सामग्री पर जाएँ
Topos Uranos
हिन्दी

दस्तावेज़ की संरचना: सारांश और चुनौतियाँ

सारांश

यह पाठ पाठ्यक्रम की तीसरी इकाई को समाप्त करता है, जो दस्तावेज़ की संरचना को समर्पित है। यह उन निर्णयों और क्रियाविधियों की शृंखला को फिर से गढ़ता है जो दस्तावेज़ की क्लास से अपनी प्रस्तावना तक जाती है, और हर कड़ी पर बताता है कि कौन-सा सिद्धांत प्रयुक्त होता है और वह किस पाठ में स्थापित होता है; उपलब्धियों को पाठ्यक्रम की योजना के सापेक्ष रखता है और स्पष्ट करता है कि कौन-से प्रश्न, जिनका केवल पूर्वाभास दिया गया, आगे की इकाइयों के लिए रहते हैं; अपने समापन मूल्यांकन में प्रवेश मूल्यांकन के कौशलों को दोहराता है; और छह चुनौतियों के साथ समाप्त होता है, जो पाठों के प्रश्नों से कठिन हैं और जिनमें उनमें से कई को मिलाना पड़ता है: किसी शोध-प्रबंध की योजना उसके नियमों के आधार पर बनाना, किसी पुस्तक के क्रमांकन और संदर्भों का पूर्वानुमान लगाना, और कई फ़ाइलों में बँटे ऐसे दस्तावेज़ों का निदान करना जो विफल होते हैं या झूठ बोलते हैं।

अधिगम उद्देश्य

  1. इकाई के निर्णयों और क्रियाविधियों का क्रम फिर से गढ़ना, और पहचानना कि हर एक किस सिद्धांत पर टिका है।
  2. समझाना कि क्रमांकन, विषय-सूची, संदर्भ और आंशिक कंपाइल सहायक फ़ाइलों पर कैसे निर्भर करते हैं।
  3. उसमें भेद करना जो इकाई ने स्थापित किया और जिसका उसने केवल पूर्वाभास दिया तथा जिसे आगे की इकाइयाँ विकसित करेंगी।
  4. कई फ़ाइलों में बँटे ऐसे दस्तावेज़ों का निदान करना जो विफल होते हैं या झूठी संख्याओं के साथ कंपाइल होते हैं, और सुधारों को क्रम में रखना।
  5. किसी शोध-प्रबंध की क्लास, पृष्ठ, भागों, संदर्भों और फ़ाइलों की योजना उन नियमों के आधार पर बनाना जिनका उसे पालन करना है।

इकाई की उपलब्धियाँ

इकाई का उद्देश्य दस्तावेज़ को ऐसी वास्तुकला देना था जिसकी संख्याएँ, विषय-सूची और संदर्भ उसके सभी बदलावों में सच्चे बने रहें। यह उद्देश्य उस पर टिककर पूरा हुआ जिसे परिचय ने पिछली इकाइयों से ज्ञात माना था: कंपाइल के पास, प्रस्तावना और मुख्य भाग का विभाजन, और तार्किक मार्कअप। इस प्रकार तय किया गया मार्ग पाँच खंडों वाली एक ही शृंखला के रूप में पढ़ा जा सकता है।

दस्तावेज़ क्लास और पृष्ठ

दस्तावेज़ क्लास और पृष्ठ वाले पाठ ने स्थापित किया कि क्लास तय करती है कि कौन-से विभाजन होते हैं, \maketitle क्या करता है, सारांश होता है या नहीं, और सम पृष्ठ विषम पृष्ठों से अलग होते हैं या नहीं; इससे उसने संरचना और छपाई के आधार पर article, report और book में से चुनने की एक कसौटी निकाली, और KOMA-Script की क्लासें प्रस्तुत कीं, उस es-noquoting विकल्प के साथ जिसकी माँग इन उदाहरणों के TeX Live संस्करण में स्पेनिश के साथ उनका मेल करता है। उसने क्लास के विकल्पों को देखा, समझाया कि हाशिये पंक्ति की लंबाई पर क्यों निर्भर करते हैं और geometry से उन्हें कैसे तय करें, और अंत में पृष्ठ शैलियों पर आया, जिन्हें क्लास के कुछ कमांड अपनी ओर से थोप देते हैं।

