Context Navigation

Changes between Version 1 and Version 2 of Ticket #23751, comment 11

v1	v2
5	5	1. In order for the overall 'make latexpdf' to succeed (with TOC), the build must proceed without errors. There is a separate nested docs/_build/latex/Makefile for the latex->pdf phase, which invokes pdflatex three times, in order to iterate toward stable pagination to arrive at page numbers for TOC, index and cross-references. If any of these steps fails, the resulting PDF is incomplete.
6	6
7		So it's essential for all errors to be fixed.
	7	So it's essential for all errors to be fixed. [Edit: It's also essential to start with an empty _build directory, so that leftovers from previous build don't lead to false success.]
8	8
9	9	2. The latex code for the grey box containing the filename must not include unescaped underscores, as that's some kind of a latex error in this context, preventing make from completing. So in the djangodocs.py code that constructs that grey box (the 'colorbox'), I added backslash escape to the the underscores.