Extension:Collection

MediaWiki manüel uzantıları

Collection Sürüm durumu: kararlı
Uygulama	Özel sayfa , Vikim
Açıklama	Bir koleksiyonda düzenlenebilir, kalıcı hale getirilebilir ve isteğe bağlı olarak PDF, ODF veya DocBook (XML) olarak geri alınabilen kişisel sayfa seçimlerinin düzenlenmesine izin verir
Yazar(lar)	PediaPress.com Siebrand Mazeland Marcin Cieślak
En son sürüm	1.8.0
Uyumluluk politikası	MediaWiki ile birlikte anlık görüntüler yayımlanır. Master geriye dönük olarak uyumlu değil.
MediaWiki	>= 1.42
Veritabanı değişiklikleri	Hayır
Composer	mediawiki/collection
Lisans	GNU Genel Kamu Lisansı 2.0 veya üstü
İndir	Uzantıyı indir Git [?]: Git master'ı indir depoyu göz at (GitHub) geçmişi işleyin veri deposu katkıda bulunanlar (GitHub) kod incelemesi README
Örnek	wiki.openoffice.org
Parametreler $wgCollectionMaxSuggestions $wgCollectionMWServeCert $wgCollectionPortletFormats $wgCollectionRendererSettings $wgCollectionMWServeURL $wgCollectionDisableSidebarLink $wgCollectionMaxArticles $wgCollectionSuggestCheapWeightThreshhold $wgCollectionContentTypeToFilename $wgCollectionShowRenderNotes $wgCollectionMWServeCredentials $wgCollectionDisableDownloadSection $wgCollectionFormatToServeURL $wgCollectionLicenseName $wgCommunityCollectionNamespace $wgCollectionCommandToServeURL $wgCollectionSuggestThreshhold $wgCollectionPortletForLoggedInUsersOnly $wgCollectionArticleNamespaces $wgCollectionPODPartners $wgCollectionFormats $wgCollectionLicenseURL
Eklenen haklar collectionsaveasuserpage collectionsaveascommunitypage
Kullanılan kancalar OutputPageCheckLastModified SidebarBeforeOutput SiteNoticeAfter
Quarterly downloads	137 (Ranked 51st)
Public wikis using	1,243 (Ranked 219th)
Translatewiki.net adresinde mevcutsa, Collection uzantısını çevirin
Sorunlar	Açık görevler · Hata bildir

Collection uzantısı, bir kullanıcının bir koleksiyondaki kişisel sayfa seçimlerini düzenlemesine olanak tanır. Koleksiyonlar şunlar olabilir:

• bölümler kullanılarak düzenlenebilir ve yapılandırabilir
• kalıcı, yüklenebilir ve paylaşılabilir
• https://pediapress.com/ altında basılı kitap olarak sipariş edebilir

Orijinal proje hakkında daha fazla bilgi için Vikiler Gitme Yazdırılabilir basın bültenine bakın.

Belgeler ve Destek

Collection uzantısı, ağır yükünün çoğunu yapmak için Proton hizmeti kullanır. Önceden OCG kullanıldı.

You can use the IRC channel #wikimedia-services ^bağlan to get in touch with developers.

Hataları bildirmek için MediaWiki-extensions-Collection projeyi Phabricator olarak kullanın.

Uzantıyı kurarsanız vikinizi nasıl hazırlayacağınıza dair ayrıntılı bir kılavuz (şablonlar, yardım sayfaları, kategoriler) meta.wikimedia.org altında mevcuttur.

Ekran video kaydı

YouTube'da (Almanca) (2:45 dakika) mevcut temel işlevselliği gösteren bir ekran video kaydı var.

Çapraz viki madde koleksiyonları oluşturma

OCG hizmeti bunu destekledi, ancak Collection uzantısı desteklemiyor (henüz, yamalar açıktır!). Vikiler arası koleksiyonlar oluşturmak için düşük seviyeli mw-ocg-bundler ve mw-ocg-latexer araçlarını kullanabilir veya bu amaçla https://pediapress.com/collection/ kullanabilirsiniz, bilet 408 bakınız.

