Tudo o que vem antes de begin{document}

Pacotes, metadados e ordem de carregamento: o que pertence ao preâmbulo e o que não pertence.

Tudo o que vem antes de begin{document}

Tudo o que fica entre \documentclass{...} e \begin{document} é o preâmbulo. Ele não produz texto visível. Ele configura a compilação. Fontes, margens, pacotes, comandos personalizados e metadados do documento vivem todos aqui, e é por isso que o preâmbulo de um artigo maduro costuma ser mais longo do que a introdução. Quando você sabe o que cada linha faz, um modelo copiado deixa de ser mágica e vira uma lista de verificação.

Anatomia

\documentclass[11pt,a4paper]{article}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage[margin=1in]{geometry}
\usepackage{amsmath,amssymb}
\usepackage{graphicx,booktabs}
\usepackage{hyperref} % load late
\title{Title}
\author{You}
\date{\today}

As opções de \documentclass definem padrões globais: 11pt é o tamanho base da fonte a partir do qual todo o resto escala, e a4paper declara o tamanho do papel. As duas linhas de codificação são companheiras históricas: inputenc informa ao motor que o seu arquivo-fonte está em UTF-8, e fontenc seleciona a codificação das fontes, para que os caracteres acentuados sejam glifos de verdade e não composições. O LaTeX atual já presume entrada em UTF-8, então você verá essas linhas omitidas em documentos novos, mas elas são inofensivas e os modelos as mantêm por compatibilidade.

O bloco do meio carrega pacotes de funcionalidades. O geometry define as margens em uma única opção, amsmath e amssymb fornecem os ambientes e os símbolos matemáticos de que quase todo documento técnico precisa, graphicx habilita o \includegraphics para figuras e booktabs fornece os filetes que fazem as tabelas parecerem profissionais. Por fim, o hyperref torna as referências e as citações clicáveis e é carregado por último de propósito, porque redefine partes internas de muitos outros pacotes.

As linhas \title, \author e \date apenas guardam metadados. Nada é impresso até que \maketitle seja executado no corpo, e é por isso que elas podem ficar no preâmbulo.

Regras práticas

Alguns hábitos mantêm os preâmbulos saudáveis. Carregue um pacote por tarefa e resista a empilhar pacotes que disputam o mesmo território, como duas maneiras de definir as margens. Mantenha o hyperref no fim, com as poucas exceções documentadas, como o cleveref, que precisam vir depois dele. Coloque as escolhas que valem para o documento todo nas opções da classe em vez de espalhá-las, para que 11pt ou twocolumn sejam declarados uma única vez, onde qualquer pessoa possa ver. E quando as suas macros personalizadas passarem de algumas linhas, mova-as para um arquivo .sty, para que vários documentos possam compartilhar um único conjunto de definições.

A disciplina mais útil é negativa: se você não sabe por que uma linha do preâmbulo está ali, descubra antes que o seu documento passe a depender dela. Preâmbulos copiados acumulam linhas mortas, e as linhas mortas são o esconderijo dos conflitos entre pacotes. Veja também o esqueleto do documento e os motores comparados.

Verificação sobre o preâmbuloQuestionário de prática opcional5 perguntas

Uma verificação rápida do que esta lição aborda. As respostas erradas mostram a certa. As opções são embaralhadas a cada tentativa. Você pode tentar de novo quantas vezes quiser.

Voltar para Abra o ciclo