18  Render e preview

Dois comandos cobrem o dia a dia: quarto preview, enquanto se escreve, e quarto render, para gerar o livro completo.

18.1 Preview

quarto preview

Abre o livro no navegador e o atualiza a cada arquivo salvo. É o modo de trabalho normal: o texto de um lado, o resultado do outro. O preview renderiza só o capítulo que mudou, por isso é rápido; alterações em _quarto.yml ou no tema exigem reiniciar o comando.

18.2 Render

quarto render                # HTML completo em _book/
quarto render --to html
quarto render capitulos/parte-1-fundamentos/03-markdown.qmd   # um capítulo só

O render completo é o que o CI faz antes de publicar. Vale rodá-lo localmente antes de enviar alterações grandes: é ele que acusa referências cruzadas não resolvidas (unresolved crossref), citações sem entrada no .bib (citeproc: reference not found) e erros de YAML.

18.3 O que sai e o que não entra no Git

O render produz _book/ (o site) e .quarto/ (cache); projetos com código produzem também _freeze/. As três pastas estão no .gitignore. O site publicado não é o _book/ local: é o que o CI gera a partir do que está no repositório (Capítulo 20). Se o livro parece diferente no ar, a primeira pergunta é se a alteração foi enviada.

18.4 Congelamento

execute: freeze: auto faz o Quarto guardar os resultados de código executado e só reexecutar o que mudou. Os livros da casa não têm código executável, então a opção existe por segurança: se algum dia um capítulo tiver um gráfico em R ou Python, o CI não precisará do kernel. Os diagramas Mermaid não passam por esse mecanismo.

18.5 EPUB e PDF

Os formatos alternativos ficam comentados em _quarto.yml e podem ser gerados localmente quando houver necessidade:

quarto render --to epub
quarto render --to pdf      # exige LaTeX; ver quarto check

O PDF usa a classe scrbook em A5 e a bibliografia ABNT via BibLaTeX; a configuração comentada serve de ponto de partida, mas não é mantida no CI.

NotaPontos-chave
  • quarto preview para escrever; quarto render para verificar o livro inteiro antes de enviar.
  • O render acusa referências cruzadas e citações quebradas.
  • _book/, .quarto/ e _freeze/ não entram no Git; o site publicado vem do CI.
  • EPUB e PDF são opcionais e gerados localmente.