Kurulum

• Dosyaları indirin ve extensions/ klasörünüzdeki Collection adlı dizine yerleştirin.
  Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Collection
• LocalSettings.php dosyanızın altına aşağıdaki kodu ekleyin:

  wfLoadExtension( 'Collection' );
  

• Uzantıyı gerektiği gibi yapılandırın
•  Yapıldı – Uzantının başarıyla yüklendiğini doğrulamak için vikinizde Special:Version seçeneğine gidin.

Uzantının ayrıntılı yapılandırma talimatları için lütfen birlikte verilen README sayfasıda okuyun. If you use MediaWiki 1.4.1 you have to use the following Command:

cd extensions/

git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Collection --branch REL1_41

Local render server (OCG)

Installing a development instance en güncel belgeleri içerir.

Yapılandırma

=== PDF'ler, OpenDocument- ve DocBook-Exports oluşturma ===

Bu uzantı ile PDF (ODF, DocBook) desteğini etkinleştirmek kolaydır. Varsayılan olarak https://tools.pediapress.com/ sunucusunu kullanacak şekilde yapılandırılmıştır. Bu nedenle, internetten erişilebilen (düşük trafikli) sitelerin kendi PDF sunucusunu kurması gerekmez. Adımlar:

• Collection uzantısını $wgCollectionMWServeURL için varsayılan değer olan http://tools.pediapress.com/mw-serve/ kullanarak kurup yapılandırmanız yeterlidir (talimatlar için Collection uzantısının README dosyasını bakın) ve MediaWiki kurulumunuzda MediaWiki API (api.php) seçeneğinin etkinleştirildiğinden emin olun.
• Bazı kullanıcılar PDFtk yüklemenin gerekli olduğunu bildiriyor.

Python, ReportLab, mwlib vb. kurulumu gerekmez! Bununla birlikte, bu hizmeti kullanmak için, vikinize internetten erişilebilmesi ve oturum açmamış kullanıcılar için erişilebilir olması veya oturum açma kimlik bilgilerinin yapılandırılması gerektiğini unutmayın (talimatlar için README sayfasına bakın).

Bu teknoloji kullanılarak PDF olarak oluşturulan, İngilizce Vikipedi'den Solar system örnek maaddesine bir göz atın.

Gelişmiş ve isteğe bağlı yapılandırma

Çoğu vikinin bundan sonra gelenleri bilmesine asla gerek yoktur. Yapılandırabileceğiniz tüm küresel değişkenleri ve anlamlarını görmek için ana PHP dosyasını kontrol edin. Bunlardan bazıları, birçok durumda dışa aktarımı ayarlamak için kullanışlıdır.

Talep üzerine yazdırma

Sürüm 1.6'dan ($1) bu yana uzantı, isteğe bağlı baskı hizmetinin mevcut sağlayıcılarını tanımlamak için kullanılan $wgCollectionPODPartners değişkenini sunar.

Varsayılan olarak PediaPress hizmetini kullanır:

$wgCollectionPODPartners = [
    'pediapress' => [
        'name' => 'PediaPress',
        'url' => 'http://pediapress.com/',
        'posturl' => 'http://pediapress.com/api/collections/',
        'infopagetitle' => 'coll-order_info_article'
    ],
];

Bir dizi öğedir, her biri olası bir isteğe bağlı baskı sağlayıcısı olarak listelenir. Parametreler şunlardır:

name

sağlayıcının kısa adı

url

Bilgi sayfası yoksa daha fazla bilgi için işaret edecek URL

posturl

Gerçek yazdırma web hizmetinin URL'si

infopagetitle

