Saltar para o conteúdo
Topos Uranos
Português

Primeiros passos: síntese e desafios

Resumo

Esta aula encerra a primeira unidade do curso, dedicada aos primeiros passos com LaTeX. Reconstrói a cadeia de conceitos e procedimentos que vai da composição tipográfica à depuração de um documento, indicando em cada elo que princípio se usa e em que aula se estabelece; situa o que foi alcançado em relação ao plano do curso e precisa que questões, apenas tocadas, ficam para as unidades seguintes; repete em sua avaliação de saída as habilidades da avaliação de entrada; e termina com seis desafios, de dificuldade superior à dos problemas das aulas, que exigem combinar os instrumentos de várias delas para diagnosticar documentos que falham ou para planejar um a partir de uma descrição.

Objetivos de aprendizagem

  1. Reconstruir a ordem dos conceitos e procedimentos da unidade, identificando o princípio em que se apoia cada um.
  2. Explicar como se relacionam as regras de leitura do código-fonte, sua anatomia e as mensagens do log.
  3. Distinguir o que a unidade estabeleceu do que apenas antecipou e que as unidades seguintes desenvolverão.
  4. Diagnosticar documentos que falham por várias causas ao mesmo tempo, ordenando as correções segundo o log.
  5. Planejar o preâmbulo e o corpo de um documento a partir da descrição do que ele deve conter.

O que a unidade alcançou

A unidade se propôs levar quem nunca havia usado LaTeX ao ponto de escrever, compilar e corrigir por conta própria um documento breve. O propósito se cumpriu com uma única ressalva, declarada desde a introdução: deu-se por sabido o manejo de arquivos e pastas num computador. Com ela, o caminho percorrido pode ser lido como uma única cadeia em quatro trechos, na qual cada conceito ou procedimento se apoia nos anteriores.

O que é LaTeX

A aula O que é LaTeX partiu da composição tipográfica, o conjunto de decisões que dispõem cada letra, cada linha e cada página, e das exigências particulares dos textos acadêmicos. Delas deduziu a conveniência de uma linguagem de marcação, na qual o autor declara o que é cada coisa e a classe do documento decide como ela se vê: a separação entre conteúdo e forma, que reaparece em toda a unidade. Distinguiu depois os três motores e escolheu o LuaLaTeX, que lê Unicode e carrega as fontes do sistema; fixou as três regras com que o motor lê o código-fonte (os espaços repetidos valem um, uma linha em branco termina o parágrafo e o sinal de porcentagem inicia um comentário), e descreveu o ciclo de escrever, compilar e ler, com o log e o arquivo auxiliar que cada compilação deixa.

O ambiente de trabalho

A aula sobre o ambiente de trabalho converteu essa descrição numa instalação: uma distribuição, TeX Live, MiKTeX ou MacTeX, com seu gerenciador de pacotes; o Texmaker, configurado para compilar com LuaLaTeX, salvar em UTF-8 e sincronizar o código-fonte com o PDF; e o Overleaf, cujo compilador predeterminado é preciso trocar em cada projeto. Estabeleceu além disso a regra de uma pasta por projeto, a distinção entre o que o autor escreve e o que a compilação regenera, e as três causas pelas quais um PDF pode não mudar: um erro grave que impede escrevê-lo, um visualizador que o bloqueia ou não o recarrega, e a compilação de outro arquivo.

Anatomia de um documento

A aula sobre a anatomia de um documento explicou peça por peça o que o documento mínimo trazia como receita. O preâmbulo configura e o corpo compõe, porque ao chegar a \begin{document} a configuração se fecha. Os comandos se dividem em palavras de controle, cujo nome termina no primeiro caractere que não é letra e que consomem o espaço seguinte, e símbolos de controle, que não o consomem; recebem argumentos obrigatórios entre chaves e opcionais entre colchetes, e alguns têm uma forma com asterisco. As declarações valem até o final do grupo que as contém, e os ambientes, que são grupos, devem ser fechados na ordem inversa à de sua abertura. Os dez caracteres reservados fazem algo em vez de ser impressos, e cada um tem seu modo de ser impresso. Os pacotes e a classe, com suas opções, completam a estrutura.