अनुभाग, विषय-सूची और परिशिष्ट

अनुभाग, विषय-सूची और परिशिष्ट वाले पाठ ने शीर्षक का डेटा और सारांश टाइपसेट किए, विभाजन के स्तरों को क्रम में रखा और स्थापित किया कि दो स्वतंत्र काउंटर, secnumdepth और tocdepth, तय करते हैं कि क्या क्रमांकित होगा और क्या विषय-सूची में जाएगा। उसने समझाया कि विषय-सूची उससे बनती है जो पिछले पास ने दर्ज किया, और पुरानी पड़ जाने पर कोई चेतावनी नहीं देती; कि \appendix अपने बाद आने वाली चीज़ों का क्रमांकन बदल देता है; और कि किसी पुस्तक के तीन भाग होते हैं, पृष्ठों की दो संख्या-व्यवस्थाओं के साथ, जिनका क्रम उदासीन नहीं है।

क्रॉस-संदर्भ

क्रॉस-संदर्भ वाले पाठ ने वह सिद्धांत स्थापित किया जिस पर हर संदर्भ निर्भर है: लेबल अपने से पहले, अपने परिवेश के भीतर, दी गई अंतिम संख्या दर्ज करता है। इससे उसने निकाला कि हर तत्व में लेबल कहाँ जाता है, चित्र के कैप्शन से पहले रखा लेबल अनुभाग का संदर्भ क्यों देता है, और बिना संख्या वाले अनुभाग की अपनी कोई संख्या क्यों नहीं होती जिसका संदर्भ दिया जा सके। उसने दिखाया कि किसी बदलाव के बाद एक ही कंपाइल पुरानी संख्याएँ पूरी तरह सही दिखते रूप में छापता है, और hyperref प्रस्तुत किया, जिसे पैकेजों के अंत में लोड करना होता है, और cleveref, जो उसके बाद आता है और जो, जब तक \crefname हिंदी नाम तय न करे, अंग्रेज़ी नाम लिखता है।

लंबे दस्तावेज़

लंबे दस्तावेज़ों वाले पाठ ने एक दस्तावेज़ को एक मुख्य फ़ाइल और बिना प्रस्तावना वाले टुकड़ों में बाँटा। उसने \input में, जो एक अक्षरशः प्रतिस्थापन है, और \include में भेद किया, जो पृष्ठ खोलता है, अपनी सहायक फ़ाइल लिखता है और \includeonly स्वीकार करता है, जिसका क्रमांकन किसी पिछले पूर्ण कंपाइल की सहायक फ़ाइलों पर निर्भर करता है। उसने स्थापित किया कि पथ मुख्य फ़ाइल के फ़ोल्डर से लिखे जाते हैं, कि Texmaker में मास्टर दस्तावेज़ घोषित किया जाता है, और बँटे हुए दस्तावेज़ों की अपनी त्रुटियाँ देखीं, जिनमें दो मौन हैं: वह टुकड़ा जिसे \include नहीं ढूँढ़ पाता, और प्रस्तावना वाला टुकड़ा, जिसका \end{document} शोध-प्रबंध को समाप्त कर देता है।

मैक्रो और अपनी प्रस्तावना

मैक्रो और अपनी प्रस्तावना वाले पाठ ने तार्किक मार्कअप को एक पद्धति बना दिया: आर्ग्युमेंट वाले और एक वैकल्पिक आर्ग्युमेंट वाले \newcommand, वह सुरक्षा जो किसी घिरे हुए नाम को फिर से परिभाषित करने से रोकती है, बिना आर्ग्युमेंट वाले कमांड के बाद खो जाने वाली जगह, \NewDocumentCommand, अपने परिवेश, जिनके आर्ग्युमेंट केवल आरंभ में होते हैं, और किसी फ़ाइल या पैकेज में ले जाई गई प्रस्तावना, जिसे क्लास, भाषा या hyperref का स्थान नहीं थोपना चाहिए।

