spbinx- जेनरेट किए गए दस्तावेज़ को बिटबकेट विकी पर स्वचालित रूप से प्रकाशित कैसे करें?

Question

मेरे पास स्फिंक्स से उत्पन्न दस्तावेज (ऑटोोड्यूलस सुविधा का उपयोग करके) के साथ एक पायथन पैकेज है और इसे परियोजना के गिट रिपोजिटरी में _build निर्देशिका में बैठे स्थिर HTML पृष्ठों के सेट में बनाया जा सकता है। मैं इस दस्तावेज़ को सुंदर और निजी बिटबकेट पर देखना चाहता हूं। ऐसा लगता है कि विकी जो कि एक गिट रेपो स्वयं ही इसके लिए प्रयोग योग्य हो सकती है।

क्या अनुक्रमों का एक आसान कदम है जो मेरे एचटीएमएल दस्तावेज को मार्कअप में परिवर्तित/परिवर्तित कर सकता है और इसे बिटबकेट विकी रिपोजिटरी में धक्का दे सकता है?

Answer 1

दुर्भाग्य से यह वास्तव में संभव नहीं है ...

आप विकि रेपो करने के लिए अपने _build dir धक्का और इतने की तरह अपने html फ़ाइलें करने के लिए विकी (Home.rst) में लिंक बना सकते हैं:

`Sphinx docs <_build/html/index.html>`_ 

और यह उन्हें प्रदर्शित करेगा लेकिन _static सीएसएस/जे एस फ़ाइलें के शामिल किए जाने से काम नहीं चलेगा, तो अपने दस्तावेज़ों को बदसूरत दिखेगा :(

तुम भी publish your docs as a website on BitBucket सकता है लेकिन वहाँ कोई गोपनीयता है, अपने दस्तावेज़ों को भी अपने रेपो अगर सार्वजनिक किया जाएगा निजी है, इसलिए यह बहुत उपयोगी नहीं है, n आप सिर्फ read the docs साथ जा सकते हैं ...

डॉक्स पढ़ें वास्तव में supports privacy तो आप एक निजी मोड में अपने दस्तावेज़ों को जोड़ सकते हैं और BitBucket में एक Webhook जोड़ें। दुर्भाग्य से यह केवल सार्वजनिक रिपो के साथ काम करता है, इसलिए कोई अच्छा समाधान नहीं है ...

पीएस एक पुन: प्रयोज्य ऐप है जो आपको निजी रूप से django (संरक्षित) से अपने स्फिंक्स दस्तावेज़ों की सेवा करने की अनुमति देता है: django-docs;) और आप उन्हें अपनी बिटबकेट * .rst फ़ाइलों से बना सकते हैं ...