mirror of
https://github.com/nunocoracao/blowfish.git
synced 2026-10-23 20:25:25 +00:00
Nuno CoraçãoandClaude Fable 5
5e0e09d415
New shortcode sections, landing layout docs, agent skill sections, v2→v3 upgrade instructions, translated homepages, and sample article feature images. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
122 lines
8.6 KiB
Markdown
122 lines
8.6 KiB
Markdown
---
|
|
title: "Homepage Layout"
|
|
featureimage: "images/v3/homepage-layout.png"
|
|
weight: 5
|
|
draft: false
|
|
description: "Configurazione del layout della home page nel tema Blowfish."
|
|
slug: "homepage-layout"
|
|
tags: ["homepage", "layouts", "docs"]
|
|
series: ["Documentazione"]
|
|
series_order: 5
|
|
---
|
|
|
|
Blowfish fornisce layout flessibili per la home page, con impostazioni per adattare ciascun design. In alternativa, puoi anche fornire il tuo modello e avere il controllo completo sul contenuto della home page.
|
|
|
|
Il layout della home page è controllato dall'impostazione `homepage.layout` nel file di configurazione `params.toml`. Inoltre, tutti i layout hanno la possibilità di includere un elenco di [articoli recenti](#articoli-recenti).
|
|
|
|
## Profile layout
|
|
|
|
Il layout predefinito è quello del profilo, ideale per i siti web e i blog personali. Mette i dettagli dell'autore in primo piano, fornendo un'immagine e i link ai profili sociali.
|
|
|
|
{{< figure src="img/home-profile.png" class="thumbnailshadow" >}}
|
|
|
|
Le informazioni sull'autore sono fornite nel file di configurazione delle lingue. Fare riferimento alle sezioni [Guida introduttiva]({{< ref "getting-started" >}}) e [Configurazione della lingua]({{< ref "configuration##language-and-i18n" >}}) per i dettagli sui parametri.
|
|
|
|
Inoltre, qualsiasi contenuto Markdown fornito nel contenuto della homepage sarà collocato sotto il profilo dell'autore. Ciò consente una maggiore flessibilità per la visualizzazione di una biografia o di altri contenuti personalizzati utilizzando gli shortcode.
|
|
|
|
Per abilitare il layout del profilo, impostare `homepage.layout = “profile”` nel file di configurazione `params.toml`.
|
|
|
|
## Page layout
|
|
|
|
Il layout di pagina è semplicemente una normale pagina di contenuto che visualizza il contenuto Markdown. È ottimo per i siti web statici e offre una grande flessibilità.
|
|
{{< figure src="img/home-page.png" class="thumbnailshadow" >}}
|
|
|
|
Per abilitare il layout di pagina, impostare `homepage.layout = “page”` nel file di configurazione `params.toml`.
|
|
|
|
## Hero layout
|
|
|
|
Il layout hero riunisce le idee dei layout profilo e scheda. Questo non solo mostra le informazioni sull'autore del sito, ma carica anche il markdown sotto di esso.
|
|
|
|
{{< figure src="img/home-hero.png" class="thumbnailshadow" >}}
|
|
|
|
Per abilitare il layout Hero, impostare `homepage.layout = “hero”` e `homepage.homepageImage` nel file di configurazione `params.toml`.
|
|
|
|
## Background layout
|
|
|
|
Il layout di sfondo è una versione più fluida del layout Hero. Come nel layout Hero, anche in questo caso vengono visualizzate le informazioni sull'autore del sito e viene caricato il markdown sotto di esso.
|
|
|
|
{{< figure src="img/home-background.png" class="thumbnailshadow" >}}
|
|
|
|
Per abilitare il layout di sfondo, impostare `homepage.layout = “background”` e `homepage.homepageImage` nel file di configurazione `params.toml`.
|
|
|
|
## Card layout
|
|
|
|
Il layout delle schede è un'estensione del layout di pagina. Offre lo stesso livello di flessibilità, visualizzando anche i contenuti markdown e aggiungendo un'immagine per visualizzare i contenuti visivi.
|
|
|
|
{{< figure src="img/home-card.png" class="thumbnailshadow" >}}
|
|
|
|
Per abilitare il layout a scheda, impostare `homepage.layout = “card”` e `homepage.homepageImage` nel file di configurazione `params.toml`.
|
|
|
|
## Landing layout
|
|
|
|
Il layout Landing è pensato per siti di prodotto, hub di documentazione e siti personali che hanno bisogno di un'apertura di maggiore impatto. Si apre con un hero ampio e dal taglio editoriale — occhiello, titolo d'effetto, paragrafo introduttivo e pulsanti di call-to-action — facoltativamente accompagnato da un'immagine hero a tutta larghezza che si dissolve nello sfondo globale, con un'animazione di ingresso scaglionata che viene disattivata automaticamente per i visitatori che preferiscono ridurre il movimento. Tutto ciò che sta sotto l'hero è Markdown standard e shortcode di Blowfish, quindi l'intera pagina rimane portabile e facile da mantenere.
|
|
|
|
{{< figure src="img/home-landing.png" class="thumbnailshadow" >}}
|
|
|
|
Per abilitare il layout Landing, impostare `homepage.layout = "landing"` nel file di configurazione `params.toml`.
|
|
|
|
L'hero è controllato dal front matter di `content/_index.md`. Tutti i campi sono facoltativi — ciò che viene omesso semplicemente non viene renderizzato:
|
|
|
|
```yaml
|
|
---
|
|
title: "Build a site that feels unmistakably yours."
|
|
heroCaption: "Blowfish" # eyebrow above the title; defaults to the author name
|
|
heroLead: "A short statement that expands on the title."
|
|
heroButtons:
|
|
- label: "Get started"
|
|
url: "/docs/installation/"
|
|
- label: "Explore the docs"
|
|
url: "/docs/"
|
|
style: "outline" # "primary" (default) or "outline"
|
|
---
|
|
```
|
|
|
|
| Front matter | Descrizione |
|
|
| ------------ | ----------- |
|
|
| `heroCaption` | Piccolo occhiello in maiuscolo sopra il titolo. Il valore predefinito è `params.Author.name`. |
|
|
| `heroLead` | Paragrafo introduttivo renderizzato sotto il titolo. Supporta Markdown. |
|
|
| `heroButtons` | Elenco di pulsanti di call-to-action (`label`, `url` e `style` facoltativo). Utilizza lo stesso stile dello [shortcode `cta`]({{< ref "shortcodes#cta-button" >}}). |
|
|
|
|
Il corpo Markdown di `_index.md` viene renderizzato sotto l'hero, quindi statistiche, griglie di funzionalità, passaggi e qualsiasi altro shortcode possono comporre il resto della pagina. Il layout Landing si abbina bene all'opzione `backgroundCanvas` a livello di sito descritta nei [docs di configurazione]({{< ref "configuration" >}}).
|
|
|
|
|
|
## Custom layout
|
|
|
|
Se i layout integrati della homepage non sono sufficienti per le vostre esigenze, avete la possibilità di creare un layout personalizzato. Questo permette di avere un controllo totale sul contenuto della pagina e fornisce essenzialmente una lavagna vuota con cui lavorare.
|
|
|
|
Per abilitare il layout personalizzato, impostare `homepage.layout = “custom”` nel file di configurazione `params.toml`.
|
|
|
|
Con il valore di configurazione impostato, creare un nuovo file `custom.html` e collocarlo in `layouts/partials/home/custom.html`. Ora tutto ciò che è contenuto nel file `custom.html` sarà collocato nell'area dei contenuti della homepage del sito. È possibile utilizzare qualsiasi funzione HTML, Tailwind o Hugo per definire il layout.
|
|
|
|
Per includere [articoli recenti](#articoli-recenti) nel layout personalizzato, utilizzare il partial `recent-articles/main.html`.
|
|
|
|
Il sito di esempio incluso utilizza il layout Landing integrato e gli shortcode di contenuto standard. Visitare il [repo GitHub](https://github.com/nunocoracao/blowfish/tree/main/exampleSite) per vedere come è configurato.
|
|
|
|
## Articoli recenti
|
|
|
|
Tutti i layout delle homepage hanno la possibilità di visualizzare gli articoli recenti sotto il contenuto della pagina principale. Per attivarla, è sufficiente impostare l'opzione `homepage.showRecent` a `true` nel file di configurazione `params.toml`.
|
|
|
|
{{< figure src="img/home-list.png" class="thumbnailshadow" >}}
|
|
|
|
Gli articoli elencati in questa sezione sono derivati dall'impostazione `mainSections`, che consente di utilizzare i tipi di contenuto del sito web. Per esempio, se si hanno sezioni di contenuto per _post_ e _progetti_, si può impostare questa impostazione su `[“post”, “progetti”]` e tutti gli articoli di queste due sezioni saranno utilizzati per popolare l'elenco dei recenti. Il tema si aspetta che questa impostazione sia un array, quindi se si utilizza una sola sezione per tutti i contenuti, è necessario impostarla di conseguenza: `[“blog”]`.
|
|
|
|
## Thumbnails
|
|
|
|
Blowfish è stato creato in modo che sia facile aggiungere supporto visivo ai tuoi articoli. Se hai familiarità con la struttura dell'articolo di Hugo, devi solo inserire un file immagine (quasi tutti i formati sono supportati ma consigliamo `.png` o `.jpg`) che inizi con `feature*` all'interno della cartella dell'articolo. E questo è tutto, Blowfish sarà quindi in grado di utilizzare l'immagine sia come miniatura all'interno del tuo sito web sia per le schede <a target="_blank" href="https://oembed.com/">oEmbed</a> su piattaforme sociali.
|
|
|
|
[Qui]({{< ref "thumbnails" >}}) si trova una guida con maggiori informazioni e un [sample]({{< ref "thumbnail_sample" >}}) se si vuole vedere un esempio.
|
|
|
|
## Card Gallery
|
|
|
|
Blowfish supporta anche la visualizzazione degli elenchi standard di articoli come gallerie di schede. È possibile configurare questo sia per la sezione recente nella homepage che per gli elenchi di articoli nel sito web. Per la homepage si può usare `homepage.cardView` e `homepage.cardViewScreenWidth`; per gli elenchi si può usare `list.cardView` e `list.cardViewScreenWidth`. Per maggiori dettagli, consultare i [docs di configurazione] ({{< ref "configuration" >}}) e la homepage per una dimostrazione dal vivo.
|