मेरे पास ऐसा कुछ है:

.. toctree::
   :maxdepth: 2
   :caption: Contents:
   :hidden:
   :glob:

   docs
   frontend
   backend
   tools/*

मैं चाहता हूं कि tools निर्देशिका में पाए गए सभी दस्तावेज़ एक विस्तार योग्य साइडबार TOC प्रविष्टि में संक्षिप्त हो जाएं। संभव होना चाहिए, लेकिन मुझे कोई सुराग नहीं मिल रहा है।

मैं sphinx_rtd_theme का उपयोग करता हूं।

इसे दूसरे तरीके से रखने के लिए: मान लीजिए कि मेरे पास इस तरह का एक बहुत लंबा दस्तावेज़ है (tools.rst):

Section 1
*********

Subsection 1
============

Subsection 2
============

Subsection 3
============

मैं इसे उपखंड द्वारा कैसे विभाजित कर सकता हूं और दस्तावेज़ संरचना को संरक्षित करने के लिए, बिना शामिल किए, जो वैसे भी स्फिंक्स के साथ अच्छी तरह से नहीं बैठता है।

0
Alexey Orlov 15 पद 2020, 20:40
आपका "बहुत लंबा दस्तावेज़" कहाँ है? क्या यह tools/example.rst है? क्या आप कह रहे हैं कि उपखंड साइडबार नेविगेशन में प्रकट नहीं होते हैं? क्या आपने :maxdepth: 3 की कोशिश की?
 – 
Steve Piercy
16 पद 2020, 11:53
नहीं। मेरे पास एक बहुत लंबा tools.rst है जिसमें मेरी source निर्देशिका में एक अनुभाग शीर्षक है; मैं इसे source/tools और में विभाजित करना चाहता हूं (एक एकल अनुभाग शीर्षक)। मैंने इसका प्रबंधन नहीं किया।
 – 
Alexey Orlov
16 पद 2020, 12:07
toctree में न तो tools.rst और न ही tools है। यही कारण है कि यह नेविगेशन में दिखाई नहीं देता है। toctree सूची में यह दिखाई देने के लिए आपके पास उनमें से एक होना चाहिए।
 – 
Steve Piercy
16 पद 2020, 13:41
ओह, यह केवल संपादित index.rst है। बेशक, tools.rst शुरू में index.rst में मौजूद था। मैंने इसे विभाजित करने और इसे source/tools और में स्थानांतरित करने और उपस्थिति और पदानुक्रम को संरक्षित करने का प्रबंधन नहीं किया। धारा अब उपखंडों की जड़ नहीं है। निर्देश शामिल करें, वैसे, काम करते हैं, लेकिन वे बदसूरत और बोझिल हैं।
 – 
Alexey Orlov
16 पद 2020, 14:05
कृपया अपने प्रश्नों को अपनी फाइलों की वर्तमान स्थिति और उनकी वर्तमान स्थिति के साथ आपको किस समस्या का सामना करना पड़ता है, के साथ अपडेट करें। मैं आपका बिल्कुल भी अनुसरण नहीं कर सकता।
 – 
Steve Piercy
16 पद 2020, 14:41

1 उत्तर

सबसे बढ़िया उत्तर

source/index.rst:

.. toctree::
   :maxdepth: 2
   :caption: Contents:
   :glob:

   tools/_tools
   docs
   frontend
   backend
   tmp/*

पुराना source/tools/_tools.rst:

Notes on tools
**************

.. include:: black.rst
.. include:: docker.rst
.. include:: git_hooks.rst
.. include:: github_webhooks.rst
.. include:: mypy.rst
.. include:: pipm.rst
.. include:: poetry.rst
.. include:: sphinx.rst
.. include:: uvicorn.rst

नया source/tools/_tools.rst:

Notes on tools
**************

.. toctree::
   :maxdepth: 2
   :glob:

   *

नया वाला बिल्कुल पुराने जैसा दिखता है, और अधिक बहुमुखी है और बहुत साफ है।

0
Alexey Orlov 16 पद 2020, 14:54