3  Composizione

La guida di quarto è il posto giusto da cui partire per tutte le informazioni sulle funzionalità offerte dal sistema e sulla sintassi di markup.

Il flusso di lavoro tipico consiste nell’aggiungere via via i file dei nuovi capitoli nella cartella chapters, aggiornare l’indice nel file _quarto.yml e dare libero sfogo alla propria creatività.

Il Makefile del repositorio dovrebbe illustrate in modo auto-esplicativo le operazioni di base rilevanti per il lavoro giornaliero:

• preview: anteprima dell’html statico nel proprio browser;
• render: compilazione completa di html e pdf;
• clean: rimozione degli artefatti;
• publish: rilascio su Codeberg Pages.

Più precisamente:

preview:
    quarto preview

render:
    quarto render

clean:
    rm -rf _book .quarto

publish: render
    ghp-import -o -f -p -b pages _book