আমি স্পিনক্সের সাথে শুরু করার চেষ্টা করছি এবং মনে হচ্ছে অবিরাম সমস্যা আছে।
আদেশ: docs/sphinx-quickstart
আমি সমস্ত প্রশ্নের উত্তর দিই এবং সবকিছু ঠিকঠাক কাজ করে।
আদেশ: docs/ls
সবকিছু স্বাভাবিক দেখাচ্ছে। ফলাফল:build Makefile source
আদেশ: sphinx-build -d build/doctrees source build/html
মনে হচ্ছে এটি কাজ করে। আমি সূচক html ফাইল খুলতে এবং আমি যা চাই তার একটি "শেল" দেখতে সক্ষম হয়েছি।
আমি যখন চেষ্টা করি এবং আমার আসল উত্স কোডটি sourceফোল্ডার হিসাবে রাখি তখন আমি সমস্যার মধ্যে পড়ে।
আদেশ: sphinx-build -d build/doctrees ../ys_utils build/html
ফলাফল:
Making output directory...
Running Sphinx v1.1.3
loading pickled environment... not yet created
No builder selected, using default: html
loading intersphinx inventory from http://docs.python.org/objects.inv...
building [html]: targets for 1 source files that are out of date
updating environment: 1 added, 0 changed, 0 removed
Traceback (most recent call last):
File "/usr/local/lib/python2.6/dist-packages/Sphinx-1.1.3-py2.6.egg/sphinx/ext/autodoc.py", line 321, in import_object
__import__(self.modname)
ImportError: No module named ys_utils
Traceback (most recent call last):
File "/usr/local/lib/python2.6/dist-packages/Sphinx-1.1.3-py2.6.egg/sphinx/ext/autodoc.py", line 321, in import_object
__import__(self.modname)
ImportError: No module named ys_utils.test_validate_ut
Traceback (most recent call last):
File "/usr/local/lib/python2.6/dist-packages/Sphinx-1.1.3-py2.6.egg/sphinx/ext/autodoc.py", line 321, in import_object
__import__(self.modname)
ImportError: No module named ys_utils.git_utils
Traceback (most recent call last):
File "/usr/local/lib/python2.6/dist-packages/Sphinx-1.1.3-py2.6.egg/sphinx/ext/autodoc.py", line 321, in import_object
__import__(self.modname)
ImportError: No module named setup.setup
/home/ricomoss/workspace/nextgen/ys_utils/ys_utils.rst:4: WARNING: autodoc can't import/find module 'ys_utils', it reported error: "No module named ys_utils", please check your spelling and sys.path
/home/ricomoss/workspace/nextgen/ys_utils/ys_utils.rst:10: WARNING: autodoc can't import/find module 'ys_utils.test_validate_ut', it reported error: "No module named ys_utils.test_validate_ut", please check your spelling and sys.path
/home/ricomoss/workspace/nextgen/ys_utils/ys_utils.rst:12: WARNING: don't know which module to import for autodocumenting u'UnitTests' (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)
/home/ricomoss/workspace/nextgen/ys_utils/ys_utils.rst:18: WARNING: autodoc can't import/find module 'ys_utils.git_utils', it reported error: "No module named ys_utils.git_utils", please check your spelling and sys.path
/home/ricomoss/workspace/nextgen/ys_utils/ys_utils.rst:24: WARNING: autodoc can't import/find module 'setup.setup', it reported error: "No module named setup.setup", please check your spelling and sys.path
WARNING: master file /home/ricomoss/workspace/nextgen/ys_utils/index.rst not found
looking for now-outdated files... none found
pickling environment... done
checking consistency... /home/ricomoss/workspace/nextgen/ys_utils/ys_utils.rst:: WARNING: document isn't included in any toctree
done
preparing documents... done
writing output... [ 50%] index
Exception occurred:
File "/usr/local/lib/python2.6/dist-packages/Sphinx-1.1.3-py2.6.egg/sphinx/environment.py", line 1213, in get_doctree
f = open(doctree_filename, 'rb')
IOError: [Errno 2] No such file or directory: '/home/ricomoss/workspace/nextgen/docs/build/doctrees/index.doctree'
The full traceback has been saved in /tmp/sphinx-err-jjJ7gM.log, if you want to report the issue to the developers.
Please also report this if it was a user error, so that a better error message can be provided next time.
Either send bugs to the mailing list at <http://groups.google.com/group/sphinx-dev/>,
or report them in the tracker at <http://bitbucket.org/birkenfeld/sphinx/issues/>. Thanks!
আমি স্পিনক্সের সম্পূর্ণ নবাগত এবং এই জাতীয় ডকুমেন্টেশনে তুলনামূলকভাবে নতুন। কেউ কি কিছু পরামর্শ দিতে পারেন?
সম্পাদনা করুন:
আমি এটি পরিচালনা করতে একটি Makefile ব্যবহার করতে সক্ষম হতে চাই। আমার প্রকল্পে এখন পর্যন্ত আমার দুটি ফোল্ডার রয়েছে।
nextgen/ls
docs ys_utils
আমার nextgen/docs/Makefileএইচটিএমএল ys_utilsএবং অন্য যে সমস্ত মডিউলগুলি আমি নিতে যাচ্ছি তা তৈরি করতে হবে।
os.path.abspath(os.path.split(__file__)[0] + '../../')কাজ করার সময় কাজ করে নাos.path.abspath('../..'))। কেন আমি জানি না।