Sağlayıcıyı kısaca tanımlamak için kullanılacak sayfanın sayfa başlığını içeren MediaWiki sistem mesaj adı (MediaWiki: ad alanında görüldüğü gibi). Varsayılan (PediaPress için) MediaWiki:Coll-order info article ve varsayılan olarak PediaPress sipariş bilgisi ​​şeklindedir. Bu sayfa varsa, PediaPress kitap yazdırma hizmeti hakkında bilgi görüntülemek için kullanılır.

Aşağıdakileri ayarlayarak istek üzerine yazdırmayı tamamen devre dışı bırakmak da mümkündür:

$wgCollectionPODPartners = false;

Bu özellik hakkında daha fazla bilgi için lütfen görev T35536 ve taahhüt girişi sayfalarına bakın.

Ayrıca hangi dosya formatlarının mevcut olduğunu da yapılandırabilirsiniz:

$wgCollectionFormats = [
    'rl' => 'PDF', # enabled by default
    'odf' => 'ODT',
    'docbook' => 'DocBook XML',
    'xhtml' => 'XHTML 1.0 Transitional',
    'epub' => 'e-book (EPUB)',
    'zim' => 'Kiwix (OpenZIM)',
];

Daha fazla yapılandırma seçeneği için README sayfasına bakın.

Kitapları kaydetmek için kullanıcı hakları

Kullanıcıların hem kullanıcı alanlarında hem de topluluk alanında kitap kaydetmelerine izin vermek için, aşağıdaki satırları LocalSettings.php dosyanıza ekleyin:

$wgGroupPermissions['user']['collectionsaveascommunitypage'] = true;
$wgGroupPermissions['user']['collectionsaveasuserpage'] = true;

Bağlantıları başka bir yere ekleyin

Bağlantıları başka bir yere eklemek isterseniz, ör. "Kişisel Araçlar" menüsünde, bunları ilgili portlete ekleyerek yapabilirsiniz. Örneğin, Vector görünümünde bunu skins/Vector.php dosyasına ekleyerek yapabilirsiniz, böylece şöyle görünür:

	<h3><?php $this->msg( 'personaltools' ) ?></h3>
	<ul<?php $this->html( 'userlangattributes' ) ?>>
<?php
		$personalTools = $this->getPersonalTools();

		/* Links to create a PDF file/a book start */
		if ( class_exists('CollectionHooks') ) {
			$collectionURLs = CollectionHooks::getPortlet($this->getSkin());

			if ( $collectionURLs !== false ) {
				/* Put the links of the Collection extension below the last item. */
				$personalTools += $collectionURLs;
			}
		}
		/* Links to create a PDF file/a book end */

		foreach ( $personalTools as $key => $item ) {
			echo $this->makeListItem( $key, $item );
		}

Portletteki bağlantıların sırasını, $personalTools döngüsü yürütülmeden önce doğrudan $personalTools ile değiştirerek yine de değiştirebilirsiniz.

Yukarıdaki uygulamanın dezavantajı, yeni eklenen iki bağlantının araç ipuçlarını göstermemesidir. Bunun için bir çözüm hâlâ olağanüstü ve çok takdir edilecektir.

Kitap önekini ayarlama

Kitap adı için varsayılan öneki değiştirmek için MediaWiki:Coll-community book prefix mesajını düzenleyin.

Önbellek

Son sürümler işlenmiş "kitapları" bir önbellekte depolar. Daha önce kullanıcılar tarafından dışa aktarılan koleksiyonlar, oluşturulduktan birkaç dakika sonra değil, hemen indirilebilir olmalıdır; önbelleğe alınmış sürüm, indirme sayfasında sunulan bir bağlantı izlenerek güncellenebilir.

PediaPress ile Yazdırabilir Kitaplar

PediaPress tarafından sunulan yazdırabilir Vikipedi kitapları

PediaPress, viki içeriğine dayalı basılı kitaplar sunan bir hizmettir. Bu hizmet, bu uzantıya sorunsuz bir şekilde entegre edilmiştir (devre dışı bırakılabilir).

Ayrıca bakınız

• PDF export — tüm PDF dışa aktarma uzantılarının özeti