Come usare questo tema

Avvio rapido: come si installa 📥

1. Installate hugo extended, seguendo la guida ufficiale all’installazione. Per l’utilizzo di questo tema non è necessario eseguire hugo new site, in quanto si clonerà un sito di esempio nel passaggio 2.
2. Ottenere l’ultima versione del sito di esempio. Scaricate l’archivio denominato sito di esempio, che verrà automaticamente fornito con una versione compatibile del tema magnolia.
3. Le configurazioni del sito si trovano in config/_default. Il file di configurazione principale è config/_default/config.toml, ma la maggior parte delle variabili sono sovrascritte o definite dai file di configurazione delle singole lingue (ad esempio, config/_default/languages/.en.toml).
4. Spostarsi nella directory del sito e vedere l’anteprima del sito con hugo serve -D.

Come aggiornare ♻

• Spostarsi nella cartella del tema `cd themes/Magnolia
• Eseguire git checkout <version-tag>. Scegliere il tag della versione dalla pagina dei rilasci. Ad esempio git checkout v2.0.0. Controllare la pagina dei rilasci per assicurarsi che la nuova versione del tema sia compatibile con l’attuale versione del sito di esempio. Fare riferimento a Semantic Versioning 2.0.0 | Semantic Versioning.

Tradotto con DeepL.com (versione gratuita)

Come personalizzare 🎨

• Utilizzare la tavolozza di colori preferita modificando le variabili di Bootstrap in assets/scss/custom-variables.scss.

• Modificare i file di configurazione in /config/_default e /config/_default/languages aggiungendo i propri elementi alle pagine. È possibile cambiare anche i nomi delle pagine.

• Modificare il contenuto della homepage in content/<language>/_index.html, con il supporto di markdown.

• Modificare i nomi delle pagine, gli slug e le metadescrizioni in content/<language>/pages/<page>/index.html.

• Modificare le immagini del sito web dalle cartelle content/<language>/pages/<page>/<image> (le pagine e i post usano Page bundles).

• Aggiungere la propria favicon, lo sfondo e la meta-immagine predefinita (l’immagine usata per il SEO) in assets/img. Questi file possono essere di qualsiasi estensione, ma devono avere lo stesso nome di quelli attualmente presenti nella cartella degli asset del sito di esempio.

Come gestire i post ✏️

Abilita/Disabilita il blog

Aspetta, mi avevi detto che questo tema era adatto ai noob, non voglio avere a che fare con tutta la roba del blog!
Ho bisogno di una semplice landing page e tutte queste funzioni del blog non mi interessano!

Se non avete bisogno di post, potete disabilitare completamente la parte blog del tema dai file di configurazione e usare Magnolia come semplice landing page.

• Per disabilitare il rendering e l’indicizzazione di tags only per l’intero sito -> config.toml scommentare #disableKinds = ['taxonomy', 'term'].
• Per disabilitare il rendering e l’indicizzazione di post e tag per l’intero sito -> config.toml scommentare #disableKinds = ['taxonomy', 'term'] e #ignoreFiles= ['posts/*'].

Organizzazione del contenuto

La cartella /content contiene diversi tipi di contenuti; l’organizzazione dei contenuti imita la struttura del sito.

content
├── en
│   ├── _index.md
│   ├── pages
│   ├── posts
│   ├── profile.webp
│   └── tags
└── it
    ├── _index.md
    ├── pages
    ├── posts
    ├── profile.webp
    └── tags

Per ogni lingua, ci si troverà di fronte alla homepage _index.md e all’immagine utilizzata per la sezione di presentazione della homepage (profile.webp). Le altre directory conterranno esattamente ciò che ci si aspetta.

pages= normali pagine del sito (ufficio, servizi, ecc.). posts= messaggi del sito. tags = tag personalizzati.

Post

• Creare un nuovo post con: hugo new --kind post-bundle content/<lang>/posts/<nome-post>. Questa sarà la sua struttura molto semplice:

content/en/posts
├── a-poem-about-flowers
│   ├── images
│   │   └── featured.jpg
│   └── index.md

• Modificare i metadati in index.md e aggiungere il contenuto del post.

• Aggiungere un’immagine in evidenza al post, inserendo il segnaposto featured.webp in /images. L’immagine in evidenza deve essere chiamata “featured”, ma può essere di qualsiasi estensione. Se si desidera, è possibile rimuovere il segnaposto per avere un post di solo testo.

Tags

1. Un’opzione è quella di creare automaticamente i tag aggiungendoli ai frontespizi dei post.

2. La seconda opzione è creare un nuovo tag con: hugo new --kind tag content/<lang>/tags/<nome-tag>. La creazione di tag in questo modo consentirà una manipolazione più fine, si possono tradurre i tag dando la stessa translationKey nel frontmatter in ogni lingua diversa. In questo modo i post saranno ordinati nello stesso modo per ogni lingua e le traduzioni delle pagine dei tag saranno disponibili.

content/it/tags
├── fiori
│ └── _index.md

Per ulteriori informazioni sull’organizzazione dei contenuti, fare riferimento a Organizzazione dei contenuti | Hugo.

Aggiungere nuove lingue 🚩

1. Andare a config/_default/languages.
2. Duplicare uno dei file di lingua, cambiare il tag della lingua e il nome del file (en, it, fr ecc.): questo dovrebbe essere conforme a RFC 5646. Per una configurazione più rapida, utilizzare RFC 5646 Language Tags List.
3. Tradurre i valori delle variabili all’interno del file .toml in base alla lingua.
4. Nella cartella /content, duplicare una delle cartelle delle lingue e cambiarne il nome in base alla nuova lingua, come indicato al punto 2.
5. Per ogni file .html in /content/pages, è possibile modificare liberamente title e slug. La translationKey deve rimanere intatta o deve essere modificata in ogni file di pagina in lingua. Suggerisco vivamente di tradurre il SEO anche qui.
6. Per ogni file .md in content/posts/<my-post> traducete il contenuto e i valori di frontmatter di cui avete bisogno (es. summary).

Pagina 404 personalizzata

Per aggiungere la pagina 404 personalizzata e farla funzionare sulle pagine di github, è necessario aggiungerla manualmente durante la costruzione del sito eseguendo hugo. Questo perché github pages cerca un modello 404 nella cartella principale del progetto, quindi è possibile avere una sola pagina 404 per tutte le lingue. Per creare un link simbolico alla versione 404 inglese, che sarà poi usata come 404 predefinita una volta ospitata, dopo aver eseguito hugo eseguire ln -s public/en/404/index.html public/404.html.

Remunera il mio tempo e le mie energie 💫

Progettare questo tema e renderlo disponibile per voi ha richiesto molto tempo e impegno.

La licenza MIT significa che siete completamente liberi di fare tutto ciò che volete con questo tema, anche guadagnarci sopra!

Se lo desiderate, potete supportarmi in diversi modi.

Perché mai dovresti farlo?