Saltar al contenido

Proyectos con varios archivos

Deja el preámbulo y \begin{document} en main.tex e incorpora los demás archivos con \input{chapters/intro} o \include{chapters/intro}; Scissor LaTeX los une en un solo documento antes de componerlo.

Por qué dividir un documento

Una tesis o un informe largo es más fácil de trabajar por partes: un archivo por capítulo, uno para el preámbulo, otro para el apéndice. LaTeX tiene dos comandos para esto, y los dos funcionan en Scissor LaTeX.

ComandoQué haceEn Scissor LaTeX
\input{file}Pone aquí mismo el texto del archivo, como si lo hubieras escrito tú.Funciona, también en el preámbulo y anidado.
\include{file}Empieza una página nueva, pone aquí el texto del archivo y termina la página.Funciona. Varios saltos de página seguidos se convierten en uno, así que no quedan páginas vacías.
\includeonly{a,b}Omite todos los \include que no están en la lista.Se ignora: se incluyen todos los archivos.
\subfile{file} (subfiles)Como \input, para archivos que también compilan por separado.No compatible: se omite con un aviso. Usa \input.
\import{dir/}{file} (import)\input relativo a otra carpeta.No compatible: se omite con un aviso.

Un proyecto pequeño

Un proyecto típico tiene un archivo principal y una carpeta de capítulos:

TEXT
main.tex
preamble.tex
chapters/intro.tex
chapters/method.tex
refs.bib

El archivo principal contiene la clase, el preámbulo y el cuerpo del documento, e incorpora el resto:

LaTeX
\documentclass{report}
\input{preamble}

\title{Rainfall at Two Sites}
\author{Erika Mustermann}

\begin{document}
\maketitle
\input{chapters/intro}
\input{chapters/method}
\bibliographystyle{plain}
\bibliography{refs}
\end{document}

Cada archivo de capítulo contiene solo su parte del texto, sin preámbulo y sin \begin{document}:

LaTeX
\chapter{Introduction}
\label{chap:intro}
Rain gauges were read every morning for 44 days.
The method is described in Chapter~\ref{chap:method}.

Scissor LaTeX sustituye cada \input e \include por el texto del archivo y compone el resultado como un solo documento. Las etiquetas, las referencias y las citas funcionan entre archivos, porque para el compositor todo es un único texto.

Cómo queda el documento unido

Esto es lo que compone el editor cuando main.tex incorpora dos archivos de capítulo con \input: el texto de ambos archivos, en orden. (El ejemplo está escrito como un solo archivo para poder mostrarlo aquí.) En un report o un book, \chapter empieza cada capítulo por sí solo en una página nueva.

Dos archivos de capítulo unidos en un solo documento

\documentclass{report}
\begin{document}
\chapter{Introduction}
\label{chap:intro}
Rain gauges were read every morning for 44 days.
The method is described in Chapter~\ref{chap:method}.
\chapter{Method}
\label{chap:method}
Each gauge was emptied after reading, as noted in
Chapter~\ref{chap:intro}.
\end{document}
Compuesto por Scissor LaTeX: Dos archivos de capítulo unidos en un solo documento
Página 2

Cómo se encuentran los nombres de archivo

  • Las rutas son relativas a la carpeta superior del proyecto, igual que en LaTeX son relativas a la carpeta del archivo principal, también dentro de archivos anidados.
  • La extensión .tex se puede omitir: \input{chapters/intro} encuentra chapters/intro.tex.
  • Las comillas alrededor de un nombre, como en \input{"my file"}, se eliminan.
  • Un archivo que falta aparece como error en la pestaña Problemas, con la línea del \input. El resto del documento se sigue componiendo.
  • Un archivo que se incluye a sí mismo, directamente o a través de otros, se omite con un aviso, y el anidamiento se detiene después de 24 niveles.

subfiles e \includeonly

El paquete subfiles permite compilar cada capítulo por separado. Scissor LaTeX no sigue \subfile: el comando se omite y la pestaña Problemas indica que no se ha incluido un archivo.

\subfile no se sigue

\documentclass{article}
\usepackage{subfiles}
\begin{document}
The chapter below is not included:
\subfile{chapters/intro}
Replace it with an \verb|\input| line.
\end{document}

Pestaña Problemas: 1 included file is not part of this conversion

Para trabajar en un capítulo cada vez, comenta las demás líneas \include con %. \includeonly se acepta, pero no tiene efecto: se componen todos los archivos incluidos. Lo mismo ocurre con \lstinputlisting e \inputminted, que se omiten con el mismo aviso (consulta Listados de código).

Otros archivos del proyecto

Las imágenes, los archivos .bib y los archivos de datos pueden estar en cualquier carpeta; haz referencia a ellos con su ruta desde la carpeta superior, como \includegraphics{figures/plot.png}. Todos los archivos .bib del proyecto se usan para las citas, nombre lo que nombre \bibliography (consulta Bibliografías). Para traer un proyecto entero desde una instalación de TeX, consulta Proyectos y archivos.

Diferencias con una instalación de TeX

Los manuales de los paquetes relacionados están en CTAN: subfiles e import.

Preguntas y respuestas

¿Qué diferencia hay entre \input e \include?

\input pega el texto del archivo en su lugar. \include además empieza y termina una página nueva a su alrededor, y en una instalación de TeX funciona con \includeonly. En Scissor LaTeX ambos sirven para capítulos; \includeonly se ignora, así que se componen todos los \include.

¿Por qué no se encuentra mi archivo de \input?

Comprueba la ruta desde la carpeta superior del proyecto y la ortografía, incluidas las mayúsculas. La pestaña Problemas muestra el nombre que se buscó y la línea del \input.

¿Funciona subfiles en Scissor LaTeX?

No. Sustituye \subfile{...} por \input{...}; así, los archivos de capítulo no necesitan un preámbulo propio.

Scissor LaTeX compone cada ejemplo de esta página al generar el sitio. Última actualización: 2026-11-07.