A estrutura do documento: introdução

Resumo

Esta aula abre a terceira unidade do curso, dedicada à estrutura do documento. Explica para que serve a unidade: passar do texto bem composto da unidade anterior a um documento longo com arquitetura própria, cujas partes se numeram, se listam em um sumário, remetem umas às outras e se distribuem em vários arquivos; apresenta suas cinco aulas e o fio que as une, desde a classe do documento e a página até o preâmbulo próprio; precisa o que se dá por sabido das unidades anteriores; recorda de onde procedem as formas dos documentos acadêmicos; formula o problema que a unidade resolve, o de que um documento cujas remissões e números se escrevem à mão começa a mentir assim que muda; e mostra que essa arquitetura serve tanto a uma tese de física quanto a uma de história.

Objetivos de aprendizagem

Descrever a sequência de conteúdos da unidade e explicar o que cada aula traz à seguinte.
Reconhecer o que a unidade dá por sabido das anteriores e revisá-lo se for preciso.
Explicar, com um exemplo, por que as remissões internas não se escrevem à mão.
Reconhecer nos gêneros acadêmicos de diferentes disciplinas a estrutura que a unidade ensina a compor.

Avaliação de entrada

Antes de percorrer a unidade, convém medir o ponto de partida. Esta avaliação é uma autoavaliação: não recebe nota, e seu único propósito é orientar o estudo. Suas duas primeiras perguntas revisam o que a unidade dá por sabido das anteriores; as dez seguintes tratam, de duas em duas e em ordem, das cinco aulas da unidade. Quem nunca compôs um documento longo não deve esperar acertá-las: cada resposta, certa ou não, explica o ponto e nomeia a aula que o trata. As mesmas habilidades voltam a ser medidas no final, na aula de síntese.

Avaliação de entrada

Antes de começar a unidade, meça seu ponto de partida. É uma autoavaliação breve: não recebe nota e seu resultado fica guardado apenas no seu navegador.

Pergunta 1De unidades anterioresDepois da primeira compilação de um documento, uma remissão feita com \ref aparece como dois pontos de interrogação, e o registro pede para compilar outra vez. O que está acontecendo?
Na primeira passagem o motor anotou os números no arquivo auxiliar, mas só pode usá-los na passagem seguinte; basta compilar outra vez, ou compilar com o latexmk.
O rótulo está mal escrito, e é preciso corrigi-lo.
Falta um pacote para as referências.
O arquivo auxiliar está danificado e é preciso apagá-lo.
Pergunta 2De unidades anterioresUm ensaio marca os títulos de obras com \obra{…}, definida no preâmbulo como \newcommand{\obra}[1]{\emph{#1}}, em vez de escrever \textit{…} em cada lugar. O que ganha?
Que o aspecto de todos os títulos se muda em uma só linha, sem tocar outros itálicos que cumprem outras funções.
Nada, porque o resultado é o mesmo.
Que a compilação fica mais rápida.
Que os títulos entram sozinhos no sumário.
Pergunta 3Um estudante escreve sua tese com \documentclass{article} e divide o texto com \chapter{…}. O que acontece ao compilar?
O motor produz o erro “Undefined control sequence”, porque a classe article não tem capítulos.
Os capítulos são compostos como seções.
Os capítulos são compostos corretamente, porque todas as classes têm as mesmas divisões.
São ignorados sem aviso.
Pergunta 4Uma universidade exige margens de 2,5 centímetros em papel A4. Qual é a maneira adequada de fixá-las?
Com o pacote geometry, por exemplo \usepackage[a4paper, margin=2.5cm]{geometry} no preâmbulo.
Com a opção a4paper da classe, que fixa as margens.
Com \hspace no começo de cada linha.
Reduzindo o tamanho da letra com \small.
Pergunta 5Em um documento de classe article, escreve-se \setcounter{tocdepth}{1} antes de \tableofcontents. O que mostra o sumário?
Somente as seções, sem as subseções.
Somente as subseções.
Nada, porque o sumário fica vazio.
Todas as divisões, mas sem números.
Pergunta 6Em um documento de classe article, depois do comando \appendix, escrevem-se dois \section. Como são numerados?
Com letras: A e B.
Seguem a numeração anterior, como seções comuns.
Sem número, como as seções com asterisco.
Com números romanos: I e II.
Pergunta 7Um autor escreve \label{sec:metodos} na linha anterior a \section{Métodos}, que é a seção 2. Que número imprime \ref{sec:metodos}?
O da divisão anterior, 1, porque o rótulo toma o último número atribuído antes dele.
O 2, porque o rótulo está junto da seção.
Dois pontos de interrogação, em todas as compilações.
Um erro, porque o rótulo deve ir dentro do título.
Pergunta 8O que muda em um documento ao carregar o pacote hyperref?
As remissões, as entradas do sumário e as chamadas das notas se convertem em links do PDF, e o PDF recebe marcadores.
Os números das seções e das páginas.
As remissões deixam de precisar de duas passagens.
O idioma dos nomes como “Sumário” ou “Figura”.
Pergunta 9No documento principal de uma tese, o que distingue \include{capitulo1} de \input{capitulo1}?
\include começa o conteúdo em uma página nova e permite compilar só alguns capítulos com \includeonly; \input insere o arquivo tal como está, no ponto em que é escrito.
Nada: são sinônimos.
\input só admite arquivos do preâmbulo.
\include copia o arquivo dentro do principal ao salvar.
Pergunta 10O preâmbulo de uma tese contém \includeonly{capitulo3}, e o corpo inclui os cinco capítulos com \include. O que produz a compilação, se a tese já tinha sido compilada inteira antes?
Um PDF só com o capítulo 3, que conserva seus números de página, de capítulo e de remissão, tomados dos auxiliares dos demais.
Um PDF com os cinco capítulos, porque \includeonly só afeta o sumário.
Um PDF só com o capítulo 3, numerado como capítulo 1 e a partir da página 1.
Um erro, porque faltam os demais capítulos.
Pergunta 11Um preâmbulo contém \newcommand{\emph}[1]{\textbf{#1}}. O que acontece?
O motor produz o erro “Command \emph already defined”: \newcommand não redefine comandos existentes, e para isso existe \renewcommand.
Todas as ênfases passam a negrito.
Cria-se um segundo comando \emph, que convive com o original.
Nada, porque o preâmbulo não compõe texto.
Pergunta 12Com \newcommand{\grandeza}[2]{#1~#2} no preâmbulo, o que imprime \grandeza{5}{km}?
“5 km”, com um espaço em que a linha não pode ser quebrada.
“km 5”.
“5~km”, com o til impresso.
Um erro, porque um comando só admite um argumento.