स्फिंक्स टक्ट्री में स्वयं का उपयोग करने में उप-वर्ग

Question

शामिल नहीं है मैं मुख्य (index.rst) पृष्ठ को शामिल करने के लिए स्फिंक्स में अपने सिद्धांत को पसंद करूंगा। दस्तावेजों का सुझाव है कि 'स्वयं' समेत यह किया जाएगा, लेकिन जैसा कि अन्य ने स्टैक ओवरफ्लो पर ध्यान दिया है, इसमें केवल मुख्य पृष्ठ का शीर्षक शामिल है, ताकि यदि गहराई> 1 मुख्य पृष्ठ के लिए व्यवहार लिंक किए गए पृष्ठों से अलग है।

मैंने इस मुद्दे के लिए सुझाए गए सामग्री निर्देश भी देखे हैं, मेरे लिए यह सिर्फ सामग्री की एक अलग स्थानीय सूची बनाता है और टक्ट्री के साथ मदद नहीं करता है। मैं वास्तव में ऐसे समाधान की तलाश में हूं जो टक्ट्री में लगातार व्यवहार करता है। क्या कोई है?

Answer 1

शाब्दिक self सहित, जैसा कि आपने उल्लेख किया है, वर्तमान दस्तावेज़ का शीर्षक जोड़ता है। हालांकि, वर्तमान दस्तावेज़ के शीर्षक सहित वास्तव में इसे पेड़ में जोड़ दिया जाता है। उदाहरण के लिए,

.. toctree:: 
    :maxdepth: 2 

    index 

आपके इच्छित परिणाम का उत्पादन करेगा। मुझे यकीन नहीं है कि यह कहीं भी दस्तावेज़ीकरण में स्पष्ट रूप से क्यों सूचीबद्ध नहीं है।