9  Livros e teses

Este capítulo descreve a anatomia de um capítulo da casa: como começa, como termina e como se liga aos outros.

9.1 O título com identificador

O título do capítulo é a primeira linha do arquivo, como heading de nível 1 com um identificador:

# As fases da memória {#sec-fases-da-memoria}

O identificador começa com sec- e usa apenas letras minúsculas sem acento, números e hífens. É ele que os outros capítulos usam para apontar para este, e é o motivo de o título ir no heading e não no campo title: do YAML: o Quarto só aceita identificador em heading. Esse identificador é permanente; o número do capítulo, não.

9.2 Páginas sem número

Prefácio, contracapa, objetivos, créditos e referências não são capítulos numerados. Recebem number-sections: false no cabeçalho YAML e a classe .unnumbered no título:

---
number-sections: false
---

# Prefácio {.unnumbered}

9.3 Referências cruzadas entre capítulos

Toda menção a outro capítulo é um link, e o link nasce do conteúdo, não de um andaime (“o capítulo sobre X mostra que…”). Na prosa, o link vai embutido na frase natural:

os hormônios do estresse, [liberados pela excitação
emocional](#sec-memoria-e-emocao), modulam a consolidação

Entre parênteses, em tabelas e nas listas de “Ligação com o livro” das atividades, usa-se a referência cruzada do Quarto, que renderiza “Capítulo N” com o número atualizado a cada render:

(ver @sec-memoria-e-emocao)

Nunca escreva o número do capítulo à mão: ele muda a cada fusão ou reordenação. Se um identificador não existir, quarto render avisa com unresolved crossref.

9.4 O fecho do capítulo

Todo capítulo termina com um callout de Pontos-chave: três a cinco itens que só reformulam o que o capítulo disse, sem dado novo. Nos livros clínicos, quando o conteúdo já citado sustenta uma aplicação, um callout Na clínica vem antes dele, com a mesma regra: nada de afirmação sem fonte.

::: {.callout-note appearance="simple"}
## Pontos-chave

- Primeiro ponto.
- Segundo ponto.
:::

9.5 Comentários do autor

Os comentários AUTOR registram pendências, decisões e procedência do texto. Ficam no topo do arquivo (quando dizem respeito ao capítulo inteiro) ou logo abaixo do heading da seção a que se referem. São preservados de edição em edição; para registrar uma decisão nova, acrescenta-se outro comentário no mesmo formato, com a data. A ausência de comentário num texto rascunhado com IA significa “revisado pelo autor”, não “sem procedência”.

<!-- AUTOR (2ª ed., 06/09/2026): capítulo reescrito com foco na mensagem. -->

9.6 Texto congelado

Quando um livro tem edição anterior, os capítulos reproduzidos sem alteração levam um comentário que os identifica (“texto reproduzido SEM alterações da 1ª edição”) e não são editados sem pedido explícito do autor. Seções novas acrescentadas ao final vêm precedidas de um comentário que as marca como editáveis.

NotaPontos-chave
  • O título do capítulo é um heading com identificador sec-; o identificador é permanente, o número não.
  • Menções a outros capítulos são links embutidos na frase ou referências cruzadas, nunca números escritos à mão.
  • Todo capítulo termina com Pontos-chave; Na clínica vem antes, quando cabe.
  • Comentários AUTOR registram decisões e pendências e nunca são apagados por terceiros.