6. Opções de Compilação¶
Neste apêndice são apresentadas algumas opções úteis para a compilação de documentos LaTeX. Na Parte 1, foi mostrado como um documento LaTeX simples pode ser compilado utilizando-se os seguintes comandos:
1 2 3 | |
Na sequência de comandos acima, até que o resultado final seja alcançado (o arquivo PDF), observe que há vários arquivos intermediários que são gerados durante a compilação. O comando latex arquivo.tex irá gerar os seguintes arquivos:
arquivo.aux: contém as informações sobre a estrutura e as partes do documento (e.g., sumário, capítulos, seções etc);arquivo.dvi: é o arquivo que contém o documento formatado, pronta para inspeção no computador (ainda não é o arquivo final);arquivo.log: contém informações o compilador utilizado e a versão, o tipo de classe empregada, estilos e pacotes carregados.
O passo seguinte à execução do comando latex, é criar um arquivo que possa ser impresso. Esse arquivo pode ser um arquivo PS, EPS ou PDF, sendo o arquivo PDF o formato preferível. Para criar o arquivo no formato PS, utiliza-se o comando:
1 | |
Para criar o arquivo PDF, há duas formas: converter o arquivo DVI em PDF (sem a necessidade do arquivo PS), a partir do comando:
1 | |
A outra forma, é converter o arquivo PS em PDF, utilizando o comando a seguir:
1 | |
Entretando, ao invés de utilizar a sequência de comandos acima, pode-se utilizar o comando pdflatex que automatiza as etapas intermediárias entre o documento LaTeX e o arquivo PDF final:
1 | |
Outros compiladores, como o XeLaTeX escrevem o arquivo PDF de forma direta, bastando, para isso, utilizar o seguinte comando:
1 | |
Dependendo das necessidades do usuário ou da complexidade do documento escrito (como esta apostila), pode ser necessário utilizar algumas opções do compilador para que o documento seja criado. O comportamento padrão dos compiladores do LaTeX, é abortar o processo de compilação quando erros são encontrados. Por exemplo, quando um comando é digitado errado, como indicado a seguir:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | |
Na saída do comando acima, observe que o compilador não entendeu a instrução \maketitlee e parou a compilação com a mensagem ! Undefined control sequence.. Neste caso, o compilador aguarda algum tipo de instrução, o que é conveniente pois permite que o usuário possa identificar e corrigir os problemas. Neste caso, para sair do prompt de compilação do LaTeX, basta digitar a palavra quit. Veja a seguir:
1 2 3 4 5 6 7 | |
Quando algum pacote desatualizado, ou que causa algum tipo de conflito com outro pacote ocorre, ou quando comandos errados são utiizados (e o usuário não percebe), a opção -interaction=nonstopmode pode ser útil. Esta opção instrui o compilador em uso a continuar com a compilação do documento, mesmo que erros sejam encontrados. Ela deve ser utilizada da seguinte forma:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 | |
Note que mesmo com a instrução \maketitlee estando incorreta (o correto é maketitle), o compilador continuou com a compilação até o fim. Neste caso, o resultado é um documento sem o título, nome do autor e data.
Alguns pacotes, requerem opções especiais para que possam ser utilizados. Um exemplo é o pacote tcolorbox quando é utilizado para produzir listagem de código (como a maioria dos exemplos mostrados nesta apostila). Neste caso, faz-se necessária a utilização do pacote Pygments do Python. Como este pacote não pertence ao LaTeX, é necessário utilizar a opção -shell-escape para que o pacote tcolorbox possa utilizar o pacote Pygments. Neste caso, a utilização desta ocorre da seguinte forma:
1 | |
Alguns editores tem a funcionalidade de atualizar automaticamente o documento final quando o código-fonte é salvo, como é o caso do editor online Overleaf. Quando o LaTeX é utilizado em linha de comando, é possível também obter um comportamente semelhante utilizando o comando latexmk: enquando o documento é editado e salvo, utilizando um editor local como o VIM, pode-se deixar o comando a seguir sendo executado em um outro terminal (no mesmo diretório):
1 | |
Após executar este comando (o terminal ficará ocupado), ocorrerá o seguinte:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 | |
Observe a mensagem === Watching for updated files. Use ctrl/C to stop .... Se o documento PDF estiver aberto em um visualizador como o Adobe Acrobat ou o Evince, o documento deverá ser atualizado sempre que o código-fonte for salvo.
Por fim, todo o conteúdo desta apostila pode ser acessado a partir de https://github.com/cfbastarz/CursoIntroLaTeX. Para obter uma cópia do repositório, basta seguir os passos abaixo:
1 | |
Para compilar o código, será necessário ter o pacote Pygments do Python instalado na máquina. Para instalar este pacote, basta utilizar um dos comandos a seguir:
1 | |
ou
1 | |
No Mac OS X, pode-se utilizar o gerenciador de pacotes brew para instalar o pacote pygments:
1 | |
A apostila (e os outros materiais), podem ser finalmente compilados utilizando o compilador XeLaTeX e o BibTeX:
1 2 3 4 | |