[Numpy-discussion] Beginner Help: Generating HTML using Sphinx

[Sanchi Vaishnavi]

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
> $  make html
> >> sphinx-build: error: unrecognized arguments: --keep-going
> >> make: *** [html] Error 2


 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
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/numpy-discussion/attachments/20190330/10a8a598/attachment-0001.html>