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


Ignore:
Timestamp:
Nov 15, 2015, 5:54:34 PM (9 years ago)
Author:
Graham Wideman

Legend:

Unmodified
Added
Removed
Modified
  • Ticket #23751, comment 11

    v1 v2  
    551. 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.
    66
    7 So it's essential for all errors to be fixed.
     7So 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.]
    88
    992. 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.
Back to Top