एक्सटेंशन:Collection

मीडियाविकि एक्सटेंशन मैन्युअल

Collection प्रकाशन की स्थिति: अनानुरक्षित
कार्यान्वयन	विशेष पृष्ठ , MyWiki
विवरण	पृष्ठों का एक संग्रहण संगठित करने देता है जिसे सम्पादित किया जाता सकता है, रख जा सकता है और वैकल्पिक रूप से एक PDF, ODF या DocBook (XML) के रूप में प्राप्त किया जा सकता है
लेखक	PediaPress.com Siebrand Mazeland Marcin Cieślak
नवीनतम संस्करण	1.8.0
संगतता नीति	मीडियाविकि के साथ प्रकाशित स्नैपशॉट्स। Master में पीछे की तरफ से संगतता नहीं है।
डेटाबेस बदलता है	नहीं
लाइसेंस	GNU साधारण सार्वजनिक लाइसेंस 2.0 या अधिक
डाउनलोड करें	एक्सटेंशन डाउनलोड करें गिट [?]: गिट master डाउनलोड करें रिपॉज़िटरी देखें (GitHub) कमिट्स का इतिहास रिपॉज़िटरी पर योगदानकर्ताएँ (GitHub) कोड निरीक्षण README
उदाहरण	wiki.openoffice.org
पैरामीटर $wgCollectionMaxSuggestions $wgCollectionMWServeCert $wgCollectionPortletFormats $wgCollectionRendererSettings $wgCollectionMWServeURL $wgCollectionDisableSidebarLink $wgCollectionMaxArticles $wgCollectionSuggestCheapWeightThreshhold $wgCollectionContentTypeToFilename $wgCollectionShowRenderNotes $wgCollectionMWServeCredentials $wgCollectionDisableDownloadSection $wgCollectionFormatToServeURL $wgCollectionLicenseName $wgCommunityCollectionNamespace $wgCollectionCommandToServeURL $wgCollectionSuggestThreshhold $wgCollectionPortletForLoggedInUsersOnly $wgCollectionArticleNamespaces $wgCollectionPODPartners $wgCollectionFormats $wgCollectionLicenseURL
अन्य अधिकार collectionsaveasuserpage collectionsaveascommunitypage
उपयोग किए गए हुक OutputPageCheckLastModified SidebarBeforeOutput SiteNoticeAfter
Quarterly downloads	78 (Ranked 68th)
Public wikis using	1,243 (Ranked 219th)
Collection एक्सटेंशन को अनुवादित करें अगर यह translatewiki.net पर उपलब्ध है
मुद्दे	अधूरे कार्य · बग की रिपोर्ट करें

Collection एक्सटेंशन की मदद से आप पृष्ठों के किसी व्यक्तिगत चुनिंदा समूह को एक संग्रह में संगठित कर सकते हैं। संग्रहों को:

• अध्यायों की मदद से सम्पादित और संरचित किया जा सकता है
• रखा, लोड किया और बाँटा जा सकता है
• https://pediapress.com/ पर छापा जा सकता है

मूल परियोजना के बारे में अधिक जानकारी के लिए प्रेस प्रकाशन 'Wikis Go Printable' देखें।

प्रलेख और समर्थन

Collection एक्सटेंशन ज़्यादातर भारी-भरकम कामों के लिए Proton सेवा का इस्तेमाल करता है। यह पहले OCG का इस्तेमाल करता था।

You can use the IRC channel #wikimedia-services ^{जुड़ें} to get in touch with developers.

बग्स रिपोर्ट करने के लिए Phabricator की MediaWiki-extensions-Collection परियोजना का इस्तेमाल करें।

अपने विकि (साँचों, पृष्ठों, श्रेणियों) को इस एक्सटेंशन के लिए तैयार करने के लिए एक विस्तृत गाइड meta.wikimedia.org पर उपलब्ध है।

स्क्रीनकास्ट

YouTube पर बुनियादी कार्यक्षमता को दर्शाते हुए एक स्क्रीनकास्ट मौजूद है (जर्मन भाषा में) (2 मिनट 45 सेकंड)

