2012-06-19 17 views
13

मैं वर्तमान में एक जटिल जटिल Django वेबसाइट के लिए स्फिंक्स का उपयोग करके कुछ व्यापक दस्तावेज लिख रहा हूं। मैं इस घर पर काम कर रहा हूं और जल्द ही जाने से पहले मैं साइट के लिए नए देवताओं/व्यवस्थापक द्वारा सुलभ विस्तृत दस्तावेज छोड़ना चाहता हूं।होस्टिंग निजी स्फिंक्स प्रलेखन

मेरा प्रश्न यह है कि इस दस्तावेज़ को होस्ट करने के लिए मेरे विकल्प क्या हैं? मैं इसे निजी होना पसंद करूंगा। इसके अलावा दस्तावेज़ एक वेबसाइट से संबंधित हैं जो कि अजगर पैकेज नहीं है। इन दो कारणों से मैं सोच रहा हूं कि डॉक्स पढ़ें सबसे उपयुक्त विकल्प नहीं हो सकता है।

मैं django-sphinxdoc में भाग गया, हालांकि इसके लिए हेस्टैक को बैकएंड के रूप में स्थापित करने की आवश्यकता है। क्या अंतर्निहित जेएस खोज का उपयोग कर दस्तावेज़ों को बस सर्वर करने का कोई तरीका नहीं है? या एक सेवा जो दस्तावेज़ों की निजी होस्टिंग की अनुमति देती है?

किसी भी विकल्प की बहुत सराहना की जाएगी।

उत्तर

14

स्फिंक्स स्थिर .html फ़ाइलें (make html) उत्पन्न कर सकता है। उन HTML फ़ाइलों को एक आंतरिक वेब सर्वर पर रखें और आपको जाने के लिए अच्छा होना चाहिए।

+0

क्या यह जेएस खोज के साथ काम करता है? –

+2

यूप। जेएस खोज सिर्फ एक स्थिर सूचकांक के साथ जेएस है (जो आपके दस्तावेज़ों का निर्माण करते समय बनाया गया है)। –

6

मुझे प्रलेखन को निजी रूप से होस्ट करने की आवश्यकता महसूस हुई। इसलिए मैंने एक वेब सेवा बनाई है जो निजी स्फिंक्स प्रलेखन होस्टिंग का समर्थन करता है: हैसडॉक्स।

http://www.hasdocs.com/

यह अपने वेब सर्वर, आदि आप अपने GitHub खजाने और अनुमतियाँ सिंक कर सकते हैं स्थापित करने के लिए की आवश्यकता को समाप्त कर देना चाहिए। निजी परियोजनाओं में निजी दस्तावेज़ होते हैं जो केवल सही विशेषाधिकार वाले लोगों द्वारा उपलब्ध होते हैं। जब भी आप अपने गिटहब भंडार में नया कोड दबाते हैं तो दस्तावेज़ पुनर्निर्मित हो जाता है।

यह वर्तमान में बीटा में है और स्पिंक्स, जैकिल और जावाडोक को दस्तावेज़ीकरण जनरेटर के रूप में समर्थन देता है। कृपया इसे आज़माएं और किसी भी प्रतिक्रिया की सराहना की जाएगी।

+0

क्या आप बिटबकेट का समर्थन करते हैं? –

+4

यह देखने के लिए बम किया गया कि http://www.hasdocs.com चला गया प्रतीत होता है। किसी और के पास इसके लिए कोई अच्छा समाधान है? –

+0

@BrianKing स्रोत की तरह दिखता है [https://github.com/narrowcast/hasdocs.com ](https://github.com/narrowcast/hasdocs.com) – Reinbach

-1

इस question का उत्तर देखें (पूर्ण प्रकटीकरण, मैंने सवाल पूछा, कुछ शोध और कोडिंग का कोई जवाब नहीं मिला और जवाब पोस्ट किया, इसलिए जब यह काम करता है वहां बेहतर हो सकता है। मैं बहुत बाध्य होगा अगर कोई उन्हें इंगित करेगा।)

यह गिटलैब रेपो एक कामकाजी उदाहरण here दिखाता है।

static password protection का उपयोग करता है और इस issue में भी चर्चा की जाती है।

संबंधित मुद्दे