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

Sanchi Vaishnavi vaishnavi.sanchi at gmail.com
Sat Mar 30 13:45:31 EDT 2019


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 at sipsolutions.net>
wrote:

> Hi Sanchi,
>
> On Sat, 2019-03-30 at 15:58 +0530, Sanchi Vaishnavi wrote:
> > 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
> >
>
> It sounds like your sphinx version is older and is missing the
> "--keep-going" argument. It would probably be best to upgrade your
> sphinx version.
>
> Best,
>
> Sebastian
>
>
> >
> >  I can't make sense of the last two errors. I had followed the
> > instructions from NumPy and Sphinx-doc.
> > 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
> > _______________________________________________
> > NumPy-Discussion mailing list
> > NumPy-Discussion at python.org
> > https://mail.python.org/mailman/listinfo/numpy-discussion
> _______________________________________________
> NumPy-Discussion mailing list
> NumPy-Discussion at python.org
> https://mail.python.org/mailman/listinfo/numpy-discussion
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/numpy-discussion/attachments/20190330/5fa600e9/attachment.html>


More information about the NumPy-Discussion mailing list