क्रॉस-विकि लेख संग्रह बनाना

OCG सेवा पर यह समर्थित था, मगर Collection एक्सटेंशन में यह अब भी समर्थित नहीं है (पैचेस का स्वागत है!)। आप नीच-स्तर mw-ocg-bundler और mw-ocg-latexer उपकरणों का इस्तेमाल करके क्रॉस-विकि संग्रह बना सकते हैं, या फिर इस काम के लिए https://pediapress.com/collection/ का इस्तेमाल कर सकते हैं। टिकट 408 देखें।

स्थापना

• फ़ाइलों को डाउनलोड करें और अपने extensions/ फ़ोल्डर के Collection नामक डिरेक्ट्री में डालें।
  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 फ़ाइल के अंत में निम्न कोड जोड़ें:

  wfLoadExtension( 'Collection' );
  

• आवश्यकतानुसार एक्सटेंशन को कॉन्फ़िगर करें
•  पूर्ण – अपने विकि पर Special:Version पर जाकर देखें कि एक्सटेंशन को सफलतापूर्वक स्थापित किया गया है कि नहीं।

एक्सटेंशन के कॉन्फ़िगरेशन के बारे में विस्तृत अनुदेशों के लिए कृपया शामिल README भी देखें। 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 में नवीनतम प्रलेख है।

कॉन्फ़िगरेशन

=== PDF, OpenDocument- और DocBook-निर्यात बनाना ===

इस एक्सटेंशन के साथ PDF (ODF, DocBook) का समर्थन सक्षम करना आसान है। इसे डिफ़ॉल्ट से https://tools.pediapress.com/ सर्वर का इस्तेमाल करने के लिए कॉन्फ़िगर किया जाता है। इसलिए इंटरनेट पर उपलब्ध (कम प्रसिद्धि वाले) साइटों के लिए अपने PDF सर्वर सर्वर स्थापित करना आवश्यक नहीं। चरण:

• बस $wgCollectionMWServeURL के डिफ़ॉल्ट वैल्यू http://tools.pediapress.com/mw-serve/ के साथ Collection एक्सटेंशन को स्थापित और कॉन्फ़िगर करें (अनुदेशों के लिए Collection एक्सटेंशन का README देखें) और सुनिश्चित करें कि मीडियाविकि API (api.php) आपकी मीडियाविकि स्थापना पर सक्षम है।
• कुछ सदस्यों का कहना है कि PDFtk स्थापित करना आवश्यक है।

Python, ReportLab, mwlib आदि की स्थापना की कोई ज़रूरत नहीं! मगर ध्यान रखें कि इस सेवा का इस्तेमाल करने के लिए आपके विकि का इस्तेमाल इंटरनेट के ज़रिए किया जाना संभव होना चाहिए, और या तो गैर-लॉग-इन किए हुए सदस्यों के लिए इस तक पहुँचना संभव होना चाहिए या फिर लॉग-इन साख कॉन्फ़िगर किए हुए होने चाहिए (अनुदेशों के लिए README देखें)।

अंग्रेज़ी विकिपीडिया से Solar system, उदाहरण लेख देखें, जिसे इस प्रौद्योगिकी से PDF के रूप में रेंडर किया गया है।

उन्नत और वैकल्पिक कॉन्फ़िगरेशन

ज़्यादातर विकियों पर नीचे की सामग्री की ज़रूरत नहीं होगी। उन सभी ग्लोबल कॉन्फ़िगरेशन्स को और उनके अर्थ प्रमुख PHP फ़ाइल पर देखें जिन्हें आप कॉन्फ़िगर कर सकते हैं। इनमें से कुछ विकल्पों की मदद से आप निर्यात को भी बदल सकते हैं।

माँग-पर-छाप

संस्करण 1.6 ($1) से एक्सटेंशन पर वेरिएबल $wgCollectionPODPartners मौजूद है जिससे माँग-पर-छाप सेवा के प्रदाताओं को परिभाषित किया जा सकता है।

डिफ़ॉल्ट से यह PediaPress सेवा का इस्तेमाल करता है:

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

