Guida Git e MkDocs

Guida pratica per lavorare su Linux con Git e MkDocs Material: cosa installare, come preparare l'ambiente e quali comandi usare ogni giorno.

Come usare questa guida

Ogni pagina indica all'inizio dove eseguire i comandi, perché la cartella sbagliata è la causa più frequente di errori.

Dove sei

Gli esempi usano la cartella ~/progetti/mio-sito come radice del progetto, cioè quella che contiene mkdocs.yml.

Percorso consigliato

1. Prerequisiti: cosa installare.
2. Ambiente virtuale: isolare le dipendenze.
3. Installazione di MkDocs: primo avvio del sito.
4. Concetti di Git e comandi base.
5. Flusso di lavoro quotidiano.
6. Pubblicazione su Cloudflare Pages.

Hai fretta?

Vai alla cheatsheet o ai problemi comuni.