Los archivos de un proyecto real

.tex, .bib, .cls, .sty y la basura generada que no debes subir a Git.

Los archivos de un proyecto real

Abre la carpeta de cualquier proyecto real de LaTeX después de compilar y encontrarás muchos más archivos de los que escribiste. Esto sorprende a la mayoría de los principiantes, y el miedo a borrar lo que no se debe mantiene las carpetas desordenadas para siempre. La distinción que lo aclara: algunos archivos son código fuente que tú editas, otros son estilos que aportan una plantilla o un paquete, y el resto es espacio de trabajo temporal generado que el compilador recrea en cada ejecución.

Los archivos que escribes

Tus archivos .tex contienen el documento propiamente dicho: el texto, las secciones, las figuras y las matemáticas. Un archivo .bib es tu base de datos bibliográfica, con una entrada por cada artículo o libro que puedas citar; puedes mantenerlo a mano o exportarlo desde un gestor de referencias como Zotero. Estos son los archivos que merece la pena respaldar y poner bajo control de versiones, porque todo lo demás se puede reconstruir a partir de ellos.

Los archivos que te da una plantilla

Un archivo .cls define una clase de documento, lo que indicas en \documentclass{...}. Las revistas y los congresos distribuyen la suya para que todos los envíos tengan el mismo aspecto, y casi nunca se edita. Un archivo .sty es un paquete: macros y ajustes reutilizables que se cargan con \usepackage. Solo escribirás uno tú mismo cuando quieras compartir comandos personalizados entre varios documentos. Un archivo .bst describe un estilo de citas de BibTeX y, del mismo modo, lo habitual es limitarse a copiar el que facilita la revista o el congreso.

Los archivos que genera el compilador

El archivo .aux guarda los datos de referencias cruzadas y de citas entre las pasadas de compilación; nunca lo edites, y no dudes en borrarlo, porque la siguiente compilación lo reescribe. El archivo .log registra todo lo que hizo el compilador y solo merece abrirse cuando algo va mal. El .pdf es el resultado que de verdad querías.

ExtensiónFunción¿Editar a mano?
.texDocumentos fuente y capítulosSí
.bibBase de datos bibliográficaSí (o exportar desde Zotero)
.clsClase de documentoRara vez (plantillas de terceros)
.styPaquetes / archivos de estiloAl escribir tus propias macros
.bstEstilo de BibTeXRara vez
.auxDatos de referencias cruzadasNo: generado
.logRegistro del compiladorLéelo al depurar
.pdfResultadoVer / enviar

Una estructura de proyecto que escala

paper/
main.tex
chapters/
figures/
refs.bib

Un único main.tex en el nivel superior actúa como punto de entrada, los capítulos viven en su propia carpeta y se incorporan con \input o \include, las imágenes están en figures/, y la bibliografía se queda en un solo refs.bib. Esta estructura sigue siendo manejable tanto si el proyecto es un artículo de cuatro páginas como una tesis. Separar los capítulos en archivos muestra cómo se conectan las piezas.

Si usas Git, añade *.aux, *.log y los demás archivos generados a .gitignore, para que tu historial solo registre código fuente real. Los proyectos de Oleafly son carpetas normales en el disco, así que este consejo se aplica igual allí. El error más frecuente es el contrario: al buscar un error de compilación raro, borrar los archivos .aux suele ser la solución, porque uno obsoleto de una ejecución fallida puede envenenar todas las compilaciones posteriores.

Volver a Abrir el bucle