From: Leandro Lucarella <llucax@gmail.com>
Date: Mon, 25 Oct 2010 20:17:01 +0000 (-0300)
Subject: Arreglar índice del PDF
X-Git-Tag: borrador-jurado
X-Git-Url: https://git.llucax.com/z.facultad/75.00/informe.git/commitdiff_plain/00166d6ec121c518a1b3f70460409cd56c450f2f?ds=sidebyside

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 5912026..df88770 100644
--- 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 ee527af..d31a871 100644
--- 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