Table of Contents missing and links broken in PDF on readthedocs

[michael.amie@…]

In the 1.4.X series of documentation PDFs the content has been rearranged in such a way that the Table Of Contents does not specify which chapter / section # a given topic is located and the table of contents links are also broken, this makes navigating the documentation difficult.

[Claude Paroz]

It's strange that 1.3.x and dev seem to be fine, and not 1.4.x. I don't see what is so different in 1.4.x. Any hint? Or might this be simply a build failure on readthedocs?

[Aymeric Augustin]

Indeed.

[Tim Graham]

This may be a problem with readthedocs -- I just rebuilt the docs for 1.3.X, 1.4.X, and latest there and now the TOC doesn't appear on any of them. However, when I build the docs locally (tested master and 1.4.X) the TOC does appear.

[Aymeric Augustin]

I discussed on IRC with the maintainer of ReadTheDocs.

PDFs are generated via LaTeX, which tends to spit ​interesting but barely usable logs.

He thinks the issue is worth investigating, so let's keep this ticket open.

The fix may be purely on ReadTheDocs' side, and it may require fixes to Django's docs.

[Tim Graham]

#19644 reported that all links point to the menu page which I think is the same root cause as this issue.

It looks like 'django.aux' isn't being generated for the readthedocs build.

I found the following note which may be relevant: "When using \label, you'll have to compile your LaTeX code twice. The first compilation will produce a .aux file that contains all the label information based on your \label commands. The second compilation reads and uses that information to fill out your \ref and \pageref commands."

[Tim Graham]

Table of contents is back.