Compilar e corrigir erros

A aula sobre a compilação e a correção de erros reuniu tudo o que veio antes. Explicou que o motor trabalha em passagens, de modo que as referências e o sumário se completam na passagem seguinte, e que o latexmk repete as passagens por conta própria; ensinou a ler um erro por sua linha de exclamação, seu número de linha e o corte que separa o que foi lido do que faltava ler; distinguiu os erros, que sempre se corrigem, das advertências e dos avisos de caixas; associou as mensagens mais frequentes a suas causas, que quase sempre são infrações da anatomia do código-fonte; e propôs uma estratégia: ler primeiro o primeiro erro, dividir o código-fonte ao meio, reduzir o problema a um exemplo mínimo, limpar os auxiliares e buscar a mensagem.

A figura seguinte reúne os quatro trechos numa única cadeia. Cada nó da coluna é um conceito ou um procedimento, numerado segundo a ordem em que uns se apoiam nos outros e unido por um arco aos elos anteriores que usa; ao redor flutuam os apoios, isto é, os princípios aos quais a cadeia recorre uma e outra vez, cada um unido por um traço firme aos elos que se apoiam nele e por um pontilhado ao elo onde se estabelece, exceto o que se admite sem estudá-lo, que se desenha como um anel. Ao clicar num apoio destacam-se todos os elos que o usam, e cada elo remete à aula em que é estudado.

