17 Idioma e local
O Quarto traz traduções internas para várias línguas, o português do Brasil entre elas. Três opções de _quarto.yml deixam o livro inteiro em português: lang, language e date-format.
17.1 lang
lang: pt-BR marca o idioma do documento. O efeito vai além da interface: o Pandoc usa o idioma para a hifenização, o Citeproc para os conectivos das citações (“e”, “et al.”), e os navegadores e leitores de tela para a pronúncia.
17.2 language
language: _language-pt.yml aponta para um arquivo com as strings da interface que a casa redefine: títulos de seção (“Referências”, “Notas de rodapé”), rótulos do sumário (“Nesta página”), títulos dos callouts (“Nota”, “Dica”, “Atenção”, “Importante”, “Cuidado”), prefixos das referências cruzadas (“Capítulo”, “Figura”, “Tabela”), textos da busca e dos botões de código. O arquivo é um overlay: só as chaves listadas são substituídas, e o resto vem do português interno do Quarto.
crossref-ch-prefix: "Capítulo"
crossref-fig-title: "Figura"
callout-note-title: "Nota"
toc-title-website: "Nesta página"O arquivo é o mesmo em todos os livros e faz parte do conjunto sincronizado pelo modelo.
17.3 Datas
date: today com date-format: "MMMM [de] YYYY" produz “setembro de 2026” no bloco de título. Os colchetes protegem a preposição para que não seja interpretada como código de formato.
17.4 O que ainda fica em inglês
Alguns textos vêm de bibliotecas externas e não passam pelo _language-pt.yml: os rótulos internos dos diagramas Mermaid e mensagens de erro do Quarto no terminal. Nenhum deles chega ao leitor.
lang: pt-BRafeta hifenização, citações e acessibilidade._language-pt.ymlredefine só as strings listadas; o resto vem do Quarto.date-formatcom colchetes produz a data por extenso em português.