Projetos e arquivos

Um projeto é um conjunto de arquivos guardado no seu dispositivo, e um deles é o arquivo principal, o que é composto. Você pode importar um projeto inteiro de uma vez abrindo um .zip ou uma pasta, por exemplo um baixado de outro editor de LaTeX.

O que é um projeto

Um projeto reúne todos os arquivos de que seu documento precisa: códigos .tex, um arquivo .bib com suas referências, imagens e arquivos de dados para gráficos. Os arquivos podem ficar em pastas, como chapters/intro.tex ou figures/plot.png.

Os projetos são salvos no armazenamento do seu navegador, neste dispositivo, um instante depois de cada alteração. O painel Projetos lista todos eles, do mais novo para o mais antigo, e permite renomear, trocar ou excluir. Excluir um projeto aqui nunca exclui uma cópia que você salvou no Google Drive.

O arquivo principal

Um arquivo .tex é o arquivo principal: o que tem \documentclass e \begin{document}. É ele que é composto, e ele puxa os outros com \input e \include. O painel Arquivos o marca com principal.

Para compor outro arquivo, abra o menu dele no painel Arquivos e escolha Compor este arquivo, ou selecione-o em Arquivo principal.

Um arquivo principal com bibliografia

LaTeXCopiarAbrir no editor (abre em uma nova aba)

\documentclass{article}
\begin{document}
\section{Background}
Long tables are discussed by \cite{mustermann2021}.
\bibliographystyle{plain}
\bibliography{refs}
\end{document}

O exemplo acima precisa de um segundo arquivo, refs.bib, no mesmo projeto. Abra-o no editor para ver os dois arquivos. Mais sobre referências em Bibliografias e citações.

Vários arquivos .tex

Divida um documento longo em um arquivo por capítulo e puxe-os para o arquivo principal. \input{chapters/intro} insere o arquivo onde o comando está; \include{chapters/intro} faz o mesmo e antes começa uma nova página. A extensão .tex pode ser omitida.

\documentclass{report}
\begin{document}
\include{chapters/intro}
\include{chapters/method}
\input{appendix}
\end{document}

Erros num arquivo incluído apontam para o arquivo e a linha certos na aba Problemas. Veja Projetos com vários arquivos para os detalhes, incluindo o que acontece com \includeonly e o pacote subfiles.

Adicionar arquivos

Há várias maneiras de adicionar arquivos ao projeto aberto:

• Solte arquivos em qualquer lugar do editor.
• No painel Arquivos, use Enviar arquivos para arquivos ou Pasta para uma pasta inteira deste dispositivo.
• Use Novo arquivo para criar um arquivo vazio. Digite um caminho como chapters/intro.tex para colocá-lo numa pasta.
• Use Drive ou Pasta do Google Drive para adicionar arquivos do seu Google Drive. Veja Salvar no Google Drive.

Se o projeto já tiver um arquivo com o mesmo nome, o editor pergunta se deve substituí-lo ou manter o seu.

O editor aceita .tex, .bib, .sty, .cls, .bst, .txt, .md, .csv e arquivos de texto parecidos, imagens (PNG, JPG, SVG, PDF e mais alguns) e arquivos .zip, que são descompactados.

Importar um projeto de um .zip ou de uma pasta

A maioria dos editores de LaTeX e toda instalação do TeX guardam um projeto como uma pasta. Para trazer um para o Scissor LaTeX:

1. Baixe o projeto como .zip do outro editor, ou encontre a pasta dele no seu computador.
2. No Scissor LaTeX, escolha Novo projeto e depois Abrir arquivos .tex ou .zip ou Abrir uma pasta.
3. O editor descompacta o projeto, mantém a estrutura de pastas e escolhe o arquivo principal.

Quando há mais de um documento completo, o editor prefere main.tex, depois um arquivo com o mesmo nome da pasta e depois o que tem o caminho mais curto. Um aviso informa qual arquivo ele escolheu, e você pode mudá-lo em Arquivo principal.

Uma pasta pode ter até 2.000 arquivos e 100 MB. Quando uma pasta é maior, os códigos-fonte são mantidos primeiro e o resto fica de fora e é contado.

Arquivos de que o documento precisa, mas que faltam no projeto

Depois que você abre ou adiciona arquivos, o editor confere o que seu documento referencia: imagens em \includegraphics, arquivos .bib, arquivos em \input e \include e arquivos de dados de gráficos. Se faltar algo, o painel Arquivos lista o que falta, com botões para enviar o arquivo ou adicioná-lo do Drive. Um arquivo que você adiciona só pelo nome vai para onde o documento espera, então plot.png vai para figures/ se o documento pedir figures/plot.png.

Até lá, uma imagem que falta é desenhada como uma caixa tracejada com o nome dela, e a aba Problemas diz quais imagens faltam.

Uma imagem no projeto, outra faltando

LaTeXPreâmbulo: \usepackage{graphicx}CopiarAbrir no editor (abre em uma nova aba)

\includegraphics[width=0.45\linewidth]{figures-plot.png}

\includegraphics[width=0.45\linewidth]{figures/missing.png}

Aba Problemas: Images not in the project: figures/missing.png

Seus próprios arquivos .sty e .cls

Um projeto pode ter seus próprios arquivos .sty e .cls: eles são mantidos, salvos no Drive e exportados com o projeto. A prévia, porém, ainda não os lê. Um \usepackage{mymacros} que indica um arquivo seu aparece na aba Problemas como um pacote indisponível, e os comandos definidos nele são ignorados.

Enquanto isso não mudar, copie as linhas \newcommand e \newenvironment de que você precisa do seu arquivo .sty para o preâmbulo do arquivo principal. Elas funcionam ali, e o documento continua compilando numa instalação do TeX.

\documentclass{article}
% from mymacros.sty
\newcommand{\project}{River Survey}
\newcommand{\unit}[1]{\,\mathrm{#1}}
\begin{document}
The \project{} measured a flow of $44\unit{m^3/s}$.
\end{document}

O que muda em relação a uma instalação do TeX

Cada exemplo desta página é composto pelo Scissor LaTeX quando o site é gerado. Última atualização: 2026-11-07.