मैं स्फिंक्स में एक पदानुक्रमित दस्तावेज उत्पन्न करने की कोशिश कर रहा हूं।

मुझे निम्नलिखित संरचना चाहिए:

Introduction
Quick start
Weather API (one general page + 2 subpages)
  Temperature
  Humidity
Sky API (one general page + 3 subpages)
  Planets
  Stars
  Satellites
Future API (one page is enough for this)

यह मानते हुए कि उपरोक्त टीओसी में प्रत्येक पंक्ति में एक फ़ाइल है, इसे प्राप्त करने के लिए मुझे क्या करना चाहिए?

मैंने शीर्ष अनुक्रमणिका फ़ाइल में एक या अधिक .. toctree:: निर्देशों को शामिल करने का प्रयास किया, लेकिन परिणाम काफी यादृच्छिक प्रतीत होते हैं।

0
Jirka 13 फरवरी 2019, 21:03

1 उत्तर

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

एक निर्देशिका और फ़ाइल संरचना बनाएं जो निम्नलिखित toctree प्रविष्टियों के साथ संरेखित हो, लेकिन वास्तविक फ़ाइल नाम .rst प्रत्यय के साथ संलग्न हैं।

.. toctree::

    introduction
    quick_start
    weather_api/index
    weather_api/temperature
    weather_api/humidity
    sky_api/index
    sky_api/planets
    sky_api/stars
    sky_api/satellites
    future_api/index

हम इसे पिरामिड के दस्तावेज़ के एक भाग में करते हैं, हालाँकि हम ग्लोबिंग भी करते हैं क्योंकि फाइलों का क्रम महत्वपूर्ण नहीं है। आपके आदेश का महत्व प्रतीत होता है, इसलिए उन्हें अपने वांछित क्रम में सूचीबद्ध करना आवश्यक है।

2
Steve Piercy 13 फरवरी 2019, 22:51