जब कोई स्रोत फ़ाइल

Question

बदलती है तो मैं स्वचालित रूप से स्फिंक्स दस्तावेज़ का निर्माण करता हूं, मैं अपनी परियोजनाओं में से किसी एक को दस्तावेज़ के लिए Sphinx का उपयोग कर रहा हूं, और मैं अपने ब्राउज़र में अपने परिवर्तनों का पूर्वावलोकन करना चाहता हूं। मैं .rst फ़ाइल में कुछ बदलावों को सहेजने में सक्षम होना चाहता हूं, और तुरंत अपने ब्राउज़र को रीफ्रेश करने और परिवर्तन देखने में सक्षम होना चाहता हूं।

अनिवार्य रूप से मैं स्वचालित रूप से make html निष्पादित करना चाहता हूं जब भी .rst फ़ाइलों में से कोई एक बदल जाता है।

(Geany, एडिट, Emacs, vi, नोटपैड ++ ...)

Answer 1

आप पसंदीदा संपादक है कि फाइल की बचत होती है और उसे अपने ब्राउज़र में खुल जाता है आप में एक मैक्रो बना सकते हैं, किसी भी पाठ संपादक क्या कर सकते हैं

Answer 2

आप अगर ' एक * निक्स सिस्टम पर फिर से, आप फाइल सिस्टम घटनाओं की निगरानी करने और कार्यों को ट्रिगर करने के लिए inotify का उपयोग कर सकते हैं।

उदाहरण के लिए

, ubuntu पर,

apt-get install inotify-tools 

फिर एक में होने वाली घटनाओं को देखते हुए dir

while true 
    do 
    inotifywait -r -e modify -e move -e create -e delete /tmp/docs | while read line 
     do 
     echo "file changed; time to run make html" 
     done 
    done 

Answer 3

याकूब कापलान-मॉस has a good solution के लिए सुनने के लिए इस तरह एक स्क्रिप्ट चलाने:

pip install watchdog 
watchmedo shell-command \ 
      --patterns="*.rst" \ 
      --ignore-pattern='_build/*' \ 
      --recursive \ 
      --command='make html' 

नोट, अपने प्रत्यय से मेल खाने के लिए पैटर्न को बदलें। जैकब * .txt का उपयोग करता है, लेकिन मुझे इसे * .rst में बदलने की आवश्यकता है।

Answer 4

आप sphinx-autobuild का उपयोग कर सकते हैं।

sphinx-autobuild source build/html 

यह भी स्वचालित रूप से ब्राउज़र में एक पृष्ठ ताज़ा आरंभ हो जाएगा

sphinx-autobuild docs docs/_build/html 

या, यदि आप एक अलग निर्माण dir है,:

यह उपयोग में आसान है, उदाहरण के लिए।