sphinx-doc / sphinx-autobuild

Watch a Sphinx directory and rebuild the documentation when a change is detected. Also includes a hot-reload web server.
MIT License
523 stars 75 forks source link

sphinx-build dependency missing #74

Closed bocekm closed 3 years ago

bocekm commented 5 years ago

I've installed sphinx-autobuild through pip on Fedora 29. After running sphinx-autobuild -z <codesourcepath> "<docspath>" "<outputpath>" I'm getting:

+--------- manually triggered build ---------------------------------------------
Traceback (most recent call last):
  File "/usr/bin/sphinx-autobuild", line 11, in <module>
    sys.exit(main())
  File "/usr/lib/python2.7/site-packages/sphinx_autobuild/__init__.py", line 312, in main
    builder.build()
  File "/usr/lib/python2.7/site-packages/sphinx_autobuild/__init__.py", line 175, in build
    subprocess.Popen(args, stdout=slave)
  File "/usr/lib64/python2.7/subprocess.py", line 394, in __init__
    errread, errwrite)
  File "/usr/lib64/python2.7/subprocess.py", line 1047, in _execute_child
    raise child_exception
OSError: [Errno 2] No such file or directory
make: *** [Makefile:18: livehtml] Error

By further investigation I found out that I'm missing sphinx-build executable. I believe this should be marked as dependency. Or at least improve the error message.

sirex commented 4 years ago

And it would be nice to have a command line flag for manually specifying sphinx-build executable location.

pradyunsg commented 3 years ago

Hah. That's a good point. :)

And, the related request seems to be for #58.

pradyunsg commented 3 years ago

Should be fixed in #82!