Beginner Help: Generating HTML using Sphinx
![](https://secure.gravatar.com/avatar/b55be4148d6c2806205b320c6cd2fbf5.jpg?s=120&d=mm&r=g)
I was learning to get to $ make html to work. These are the final steps that I used on my test branch in my numpy repo: $ sphinx-build -b html doc/source builddir
build succeeded, 165 warnings.
$ make html
make: *** No rule to make target `html’. Stop.
I checked one of the resultant HTML pages, and the changes had been made as expected. But to make sense of the last message, on reading on forums (StackOverflow), I found that I got that error because I was in the directory which* did not* contain the makefile. So: $ cd doc
I can't make sense of the last two errors. I had followed the instructions from NumPy <http://www.numpy.org/devdocs/docs/howto_build_docs.html#sphinx-extensions> and Sphinx-doc <http://www.sphinx-doc.org/en/master/usage/quickstart.html#running-the-build> . I realize that this question is not about NumPy, so I appreciate any resource you can point me to. Thank you! Sanchi https://github.com/chelwin
![](https://secure.gravatar.com/avatar/b55be4148d6c2806205b320c6cd2fbf5.jpg?s=120&d=mm&r=g)
Hi Sebastian, Thank you, it works perfectly now. I wrongly assumed that I'd installed the latest version. As it happens, conda currently ships the version 1.7.4 of sphinx, as against the latest version 2.0.0. I did this: pip install -U sphinx Best, Sanchi On Sat, Mar 30, 2019 at 5:48 PM Sebastian Berg <sebastian@sipsolutions.net> wrote:
![](https://secure.gravatar.com/avatar/64b862f6213fcf301546bb0d98acb14f.jpg?s=120&d=mm&r=g)
Hello I still have a problem with this. I am using sphinx1.8.5 and changed the default python version on my computer to be 3.6 but I get the following error on $ make html ; Traceback (most recent call last):
I googled the error but didn't find anything really useful. I feel it has something to do with python2.7 as part of the path. Suppose I am right, I need help changing it to python3.6 please. Regards Mbeng Tanyi On Sun, Mar 31, 2019 at 9:20 PM Matti Picus <matti.picus@gmail.com> wrote:
![](https://secure.gravatar.com/avatar/72f994ca072df3a3d2c3db8a137790fd.jpg?s=120&d=mm&r=g)
Note the /home/valentina-t/.local/lib/python2.7 in the error message. This indicates you are using python2.7, not python3.6. Please try using a virtual environment or activating a conda environment. If you need further help please reach out to me personally. Matti On 2/4/19 11:41 am, Mbeng Tanyi wrote:
![](https://secure.gravatar.com/avatar/b55be4148d6c2806205b320c6cd2fbf5.jpg?s=120&d=mm&r=g)
Hi Sebastian, Thank you, it works perfectly now. I wrongly assumed that I'd installed the latest version. As it happens, conda currently ships the version 1.7.4 of sphinx, as against the latest version 2.0.0. I did this: pip install -U sphinx Best, Sanchi On Sat, Mar 30, 2019 at 5:48 PM Sebastian Berg <sebastian@sipsolutions.net> wrote:
![](https://secure.gravatar.com/avatar/64b862f6213fcf301546bb0d98acb14f.jpg?s=120&d=mm&r=g)
Hello I still have a problem with this. I am using sphinx1.8.5 and changed the default python version on my computer to be 3.6 but I get the following error on $ make html ; Traceback (most recent call last):
I googled the error but didn't find anything really useful. I feel it has something to do with python2.7 as part of the path. Suppose I am right, I need help changing it to python3.6 please. Regards Mbeng Tanyi On Sun, Mar 31, 2019 at 9:20 PM Matti Picus <matti.picus@gmail.com> wrote:
![](https://secure.gravatar.com/avatar/72f994ca072df3a3d2c3db8a137790fd.jpg?s=120&d=mm&r=g)
Note the /home/valentina-t/.local/lib/python2.7 in the error message. This indicates you are using python2.7, not python3.6. Please try using a virtual environment or activating a conda environment. If you need further help please reach out to me personally. Matti On 2/4/19 11:41 am, Mbeng Tanyi wrote:
participants (5)
-
Hameer Abbasi
-
Matti Picus
-
Mbeng Tanyi
-
Sanchi Vaishnavi
-
Sebastian Berg