10  Figuras e tabelas

Figuras e tabelas ganham número, legenda e podem ser citadas em qualquer lugar do livro. O Quarto cuida da numeração e dos links; o autor cuida do identificador e da legenda.

10.1 Figuras

![A estrutura do projeto](images/fig-estrutura.svg){#fig-estrutura fig-alt="Diagrama em árvore das pastas do projeto"}

Três regras da casa:

  • O identificador começa com fig-.
  • Toda figura tem fig-alt, o texto alternativo lido por leitores de tela. Ele descreve a imagem; a legenda a interpreta.
  • images/ não recebe material de terceiros com direitos autorais. Figuras são originais, de domínio público ou sob licença compatível, e o crédito vai na página de créditos ou no ponto de uso.

A legenda fica abaixo da figura (fig-cap-location: bottom).

10.2 Tabelas

A legenda das tabelas fica acima (tbl-cap-location: top). A classe .striped alterna o fundo das linhas e tbl-colwidths fixa a largura das colunas em porcentagem, o que evita que o texto quebre de forma imprevisível:

| Elemento | Prefixo | Exemplo |
|---|---|---|
| Seção ou capítulo | `sec-` | `@sec-sintaxe` |

: Prefixos de referência cruzada {#tbl-prefixos .striped tbl-colwidths="[40,20,40]"}

O resultado é a Tabela 10.1.

Tabela 10.1: Prefixos de referência cruzada
Elemento Prefixo Exemplo de uso
Seção ou capítulo sec- @sec-sintaxe
Figura fig- @fig-fluxo
Tabela tbl- @tbl-prefixos
Equação eq- @eq-nome
Listagem de código lst- @lst-nome

10.3 Referências cruzadas

A referência cruzada é a arroba seguida do identificador, no meio da frase. O Quarto substitui pelo prefixo em português e o número: “Figura 1”, “Tabela 6.1”, “Capítulo 5”. Os prefixos vêm de _language-pt.yml (Capítulo 17). Como o prefixo do identificador é o que distingue uma referência cruzada de uma citação bibliográfica, os validadores da casa ignoram sec-, fig-, tbl- e afins ao procurar chaves de citação.

10.4 Diagramas Mermaid

Diagramas descritos em texto dispensam imagem e ficam sob controle de versão como o resto do capítulo. Um bloco de código com a linguagem mermaid é renderizado no HTML; a Figura 10.1 mostra o fluxo de publicação da casa.

flowchart LR
  A[Escrever .qmd] --> B[Validar .bib]
  B --> C[quarto render]
  C --> D[GitHub Pages]
Figura 10.1: Fluxo de publicação de um livro da casa.

O tema dos diagramas é neutral, definido em _quarto.yml, para combinar com a paleta do livro. Um diagrama de referência deve existir uma única vez no livro; outros capítulos apontam para ele com a referência cruzada, em vez de duplicá-lo.

10.5 Equações

Fórmulas usam a notação do LaTeX entre cifrões: $E = mc^2$ no meio da frase, ou entre $$ para equação destacada. Os livros da casa raramente precisam delas.

NotaPontos-chave
  • Figuras e tabelas têm identificador com prefixo (fig-, tbl-) e legenda; o Quarto numera e cria os links.
  • Toda figura tem fig-alt; nenhuma figura de terceiros com direitos autorais entra em images/.
  • A referência cruzada renderiza o prefixo em português e o número atualizado.
  • Diagramas são Mermaid, versionados como texto, e cada diagrama de referência existe uma vez só.