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.