Saltar para o conteúdo
Topos Uranos
Português

Anatomia de um documento

Resumo

Esta aula decompõe uma fonte de LaTeX em suas peças. Distingue o preâmbulo do corpo e explica o que pode ir em cada um e por quê; descreve os comandos, com seus dois tipos de nome, seus argumentos obrigatórios e opcionais e suas formas com asterisco, e precisa onde termina o nome de um comando; mostra como os grupos limitam o alcance das declarações; apresenta os ambientes e o erro produzido por um aninhamento incorreto; percorre os dez caracteres reservados, o que cada um faz e como se imprime; explica os comentários como meio de desativar código; e apresenta brevemente os pacotes e a classe do documento com suas opções, que a unidade dedicada à estrutura desenvolverá.

Objetivos de aprendizagem

  1. Distinguir o preâmbulo do corpo e decidir onde deve ir um comando de acordo com o que ele faz.
  2. Reconhecer em um comando seu nome, seus argumentos obrigatórios e opcionais e sua forma com asterisco, e prever onde termina seu nome.
  3. Prever o alcance de uma declaração dentro de grupos e ambientes, e escrevê-la de modo que afete apenas o texto devido.
  4. Aninhar corretamente os ambientes e interpretar o erro que um aninhamento incorreto produz.
  5. Imprimir cada um dos dez caracteres reservados e explicar o que cada um faz quando não é protegido.

As duas partes de uma fonte

Toda fonte de LaTeX tem a mesma forma. Começa com \documentclass, que declara a classe do documento. O que vem depois, até \begin{document}, é o preâmbulo: nele se carregam os pacotes e se tomam as decisões que valem para todo o documento, mas nada se compõe. Entre \begin{document} e \end{document} está o corpo, o único lugar onde se compõe texto. O que se escrever depois de \end{document} é ignorado por completo.

A divisão não é uma convenção de estilo, mas uma consequência de como o LaTeX trabalha. Ao chegar a \begin{document}, o LaTeX encerra a configuração: já se sabe quais pacotes existem e qual tipografia, qual idioma e qual tamanho de página vigoram, e a partir desse momento se compõe. Disso decorrem duas regras, e dois erros. Primeira: um pacote só pode ser carregado no preâmbulo, porque poderia alterar decisões já aplicadas; um \usepackage no corpo produz o erro “Can be used only in preamble”. Segunda: no preâmbulo nada se compõe; um texto, um título de seção ou um sumário escritos antes de \begin{document} produzem o erro “Missing \begin{document}”.

Entre os dois extremos há comandos que apenas definem ou guardam algo, sem compô-lo: \newcommand, que define um comando novo, ou \title, que guarda o título para quando \maketitle o imprimir. Esses funcionam em qualquer das duas partes, mas vão no preâmbulo, porque assim valem desde o início e quem lê a fonte os encontra reunidos.

ExemploUm documento com suas partes indicadas

Os comentários, que começam com %, indicam as partes; o motor os ignora. A última linha, escrita depois de \end{document}, também não aparece no resultado.

Código LaTeX
\documentclass{article}      % a classe\usepackage{fontspec}        % preâmbulo: pacotes\usepackage[brazilian]{babel}\title{Relatório de leitura} % preâmbulo: dados que se guardam\author{Ana Souza}\date{}​\begin{document}             % começa o corpo\maketitle\section{Apresentação do problema}O corpo é o único lugar onde se compõe texto.\end{document}               % fim do corpoEsta linha não aparece no resultado.
Resultado
Resultado

O comando \date{}, com o argumento vazio, faz com que \maketitle não imprima a data, que de outro modo seria a da compilação. A opção brazilian de babel segue as convenções do português do Brasil; para o português europeu usa-se portuguese.