पायथन की वेबसाइट कैसे ऑनलाइन दस्तावेज उत्पन्न करती है?

Question

स्फिंक्स 0.6.5 का उपयोग करके बनाया गया।

मैं अजगर के दस्तावेज़ reStructuredText का उपयोग करता है, लेकिन यह http://docs.python.org/whatsnew/2.6.html और http://docs.python.org/tutorial/index.html की तरह अलग अलग खंड हैं।

आप इसे पुन: संरचित पाठ में कैसे करते हैं? क्या आप निर्देशिकाओं के समूह में rst2html चलाते हैं, इसकी संरचना को रखते हैं?

मुझे पता है कि यह स्फिंक्स का उपयोग करता है (जैसा कि Thomas Wouters in an answer से कहा सीधे rst2html नहीं), लेकिन कैसे आप एक पूर्ण विकसित स्वचालित दस्तावेज़ वेबसाइट है एक भंडार में स्रोत कोड फ़ाइलों के साथ अपने पहला संरचना को व्यवस्थित करना चाहिए?

Answer 1

अजगर प्रलेखन अपनी मार्कअप के लिए आराम का उपयोग करता है, लेकिन यह एचटीएमएल sphinx, नहीं rst2html सीधे का उपयोग कर उत्पन्न करता है। sphinx उपकरण सभी .rst फ़ाइलों को कई .html फ़ाइलों में परिवर्तित करता है। यह देखने के लिए कि पाइथन दस्तावेज़ कैसे उत्पन्न होते हैं, http://svn.python.org/projects/python/trunk/Doc/Makefile

Answer 2

मुझे sampledoc tutorial on the matplotlib site स्पिंक्स के साथ शुरू करने के लिए काफी उपयोगी पाया गया।

Answer 3

यहां how to build Python documentation बिल्कुल है।