11  Callouts e elementos

Os livros da casa usam poucos elementos além do texto corrido, e cada um tem função definida. Este capítulo mostra cada elemento em uso.

11.1 Callouts

Um callout é um bloco destacado com título. O Quarto tem cinco tipos, com títulos em português vindos de _language-pt.yml; a aparência é simple por padrão no livro (sem ícone grande nem fundo colorido).

::: {.callout-tip appearance="simple"}
## Na clínica

Texto do bloco.
:::
NotaNota (callout-note)

Usada nos Pontos-chave que fecham cada capítulo e em informações complementares.

DicaDica (callout-tip)

Usada no bloco Na clínica, que aplica o conteúdo já citado do capítulo, e em orientações práticas como as deste manual.

ImportanteImportante (callout-important)

Usada no Aviso ao docente das atividades e em ressalvas que o leitor não pode pular.

AtençãoAtenção (callout-warning)

Reservada a situações em que um procedimento pode dar errado (por exemplo, um script que sobrescreve um arquivo).

CuidadoCuidado (callout-caution)

Raramente usada; equivale a Atenção com tom mais forte.

O título vai como heading de nível 2 dentro do bloco. Sem título, o callout usa o nome do tipo.

11.2 Epígrafes

Uma epígrafe de capítulo é um bloco de citação logo após o título, com a atribuição na última linha e a citação bibliográfica quando a obra está no .bib. A contracapa (epigrafes.qmd) é uma página só de epígrafes: o bloco recebe a classe .epigrafes, e o styles.css centraliza os poemas em serifa itálica e esconde o título da página, que existe apenas para a barra lateral.

::: {.epigrafes}

> *Verso um.*\
> *Verso dois.*
>
> — Autor, *Obra* (ano)

:::

11.3 Abas

Blocos com abas (tabset) mostram alternativas do mesmo conteúdo, como os formatos de citação sugerida na página de créditos:

::: {.panel-tabset}

### ABNT
Texto.

### Vancouver
Texto.

:::

SILVA, Henrique Alvarenga da. Manual de Quarto: como escrever e publicar livros didáticos no padrão da casa. São João del-Rei: Edição do Autor, 2026.

Silva HA. Manual de Quarto: como escrever e publicar livros didáticos no padrão da casa. São João del-Rei (MG): Edição do Autor; 2026.

11.4 Conteúdo condicional

Um bloco pode aparecer só em um formato. A miniatura da capa na página de créditos, por exemplo, existe apenas no HTML:

::: {.content-visible when-format="html"}
![Capa](images/capa.jpg){.cover-credit-thumb}
:::

11.5 Atividades e apêndices

As atividades em sala de aula seguem uma estrutura fixa: objetivos, materiais, roteiro passo a passo, perguntas para discussão e uma seção final Ligação com o livro, com a lista dos capítulos relacionados em referência cruzada. Os apêndices são material de consulta rápida (quadros-síntese, linhas do tempo, glossários) e remetem aos capítulos em vez de repeti-los.

NotaPontos-chave
  • Cinco tipos de callout, cada um com uso definido; título como heading de nível 2 dentro do bloco.
  • Epígrafes são blocos de citação; a contracapa usa a classe .epigrafes.
  • Abas mostram alternativas do mesmo conteúdo; blocos condicionais restringem conteúdo a um formato.
  • Atividades terminam com “Ligação com o livro”; apêndices remetem aos capítulos.