Un archivo raíz, muchos capítulos

include frente a input, includeonly y redactar un capítulo cada vez.

Un archivo raíz, muchos capítulos

Una tesis en un único archivo .tex se vuelve un suplicio más o menos a partir del segundo capítulo: desplazarse sustituye a pensar, y cada compilación lo procesa todo. La cura estándar es un archivo raíz que contiene la clase y el preámbulo, con cada capítulo en su propio archivo. El archivo raíz los une.

El archivo raíz

% main.tex
\documentclass{report}
\begin{document}
\include{chapters/intro}
\include{chapters/methods}
\include{chapters/results}
\end{document}

main.tex es el único archivo que compilas. Cada \include nombra otro archivo sin su extensión .tex, usando barras normales en todas las plataformas, e incorpora su contenido en ese punto. Los archivos de capítulo solo contienen contenido, y suelen empezar con \chapter{...}. No tienen \documentclass ni un entorno document propio, porque son fragmentos de este documento, no documentos.

include frente a input

Los dos comandos de inclusión se comportan de forma distinta, y las diferencias deciden cuál usar y dónde. \include empieza una página nueva antes del material, lo que conviene a los capítulos, y escribe un archivo .aux separado para cada archivo incluido, que es lo que hace posible la compilación selectiva. \input es un pegado textual simple: sin salto de página, sin .aux separado, y puede anidarse dentro de otro input. Eso convierte a \input en la herramienta adecuada para fragmentos menores que un capítulo, como una tabla grande guardada en su propio archivo o un archivo de macros compartido. Una regla estructural que conviene recordar es que \include no puede anidarse dentro de un archivo incluido, mientras que \input puede usarse en cualquier parte.

Redactar un capítulo cada vez

\includeonly{chapters/methods}

Colocado en el preámbulo, \includeonly le dice a LaTeX que procese solo los archivos indicados y que siga leyendo los datos .aux guardados de todos los demás. La compilación se acelera drásticamente, y como las etiquetas y los recuentos de páginas de los demás capítulos se reproducen desde sus archivos .aux, las referencias cruzadas y la numeración del capítulo que estás redactando siguen siendo correctas. Esa segunda mitad es la razón para preferir esto a comentar líneas \include, que olvida por completo los demás capítulos y convierte cada \ref hacia ellos en ??.

Comenta la línea \includeonly para las compilaciones completas, y haz siempre una compilación completa antes de compartir un PDF, porque los datos .aux obsoletos pueden quedarse atrás respecto a las ediciones hechas en los capítulos excluidos. Para saber qué archivos de la carpeta resultante son tuyos y cuáles se generan, consulta los archivos de un proyecto real.

Volver a Formato largo