PDF Indexes are not being generated

[NoralK]

The PDF index is missing. Local generation index shows RTD no index.

Let me know if you need further information.

[gregmuellegger]

@NoralK Hi, thanks for the report.
Can you tell us the project you are having problems with?

[NoralK]

Thank you for the help - here is the URL https://github.com/NoralK/TestDocs

[gregmuellegger]

@NoralK I can't seem to find the related project on readthedocs. It seems that there was https://readthedocs.org/projects/noral-testdocs/ before but it was deleted. Do you still have the project on readthedocs.org that you are having problems with?

I need to have a look at the build output and see the PDF results you are getting before I can invest any further.

[NoralK]

The project is there. I do not know if it will help but I changed it from private to protected. Last build was approx. 7 days ago.

[NoralK]

I think I know what is happening. RTFD has changed how many times it generates the PDF in the makefile or custom script and has cut too many, specifically the pass to incorporate the index. So if another pass was made, after the index files get created, then the index inside the PDF should show up.

There should be a minimum of three passes, as I know it:

1. To generate/check the initial PDF
2. To generate the index files - a message will state to Rerun to get outlines right
3. Final generation of the PDF with index

I know sphinx uses 5 passes but they do 1 and 3 twice and from what I have seen and read those are unnecessary.

Hope this help and again thank you.

[gregmuellegger]

RTD runs the pdflatex command twice. That was introduced with #749. However we never ran it more than this. So it seems that it didn't change. Was it already working for you at some point?

However we could try running the pdflatex command three times and see if that helps.

[gregmuellegger]

I've proposed the third run in #1583.

[NoralK]

Any update on this?

[gregmuellegger]

@NoralK we haven't merged the proposed fix so far as we are not sure about why exactly we need the third run. Can you maybe jump in #1583 and shed some light onto the strangenesses of LaTeX for us? That would be super helpful!

[gregmuellegger]

Blocked by the decision in #1583

[NoralK]

Did anyone read my comment or open a ticket with PDFlatex?

You closed the ticket and yet there are still no indexes!

Noral

On Mon, Sep 14, 2015 at 6:51 AM, Gregor Müllegger notifications@github.com
wrote:

Blocked by the decision in #1583
#1583

—
Reply to this email directly or view it on GitHub
#1557 (comment)
.

[agjohnson]

@NoralK This ticket is still open, it's marked as blocked on the PR under review. There is no substantial case for running pdflatex a third time yet, so the PR remains open.

[agjohnson]

Closing this issue due to inactivity. The project with pdf index issues doesn't exist on RTD, and the related PR to run pdflatex with 3 passes was rejected due to lack of input signifying it was necessary. If anyone has more information/background on this issue, feel free to reopen.

[jfbu]

moved to #1583 (comment)