Arreglar índice del PDF

El paquete varioref de LaTeX es medio buggy y parece que no se mantiene
mucho[1]. Si se carga después que el paquete hyperref, se rompe el índice
del PDF (no el del documento en sí). Por la forma en la que Sphinx genera
la documentación, y dado que el paquete hyperref se carga en el paquete
sphinx, se hace un hack en el Makefile para cargar el paquete varioref
*antes* que el paquete sphinx para que todo funcione como se espera.

[1] http://www.tex.ac.uk/ctan/macros/latex/contrib/hyperref/

diff --git a/Makefile b/Makefile
index 59120265a80e23d8a0aec40b415a8eec8b38dff9..df88770bffa77a638a95782f360d62845ee7be51 100644 (file)
--- a/Makefile
+++ b/Makefile
@@ -24,6 +24,7 @@ clean:
 latex:
        $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) build/latex
        @sed -i 's/\\chapter{Glosario}/\\chapter*{Glosario}\n\\addcontentsline{toc}{chapter}{Glosario}/' build/latex/tesis.tex
+       @sed -i 's/^\\usepackage{sphinx}$$/\\usepackage[final]{varioref} \\usepackage{sphinx}/' build/latex/tesis.tex
        @sed -i 's/, \\py@release//' build/latex/sphinx.sty
        @sed -i '/-makeindex/d' build/latex/Makefile
        @cp manual.cls build/latex/

diff --git a/source/conf.py b/source/conf.py
index ee527af2491604e3a683b8bbeb946434ba615179..d31a871ed40cc053bbb77f7732c4d938daf5c052 100644 (file)
--- a/source/conf.py
+++ b/source/conf.py
@@ -198,9 +198,15 @@ latex_logo = None
 # Additional stuff for the LaTeX preamble.
 latex_preamble = r'''
 \usepackage{epigraph}
-\usepackage[final]{varioref} % XXX: breaks PDF index, use [final] when done
 \usepackage{subfig}
 
+% Se hackea el Makefile para hacer el usepackage de varioref antes del
+% usepackage{sphinx} porque si se lo hace despues se rompe el indice del PDF
+% (en realidad tiene que estar antes del usepackage del hyperref, que se carga
+% en el paquete sphinx). Para cambiar entre draft/final hay que modificar el
+% Makefile.
+%\usepackage[final]{varioref} % XXX: breaks PDF index, use [final] when done
+
 % Relaja restricciones de LaTeX para floats, ver:
 % http://mintaka.sdsu.edu/GF/bibliog/latex/floats.html
 % http://www.tex.ac.uk/cgi-bin/texfaq2html?label=floats