2010-04-05 13 views
26

कई django परियोजनाओं में, दस्तावेज़ निर्देशिका में मैं * .rst फ़ाइलों को देख सकता हूं:ब्राउज़ करने के लिए कैसे (कोई टेक्स्ट एडिटर) .rst फ़ाइलें?

उन्हें ब्राउज़ करने का सबसे अच्छा तरीका क्या है (कोर्स के टेक्स्ट एडिटर का उपयोग किए बिना)?

क्या HTML उत्पन्न करना संभव है?

+1

क्या आप "कोर्स के टेक्स्ट एडिटर के प्रयोग किए बिना" विस्तार करने के लिए विवरण संपादित कर सकते हैं? यह एक अच्छा तरीका प्रतीत होता है, और इसे अस्वीकार करने के आपके कारण स्पष्ट नहीं हैं। – bignose

उत्तर

25

.rst फ़ाइलें ReStructuredText प्रारूप हैं। वे टेक्स्ट फाइलों की तरह दिखते हैं, लेकिन उन्हें पाइथन docutils पैकेज के साथ HTML में प्रस्तुत किया जा सकता है।

1

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

+0

https://docs.djangoproject.com/en/1.8/internals/contributing/writing-documentation/ –

5
+10

जबकि यह सैद्धांतिक रूप से प्रश्न का उत्तर दे सकता है, [यह बेहतर होगा] (http://meta.stackexchange.com/q/825 9) यहां उत्तर के आवश्यक हिस्सों को शामिल करने के लिए, और संदर्भ के लिए लिंक प्रदान करें। –

11

प्रयास करें Zjk कहते हैं, आप restview उपयोग कर सकते हैं:

restview अजगर पैकेज सूचकांक से उपलब्ध है: http://pypi.python.org/pypi/restview। आप रीस्टव्यू इंस्टॉल भी पाइप कर सकते हैं।

यहाँ है कि मैं क्या एक आभासी वातावरण का उपयोग कर इसे बाहर का परीक्षण करने के लिए किया था है:

mkdir restview 
cd restview/ 
virtualenv-2.7 venv # The second system I used just used 'virtualenv venv' 
./venv/bin/pip install restview 
./venv/bin/restview ~/path/MANUAL.rst 

यह एक वेब सर्वर का शुभारंभ किया और अपने ब्राउज़र में प्रलेखन पृष्ठ खोला।

नोट: मैंने केवल वर्चुअलएन्व का उपयोग किया क्योंकि मुझे वैश्विक स्तर पर चीजों को इंस्टॉल करना पसंद नहीं है। यह कई अन्य लोगों के लिए अधिक हो सकता है, लेकिन मेरे पास इन वन-ऑफ वातावरण के साथ भी बेहतर भाग्य है। जब मैंने उबंटू 14.04 वीएम पर pip install restview की कोशिश की तो यह असफल रहा, जबकि उपर्युक्त दृष्टिकोण उस प्रणाली के साथ-साथ इस पर एक आकर्षण की तरह काम करता था।

-3

बस फ़ाइल एक्सटेंशन का नाम .txt में बदलें और फिर आप किसी भी टेक्स्टडिटर के साथ फ़ाइल खोलें।

लोग अपने ज्ञान को छिपाने के लिए सीमाओं और बाधाओं को निर्धारित करते हैं - समय की कमर।

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