Il nostro sito

Guida facile e veloce al sito di CartaBinaria

Il sito statico per CartaBinaria che stai visionando al momento. Due istanze pubbliche sono disponibili:

L’aggiornamento della prima avviene tramite Ansible, mentre quello della seconda avviene in automatico a ogni modifica di main.

Come fare il deploy localmente?

hugo server

Se qualcosa non va esegui

hugo --gc --minify

Aggiungere nuovi progetti nella home

Per aggiungere nuovi progetti nella home, basta creare un nuovo file markdown nella cartella content/it/project/ con il comando qui sotto.

hugo new project/nome-del-progetto/index.md

Il nome che darete al progetto verrà usato automaticamente come link alla corrispondente repository GitHub.

Se non è corretto, potete modificarlo manualmente nel file markdown.

Ricorda di assegnare i tag corretti tra quelli proposti

Aggiungere immagine di copertina

È possibile inserire un’immagine di copertina per un contenuto, basta inserire un’immagine nella cartella del contenuto della wiki rinominata in featured.png o featured.jpg


Aggiungere nuovi contenuti alla wiki

Per aggiungere nuovi contenuti alla wiki, basta creare un nuovo file markdown nella cartella content/it/wiki/ con il comando qui sotto. Questo ti genererà un file con un header già pronto per essere compilato.

hugo new wiki/nome-del-contenuto/index.md

Per aggiungere la versione inglese basta fare:

hugo new ./content/en/wiki/nome-del-contenuto/index.md

Nota ricordate di impostare bene le categorie, autori e tags per i nuovi contenuti, in modo da poterli trovare e classificare facilmente.

Aggiungere immagine di copertina

È possibile inserire un’immagine di copertina per un contenuto, basta inserire un’immagine nella cartella del contenuto della wiki rinominata in featured.png o featured.jpg

Puoi configurare evenutali altre impostazioni di visualizzazione nell’header del file index.md alle righe 17-25.

Ordinamento dei contenuti

Sono automaticamente ordinati per data di creazione, ad eccezione del contenuto “Contribuire” che è sempre il primo. Se vuoi dare un ordine diverso ai contenuti, puoi impostare il parametro weight nell’header del file index.md del contenuto.

Associare un progetto ad un contenuto

Attraverso l’impostazione projects: [] [riga 7], puoi associare un progetto della home al contenuto della wiki inserendo al posto delle parentesi il nome della cartella del progetto a cui ti vuoi riferire.

Modifica questa pagina