Sito statico basato sul generatore Hugo. URL: https://albopop.it.
Questo repository contiene i sorgenti del sito e include il repository del tema come submodule nella cartella themes/albopop.
Attenzione! Devi aver installata la versione extended di Hugo con il supporto per Hugo Pipes.
Clona il repository in locale: git clone --recursive git@github.com:ondata/albopopTwoDotZero.git (solo la prima volta).
Entra nella cartella di progetto: cd albopopTwoDotZero/ (verifica di essere sulla branch develop con git branch).
Lancia il server di sviluppo: hugo server -D.
Apri la versione live del sito all'indirizzo http://localhost:1313/ (verifica l'indirizzo esatto nei log in console), la pagina si ricarica per ogni modifica dei file sorgente.
Una volta finito di lavorare, chiudi il server di sviluppo e genera i file statici del sito (nella cartella public/) con il comando hugo.
Salva le tue modifiche al progetto con (questo non è più necessario, perché viene fatto automaticamente, sul sito pubblico, dopo l'approvazione della pull request).git add . e git commit -m '[descrizione modifiche]' (assicurati di committare anche i file della cartella public/)
Pubblica le tue modifiche sul repository condiviso con git push (direttamente la branch develop oppure una tua branch derivata da questa).
Segnala il tuo lavoro in una issue corrispondente.
Tutti i contenuti del sito sono nella cartella content/ sotto forma di file .md (formato markdown).
Quelli presenti direttamente in content/ rappresentano le pagine del sito, quelli all'interno di sottocartelle
rappresentano i post (in particolare sono previsti post del blog, comune, altrepa).
I file _index.md rappresentano le pagine di elenco dei post corrispondenti.
L'output HTML delle pagine è definito da file di template nella cartella layouts/, che a loro volta sostituiscono o si aggiungono
ai file predefiniti del tema attivo (cartella themes/albopop/).
I fogli di stile si trovano nella cartella assets/sass/, l'entry point è il file main.scss che definisce le principali variabili
e include tutti gli altri fogli di stile. I valori di alcune variabili fondamentali (es. i colori di base) sono definiti a loro volta
nella configurazione del sito (il file config.toml presente nella cartella principale di progetto).
È compito di Hugo compilare opportunamente i file scss in un regolare file css concatenato e minificato:
a ogni modifica nel caso del server di sviluppo, staticamente quando si compila il tutto nella cartella public/.
Per aggiornare la versione pubblica (sulla branch gh-pages): git subtree push --prefix public/ origin gh-pages.
Se la cartella del tema themes/albopop risulta assente o vuota, assicurati di essere sulla branch develop (con git checkout develop),
di avere il repository locale aggiornato (con git pull) ed esegui git submodule update --init --recursive.