नीचे का चित्र पाँचों खंडों को एक ही शृंखला में जोड़ता है। स्तंभ की हर गाँठ एक निर्णय या क्रियाविधि है, उस क्रम में क्रमांकित जिसमें वे एक-दूसरे पर टिके हैं, और एक चाप से उन पिछली कड़ियों से जुड़ी है जिनका वह उपयोग करती है; चारों ओर आधार तैरते हैं, अर्थात् वे सिद्धांत जिनका सहारा शृंखला बार-बार लेती है, हर एक ठोस रेखा से उन कड़ियों से जुड़ा जो उस पर टिकी हैं और बिंदुदार रेखा से उस कड़ी से जहाँ वह स्थापित होता है, सिवाय उनके जो पिछली इकाइयों में स्थापित हुए, जो छल्लों के रूप में बनाए गए हैं। किसी आधार पर क्लिक करने से वे सभी कड़ियाँ उभर आती हैं जो उसका उपयोग करती हैं, और हर कड़ी उस पाठ की ओर ले जाती है जिसमें उसका अध्ययन होता है।

शृंखला के आधार

  • Aपास. इंजन एक पास में संख्याएँ, शीर्षक और पृष्ठ सहायक फ़ाइलों में दर्ज करता है, और अगले पास में उनका उपयोग करता है। पहली इकाई में स्थापित। इस इकाई में बिना प्रमाण के स्वीकार किया गया।
  • Bप्रस्तावना और मुख्य भाग. प्रस्तावना सेटिंग करती है और पैकेज लोड करती है, और मुख्य भाग टाइपसेट करता है; जो केवल परिभाषित या संग्रहित करता है वह दोनों में जा सकता है। पहली इकाई में स्थापित। इस इकाई में बिना प्रमाण के स्वीकार किया गया।
  • Cविषय-वस्तु और रूप. लेखक घोषित करता है कि हर चीज़ क्या है, और कहीं और लिया गया निर्णय तय करता है कि वह कैसी दिखती है। पिछली इकाइयों में स्थापित। इस इकाई में बिना प्रमाण के स्वीकार किया गया।
  • Dक्लास तय करती है. दस्तावेज़ की क्लास तय करती है कि कौन-से विभाजन होते हैं, शीर्षक क्या टाइपसेट करता है, सारांश होता है या नहीं, पृष्ठ कैसे बँटते हैं और उसके कमांड कौन-सी शैली थोपते हैं। स्थापित होता है: 1. तीन मानक क्लासें.
  • Eलेबल क्या दर्ज करता है. लेबल अपने से पहले, अपने परिवेश के भीतर, दी गई अंतिम संख्या दर्ज करता है, यह जाने बिना कि वह किससे जुड़ा है। स्थापित होता है: 11. लेबल और संदर्भ.
  • Fलोड करने का क्रम. पैकेज उसी क्रम में लोड होते हैं जिसमें वे पढ़े जाते हैं, और बाद वाला पहले वाले का किया हुआ पलट सकता है: hyperref अंत में आता है, और cleveref उसके बाद। स्थापित होता है: 13. लिंक.
  • Gमुख्य फ़ाइल. कंपाइल हमेशा मुख्य फ़ाइल का होता है; टुकड़े उसके मुख्य भाग के अंश हैं, बिना प्रस्तावना के, और उनके पथ मुख्य फ़ाइल के फ़ोल्डर से लिखे जाते हैं। स्थापित होता है: 16. include कमांड.

  1. खंड 1 दस्तावेज़ क्लास और पृष्ठ

    • दस्तावेज़ की संरचना और छपाई के आधार पर क्लास चुनना।
    • क्लास के विकल्प घोषित करना और उनके प्रभाव का पूर्वानुमान लगाना।
    • पंक्ति को अत्यधिक लंबा किए बिना geometry से हाशिये तय करना।
    • पृष्ठ शैलियों, हेडरों और फ़ुटरों का पूर्वानुमान लगाना और उन्हें बदलना।

    1. तीन मानक क्लासें. article में अध्याय नहीं होते; report में होते हैं, अपने पृष्ठों पर शीर्षक और सारांश के साथ; book दोनों तरफ़ छापती है और उसमें सारांश नहीं होता।

      आधार: B (प्रस्तावना और मुख्य भाग). सिद्ध किया गया: दस्तावेज़ के क्लास और पृष्ठ.

    2. KOMA-Script. scrartcl, scrreprt और scrbook यूरोपीय निर्णयों के साथ मानक क्लासों के समकक्ष हैं; स्पेनिश में babel के साथ, इस संस्करण में, उन्हें es-noquoting विकल्प चाहिए।

      उपयोग करती है: 1. तीन मानक क्लासें. आधार: C (विषय-वस्तु और रूप). सिद्ध किया गया: दस्तावेज़ के क्लास और पृष्ठ.

    3. क्लास के विकल्प. काग़ज़, फ़ॉन्ट का आकार, एक या दो तरफ़, शीर्षक पृष्ठ, अध्यायों की शुरुआत और ड्राफ़्ट पहली पंक्ति में घोषित किए जाते हैं।

      उपयोग करती है: 1. तीन मानक क्लासें. आधार: D (क्लास तय करती है). सिद्ध किया गया: दस्तावेज़ के क्लास और पृष्ठ.

    4. हाशिये. geometry कुछ ही मापों से पृष्ठ की गणना करता है; पाठ-बॉक्स की चौड़ाई पंक्ति की लंबाई तय करती है, और वही पाठक झेलता है।

      उपयोग करती है: 3. क्लास के विकल्प. आधार: B (प्रस्तावना और मुख्य भाग). सिद्ध किया गया: दस्तावेज़ के क्लास और पृष्ठ.

    5. पृष्ठ शैलियाँ. शैली हेडर और फ़ुटर तय करती है; \maketitle और \chapter अपने पृष्ठ पर plain शैली थोपते हैं, और fancyhdr या scrlayer-scrpage अपनी शैलियाँ बनाते हैं।

      उपयोग करती है: 1. तीन मानक क्लासें, 4. हाशिये. आधार: D (क्लास तय करती है). सिद्ध किया गया: दस्तावेज़ के क्लास और पृष्ठ.

  2. खंड 2 अनुभाग, विषय-सूची और परिशिष्ट

    • क्लास के अनुसार शीर्षक और सारांश टाइपसेट करना।
    • विभाजन का स्तर चुनना और क्रमांकन तथा विषय-सूची का पूर्वानुमान लगाना।
    • विषय-सूची और सूचियाँ बनाना, यह जानते हुए कि वे किस पास पर निर्भर हैं।
    • परिशिष्टों और पुस्तक के भागों को क्रम में रखना।

    1. शीर्षक और सारांश. \title, \author और \date संग्रहित करते हैं, \maketitle टाइपसेट करता है; abstract परिवेश article और report में होता है, book में नहीं।

      उपयोग करती है: 1. तीन मानक क्लासें. आधार: D (क्लास तय करती है), B (प्रस्तावना और मुख्य भाग). सिद्ध किया गया: अनुभाग, विषय-सूची और परिशिष्ट.

    2. विभाजन के स्तर. सात स्तर, खंड से उप-अनुच्छेद तक; अध्याय केवल report और book में होता है, और पदानुक्रम शीर्षक के आकार के आधार पर नहीं चुना जाता।

      उपयोग करती है: 1. तीन मानक क्लासें. आधार: D (क्लास तय करती है). सिद्ध किया गया: अनुभाग, विषय-सूची और परिशिष्ट.

    3. क्रमांकन और विषय-सूची. secnumdepth तय करता है कि कौन-से स्तर क्रमांकित होंगे और tocdepth कि कौन-से विषय-सूची में जाएँगे; तारांकित रूप न क्रमांकित करता है, न कोई संख्या खर्च करता है।

      उपयोग करती है: 7. विभाजन के स्तर. आधार: C (विषय-वस्तु और रूप). सिद्ध किया गया: अनुभाग, विषय-सूची और परिशिष्ट.

    4. विषय-सूची और सूचियाँ. विषय-सूची वही टाइपसेट करती है जो पिछले पास ने .toc फ़ाइल में दर्ज किया, और पुरानी पड़ जाने पर चेतावनी नहीं देती।

      उपयोग करती है: 7. विभाजन के स्तर, 8. क्रमांकन और विषय-सूची. आधार: A (पास). सिद्ध किया गया: अनुभाग, विषय-सूची और परिशिष्ट.

    5. परिशिष्ट और पुस्तक के भाग. \appendix अपने बाद आने वाली चीज़ों का क्रमांकन बदलता है; book में प्रारंभिक पृष्ठों, मुख्य भाग और अंतिम पृष्ठों की दो पृष्ठ-संख्या व्यवस्थाएँ होती हैं, और परिशिष्ट \backmatter से पहले आते हैं।

      उपयोग करती है: 7. विभाजन के स्तर, 5. पृष्ठ शैलियाँ. आधार: D (क्लास तय करती है). सिद्ध किया गया: अनुभाग, विषय-सूची और परिशिष्ट.

  3. खंड 3 क्रॉस-संदर्भ

    • लेबल रखना और उनके नाम रखना।
    • अनुमान लगाना कि एक या दो पास के बाद संदर्भ क्या छापता है।
    • hyperref और cleveref को उनके क्रम में लोड करना।
    • नाम और संख्या के साथ, या शीर्षक से, संदर्भ देना।

    1. लेबल और संदर्भ. \label किसी स्थान को चिह्नित करता है, \ref और \pageref उसकी संख्या और पृष्ठ लिखते हैं, दो पास में।

      उपयोग करती है: 7. विभाजन के स्तर. आधार: A (पास). सिद्ध किया गया: क्रॉस-संदर्भ.

    2. लेबल कहाँ जाता है. संख्या देने वाले कमांड के बाद और उसी परिवेश के भीतर: \section के बाद, \caption के बाद; ऐसे उपसर्ग के साथ जो बताए कि वह किसे सूचित करता है।

      उपयोग करती है: 11. लेबल और संदर्भ. आधार: E (लेबल क्या दर्ज करता है). सिद्ध किया गया: क्रॉस-संदर्भ.

    3. लिंक. hyperref संदर्भों, विषय-सूची और पाद-टिप्पणियों को लिंक में और अनुभागों को बुकमार्क में बदलता है, और पैकेजों के अंत में लोड होता है।

      उपयोग करती है: 11. लेबल और संदर्भ, 9. विषय-सूची और सूचियाँ. आधार: B (प्रस्तावना और मुख्य भाग). सिद्ध किया गया: क्रॉस-संदर्भ.

    4. नाम वाले संदर्भ. cleveref नाम और संख्या लिखता है; हिंदी नामों के बिना वह अंग्रेज़ी नाम (“section”) लिखता है, और हिंदी नाम \crefname से तय होते हैं; nameref शीर्षक से संदर्भ देता है।

      उपयोग करती है: 13. लिंक, 12. लेबल कहाँ जाता है. आधार: E (लेबल क्या दर्ज करता है), F (लोड करने का क्रम). सिद्ध किया गया: क्रॉस-संदर्भ.

  4. खंड 4 लंबे दस्तावेज़

    • हर टुकड़े के लिए \input और \include में से चुनना।
    • पूर्वानुमान लगाना कि \includeonly क्या बनाए रखता है।
    • फ़ोल्डरों को व्यवस्थित करना और मास्टर दस्तावेज़ घोषित करना।
    • बँटे हुए दस्तावेज़ों की मुखर और मौन त्रुटियों को पहचानना।

    1. input कमांड. \input किसी फ़ाइल को ऐसे जोड़ता है मानो उसका पाठ उसी जगह लिखा हो, बिना पृष्ठ तोड़े और बिना सहायक फ़ाइलें बनाए।

      आधार: B (प्रस्तावना और मुख्य भाग). सिद्ध किया गया: लंबे दस्तावेज़.

    2. include कमांड. \include पहले और बाद में पृष्ठ खोलता है, हर टुकड़े के लिए अपनी सहायक फ़ाइल लिखता है और नेस्ट नहीं किया जा सकता।

      उपयोग करती है: 15. input कमांड, 7. विभाजन के स्तर. आधार: A (पास). सिद्ध किया गया: लंबे दस्तावेज़.

    3. आंशिक कंपाइल. \includeonly केवल चुने हुए टुकड़े टाइपसेट करता है और बाकी को उनकी सहायक फ़ाइलों से क्रमांकित करता है, जो उनके अंतिम बदलाव के बाद के किसी पूर्ण कंपाइल से आनी चाहिए।

      उपयोग करती है: 16. include कमांड, 11. लेबल और संदर्भ. आधार: A (पास). सिद्ध किया गया: लंबे दस्तावेज़.

    4. फ़ोल्डर और मास्टर दस्तावेज़. मूल में एक मुख्य फ़ाइल, फ़ोल्डरों में टुकड़े, मुख्य फ़ाइल से पथ, सरल नाम, और Texmaker में मुख्य फ़ाइल मास्टर दस्तावेज़ के रूप में।

      उपयोग करती है: 16. include कमांड. आधार: G (मुख्य फ़ाइल). सिद्ध किया गया: लंबे दस्तावेज़.

    5. बँटे दस्तावेज़ों की त्रुटियाँ. फ़ाइल के बिना \input कंपाइल रोक देता है; फ़ाइल के बिना \include केवल “No file” दर्ज करता है; प्रस्तावना वाला टुकड़ा अपने \end{document} पर शोध-प्रबंध समाप्त कर देता है।

      उपयोग करती है: 16. include कमांड, 18. फ़ोल्डर और मास्टर दस्तावेज़. आधार: G (मुख्य फ़ाइल), B (प्रस्तावना और मुख्य भाग). सिद्ध किया गया: लंबे दस्तावेज़.

  5. खंड 5 मैक्रो और अपनी प्रस्तावना

    • आर्ग्युमेंट वाले और एक वैकल्पिक आर्ग्युमेंट वाले कमांड परिभाषित करना।
    • परिभाषित करने, फिर से परिभाषित करने और उपलब्ध कराने में भेद करना, और खोई जगह से बचना।
    • अपने परिवेश परिभाषित करना।
    • प्रस्तावना को किसी फ़ाइल या पैकेज में इकट्ठा करना।

    1. अपने कमांड. \newcommand अधिकतम नौ आर्ग्युमेंट वाला कमांड परिभाषित करता है, जिनमें पहला अपने डिफ़ॉल्ट मान के साथ वैकल्पिक हो सकता है; यह दोहराए जाने वाले किसी कार्य को नाम देता है।

      आधार: C (विषय-वस्तु और रूप). सिद्ध किया गया: मैक्रो और अपनी प्रस्तावना.

    2. घिरे हुए नाम और जगहें. \newcommand किसी मौजूदा नाम को अस्वीकार करता है और \renewcommand किसी अनुपस्थित नाम को; बिना आर्ग्युमेंट वाला कमांड अपने बाद की जगह खा जाता है।

      उपयोग करती है: 20. अपने कमांड. आधार: B (प्रस्तावना और मुख्य भाग). सिद्ध किया गया: मैक्रो और अपनी प्रस्तावना.

    3. अपने परिवेश. \newenvironment आरंभ और समापन परिभाषित करता है; उसके आर्ग्युमेंट केवल आरंभ में होते हैं, और \NewDocumentEnvironment उन्हें समापन में भी स्वीकार करता है।

      उपयोग करती है: 20. अपने कमांड. आधार: C (विषय-वस्तु और रूप). सिद्ध किया गया: मैक्रो और अपनी प्रस्तावना.

    4. अपनी प्रस्तावना. प्रस्तावना को \input से पढ़ी जाने वाली फ़ाइल में या .sty पैकेज में ले जाया जाता है, जो क्लास, भाषा या hyperref का स्थान नहीं थोपता।

      उपयोग करती है: 20. अपने कमांड, 21. घिरे हुए नाम और जगहें, 15. input कमांड, 13. लिंक. आधार: F (लोड करने का क्रम), C (विषय-वस्तु और रूप). सिद्ध किया गया: मैक्रो और अपनी प्रस्तावना.

गणित की ओर. शृंखला वहाँ रुकती है जहाँ वास्तुकला पूरी है और उसे भरना बाकी है: क्रमांकित समीकरण और प्रमेय, जिनका संदर्भ इस इकाई के लेबलों से दिया जाएगा, अगली इकाई का विषय हैं।