Extension: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) | |
| En son sürüm | 1.8.0 (2019-05-18) |
| 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.34+ |
| Veritabanı değişiklikleri | Hayır |
| Lisans | GNU Genel Kamu Lisansı 2.0 veya üstü |
| İndir | README |
| Örnek | wiki.openoffice.org |
|
|
|
|
| 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
Bir seferde şunlar da olabilir:
- PDF olarak oluşturulur (PDF Writer bakın)
- ODF Metin Belgesi olarak dışa aktarılır (OpenDocument Export bakın)
- DocBook XML olarak dışa aktarılabilir (XML Bridge bakın)
- ZIM dosyası olarak dışa aktarılabilir (openZIM bakın)
- ePub dosyası olarak dışa aktarılabilir (ebook)
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.
mwlib
Koleksiyon uzantısının eski sürümleri mwlib kitaplığını kullandı.
mwlib için belgeler http://mwlib.readthedocs.org/ altında bulunabilir ve mwlib ve mwlib.rl için destek ve tartışma için bir Google grubu vardır.
padiapress IRC kanalında mwlib geliştiriciler de görüldü:
- Sunucu: irc.freenode.net
- Kanal: #pediapress
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
LocalSettings.php içinde "wfLoadExtension" satırını kullanır. 1.33 ve önceki sürümler eski "require_once" satırını kullanır. Buna uyulmazsa update.php açıklama yapılmadan başarısız olur.- Dosyaları indirin ve
extensions/klasörünüzdekiCollectionadlı dizine yerleştirin. - 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.
MediaWiki 1.33 veya önceki bir sürümü çalıştıran kullanıcılara:
Yukarıdaki talimatlar, bu eklentiyi wfLoadExtension() kullanarak kurmanın yeni yolunu açıklar.
Bu uzantıyı önceki sürümlerine (MediaWiki 1.33 ve önceki sürümler) yüklemeniz gerekirse, wfLoadExtension( 'Collection' ); yerine kullanmanız gerekir:
require_once "$IP/extensions/Collection/Collection.php";
Uzantının ayrıntılı yapılandırma talimatları için lütfen birlikte verilen README sayfasıda okuyun.
$wgScriptPath parametresi boşsa bu uzantı çalışmaz. Örneğin:
$wgScriptPath = '';
$wgScriptPath = '/wiki';
Örneğin:
$wgScriptPath = 'https://www.example.com'; // WITHOUT SLASH ON END
Bu sitenizi bozarsa, "extensions/Collection/Collection.body.php" yamayı da yapabilirsiniz.
"renderCollection" işlevinde değişiklik:
'base_url' => 'https://www.example.com', // WITHOUT SLASH ON END
Daha fazla bilgi için bu sorun raporuna bakın.
(bf83e768 ile düzeltilebilir.)
Yapılandırma
Aşağıdaki belgeler güncel değil. Installing a development instance en güncel belgeleri içerir.
Daha eski mwlib tabanlı hizmet için Installation and Configuration of the Collection Extension ve Customization via System Messages bakınız.
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ı
$wgCollectionMWServeURLiçin varsayılan değer olanhttp://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.
Kendi render sunucunuzu kurun
Ya dışarıdan erişilemeyen bir vikiniz varsa veya sitenizin trafiği yüksekse, kendi render sunucunuzu kurmanız gerekir. Sunucu mwlib ile birlikte gelir ve bağımsız bir HTTP sunucusu (varsayılan protokoldür) veya FastCGI veya SCGI sunucusu veya bir CGI betiği olarak kullanılabilir.
Gereksinimler ve adımlar
Mwlib'i yüklemek sayıda ek önkoşul içerir. Lütfen resmi kurulum belgelerine bakın. Özel ortamınız için kılavuzlar da yararlı olabilir, aşağıya bakın.
Diğer kılavuzlar
- Bunun Ubuntu 14.04'te nasıl yapılacağına ilişkin belgeler için Ubuntu 14.04 LTS'de bir oluşturma sunucusu kuruma sayfasına bakın.
- Bunun OSX Mavericks'te nasıl yapılacağına ilişkin belgeler için OSX'te bir işleme sunucusu kuruma bakın. Diğer sistemler için de localhost kurulumları için faydalı ipuçları vardır.
- Yerel makinelere kurulum talimatlarını içeren Extension:Collection kurulumu ve yapılandırması hakkında kapsamlı bir kılavuz - edutechwiki (TECFA, Cenevre Üniversitesi).
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 (r113740) 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.
Uzantıyı iyileştirmeye yardımcı olun
Uzantıyı daha iyi hale getirmeye yardımcı olmak istiyorsanız şunları yapabilirsiniz:
- bir hata veya özellik isteği için bir görev açın,
- lütfen etherpad:BugTriage-Collection ve etherpad:BugTriage-mwlib sayfaları da test edin;
- translatewiki.net kullanarak çevirileri düzeltin ve ekleyin.
PediaPress ile Yazdırabilir 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).
İlgili
Ayrıca bakınız
- PDF export — tüm PDF dışa aktarma uzantılarının özeti
| Bu uzantı bir veya daha fazla Wikimedia projelerinde kullanılıyor. Bu, muhtemelen uzantının kararlı olduğu ve bu tür yüksek trafikli web siteleri tarafından kullanılacak kadar iyi çalıştığı anlamına gelir. Nerede kurulduğunu görmek için bu uzantının adını Wikimedia'nın CommonSettings.php ve InitialiseSettings.php yapılandırma dosyalarında arayın. Belirli bir vikide yüklü olan uzantılar listesinin tamamı vikinin Special:Version sayfasında görülebilir. |