8  Projetos

Um livro da casa é uma pasta com uma organização fixa. A regularidade tem um propósito: quem abre qualquer livro sabe onde está cada coisa, e os scripts, o workflow e o modelo de projeto (Capítulo 21) contam com ela.

8.1 Árvore de pastas

livro/
├── _quarto.yml              # configuração e sumário
├── _language-pt.yml         # strings da interface em português
├── index.qmd                # prefácio (primeira página)
├── creditos.qmd             # autor, licença, como citar
├── references.qmd           # lista de referências
├── theme-editorial.scss     # tema (paleta, tipografia)
├── styles.css               # @font-face e ajustes finos
├── capitulos/parte-N-nome/  # capítulos, um diretório por parte
├── atividades/              # atividades em sala de aula (se houver)
├── apendices/               # material de consulta
├── references/              # references.bib + csl_styles/
├── fonts/                   # fontes .woff2 self-hosted
├── images/                  # capa.html, capa.jpg, favicon.png, figuras
├── code/                    # validadores e utilitários
├── .github/workflows/       # publish.yml
└── apple-touch-icon.png     # ícone para iOS

Ao renderizar, o Quarto cria _book/ (o site pronto), .quarto/ (cache interno) e, se houver código, _freeze/. Nenhuma das três entra no Git.

8.2 O arquivo _quarto.yml

É o centro do projeto. Está dividido em blocos, na ordem em que aparecem no arquivo:

Blocos do _quarto.yml

Bloco	O que define
project	tipo (book), pasta de saída, recursos extras a copiar
lang e language	idioma do documento e arquivo de strings da interface
book	metadados (título, autor, edição, descrição), capa, favicon, repositório, sumário, rodapé
bibliography, csl	bibliografia e estilo de citação
format	opções do HTML (tema, fontes, sumário local, numeração) e formatos comentados
execute	política de execução de código

Cada livro novo muda só os metadados, o sumário e as URLs; o resto é idêntico entre os livros e deve continuar assim.

8.3 O sumário

O bloco chapters: lista os arquivos na ordem do livro. Partes são objetos com part: e sua própria lista de chapters:. As páginas fora das partes (prefácio, contracapa, objetivos, créditos, referências) ficam soltas na lista:

book:
  chapters:
    - index.qmd
    - part: "Parte I — Fundamentos"
      chapters:
        - capitulos/parte-1-fundamentos/01-o-que-e-o-quarto.qmd
    - part: "Apêndices"
      chapters:
        - apendices/referencia-rapida.qmd
    - creditos.qmd
    - references.qmd

O Quarto também aceita uma chave appendices: separada; a casa prefere uma parte chamada “Apêndices” dentro de chapters:, para que os apêndices sigam a mesma numeração e navegação dos capítulos.

8.4 Numeração e nomes de arquivo

O prefixo numérico de cada arquivo (01-, 02-…) é o número do capítulo no livro, contado de forma contínua pelas partes. A numeração é uma conveniência para quem navega nas pastas: os links entre capítulos não dependem do nome do arquivo, e sim do identificador do heading (Capítulo 9). Ao inserir, fundir ou mover um capítulo, renumere os seguintes com git mv, para que o histórico acompanhe.

NotaPontos-chave

• A árvore de pastas é fixa e igual em todos os livros; scripts e workflow dependem dela.
• _quarto.yml concentra metadados, sumário, bibliografia e formato; entre livros mudam só metadados, sumário e URLs.
• Partes são grupos de capítulos no sumário; os apêndices são uma parte como as outras.
• O prefixo numérico do arquivo é o número do capítulo; renumere com git mv.