build does not update index.html from README.rst

Tom Kuiper

unread,

Nov 10, 2019, 2:12:39 PM11/10/19

to sphinx-users

In summary, when I do 'build html' the new index.html does not show changes made in README.rst.

The first time I ran 'make html' I just renamed README.md to be README.rst and the build of course complained. I edited README.rst to use proper restructured text mark up and did another build. However, I did not catch everything. In particular, in one section had a one-line code section with

Jhhmm+ddmm, Bhhmm+ddmm and Gddd.d+dd.d

The "and" was rendered in green and everything following was not rendered. Instead, the unrendered restructured text is shown. Fixing the source file and rebuilding did not change the rendered version, even though the time of the resulting index.html shows that it was newly generated. The extra weird thing is that includeme.html is correct when I view it in Chrome. I then did

make clean
Removing everything under '../../DatesTimes-docs'...
make html
Running Sphinx v1.8.0
...
but still index.html was the incorrect version.

It must be that there is something intermediate between the file README.rst and the generated index.html but it can't be includeme.html. Could it be that 'make html' is doing something weird? Makefile is very simple. Whatever is going wrong is in Sphinx itself. Could it be a bug?

Thanks and best regards.

Libor Jelinek

unread,

Nov 10, 2019, 2:27:24 PM11/10/19

to sphinx...@googlegroups.com

How could README.rst become index.html? Send us your conf.py to let understand.

Libor

Dne ne 10. 11. 2019 20:12 uživatel Tom Kuiper <tbhk...@gmail.com> napsal:

--
You received this message because you are subscribed to the Google Groups "sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to sphinx-users...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/sphinx-users/fdcec6c8-b22c-4b7e-83d5-9b6746e834c0%40googlegroups.com.

Tom Kuiper

unread,

Nov 10, 2019, 2:36:17 PM11/10/19

to sphinx-users

README.rst is included via an includeme.rst in index.rst. I've included these files as well as the conf.py you requested.

Thanks

README.rst

conf.py

includeme.rst

index.rst

Tom Kuiper

unread,

Nov 10, 2019, 2:48:48 PM11/10/19

to sphinx-users

It occurs to me that I should have given you the rendered pages as well.

Tom

On Sunday, November 10, 2019 at 11:12:39 AM UTC-8, Tom Kuiper wrote:

includeme.html

index.html

Tom Kuiper

unread,

Nov 10, 2019, 6:49:32 PM11/10/19

to sphinx-users

Problem solved!

I had two versions of the reST source, one in README.rst and the other in a module docstring. I changed the former and was looking for the change in the latter. Stupid. Sorry to be a nuisance.

On Sunday, November 10, 2019 at 11:12:39 AM UTC-8, Tom Kuiper wrote:

Reply all

Reply to author

Forward