Projetos com vários arquivos
Mantenha o preâmbulo e o \begin{document} em main.tex e traga os outros arquivos com \input{chapters/intro} ou \include{chapters/intro}; o Scissor LaTeX junta tudo em um documento antes de compor.
Por que dividir um documento
Uma tese ou um relatório longo é mais fácil de trabalhar em partes: um arquivo por capítulo, um para o preâmbulo, um para o apêndice. O LaTeX tem dois comandos para isso, e os dois funcionam no Scissor LaTeX.
| Comando | O que faz | No Scissor LaTeX |
|---|---|---|
\input{file} | Coloca o texto do arquivo exatamente ali, como se você o tivesse digitado. | Funciona, também no preâmbulo e de forma aninhada. |
\include{file} | Começa uma nova página, coloca ali o texto do arquivo e termina a página. | Funciona. Quebras de página seguidas viram uma só, então não há páginas vazias. |
\includeonly{a,b} | Deixa de fora todo \include que não está na lista. | Ignorado: todos os arquivos são incluídos. |
\subfile{file} (subfiles) | Como \input, para arquivos que também compilam sozinhos. | Não suportado: pulado com uma mensagem. Use \input. |
\import{dir/}{file} (import) | \input relativo a outra pasta. | Não suportado: pulado com uma mensagem. |
Um projeto pequeno
Um projeto típico tem um arquivo principal e uma pasta de capítulos:
main.tex
preamble.tex
chapters/intro.tex
chapters/method.tex
refs.bibO arquivo principal contém a classe, o preâmbulo e o corpo do documento, e traz o resto:
\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 arquivo de capítulo contém só a sua parte do texto, sem preâmbulo e sem \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}.O Scissor LaTeX substitui cada \input e \include pelo texto do arquivo e compõe o resultado como um único documento. Rótulos, referências e citações funcionam entre arquivos, porque para o compositor é tudo um texto só.
Como fica o documento juntado
Isto é o que o editor compõe quando main.tex traz dois arquivos de capítulo com \input: o texto dos dois arquivos, em ordem. (O exemplo está escrito como um único arquivo para poder ser mostrado aqui.) Em um report ou book, \chapter começa cada capítulo em uma nova página por conta própria.
Dois arquivos de capítulo juntados em um 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}
Como os nomes de arquivo são encontrados
- Os caminhos são relativos à pasta raiz do projeto, assim como no LaTeX são relativos à pasta do arquivo principal, também dentro de arquivos aninhados.
- A extensão
.texpode ser omitida:\input{chapters/intro}encontrachapters/intro.tex. - Aspas em volta de um nome, como em
\input{"my file"}, são removidas. - Um arquivo que está faltando aparece como erro na aba Problemas, com a linha do
\input. O resto do documento continua sendo composto. - Um arquivo que inclui a si mesmo, diretamente ou por meio de outros, é deixado de fora com uma mensagem, e o aninhamento para depois de 24 níveis.
subfiles e \includeonly
O pacote subfiles permite que cada capítulo compile sozinho. O Scissor LaTeX não segue \subfile: o comando é pulado e a aba Problemas avisa que um arquivo não foi incluído.
\subfile não é seguido
\documentclass{article}
\usepackage{subfiles}
\begin{document}
The chapter below is not included:
\subfile{chapters/intro}
Replace it with an \verb|\input| line.
\end{document}Aba Problemas: 1 included file is not part of this conversion
Para trabalhar em um capítulo de cada vez, comente as outras linhas \include com %. \includeonly é aceito, mas não tem efeito: todo arquivo incluído é composto. O mesmo vale para \lstinputlisting e \inputminted, que são pulados com a mesma mensagem (veja Listagens de código).
Outros arquivos do projeto
Imagens, arquivos .bib e arquivos de dados podem ficar em qualquer pasta; faça referência a eles pelo caminho a partir da pasta raiz, como \includegraphics{figures/plot.png}. Todos os arquivos .bib do projeto são usados nas citações, seja qual for o nome dado em \bibliography (veja Bibliografias). Para trazer um projeto inteiro de uma instalação do TeX, veja Projetos e arquivos.
O que difere de uma instalação do TeX
Os manuais dos pacotes relacionados estão no CTAN: subfiles e import.
Perguntas e respostas
Qual é a diferença entre \input e \include?
\input cola o texto do arquivo no lugar. \include também começa e termina uma nova página em volta dele e, em uma instalação do TeX, funciona com \includeonly. No Scissor LaTeX os dois servem para capítulos; \includeonly é ignorado, então todo \include é composto.
Por que meu arquivo do \input não é encontrado?
Confira o caminho a partir da pasta raiz do projeto e a grafia, inclusive as letras maiúsculas. A aba Problemas mostra o nome procurado e a linha do \input.
O subfiles funciona no Scissor LaTeX?
Não. Substitua \subfile{...} por \input{...}; assim os arquivos de capítulo não precisam de um preâmbulo próprio.
Cada exemplo desta página é composto pelo Scissor LaTeX quando o site é gerado. Última atualização: 2026-11-07.