Saltar al contenido
Topos Uranos
Español

Documentos largos

Resumen

Esta clase enseña a dividir un documento largo en varios archivos sin que deje de ser un solo documento. Explica por qué conviene dividir una tesis, un libro o un volumen colectivo; distingue \input, que inserta un archivo como si su texto estuviera escrito en su lugar, de \include, que compone un capítulo en páginas propias y con un archivo auxiliar propio; muestra cómo \includeonly compila solo algunos capítulos conservando la numeración y las referencias, y en qué condición lo consigue; propone una organización de carpetas y de nombres de archivo; enseña a declarar en Texmaker el documento maestro y a compilar siempre desde el archivo principal; presenta el paquete subfiles para compilar un capítulo por separado; desarrolla como caso completo la estructura de una tesis; y recorre los errores más frecuentes, con sus mensajes reales.

Objetivos de aprendizaje

  1. Decidir, para cada pieza de un documento largo, si debe insertarse con \input o con \include, según sus efectos sobre las páginas y los archivos auxiliares.
  2. Predecir qué números, páginas y referencias produce \includeonly, y explicar de qué compilación anterior depende que se conserven.
  3. Organizar un proyecto en un archivo principal y carpetas, con rutas relativas al archivo principal y nombres de archivo que no causen problemas.
  4. Configurar Texmaker para que compile el documento maestro desde cualquier archivo del proyecto, y preparar con subfiles capítulos que también compilen solos.
  5. Reconocer en el registro los errores propios de los documentos divididos y distinguir los que detienen la compilación de los que la dejan terminar con un resultado incompleto.

Por qué dividir un documento

Un artículo de quince páginas cabe cómodamente en un solo archivo. Una tesis de doscientas, no: el archivo tiene miles de líneas, encontrar un pasaje exige buscarlo, y cada compilación recorre el documento entero aunque solo haya cambiado una coma del último capítulo. Un libro añade capítulos que se escriben en épocas distintas; un volumen colectivo, capítulos que escriben autores distintos, cada uno a su ritmo. En los tres casos conviene que cada capítulo viva en su propio archivo.

Ahora bien, dividir los archivos no debe dividir el documento. El índice debe listar todos los capítulos, la numeración debe continuar de uno a otro y una referencia escrita en el primero debe encontrar la sección del quinto. La solución de LaTeX es un archivo principal, que contiene la clase, el preámbulo y el orden de las piezas, y que inserta cada pieza en su lugar con una instrucción. El motor compila siempre el archivo principal; las piezas no son documentos, sino fragmentos de su cuerpo. De ello se sigue la regla que recorre toda la clase: una pieza no tiene preámbulo, y se compila desde el archivo principal.

Hay dos instrucciones para insertar una pieza, \input e \include, y su diferencia no es de estilo: cada una hace algo distinto con las páginas y con los archivos auxiliares.