डॉकबुक - Revision history

Neeraja at 03:59, 6 September 2023

2023-09-06T03:59:36Z

← Older revision		Revision as of 09:29, 6 September 2023
Line 19:		Line 19:
	}}		}}

	डॉकबुक तकनीकी डॉक्यूमेंट के लिए एक सिमेंटिक मार्कअप भाषा है। यह मूल रूप से कंप्यूटर हार्डवेयर और सॉफ्टवेयर से संबंधित तकनीकी डॉक्यूमेंट लिखने के लिए था, लेकिन इसका उपयोग किसी अन्य प्रकार के प्रलेखन के लिए किया जा सकता है।<ref>[http://docbook.org/whatis What is DocBook?]</ref>		'''डॉकबुक''' तकनीकी डॉक्यूमेंट के लिए एक सिमेंटिक मार्कअप भाषा है। यह मूल रूप से कंप्यूटर हार्डवेयर और सॉफ्टवेयर से संबंधित तकनीकी डॉक्यूमेंट लिखने के लिए था, लेकिन इसका उपयोग किसी अन्य प्रकार के प्रलेखन के लिए किया जा सकता है।<ref>[http://docbook.org/whatis What is DocBook?]</ref>

	सिमेंटिक भाषा के रूप में, डॉकबुक अपने उपयोगकर्ताओं को एक प्रस्तुति-तटस्थ रूप में डॉक्युमेंट सामग्री बनाने में सक्षम बनाता है जो सामग्री की तार्किक संरचना को कैप्चर करता है; उस सामग्री को तब एचटीएमएल, एक्सएचटीएमएल, ईपीयूबी, पीडीएफ, मैन पेज, वेबहेल्प और एचटीएमएल हेल्प सहित विभिन्न स्वरूपों में प्रकाशित किया जा सकता है।<ref name="webhelp-1.76.1">[http://blog.kasunbg.com/2010/08/docbook-webhelp-project.html DocBook WebHelp Project]</ref> उपयोगकर्ताओं को स्रोत में कोई भी बदलाव करने की अनुमति देने की आवश्यकता के बिना है। दूसरे शब्दों में, जब डॉकबुक प्रारूप में एक डॉक्यूमेंट लिखा जाता है, तो इसे फिर से लिखने की आवश्यकता के परिणामस्वरूप अन्य प्रारूपों में प्रभावी रूप से सक्षम हो जाता है।		सिमेंटिक भाषा के रूप में, डॉकबुक अपने उपयोगकर्ताओं को एक प्रस्तुति-तटस्थ रूप में डॉक्युमेंट सामग्री बनाने में सक्षम बनाता है जो सामग्री की तार्किक संरचना को कैप्चर करता है; उस सामग्री को तब एचटीएमएल, एक्सएचटीएमएल, ईपीयूबी, पीडीएफ, मैन पेज, वेबहेल्प और एचटीएमएल हेल्प सहित विभिन्न स्वरूपों में प्रकाशित किया जा सकता है।<ref name="webhelp-1.76.1">[http://blog.kasunbg.com/2010/08/docbook-webhelp-project.html DocBook WebHelp Project]</ref> उपयोगकर्ताओं को स्रोत में कोई भी बदलाव करने की अनुमति देने की आवश्यकता के बिना है। दूसरे शब्दों में, जब डॉकबुक प्रारूप में एक डॉक्यूमेंट लिखा जाता है, तो इसे फिर से लिखने की आवश्यकता के परिणामस्वरूप अन्य प्रारूपों में प्रभावी रूप से सक्षम हो जाता है।
Line 155:		Line 155:
	[[Category:Navigational boxes without horizontal lists]]		[[Category:Navigational boxes without horizontal lists]]
	[[Category:Pages with script errors]]		[[Category:Pages with script errors]]
			[[Category:Short description with empty Wikidata description]]
	[[Category:Sidebars with styles needing conversion]]		[[Category:Sidebars with styles needing conversion]]
	[[Category:Template documentation pages\|Documentation/doc]]		[[Category:Template documentation pages\|Documentation/doc]]

Manidh at 08:32, 7 July 2023

2023-07-07T08:32:55Z

@@ Line 147: / Line 147: @@
 {{Authority control}}
+[[Category:Collapse templates]]
 [[Category:Created On 14/06/2023]]
-[[Category:Vigyan Ready]]
+[[Category:Lua-based templates]]

Indicwiki: 11 revisions imported from :alpha:डॉकबुक

2023-07-06T12:38:08Z

11 revisions imported from alpha:डॉकबुक

← Older revision	Revision as of 18:08, 6 July 2023
(No difference)

alpha>Neeraja: added Category:Vigyan Ready using HotCat

2023-07-06T10:52:24Z

added Category:Vigyan Ready using HotCat

← Older revision		Revision as of 16:22, 6 July 2023
Line 153:		Line 153:
	[[Category: Machine Translated Page]]		[[Category: Machine Translated Page]]
	[[Category:Created On 14/06/2023]]		[[Category:Created On 14/06/2023]]
			[[Category:Vigyan Ready]]

alpha>Sweta at 07:39, 30 June 2023

2023-06-30T07:39:46Z

Show changes

alpha>Sweta at 11:31, 28 June 2023

2023-06-28T11:31:54Z

← Older revision		Revision as of 17:01, 28 June 2023
Line 1:		Line 1:
	{{Short description\|Markup language for documentation}}		{{Short description\|Markup language for documentation}}
	{{Infobox file format		{{Infobox file format
	\| name = ~~DocBook~~		\| name = डॉकबुक
	\| icon =		\| icon =
	\| logo =		\| logo =
	\| extension = .dbk, .xml		\| extension = .dbk, .xml
	\| mime = ~~application~~/~~docbook~~+~~xml~~		\| mime = एप्लिकेशन/डॉकबुक+एक्सएमएल
	\| type code =		\| type code =
	\| uniform type =		\| uniform type =
	\| magic =		\| magic =
	\| owner = [[~~OASIS~~ (~~organization~~)\|~~OASIS~~]]		\| owner = [[ओएसिस (संगठन)\|ओएसिस]]
	\| genre = [[~~markup language~~]]		\| genre = [[मार्कअप लैंग्वेज]]
	\| container for =		\| container for =
	\| contained by =		\| contained by =
	\| extended from = [[~~SGML~~]], [[~~XML~~]]		\| extended from = [[एसजीएमएल]], [[एक्सएमएल]]
	\| extended to =		\| extended to =
	\| open = ~~Yes~~		\| open = हाँ
	\| standard = [http://docs.oasis-open.org/docbook/docbook/v5.1/os/docbook-v5.1-os.html 5.1 (November 2016)],<br/>[http://www.oasis-open.org/docbook/specs/docbook-4.5-spec.html 4.5 (October 2006)]		\| standard = [http://docs.oasis-open.org/docbook/docbook/v5.1/os/docbook-v5.1-os.html 5.1 (November 2016)],<br/>[http://www.oasis-open.org/docbook/specs/docbook-4.5-spec.html 4.5 (October 2006)]
	}}		}}
Line 44:		Line 44:
	''ब्लॉक-लेवल'' टैग पैराग्राफ, सूचियां आदि जैसे तत्व हैं। इन सभी तत्वों में सीधे तौर पर टेक्स्ट नहीं हो सकता है। अनुक्रमिक ब्लॉक-स्तरीय तत्व एक को "एक के बाद एक" प्रस्तुत करते हैं। इस स्तिथि में, बाद में, भाषा के आधार पर भिन्न हो सकते हैं। अधिकांश पश्चिमी भाषाओं में, "बाद" का अर्थ निम्न है: पाठ पैराग्राफ पृष्ठ के नीचे मुद्रित होते हैं। अन्य भाषाओं की लेखन प्रणालियों की दिशा अलग-अलग हो सकती है; उदाहरण के लिए, जापानी में, पैराग्राफ प्रायः नीचे की ओर वाले कॉलम में मुद्रित होते हैं, जिसमें कॉलम दाएं से बाएं ओर चलते हैं, इसलिए उस स्थिति में "बाद" बाईं ओर होगा। डॉकबुक शब्दार्थ इस प्रकार की भाषा-आधारित अवधारणाओं से पूरी तरह तटस्थ है।		''ब्लॉक-लेवल'' टैग पैराग्राफ, सूचियां आदि जैसे तत्व हैं। इन सभी तत्वों में सीधे तौर पर टेक्स्ट नहीं हो सकता है। अनुक्रमिक ब्लॉक-स्तरीय तत्व एक को "एक के बाद एक" प्रस्तुत करते हैं। इस स्तिथि में, बाद में, भाषा के आधार पर भिन्न हो सकते हैं। अधिकांश पश्चिमी भाषाओं में, "बाद" का अर्थ निम्न है: पाठ पैराग्राफ पृष्ठ के नीचे मुद्रित होते हैं। अन्य भाषाओं की लेखन प्रणालियों की दिशा अलग-अलग हो सकती है; उदाहरण के लिए, जापानी में, पैराग्राफ प्रायः नीचे की ओर वाले कॉलम में मुद्रित होते हैं, जिसमें कॉलम दाएं से बाएं ओर चलते हैं, इसलिए उस स्थिति में "बाद" बाईं ओर होगा। डॉकबुक शब्दार्थ इस प्रकार की भाषा-आधारित अवधारणाओं से पूरी तरह तटस्थ है।

	इनलाइन-स्तरीय टैग जोर, हाइपरलिंक इत्यादि जैसे तत्व हैं। वे ब्लॉक-स्तरीय तत्व के भीतर टेक्स्ट को लपेटते हैं। पैराग्राफ प्रारूप में प्रस्तुत किए जाने पर ये तत्व पाठ को तोड़ने का कारण नहीं बनते हैं, लेकिन सामान्यतः वे डॉक्युमेंट प्रोसेसर को फ़ॉन्ट, आकार या समान विशेषताओं को बदलकर संलग्न पाठ में कुछ प्रकार के विशिष्ट टाइपोग्राफ़िकल उपचार लागू करने का कारण बनते हैं। (डॉकबुक विनिर्देश यह कहता है कि यह अलग टाइपोग्राफ़िकल उपचार की अपेक्षा करता है, लेकिन यह विशिष्ट आवश्यकताओं की ~~पेशकश~~ नहीं करता है कि यह उपचार क्या हो सकता है।) यानी, डॉकबुक प्रोसेसर को एक <code>emphasis</code> टैग को इटैलिक में बदलने की ज़रूरत नहीं है। रीडर-आधारित डॉकबुक प्रोसेसर शब्दों के आकार को बढ़ा सकता है, या, टेक्स्ट-आधारित प्रोसेसर इटैलिक के बजाय बोल्ड का उपयोग कर सकता है।		इनलाइन-स्तरीय टैग जोर, हाइपरलिंक इत्यादि जैसे तत्व हैं। वे ब्लॉक-स्तरीय तत्व के भीतर टेक्स्ट को लपेटते हैं। पैराग्राफ प्रारूप में प्रस्तुत किए जाने पर ये तत्व पाठ को तोड़ने का कारण नहीं बनते हैं, लेकिन सामान्यतः वे डॉक्युमेंट प्रोसेसर को फ़ॉन्ट, आकार या समान विशेषताओं को बदलकर संलग्न पाठ में कुछ प्रकार के विशिष्ट टाइपोग्राफ़िकल उपचार लागू करने का कारण बनते हैं। (डॉकबुक विनिर्देश यह कहता है कि यह अलग टाइपोग्राफ़िकल उपचार की अपेक्षा करता है, लेकिन यह विशिष्ट आवश्यकताओं की प्रस्ताव नहीं करता है कि यह उपचार क्या हो सकता है।) यानी, डॉकबुक प्रोसेसर को एक <code>emphasis</code> टैग को इटैलिक में बदलने की ज़रूरत नहीं है। रीडर-आधारित डॉकबुक प्रोसेसर शब्दों के आकार को बढ़ा सकता है, या, टेक्स्ट-आधारित प्रोसेसर इटैलिक के बजाय बोल्ड का उपयोग कर सकता है।

	=== प्रतिरूप डॉक्युमेंट ===		=== प्रतिरूप डॉक्युमेंट ===
Line 105:		Line 105:
	नॉर्मन वॉल्श और डॉकबुक प्रोजेक्ट डेवलपमेंट टीम डॉकबुक स्रोत दस्तावेजों से उत्पादन के लिए महत्वपूर्ण आवेदन को बनाए रखती है: [[एक्सएसएलटी]] स्टाइलशीट का एक सेट (और साथ ही [[डीएसएसएसएल]] स्टाइलशीट) की विरासत सेट जो उच्च गुणवत्ता वाले एचटीएमएल और प्रिंट (एफओ/पीडीएफ) आउटपुट, साथ ही अन्य प्रारूपों में आउटपुट उत्पन्न कर सकता है। आरटीएफ, मैन पेज और एचटीएमएल हेल्प सम्मिलित हैं।		नॉर्मन वॉल्श और डॉकबुक प्रोजेक्ट डेवलपमेंट टीम डॉकबुक स्रोत दस्तावेजों से उत्पादन के लिए महत्वपूर्ण आवेदन को बनाए रखती है: [[एक्सएसएलटी]] स्टाइलशीट का एक सेट (और साथ ही [[डीएसएसएसएल]] स्टाइलशीट) की विरासत सेट जो उच्च गुणवत्ता वाले एचटीएमएल और प्रिंट (एफओ/पीडीएफ) आउटपुट, साथ ही अन्य प्रारूपों में आउटपुट उत्पन्न कर सकता है। आरटीएफ, मैन पेज और एचटीएमएल हेल्प सम्मिलित हैं।

	वेब सहायता<ref name="webhelp-1.76.1" /> डॉकबुक एक्सएसएल स्टाइलशीट में एक विभाजित एचटीएमएल आउटपुट प्रारूप है जिसे संस्करण 1.76.1 में ~~पेश~~ किया गया था. वेब सहायता के लिए प्रलेखन<ref>[http://docbook.sourceforge.net/release/xsl/current/webhelp/docs/index.html Web help documentation]</ref> भी वेब सहायता का एक उदाहरण प्रदान करता है और डॉकबुक एक्सएसएल वितरण का हिस्सा है।		वेब सहायता<ref name="webhelp-1.76.1" /> डॉकबुक एक्सएसएल स्टाइलशीट में एक विभाजित एचटीएमएल आउटपुट प्रारूप है जिसे संस्करण 1.76.1 में प्रस्तुत किया गया था. वेब सहायता के लिए प्रलेखन<ref>[http://docbook.sourceforge.net/release/xsl/current/webhelp/docs/index.html Web help documentation]</ref> भी वेब सहायता का एक उदाहरण प्रदान करता है और डॉकबुक एक्सएसएल वितरण का हिस्सा है।

	प्रमुख विशेषताएं इसका पूरी तरह से सीएसएस-आधारित पेज लेआउट, सहायता सामग्री की खोज और संक्षिप्त-वृक्ष रूप में सामग्री की एक तालिका हैं। खोज में स्टेमिंग, मैच हाइलाइटिंग, स्पष्ट पेज स्कोरिंग और मानक बहुभाषी टोकननाइज़र है। खोज और टीओसी एक फलक में हैं जो एक फ्रेमसेट के रूप में दिखाई देता है लेकिन वास्तव में इसे डिव [[डिव और स्पैन\|डिव]] और कुकीज़ के साथ कार्यान्वित किया जाता है (ताकि यह प्रगतिशील हो)।		प्रमुख विशेषताएं इसका पूरी तरह से सीएसएस-आधारित पेज लेआउट, सहायता सामग्री की खोज और संक्षिप्त-वृक्ष रूप में सामग्री की एक तालिका हैं। खोज में स्टेमिंग, मैच हाइलाइटिंग, स्पष्ट पेज स्कोरिंग और मानक बहुभाषी टोकननाइज़र है। खोज और टीओसी एक फलक में हैं जो एक फ्रेमसेट के रूप में दिखाई देता है लेकिन वास्तव में इसे डिव [[डिव और स्पैन\|डिव]] और कुकीज़ के साथ कार्यान्वित किया जाता है (ताकि यह प्रगतिशील हो)।

alpha>Sweta at 10:53, 28 June 2023

2023-06-28T10:53:31Z

Show changes

alpha>Sweta: /* सरलीकृत डॉकबुक */

2023-06-28T10:50:08Z

सरलीकृत डॉकबुक

← Older revision		Revision as of 16:20, 28 June 2023
Line 111:		Line 111:
	== सरलीकृत डॉकबुक ==		== सरलीकृत डॉकबुक ==

	डॉकबुक बड़ी संख्या में सुविधाएँ प्रदान करता है जो एक नए उपयोगकर्ता के लिए भारी हो सकती हैं। ~~उन लोगों के लिए~~ जो ~~तेज सीखने की अवस्था~~ के बिना डॉकबुक की सुविधा चाहते हैं, सरलीकृत ~~डॉकबुक को डिजाइन~~ किया गया था। यह डॉकबुक का एक छोटा सा उपसमुच्चय है जिसे लेख या श्वेत पत्र जैसे एकल ~~डॉक्युमेंटों~~ के लिए डिज़ाइन किया गया ~~है (अर्थात, पुस्तकें समर्थित नहीं हैं)।~~ सरलीकृत डॉकबुक डीटीडी वर्तमान में 1.1 ~~संस्करण~~ पर है।<ref>[http://www.docbook.org/schemas/sdocbook/ Simplified DocBook]</ref>		डॉकबुक बड़ी संख्या में सुविधाएँ प्रदान करता है जो एक नए उपयोगकर्ता के लिए भारी हो सकती हैं। जो लोग कठिन अध्ययन के बिना डॉकबुक की सुविधा चाहते हैं, उनके लिए डॉकबुक सरलीकृत डिज़ाइन किया गया था। यह डॉकबुक का एक छोटा उपसमुच्चय है जिसे लेख या श्वेत पत्र (यानी, "किताबें" समर्थित नहीं हैं) जैसे एकल दस्तावेज़ों के लिए डिज़ाइन किया गया है। सरलीकृत डॉकबुक डीटीडी वर्तमान में संस्करण 1.1 पर है।<ref>[http://www.docbook.org/schemas/sdocbook/ Simplified DocBook]</ref>


	== आलोचना ==		== आलोचना ==
	[[ओपनबीएसडी]] के ~~मैनडॉक~~ के लेखक इंगो ~~श्वार्ज~~, डॉकबुक को ~~[[मैन पेज]]ों के~~ सिमेंटिक एमडीओसी मैक्रो से ~~कमतर~~ मानते हैं। डॉकबुक-to-~~mdoc कन्वर्टर~~ लिखने के प्रयास में (पिछले कन्वर्टर्स जैसे डॉकबुक-to-~~man सिमेंटिक~~ तत्वों को कवर नहीं करता है), वह ~~एक ही समय~~ में ~~mdoc में शामिल~~ तत्वों की तुलना में ~~सिमेंटिक भागों को फूला हुआ~~, निरर्थक और अधूरा ~~पाता है।~~ इसके ~~अलावा~~, श्वार्ज़ ने डॉकबुक विनिर्देश को टैग के उपयोग के बारे में पर्याप्त रूप से विशिष्ट नहीं पाया, ~~भाषा~~ संस्करणों में गैर-पोर्टेबल, ~~विवरणों~~ में ~~खुरदरी~~ और समग्र ~~रूप से असंगत~~ है।<ref>{{cite web \|last1=Schwarze \|first1=Igor \|title=docbook2mdoc-1.0.0 released \|url=https://undeadly.org/cgi?action=article&sid=20190419101505 \|website=OpenBSD Journal \|date=April 19, 2019}}</ref>		[[ओपनबीएसडी]] के मैंडॉक के लेखक इंगो श्वार्ज़, मैन पेजों के लिए डॉकबुक को सिमेंटिक एमडीओसी मैक्रो से न्यूनतम मानते हैं। डॉकबुक-टू-एमडॉक कनवर्टर लिखने के प्रयास में (पिछले कन्वर्टर्स जैसे डॉकबुक-टू-मैन शब्दार्थ तत्वों को कवर नहीं करता है), वह अर्थ भागों को पाता है "डॉक में सम्मिलित तत्वों की तुलना में एक ही समय में सुस्त, निरर्थक और अधूरा "। इसके अतिरिक्त, श्वार्ज़ ने डॉकबुक विनिर्देश को टैग के उपयोग के बारे में पर्याप्त रूप से विशिष्ट नहीं पाया है, संस्करणों में गैर-पोर्टेबल भाषा, विवरण में किसी न किसी तरह और समग्र अतुलनीय है।<ref>{{cite web \|last1=Schwarze \|first1=Igor \|title=docbook2mdoc-1.0.0 released \|url=https://undeadly.org/cgi?action=article&sid=20190419101505 \|website=OpenBSD Journal \|date=April 19, 2019}}</ref>


	== यह भी देखें ==		== यह भी देखें ==

Line 123:		Line 119:
	* [[दस्तावेज़ मार्कअप भाषाओं की तुलना\|डॉक्युमेंट मार्कअप भाषाओं की तुलना]]		* [[दस्तावेज़ मार्कअप भाषाओं की तुलना\|डॉक्युमेंट मार्कअप भाषाओं की तुलना]]
	* डॉकबुक एक्सएसएल		* डॉकबुक एक्सएसएल
	*[[डार्विन सूचना टंकण वास्तुकला]]		*[[डार्विन सूचना टंकण वास्तुकला\|डार्विन सूचना टाइपिंग वास्तुकला]]
	* [[LinuxDoc]] ~~डॉक~~		* [[LinuxDoc\|लिनक्स डॉक]]
	* ~~[[कंडोम]]~~		* लाटेक्स
	*[[मुमासी]]		*[[मुमासी]]

Line 131:		Line 127:

	{{reflist}}		{{reflist}}


	== अग्रिम पठन ==		== अग्रिम पठन ==
	Norman Walsh is the principal author of the book [http://www.docbook.org/tdg/ ''डॉकबुक: The Definitive Guide''], the official documentation of डॉकबुक. This book is available online under the [[GNU Free Documentation License\|GFDL]], and also as a print publication.		Norman Walsh is the principal author of the book [http://www.docbook.org/tdg/ ''डॉकबुक: The Definitive Guide''], the official documentation of डॉकबुक. This book is available online under the [[GNU Free Documentation License\|GFDL]], and also as a print publication.
Line 141:		Line 135:
	* {{ cite book \| author = Joe Brockmeier \| year = 2001 \| title = DocBook Publishing — A Better Way to Create Professional Documents \| publisher = Prima Tech's Linux Series \| isbn = 0-7615-3331-1 }}		* {{ cite book \| author = Joe Brockmeier \| year = 2001 \| title = DocBook Publishing — A Better Way to Create Professional Documents \| publisher = Prima Tech's Linux Series \| isbn = 0-7615-3331-1 }}
	{{refend}}		{{refend}}


	== बाहरी संबंध ==		== बाहरी संबंध ==
	* [http://docbook.org डॉकबुक.org] - Collection of डॉकबुक information, including a 4.x and 5.0 version of ''डॉकबुक: The Definitive Guide'' and all versions of the डॉकबुक schemas/डीटीडीs.		* [http://docbook.org डॉकबुक.org] - Collection of डॉकबुक information, including a 4.x and 5.0 version of ''डॉकबुक: The Definitive Guide'' and all versions of the डॉकबुक schemas/डीटीडीs.

alpha>Sweta: /* आउटपुट स्वरूप */

2023-06-28T10:39:29Z

आउटपुट स्वरूप

← Older revision		Revision as of 16:09, 28 June 2023
Line 63:		Line 63:
	</book>		</book>
	</syntaxhighlight>		</syntaxhighlight>
	शब्दार्थ, यह दस्तावेज़ एक "पुस्तक" है, जिसमें "शीर्षक" होता है, जिसमें दो "अध्याय" होते हैं, जिनमें से प्रत्येक का अपना "शीर्षक" होता है"। उन "अध्याय" में "पैराग्राफ" होते हैं जिनमें पाठ होता ~~है.~~ मार्कअप अंग्रेजी में काफी पढ़ने योग्य है।		शब्दार्थ, यह दस्तावेज़ एक "पुस्तक" है, जिसमें "शीर्षक" होता है, जिसमें दो "अध्याय" होते हैं, जिनमें से प्रत्येक का अपना "शीर्षक" होता है"। उन "अध्याय" में "पैराग्राफ" होते हैं जिनमें पाठ होता है। मार्कअप अंग्रेजी में काफी पढ़ने योग्य है।

	अधिक विस्तार में कहें तो दस्तावेज़ का मूल तत्व <code>book</code>है। सभी डॉकबुक तत्व एक [[एक्सएमएल नेमस्पेस]] में हैं, इसलिए मूल तत्व में वर्तमान नेमस्पेस सेट करने के लिए एक एक्सएमएलएनएस विशेषता है। इसके अलावा, डॉकबुक दस्तावेज़ के मूल तत्व में एक संस्करण होना चाहिए जो उस प्रारूप के संस्करण को निर्दिष्ट करता है जिस पर दस्तावेज़ बनाया गया है।		अधिक विस्तार में कहें तो दस्तावेज़ का मूल तत्व <code>book</code>है। सभी डॉकबुक तत्व एक [[एक्सएमएल नेमस्पेस]] में हैं, इसलिए मूल तत्व में वर्तमान नेमस्पेस सेट करने के लिए एक एक्सएमएलएनएस विशेषता है। इसके अलावा, डॉकबुक दस्तावेज़ के मूल तत्व में एक संस्करण होना चाहिए जो उस प्रारूप के संस्करण को निर्दिष्ट करता है जिस पर दस्तावेज़ बनाया गया है।
Line 92:		Line 92:
	=== प्री डॉकबुक v5.0 ===		=== प्री डॉकबुक v5.0 ===

	डॉकबुक 5 तक, डॉकबुक को एक दस्तावेज़ प्रकार परिभाषा (डीटीडी) द्वारा मानक रूप से परिभाषित किया गया था। क्योंकि डॉकबुक मूल रूप से एसजीएमएल के एक आवेदन के रूप में बनाया गया था, डीटीडी एकमात्र उपलब्ध स्कीमा भाषा ~~थी.~~ डॉकबुक 4.x प्रारूप एसजीएमएल या एक्सएमएल हो सकते हैं, लेकिन एक्सएमएल संस्करण का अपना नाम क्षेत्र नहीं ~~है.~~		डॉकबुक 5 तक, डॉकबुक को एक दस्तावेज़ प्रकार परिभाषा (डीटीडी) द्वारा मानक रूप से परिभाषित किया गया था। क्योंकि डॉकबुक मूल रूप से एसजीएमएल के एक आवेदन के रूप में बनाया गया था, डीटीडी एकमात्र उपलब्ध स्कीमा भाषा थी। डॉकबुक 4.x प्रारूप एसजीएमएल या एक्सएमएल हो सकते हैं, लेकिन एक्सएमएल संस्करण का अपना नाम क्षेत्र नहीं है।

	डॉकबुक 4.x प्रारूपों को डीटीडी द्वारा परिभाषित प्रतिबंधों के भीतर रहना था। सबसे महत्वपूर्ण प्रतिबंध यह था कि किसी तत्व का नाम विशिष्ट रूप से उसकी संभावित सामग्री को परिभाषित करता है। यानी, <code>info</code> नाम के तत्व में वही जानकारी होनी चाहिए, चाहे वह डॉकबुक फ़ाइल में कहीं भी हो। इस प्रकार, डॉकबुक 4.x में कई प्रकार के सूचना तत्व हैं: <code>bookinfo</code>, <code>chapterinfo</code>, आदि। प्रत्येक का सामग्री मॉडल थोड़ा अलग है, लेकिन वे अपने कुछ सामग्री मॉडल साझा करते हैं। इसके अतिरिक्त, वे संदर्भ संबंधी जानकारी को दोहराते हैं। पुस्तक का <code>info</code> तत्व वह है, क्योंकि यह पुस्तक का प्रत्यक्ष संतान है; इसे विशेष रूप से मानव पाठक के लिए नाम देने की आवश्यकता नहीं है। हालाँकि, क्योंकि प्रारूप को डीटीडी द्वारा परिभाषित किया गया था, इसलिए इसे इस प्रकार नाम देना पड़ा। रूट तत्व के पास कोई संस्करण नहीं है या उसे इसकी आवश्यकता नहीं है, क्योंकि संस्करण प्री-डॉकबुक 5 दस्तावेज़ के शीर्ष पर डीटीडी घोषणा में बनाया गया है।		डॉकबुक 4.x प्रारूपों को डीटीडी द्वारा परिभाषित प्रतिबंधों के भीतर रहना था। सबसे महत्वपूर्ण प्रतिबंध यह था कि किसी तत्व का नाम विशिष्ट रूप से उसकी संभावित सामग्री को परिभाषित करता है। यानी, <code>info</code> नाम के तत्व में वही जानकारी होनी चाहिए, चाहे वह डॉकबुक फ़ाइल में कहीं भी हो। इस प्रकार, डॉकबुक 4.x में कई प्रकार के सूचना तत्व हैं: <code>bookinfo</code>, <code>chapterinfo</code>, आदि। प्रत्येक का सामग्री मॉडल थोड़ा अलग है, लेकिन वे अपने कुछ सामग्री मॉडल साझा करते हैं। इसके अतिरिक्त, वे संदर्भ संबंधी जानकारी को दोहराते हैं। पुस्तक का <code>info</code> तत्व वह है, क्योंकि यह पुस्तक का प्रत्यक्ष संतान है; इसे विशेष रूप से मानव पाठक के लिए नाम देने की आवश्यकता नहीं है। हालाँकि, क्योंकि प्रारूप को डीटीडी द्वारा परिभाषित किया गया था, इसलिए इसे इस प्रकार नाम देना पड़ा। रूट तत्व के पास कोई ''संस्करण'' नहीं है या उसे इसकी आवश्यकता नहीं है, क्योंकि संस्करण प्री-डॉकबुक 5 दस्तावेज़ के शीर्ष पर डीटीडी घोषणा में बनाया गया है।

	डॉकबुक 4.x दस्तावेज़ डॉकबुक 5 के साथ संगत नहीं हैं, लेकिन एक्सएसएलटी स्टाइलशीट के माध्यम से डॉकबुक 5 दस्तावेजों में परिवर्तित किया जा सकता ~~है.~~ एक ( <code>db4-upgrade.xsl</code>) डॉकबुक 5 स्कीमा और विनिर्देश पैकेज के वितरण के हिस्से के रूप में प्रदान किया गया है।<ref>Jirka Kosek, Norman Walsh, Dick Hamilton, and Michael Smith, ''DocBook V5.0: The Transition Guide'', 16 June 2009, [http://docbook.org/docs/howto/#convert4to5 Converting DocBook V4.x documents to DocBook V5.0]</ref>		डॉकबुक 4.x दस्तावेज़ डॉकबुक 5 के साथ संगत नहीं हैं, लेकिन एक्सएसएलटी स्टाइलशीट के माध्यम से डॉकबुक 5 दस्तावेजों में परिवर्तित किया जा सकता है। एक ( <code>db4-upgrade.xsl</code>) डॉकबुक 5 स्कीमा और विनिर्देश पैकेज के वितरण के हिस्से के रूप में प्रदान किया गया है।<ref>Jirka Kosek, Norman Walsh, Dick Hamilton, and Michael Smith, ''DocBook V5.0: The Transition Guide'', 16 June 2009, [http://docbook.org/docs/howto/#convert4to5 Converting DocBook V4.x documents to DocBook V5.0]</ref>
	== आउटपुट स्वरूप ==		== आउटपुट स्वरूप ==


	डॉकबुक फ़ाइलों का उपयोग विभिन्न प्रकार के स्वरूपों में आउटपुट फ़ाइलों को तैयार करने के लिए किया जाता है। लगभग हमेशा, यह [[DocBook XSL\|डॉकबुक XSL]] स्टाइलशीट का उपयोग करके पूरा किया जाता है। ये XSLT स्टाइलशीट हैं जो डॉकबुक डॉक्युमेंटों को कई स्वरूपों (HTML, [[XSL-FO]] को बाद में [[PDF]] में बदलने के लिए, आदि) में रूपांतरित करती हैं। सामग्री, शब्दावलियों और अनुक्रमणिकाओं की तालिकाएँ बनाने के लिए ये स्टाइलशीट पर्याप्त रूप से परिष्कृत हो सकती हैं। वे एक ही डॉक्युमेंट के विभिन्न संस्करणों (जैसे एक ट्यूटोरियल या एक त्वरित-संदर्भ मार्गदर्शिका, जहां इनमें से प्रत्येक में सामग्री का एक सबसेट शामिल है) के विभिन्न संस्करणों का निर्माण करने के लिए एक मास्टर डॉक्युमेंट के विशेष निर्दिष्ट भागों के चयन की देखरेख कर सकते हैं। उपयोगकर्ता अपनी आवश्यकताओं के अनुसार उपयुक्त आउटपुट स्वरूप में डॉकबुक को संसाधित करने के लिए अपनी स्वयं की अनुकूलित स्टाइलशीट या यहां तक कि एक पूर्ण कार्यक्रम भी लिख सकते हैं।

			डॉकबुक फाइलों का उपयोग विभिन्न प्रकार के प्रारूपों में आउटपुट फाइलें तैयार करने के लिए किया जाता है। लगभग हमेशा, यह [[DocBook XSL\|डॉकबुक]] एक्सएसएल स्टाइलशीट का उपयोग करके पूरा किया जाता है। ये एक्सएसएलटी स्टाइलशीट हैं जो डॉकबुक दस्तावेजों को कई प्रारूपों में परिवर्तित करती हैं (एचटीएमएल, बाद में पीडीएफ में रूपांतरण के लिए एक्सएसएल-एफओ, आदि)। ये स्टाइलशीट सामग्री, शब्दावलियों और अनुक्रमणिका की तालिकाएँ उत्पन्न करने के लिए पर्याप्त रूप से परिष्कृत हो सकती हैं। वे एक ही दस्तावेज़ के विभिन्न संस्करण (जैसे कि "ट्यूटोरियल" या "त्वरित-संदर्भ मार्गदर्शिका", जहां इनमें से प्रत्येक में सामग्री का एक सबसेट शामिल होता है) तैयार करने के लिए मास्टर दस्तावेज़ के विशेष निर्दिष्ट भागों के चयन की देखरेख कर सकते हैं। उपयोगकर्ता अपनी आवश्यकताओं के अनुसार डॉकबुक को उचित आउटपुट प्रारूप में संसाधित करने के लिए अपनी स्वयं की अनुकूलित स्टाइलशीट या एक पूर्ण प्रोग्राम भी लिख सकते हैं।

			नॉर्मन वॉल्श और डॉकबुक प्रोजेक्ट डेवलपमेंट टीम डॉकबुक स्रोत दस्तावेजों से उत्पादन के लिए महत्वपूर्ण आवेदन को बनाए रखती है: [[एक्सएसएलटी]] स्टाइलशीट का एक सेट (और साथ ही [[डीएसएसएसएल]] स्टाइलशीट) की विरासत सेट जो उच्च गुणवत्ता वाले एचटीएमएल और प्रिंट (एफओ/पीडीएफ) आउटपुट, साथ ही अन्य प्रारूपों में आउटपुट उत्पन्न कर सकता है। आरटीएफ, मैन पेज और एचटीएमएल हेल्प शामिल हैं।

	~~नॉर्मन वॉल्श और~~ डॉकबुक ~~प्रोजेक्ट डेवलपमेंट टीम डॉकबुक स्रोत डॉक्युमेंटों से~~ आउटपुट ~~तैयार करने~~ के लिए ~~महत्वपूर्ण एप्लिकेशन को बनाए रखती है~~: ~~[[एक्सएसएलटी~~]~~] स्टाइलशीट्स~~ का एक सेट (साथ ही [[डीएसएसएसएल]] स्टाइलशीट्स का एक विरासत सेट) जो उच्च गुणवत्ता वाले एचटीएमएल और ~~प्रिंट ([[~~ एक्सएसएल स्वरूपण ऑब्जेक्ट्स ]]/ पोर्टेबल डॉक्युमेंट स्वरूप) आउटपुट, साथ ही [[रिच टेक्स्ट फ़ॉर्मैट]], [[मैन पेज]] और HTML सहायता सहित अन्य स्वरूपों में आउटपुट।		वेब सहायता<ref name="webhelp-1.76.1" /> डॉकबुक एक्सएसएल स्टाइलशीट में एक विभाजित एचटीएमएल आउटपुट प्रारूप है जिसे संस्करण 1.76.1 में पेश किया गया था. वेब सहायता के लिए प्रलेखन<ref>[http://docbook.sourceforge.net/release/xsl/current/webhelp/docs/index.html Web help documentation]</ref> भी वेब सहायता का एक उदाहरण प्रदान करता है और डॉकबुक एक्सएसएल वितरण का हिस्सा है।

	वेब सहायता<ref name=webhelp-1.76.1 />डॉकबुक XSL स्टाइलशीट में खंडित HTML आउटपुट स्वरूप है जिसे 1.76.1 संस्करण में पेश किया गया था। वेब सहायता के लिए डॉक्युमेंटीकरण<ref>[http://docbook.sourceforge.net/release/xsl/current/webhelp/docs/index.html Web help documentation]</ref> वेब सहायता का एक उदाहरण भी प्रदान करता है और यह डॉकबुक XSL वितरण का भाग है।		प्रमुख विशेषताएं इसका पूरी तरह से सीएसएस-आधारित पेज लेआउट, सहायता सामग्री की खोज और संक्षिप्त-वृक्ष रूप में सामग्री की एक तालिका हैं। खोज में स्टेमिंग, मैच हाइलाइटिंग, स्पष्ट पेज स्कोरिंग और मानक बहुभाषी टोकननाइज़र है। खोज और टीओसी एक फलक में हैं जो एक फ्रेमसेट के रूप में दिखाई देता है लेकिन वास्तव में इसे डिव [[डिव और स्पैन\|डिव]] और कुकीज़ के साथ कार्यान्वित किया जाता है (ताकि यह प्रगतिशील हो)।

	~~इसकी~~ प्रमुख ~~विशेषताएँ हैं~~ इसका ~~पूर्ण रूप~~ से ~~CSS~~-आधारित ~~पृष्ठ~~ लेआउट, सहायता सामग्री की खोज, और संक्षिप्त-वृक्ष रूप में सामग्री की ~~तालिका।~~ खोज में ~~[[उत्पन्न]]~~, मैच हाइलाइटिंग, स्पष्ट ~~पृष्ठ-~~स्कोरिंग और मानक बहुभाषी ~~[[टोकनकरण (शाब्दिक विश्लेषण)]]~~ है। खोज और टीओसी एक फलक में हैं जो एक ~~[[ फ़्रेमसेट (एचटीएमएल) ]]~~ के रूप में दिखाई देता है, लेकिन वास्तव में इसे [[डिव और स्पैन]] और कुकीज़ के साथ ~~लागू~~ किया जाता है (ताकि यह प्रगतिशील हो)।

	== सरलीकृत डॉकबुक ==		== सरलीकृत डॉकबुक ==

alpha>Sweta: /* प्री डॉकबुक v5.0 */

2023-06-28T10:32:12Z

प्री डॉकबुक v5.0

Show changes