Apoios da cadeia

  • AArquivos e pastas. O manejo corrente de arquivos e pastas num computador: criá-los, nomeá-los, encontrá-los, copiá-los e distingui-los por sua extensão. Dá-se por sabido desde a introdução. Admitido sem demonstração nesta unidade.
  • BConteúdo e forma. O autor declara o que é cada coisa, e a classe do documento e o preâmbulo decidem como ela se vê. Estabelecido em: 2. Linguagem de marcação.
  • CUnicode e fontes. O LuaLaTeX lê o código-fonte em Unicode, salvo em UTF-8, e carrega as fontes do sistema; um caractere que a fonte não contém não detém a compilação, mas falta no PDF. Estabelecido em: 3. Motores e LuaLaTeX.
  • DO log. Cada compilação anota no arquivo de log o que fez, com seus erros e advertências; é a primeira coisa que se lê quando algo falha. Estabelecido em: 5. Código-fonte, compilação e PDF.
  • EGrupos e alcance. Uma declaração vale até o final do grupo que a contém; as chaves e os ambientes abrem grupos que devem ser fechados na ordem inversa à de sua abertura. Estabelecido em: 12. Grupos e ambientes.
  • FCaracteres reservados. Dez caracteres fazem algo em vez de ser impressos; escritos tal como estão no texto, produzem um erro ou um efeito despercebido. Estabelecido em: 13. Caracteres reservados.
  • GO primeiro erro. Para se recuperar de um erro o motor adivinha, e suas adivinhações podem produzir erros novos; só o primeiro corresponde com certeza ao código-fonte. Estabelecido em: 16. Leitura de um erro.

  1. Trecho 1 O que é LaTeX

    • Explicar o que é a composição tipográfica e por que os textos acadêmicos a exigem.
    • Separar o conteúdo da forma mediante uma linguagem de marcação.
    • Escolher o motor segundo os idiomas, as escritas e as fontes, e justificar o LuaLaTeX.
    • Prever o que produz um código-fonte segundo as regras dos espaços, dos parágrafos e dos comentários.

    1. Composição tipográfica. Compor é decidir onde cai cada letra, onde termina cada linha e onde se corta cada página; os textos acadêmicos, com fórmulas, remissões, notas e vários idiomas, o exigem em maior grau.

      Demonstrado em: O que é o LaTeX.

    2. Linguagem de marcação. No LaTeX, um conjunto de macros escrito sobre o TeX, o autor marca o conteúdo num arquivo de texto puro, e a forma deriva da classe e do preâmbulo.

      Usa: 1. Composição tipográfica. Demonstrado em: O que é o LaTeX.

    3. Motores e LuaLaTeX. pdfLaTeX, XeLaTeX e LuaLaTeX entendem o mesmo LaTeX, mas só os dois últimos leem Unicode e carregam as fontes do sistema; o curso usa o LuaLaTeX.

      Usa: 2. Linguagem de marcação. Demonstrado em: O que é o LaTeX.

    4. Espaços, parágrafos e comentários. Vários espaços valem um e uma quebra de linha vale um espaço; uma linha em branco termina o parágrafo; o sinal de porcentagem converte em comentário o resto da linha, com sua quebra.

      Usa: 2. Linguagem de marcação. Demonstrado em: O que é o LaTeX.

    5. Código-fonte, compilação e PDF. Escreve-se o código-fonte, o motor o compila e lê-se o PDF; junto a ele ficam o log e o arquivo auxiliar.

      Usa: 3. Motores e LuaLaTeX. Apoia-se em: A (Arquivos e pastas). Demonstrado em: O que é o LaTeX.

  2. Trecho 2 O ambiente de trabalho

    • Escolher uma distribuição e um tipo de instalação segundo o sistema, o espaço e a conexão.
    • Configurar o Texmaker e o Overleaf para compilar com LuaLaTeX.
    • Organizar cada projeto em sua pasta e decidir que arquivos se conservam.
    • Explicar por que um PDF pode não mudar depois de uma correção.

    1. Distribuição e pacotes. Uma distribuição reúne os motores, os pacotes, as fontes e um gerenciador que instala o que falta: TeX Live, MiKTeX ou MacTeX, completa ou básica.

      Usa: 3. Motores e LuaLaTeX. Apoia-se em: A (Arquivos e pastas). Demonstrado em: O ambiente de trabalho.

    2. Texmaker e Overleaf. O Texmaker é configurado para compilar com LuaLaTeX, salvar em UTF-8 e sincronizar o código-fonte com o PDF; no Overleaf escolhe-se o LuaLaTeX em cada projeto.

      Usa: 5. Código-fonte, compilação e PDF, 6. Distribuição e pacotes. Apoia-se em: C (Unicode e fontes). Demonstrado em: O ambiente de trabalho.

    3. Pasta e auxiliares. Cada documento tem sua pasta; o que o autor escreveu ou forneceu se conserva, e os auxiliares, que a compilação regenera, podem ser apagados.

      Usa: 5. Código-fonte, compilação e PDF, 7. Texmaker e Overleaf. Apoia-se em: A (Arquivos e pastas). Demonstrado em: O ambiente de trabalho.

    4. O PDF que não muda. Se o PDF não muda, ou a compilação não o escreveu, ou o visualizador o bloqueia ou não o recarrega, ou se compilou outro arquivo; o log e a hora do PDF decidem.

      Usa: 8. Pasta e auxiliares, 7. Texmaker e Overleaf. Apoia-se em: D (O log). Demonstrado em: O ambiente de trabalho.

  3. Trecho 3 Anatomia de um documento

    • Distinguir o preâmbulo do corpo e decidir onde vai cada comando.
    • Reconhecer as partes de um comando e prever onde termina seu nome.
    • Prever o alcance das declarações e aninhar corretamente os ambientes.
    • Imprimir os dez caracteres reservados e explicar o que fazem sem proteção.

    1. Preâmbulo e corpo. O preâmbulo carrega pacotes e toma decisões sem compor nada; o corpo é o único lugar onde se compõe; o que só define ou guarda pode ir em ambos, e convém no preâmbulo.

      Usa: 5. Código-fonte, compilação e PDF. Apoia-se em: B (Conteúdo e forma). Demonstrado em: Anatomia de um documento.

    2. Comandos. Uma palavra de controle termina no primeiro caractere que não é letra e consome o espaço seguinte; um símbolo de controle tem um só caractere e não o consome; os argumentos vão entre chaves ou entre colchetes.

      Usa: 4. Espaços, parágrafos e comentários. Demonstrado em: Anatomia de um documento.

    3. Grupos e ambientes. Uma declaração vale até o final de seu grupo; os ambientes são grupos, e um aberto dentro de outro se fecha antes dele.

      Usa: 11. Comandos. Apoia-se em: B (Conteúdo e forma). Demonstrado em: Anatomia de um documento.

    4. Caracteres reservados. A barra invertida, as chaves, a porcentagem, o cifrão, o e comercial, a cerquilha, o sublinhado, o circunflexo e o til fazem algo em vez de ser impressos, e cada um se imprime de um modo próprio.

      Usa: 11. Comandos, 4. Espaços, parágrafos e comentários. Demonstrado em: Anatomia de um documento.

    5. Pacotes e classe. Os pacotes ampliam o que o LaTeX sabe fazer e são carregados só no preâmbulo; a classe, com suas opções, fixa a forma geral do documento.

      Usa: 10. Preâmbulo e corpo, 6. Distribuição e pacotes. Apoia-se em: B (Conteúdo e forma). Demonstrado em: Anatomia de um documento.

  4. Trecho 4 Compilar e corrigir erros

    • Explicar por que as referências e o sumário precisam de outra passagem, e compilar com o latexmk.
    • Ler um erro do log: sua mensagem, sua linha e o ponto da detecção.
    • Relacionar os erros mais frequentes com suas causas prováveis.
    • Localizar a causa real de um erro com uma estratégia ordenada, e decidir que advertências atender.

    1. Passagens e latexmk. Em cada passagem o motor anota nos auxiliares números e títulos que a passagem seguinte usa; o latexmk repete as passagens até que nada mude.

      Usa: 8. Pasta e auxiliares. Apoia-se em: D (O log). Demonstrado em: Compilar e corrigir erros.

    2. Leitura de um erro. Um erro se reconhece por sua linha de exclamação; a linha que começa com l. dá o número da linha do código-fonte, partida entre o que foi lido e o que faltava ler.

      Usa: 9. O PDF que não muda, 11. Comandos. Apoia-se em: D (O log). Demonstrado em: Compilar e corrigir erros.

    3. Erros frequentes. Comandos ou ambientes não definidos, fórmulas não abertas, chaves que não se correspondem, arquivos que faltam e texto no preâmbulo: cada mensagem delata a infração de uma regra da anatomia do código-fonte.

      Usa: 16. Leitura de um erro, 10. Preâmbulo e corpo, 12. Grupos e ambientes, 13. Caracteres reservados, 14. Pacotes e classe. Apoia-se em: E (Grupos e alcance), F (Caracteres reservados). Demonstrado em: Compilar e corrigir erros.

    4. Estratégia de depuração. Ler o primeiro erro, dividir o corpo ao meio sem cortar grupos nem ambientes, reduzir a um exemplo mínimo, limpar os auxiliares e buscar a mensagem.

      Usa: 17. Erros frequentes, 4. Espaços, parágrafos e comentários, 8. Pasta e auxiliares. Apoia-se em: D (O log), E (Grupos e alcance), G (O primeiro erro). Demonstrado em: Compilar e corrigir erros.

    5. Advertências. As advertências não detêm a compilação, mas algumas exigem agir: referências indefinidas, pedidos de compilar outra vez, linhas que transbordam e caracteres que faltam.

      Usa: 15. Passagens e latexmk, 16. Leitura de um erro. Apoia-se em: C (Unicode e fontes), D (O log). Demonstrado em: Compilar e corrigir erros.

Rumo ao texto. A cadeia se detém onde o documento mínimo já não basta: o próprio texto, com seus idiomas, escritas, notas e citações, é o objeto da unidade seguinte.