Guidedog / दस्तावेज़
0.2.0
रीडर, रेंडरर और बिल्डर¶
रीडर सोर्स भाषा समझता है। रेंडरर एक दस्तावेज़ वृक्ष लिखता है। बिल्डर प्रोजेक्ट का संयोजन और प्रकाशन करता है। ये अलग ज़िम्मेदारियाँ हैं।
| इनपुट | रीडर | रास्ता |
|---|---|---|
| परियोजना में RST | RST और बिल्ट-इन Sphinx परत | परियोजना ग्राफ़ से HTML, Typst/PDF, पाठ या कैटलॉग बनते हैं। |
| परियोजना में Markdown | MyST-संगत Markdown परत | वही परियोजना ग्राफ़ और बिल्डर। |
convert file.md |
डिफ़ॉल्ट रूप में CommonMark | एक दस्तावेज़ से HTML या Typst/PDF। |
convert file.typ |
नेटिव Typst अडैप्टर | Guidedoc के सिमैंटिक वृक्ष से बाहर Typst कम्पाइल करना। |
बिल्डर¶
html-
हर दस्तावेज़ की HTML फ़ाइल, इंडेक्स, खोज और इन्वेंटरी सहित।
dirhtml-
निर्देशिका जैसे दस्तावेज़ URL।
singlehtml-
दस्तावेज़ खंड और स्थानीय संदर्भ वाली एक मुख्य HTML पृष्ठ।
pdf-
परियोजना में तय Typst किताबें। LaTeX बिल्डर के एलियस यही रास्ता चुनते हैं।
text-
दस्तावेज़ों की सादे पाठ की फ़ाइलें।
gettext-
अनुवाद के संदेश टेम्पलेट।
dummy-
आर्टिफ़ैक्ट प्रकाशित किए बिना परियोजना पढ़ता और संदर्भ हल करता है।
कवरेज एक प्रमाण है¶
guidedog formats प्रोग्राम के वास्तविक अडैप्टर बताता है। संगतता पेज निश्चित टेस्ट और वास्तविक प्रोजेक्ट जाँच दर्ज करता है। CommonMark पास होना पूरा MyST समर्थन नहीं; RST पढ़ना हर Python एक्सटेंशन का व्यवहार नहीं। Sphinx के साथ संगतता देखें।