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

[Mbeng Tanyi]

Hello

I also got an error the first time I tried $ make file as follows:

> mkdir -p build/html build/doctrees
> LANG=C sphinx-build -b html -WT --keep-going -d build/doctrees   source
> build/html
> /bin/sh: 1: sphinx-build: not found
> Makefile:123: recipe for target 'html' failed
> make: *** [html] Error 127


After upgrading to sphinx2 as was suggested here, I still get errors after $
make html :

> mkdir -p build/html build/doctrees
> LANG=C sphinx-build -b html -WT --keep-going -d build/doctrees   source
> build/html
> Traceback (most recent call last):
>   File "/home/valentina-t/.local/bin/sphinx-build", line 7, in <module>
>     from sphinx.cmd.build import main
>   File
> "/home/valentina-t/.local/lib/python2.7/site-packages/sphinx/cmd/build.py",
> line 39
>     file=stderr)
>         ^
> SyntaxError: invalid syntax
> Makefile:123: recipe for target 'html' failed
> make: *** [html] Error
>


On Sat, Mar 30, 2019 at 6:47 PM Sanchi Vaishnavi <vaishnavi.sanchi at gmail.com>
wrote:

> 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
>>
> _______________________________________________
> 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/20190331/3f80d47d/attachment.html>