1  Iniziare un nuovo progetto

Questo capitolo è una breve guida a come creare da zero un nuovo testo interattivo da ospitare su Codeberg utilizzando quarto.

1.1 Creazione del repositorio

Quanto crei un nuovo repositorio nel tuo spazio utente di Codeberg, hai la scelta di partire da un template: seleziona taleae/quarto_template, spuntando Git content (default branch) tra i Template items.

A questo punto puoi clonare il repositorio localmente ed iniziare a lavorare nella tua working copy, e.g., per questa guida

git clone ssh://git@codeberg.org/taleae/quarto_guide.git
cd quarto_guide
git status

(Ovviamente devi modificare opportunamente l’url in modo da puntare al tuo nuovo repositorio appena creato.)

Il repositorio dovrebbe già essere completamente funzionale, e puoi visualizzare un’anteprima sul tuo browser facendo semplicemente

quarto preview

oppure utilizzando l’apposito target del Makefile

quarto preview

Nota

Va da sé: è necessario avere quarto installato sul tuo computer. Puoi partire da qui.

1.2 Modifiche iniziali

Il template su Codeberg è costruito in modo da minimizzare il numero di cambiamenti necessari per cominciare a lavorare sul materiale, ma non fa magie. (Non ancora, per lo meno.)

Ci sono alcune modifiche da fare prima di cominciare, ed in particolare:

• nel file _quarto.yml: devi aggiornare opportunamente i campi ${TITLE}, ${SUBTITLE} e ${AUTHORS}—quest’ultimo due volte;
• nel file chapters/cc-by-sa-it.qmd (o chapters/cc-by-sa-en.qmd, a seconda della lingua) devi aggiornare il campo ${AUTHORS}.

1.2.1 Scelta della lingua

Se il progetto è in italiano non c’è molto altro da fare, a parte rimuovere dal repositorio il file di licenza in inglese (che in questa configurazione non è usato) se proprio tieni all’economia concettuale.

Se, viceversa, il progetto è in inglese, allora devi modificare ulteriormente il file _quarto.yml, cambiando in en tutte le istanze di it. Dovrebbe essere semplice. (Ovviamente dovrai tradurre anche il poco testo già presente dall’italiano all’inglese.)

1.2.2 Scelta della licenza

Se la licenza di default (CC BY-SA 4.0) va bene non devi fare niente.

In caso contrario dovrai modificare opportunamente il file LICENSE e creare un nuovo file .qmd per rimpiazzare il vecchio chapters/cc-by-sa-it.qmd. (Il riferimento al vecchio file in _quarto.yml andrà modificato opportunamente.)

1.3 C’è altro?

Non direi. Siamo pronti per cominciare a scrivere il materiale.