क्या स्फिंक्स उन दस्तावेज़ों से लिंक कर सकता है जो रूट दस्तावेज़ के नीचे निर्देशिका में स्थित नहीं हैं?

| | | | | | | | | | | | | |

मैं एक गैर-पायथन परियोजना का दस्तावेजीकरण करने के लिए स्फिंक्स का उपयोग कर रहा हूं। मैं प्रत्येक सबमॉड्यूल में ./doc फोल्डर वितरित करना चाहता हूं, जिसमें उस मॉड्यूल को दस्तावेज करने के लिए submodule_name.rst फाइलें शामिल हैं। मैं फिर उन फ़ाइलों को संपूर्ण डिज़ाइन के लिए एक युक्ति बनाने के लिए मास्टर पदानुक्रम में चूसना चाहता हूं।

अर्थात:

प्रोजेक्ट डॉक्स स्पेक project_spec.rst conf.py मॉड्यूल मॉड्यूल1 डॉक्स मॉड्यूल1.rst src मॉड्यूल2 डॉक्स मॉड्यूल2.rst src 

मैंने मास्टर project_spec.rst दस्तावेज़ में फ़ाइलों को इस तरह शामिल करने का प्रयास किया:

.. toctree:: :numbered: :maxdepth: 2 मॉड्यूल 1 < ;../../मॉड्यूल/मॉड्यूल1/डॉक्स/मॉड्यूल1> 

हालाँकि यह त्रुटि संदेश परिणाम देता है:

चेतावनी: toctree में गैर-मौजूदा दस्तावेज़ का संदर्भ शामिल है u"modules/module1/docs/module1"

क्या किसी तरह दस्तावेज़ पथ में ../ का उपयोग करना संभव नहीं है?

अपडेट: जोड़ा गया conf.py स्थान

अपडेट करें : नीचे शामिल ट्रिक के अलावा, यह अभी भी (2019) संभव नहीं है। एक खुला मुद्दा है जो आगे बढ़ता रहता है: https://github.com/sphinx- doc/sphinx/issues/701