Trabajar con documentos grandes

Los libros, tesis e informes largos hacen pesada la secuencia editar-compilar: las compilaciones se vuelven lentas, un único archivo enorme es incómodo y mantener numeración y referencias en cientos de páginas es difícil. Este capítulo convierte un documento largo en una forma que puedes seguir escribiendo cada día: dividir por capítulos, compilar solo la parte que estás editando y alternar deliberadamente entre modo draft y compilaciones limpias completas.

Qué se complica a gran escala

A medida que el documento crece aparecen: (1) compilaciones completas lentas, (2) un archivo único demasiado largo para navegarlo, (3) el trabajo de mantener referencias cruzadas, numeración y tabla de contenido coherentes entre capítulos, y (4) errores difíciles de localizar. Todo mejora mucho al dividir el documento y procesar solo la parte necesaria.

Dividir en archivos

La forma básica es un archivo por capítulo, unidos por un archivo principal ligero. Es más fácil encontrar el lugar, repartir trabajo con coautores y mantener pequeños los diffs. La mecánica de inclusión (\input / \include / subfiles) se explica en “Proyectos de varios archivos”; para piezas de nivel capítulo, \include es lo adecuado, porque fuerza saltos de página alrededor de cada parte y le da su propio .aux.

Compilar solo el capítulo que editas — \includeonly

Si divides con \include, poner \includeonly{the-chapter-you-are-editing} en el preámbulo procesa solo ese capítulo. Como el .aux de cada capítulo conserva los valores de la última compilación completa, los números de página y referencias cruzadas de los capítulos omitidos siguen correctos. Una compilación completa de varios minutos se convierte en una parcial de segundos. El hábito importante es hacer primero una compilación completa. Si omites capítulos antes de que existan sus .aux, las referencias quedan como ?? o los números de página quedan obsoletos. Combinado con compilaciones incrementales de latexmk o -pvc, la espera casi desaparece.

% プリアンブルで編集中の章だけに絞る / restrict to the chapter you’re editing
\includeonly{chapters/ch3}

\includeonly no es un mecanismo de acabado. Depende de archivos .aux escritos anteriormente para páginas y referencias, así que antes de entregar hay que quitarlo y compilar todos los capítulos. En un documento con índice, bibliografía y tabla de contenido, el PDF parcial es una aproximación de trabajo, no el documento final.

Iterar rápido con el modo draft

La opción draft de la clase ayuda al probar documentos grandes. (1) Marca las overfull boxes, líneas que invaden el margen, con una regla negra, de modo que los problemas de maquetación se ven enseguida. (2) Sustituye las imágenes por un marcador con marco y nombre de archivo en lugar de renderizarlas, lo que omite el procesamiento de imágenes y acelera la compilación. Para aplicarlo solo a imágenes, usa \usepackage[draft]{graphicx}. Vuelve a final para la salida real. Si quieres ver las imágenes pero marcar solo los overfull, usa \overfullrule=5pt.

\documentclass[draft]{report}   % 画像を省き overfull を表示 / skip images, show overfull rules
% 画像だけ draft にする場合 / scope it to images only:
\usepackage[draft]{graphicx}

Crear un ritmo para un proyecto largo

En documentos grandes conviene evitar la falsa elección entre “compilar siempre todo perfectamente” y “compilar solo fragmentos”. En el día a día, usa \includeonly y latexmk -pvc para iterar sobre el capítulo actual. En hitos, quita draft y compila todo el documento. Antes de un fin de semana o de entregar, borra los archivos generados y haz una compilación limpia. Este ritmo mantiene rápida la iteración y detecta pronto fallos del PDF final.

Otras tácticas

• Minimiza la espera con compilaciones incrementales de latexmk o -pvc (véase Compilaciones automáticas).
• Para figuras pesadas, externaliza TikZ o prerenderiza a PDF para mantener ligeras las recompilaciones.
• Quita temporalmente secciones enormes de \includeonly, o coméntalas.
• Justo antes de terminar, compila todo con final para fijar numeración, tabla de contenido, índice y bibliografía.
• Antes de entregar, quita draft y \includeonly, recompila el PDF y lee también los warnings del log.