Os arquivos de um projeto real
.tex, .bib, .cls, .sty e os arquivos gerados que você não deve incluir no Git.
Os arquivos de um projeto real
Abra a pasta de qualquer projeto LaTeX de verdade depois de uma compilação e você vai encontrar bem mais arquivos do que escreveu. Isso surpreende a maioria dos iniciantes, e o medo de apagar a coisa errada deixa as pastas bagunçadas para sempre. A distinção que esclarece tudo: alguns arquivos são código-fonte que você edita, outros são estilos fornecidos por um modelo ou por um pacote, e o resto é espaço de rascunho gerado, que o compilador recria a cada execução.
Os arquivos que você escreve
Seus arquivos .tex guardam o documento em si: o texto, as seções, as figuras e a matemática. Um arquivo .bib é o seu banco de dados de bibliografia, com uma entrada para cada artigo ou livro que você pode citar; você pode mantê-lo à mão ou exportá-lo de um gerenciador de referências como o Zotero. São esses os arquivos que valem um backup e o controle de versão, porque todo o resto pode ser reconstruído a partir deles.
Os arquivos que um modelo fornece
Um arquivo .cls define uma classe de documento, aquilo que você informa em \documentclass{...}. Periódicos e conferências distribuem as suas próprias classes para que toda submissão tenha a mesma aparência, e você quase nunca precisa editar uma delas. Um arquivo .sty é um pacote: macros e configurações reutilizáveis, carregadas com \usepackage. Você só vai escrever um quando quiser compartilhar comandos próprios entre vários documentos. Um arquivo .bst descreve um estilo de citação do BibTeX e, da mesma forma, costuma vir pronto, incluído pela conferência ou pelo periódico.
Os arquivos que o compilador gera
O arquivo .aux guarda dados de referências cruzadas e de citações entre as passagens de compilação; nunca o edite, e pode apagá-lo sem medo, pois a próxima compilação o reescreve. O arquivo .log registra tudo o que o compilador fez e só vale a pena abri-lo quando algo dá errado. O .pdf é a saída que você realmente queria.
| Extensão | Função | Editar à mão? |
|---|---|---|
.tex | Documentos-fonte e capítulos | Sim |
.bib | Banco de dados de bibliografia | Sim (ou exportar do Zotero) |
.cls | Classe de documento | Raramente (modelos de terceiros) |
.sty | Pacotes / arquivos de estilo | Ao escrever as suas próprias macros |
.bst | Estilo do BibTeX | Raramente |
.aux | Dados de referências cruzadas | Não: gerado |
.log | Log do compilador | Leia ao depurar |
.pdf | Saída | Ver / enviar |
Uma estrutura de projeto que escala
paper/ main.tex chapters/ figures/ refs.bibUm único main.tex no nível superior serve de ponto de entrada, os capítulos ficam em uma pasta própria e são incluídos com \input ou \include, as imagens ficam em figures/ e a bibliografia fica em um só refs.bib. Essa estrutura continua fácil de manter, seja o projeto um artigo de quatro páginas ou uma tese. Dividir o documento em arquivos de capítulo mostra como as peças se conectam.
Se você usa Git, adicione *.aux, *.log e os outros arquivos gerados ao .gitignore, para que o seu histórico registre apenas código-fonte de verdade. Os projetos do Oleafly são pastas comuns no disco, então esse conselho vale sem mudanças por lá. O erro mais comum é o inverso: ao caçar um erro de compilação estranho, apagar os arquivos .aux costuma ser a solução, porque um arquivo desatualizado de uma execução quebrada pode contaminar todas as compilações seguintes.