यह तत्वों का ऐरे है, और इनमें से सभी को एक संभव माँग-पर-छाप सेवा के रूप में सूचीबद्ध किया जाएगा। पैरामीटर्स हैं:

name

प्रदाता का छोटा नाम

url

अगर कोई जानकारी पृष्ठ न हो तो URL जिस तक पहुँचाया जाएगा

posturl

छापने के वेब सेवा का URL

infopagetitle

मीडियाविकि सिस्टम संदेश का नाम (जैसा वह MediaWiki: नामस्थान में नज़र आता हो) जिसमें उस पृष्ठ का शीर्षक है जिससे प्रदाता के बारे में छोटी जानकारी दी जाएगी। डिफ़ॉल्ट (PediaPress के लिए) है MediaWiki:Coll-order info article, जिसका लक्ष्य है 'PediaPress order information'। अगर पृष्ठ मौजूद होता है, इससे PediaPress सेवा के बारे में कुछ जानकारी दिखाई जाती है।

आप माँग-पर-छाप को पूरी तरह से अक्षम करने के लिए सेट कर सकते हैं:

$wgCollectionPODPartners = false;

कृपया इस सुविधा के बारे में अधिक जानकारी के लिए टास्क T35536 और कमिट एंट्री देखें।

आप यह भी कॉन्फ़िगर कर सकते हैं कि कौन-से फ़ाइल प्रारूप उपलब्ध किए जाते हैं:

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

कॉन्फ़िगरेशन के अधिक विकल्पों के लिए README देखें।

किताबें सहेजने के लिए सदस्य अधिकार

सदस्यों को उनके सदस्य स्थान और सामुदायिक स्थान में किताबें सहेजने की अनुमति देने के लिए अपने LocalSettings.php पर निम्न पंक्तियाँ जोड़ें:

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

किसी दूसरी जगह पर कड़ियाँ जोड़ें

अगर आप कड़ियों को किसी दूसरी जगह पर जोड़ना चाहते हैं, जैसे "व्यक्तिगत उपकरण" मेन्यू में, आप ऐसा उन्हें उनके पोर्टलेट में जोड़कर कर सकते हैं। उदाहरणस्वरूप, Vector स्किन में आपको इन्हें skins/Vector.php फ़ाइल में जोड़ना होगा जिसके बाद फ़ाइल ऐसी दिखेगी:

	<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 );
		}

आप पोर्टलेट में कड़ियों के क्रम को बदलने के लिए foreach लूप के निष्पादित किए जाने से पहले सीधे $personalTools जोड़ सकते हैं।

ऊपर की विधि में खामी यह है कि दो नई कड़ियों पर उनके टूलटिप्स को नहीं दिखाया जाता है। इसके लिए एक समाधान का इंतज़ार किया जा रहा है और इससे बहुत मदद मिलेगी।

किताब का उपसर्ग सेट करना

किताब के नाम का डिफ़ॉल्ट उपसर्ग बदलने के लिए MediaWiki:Coll-community book prefix संदेश को सम्पादित करें।

कैश

हाल के संस्करणों द्वारा "किताबों" को एक कैश में रखा जाता है। उन संग्रहों को तुरंत डाउनलोड किया जा सकता है जिन्हें पहले किसी सदस्य द्वारा निर्यात किया गया हो, और इसमें कई मिनटों के रेंडरिंग की ज़रूरत नहीं; कैश किए गए संस्करण को डाउनलोड पृष्ठ पर एक कड़ी पर क्लिक करके अपडेट किया जा सकता है।

PediaPress से छापी कई किताबें

PediaPress द्वारा प्रदत्त विकिपीडिया की किताबें

PediaPress एक सेवा है जो विकि की सामग्री से छापी गई किताबें बनाती है। इस सेवा को एस एक्सटेंशन में एकीकृत किया गया है (अक्षम किया जा सकता है)।

ये भी देखें

• PDF export — सभी PDF निर्यात एक्सटेंशनों का सारांश
• Bookshelf — Combines wiki pages to create books and also to export them as PDF