स्फिंक्स टक्ट्री या तो बॉडी में बुलेट सूची के साथ साइडबार में एक टीओसी प्रदर्शित करता है, या

Question

पर कुछ भी नहीं, मैं स्फिंक्स (स्फिंक्स-1.2 बी 1-पी 2 2.7) के साथ काम कर रहा हूं। मैं एक साइडबार में एक टीओसी दिखाना चाहता हूँ। यह बाइनरी लगता है: मैं केवल साइडबार में एक टीओसी और पाठ के शरीर में एक बुलेट सूची प्राप्त कर सकता हूं, या मुझे कुछ भी नहीं मिलता है (साइडबार में कोई टीओसी नहीं है और कोई बुलेट सूची नहीं है)।

जब मैं इस तरह toctree निर्देश का उपयोग करें:

.. toctree:: 
    :hidden: 

    Topic1 
    Topic2 

परिणाम: साइडबार में कोई टीओसी, कोई बुलेटेड शरीर में विषयों की सूची। साइडबार और शरीर में विषयों की एक बुलेटेड सूची में टीओसी:

.. toctree:: 

    Topic1 
    Topic2 

परिणाम:

जब मैं इस तरह toctree निर्देश का उपयोग करें।

मैं सिर्फ साइडबार में टीओसी चाहता हूं। अन्य आदेश (maxdepth, includehidden) काम नहीं करते हैं। मैंने इसे देखा है, लेकिन इसे काम नहीं कर सकता। Conf.py ठीक लग रहा है, लेकिन उत्तर के लिए खोज के कई दिनों के बाद कोई भाग्य नहीं है। धन्यवाद।

Answer 1

मुझे इसके साथ भी परेशानी थी; मुझे जवाब here मिला।

टीओसी को toctree() पर कॉल के माध्यम से दिखाया गया है, उदाहरण के लिए, layout.html नामक एक फ़ाइल।

{% block sidebartoc %} 
<h3>{{ _('Table Of Contents') }}</h3> 
{{ toctree() }} 
{% endblock %} 

जब से मैं एक विषय का उपयोग कर रहा, layout.html निर्देशिका _themes अंदर विषय निर्देशिका के भीतर है: विशेष रूप से, यह निम्नलिखित के समान कोड का एक टुकड़ा है, जो <div class="sidebar"> में रहता है के माध्यम से साइडबार में दिखाया गया है ; अन्यथा layout.html निर्देशिका _templates के अंदर हो सकता है।

स्फिंक्स के नए संस्करण में, क्या टीओसी प्रदर्शित करने के लिए की जरूरत है :hidden: के रूप में

.. toctree:: 
    :hidden: 

toctree() करने के लिए कॉल करने के लिए तर्क includehidden=True जोड़ने के लिए है, के रूप में

{% block sidebartoc %} 
<h3>{{ _('Table Of Contents') }}</h3> 
{{ toctree(includehidden=True) }} 
{% endblock %}