diff --git a/exampleSite/content/_index.de.md b/exampleSite/content/_index.de.md
index 4f317df9..6ec7e52e 100644
--- a/exampleSite/content/_index.de.md
+++ b/exampleSite/content/_index.de.md
@@ -1,29 +1,37 @@
---
-title: "Willkommen bei Blowfish! :tada:"
-description: "Diese Seite wurde mit dem Blowfish-Theme für Hugo erstellt."
+title: "Baue eine Website, die unverwechselbar deine ist."
+description: "Ein modernes, flexibles Hugo-Theme für Blogs, Dokumentation, Portfolios und mehr."
+heroLead: "Blowfish bietet ausdrucksstarke Layouts, durchdachte Voreinstellungen und praktische Bausteine für deine Inhalte — damit du dich auf das konzentrieren kannst, was du sagen möchtest."
+heroButtons:
+ - label: "Loslegen"
+ url: "/de/docs/installation/"
+ - label: "Dokumentation entdecken"
+ url: "/de/docs/"
+ style: "outline"
+ - label: "Star auf GitHub"
+ url: "https://github.com/nunocoracao/blowfish"
+ style: "outline"
+ github: "nunocoracao/blowfish"
+heroImage: "images/v3/welcome.png"
---
+{{< stats >}}
+{{< stat value="5" label="Homepage-Layouts" >}}Wähle die Struktur, die zu deiner Website passt.{{< /stat >}}
+{{< stat value="40+" label="Shortcodes" >}}Gestalte ausdrucksstarke Inhalte, ohne eigene Templates zu pflegen.{{< /stat >}}
+{{< stat value="100%" label="Deine Inhalte" >}}Portables Markdown, vertraute Hugo-Konfiguration, kein Lock-in.{{< /stat >}}
+{{< /stats >}}
-
-
- {{< icon "triangle-exclamation" >}}
-
-
- Dies ist eine Demo des background Layouts.
-
-
-
-
-
-```shell
-npx blowfish-tools
-```
-
-{{< youtubeLite id="SgXhGb-7QbU" label="Blowfish-tools Demo" >}}
-
-
+{{< feature-grid >}}
+{{< feature icon="list-check" title="Mach es zu deinem" url="/de/docs/configuration/" >}}
+Ein stimmiges System aus Layouts, Farben, Typografie und Inhaltssteuerung.
+{{< /feature >}}
+{{< feature icon="code" title="Schneller gestalten" url="/de/docs/shortcodes/" label="Shortcodes durchstöbern" >}}
+Nützliche Komponenten für reichere Geschichten, klarere Dokumentation und weniger Eigenbau.
+{{< /feature >}}
+{{< feature icon="heart" title="Offen entwickelt" url="/de/users/" >}}
+Entdecke echte Websites, Community-Beiträge und Patterns, die sich in der Praxis bewähren.
+{{< /feature >}}
+{{< feature icon="wand-magic-sparkles" title="Gemacht für KI-Agents" url="/de/docs/installation/#agent-skill" label="Skill installieren" >}}
+Blowfish enthält einen Agent-Skill, der Claude Code und anderen Coding-Agents beibringt, das Theme zu installieren, zu konfigurieren und damit zu arbeiten.
+{{< /feature >}}
+{{< /feature-grid >}}
diff --git a/exampleSite/content/_index.es.md b/exampleSite/content/_index.es.md
index 8294011c..db50d3fa 100644
--- a/exampleSite/content/_index.es.md
+++ b/exampleSite/content/_index.es.md
@@ -1,29 +1,37 @@
---
-title: "¡Bienvenido a Blowfish! :tada:"
-description: "Esta página fue creada usando el tema Blowfish para Hugo."
+title: "Crea un sitio que sea inconfundiblemente tuyo."
+description: "Un tema de Hugo moderno y flexible para blogs, documentación, portafolios y más."
+heroLead: "Blowfish te ofrece layouts expresivos, valores predeterminados bien pensados y bloques de contenido prácticos, para que te concentres en lo que quieres contar."
+heroButtons:
+ - label: "Empezar"
+ url: "/es/docs/installation/"
+ - label: "Explorar la documentación"
+ url: "/es/docs/"
+ style: "outline"
+ - label: "Dale una estrella en GitHub"
+ url: "https://github.com/nunocoracao/blowfish"
+ style: "outline"
+ github: "nunocoracao/blowfish"
+heroImage: "images/v3/welcome.png"
---
+{{< stats >}}
+{{< stat value="5" label="Layouts de portada" >}}Elige la estructura que mejor se adapta al sitio que estás creando.{{< /stat >}}
+{{< stat value="40+" label="Shortcodes" >}}Compón contenido expresivo sin mantener plantillas a medida.{{< /stat >}}
+{{< stat value="100%" label="Tu contenido" >}}Markdown portable, configuración familiar de Hugo y sin ataduras.{{< /stat >}}
+{{< /stats >}}
-
-
- {{< icon "triangle-exclamation" >}}
-
-
- Esta es una demostración del layout background.
-
-
-
-
-
-```shell
-npx blowfish-tools
-```
-
-{{< youtubeLite id="SgXhGb-7QbU" label="Demo de Blowfish-tools" >}}
-
-
+{{< feature-grid >}}
+{{< feature icon="list-check" title="Hazlo tuyo" url="/es/docs/configuration/" >}}
+Un sistema coherente de layouts, colores, tipografía y controles de contenido.
+{{< /feature >}}
+{{< feature icon="code" title="Compón más rápido" url="/es/docs/shortcodes/" label="Ver shortcodes" >}}
+Componentes útiles para historias más ricas, documentación más clara y menos código a medida.
+{{< /feature >}}
+{{< feature icon="heart" title="Hecho en abierto" url="/es/users/" >}}
+Explora sitios reales, contribuciones de la comunidad y patrones que funcionan en producción.
+{{< /feature >}}
+{{< feature icon="wand-magic-sparkles" title="Pensado para agentes de IA" url="/es/docs/installation/#skill-para-agentes" label="Instalar el skill" >}}
+Blowfish incluye un skill que enseña a Claude Code y otros agentes de programación a instalar, configurar y trabajar con el tema.
+{{< /feature >}}
+{{< /feature-grid >}}
diff --git a/exampleSite/content/_index.fr.md b/exampleSite/content/_index.fr.md
index 840def8d..f5579e74 100644
--- a/exampleSite/content/_index.fr.md
+++ b/exampleSite/content/_index.fr.md
@@ -1,29 +1,37 @@
---
-title: "Bienvenue sur Blowfish ! :tada:"
-description: "Cette page a été créée avec le thème Blowfish pour Hugo."
+title: "Créez un site qui vous ressemble vraiment."
+description: "Un thème Hugo moderne et flexible pour les blogs, la documentation, les portfolios et plus encore."
+heroLead: "Blowfish vous offre des layouts expressifs, des réglages par défaut bien pensés et des blocs de contenu pratiques, pour vous concentrer sur ce que vous voulez dire."
+heroButtons:
+ - label: "Commencer"
+ url: "/fr/docs/installation/"
+ - label: "Explorer la documentation"
+ url: "/fr/docs/"
+ style: "outline"
+ - label: "Star sur GitHub"
+ url: "https://github.com/nunocoracao/blowfish"
+ style: "outline"
+ github: "nunocoracao/blowfish"
+heroImage: "images/v3/welcome.png"
---
+{{< stats >}}
+{{< stat value="5" label="Layouts d'accueil" >}}Choisissez la structure qui convient au site que vous créez.{{< /stat >}}
+{{< stat value="40+" label="Shortcodes" >}}Composez un contenu expressif sans maintenir de templates sur mesure.{{< /stat >}}
+{{< stat value="100%" label="Votre contenu" >}}Markdown portable, configuration Hugo familière et aucune dépendance.{{< /stat >}}
+{{< /stats >}}
-
-
- {{< icon "triangle-exclamation" >}}
-
-
- Ceci est une démo du layout background.
-
-
-
-
-
-```shell
-npx blowfish-tools
-```
-
-{{< youtubeLite id="SgXhGb-7QbU" label="Démo de Blowfish-tools" >}}
-
-
+{{< feature-grid >}}
+{{< feature icon="list-check" title="Faites-le vôtre" url="/fr/docs/configuration/" >}}
+Un système cohérent de layouts, couleurs, typographie et contrôles de contenu.
+{{< /feature >}}
+{{< feature icon="code" title="Composez plus vite" url="/fr/docs/shortcodes/" label="Parcourir les shortcodes" >}}
+Des composants utiles pour des histoires plus riches, une documentation plus claire et moins de code sur mesure.
+{{< /feature >}}
+{{< feature icon="heart" title="Développé au grand jour" url="/fr/users/" >}}
+Découvrez des sites réels, des contributions de la communauté et des patterns éprouvés en production.
+{{< /feature >}}
+{{< feature icon="wand-magic-sparkles" title="Conçu pour les agents IA" url="/fr/docs/installation/#skill-pour-agents" label="Installer le skill" >}}
+Blowfish inclut un skill qui apprend à Claude Code et à d'autres agents de codage à installer, configurer et utiliser le thème.
+{{< /feature >}}
+{{< /feature-grid >}}
diff --git a/exampleSite/content/_index.it.md b/exampleSite/content/_index.it.md
index e07bc0c7..c2bada23 100755
--- a/exampleSite/content/_index.it.md
+++ b/exampleSite/content/_index.it.md
@@ -1,25 +1,37 @@
---
-title: "Benvenuti a Blowfish!"
-description: "Questa pagina è stata creata utilizzando il tema Blowfish per Hugo."
+title: "Crea un sito che sia inconfondibilmente tuo."
+description: "Un tema Hugo moderno e flessibile per blog, documentazione, portfolio e altro."
+heroLead: "Blowfish ti offre layout espressivi, impostazioni predefinite ben pensate e blocchi di contenuto pratici, così puoi concentrarti su ciò che vuoi raccontare."
+heroButtons:
+ - label: "Inizia"
+ url: "/it/docs/installation/"
+ - label: "Esplora la documentazione"
+ url: "/it/docs/"
+ style: "outline"
+ - label: "Metti una stella su GitHub"
+ url: "https://github.com/nunocoracao/blowfish"
+ style: "outline"
+ github: "nunocoracao/blowfish"
+heroImage: "images/v3/welcome.png"
---
-
-
- {{< icon "triangle-exclamation" >}}
-
-
- Questa è una demo del layout background.
-
-
-
+{{< stats >}}
+{{< stat value="5" label="Layout della homepage" >}}Scegli la struttura più adatta al sito che stai creando.{{< /stat >}}
+{{< stat value="40+" label="Shortcode" >}}Componi contenuti espressivi senza mantenere template su misura.{{< /stat >}}
+{{< stat value="100%" label="I tuoi contenuti" >}}Markdown portabile, configurazione Hugo familiare e nessun lock-in.{{< /stat >}}
+{{< /stats >}}
-```shell
-npx blowfish-tools
-```
-
-{{< youtubeLite id="SgXhGb-7QbU" label="Demo degli strumenti Blowfish" >}}
+{{< feature-grid >}}
+{{< feature icon="list-check" title="Rendilo tuo" url="/it/docs/configuration/" >}}
+Un sistema coerente di layout, colori, tipografia e controlli dei contenuti.
+{{< /feature >}}
+{{< feature icon="code" title="Componi più velocemente" url="/it/docs/shortcodes/" label="Sfoglia gli shortcode" >}}
+Componenti utili per storie più ricche, documentazione più chiara e meno codice su misura.
+{{< /feature >}}
+{{< feature icon="heart" title="Sviluppato in aperto" url="/it/users/" >}}
+Esplora siti reali, contributi della community e pattern che reggono in produzione.
+{{< /feature >}}
+{{< feature icon="wand-magic-sparkles" title="Pensato per gli agenti IA" url="/it/docs/installation/#skill-per-agenti" label="Installa la skill" >}}
+Blowfish include una skill che insegna a Claude Code e ad altri agenti di programmazione a installare, configurare e usare il tema.
+{{< /feature >}}
+{{< /feature-grid >}}
diff --git a/exampleSite/content/_index.ja.md b/exampleSite/content/_index.ja.md
index 469b42f7..f8f2fba7 100755
--- a/exampleSite/content/_index.ja.md
+++ b/exampleSite/content/_index.ja.md
@@ -1,29 +1,37 @@
---
-title: "Blowfish へようこそ! :tada:"
-description: "このページは Hugo の Blowfish テーマを利用して構築されています。"
+title: "まぎれもなく自分らしいサイトを。"
+description: "ブログ、ドキュメント、ポートフォリオなどに使える、モダンで柔軟な Hugo テーマ。"
+heroLead: "Blowfish は表現力豊かなレイアウト、行き届いたデフォルト設定、実用的なコンテンツ部品を提供します。あなたは伝えたいことに集中するだけです。"
+heroButtons:
+ - label: "はじめる"
+ url: "/ja/docs/installation/"
+ - label: "ドキュメントを見る"
+ url: "/ja/docs/"
+ style: "outline"
+ - label: "GitHub でスターする"
+ url: "https://github.com/nunocoracao/blowfish"
+ style: "outline"
+ github: "nunocoracao/blowfish"
+heroImage: "images/v3/welcome.png"
---
+{{< stats >}}
+{{< stat value="5" label="ホームページレイアウト" >}}作りたいサイトに合った構成を選べます。{{< /stat >}}
+{{< stat value="40+" label="ショートコード" >}}独自テンプレートを管理せずに、表現力豊かなコンテンツを作成できます。{{< /stat >}}
+{{< stat value="100%" label="あなたのコンテンツ" >}}ポータブルな Markdown、おなじみの Hugo 設定、ロックインなし。{{< /stat >}}
+{{< /stats >}}
-
-
-
-```shell
-npx blowfish-tools
-```
-
-{{< youtubeLite id="SgXhGb-7QbU" label="Blowfish-tools demo" >}}
-
-
+{{< feature-grid >}}
+{{< feature icon="list-check" title="自分好みに" url="/ja/docs/configuration/" >}}
+レイアウト、配色、タイポグラフィ、コンテンツ制御の一貫したシステム。
+{{< /feature >}}
+{{< feature icon="code" title="より速く作る" url="/ja/docs/shortcodes/" label="ショートコードを見る" >}}
+豊かなストーリーと明快なドキュメントのための便利なコンポーネント。
+{{< /feature >}}
+{{< feature icon="heart" title="オープンに開発" url="/ja/users/" >}}
+実際のサイト、コミュニティの貢献、実運用に耐えるパターンを探索できます。
+{{< /feature >}}
+{{< feature icon="wand-magic-sparkles" title="AI エージェント対応" url="/ja/docs/installation/#エージェントスキル" label="スキルをインストール" >}}
+Blowfish には、Claude Code などのコーディングエージェントにテーマのインストール・設定・活用方法を教えるエージェントスキルが付属しています。
+{{< /feature >}}
+{{< /feature-grid >}}
diff --git a/exampleSite/content/_index.md b/exampleSite/content/_index.md
index dd8946f7..cdf0bbd8 100755
--- a/exampleSite/content/_index.md
+++ b/exampleSite/content/_index.md
@@ -1,16 +1,20 @@
---
title: "Build a site that feels unmistakably yours."
description: "A modern, flexible Hugo theme for blogs, documentation, portfolios, and more."
+heroLead: "Blowfish gives you expressive layouts, thoughtful defaults, and practical content building blocks, so you can focus on the thing you want to say."
+heroButtons:
+ - label: "Get started"
+ url: "/docs/installation/"
+ - label: "Explore the docs"
+ url: "/docs/"
+ style: "outline"
+ - label: "Star on GitHub"
+ url: "https://github.com/nunocoracao/blowfish"
+ style: "outline"
+ github: "nunocoracao/blowfish"
+heroImage: "images/v3/welcome.png"
---
-{{< lead >}}
-Blowfish gives you expressive layouts, thoughtful defaults, and practical content building blocks, so you can focus on the thing you want to say.
-{{< /lead >}}
-
-{{< cta url="/docs/installation/" label="Get started" >}}
-
-{{< cta url="/docs/" label="Explore the docs" style="outline" >}}
-
{{< stats >}}
{{< stat value="5" label="Homepage layouts" >}}Choose the structure that suits the site you are making.{{< /stat >}}
{{< stat value="40+" label="Shortcodes" >}}Compose expressive content without maintaining one-off templates.{{< /stat >}}
@@ -27,22 +31,7 @@ Useful components for richer stories, clearer documentation, and less custom glu
{{< feature icon="heart" title="Made in the open" url="/users/" >}}
Explore real sites, community contributions, and patterns that hold up in production.
{{< /feature >}}
+{{< feature icon="wand-magic-sparkles" title="Built for AI agents" url="/docs/installation/#agent-skill" label="Install the skill" >}}
+Blowfish ships an agent skill that teaches Claude Code and other coding agents how to install, configure, and build with the theme.
+{{< /feature >}}
{{< /feature-grid >}}
-
-## A theme that grows with your work
-
-{{< steps >}}
-{{< step number="1" title="Start with a strong foundation" >}}
-Pick a layout, set your colours and typography, then publish a useful first version.
-{{< /step >}}
-{{< step number="2" title="Build richer pages from content" >}}
-Use shortcodes for calls to action, feature grids, media, diagrams, tabs, and more.
-{{< /step >}}
-{{< step number="3" title="Keep evolving without rewrites" >}}
-Add what your site needs while keeping your content and configuration portable.
-{{< /step >}}
-{{< /steps >}}
-
-{{< alert "circle-info" >}}
-This homepage uses Blowfish's built-in `landing` layout and standard shortcodes. No custom homepage template is required.
-{{< /alert >}}
diff --git a/exampleSite/content/_index.pt-br.md b/exampleSite/content/_index.pt-br.md
index 45539ca5..11db5d2f 100644
--- a/exampleSite/content/_index.pt-br.md
+++ b/exampleSite/content/_index.pt-br.md
@@ -1,29 +1,37 @@
---
-title: "Bem-vindo ao Blowfish! :tada:"
-description: "Esta página foi criada usando o tema Blowfish para Hugo."
+title: "Crie um site que seja inconfundivelmente seu."
+description: "Um tema Hugo moderno e flexível para blogs, documentação, portfólios e muito mais."
+heroLead: "O Blowfish oferece layouts expressivos, padrões bem pensados e blocos de conteúdo práticos, para que você se concentre no que quer dizer."
+heroButtons:
+ - label: "Começar"
+ url: "/pt-br/docs/installation/"
+ - label: "Explorar a documentação"
+ url: "/pt-br/docs/"
+ style: "outline"
+ - label: "Dê uma estrela no GitHub"
+ url: "https://github.com/nunocoracao/blowfish"
+ style: "outline"
+ github: "nunocoracao/blowfish"
+heroImage: "images/v3/welcome.png"
---
+{{< stats >}}
+{{< stat value="5" label="Layouts de página inicial" >}}Escolha a estrutura ideal para o site que você está criando.{{< /stat >}}
+{{< stat value="40+" label="Shortcodes" >}}Componha conteúdo expressivo sem manter templates sob medida.{{< /stat >}}
+{{< stat value="100%" label="Seu conteúdo" >}}Markdown portátil, configuração familiar do Hugo e sem lock-in.{{< /stat >}}
+{{< /stats >}}
-
-
- {{< icon "triangle-exclamation" >}}
-
-
- Esta é uma demonstração do layout background.
-
-
-
-
-
-```shell
-npx blowfish-tools
-```
-
-{{< youtubeLite id="SgXhGb-7QbU" label="Demo do Blowfish-tools" >}}
-
-
+{{< feature-grid >}}
+{{< feature icon="list-check" title="Deixe com a sua cara" url="/pt-br/docs/configuration/" >}}
+Um sistema coerente de layouts, cores, tipografia e controles de conteúdo.
+{{< /feature >}}
+{{< feature icon="code" title="Componha mais rápido" url="/pt-br/docs/shortcodes/" label="Ver shortcodes" >}}
+Componentes úteis para histórias mais ricas, documentação mais clara e menos código sob medida.
+{{< /feature >}}
+{{< feature icon="heart" title="Feito abertamente" url="/pt-br/users/" >}}
+Explore sites reais, contribuições da comunidade e padrões que funcionam em produção.
+{{< /feature >}}
+{{< feature icon="wand-magic-sparkles" title="Feito para agentes de IA" url="/pt-br/docs/installation/#skill-para-agentes" label="Instalar a skill" >}}
+O Blowfish inclui uma skill que ensina o Claude Code e outros agentes de programação a instalar, configurar e trabalhar com o tema.
+{{< /feature >}}
+{{< /feature-grid >}}
diff --git a/exampleSite/content/_index.pt-pt.md b/exampleSite/content/_index.pt-pt.md
index 02994c93..e47f1cd3 100644
--- a/exampleSite/content/_index.pt-pt.md
+++ b/exampleSite/content/_index.pt-pt.md
@@ -1,29 +1,37 @@
---
-title: "Bem-vindo ao Blowfish! :tada:"
-description: "Esta página foi criada utilizando o tema Blowfish para Hugo."
+title: "Crie um site que seja inconfundivelmente seu."
+description: "Um tema Hugo moderno e flexível para blogs, documentação, portefólios e muito mais."
+heroLead: "O Blowfish oferece layouts expressivos, predefinições bem pensadas e blocos de conteúdo práticos, para que se concentre no que quer dizer."
+heroButtons:
+ - label: "Começar"
+ url: "/pt-pt/docs/installation/"
+ - label: "Explorar a documentação"
+ url: "/pt-pt/docs/"
+ style: "outline"
+ - label: "Dê uma estrela no GitHub"
+ url: "https://github.com/nunocoracao/blowfish"
+ style: "outline"
+ github: "nunocoracao/blowfish"
+heroImage: "images/v3/welcome.png"
---
+{{< stats >}}
+{{< stat value="5" label="Layouts de página inicial" >}}Escolha a estrutura ideal para o site que está a criar.{{< /stat >}}
+{{< stat value="40+" label="Shortcodes" >}}Componha conteúdo expressivo sem manter templates à medida.{{< /stat >}}
+{{< stat value="100%" label="O seu conteúdo" >}}Markdown portátil, configuração familiar do Hugo e sem dependências.{{< /stat >}}
+{{< /stats >}}
-
-
- {{< icon "triangle-exclamation" >}}
-
-
- Esta é uma demonstração do layout background.
-
-
-
-
-
-```shell
-npx blowfish-tools
-```
-
-{{< youtubeLite id="SgXhGb-7QbU" label="Demo do Blowfish-tools" >}}
-
-
+{{< feature-grid >}}
+{{< feature icon="list-check" title="Torne-o seu" url="/pt-pt/docs/configuration/" >}}
+Um sistema coerente de layouts, cores, tipografia e controlos de conteúdo.
+{{< /feature >}}
+{{< feature icon="code" title="Componha mais depressa" url="/pt-pt/docs/shortcodes/" label="Ver shortcodes" >}}
+Componentes úteis para histórias mais ricas, documentação mais clara e menos código à medida.
+{{< /feature >}}
+{{< feature icon="heart" title="Feito abertamente" url="/pt-pt/users/" >}}
+Explore sites reais, contribuições da comunidade e padrões que resistem em produção.
+{{< /feature >}}
+{{< feature icon="wand-magic-sparkles" title="Feito para agentes de IA" url="/pt-pt/docs/installation/#skill-para-agentes" label="Instalar a skill" >}}
+O Blowfish inclui uma skill que ensina o Claude Code e outros agentes de programação a instalar, configurar e trabalhar com o tema.
+{{< /feature >}}
+{{< /feature-grid >}}
diff --git a/exampleSite/content/_index.zh-cn.md b/exampleSite/content/_index.zh-cn.md
index e05994a6..e1f10042 100644
--- a/exampleSite/content/_index.zh-cn.md
+++ b/exampleSite/content/_index.zh-cn.md
@@ -1,29 +1,37 @@
---
-title: "欢迎来到 Blowfish! :tada:"
-description: "此页面是使用 Hugo 的 Blowfish 主题搭建的"
+title: "打造一个独一无二、真正属于你的网站。"
+description: "一款现代、灵活的 Hugo 主题，适用于博客、文档、作品集等。"
+heroLead: "Blowfish 提供富有表现力的布局、贴心的默认配置和实用的内容组件，让你专注于想要表达的内容。"
+heroButtons:
+ - label: "快速开始"
+ url: "/zh-cn/docs/installation/"
+ - label: "浏览文档"
+ url: "/zh-cn/docs/"
+ style: "outline"
+ - label: "在 GitHub 上加星标"
+ url: "https://github.com/nunocoracao/blowfish"
+ style: "outline"
+ github: "nunocoracao/blowfish"
+heroImage: "images/v3/welcome.png"
---
+{{< stats >}}
+{{< stat value="5" label="首页布局" >}}选择最适合你网站的结构。{{< /stat >}}
+{{< stat value="40+" label="短代码" >}}无需维护一次性模板，即可创作富有表现力的内容。{{< /stat >}}
+{{< stat value="100%" label="内容完全属于你" >}}可移植的 Markdown、熟悉的 Hugo 配置、没有锁定。{{< /stat >}}
+{{< /stats >}}
-
-
-
-```shell
-npx blowfish-tools
-```
-
-{{< youtubeLite id="SgXhGb-7QbU" label="Blowfish-tools demo" >}}
-
-
+{{< feature-grid >}}
+{{< feature icon="list-check" title="打造你的风格" url="/zh-cn/docs/configuration/" >}}
+布局、配色、排版与内容控制浑然一体。
+{{< /feature >}}
+{{< feature icon="code" title="更快地创作" url="/zh-cn/docs/shortcodes/" label="浏览短代码" >}}
+实用组件，让故事更丰富、文档更清晰、无需自制胶水代码。
+{{< /feature >}}
+{{< feature icon="heart" title="开放共建" url="/zh-cn/users/" >}}
+探索真实网站、社区贡献以及经受住生产考验的模式。
+{{< /feature >}}
+{{< feature icon="wand-magic-sparkles" title="为 AI 智能体而生" url="/zh-cn/docs/installation/#智能体技能" label="安装技能" >}}
+Blowfish 附带一个智能体技能，教 Claude Code 等编程智能体安装、配置和使用本主题。
+{{< /feature >}}
+{{< /feature-grid >}}
diff --git a/exampleSite/content/docs/advanced-customisation/index.de.md b/exampleSite/content/docs/advanced-customisation/index.de.md
index 7c7a6aa7..2be1195b 100644
--- a/exampleSite/content/docs/advanced-customisation/index.de.md
+++ b/exampleSite/content/docs/advanced-customisation/index.de.md
@@ -1,5 +1,6 @@
---
title: "Erweiterte Anpassung"
+featureimage: "images/v3/advanced-customisation.png"
weight: 13
draft: false
description: "Erfahren Sie, wie Sie Blowfish manuell erstellen."
diff --git a/exampleSite/content/docs/advanced-customisation/index.es.md b/exampleSite/content/docs/advanced-customisation/index.es.md
index 81335b11..9e4a3f95 100644
--- a/exampleSite/content/docs/advanced-customisation/index.es.md
+++ b/exampleSite/content/docs/advanced-customisation/index.es.md
@@ -1,5 +1,6 @@
---
title: "Personalización avanzada"
+featureimage: "images/v3/advanced-customisation.png"
weight: 13
draft: false
description: "Aprende cómo construir Blowfish manualmente."
diff --git a/exampleSite/content/docs/advanced-customisation/index.fr.md b/exampleSite/content/docs/advanced-customisation/index.fr.md
index 9124ec62..71fb0375 100644
--- a/exampleSite/content/docs/advanced-customisation/index.fr.md
+++ b/exampleSite/content/docs/advanced-customisation/index.fr.md
@@ -1,5 +1,6 @@
---
title: "Personnalisation avancée"
+featureimage: "images/v3/advanced-customisation.png"
weight: 13
draft: false
description: "Apprenez à construire Blowfish manuellement."
diff --git a/exampleSite/content/docs/advanced-customisation/index.it.md b/exampleSite/content/docs/advanced-customisation/index.it.md
index db9162c1..248418a9 100644
--- a/exampleSite/content/docs/advanced-customisation/index.it.md
+++ b/exampleSite/content/docs/advanced-customisation/index.it.md
@@ -1,5 +1,6 @@
---
title: "Advanced Customisation"
+featureimage: "images/v3/advanced-customisation.png"
weight: 13
draft: false
description: "Learn how to build Blowfish manually."
diff --git a/exampleSite/content/docs/advanced-customisation/index.ja.md b/exampleSite/content/docs/advanced-customisation/index.ja.md
index bd468db3..78885eca 100644
--- a/exampleSite/content/docs/advanced-customisation/index.ja.md
+++ b/exampleSite/content/docs/advanced-customisation/index.ja.md
@@ -1,5 +1,6 @@
---
title: "高度なカスタマイズ"
+featureimage: "images/v3/advanced-customisation.png"
weight: 13
draft: false
description: "Blowfishを手動でビルドする方法を学びましょう。"
diff --git a/exampleSite/content/docs/advanced-customisation/index.pt-br.md b/exampleSite/content/docs/advanced-customisation/index.pt-br.md
index 6d41f46c..aee2807b 100644
--- a/exampleSite/content/docs/advanced-customisation/index.pt-br.md
+++ b/exampleSite/content/docs/advanced-customisation/index.pt-br.md
@@ -1,5 +1,6 @@
---
title: "Personalização avançada"
+featureimage: "images/v3/advanced-customisation.png"
weight: 13
draft: false
description: "Aprenda como construir o Blowfish manualmente."
diff --git a/exampleSite/content/docs/advanced-customisation/index.pt-pt.md b/exampleSite/content/docs/advanced-customisation/index.pt-pt.md
index 298975af..ac6c7f7b 100644
--- a/exampleSite/content/docs/advanced-customisation/index.pt-pt.md
+++ b/exampleSite/content/docs/advanced-customisation/index.pt-pt.md
@@ -1,5 +1,6 @@
---
title: "Personalização avançada"
+featureimage: "images/v3/advanced-customisation.png"
weight: 13
draft: false
description: "Aprenda como construir o Blowfish manualmente."
diff --git a/exampleSite/content/docs/advanced-customisation/index.zh-cn.md b/exampleSite/content/docs/advanced-customisation/index.zh-cn.md
index ae5849ef..32778b06 100644
--- a/exampleSite/content/docs/advanced-customisation/index.zh-cn.md
+++ b/exampleSite/content/docs/advanced-customisation/index.zh-cn.md
@@ -1,5 +1,6 @@
---
title: 进阶自定义
+featureimage: "images/v3/advanced-customisation.png"
weight: 13
draft: false
description: "了解如何手动构建 Blowfish。"
diff --git a/exampleSite/content/docs/configuration/index.de.md b/exampleSite/content/docs/configuration/index.de.md
index f63a6a32..2f5b4ebb 100644
--- a/exampleSite/content/docs/configuration/index.de.md
+++ b/exampleSite/content/docs/configuration/index.de.md
@@ -3,6 +3,7 @@ title: "Konfiguration"
weight: 4
draft: false
description: "Alle in Blowfish verfügbaren Konfigurationsvariablen."
+featureimage: "images/v3/configuration-system.png"
slug: "configuration"
tags: ["konfiguration", "dokumentation"]
series: ["Dokumentation"]
@@ -13,13 +14,8 @@ Blowfish ist ein hochgradig anpassbares Theme und nutzt einige der neuesten Hugo
Das Theme wird mit einer Standardkonfiguration geliefert, die Sie mit einem einfachen Blog oder einer statischen Website zum Laufen bringt.
-{{< alert "fire" >}}
-Wir haben gerade ein CLI-Tool veröffentlicht, das Ihnen beim Einstieg mit Blowfish hilft. Es unterstützt Sie bei Installation und Konfiguration. Installieren Sie das CLI-Tool global mit:
-
-```bash
-npx blowfish-tools
-```
-
+{{< alert "wand-magic-sparkles" >}}
+Arbeitest du mit einem KI-Coding-Agent? Blowfish enthält einen **Agent-Skill**, der Agents wie Claude Code beibringt, das Theme zu installieren, zu konfigurieren und damit zu arbeiten — die Einrichtung ist auf der [Installationsseite]({{< ref "docs/installation" >}}) beschrieben.
{{< /alert >}}
> Die mit dem Theme gelieferten Konfigurationsdateien werden im TOML-Format bereitgestellt, da dies die Standard-Hugo-Syntax ist. Sie können Ihre Konfiguration bei Bedarf in YAML oder JSON konvertieren.
diff --git a/exampleSite/content/docs/configuration/index.es.md b/exampleSite/content/docs/configuration/index.es.md
index fc6f52f4..0f411520 100644
--- a/exampleSite/content/docs/configuration/index.es.md
+++ b/exampleSite/content/docs/configuration/index.es.md
@@ -3,6 +3,7 @@ title: "Configuración"
weight: 4
draft: false
description: "Todas las variables de configuración disponibles en Blowfish."
+featureimage: "images/v3/configuration-system.png"
slug: "configuration"
tags: ["configuración", "documentación"]
series: ["Documentación"]
@@ -13,13 +14,8 @@ Blowfish es un tema altamente personalizable y utiliza algunas de las últimas c
El tema viene con una configuración predeterminada que te permite empezar con un blog básico o sitio web estático.
-{{< alert "fire" >}}
-Acabamos de lanzar una herramienta CLI para ayudarte a empezar con Blowfish. Te ayudará con la instalación y configuración. Instala la herramienta CLI globalmente usando:
-
-```bash
-npx blowfish-tools
-```
-
+{{< alert "wand-magic-sparkles" >}}
+¿Trabajas con un agente de programación con IA? Blowfish incluye un **skill para agentes** que enseña a agentes como Claude Code a instalar, configurar y trabajar con el tema — consulta la [página de instalación]({{< ref "docs/installation" >}}) para configurarlo.
{{< /alert >}}
> Los archivos de configuración incluidos con el tema se proporcionan en formato TOML ya que es la sintaxis predeterminada de Hugo. Siéntete libre de convertir tu configuración a YAML o JSON si lo deseas.
diff --git a/exampleSite/content/docs/configuration/index.fr.md b/exampleSite/content/docs/configuration/index.fr.md
index 6cf74027..de2041d6 100644
--- a/exampleSite/content/docs/configuration/index.fr.md
+++ b/exampleSite/content/docs/configuration/index.fr.md
@@ -3,6 +3,7 @@ title: "Configuration"
weight: 4
draft: false
description: "Toutes les variables de configuration disponibles dans Blowfish."
+featureimage: "images/v3/configuration-system.png"
slug: "configuration"
tags: ["configuration", "documentation"]
series: ["Documentation"]
@@ -13,13 +14,8 @@ Blowfish est un thème hautement personnalisable et utilise certaines des derni
Le thème est livré avec une configuration par défaut qui vous permet de démarrer avec un blog ou un site web statique de base.
-{{< alert "fire" >}}
-Nous venons de lancer un outil CLI pour vous aider à démarrer avec Blowfish. Il vous aidera avec l'installation et la configuration. Installez l'outil CLI globalement en utilisant :
-
-```bash
-npx blowfish-tools
-```
-
+{{< alert "wand-magic-sparkles" >}}
+Vous travaillez avec un agent de codage IA ? Blowfish inclut un **skill pour agents** qui apprend aux agents comme Claude Code à installer, configurer et utiliser le thème — consultez la [page d'installation]({{< ref "docs/installation" >}}) pour le mettre en place.
{{< /alert >}}
> Les fichiers de configuration fournis avec le thème sont au format TOML car c'est la syntaxe Hugo par défaut. N'hésitez pas à convertir votre configuration en YAML ou JSON si vous le souhaitez.
diff --git a/exampleSite/content/docs/configuration/index.it.md b/exampleSite/content/docs/configuration/index.it.md
index 711b32f2..17e398df 100644
--- a/exampleSite/content/docs/configuration/index.it.md
+++ b/exampleSite/content/docs/configuration/index.it.md
@@ -4,6 +4,7 @@ title: "Configurazione"
weight: 4
draft: false
description: "Tutte le configurazioni disponibili in Blowfish."
+featureimage: "images/v3/configuration-system.png"
slug: "configurazioni"
tags: ["config", "docs"]
series: ["Documentazione"]
@@ -14,13 +15,8 @@ Blowfish è un tema altamente personalizzabile e utilizza alcune delle più rece
Il tema viene fornito con una configurazione predefinita che ti consente di essere operativo con un blog di base o un sito Web statico.
-{{< alert "fire" >}}
-We just launched a CLI tool to help you get started with Blowfish. It will help you with installation and configuration. Install the CLI tool globally using:
-
-```bash
-npx blowfish-tools
-```
-
+{{< alert "wand-magic-sparkles" >}}
+Lavori con un agente di programmazione IA? Blowfish include una **skill per agenti** che insegna ad agenti come Claude Code a installare, configurare e usare il tema — consulta la [pagina di installazione]({{< ref "docs/installation" >}}) per configurarla.
{{< /alert >}}
> I file di configurazione forniti con il tema sono forniti in formato TOML dato che questa è la sintassi predefinita di Hugo. Sentiti libero di convertire la tua configurazione in YAML o JSON se lo desideri.
@@ -168,7 +164,7 @@ Many of the article defaults here can be overridden on a per article basis by sp
| Name | Default | Description |
| --- | --- | --- |
-| `colorScheme` | `"blowfish"` | The theme colour scheme to use. Valid values are `blowfish` (default), `avocado`, `fire`, `ocean`, `forest`, `princess`, `neon`, `bloody`, `terminal`, `marvel`, `noir`, `autumn`, `congo`, `slate`, `github`, and `one-light`. Refer to the [Colour Schemes]({{< ref "getting-started#colour-schemes" >}}) section for more details. |
+| `colorScheme` | `"blowfish"` | The theme colour scheme to use. Valid values are `blowfish` (default), `avocado`, `burufugu`, `fire`, `ocean`, `forest`, `princess`, `neon`, `bloody`, `terminal`, `marvel`, `noir`, `autumn`, `congo`, `slate`, `github`, and `one-light`. Refer to the [Colour Schemes]({{< ref "getting-started#colour-schemes" >}}) section for more details. |
| `defaultAppearance` | `"light"` | The default theme appearance, either `light` or `dark`. |
| `autoSwitchAppearance` | `true` | Whether the theme appearance automatically switches based upon the visitor's operating system preference. Set to `false` to force the site to always use the `defaultAppearance`. |
| `enableA11y` | `false` | Whether to enable the accessibility toggle button. |
@@ -184,6 +180,7 @@ Many of the article defaults here can be overridden on a per article basis by sp
| `disableImageOptimizationMD` | `false` | Disables image resize and optimization features only for images using markdown syntax (``). |
| `disableTextInHeader` | `false` | Disables text in header, useful for logo based headers. |
| `defaultBackgroundImage` | _Not set_ | Default background image for both `background` homepage layout and `background` hero style |
+| `backgroundCanvas` | `false` | Quando è `true`, mostra `defaultBackgroundImage` come sfondo fisso a tutto schermo dietro ogni pagina. Le pagine il cui hero disegna già un proprio sfondo fisso (ad esempio lo stile hero `background` con un'immagine in evidenza) sopprimono automaticamente il canvas, e gli hero non ricorrono più a `defaultBackgroundImage` come ripiego, dato che il canvas la mostra già. |
| `defaultFeaturedImage` | _Not set_ | Default background image for all `featured` images across articles, will be overridden by a local `featured` image. |
| `defaultSocialImage` | _Not set_ | Default image for social media sharing (Open Graph and Twitter). Will be overridden by a local `feature` image if available. |
| `hotlinkFeatureImage` | `false` | Hotlink external images in article feature images and article cards. Those images will not be processed by Hugo. |
@@ -197,7 +194,9 @@ Many of the article defaults here can be overridden on a per article basis by sp
| Name | Default | Description |
| --- | --- | --- |
-| `header.layout` | `"basic"` | Defines the header for the entire site, supported values are `basic`, `fixed`, `fixed-fill`, and `fixed-fill-blur`. |
+| `header.layout` | `"basic"` | Defines the header for the entire site, supported values are `basic`, `fixed`, `fixed-fill`, `fixed-fill-blur`, `fixed-gradient`, and `floating`. |
+| `header.mobileMenuStyle` | `"fullscreen"` | Definisce la presentazione del menu mobile. Impostare `"dropdown"` per un menu compatto ancorato sotto l'header. |
+| `list.featureImageHover` | `false` | Aggiunge una leggera transizione di zoom quando il visitatore passa il mouse su una scheda di articolo o di contenuti correlati. Le singole pagine possono sovrascriverla con `featureImageHover` nel front matter. |
### Footer
@@ -213,7 +212,8 @@ Many of the article defaults here can be overridden on a per article basis by sp
| Name | Default | Description |
| --- | --- | --- |
-| `homepage.layout` | `"profile"` | The layout of the homepage. Valid values are `page`, `profile`, `hero`, `card`, `background`, or `custom`. When set to `custom`, you must provide your own layout by creating a `/layouts/partials/home/custom.html` file. Refer to the [Homepage Layout]({{< ref "homepage-layout" >}}) section for more details. |
+| `homepage.layout` | `"profile"` | The layout of the homepage. Valid values are `page`, `profile`, `hero`, `card`, `background`, `landing`, or `custom`. When set to `custom`, you must provide your own layout by creating a `/layouts/partials/home/custom.html` file. Refer to the [Homepage Layout]({{< ref "homepage-layout" >}}) section for more details. |
+| `homepage.layoutSwitcher` | `false` | Mostra un selettore interattivo che consente di visualizzare in anteprima, direttamente nella pagina, i layout integrati della homepage. Pensato per demo e revisioni di design, poiché renderizza tutti i layout in anteprima. |
| `homepage.homepageImage` | _Not set_ | Image to be used in `hero` and `card` layouts. Can be set as local image from asset directory or external image url. Refer to the [Homepage Layout]({{< ref "homepage-layout" >}}) section for more details. |
| `homepage.showRecent` | `false` | Whether or not to display the recent articles list on the homepage. |
| `homepage.showRecentItems` | 5 | How many articles to display if showRecent is true. If variable is set to 0 or if it isn't defined the system will default to 5 articles. |
diff --git a/exampleSite/content/docs/configuration/index.ja.md b/exampleSite/content/docs/configuration/index.ja.md
index 6a5c8f2d..a8586b8b 100644
--- a/exampleSite/content/docs/configuration/index.ja.md
+++ b/exampleSite/content/docs/configuration/index.ja.md
@@ -3,6 +3,7 @@ title: "設定"
weight: 4
draft: false
description: "Blowfish で使えるすべての設定変数"
+featureimage: "images/v3/configuration-system.png"
slug: "configuration"
tags: ["config", "docs"]
series: ["Documentation"]
@@ -13,13 +14,8 @@ Blowfish は高度にカスタマイズ可能なテーマであり、最新の H
このテーマには、基本的なブログまたは静的サイトをすぐに立ち上げて実行できるデフォルト設定が付属しています。
-{{< alert "fire" >}}
-Blowfish を簡単に使い始められるように、新しい CLI ツールをリリースしました。インストールと設定に役立ちます。 グローバルに CLI ツールをインストールするには、以下を使用します。
-
-```bash
-npx blowfish-tools
-```
-
+{{< alert "wand-magic-sparkles" >}}
+AI コーディングエージェントを使っていますか？Blowfish には、Claude Code などのエージェントにテーマのインストール・設定・活用方法を教える**エージェントスキル**が付属しています。セットアップ方法は[インストールページ]({{< ref "docs/installation" >}})をご覧ください。
{{< /alert >}}
> テーマにバンドルされている設定ファイルは、デフォルトの Hugo 構文である TOML 形式で提供されています。必要に応じて、設定を YAML または JSON に変換できます。
@@ -168,7 +164,7 @@ Blowfish は、テーマの機能を制御する多数の設定パラメータ
| 名前 | デフォルト | 説明 |
| --- | --- | --- |
-| `colorScheme` | `"blowfish"` | 使用するテーマのカラースキームです。有効な値は、`blowfish`（デフォルト）、`avocado`、`fire`、`ocean`、`forest`、`princess`、`neon`、`bloody`、`terminal`、`marvel`、`noir`、`autumn`、`congo`、`slate`, `github`, `one-light` です。詳細については、[カラースキーム]({{< ref "getting-started#カラースキーム" >}})セクションを参照してください。 |
+| `colorScheme` | `"blowfish"` | 使用するテーマのカラースキームです。有効な値は、`blowfish`（デフォルト）、`avocado`、`burufugu`、`fire`、`ocean`、`forest`、`princess`、`neon`、`bloody`、`terminal`、`marvel`、`noir`、`autumn`、`congo`、`slate`, `github`, `one-light` です。詳細については、[カラースキーム]({{< ref "getting-started#カラースキーム" >}})セクションを参照してください。 |
| `defaultAppearance` | `"light"` | デフォルトのテーマの外観です。`light` または `dark` のいずれかです。 |
| `autoSwitchAppearance` | `true` | 訪問者のオペレーティングシステムの設定に基づいてテーマの外観を自動的に切り替えるかどうかです。`false` に設定すると、サイトは常に `defaultAppearance` を使用します。 |
| `enableA11y` | `false` | アクセシビリティ切り替えボタンを有効にするかどうか。 |
@@ -184,6 +180,7 @@ Blowfish は、テーマの機能を制御する多数の設定パラメータ
| `disableImageOptimizationMD` | `false` | Markdown 記法（例：``）の画像の画像サイズ変更と最適化機能のみを無効にします。他の画像には適用されます。 |
| `disableTextInHeader` | `false` | ヘッダーのテキストを無効にします。ロゴベースのヘッダーに役立ちます。 |
| `defaultBackgroundImage` | _未設定_ | `background` ホームページレイアウトと `background` ヒーロースタイルの両方のデフォルトの背景画像です。 |
+| `backgroundCanvas` | `false` | `true` に設定すると、`defaultBackgroundImage` をすべてのページの背後に固定のフルビューポート背景として表示します。ヒーローが独自の固定背景を描画するページ（たとえば、アイキャッチ画像を使用した `background` ヒーロースタイル）では、キャンバスは自動的に抑制されます。また、キャンバスがすでに `defaultBackgroundImage` を表示しているため、ヒーローが `defaultBackgroundImage` にフォールバックすることはなくなります。 |
| `defaultFeaturedImage` | _未設定_ | 記事全体のすべての `featured` 画像のデフォルトの背景画像です。ローカルの `featured` 画像によってオーバーライドされます。 |
| `defaultSocialImage` | _未設定_ | ソーシャルメディア共有（Open Graph と Twitter）用のデフォルト画像。ローカルの `featured` 画像によってオーバーライドされます。 |
| `hotlinkFeatureImage` | `false` | 記事のアイキャッチ画像や記事カードで外部画像をホットリンクします。これらの画像は Hugo によって処理されません。 |
@@ -197,7 +194,9 @@ Blowfish は、テーマの機能を制御する多数の設定パラメータ
| 名前 | デフォルト | 説明 |
| --- | --- | --- |
-| `header.layout` | `"basic"` | サイト全体のヘッダーを定義します。サポートされている値は、`basic`、`fixed`、`fixed-fill`、`fixed-fill-blur` です。 |
+| `header.layout` | `"basic"` | サイト全体のヘッダーを定義します。サポートされている値は、`basic`、`fixed`、`fixed-fill`、`fixed-fill-blur`、`fixed-gradient`、`floating` です。 |
+| `header.mobileMenuStyle` | `"fullscreen"` | モバイルメニューの表示方法を定義します。ヘッダーの下に固定されたコンパクトなメニューを表示するには `"dropdown"` に設定します。 |
+| `list.featureImageHover` | `false` | 訪問者が記事カードや関連コンテンツカードにホバーしたときに、控えめなズームのトランジションを追加します。個々のページでは、フロントマターの `featureImageHover` でこれをオーバーライドできます。 |
### フッター(Footer)
@@ -213,7 +212,8 @@ Blowfish は、テーマの機能を制御する多数の設定パラメータ
| 名前 | デフォルト | 説明 |
| --- | --- | --- |
-| `homepage.layout` | `"profile"` | ホームページのレイアウトです。有効な値は、`page`、`profile`、`hero`、`card`、`background`、`custom` です。`custom` に設定した場合、`/layouts/partials/home/custom.html` ファイルを作成して独自のレイアウトを提供する必要があります。詳細については、[ホームページレイアウト]({{< ref "homepage-layout" >}}) セクションを参照してください。 |
+| `homepage.layout` | `"profile"` | ホームページのレイアウトです。有効な値は、`page`、`profile`、`hero`、`card`、`background`、`landing`、`custom` です。`custom` に設定した場合、`/layouts/partials/home/custom.html` ファイルを作成して独自のレイアウトを提供する必要があります。詳細については、[ホームページレイアウト]({{< ref "homepage-layout" >}}) セクションを参照してください。 |
+| `homepage.layoutSwitcher` | `false` | 組み込みのホームページレイアウトをその場でプレビューできるインタラクティブなスイッチャーを表示します。すべてのプレビューレイアウトをレンダリングするため、デモやデザインレビューでの利用を想定しています。 |
| `homepage.homepageImage` | _未設定_ | `hero` レイアウトと `card` レイアウトで使用される画像です。アセットディレクトリからのローカル画像または外部画像 URL として設定できます。詳細については、[ホームページレイアウト]({{< ref "homepage-layout" >}}) セクションを参照してください。 |
| `homepage.showRecent` | `false` | ホームページに最近の記事リストを表示するかどうかです。 |
| `homepage.showRecentItems` | 5 | showRecent が true の場合に表示する記事の数です。変数が0に設定されている場合、または定義されていない場合は、システムはデフォルトで5つの記事に設定されます。 |
diff --git a/exampleSite/content/docs/configuration/index.md b/exampleSite/content/docs/configuration/index.md
index 1d8ccf85..37318d17 100644
--- a/exampleSite/content/docs/configuration/index.md
+++ b/exampleSite/content/docs/configuration/index.md
@@ -14,13 +14,8 @@ Blowfish is a highly customisable theme and uses some of the latest Hugo feature
The theme ships with a default configuration that gets you up and running with a basic blog or static website.
-{{< alert "fire" >}}
-We just launched a CLI tool to help you get started with Blowfish. It will help you with installation and configuration. Install the CLI tool globally using:
-
-```bash
-npx blowfish-tools
-```
-
+{{< alert "wand-magic-sparkles" >}}
+Working with an AI coding agent? Blowfish ships an **agent skill** that teaches agents like Claude Code how to install, configure, and build with the theme — see the [installation page]({{< ref "docs/installation" >}}) to set it up.
{{< /alert >}}
> Configuration files bundled with the theme are provided in TOML format as this is the default Hugo syntax. Feel free to convert your config to YAML or JSON if you wish.
@@ -187,7 +182,7 @@ Many of the article defaults here can be overridden on a per article basis by sp
| Name | Default | Description |
| --- | --- | --- |
-| `colorScheme` | `"blowfish"` | The theme colour scheme to use. Valid values are `blowfish` (default), `avocado`, `fire`, `ocean`, `forest`, `princess`, `neon`, `bloody`, `terminal`, `marvel`, `noir`, `autumn`, `congo`, `slate`, `github`, and `one-light`. Refer to the [Colour Schemes]({{< ref "getting-started#colour-schemes" >}}) section for more details. |
+| `colorScheme` | `"blowfish"` | The theme colour scheme to use. Valid values are `blowfish` (default), `avocado`, `burufugu`, `fire`, `ocean`, `forest`, `princess`, `neon`, `bloody`, `terminal`, `marvel`, `noir`, `autumn`, `congo`, `slate`, `github`, and `one-light`. Refer to the [Colour Schemes]({{< ref "getting-started#colour-schemes" >}}) section for more details. |
| `defaultAppearance` | `"light"` | The default theme appearance, either `light` or `dark`. |
| `autoSwitchAppearance` | `true` | Whether the theme appearance automatically switches based upon the visitor's operating system preference. Set to `false` to force the site to always use the `defaultAppearance`. |
| `enableA11y` | `false` | Whether to enable the accessibility toggle button. |
@@ -209,6 +204,7 @@ Many of the article defaults here can be overridden on a per article basis by sp
| `backgroundImageWidth` | `1200` | Width (in pixels) to scale background images to. |
| `disableTextInHeader` | `false` | Disables text in header, useful for logo based headers. |
| `defaultBackgroundImage` | _Not set_ | Default background image for both `background` homepage layout and `background` hero style |
+| `backgroundCanvas` | `false` | When `true`, renders `defaultBackgroundImage` as a fixed full-viewport backdrop behind every page. Pages whose hero paints its own fixed background (for example the `background` hero style with a feature image) automatically suppress the canvas, and heroes no longer fall back to `defaultBackgroundImage` since the canvas already displays it. |
| `defaultFeaturedImage` | _Not set_ | Default background image for all `featured` images across articles, will be overridden by a local `featured` image. |
| `defaultSocialImage` | _Not set_ | Default image for social media sharing (Open Graph and Twitter). Will be overridden by a local `feature` image. |
| `hotlinkFeatureImage` | `false` | Hotlink external images in article feature images and article cards. Those images will not be processed by Hugo. |
diff --git a/exampleSite/content/docs/configuration/index.pt-br.md b/exampleSite/content/docs/configuration/index.pt-br.md
index ed04b3e4..6f8d3d5a 100644
--- a/exampleSite/content/docs/configuration/index.pt-br.md
+++ b/exampleSite/content/docs/configuration/index.pt-br.md
@@ -3,6 +3,7 @@ title: "Configuração"
weight: 4
draft: false
description: "Todas as variáveis de configuração disponíveis no Blowfish."
+featureimage: "images/v3/configuration-system.png"
slug: "configuration"
tags: ["configuração", "documentação"]
series: ["Documentação"]
@@ -13,13 +14,8 @@ O Blowfish é um tema altamente personalizável e usa alguns dos recursos mais r
O tema vem com uma configuração padrão que permite você começar com um blog básico ou site estático.
-{{< alert "fire" >}}
-Acabamos de lançar uma ferramenta CLI para ajudá-lo a começar com o Blowfish. Ela ajudará com a instalação e configuração. Instale a ferramenta CLI globalmente usando:
-
-```bash
-npx blowfish-tools
-```
-
+{{< alert "wand-magic-sparkles" >}}
+Trabalha com um agente de programação com IA? O Blowfish inclui uma **skill para agentes** que ensina agentes como o Claude Code a instalar, configurar e trabalhar com o tema — veja a [página de instalação]({{< ref "docs/installation" >}}) para configurá-la.
{{< /alert >}}
> Os arquivos de configuração incluídos com o tema são fornecidos no formato TOML, pois é a sintaxe padrão do Hugo. Sinta-se à vontade para converter sua configuração para YAML ou JSON, se desejar.
diff --git a/exampleSite/content/docs/configuration/index.pt-pt.md b/exampleSite/content/docs/configuration/index.pt-pt.md
index c2c749bf..ab6abae3 100644
--- a/exampleSite/content/docs/configuration/index.pt-pt.md
+++ b/exampleSite/content/docs/configuration/index.pt-pt.md
@@ -3,6 +3,7 @@ title: "Configuração"
weight: 4
draft: false
description: "Todas as variáveis de configuração disponíveis no Blowfish."
+featureimage: "images/v3/configuration-system.png"
slug: "configuration"
tags: ["configuração", "documentação"]
series: ["Documentação"]
@@ -13,13 +14,8 @@ O Blowfish é um tema altamente personalizável e utiliza algumas das funcionali
O tema vem com uma configuração predefinida que lhe permite começar com um blogue básico ou site estático.
-{{< alert "fire" >}}
-Acabámos de lançar uma ferramenta CLI para o ajudar a começar com o Blowfish. Irá ajudá-lo com a instalação e configuração. Instale a ferramenta CLI globalmente utilizando:
-
-```bash
-npx blowfish-tools
-```
-
+{{< alert "wand-magic-sparkles" >}}
+Trabalha com um agente de programação com IA? O Blowfish inclui uma **skill para agentes** que ensina agentes como o Claude Code a instalar, configurar e trabalhar com o tema — consulte a [página de instalação]({{< ref "docs/installation" >}}) para a configurar.
{{< /alert >}}
> Os ficheiros de configuração incluídos com o tema são fornecidos no formato TOML, pois é a sintaxe predefinida do Hugo. Sinta-se à vontade para converter a sua configuração para YAML ou JSON, se desejar.
diff --git a/exampleSite/content/docs/configuration/index.zh-cn.md b/exampleSite/content/docs/configuration/index.zh-cn.md
index 1e90e09d..bedc6548 100644
--- a/exampleSite/content/docs/configuration/index.zh-cn.md
+++ b/exampleSite/content/docs/configuration/index.zh-cn.md
@@ -1,5 +1,6 @@
---
title: "配置"
+featureimage: "images/v3/configuration-system.png"
weight: 4
draft: false
description: "介绍 Blowfish 中所有可用的的配置变量。"
@@ -13,13 +14,8 @@ Blowfish 是一个高度定制化的主题，使用到了一些 Hugo 中最新
主题附带了默认配置，可以让你快速启动一个基本的博客或静态网站。
-{{< alert "fire" >}}
-我们刚刚推出了 CLI 工具，来帮助你快速上手 Blowfish。它将帮助你进行安装和配置。使用以下命令可以全局范围安装 CLI 工具：
-
-```bash
-npx blowfish-tools
-```
-
+{{< alert "wand-magic-sparkles" >}}
+在使用 AI 编程智能体？Blowfish 附带一个**智能体技能**，可以教 Claude Code 等智能体如何安装、配置和使用本主题 — 请参阅[安装页面]({{< ref "docs/installation" >}})进行设置。
{{< /alert >}}
> 配置文件是基于 TOML 格式的，这也是 Hugo 默认支持的语法。当然如果你愿意，也可以将配置转换成 YAML 或 JSON 格式。
@@ -168,7 +164,7 @@ Blowfish 提供了大量控制主题功能的配置参数，下面的表格中
| 名称 | 默认值 | 描述 |
| --- | --- | --- |
-| `colorScheme` | `"blowfish"` | 主题使用的颜色方案。合法的值有： `blowfish` （默认）、`avocado`、`fire`、`ocean`、`forest`、`princess`、`neon`、`bloody`、`terminal`、`marvel`、`noir`、`autumn`、`congo`、`slate`、`github` 和 `one-light`。 具体参考[颜色方案]({{< ref "getting-started#colour-schemes" >}})以获取更多信息。 |
+| `colorScheme` | `"blowfish"` | 主题使用的颜色方案。合法的值有： `blowfish` （默认）、`avocado`、`burufugu`、`fire`、`ocean`、`forest`、`princess`、`neon`、`bloody`、`terminal`、`marvel`、`noir`、`autumn`、`congo`、`slate`、`github` 和 `one-light`。 具体参考[颜色方案]({{< ref "getting-started#colour-schemes" >}})以获取更多信息。 |
| `defaultAppearance` | `"light"` | 默认的主题外观，可以是 `light` 或者 `dark`。 |
| `autoSwitchAppearance` | `true` | 主题外观是否根据访问者操作系统的偏好自动切换。设置为 `false` 会强制网站始终使用 `defaultAppearance`。 |
| `enableA11y` | `false` | 是否启用无障碍切换按钮。 |
@@ -188,6 +184,7 @@ Blowfish 提供了大量控制主题功能的配置参数，下面的表格中
| `backgroundImageWidth` | `1200` | 宽度（以像素为单位）用于缩放背景图像。 |
| `disableTextInHeader` | `false` | 禁用文本类型的标题，对基于 logo 的标题很有用。 |
| `defaultBackgroundImage` | 无 | 设置默认背景图，用于 `background` 和 `hero` 布局下的主页。 |
+| `backgroundCanvas` | `false` | 当设置为 `true` 时，将 `defaultBackgroundImage` 渲染为固定的全视口背景，显示在每个页面之后。如果页面的 hero 自身绘制了固定背景（例如使用特色图片的 `background` hero 样式），则会自动隐藏该背景画布；同时 hero 也不再回退使用 `defaultBackgroundImage`，因为背景画布已经显示了它。 |
| `defaultFeaturedImage` | 无 | 设置默认背景图片，用于所有文章的`featured`图片，可以通过文章目录中的 `featured` 图片替换。 |
| `defaultSocialImage` | 无 | 社交媒体分享（Open Graph 和 Twitter）使用的默认图片，可以通过文章目录中的 `featured` 图片替换。 |
| `hotlinkFeatureImage` | `false` | 在文章特色图片和文章卡片中外链图片。这些图片不会被 Hugo 处理。 |
@@ -201,7 +198,9 @@ Blowfish 提供了大量控制主题功能的配置参数，下面的表格中
| 名称 | 默认值 | 描述 |
| --- | --- | --- |
-| `header.layout` | `"basic"` | 定义整个站点的页头的布局，支持的参数有 `basic`、`fixed`、`fixed-fill`、and `fixed-fill-blur`. |
+| `header.layout` | `"basic"` | 定义整个站点的页头的布局，支持的参数有 `basic`、`fixed`、`fixed-fill`、`fixed-fill-blur`、`fixed-gradient` 和 `floating`。 |
+| `header.mobileMenuStyle` | `"fullscreen"` | 定义移动端菜单的展示方式。设置为 `"dropdown"` 可使用锚定在页头下方的紧凑菜单。 |
+| `list.featureImageHover` | `false` | 当访问者将鼠标悬停在文章卡片或相关内容卡片上时，添加轻微的缩放过渡效果。各个页面可以通过扉页参数中的 `featureImageHover` 覆盖此设置。 |
### 页脚
@@ -217,7 +216,8 @@ Blowfish 提供了大量控制主题功能的配置参数，下面的表格中
| 名称 | 默认值 | 描述 |
| --- | --- | --- |
-| `homepage.layout` | `"profile"` | 首页布局参数。合法的参数值有： `page`、`profile`、`hero`、`card`、`background` 或 `custom`。当你设置为 `custom` 时，你必须创建 `/layouts/partials/home/custom.html` 文件以定制自己的布局。参考[主页布局]({{< ref "homepage-layout" >}})来获取更多信息。 |
+| `homepage.layout` | `"profile"` | 首页布局参数。合法的参数值有： `page`、`profile`、`hero`、`card`、`background`、`landing` 或 `custom`。当你设置为 `custom` 时，你必须创建 `/layouts/partials/home/custom.html` 文件以定制自己的布局。参考[主页布局]({{< ref "homepage-layout" >}})来获取更多信息。 |
+| `homepage.layoutSwitcher` | `false` | 为内置的主页布局渲染一个可交互的原位预览切换器。由于它会渲染所有预览布局，主要用于演示和设计评审场景。 |
| `homepage.homepageImage` | 无 | 在 `hero` 和 `card` 布局中使用的图像。图片可以来自于本地的资源目录，也可以是外部图像 URL。参考 [主页布局]({{< ref "homepage-layout" >}}) 来获取更多信息。 |
| `homepage.showRecent` | `false` | 是否在主页展示最新文章列表。 |
| `homepage.showRecentItems` | 5 | 如果将 `showRecent` 设置为 `true`，此参数用于显示多少篇文章。如果没有设置或者为0，则默认显示5篇文章。 |
diff --git a/exampleSite/content/docs/content-examples/index.de.md b/exampleSite/content/docs/content-examples/index.de.md
index 331ca79b..414d0be4 100644
--- a/exampleSite/content/docs/content-examples/index.de.md
+++ b/exampleSite/content/docs/content-examples/index.de.md
@@ -1,5 +1,6 @@
---
title: "Inhaltsbeispiele"
+featureimage: "images/v3/content-examples.png"
weight: 11
draft: false
description: "Alle verfügbaren Partials in Blowfish."
diff --git a/exampleSite/content/docs/content-examples/index.es.md b/exampleSite/content/docs/content-examples/index.es.md
index 0fade0ad..59905aba 100644
--- a/exampleSite/content/docs/content-examples/index.es.md
+++ b/exampleSite/content/docs/content-examples/index.es.md
@@ -1,5 +1,6 @@
---
title: "Ejemplos de contenido"
+featureimage: "images/v3/content-examples.png"
weight: 11
draft: false
description: "Todos los partials disponibles en Blowfish."
diff --git a/exampleSite/content/docs/content-examples/index.fr.md b/exampleSite/content/docs/content-examples/index.fr.md
index 0503685d..c1bcaaac 100644
--- a/exampleSite/content/docs/content-examples/index.fr.md
+++ b/exampleSite/content/docs/content-examples/index.fr.md
@@ -1,5 +1,6 @@
---
title: "Exemples de contenu"
+featureimage: "images/v3/content-examples.png"
weight: 11
draft: false
description: "Tous les partials disponibles dans Blowfish."
diff --git a/exampleSite/content/docs/content-examples/index.it.md b/exampleSite/content/docs/content-examples/index.it.md
index 52d51a05..13aa9644 100644
--- a/exampleSite/content/docs/content-examples/index.it.md
+++ b/exampleSite/content/docs/content-examples/index.it.md
@@ -1,5 +1,6 @@
---
title: "Content Examples"
+featureimage: "images/v3/content-examples.png"
weight: 11
draft: false
description: "All the partials available in Blowfish."
diff --git a/exampleSite/content/docs/content-examples/index.ja.md b/exampleSite/content/docs/content-examples/index.ja.md
index cad99da6..b4e3adc9 100644
--- a/exampleSite/content/docs/content-examples/index.ja.md
+++ b/exampleSite/content/docs/content-examples/index.ja.md
@@ -1,5 +1,6 @@
---
title: "コンテンツの例"
+featureimage: "images/v3/content-examples.png"
weight: 11
draft: false
description: "Blowfish で利用可能なすべてのパーシャル。"
diff --git a/exampleSite/content/docs/content-examples/index.pt-br.md b/exampleSite/content/docs/content-examples/index.pt-br.md
index 56656cdb..2fb9cc48 100644
--- a/exampleSite/content/docs/content-examples/index.pt-br.md
+++ b/exampleSite/content/docs/content-examples/index.pt-br.md
@@ -1,5 +1,6 @@
---
title: "Exemplos de conteúdo"
+featureimage: "images/v3/content-examples.png"
weight: 11
draft: false
description: "Todos os partials disponíveis no Blowfish."
diff --git a/exampleSite/content/docs/content-examples/index.pt-pt.md b/exampleSite/content/docs/content-examples/index.pt-pt.md
index c80c9e8e..852abd1c 100644
--- a/exampleSite/content/docs/content-examples/index.pt-pt.md
+++ b/exampleSite/content/docs/content-examples/index.pt-pt.md
@@ -1,5 +1,6 @@
---
title: "Exemplos de conteúdo"
+featureimage: "images/v3/content-examples.png"
weight: 11
draft: false
description: "Todos os partials disponíveis no Blowfish."
diff --git a/exampleSite/content/docs/content-examples/index.zh-cn.md b/exampleSite/content/docs/content-examples/index.zh-cn.md
index ac4dddcf..575ac5fc 100644
--- a/exampleSite/content/docs/content-examples/index.zh-cn.md
+++ b/exampleSite/content/docs/content-examples/index.zh-cn.md
@@ -1,5 +1,6 @@
---
title: "内容示例"
+featureimage: "images/v3/content-examples.png"
weight: 11
draft: false
description: "包含 Blowfish 中所有可用部分的示例、"
diff --git a/exampleSite/content/docs/firebase-views/index.de.md b/exampleSite/content/docs/firebase-views/index.de.md
index dbaf8118..ea7e536d 100644
--- a/exampleSite/content/docs/firebase-views/index.de.md
+++ b/exampleSite/content/docs/firebase-views/index.de.md
@@ -1,5 +1,6 @@
---
title: "Firebase: Aufrufe & Likes"
+featureimage: "images/v3/content-network.png"
weight: 15
draft: false
description: "Erfahren Sie, wie Sie Firebase integrieren und dynamische Daten für Aufrufe und Likes erhalten."
diff --git a/exampleSite/content/docs/firebase-views/index.es.md b/exampleSite/content/docs/firebase-views/index.es.md
index a1748fb3..3e21d265 100644
--- a/exampleSite/content/docs/firebase-views/index.es.md
+++ b/exampleSite/content/docs/firebase-views/index.es.md
@@ -1,5 +1,6 @@
---
title: "Firebase: Vistas & Likes"
+featureimage: "images/v3/content-network.png"
weight: 15
draft: false
description: "Aprende cómo integrar Firebase y obtener datos dinámicos para vistas y likes."
diff --git a/exampleSite/content/docs/firebase-views/index.fr.md b/exampleSite/content/docs/firebase-views/index.fr.md
index 2beea913..d92a015c 100644
--- a/exampleSite/content/docs/firebase-views/index.fr.md
+++ b/exampleSite/content/docs/firebase-views/index.fr.md
@@ -1,5 +1,6 @@
---
title: "Firebase : Vues & Likes"
+featureimage: "images/v3/content-network.png"
weight: 15
draft: false
description: "Apprenez à intégrer Firebase et obtenir des données dynamiques pour les vues et les likes."
diff --git a/exampleSite/content/docs/firebase-views/index.it.md b/exampleSite/content/docs/firebase-views/index.it.md
index f11745d5..3a117cca 100644
--- a/exampleSite/content/docs/firebase-views/index.it.md
+++ b/exampleSite/content/docs/firebase-views/index.it.md
@@ -1,5 +1,6 @@
---
title: "Firebase: Views & Likes"
+featureimage: "images/v3/content-network.png"
weight: 15
draft: false
description: "Learn how to integrate Firebase and get dynamic data for views and likes."
diff --git a/exampleSite/content/docs/firebase-views/index.ja.md b/exampleSite/content/docs/firebase-views/index.ja.md
index f30569f2..90a2b644 100644
--- a/exampleSite/content/docs/firebase-views/index.ja.md
+++ b/exampleSite/content/docs/firebase-views/index.ja.md
@@ -1,5 +1,6 @@
---
title: "Firebase: 閲覧数といいね"
+featureimage: "images/v3/content-network.png"
weight: 15
draft: false
description: "Firebase を統合して、閲覧数といいねの動的データを取得する方法を学びます。"
diff --git a/exampleSite/content/docs/firebase-views/index.pt-br.md b/exampleSite/content/docs/firebase-views/index.pt-br.md
index 6f97c8db..7cd875fb 100644
--- a/exampleSite/content/docs/firebase-views/index.pt-br.md
+++ b/exampleSite/content/docs/firebase-views/index.pt-br.md
@@ -1,5 +1,6 @@
---
title: "Firebase: Visualizações & Curtidas"
+featureimage: "images/v3/content-network.png"
weight: 15
draft: false
description: "Aprenda como integrar o Firebase e obter dados dinâmicos para visualizações e curtidas."
diff --git a/exampleSite/content/docs/firebase-views/index.pt-pt.md b/exampleSite/content/docs/firebase-views/index.pt-pt.md
index 59c00ddb..03173df1 100644
--- a/exampleSite/content/docs/firebase-views/index.pt-pt.md
+++ b/exampleSite/content/docs/firebase-views/index.pt-pt.md
@@ -1,5 +1,6 @@
---
title: "Firebase: Visualizações & Gostos"
+featureimage: "images/v3/content-network.png"
weight: 15
draft: false
description: "Aprenda como integrar o Firebase e obter dados dinâmicos para visualizações e gostos."
diff --git a/exampleSite/content/docs/firebase-views/index.zh-cn.md b/exampleSite/content/docs/firebase-views/index.zh-cn.md
index 88af4d85..f04664a4 100644
--- a/exampleSite/content/docs/firebase-views/index.zh-cn.md
+++ b/exampleSite/content/docs/firebase-views/index.zh-cn.md
@@ -1,5 +1,6 @@
---
title: "Firebase: 阅读量 & 点赞量"
+featureimage: "images/v3/content-network.png"
weight: 15
draft: false
description: "了解 Blowfish 如何集成 Firebase，并动态显示阅读量和点赞量。"
diff --git a/exampleSite/content/docs/front-matter/index.de.md b/exampleSite/content/docs/front-matter/index.de.md
index 41d04c82..560b0233 100644
--- a/exampleSite/content/docs/front-matter/index.de.md
+++ b/exampleSite/content/docs/front-matter/index.de.md
@@ -1,5 +1,6 @@
---
title: "Front Matter"
+featureimage: "images/v3/front-matter.png"
weight: 7
draft: false
description: "Alle in Blowfish verfügbaren Front-Matter-Variablen."
diff --git a/exampleSite/content/docs/front-matter/index.es.md b/exampleSite/content/docs/front-matter/index.es.md
index b2e08f73..c52d32f2 100644
--- a/exampleSite/content/docs/front-matter/index.es.md
+++ b/exampleSite/content/docs/front-matter/index.es.md
@@ -1,5 +1,6 @@
---
title: "Front Matter"
+featureimage: "images/v3/front-matter.png"
weight: 7
draft: false
description: "Todas las variables de front matter disponibles en Blowfish."
diff --git a/exampleSite/content/docs/front-matter/index.fr.md b/exampleSite/content/docs/front-matter/index.fr.md
index 0fd12be5..710739d7 100644
--- a/exampleSite/content/docs/front-matter/index.fr.md
+++ b/exampleSite/content/docs/front-matter/index.fr.md
@@ -1,5 +1,6 @@
---
title: "Front Matter"
+featureimage: "images/v3/front-matter.png"
weight: 7
draft: false
description: "Toutes les variables front matter disponibles dans Blowfish."
diff --git a/exampleSite/content/docs/front-matter/index.it.md b/exampleSite/content/docs/front-matter/index.it.md
index a6b64b53..ad6e7d7d 100644
--- a/exampleSite/content/docs/front-matter/index.it.md
+++ b/exampleSite/content/docs/front-matter/index.it.md
@@ -1,5 +1,6 @@
---
title: "Front Matter"
+featureimage: "images/v3/front-matter.png"
weight: 7
draft: false
description: "Tutte le variabili in primo piano disponibili in Blowfish."
diff --git a/exampleSite/content/docs/front-matter/index.ja.md b/exampleSite/content/docs/front-matter/index.ja.md
index 3673c150..0c99d494 100644
--- a/exampleSite/content/docs/front-matter/index.ja.md
+++ b/exampleSite/content/docs/front-matter/index.ja.md
@@ -1,5 +1,6 @@
---
title: "フロントマター"
+featureimage: "images/v3/front-matter.png"
weight: 7
draft: false
description: "Blowfish で利用可能なすべてのフロントマター変数。"
diff --git a/exampleSite/content/docs/front-matter/index.pt-br.md b/exampleSite/content/docs/front-matter/index.pt-br.md
index 9cf75038..1dfa1398 100644
--- a/exampleSite/content/docs/front-matter/index.pt-br.md
+++ b/exampleSite/content/docs/front-matter/index.pt-br.md
@@ -1,5 +1,6 @@
---
title: "Front Matter"
+featureimage: "images/v3/front-matter.png"
weight: 7
draft: false
description: "Todas as variáveis de front matter disponíveis no Blowfish."
diff --git a/exampleSite/content/docs/front-matter/index.pt-pt.md b/exampleSite/content/docs/front-matter/index.pt-pt.md
index b2b5ac86..f50a3702 100644
--- a/exampleSite/content/docs/front-matter/index.pt-pt.md
+++ b/exampleSite/content/docs/front-matter/index.pt-pt.md
@@ -1,5 +1,6 @@
---
title: "Front Matter"
+featureimage: "images/v3/front-matter.png"
weight: 7
draft: false
description: "Todas as variáveis de front matter disponíveis no Blowfish."
diff --git a/exampleSite/content/docs/front-matter/index.zh-cn.md b/exampleSite/content/docs/front-matter/index.zh-cn.md
index bbb12bac..122dafdd 100644
--- a/exampleSite/content/docs/front-matter/index.zh-cn.md
+++ b/exampleSite/content/docs/front-matter/index.zh-cn.md
@@ -1,5 +1,6 @@
---
title: "Front Matter(文件头信息)"
+featureimage: "images/v3/front-matter.png"
weight: 7
draft: false
description: "文本主要介绍 Blowfish 中页面中可以添加的所有的 Front Matter 参数。"
diff --git a/exampleSite/content/docs/getting-started/index.de.md b/exampleSite/content/docs/getting-started/index.de.md
index a3df7b68..9b304683 100644
--- a/exampleSite/content/docs/getting-started/index.de.md
+++ b/exampleSite/content/docs/getting-started/index.de.md
@@ -13,12 +13,8 @@ series_order: 3
Dieser Abschnitt setzt voraus, dass Sie das [Blowfish-Theme bereits installiert]({{< ref "docs/installation" >}}) haben.
{{< /alert >}}
-
-{{< alert "fire" >}}
-Wir haben gerade ein CLI-Tool veröffentlicht, das Ihnen beim Einstieg mit Blowfish hilft. Es unterstützt Sie bei Installation und Konfiguration. Installieren Sie das CLI-Tool global mit:
-```bash
-npx blowfish-tools
-```
+{{< alert "wand-magic-sparkles" >}}
+Arbeitest du mit einem KI-Coding-Agent? Blowfish enthält einen **Agent-Skill**, der Agents wie Claude Code beibringt, das Theme zu installieren, zu konfigurieren und damit zu arbeiten — die Einrichtung ist auf der [Installationsseite]({{< ref "docs/installation" >}}) beschrieben.
{{< /alert >}}
Die mit Blowfish gelieferten Konfigurationsdateien enthalten alle möglichen Einstellungen, die das Theme erkennt. Standardmäßig sind viele davon auskommentiert, aber Sie können sie einfach einkommentieren, um eine bestimmte Funktion zu aktivieren oder zu ändern.
diff --git a/exampleSite/content/docs/getting-started/index.es.md b/exampleSite/content/docs/getting-started/index.es.md
index 67172631..b29d3ad3 100644
--- a/exampleSite/content/docs/getting-started/index.es.md
+++ b/exampleSite/content/docs/getting-started/index.es.md
@@ -13,12 +13,8 @@ series_order: 3
Esta sección asume que ya has [instalado el tema Blowfish]({{< ref "docs/installation" >}}).
{{< /alert >}}
-
-{{< alert "fire" >}}
-Acabamos de lanzar una herramienta CLI para ayudarte a empezar con Blowfish. Te ayudará con la instalación y configuración. Instala la herramienta CLI globalmente usando:
-```bash
-npx blowfish-tools
-```
+{{< alert "wand-magic-sparkles" >}}
+¿Trabajas con un agente de programación con IA? Blowfish incluye un **skill para agentes** que enseña a agentes como Claude Code a instalar, configurar y trabajar con el tema — consulta la [página de instalación]({{< ref "docs/installation" >}}) para configurarlo.
{{< /alert >}}
Los archivos de configuración que vienen con Blowfish contienen todas las configuraciones posibles que el tema reconoce. Por defecto, muchas de estas están comentadas, pero puedes simplemente descomentarlas para activar o cambiar una característica específica.
diff --git a/exampleSite/content/docs/getting-started/index.fr.md b/exampleSite/content/docs/getting-started/index.fr.md
index 62f14640..cd2f38b3 100644
--- a/exampleSite/content/docs/getting-started/index.fr.md
+++ b/exampleSite/content/docs/getting-started/index.fr.md
@@ -13,12 +13,8 @@ series_order: 3
Cette section suppose que vous avez déjà [installé le thème Blowfish]({{< ref "docs/installation" >}}).
{{< /alert >}}
-
-{{< alert "fire" >}}
-Nous venons de lancer un outil CLI pour vous aider à démarrer avec Blowfish. Il vous aidera avec l'installation et la configuration. Installez l'outil CLI globalement en utilisant :
-```bash
-npx blowfish-tools
-```
+{{< alert "wand-magic-sparkles" >}}
+Vous travaillez avec un agent de codage IA ? Blowfish inclut un **skill pour agents** qui apprend aux agents comme Claude Code à installer, configurer et utiliser le thème — consultez la [page d'installation]({{< ref "docs/installation" >}}) pour le mettre en place.
{{< /alert >}}
Les fichiers de configuration livrés avec Blowfish contiennent tous les paramètres possibles que le thème reconnaît. Par défaut, beaucoup d'entre eux sont commentés, mais vous pouvez simplement les décommenter pour activer ou modifier une fonctionnalité spécifique.
diff --git a/exampleSite/content/docs/getting-started/index.it.md b/exampleSite/content/docs/getting-started/index.it.md
index b0fae2ca..4d59a4db 100644
--- a/exampleSite/content/docs/getting-started/index.it.md
+++ b/exampleSite/content/docs/getting-started/index.it.md
@@ -13,12 +13,8 @@ series_order: 3
Questa sezione presuppone che tu abbia già [installato il tema Blowfish]({{< ref "docs/installation" >}}).
{{< /alert >}}
-
-{{< alert "fire" >}}
-Abbiamo appena lanciato uno strumento CLI per aiutarvi a iniziare con Blowfish. Vi aiuterà con l'installazione e la configurazione. Installate lo strumento CLI a livello globale utilizzando:
-```bash
-npx blowfish-tools
-```
+{{< alert "wand-magic-sparkles" >}}
+Lavori con un agente di programmazione IA? Blowfish include una **skill per agenti** che insegna ad agenti come Claude Code a installare, configurare e usare il tema — consulta la [pagina di installazione]({{< ref "docs/installation" >}}) per configurarla.
{{< /alert >}}
I file di configurazione forniti con Blowfish contengono tutte le possibili impostazioni riconosciute dal tema. Per impostazione predefinita, molti di questi sono commentati ma puoi semplicemente decommentarli per attivare o modificare una funzionalità specifica.
diff --git a/exampleSite/content/docs/getting-started/index.ja.md b/exampleSite/content/docs/getting-started/index.ja.md
index f2546e31..755c9a00 100644
--- a/exampleSite/content/docs/getting-started/index.ja.md
+++ b/exampleSite/content/docs/getting-started/index.ja.md
@@ -13,12 +13,8 @@ series_order: 3
このセクションでは、[Blowfish テーマをすでにインストールしている]({{< ref "docs/installation" >}})ことを前提としています。
{{< /alert >}}
-
-{{< alert "fire" >}}
-Blowfish の使用開始を支援する CLI ツールをリリースしました。インストールと設定に役立ちます。次のコマンドで CLI ツールをグローバルにインストールします。
-```bash
-npx blowfish-tools
-```
+{{< alert "wand-magic-sparkles" >}}
+AI コーディングエージェントを使っていますか？Blowfish には、Claude Code などのエージェントにテーマのインストール・設定・活用方法を教える**エージェントスキル**が付属しています。セットアップ方法は[インストールページ]({{< ref "docs/installation" >}})をご覧ください。
{{< /alert >}}
Blowfish に同梱されている設定ファイルには、テーマが認識できるすべての設定が含まれています。デフォルトでは、これらの多くはコメントアウトされていますが、コメントを解除するだけで特定の機能を有効化または変更できます。
diff --git a/exampleSite/content/docs/getting-started/index.md b/exampleSite/content/docs/getting-started/index.md
index ed234311..7ff01b78 100644
--- a/exampleSite/content/docs/getting-started/index.md
+++ b/exampleSite/content/docs/getting-started/index.md
@@ -14,12 +14,8 @@ series_order: 3
This section assumes you have already [installed the Blowfish theme]({{< ref "docs/installation" >}}).
{{< /alert >}}
-
-{{< alert "fire" >}}
-We just launched a CLI tool to help you get started with Blowfish. It will help you with installation and configuration. Install the CLI tool globally using:
-```bash
-npx blowfish-tools
-```
+{{< alert "wand-magic-sparkles" >}}
+Working with an AI coding agent? Blowfish ships an **agent skill** that teaches agents like Claude Code how to install, configure, and build with the theme — see the [installation page]({{< ref "docs/installation" >}}) to set it up.
{{< /alert >}}
The config files that ship with Blowfish contain all of the possible settings that the theme recognises. By default, many of these are commented out but you can simply uncomment them to activate or change a specific feature.
diff --git a/exampleSite/content/docs/getting-started/index.pt-br.md b/exampleSite/content/docs/getting-started/index.pt-br.md
index d537c25a..816b93c6 100644
--- a/exampleSite/content/docs/getting-started/index.pt-br.md
+++ b/exampleSite/content/docs/getting-started/index.pt-br.md
@@ -13,12 +13,8 @@ series_order: 3
Esta seção assume que você já [instalou o tema Blowfish]({{< ref "docs/installation" >}}).
{{< /alert >}}
-
-{{< alert "fire" >}}
-Acabamos de lançar uma ferramenta CLI para ajudá-lo a começar com o Blowfish. Ela ajudará com a instalação e configuração. Instale a ferramenta CLI globalmente usando:
-```bash
-npx blowfish-tools
-```
+{{< alert "wand-magic-sparkles" >}}
+Trabalha com um agente de programação com IA? O Blowfish inclui uma **skill para agentes** que ensina agentes como o Claude Code a instalar, configurar e trabalhar com o tema — veja a [página de instalação]({{< ref "docs/installation" >}}) para configurá-la.
{{< /alert >}}
Os arquivos de configuração que acompanham o Blowfish contêm todas as configurações possíveis que o tema reconhece. Por padrão, muitas delas estão comentadas, mas você pode simplesmente descomentá-las para ativar ou alterar uma funcionalidade específica.
diff --git a/exampleSite/content/docs/getting-started/index.pt-pt.md b/exampleSite/content/docs/getting-started/index.pt-pt.md
index 2f52f878..3ad10e49 100644
--- a/exampleSite/content/docs/getting-started/index.pt-pt.md
+++ b/exampleSite/content/docs/getting-started/index.pt-pt.md
@@ -13,12 +13,8 @@ series_order: 3
Esta secção assume que já [instalou o tema Blowfish]({{< ref "docs/installation" >}}).
{{< /alert >}}
-
-{{< alert "fire" >}}
-Acabámos de lançar uma ferramenta CLI para o ajudar a começar com o Blowfish. Irá ajudá-lo com a instalação e configuração. Instale a ferramenta CLI globalmente utilizando:
-```bash
-npx blowfish-tools
-```
+{{< alert "wand-magic-sparkles" >}}
+Trabalha com um agente de programação com IA? O Blowfish inclui uma **skill para agentes** que ensina agentes como o Claude Code a instalar, configurar e trabalhar com o tema — consulte a [página de instalação]({{< ref "docs/installation" >}}) para a configurar.
{{< /alert >}}
Os ficheiros de configuração que acompanham o Blowfish contêm todas as definições possíveis que o tema reconhece. Por defeito, muitas delas estão comentadas, mas pode simplesmente descomentá-las para ativar ou alterar uma funcionalidade específica.
diff --git a/exampleSite/content/docs/getting-started/index.zh-cn.md b/exampleSite/content/docs/getting-started/index.zh-cn.md
index 6a506c65..142a3c1f 100644
--- a/exampleSite/content/docs/getting-started/index.zh-cn.md
+++ b/exampleSite/content/docs/getting-started/index.zh-cn.md
@@ -13,12 +13,8 @@ series_order: 3
本节内容需要已经阅读了 [安装 Blowfish 主题]({{< ref "docs/installation" >}})。
{{< /alert >}}
-
-{{< alert "fire" >}}
-我们刚刚推出了一个 CLI 工具，用来帮助你快速开始 Blowfish。 它将帮助你安装和配置 Blowfish 主题。 可以使用以下命令全局安装 CLI 工具：
-```bash
-npx blowfish-tools
-```
+{{< alert "wand-magic-sparkles" >}}
+在使用 AI 编程智能体？Blowfish 附带一个**智能体技能**，可以教 Claude Code 等智能体如何安装、配置和使用本主题 — 请参阅[安装页面]({{< ref "docs/installation" >}})进行设置。
{{< /alert >}}
Blowfish 中的配置文件中包含了主题需要的所有可能的设置选项。但默认情况下大多数设置都是被注释的，你只需要取消注释就可以激活或者修改设定选项。
diff --git a/exampleSite/content/docs/homepage-layout/img/home-background.png b/exampleSite/content/docs/homepage-layout/img/home-background.png
index c9f7d4d5..69b9b95e 100644
Binary files a/exampleSite/content/docs/homepage-layout/img/home-background.png and b/exampleSite/content/docs/homepage-layout/img/home-background.png differ
diff --git a/exampleSite/content/docs/homepage-layout/img/home-card.png b/exampleSite/content/docs/homepage-layout/img/home-card.png
index 946d6ae5..d9a8aa10 100644
Binary files a/exampleSite/content/docs/homepage-layout/img/home-card.png and b/exampleSite/content/docs/homepage-layout/img/home-card.png differ
diff --git a/exampleSite/content/docs/homepage-layout/img/home-hero.png b/exampleSite/content/docs/homepage-layout/img/home-hero.png
index 19347813..9a0b4f12 100644
Binary files a/exampleSite/content/docs/homepage-layout/img/home-hero.png and b/exampleSite/content/docs/homepage-layout/img/home-hero.png differ
diff --git a/exampleSite/content/docs/homepage-layout/img/home-landing.png b/exampleSite/content/docs/homepage-layout/img/home-landing.png
new file mode 100644
index 00000000..b5d18728
Binary files /dev/null and b/exampleSite/content/docs/homepage-layout/img/home-landing.png differ
diff --git a/exampleSite/content/docs/homepage-layout/img/home-page.png b/exampleSite/content/docs/homepage-layout/img/home-page.png
index ab87fa53..ecc834d6 100644
Binary files a/exampleSite/content/docs/homepage-layout/img/home-page.png and b/exampleSite/content/docs/homepage-layout/img/home-page.png differ
diff --git a/exampleSite/content/docs/homepage-layout/img/home-profile.png b/exampleSite/content/docs/homepage-layout/img/home-profile.png
index c32eceeb..5b52add0 100644
Binary files a/exampleSite/content/docs/homepage-layout/img/home-profile.png and b/exampleSite/content/docs/homepage-layout/img/home-profile.png differ
diff --git a/exampleSite/content/docs/homepage-layout/index.de.md b/exampleSite/content/docs/homepage-layout/index.de.md
index a8e18ff5..52268404 100644
--- a/exampleSite/content/docs/homepage-layout/index.de.md
+++ b/exampleSite/content/docs/homepage-layout/index.de.md
@@ -1,5 +1,6 @@
---
title: "Homepage-Layout"
+featureimage: "images/v3/homepage-layout.png"
weight: 5
draft: false
description: "Konfiguration des Homepage-Layouts im Blowfish-Theme."
@@ -9,7 +10,7 @@ series: ["Dokumentation"]
series_order: 5
---
-Blowfish bietet ein vollständig flexibles Homepage-Layout. Es gibt zwei Hauptvorlagen zur Auswahl mit zusätzlichen Einstellungen zur Anpassung des Designs. Alternativ können Sie auch Ihre eigene Vorlage bereitstellen und die vollständige Kontrolle über den Homepage-Inhalt haben.
+Blowfish bietet flexible Homepage-Layouts mit Einstellungen zur Anpassung jedes Designs. Alternativ können Sie auch Ihre eigene Vorlage bereitstellen und die vollständige Kontrolle über den Homepage-Inhalt haben.
Das Layout der Homepage wird durch die Einstellung `homepage.layout` in der Konfigurationsdatei `params.toml` gesteuert. Zusätzlich haben alle Layouts die Option, eine Liste der [neuesten Artikel](#neueste-artikel) einzuschließen.
@@ -57,6 +58,38 @@ Das Card-Layout ist eine Erweiterung des Seiten-Layouts. Es bietet das gleiche M
Um das Card-Layout zu aktivieren, setzen Sie `homepage.layout = "card"` und `homepage.homepageImage` in der Konfigurationsdatei `params.toml`.
+## Landing-Layout
+
+Das Landing-Layout ist für Produkt-Websites, Dokumentations-Hubs und persönliche Websites gedacht, die ein stärkeres Eröffnungsstatement benötigen. Es beginnt mit einem großzügigen, redaktionellen Hero — Eyebrow, prägnante Headline, Lead-Absatz und Call-to-Action-Buttons — optional hinterlegt mit einem Hero-Bild in voller Breite, das in den globalen Hintergrund übergeht, mit einer gestaffelten Eingangsanimation, die für Besucher mit reduzierter Bewegungspräferenz automatisch deaktiviert wird. Alles unterhalb des Heros ist Standard-Markdown mit Blowfish-Shortcodes, sodass die gesamte Seite portabel und einfach zu pflegen bleibt.
+
+{{< figure src="img/home-landing.png" class="thumbnailshadow" >}}
+
+Um das Landing-Layout zu aktivieren, setzen Sie `homepage.layout = "landing"` in der Konfigurationsdatei `params.toml`.
+
+Der Hero wird über das Front Matter von `content/_index.md` gesteuert. Alle Felder sind optional — alles, was Sie weglassen, wird einfach nicht gerendert:
+
+```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 | Beschreibung |
+| ------------ | ----------- |
+| `heroCaption` | Kleiner Eyebrow-Text in Großbuchstaben über dem Titel. Standardmäßig `params.Author.name`. |
+| `heroLead` | Lead-Absatz, der unter dem Titel gerendert wird. Unterstützt Markdown. |
+| `heroButtons` | Liste von Call-to-Action-Buttons (`label`, `url` und optional `style`). Verwendet dasselbe Styling wie der [`cta`-Shortcode]({{< ref "shortcodes#cta-button" >}}). |
+
+Der Markdown-Inhalt von `_index.md` wird unterhalb des Heros gerendert, sodass Statistiken, Feature-Grids, Schritte und beliebige andere Shortcodes den Rest der Seite gestalten können. Das Landing-Layout passt gut zur websiteweiten Option `backgroundCanvas`, die in der [Konfigurations-Dokumentation]({{< ref "configuration" >}}) beschrieben wird.
+
## Benutzerdefiniertes Layout
@@ -68,7 +101,7 @@ Nachdem der Konfigurationswert gesetzt ist, erstellen Sie eine neue Datei `custo
Um [neueste Artikel](#neueste-artikel) im benutzerdefinierten Layout einzuschließen, verwenden Sie das Partial `recent-articles/main.html`.
-Als Beispiel verwendet die [Homepage]({{< ref "/" >}}) auf dieser Website das benutzerdefinierte Layout, um zwischen dem Profil- und Seiten-Layout zu wechseln. Besuchen Sie das [GitHub-Repository](https://github.com/nunocoracao/blowfish/blob/main/exampleSite/layouts/partials/home/custom.html), um zu sehen, wie es funktioniert.
+Die mitgelieferte Beispiel-Website verwendet das integrierte Landing-Layout und Standard-Inhalts-Shortcodes. Besuchen Sie das [GitHub-Repository](https://github.com/nunocoracao/blowfish/tree/main/exampleSite), um zu sehen, wie sie konfiguriert ist.
## Neueste Artikel
diff --git a/exampleSite/content/docs/homepage-layout/index.es.md b/exampleSite/content/docs/homepage-layout/index.es.md
index 83974bac..664932cf 100644
--- a/exampleSite/content/docs/homepage-layout/index.es.md
+++ b/exampleSite/content/docs/homepage-layout/index.es.md
@@ -1,5 +1,6 @@
---
title: "Diseño de página de inicio"
+featureimage: "images/v3/homepage-layout.png"
weight: 5
draft: false
description: "Configuración del diseño de la página de inicio en el tema Blowfish."
@@ -9,7 +10,7 @@ series: ["Documentación"]
series_order: 5
---
-Blowfish proporciona un diseño de página de inicio totalmente flexible. Hay dos plantillas principales para elegir con configuraciones adicionales para ajustar el diseño. Alternativamente, también puedes proporcionar tu propia plantilla y tener control total sobre el contenido de la página de inicio.
+Blowfish proporciona diseños de página de inicio flexibles con configuraciones para ajustar cada diseño. Alternativamente, también puedes proporcionar tu propia plantilla y tener control total sobre el contenido de la página de inicio.
El diseño de la página de inicio está controlado por la configuración `homepage.layout` en el archivo de configuración `params.toml`. Además, todos los diseños tienen la opción de incluir una lista de [artículos recientes](#artículos-recientes).
@@ -57,6 +58,38 @@ El diseño de tarjeta es una extensión del diseño de página. Proporciona el m
Para habilitar el diseño Tarjeta, establece `homepage.layout = "card"` y `homepage.homepageImage` en el archivo de configuración `params.toml`.
+## Diseño Landing
+
+El diseño Landing está pensado para sitios de producto, centros de documentación y sitios personales que necesitan una declaración de apertura más contundente. Se abre con un hero espacioso y editorial — eyebrow, titular destacado, párrafo introductorio y botones de llamada a la acción — opcionalmente respaldado por una imagen hero de ancho completo que se funde con el fondo global, con una animación de entrada escalonada que se desactiva automáticamente para los visitantes que prefieren el movimiento reducido. Todo lo que está debajo del hero es Markdown estándar y shortcodes de Blowfish, de modo que la página completa sigue siendo portátil y fácil de mantener.
+
+{{< figure src="img/home-landing.png" class="thumbnailshadow" >}}
+
+Para habilitar el diseño Landing, establece `homepage.layout = "landing"` en el archivo de configuración `params.toml`.
+
+El hero se controla mediante el front matter de `content/_index.md`. Todos los campos son opcionales — todo lo que omitas simplemente no se renderiza:
+
+```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 | Descripción |
+| ------------ | ----------- |
+| `heroCaption` | Pequeño eyebrow en mayúsculas encima del título. Por defecto usa `params.Author.name`. |
+| `heroLead` | Párrafo introductorio renderizado bajo el título. Admite Markdown. |
+| `heroButtons` | Lista de botones de llamada a la acción (`label`, `url` y `style` opcional). Usa el mismo estilo que el [shortcode `cta`]({{< ref "shortcodes#cta-button" >}}). |
+
+El cuerpo Markdown de `_index.md` se renderiza debajo del hero, de modo que estadísticas, cuadrículas de características, pasos y cualquier otro shortcode pueden construir el resto de la página. El diseño Landing combina bien con la opción `backgroundCanvas` de todo el sitio descrita en la [documentación de configuración]({{< ref "configuration" >}}).
+
## Diseño personalizado
@@ -68,7 +101,7 @@ Con el valor de configuración establecido, crea un nuevo archivo `custom.html`
Para incluir [artículos recientes](#artículos-recientes) en el diseño personalizado, usa el partial `recent-articles/main.html`.
-Como ejemplo, la [página de inicio]({{< ref "/" >}}) de este sitio usa el diseño personalizado para permitir alternar entre los diseños de perfil y página. Visita el [repositorio de GitHub](https://github.com/nunocoracao/blowfish/blob/main/exampleSite/layouts/partials/home/custom.html) para ver cómo funciona.
+El sitio de ejemplo incluido usa el diseño Landing integrado y shortcodes de contenido estándar. Visita el [repositorio de GitHub](https://github.com/nunocoracao/blowfish/tree/main/exampleSite) para ver cómo está configurado.
## Artículos recientes
diff --git a/exampleSite/content/docs/homepage-layout/index.fr.md b/exampleSite/content/docs/homepage-layout/index.fr.md
index d05b978f..4af6adf4 100644
--- a/exampleSite/content/docs/homepage-layout/index.fr.md
+++ b/exampleSite/content/docs/homepage-layout/index.fr.md
@@ -1,5 +1,6 @@
---
title: "Mise en page de la page d'accueil"
+featureimage: "images/v3/homepage-layout.png"
weight: 5
draft: false
description: "Configuration de la mise en page de la page d'accueil dans le thème Blowfish."
@@ -9,7 +10,7 @@ series: ["Documentation"]
series_order: 5
---
-Blowfish offre une mise en page de page d'accueil entièrement flexible. Il y a deux modèles principaux à choisir avec des paramètres supplémentaires pour ajuster le design. Alternativement, vous pouvez également fournir votre propre modèle et avoir un contrôle total sur le contenu de la page d'accueil.
+Blowfish offre des mises en page de page d'accueil flexibles avec des paramètres pour ajuster chaque design. Alternativement, vous pouvez également fournir votre propre modèle et avoir un contrôle total sur le contenu de la page d'accueil.
La mise en page de la page d'accueil est contrôlée par le paramètre `homepage.layout` dans le fichier de configuration `params.toml`. De plus, toutes les mises en page ont l'option d'inclure une liste des [articles récents](#articles-récents).
@@ -57,6 +58,38 @@ La mise en page carte est une extension de la mise en page page. Elle offre le m
Pour activer la mise en page Carte, définissez `homepage.layout = "card"` et `homepage.homepageImage` dans le fichier de configuration `params.toml`.
+## Mise en page Landing
+
+La mise en page Landing est conçue pour les sites de produits, les hubs de documentation et les sites personnels qui ont besoin d'une entrée en matière plus affirmée. Elle s'ouvre sur un hero spacieux et éditorial — accroche, titre fort, paragraphe d'introduction et boutons d'appel à l'action — éventuellement adossé à une image hero pleine largeur qui se fond dans l'arrière-plan global, avec une animation d'entrée échelonnée qui est automatiquement désactivée pour les visiteurs préférant réduire les animations. Tout ce qui se trouve sous le hero est du Markdown standard et des shortcodes Blowfish, de sorte que la page complète reste portable et facile à maintenir.
+
+{{< figure src="img/home-landing.png" class="thumbnailshadow" >}}
+
+Pour activer la mise en page Landing, définissez `homepage.layout = "landing"` dans le fichier de configuration `params.toml`.
+
+Le hero est piloté par le front matter de `content/_index.md`. Tous les champs sont optionnels — tout ce que vous omettez n'est simplement pas affiché :
+
+```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 | Description |
+| ------------ | ----------- |
+| `heroCaption` | Petite accroche en majuscules au-dessus du titre. Par défaut, `params.Author.name`. |
+| `heroLead` | Paragraphe d'introduction affiché sous le titre. Prend en charge le Markdown. |
+| `heroButtons` | Liste de boutons d'appel à l'action (`label`, `url` et `style` optionnel). Utilise le même style que le [shortcode `cta`]({{< ref "shortcodes#cta-button" >}}). |
+
+Le corps Markdown de `_index.md` est rendu sous le hero, de sorte que les statistiques, les grilles de fonctionnalités, les étapes et tous les autres shortcodes peuvent construire le reste de la page. La mise en page Landing se marie bien avec l'option `backgroundCanvas` à l'échelle du site décrite dans la [documentation de configuration]({{< ref "configuration" >}}).
+
## Mise en page personnalisée
@@ -68,7 +101,7 @@ Avec la valeur de configuration définie, créez un nouveau fichier `custom.html
Pour inclure les [articles récents](#articles-récents) dans la mise en page personnalisée, utilisez le partial `recent-articles/main.html`.
-Par exemple, la [page d'accueil]({{< ref "/" >}}) de ce site utilise la mise en page personnalisée pour permettre de basculer entre les mises en page profil et page. Visitez le [dépôt GitHub](https://github.com/nunocoracao/blowfish/blob/main/exampleSite/layouts/partials/home/custom.html) pour voir comment cela fonctionne.
+Le site d'exemple inclus utilise la mise en page Landing intégrée et des shortcodes de contenu standard. Visitez le [dépôt GitHub](https://github.com/nunocoracao/blowfish/tree/main/exampleSite) pour voir comment il est configuré.
## Articles récents
diff --git a/exampleSite/content/docs/homepage-layout/index.it.md b/exampleSite/content/docs/homepage-layout/index.it.md
index 3ed9d608..29b8ab75 100644
--- a/exampleSite/content/docs/homepage-layout/index.it.md
+++ b/exampleSite/content/docs/homepage-layout/index.it.md
@@ -1,5 +1,6 @@
---
title: "Homepage Layout"
+featureimage: "images/v3/homepage-layout.png"
weight: 5
draft: false
description: "Configurazione del layout della home page nel tema Blowfish."
@@ -9,7 +10,7 @@ series: ["Documentazione"]
series_order: 5
---
-Blowfish fornisce un layout della home page completamente flessibile. Sono disponibili due modelli principali tra cui scegliere con impostazioni aggiuntive per adattare il design. In alternativa, puoi anche fornire il tuo modello e avere il controllo completo sul contenuto della home page.
+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).
@@ -56,6 +57,38 @@ Il layout delle schede è un'estensione del layout di pagina. Offre lo stesso li
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
@@ -67,7 +100,7 @@ Con il valore di configurazione impostato, creare un nuovo file `custom.html` e
Per includere [articoli recenti](#articoli-recenti) nel layout personalizzato, utilizzare il partial `recent-articles/main.html`.
-Ad esempio, la [homepage]({{< ref "/" >}}) di questo sito utilizza il layout personalizzato per consentire di passare dal layout del profilo a quello della pagina. Visitare il [repo GitHub](https://github.com/nunocoracao/blowfish/blob/main/exampleSite/layouts/partials/home/custom.html) per vedere come funziona.
+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
diff --git a/exampleSite/content/docs/homepage-layout/index.ja.md b/exampleSite/content/docs/homepage-layout/index.ja.md
index e0f2ae91..8ae035e9 100644
--- a/exampleSite/content/docs/homepage-layout/index.ja.md
+++ b/exampleSite/content/docs/homepage-layout/index.ja.md
@@ -1,5 +1,6 @@
---
title: "ホームページレイアウト"
+featureimage: "images/v3/homepage-layout.png"
weight: 5
draft: false
description: "Blowfish テーマのホームページレイアウト設定"
@@ -9,7 +10,7 @@ series: ["Documentation"]
series_order: 5
---
-Blowfish は完全に柔軟なホームページレイアウトを提供します。2つのメインテンプレートから選択でき、追加設定でデザインを調整できます。または、独自のテンプレートを提供して、ホームページのコンテンツを完全に制御することもできます。
+Blowfish は柔軟なホームページレイアウトを提供しており、各デザインを調整するための設定が用意されています。または、独自のテンプレートを提供して、ホームページのコンテンツを完全に制御することもできます。
ホームページのレイアウトは、`params.toml` 設定ファイルの `homepage.layout` 設定によって制御されます。さらに、すべてのレイアウトには、[最新記事](#最新記事)のリストを含めるオプションがあります。
@@ -57,6 +58,39 @@ Blowfish は完全に柔軟なホームページレイアウトを提供しま
カードレイアウトを有効にするには、`params.toml` 設定ファイルで `homepage.layout = "card"` と `homepage.homepageImage` を設定します。
+## ランディングレイアウト (landing)
+
+ランディングレイアウトは、プロダクトサイト、ドキュメントハブ、そしてより強い第一印象を必要とする個人サイトのために設計されています。ページの冒頭には、ゆったりとしたエディトリアルなヒーロー（アイブロウ、ステートメントとなる見出し、リード文、コールトゥアクションボタン）が表示され、オプションでサイト全体の背景に溶け込む全幅のヒーロー画像を背面に配置でき、要素が順に現れるエントランスアニメーションが付いています。このアニメーションは、動きを減らす設定（reduced motion）を有効にしている訪問者に対しては自動的に無効になります。ヒーローより下はすべて標準の Markdown と Blowfish のショートコードなので、ページ全体の移植性と保守性が保たれます。
+
+{{< figure src="img/home-landing.png" class="thumbnailshadow" >}}
+
+ランディングレイアウトを有効にするには、`params.toml` 設定ファイルで `homepage.layout = "landing"` を設定します。
+
+ヒーローは `content/_index.md` のフロントマターによって制御されます。すべてのフィールドはオプションで、省略したものは単に表示されません:
+
+```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"
+---
+```
+
+| フロントマター | 説明 |
+| ------------ | ----------- |
+| `heroCaption` | タイトルの上に表示される小さな大文字のアイブロウです。デフォルトは `params.Author.name` です。 |
+| `heroLead` | タイトルの下に表示されるリード文です。Markdown をサポートします。 |
+| `heroButtons` | コールトゥアクションボタンのリストです（`label`、`url`、およびオプションの `style`）。[`cta` ショートコード]({{< ref "shortcodes#cta-button" >}})と同じスタイルを使用します。 |
+
+`_index.md` の Markdown 本文はヒーローの下に表示されるため、統計、フィーチャーグリッド、ステップなどのショートコードでページの残りの部分を構築できます。ランディングレイアウトは、[設定ドキュメント]({{< ref "configuration" >}})で説明されているサイト全体の `backgroundCanvas` オプションと相性が良いです。
+
+
## カスタムレイアウト
組み込みのホームページレイアウトがニーズに合わない場合は、独自のカスタムレイアウトを提供するオプションがあります。これにより、ページコンテンツを完全に制御でき、基本的に作業するための白紙の状態が得られます。
@@ -67,7 +101,7 @@ Blowfish は完全に柔軟なホームページレイアウトを提供しま
カスタムレイアウトに[最新記事](#最新記事)を含めるには、`recent-articles/main.html` パーシャルを使用します。
-例として、このサイトの[ホームページ]({{< ref "/" >}})では、カスタムレイアウトを使用して、プロフィールレイアウトとページレイアウトを切り替えています。動作を確認するには、[GitHub リポジトリ](https://github.com/nunocoracao/blowfish/blob/main/exampleSite/layouts/partials/home/custom.html)にアクセスしてください。
+付属のサンプルサイトは、組み込みのランディングレイアウトと標準のコンテンツショートコードを使用しています。設定方法を確認するには、[GitHub リポジトリ](https://github.com/nunocoracao/blowfish/tree/main/exampleSite)にアクセスしてください。
## 最新記事
diff --git a/exampleSite/content/docs/homepage-layout/index.md b/exampleSite/content/docs/homepage-layout/index.md
index ee72a5e1..0699a9ca 100644
--- a/exampleSite/content/docs/homepage-layout/index.md
+++ b/exampleSite/content/docs/homepage-layout/index.md
@@ -60,9 +60,35 @@ To enable the Card layout, set `homepage.layout = "card"` and `homepage.homepage
## Landing layout
-The Landing layout is designed for product sites, documentation hubs, and personal sites that need a stronger opening statement. It gives homepage content a spacious, editorial hero treatment while still rendering standard Markdown and Blowfish shortcodes, so the full page stays portable and easy to maintain.
+The Landing layout is designed for product sites, documentation hubs, and personal sites that need a stronger opening statement. It opens with a spacious, editorial hero — eyebrow, statement headline, lead paragraph, and call-to-action buttons — optionally backed by a full-width hero image that dissolves into the global background, with a staggered entrance animation that is disabled automatically for visitors who prefer reduced motion. Everything below the hero is standard Markdown and Blowfish shortcodes, so the full page stays portable and easy to maintain.
-To enable the Landing layout, set `homepage.layout = "landing"` in the `params.toml` configuration file. Use `content/_index.md` for the title, lead, calls to action, feature grids, and other content.
+{{< figure src="img/home-landing.png" class="thumbnailshadow" >}}
+
+To enable the Landing layout, set `homepage.layout = "landing"` in the `params.toml` configuration file.
+
+The hero is driven by the front matter of `content/_index.md`. All fields are optional — anything you leave out is simply not rendered:
+
+```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 | Description |
+| ------------ | ----------- |
+| `heroCaption` | Small uppercase eyebrow above the title. Defaults to `params.Author.name`. |
+| `heroLead` | Lead paragraph rendered under the title. Supports Markdown. |
+| `heroButtons` | List of call-to-action buttons (`label`, `url`, and optional `style`). Uses the same styling as the [`cta` shortcode]({{< ref "shortcodes#cta-button" >}}). |
+
+The Markdown body of `_index.md` renders below the hero, so stats, feature grids, steps, and any other shortcodes can build out the rest of the page. The Landing layout pairs well with the site-wide `backgroundCanvas` option described in the [Configuration docs]({{< ref "configuration" >}}).
## Custom layout
diff --git a/exampleSite/content/docs/homepage-layout/index.pt-br.md b/exampleSite/content/docs/homepage-layout/index.pt-br.md
index b7aa7e48..242f84c3 100644
--- a/exampleSite/content/docs/homepage-layout/index.pt-br.md
+++ b/exampleSite/content/docs/homepage-layout/index.pt-br.md
@@ -1,5 +1,6 @@
---
title: "Layout da Página Inicial"
+featureimage: "images/v3/homepage-layout.png"
weight: 5
draft: false
description: "Configurando o layout da página inicial no tema Blowfish."
@@ -9,7 +10,7 @@ series: ["Documentação"]
series_order: 5
---
-O Blowfish fornece um layout de página inicial totalmente flexível. Existem dois modelos principais para escolher com configurações adicionais para ajustar o design. Alternativamente, você também pode fornecer seu próprio modelo e ter controle total sobre o conteúdo da página inicial.
+O Blowfish fornece layouts flexíveis de página inicial com configurações para ajustar cada design. Alternativamente, você também pode fornecer seu próprio modelo e ter controle total sobre o conteúdo da página inicial.
O layout da página inicial é controlado pela configuração `homepage.layout` no arquivo de configuração `params.toml`. Além disso, todos os layouts têm a opção de incluir uma lista de [artigos recentes](#artigos-recentes).
@@ -57,6 +58,38 @@ O layout de cartão é uma extensão do layout de página. Ele fornece o mesmo n
Para habilitar o layout Cartão, defina `homepage.layout = "card"` e `homepage.homepageImage` no arquivo de configuração `params.toml`.
+## Layout Landing
+
+O layout Landing foi projetado para sites de produtos, hubs de documentação e sites pessoais que precisam de uma abertura mais marcante. Ele começa com um hero espaçoso e editorial — legenda superior (eyebrow), título de impacto, parágrafo de destaque e botões de call-to-action — opcionalmente apoiado por uma imagem hero de largura total que se dissolve no plano de fundo global, com uma animação de entrada escalonada que é desativada automaticamente para visitantes que preferem movimento reduzido. Tudo abaixo do hero é Markdown padrão e shortcodes do Blowfish, então a página inteira permanece portátil e fácil de manter.
+
+{{< figure src="img/home-landing.png" class="thumbnailshadow" >}}
+
+Para habilitar o layout Landing, defina `homepage.layout = "landing"` no arquivo de configuração `params.toml`.
+
+O hero é controlado pelo front matter de `content/_index.md`. Todos os campos são opcionais — qualquer campo que você omitir simplesmente não é renderizado:
+
+```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 | Descrição |
+| ------------ | ----------- |
+| `heroCaption` | Pequena legenda em maiúsculas acima do título. O padrão é `params.Author.name`. |
+| `heroLead` | Parágrafo de destaque renderizado abaixo do título. Suporta Markdown. |
+| `heroButtons` | Lista de botões de call-to-action (`label`, `url` e `style` opcional). Usa o mesmo estilo do [shortcode `cta`]({{< ref "shortcodes#cta-button" >}}). |
+
+O corpo Markdown de `_index.md` é renderizado abaixo do hero, então estatísticas, grades de recursos, passos e quaisquer outros shortcodes podem construir o restante da página. O layout Landing combina bem com a opção `backgroundCanvas` para todo o site, descrita na [documentação de configuração]({{< ref "configuration" >}}).
+
## Layout personalizado
@@ -68,7 +101,7 @@ Com o valor de configuração definido, crie um novo arquivo `custom.html` e col
Para incluir [artigos recentes](#artigos-recentes) no layout personalizado, use o partial `recent-articles/main.html`.
-Como exemplo, a [página inicial]({{< ref "/" >}}) deste site usa o layout personalizado para permitir alternar entre os layouts de perfil e página. Visite o [repositório GitHub](https://github.com/nunocoracao/blowfish/blob/main/exampleSite/layouts/partials/home/custom.html) para ver como funciona.
+O site de exemplo incluído usa o layout Landing integrado e shortcodes de conteúdo padrão. Visite o [repositório GitHub](https://github.com/nunocoracao/blowfish/tree/main/exampleSite) para ver como ele está configurado.
## Artigos recentes
diff --git a/exampleSite/content/docs/homepage-layout/index.pt-pt.md b/exampleSite/content/docs/homepage-layout/index.pt-pt.md
index d5b18b7d..b43bec66 100644
--- a/exampleSite/content/docs/homepage-layout/index.pt-pt.md
+++ b/exampleSite/content/docs/homepage-layout/index.pt-pt.md
@@ -1,5 +1,6 @@
---
title: "Layout da Página Inicial"
+featureimage: "images/v3/homepage-layout.png"
weight: 5
draft: false
description: "Configuração do layout da página inicial no tema Blowfish."
@@ -9,7 +10,7 @@ series: ["Documentação"]
series_order: 5
---
-O Blowfish fornece um layout de página inicial totalmente flexível. Existem dois modelos principais para escolher com definições adicionais para ajustar o design. Alternativamente, também pode fornecer o seu próprio modelo e ter controlo total sobre o conteúdo da página inicial.
+O Blowfish fornece layouts de página inicial flexíveis, com definições para ajustar cada design. Alternativamente, também pode fornecer o seu próprio modelo e ter controlo total sobre o conteúdo da página inicial.
O layout da página inicial é controlado pela definição `homepage.layout` no ficheiro de configuração `params.toml`. Além disso, todos os layouts têm a opção de incluir uma lista de [artigos recentes](#artigos-recentes).
@@ -57,6 +58,38 @@ O layout de cartão é uma extensão do layout de página. Fornece o mesmo níve
Para ativar o layout Cartão, defina `homepage.layout = "card"` e `homepage.homepageImage` no ficheiro de configuração `params.toml`.
+## Layout Landing
+
+O layout Landing foi pensado para sites de produto, hubs de documentação e sites pessoais que precisam de uma abertura mais marcante. Abre com um hero espaçoso e editorial — legenda (eyebrow), título de destaque, parágrafo introdutório e botões de call-to-action — opcionalmente apoiado por uma imagem hero de largura total que se dissolve no fundo global, com uma animação de entrada faseada que é automaticamente desativada para os visitantes que preferem movimento reduzido. Tudo o que está abaixo do hero é Markdown padrão e shortcodes do Blowfish, pelo que a página completa se mantém portátil e fácil de manter.
+
+{{< figure src="img/home-landing.png" class="thumbnailshadow" >}}
+
+Para ativar o layout Landing, defina `homepage.layout = "landing"` no ficheiro de configuração `params.toml`.
+
+O hero é controlado pelo front matter de `content/_index.md`. Todos os campos são opcionais — tudo o que omitir simplesmente não é apresentado:
+
+```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 | Descrição |
+| ------------ | ----------- |
+| `heroCaption` | Pequena legenda (eyebrow) em maiúsculas acima do título. A predefinição é `params.Author.name`. |
+| `heroLead` | Parágrafo introdutório apresentado sob o título. Suporta Markdown. |
+| `heroButtons` | Lista de botões de call-to-action (`label`, `url` e `style` opcional). Utiliza o mesmo estilo do [shortcode `cta`]({{< ref "shortcodes#cta-button" >}}). |
+
+O corpo Markdown de `_index.md` é apresentado abaixo do hero, pelo que estatísticas, grelhas de funcionalidades, passos e quaisquer outros shortcodes podem construir o resto da página. O layout Landing combina bem com a opção `backgroundCanvas` aplicada a todo o site, descrita na [documentação de configuração]({{< ref "configuration" >}}).
+
## Layout personalizado
@@ -68,7 +101,7 @@ Com o valor de configuração definido, crie um novo ficheiro `custom.html` e co
Para incluir [artigos recentes](#artigos-recentes) no layout personalizado, utilize o partial `recent-articles/main.html`.
-Como exemplo, a [página inicial]({{< ref "/" >}}) deste site utiliza o layout personalizado para permitir alternar entre os layouts de perfil e página. Visite o [repositório GitHub](https://github.com/nunocoracao/blowfish/blob/main/exampleSite/layouts/partials/home/custom.html) para ver como funciona.
+O site de exemplo incluído utiliza o layout Landing integrado e shortcodes de conteúdo padrão. Visite o [repositório GitHub](https://github.com/nunocoracao/blowfish/tree/main/exampleSite) para ver como está configurado.
## Artigos recentes
diff --git a/exampleSite/content/docs/homepage-layout/index.zh-cn.md b/exampleSite/content/docs/homepage-layout/index.zh-cn.md
index 57cec4ab..29957329 100644
--- a/exampleSite/content/docs/homepage-layout/index.zh-cn.md
+++ b/exampleSite/content/docs/homepage-layout/index.zh-cn.md
@@ -1,5 +1,6 @@
---
title: "主页布局"
+featureimage: "images/v3/homepage-layout.png"
weight: 5
draft: false
description: "在 Blowfish 主题中设置主页布局。"
@@ -9,7 +10,7 @@ series: ["部署教程"]
series_order: 5
---
-Blowfish 提供了一个完全灵活的主页布局。你可以选择两种主要模板，并提供了额外的参数来帮助调整设计。当然，你也可以提供自己的模板，完全控制主页的内容。
+Blowfish 提供了灵活的主页布局，每种设计都有相应的参数可以调整。当然，你也可以提供自己的模板，完全控制主页的内容。
主页布局由 `params.toml` 配置文件中的 `homepage.layout` 参数来控制的。此外所有布局都默认包括 [最近文章](#最近文章)。
@@ -57,6 +58,39 @@ Blowfish 提供了一个完全灵活的主页布局。你可以选择两种主
如果想要启用 card 布局，请在 `params.toml` 配置文件中设置 `homepage.layout = "card"` 和 `homepage.homepageImage` 。
+## 着陆页布局（landing）
+
+着陆页布局（landing）专为产品网站、文档中心以及需要更强开场表达的个人网站而设计。它以一个宽敞、富有编辑感的 hero 区域开场 —— 包含眉标（eyebrow）、主标题、导语段落和号召性按钮 —— 并可选择以一张融入全局背景的全宽 hero 图片作为背景，同时带有错落的入场动画（对于偏好减少动效的访问者会自动禁用）。hero 下方的所有内容都是标准的 Markdown 和 Blowfish 短代码，因此整个页面依然便于迁移和维护。
+
+{{< figure src="img/home-landing.png" class="thumbnailshadow" >}}
+
+如果想要启用 landing 布局，请在 `params.toml` 配置文件中设置 `homepage.layout = "landing"`。
+
+hero 区域由 `content/_index.md` 的扉页参数驱动。所有字段都是可选的 —— 未填写的内容不会被渲染：
+
+```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"
+---
+```
+
+| 扉页参数 | 描述 |
+| ------------ | ----------- |
+| `heroCaption` | 显示在标题上方的小号大写眉标。默认为 `params.Author.name`。 |
+| `heroLead` | 渲染在标题下方的导语段落。支持 Markdown。 |
+| `heroButtons` | 号召性按钮列表（`label`、`url` 以及可选的 `style`）。样式与 [`cta` 短代码]({{< ref "shortcodes#cta-button" >}})相同。 |
+
+`_index.md` 的 Markdown 正文会渲染在 hero 下方，因此可以使用统计数据、特性网格、步骤以及其他任意短代码来构建页面的其余部分。landing 布局与[配置文档]({{< ref "configuration" >}})中介绍的站点级 `backgroundCanvas` 选项搭配使用效果很好。
+
+
## 自定义布局（custom）
如果以上几个布局还没有满足你的需求，你还可以自己创建自定义布局。这样你可以基于一个空白的画布，来完全控制页面上的内容。
@@ -67,7 +101,7 @@ Blowfish 提供了一个完全灵活的主页布局。你可以选择两种主
如果你想在自定义布局上添加 [最近文章](#最近文章)，请使用 `recent-articles/main.html` 中的内容。
-如果你想在网站[主页]({{< ref "/" >}})使用自定义布局来实现在个人资料和页面布局之间的切换。这里的[GitHub 仓库](https://github.com/nunocoracao/blowfish/blob/main/exampleSite/layouts/partials/home/custom.html)有一个例子可以参考。
+主题附带的示例站点使用了内置的着陆页布局（landing）和标准内容短代码。可以访问 [GitHub 仓库](https://github.com/nunocoracao/blowfish/tree/main/exampleSite)查看它的具体配置方式。
## 最近文章
diff --git a/exampleSite/content/docs/hosting-deployment/index.de.md b/exampleSite/content/docs/hosting-deployment/index.de.md
index 7ac45a97..72c646ca 100644
--- a/exampleSite/content/docs/hosting-deployment/index.de.md
+++ b/exampleSite/content/docs/hosting-deployment/index.de.md
@@ -1,5 +1,6 @@
---
title: "Hosting & Bereitstellung"
+featureimage: "images/v3/publishing-system.png"
weight: 14
draft: false
description: "Erfahren Sie, wie Sie eine Blowfish-Website bereitstellen."
diff --git a/exampleSite/content/docs/hosting-deployment/index.es.md b/exampleSite/content/docs/hosting-deployment/index.es.md
index 499f73c2..ea12e880 100644
--- a/exampleSite/content/docs/hosting-deployment/index.es.md
+++ b/exampleSite/content/docs/hosting-deployment/index.es.md
@@ -1,5 +1,6 @@
---
title: "Alojamiento y despliegue"
+featureimage: "images/v3/publishing-system.png"
weight: 14
draft: false
description: "Aprende cómo desplegar un sitio Blowfish."
diff --git a/exampleSite/content/docs/hosting-deployment/index.fr.md b/exampleSite/content/docs/hosting-deployment/index.fr.md
index c981550c..41a483ab 100644
--- a/exampleSite/content/docs/hosting-deployment/index.fr.md
+++ b/exampleSite/content/docs/hosting-deployment/index.fr.md
@@ -1,5 +1,6 @@
---
title: "Hébergement & Déploiement"
+featureimage: "images/v3/publishing-system.png"
weight: 14
draft: false
description: "Apprenez à déployer un site Blowfish."
diff --git a/exampleSite/content/docs/hosting-deployment/index.it.md b/exampleSite/content/docs/hosting-deployment/index.it.md
index 0bdd38d8..04541bd1 100644
--- a/exampleSite/content/docs/hosting-deployment/index.it.md
+++ b/exampleSite/content/docs/hosting-deployment/index.it.md
@@ -1,5 +1,6 @@
---
title: "Hosting & Deployment"
+featureimage: "images/v3/publishing-system.png"
weight: 14
draft: false
description: "Learn how to deploy a Blowfish site."
diff --git a/exampleSite/content/docs/hosting-deployment/index.ja.md b/exampleSite/content/docs/hosting-deployment/index.ja.md
index b5774eec..d242506a 100644
--- a/exampleSite/content/docs/hosting-deployment/index.ja.md
+++ b/exampleSite/content/docs/hosting-deployment/index.ja.md
@@ -1,5 +1,6 @@
---
title: "ホスティングとデプロイ"
+featureimage: "images/v3/publishing-system.png"
weight: 14
draft: false
description: "Blowfish サイトのデプロイ方法について説明します。"
diff --git a/exampleSite/content/docs/hosting-deployment/index.pt-br.md b/exampleSite/content/docs/hosting-deployment/index.pt-br.md
index e679e51b..fb6cbec4 100644
--- a/exampleSite/content/docs/hosting-deployment/index.pt-br.md
+++ b/exampleSite/content/docs/hosting-deployment/index.pt-br.md
@@ -1,5 +1,6 @@
---
title: "Hospedagem e implantação"
+featureimage: "images/v3/publishing-system.png"
weight: 14
draft: false
description: "Aprenda como implantar um site Blowfish."
diff --git a/exampleSite/content/docs/hosting-deployment/index.pt-pt.md b/exampleSite/content/docs/hosting-deployment/index.pt-pt.md
index 27d651f7..951d4862 100644
--- a/exampleSite/content/docs/hosting-deployment/index.pt-pt.md
+++ b/exampleSite/content/docs/hosting-deployment/index.pt-pt.md
@@ -1,5 +1,6 @@
---
title: "Alojamento e implementação"
+featureimage: "images/v3/publishing-system.png"
weight: 14
draft: false
description: "Aprenda como implementar um site Blowfish."
diff --git a/exampleSite/content/docs/hosting-deployment/index.zh-cn.md b/exampleSite/content/docs/hosting-deployment/index.zh-cn.md
index 6e20ff52..0bf2826a 100644
--- a/exampleSite/content/docs/hosting-deployment/index.zh-cn.md
+++ b/exampleSite/content/docs/hosting-deployment/index.zh-cn.md
@@ -1,5 +1,6 @@
---
title: "托管和部署"
+featureimage: "images/v3/publishing-system.png"
weight: 14
draft: false
description: "了解如何部署 Blowfish 网页。"
diff --git a/exampleSite/content/docs/installation/index.de.md b/exampleSite/content/docs/installation/index.de.md
index 1a723ebc..953e3ca8 100644
--- a/exampleSite/content/docs/installation/index.de.md
+++ b/exampleSite/content/docs/installation/index.de.md
@@ -13,6 +13,21 @@ Folgen Sie einfach dem standardmäßigen Hugo [Schnellstart](https://gohugo.io/g
Detaillierte Installationsanweisungen finden Sie unten. Anweisungen zum [Aktualisieren des Themes](#updates-installieren) sind ebenfalls verfügbar.
+## Agent-Skill
+
+Blowfish enthält einen [Agent-Skill](https://github.com/nunocoracao/blowfish/tree/main/.claude/skills/blowfish), der KI-Coding-Agents — wie Claude Code — beibringt, wie man das Theme installiert, konfiguriert und damit Websites erstellt. Wenn du mit einem Agent an deiner Website arbeitest, installiere den Skill, damit er sich mit den Konfigurationsdateien, Layouts, Front Matter und Shortcodes von Blowfish auskennt.
+
+Installation über den Blowfish-Plugin-Marketplace in Claude Code:
+
+```shell
+/plugin marketplace add nunocoracao/blowfish
+/plugin install blowfish@blowfish
+```
+
+Alternativ kannst du den Skill-Ordner unter `.claude/skills/blowfish/` in dein Website-Repository kopieren — Agents laden Skills aus dem `.claude/skills/`-Verzeichnis eines Projekts automatisch.
+
+---
+
## Installation
Diese Anweisungen bringen Sie von einem komplett leeren Zustand mit Hugo und Blowfish zum Laufen. Die meisten der in diesem Leitfaden erwähnten Abhängigkeiten können mit dem Paketmanager Ihrer Wahl für Ihre Plattform installiert werden.
@@ -27,7 +42,7 @@ Stellen Sie sicher, dass Sie **Hugo Version 0.158.0** oder höher verwenden, da
Sie finden detaillierte Installationsanweisungen für Ihre Plattform in der [Hugo-Dokumentation](https://gohugo.io/getting-started/installing).
-### Blowfish Tools (empfohlen)
+### Blowfish Tools
Wir haben gerade ein neues CLI-Tool veröffentlicht, das Ihnen beim Einstieg mit Blowfish hilft. Es erstellt ein neues Hugo-Projekt, installiert das Theme und richtet die Theme-Konfigurationsdateien für Sie ein. Es befindet sich noch in der Beta-Phase, also [melden Sie bitte alle Probleme, die Sie finden](https://github.com/nunocoracao/blowfish-tools).
@@ -112,7 +127,7 @@ Für diese Methode verwenden Sie Hugo zur Verwaltung Ihrer Themes. Hugo verwende
```toml
[[imports]]
disable = false
- path = "github.com/nunocoracao/blowfish/v2"
+ path = "github.com/nunocoracao/blowfish/v3"
```
4. Starten Sie Ihren Server mit `hugo server` und das Theme wird automatisch heruntergeladen.
@@ -209,3 +224,14 @@ Beachten Sie, dass alle lokalen Anpassungen, die Sie an den Theme-Dateien vorgen
2. Entpacken Sie das Archiv, benennen Sie den Ordner in `blowfish` um und verschieben Sie ihn in das Verzeichnis `themes/` im Stammordner Ihres Hugo-Projekts. Sie müssen das vorhandene Verzeichnis überschreiben, um alle Theme-Dateien zu ersetzen.
3. Erstellen Sie Ihre Website neu und überprüfen Sie, ob alles wie erwartet funktioniert.
+---
+
+## Upgrade von v2 auf v3
+
+Blowfish v3 ist vollständig abwärtskompatibel zu v2-Websites: Alle neuen Features sind opt-in, es wurden keine Konfigurationsoptionen entfernt und keine Templates oder Partials umbenannt. Deine Website sieht nach dem Upgrade genauso aus und verhält sich gleich, bis du die neuen Features aktivierst.
+
+- **Git-Submodul:** Wie üblich aktualisieren — `git submodule update --remote --merge`. Mehr ist nicht nötig.
+- **Hugo-Modul:** Bearbeite `config/_default/module.toml` und ändere den Importpfad von `github.com/nunocoracao/blowfish/v2` zu `github.com/nunocoracao/blowfish/v3`, dann führe `hugo mod get -u` aus.
+- **Manuelle Installation:** Lade das neueste Release herunter und ersetze den Theme-Ordner wie oben beschrieben.
+
+Nach dem Upgrade findest du in der [Konfigurationsdokumentation]({{< ref "configuration" >}}) die neuen Opt-in-Optionen — den Floating-Header, das Landing-Homepage-Layout, den Hintergrund-Canvas, den Lesefortschrittsbalken und mehr.
diff --git a/exampleSite/content/docs/installation/index.es.md b/exampleSite/content/docs/installation/index.es.md
index 07f4444d..8512995b 100644
--- a/exampleSite/content/docs/installation/index.es.md
+++ b/exampleSite/content/docs/installation/index.es.md
@@ -13,6 +13,21 @@ Simplemente sigue el procedimiento estándar de Hugo [Inicio Rápido](https://go
Las instrucciones de instalación detalladas se encuentran a continuación. También están disponibles instrucciones para [actualizar el tema](#instalación-de-actualizaciones).
+## Skill para agentes
+
+Blowfish incluye un [skill para agentes](https://github.com/nunocoracao/blowfish/tree/main/.claude/skills/blowfish) que enseña a los agentes de programación con IA — como Claude Code — a instalar, configurar y crear sitios con el tema. Si usas un agente para trabajar en tu sitio, instala el skill para que conozca los archivos de configuración, los layouts, el front matter y los shortcodes de Blowfish.
+
+Instálalo desde el marketplace de plugins de Blowfish en Claude Code:
+
+```shell
+/plugin marketplace add nunocoracao/blowfish
+/plugin install blowfish@blowfish
+```
+
+Como alternativa, copia la carpeta del skill en el repositorio de tu sitio, en `.claude/skills/blowfish/` — los agentes cargan automáticamente los skills almacenados en el directorio `.claude/skills/` de un proyecto.
+
+---
+
## Instalación
Estas instrucciones te ayudarán a empezar con Hugo y Blowfish desde un estado completamente vacío. La mayoría de las dependencias mencionadas en esta guía se pueden instalar utilizando el gestor de paquetes de tu elección para tu plataforma.
@@ -27,7 +42,7 @@ Asegúrate de estar usando **Hugo versión 0.158.0** o posterior, ya que el tema
Puedes encontrar instrucciones de instalación detalladas para tu plataforma en la [documentación de Hugo](https://gohugo.io/getting-started/installing).
-### Blowfish Tools (recomendado)
+### Blowfish Tools
Acabamos de lanzar una nueva herramienta CLI para ayudarte a empezar con Blowfish. Creará un nuevo proyecto Hugo, instalará el tema y configurará los archivos de configuración del tema por ti. Todavía está en beta, así que por favor [reporta cualquier problema que encuentres](https://github.com/nunocoracao/blowfish-tools).
@@ -112,7 +127,7 @@ Para este método usarás Hugo para gestionar tus temas. Hugo usa **Go** para in
```toml
[[imports]]
disable = false
- path = "github.com/nunocoracao/blowfish/v2"
+ path = "github.com/nunocoracao/blowfish/v3"
```
4. Inicia tu servidor usando `hugo server` y el tema se descargará automáticamente.
@@ -209,3 +224,14 @@ Ten en cuenta que cualquier personalización local que hayas hecho a los archivo
2. Extrae el archivo, renombra la carpeta a `blowfish` y muévela al directorio `themes/` dentro de la carpeta raíz de tu proyecto Hugo. Necesitarás sobrescribir el directorio existente para reemplazar todos los archivos del tema.
3. Reconstruye tu sitio y verifica que todo funcione como se esperaba.
+---
+
+## Actualizar de v2 a v3
+
+Blowfish v3 es totalmente compatible con los sitios de v2: todas las novedades son opcionales, no se ha eliminado ninguna opción de configuración y no se ha renombrado ningún template ni partial. Tu sitio se verá y funcionará igual tras actualizar, hasta que actives las nuevas funciones.
+
+- **Submódulo Git:** actualiza como siempre — `git submodule update --remote --merge`. No hace falta nada más.
+- **Módulo de Hugo:** edita `config/_default/module.toml` y cambia la ruta de importación de `github.com/nunocoracao/blowfish/v2` a `github.com/nunocoracao/blowfish/v3`; después ejecuta `hugo mod get -u`.
+- **Instalación manual:** descarga la última versión y sustituye la carpeta del tema, como se describe arriba.
+
+Tras actualizar, consulta la [documentación de configuración]({{< ref "configuration" >}}) para conocer las nuevas opciones — el header flotante, el layout de portada landing, el fondo global, la barra de progreso de lectura y más.
diff --git a/exampleSite/content/docs/installation/index.fr.md b/exampleSite/content/docs/installation/index.fr.md
index b9117ad7..53f0c1c5 100644
--- a/exampleSite/content/docs/installation/index.fr.md
+++ b/exampleSite/content/docs/installation/index.fr.md
@@ -13,6 +13,21 @@ Suivez simplement la procédure standard Hugo [Démarrage Rapide](https://gohugo
Des instructions d'installation détaillées sont disponibles ci-dessous. Des instructions pour [mettre à jour le thème](#installation-des-mises-à-jour) sont également disponibles.
+## Skill pour agents
+
+Blowfish inclut un [skill pour agents](https://github.com/nunocoracao/blowfish/tree/main/.claude/skills/blowfish) qui apprend aux agents de codage IA — comme Claude Code — à installer, configurer et créer des sites avec le thème. Si vous utilisez un agent pour travailler sur votre site, installez le skill afin qu'il connaisse les fichiers de configuration, les layouts, le front matter et les shortcodes de Blowfish.
+
+Installez-le depuis la marketplace de plugins de Blowfish dans Claude Code :
+
+```shell
+/plugin marketplace add nunocoracao/blowfish
+/plugin install blowfish@blowfish
+```
+
+Vous pouvez aussi copier le dossier du skill dans le dépôt de votre site, sous `.claude/skills/blowfish/` — les agents chargent automatiquement les skills présents dans le répertoire `.claude/skills/` d'un projet.
+
+---
+
## Installation
Ces instructions vous permettront de démarrer avec Hugo et Blowfish à partir d'un état complètement vierge. La plupart des dépendances mentionnées dans ce guide peuvent être installées à l'aide du gestionnaire de paquets de votre choix pour votre plateforme.
@@ -27,7 +42,7 @@ Assurez-vous d'utiliser **Hugo version 0.158.0** ou ultérieure car le thème ti
Vous pouvez trouver des instructions d'installation détaillées pour votre plateforme dans la [documentation Hugo](https://gohugo.io/getting-started/installing).
-### Blowfish Tools (recommandé)
+### Blowfish Tools
Nous venons de lancer un nouvel outil CLI pour vous aider à démarrer avec Blowfish. Il créera un nouveau projet Hugo, installera le thème et configurera les fichiers de configuration du thème pour vous. Il est encore en bêta, veuillez donc [signaler tout problème que vous rencontrez](https://github.com/nunocoracao/blowfish-tools).
@@ -112,7 +127,7 @@ Pour cette méthode, vous utiliserez Hugo pour gérer vos thèmes. Hugo utilise
```toml
[[imports]]
disable = false
- path = "github.com/nunocoracao/blowfish/v2"
+ path = "github.com/nunocoracao/blowfish/v3"
```
4. Démarrez votre serveur en utilisant `hugo server` et le thème sera téléchargé automatiquement.
@@ -209,3 +224,14 @@ Notez que toutes les personnalisations locales que vous avez apportées aux fich
2. Extrayez l'archive, renommez le dossier en `blowfish` et déplacez-le dans le répertoire `themes/` à l'intérieur du dossier racine de votre projet Hugo. Vous devrez écraser le répertoire existant pour remplacer tous les fichiers du thème.
3. Reconstruisez votre site et vérifiez que tout fonctionne comme prévu.
+---
+
+## Mettre à niveau de v2 vers v3
+
+Blowfish v3 est entièrement rétrocompatible avec les sites v2 : toutes les nouveautés sont optionnelles, aucune option de configuration n'a été supprimée et aucun template ni partial n'a été renommé. Votre site aura le même aspect et le même comportement après la mise à niveau, jusqu'à ce que vous activiez les nouvelles fonctionnalités.
+
+- **Sous-module Git :** mettez à jour comme d'habitude — `git submodule update --remote --merge`. Rien d'autre n'est nécessaire.
+- **Module Hugo :** modifiez `config/_default/module.toml` en remplaçant le chemin d'import `github.com/nunocoracao/blowfish/v2` par `github.com/nunocoracao/blowfish/v3`, puis exécutez `hugo mod get -u`.
+- **Installation manuelle :** téléchargez la dernière version et remplacez le dossier du thème, comme décrit ci-dessus.
+
+Après la mise à niveau, parcourez la [documentation de configuration]({{< ref "configuration" >}}) pour découvrir les nouvelles options — le header flottant, la mise en page landing, le fond global, la barre de progression de lecture et plus encore.
diff --git a/exampleSite/content/docs/installation/index.it.md b/exampleSite/content/docs/installation/index.it.md
index 9aa98f82..c6db2ce8 100644
--- a/exampleSite/content/docs/installation/index.it.md
+++ b/exampleSite/content/docs/installation/index.it.md
@@ -13,6 +13,21 @@ Segui semplicemente la procedura standard [Avvio Rapido](https://gohugo.io/getti
Sono riportate le istruzioni dettagliate per l'installazione. Sono disponibili anche le istruzioni per [aggiornare il tema](#installazione-degli-aggiornamenti).
+## Skill per agenti
+
+Blowfish include una [skill per agenti](https://github.com/nunocoracao/blowfish/tree/main/.claude/skills/blowfish) che insegna agli agenti di programmazione IA — come Claude Code — come installare, configurare e creare siti con il tema. Se usi un agente per lavorare sul tuo sito, installa la skill così conoscerà i file di configurazione, i layout, il front matter e gli shortcode di Blowfish.
+
+Installala dal marketplace dei plugin di Blowfish in Claude Code:
+
+```shell
+/plugin marketplace add nunocoracao/blowfish
+/plugin install blowfish@blowfish
+```
+
+In alternativa, copia la cartella della skill nel repository del tuo sito in `.claude/skills/blowfish/` — gli agenti caricano automaticamente le skill presenti nella directory `.claude/skills/` di un progetto.
+
+---
+
## Installazione
Queste istruzioni ti consentiranno di iniziare a utilizzare Hugo e Blowfish partendo da uno stato completamente vuoto. La maggior parte delle dipendenze menzionate in questa guida possono essere installate utilizzando il gestore pacchetti corretti per la tua piattaforma.
@@ -28,7 +43,7 @@ Assicurati di usare la **versione 0.158.0 di Hugo** o successiva, poiché il tem
Puoi trovare le istruzioni dettagliate sull'installazione per la propria piattaforma in [Documenti Hugo](https://gohugo.io/getting-started/installing).
-### Strumenti Blowfish (raccomandato)
+### Strumenti Blowfish
Abbiamo appena lanciato un nuovo strumento CLI per aiutarti a iniziare con Blowfish. Questo ti permette di creare un nuovo progetto Hugo, di installare il tema e di impostare i file di configurazione del tema per te. È ancora in fase beta, quindi per favore [segnala qualsiasi problema che riscontri] (https://github.com/nunocoracao/blowfish-tools).
@@ -111,7 +126,7 @@ Per questo metodo utilizzerai Hugo per gestire i tuoi temi. Hugo utilizza **Go**
```toml
[[imports]]
disable = false
- path = "github.com/nunocoracao/blowfish/v2"
+ path = "github.com/nunocoracao/blowfish/v3"
```
4. Avvia il tuo server utilizzando `hugo server` e il tema verrà scaricato automaticamente.
@@ -208,3 +223,14 @@ Tieni presente che ogni personalizzazione locale apportata ai file del tema andr
2. Estrai l'archivio, rinomina la cartella in "blowfish" e spostala nella directory "themes/" all'interno della cartella principale del tuo progetto Hugo. Dovrai sovrascrivere la directory esistente per sostituire tutti i file del tema.
3. Riavvia il tuo sito e verifica che tutto funzioni come previsto.
+---
+
+## Aggiornare da v2 a v3
+
+Blowfish v3 è completamente retrocompatibile con i siti v2: tutte le novità sono opt-in, nessuna opzione di configurazione è stata rimossa e nessun template o partial è stato rinominato. Il tuo sito avrà lo stesso aspetto e comportamento dopo l'aggiornamento, finché non attivi le nuove funzionalità.
+
+- **Submodule Git:** aggiorna come al solito — `git submodule update --remote --merge`. Non serve altro.
+- **Modulo Hugo:** modifica `config/_default/module.toml` cambiando il percorso di import da `github.com/nunocoracao/blowfish/v2` a `github.com/nunocoracao/blowfish/v3`, poi esegui `hugo mod get -u`.
+- **Installazione manuale:** scarica l'ultima release e sostituisci la cartella del tema, come descritto sopra.
+
+Dopo l'aggiornamento, consulta la [documentazione di configurazione]({{< ref "configuration" >}}) per le nuove opzioni — l'header flottante, il layout landing, lo sfondo globale, la barra di avanzamento della lettura e altro.
diff --git a/exampleSite/content/docs/installation/index.ja.md b/exampleSite/content/docs/installation/index.ja.md
index 7a583df6..b9756bc8 100644
--- a/exampleSite/content/docs/installation/index.ja.md
+++ b/exampleSite/content/docs/installation/index.ja.md
@@ -13,6 +13,21 @@ Hugo の[クイックスタートガイド](https://gohugo.io/getting-started/qu
詳細なインストール手順は以下に記載されています。[テーマのアップデート方法](#テーマのアップデート方法)についても説明しています。
+## エージェントスキル
+
+Blowfish には、Claude Code などの AI コーディングエージェントにテーマのインストール・設定・サイト構築の方法を教える[エージェントスキル](https://github.com/nunocoracao/blowfish/tree/main/.claude/skills/blowfish)が付属しています。エージェントを使ってサイトを開発する場合は、このスキルをインストールすると、Blowfish の設定ファイル、レイアウト、フロントマター、ショートコードをエージェントが理解できるようになります。
+
+Claude Code で Blowfish のプラグインマーケットプレイスからインストールできます:
+
+```shell
+/plugin marketplace add nunocoracao/blowfish
+/plugin install blowfish@blowfish
+```
+
+または、スキルのフォルダをサイトのリポジトリの `.claude/skills/blowfish/` にコピーしてください。エージェントはプロジェクトの `.claude/skills/` ディレクトリにあるスキルを自動的に読み込みます。
+
+---
+
## インストール
以下の手順では、全くの新規状態から Hugo と Blowfish を使用してウェブサイトを立ち上げる方法を説明します。このガイドで紹介するツールのほとんどは、お使いのプラットフォームに対応したパッケージマネージャーからインストール可能です。
@@ -27,7 +42,7 @@ Hugo を初めて使用する場合は、[公式サイトの手順](https://gohu
お使いのプラットフォームに合わせた詳細なインストール手順は、[Hugo の公式ドキュメント](https://gohugo.io/getting-started/installing)に記載されています。
-### Blowfish Tools (推奨)
+### Blowfish Tools
Blowfish を簡単に使い始められるよう、新しく CLI ツールをリリースしました。このツールは、新しい Hugo プロジェクトの作成、テーマのインストール、そしてテーマ設定ファイルのセットアップを自動的に行います。まだベータ版ですので、[問題を発見した場合は報告にご協力ください](https://github.com/nunocoracao/blowfish-tools)。
@@ -112,7 +127,7 @@ git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blo
```toml
[[imports]]
disable = false
- path = "github.com/nunocoracao/blowfish/v2"
+ path = "github.com/nunocoracao/blowfish/v3"
```
4. `hugo server` を実行してサーバーを起動すると、テーマが自動的にダウンロードされます。
@@ -209,3 +224,14 @@ Blowfish を手動でアップデートするには、テーマの最新コピ
2. アーカイブを解凍し、フォルダ名を `blowfish` に変更して、Hugo プロジェクトのルートフォルダ内の `themes/` ディレクトリに移動します。すべてのテーマファイルを置き換えるには、既存のディレクトリを上書きする必要があります。
3. サイトを再びビルドし、すべてが期待通りに動作することを確認してください。
+---
+
+## v2 から v3 へのアップグレード
+
+Blowfish v3 は v2 のサイトと完全な後方互換性があります。新機能はすべてオプトインで、設定オプションの削除やテンプレート・パーシャルの名称変更はありません。アップグレード後も、新機能を有効にするまでサイトの見た目や動作は変わりません。
+
+- **Git サブモジュール:** いつも通り更新してください — `git submodule update --remote --merge`。それ以外の作業は不要です。
+- **Hugo モジュール:** `config/_default/module.toml` のインポートパスを `github.com/nunocoracao/blowfish/v2` から `github.com/nunocoracao/blowfish/v3` に変更し、`hugo mod get -u` を実行してください。
+- **手動インストール:** 上記の手順の通り、最新リリースをダウンロードしてテーマフォルダを置き換えてください。
+
+アップグレード後は、[設定ドキュメント]({{< ref "configuration" >}})で新しいオプトイン機能（フローティングヘッダー、ランディングレイアウト、背景キャンバス、読書プログレスバーなど）を確認してください。
diff --git a/exampleSite/content/docs/installation/index.md b/exampleSite/content/docs/installation/index.md
index bd026907..ed5a2023 100644
--- a/exampleSite/content/docs/installation/index.md
+++ b/exampleSite/content/docs/installation/index.md
@@ -14,6 +14,21 @@ Simply follow the standard Hugo [Quick Start](https://gohugo.io/getting-started/
Detailed installation instructions can be found below. Instructions for [updating the theme](#installing-updates) are also available.
+## Agent skill
+
+Blowfish ships an [agent skill](https://github.com/nunocoracao/blowfish/tree/main/.claude/skills/blowfish) that teaches AI coding agents — like Claude Code — how to install, configure, and build sites with the theme. If you use an agent to work on your site, install the skill so it knows its way around Blowfish's configuration files, layouts, front matter, and shortcodes.
+
+Install it from the Blowfish plugin marketplace in Claude Code:
+
+```shell
+/plugin marketplace add nunocoracao/blowfish
+/plugin install blowfish@blowfish
+```
+
+Alternatively, copy the skill folder into your site repository at `.claude/skills/blowfish/` — agents automatically pick up skills stored in a project's `.claude/skills/` directory.
+
+---
+
## Installation
These instructions will get you up and running using Hugo and Blowfish from a completely blank state. Most of the dependencies mentioned in this guide can be installed using the package manager of choice for your platform.
@@ -28,7 +43,7 @@ Make sure you are using **Hugo version 0.158.0** or later as the theme takes adv
You can find detailed installation instructions for your platform in the [Hugo docs](https://gohugo.io/getting-started/installing).
-### Blowfish Tools (recommended)
+### Blowfish Tools
We just launched a new CLI tool to help you get started with Blowfish. It will create a new Hugo project, install the theme and set up the theme configuration files for you. It's still in beta so please [report any issues you find](https://github.com/nunocoracao/blowfish-tools).
@@ -113,7 +128,7 @@ For this method you'll use Hugo to manage your themes. Hugo uses **Go** to initi
```toml
[[imports]]
disable = false
- path = "github.com/nunocoracao/blowfish/v2"
+ path = "github.com/nunocoracao/blowfish/v3"
```
4. Start your server using `hugo server` and the theme will be downloaded automatically.
@@ -210,3 +225,14 @@ Note that any local customisations you have made to the theme files will be lost
2. Extract the archive, rename the folder to `blowfish` and move it to the `themes/` directory inside your Hugo project's root folder. You will need to overwrite the existing directory to replace all the theme files.
3. Rebuild your site and check everything works as expected.
+---
+
+## Upgrading from v2 to v3
+
+Blowfish v3 is fully backwards compatible with v2 sites: all new features are opt-in, no configuration options were removed, and no templates or partials were renamed. Your site will look and behave the same after upgrading, until you enable the new features.
+
+- **Git submodule:** update as usual — `git submodule update --remote --merge`. Nothing else is required.
+- **Hugo module:** edit `config/_default/module.toml` and change the import path from `github.com/nunocoracao/blowfish/v2` to `github.com/nunocoracao/blowfish/v3`, then run `hugo mod get -u`.
+- **Manual install:** download the latest release and replace the theme folder, as described above.
+
+After upgrading, browse the [configuration docs]({{< ref "configuration" >}}) for the new opt-in options — the floating header, the landing homepage layout, the background canvas, the reading progress bar, and more.
diff --git a/exampleSite/content/docs/installation/index.pt-br.md b/exampleSite/content/docs/installation/index.pt-br.md
index a9d38666..ab426fd8 100644
--- a/exampleSite/content/docs/installation/index.pt-br.md
+++ b/exampleSite/content/docs/installation/index.pt-br.md
@@ -13,6 +13,21 @@ Simplesmente siga o procedimento padrão do Hugo [Início Rápido](https://gohug
Instruções detalhadas de instalação podem ser encontradas abaixo. Instruções para [atualizar o tema](#instalando-atualizações) também estão disponíveis.
+## Skill para agentes
+
+O Blowfish inclui uma [skill para agentes](https://github.com/nunocoracao/blowfish/tree/main/.claude/skills/blowfish) que ensina agentes de programação com IA — como o Claude Code — a instalar, configurar e criar sites com o tema. Se você usa um agente para trabalhar no seu site, instale a skill para que ele conheça os arquivos de configuração, os layouts, o front matter e os shortcodes do Blowfish.
+
+Instale-a a partir do marketplace de plugins do Blowfish no Claude Code:
+
+```shell
+/plugin marketplace add nunocoracao/blowfish
+/plugin install blowfish@blowfish
+```
+
+Como alternativa, copie a pasta da skill para o repositório do seu site em `.claude/skills/blowfish/` — os agentes carregam automaticamente as skills armazenadas no diretório `.claude/skills/` de um projeto.
+
+---
+
## Instalação
Estas instruções vão te ajudar a começar com Hugo e Blowfish a partir de um estado completamente vazio. A maioria das dependências mencionadas neste guia pode ser instalada usando o gerenciador de pacotes de sua escolha para sua plataforma.
@@ -27,7 +42,7 @@ Certifique-se de estar usando **Hugo versão 0.158.0** ou posterior, pois o tema
Você pode encontrar instruções de instalação detalhadas para sua plataforma na [documentação do Hugo](https://gohugo.io/getting-started/installing).
-### Blowfish Tools (recomendado)
+### Blowfish Tools
Acabamos de lançar uma nova ferramenta CLI para ajudá-lo a começar com o Blowfish. Ela criará um novo projeto Hugo, instalará o tema e configurará os arquivos de configuração do tema para você. Ainda está em beta, então por favor [reporte quaisquer problemas que encontrar](https://github.com/nunocoracao/blowfish-tools).
@@ -112,7 +127,7 @@ Para este método, você usará o Hugo para gerenciar seus temas. O Hugo usa **G
```toml
[[imports]]
disable = false
- path = "github.com/nunocoracao/blowfish/v2"
+ path = "github.com/nunocoracao/blowfish/v3"
```
4. Inicie seu servidor usando `hugo server` e o tema será baixado automaticamente.
@@ -209,3 +224,14 @@ Note que quaisquer personalizações locais que você tenha feito nos arquivos d
2. Extraia o arquivo, renomeie a pasta para `blowfish` e mova-a para o diretório `themes/` dentro da pasta raiz do seu projeto Hugo. Você precisará sobrescrever o diretório existente para substituir todos os arquivos do tema.
3. Reconstrua seu site e verifique se tudo funciona como esperado.
+---
+
+## Atualizando da v2 para a v3
+
+O Blowfish v3 é totalmente retrocompatível com sites v2: todas as novidades são opcionais, nenhuma opção de configuração foi removida e nenhum template ou partial foi renomeado. Seu site terá a mesma aparência e comportamento após a atualização, até que você ative os novos recursos.
+
+- **Submódulo Git:** atualize como de costume — `git submodule update --remote --merge`. Nada mais é necessário.
+- **Módulo Hugo:** edite `config/_default/module.toml` e altere o caminho de importação de `github.com/nunocoracao/blowfish/v2` para `github.com/nunocoracao/blowfish/v3`; depois execute `hugo mod get -u`.
+- **Instalação manual:** baixe a última versão e substitua a pasta do tema, como descrito acima.
+
+Após atualizar, consulte a [documentação de configuração]({{< ref "configuration" >}}) para conhecer as novas opções — o header flutuante, o layout landing, o fundo global, a barra de progresso de leitura e mais.
diff --git a/exampleSite/content/docs/installation/index.pt-pt.md b/exampleSite/content/docs/installation/index.pt-pt.md
index 3d3bd818..5b7c5add 100644
--- a/exampleSite/content/docs/installation/index.pt-pt.md
+++ b/exampleSite/content/docs/installation/index.pt-pt.md
@@ -13,6 +13,21 @@ Simplesmente siga o procedimento padrão do Hugo [Início Rápido](https://gohug
Instruções detalhadas de instalação podem ser encontradas abaixo. Instruções para [atualizar o tema](#instalar-atualizações) também estão disponíveis.
+## Skill para agentes
+
+O Blowfish inclui uma [skill para agentes](https://github.com/nunocoracao/blowfish/tree/main/.claude/skills/blowfish) que ensina agentes de programação com IA — como o Claude Code — a instalar, configurar e criar sites com o tema. Se utilizar um agente para trabalhar no seu site, instale a skill para que este conheça os ficheiros de configuração, os layouts, o front matter e os shortcodes do Blowfish.
+
+Instale-a a partir do marketplace de plugins do Blowfish no Claude Code:
+
+```shell
+/plugin marketplace add nunocoracao/blowfish
+/plugin install blowfish@blowfish
+```
+
+Em alternativa, copie a pasta da skill para o repositório do seu site em `.claude/skills/blowfish/` — os agentes carregam automaticamente as skills guardadas no diretório `.claude/skills/` de um projeto.
+
+---
+
## Instalação
Estas instruções irão ajudá-lo a começar com Hugo e Blowfish a partir de um estado completamente vazio. A maioria das dependências mencionadas neste guia pode ser instalada utilizando o gestor de pacotes da sua escolha para a sua plataforma.
@@ -27,7 +42,7 @@ Certifique-se de que está a utilizar **Hugo versão 0.158.0** ou posterior, poi
Pode encontrar instruções de instalação detalhadas para a sua plataforma na [documentação do Hugo](https://gohugo.io/getting-started/installing).
-### Blowfish Tools (recomendado)
+### Blowfish Tools
Acabámos de lançar uma nova ferramenta CLI para o ajudar a começar com o Blowfish. Irá criar um novo projeto Hugo, instalar o tema e configurar os ficheiros de configuração do tema por si. Ainda está em beta, por isso [reporte quaisquer problemas que encontrar](https://github.com/nunocoracao/blowfish-tools).
@@ -112,7 +127,7 @@ Para este método, utilizará o Hugo para gerir os seus temas. O Hugo utiliza **
```toml
[[imports]]
disable = false
- path = "github.com/nunocoracao/blowfish/v2"
+ path = "github.com/nunocoracao/blowfish/v3"
```
4. Inicie o seu servidor utilizando `hugo server` e o tema será transferido automaticamente.
@@ -209,3 +224,14 @@ Note que quaisquer personalizações locais que tenha feito aos ficheiros do tem
2. Extraia o arquivo, renomeie a pasta para `blowfish` e mova-a para o diretório `themes/` dentro da pasta raiz do seu projeto Hugo. Precisará de sobrescrever o diretório existente para substituir todos os ficheiros do tema.
3. Reconstrua o seu site e verifique se tudo funciona como esperado.
+---
+
+## Atualizar da v2 para a v3
+
+O Blowfish v3 é totalmente retrocompatível com sites v2: todas as novidades são opcionais, nenhuma opção de configuração foi removida e nenhum template ou partial foi renomeado. O seu site terá o mesmo aspeto e comportamento após a atualização, até ativar as novas funcionalidades.
+
+- **Submódulo Git:** atualize como habitualmente — `git submodule update --remote --merge`. Não é necessário mais nada.
+- **Módulo Hugo:** edite `config/_default/module.toml` e altere o caminho de importação de `github.com/nunocoracao/blowfish/v2` para `github.com/nunocoracao/blowfish/v3`; depois execute `hugo mod get -u`.
+- **Instalação manual:** transfira a última versão e substitua a pasta do tema, como descrito acima.
+
+Após atualizar, consulte a [documentação de configuração]({{< ref "configuration" >}}) para conhecer as novas opções — o header flutuante, o layout landing, o fundo global, a barra de progresso de leitura e mais.
diff --git a/exampleSite/content/docs/installation/index.zh-cn.md b/exampleSite/content/docs/installation/index.zh-cn.md
index 153aa983..84866d5e 100644
--- a/exampleSite/content/docs/installation/index.zh-cn.md
+++ b/exampleSite/content/docs/installation/index.zh-cn.md
@@ -13,6 +13,21 @@ series_order: 2
更详细的安装如下，[更新主题](#更新主题)的教程也可以看此文档。
+## 智能体技能
+
+Blowfish 附带一个[智能体技能](https://github.com/nunocoracao/blowfish/tree/main/.claude/skills/blowfish)，用于教 AI 编程智能体（如 Claude Code）如何安装、配置该主题并用它构建网站。如果你使用智能体来开发你的网站，安装此技能后，智能体就能熟悉 Blowfish 的配置文件、布局、front matter 和短代码。
+
+在 Claude Code 中通过 Blowfish 插件市场安装：
+
+```shell
+/plugin marketplace add nunocoracao/blowfish
+/plugin install blowfish@blowfish
+```
+
+或者，将技能文件夹复制到你网站仓库的 `.claude/skills/blowfish/` 目录 — 智能体会自动加载项目 `.claude/skills/` 目录中的技能。
+
+---
+
## 前言
本文将一步一步指导你学会使用 Hugo 和 Blowfish。本文中提到的大多数依赖项都可以在任意你想使用的平台中使用和安装。
@@ -27,7 +42,7 @@ series_order: 2
你可以在 [Hugo 文档](https://gohugo.io/getting-started/installing) 中找到不同平台更加详细的安装指南。
-### 使用 Blowfish-Tools 工具安装 (推荐)
+### 使用 Blowfish-Tools 工具安装
我们刚刚推出了一个 CLI 工具，帮助你首次使用 Blowfish。该工具将会为你创建一个新的 Hugo 项目、安装 Blowfish 主题并设置配置文件。但目前该工具仍处于测试阶段，如果遇到任何问题，请随时[提交 issues](https://github.com/nunocoracao/blowfish-tools)。
@@ -111,7 +126,7 @@ git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blo
```toml
[[imports]]
disable = false
- path = "github.com/nunocoracao/blowfish/v2"
+ path = "github.com/nunocoracao/blowfish/v3"
```
4. 使用`hugo server` 命令后，主题将会自动下载。
@@ -208,3 +223,14 @@ Hugo 将自动更新项目中所需的任何模块。它通过检查 `module.tom
2. 解压缩, 将文件夹重命名为 `blowfish`，并移动到根目录 `themes/` 目录下。你需要覆盖旧版以替换所有的主题文件。
3. 重建站点，并检查网站是否一切正常。
+---
+
+## 从 v2 升级到 v3
+
+Blowfish v3 与 v2 站点完全向后兼容：所有新功能均为可选启用，没有删除任何配置选项，也没有重命名任何模板或部件。升级后，在你启用新功能之前，站点的外观和行为保持不变。
+
+- **Git 子模块：** 照常更新 — `git submodule update --remote --merge`，无需其他操作。
+- **Hugo 模块：** 编辑 `config/_default/module.toml`，将导入路径从 `github.com/nunocoracao/blowfish/v2` 改为 `github.com/nunocoracao/blowfish/v3`，然后运行 `hugo mod get -u`。
+- **手动安装：** 按上文所述，下载最新版本并替换主题文件夹。
+
+升级后，请查看[配置文档]({{< ref "configuration" >}})了解新的可选功能 — 悬浮菜单、着陆页布局、全局背景、阅读进度条等。
diff --git a/exampleSite/content/docs/multi-author/index.de.md b/exampleSite/content/docs/multi-author/index.de.md
index 901e6f1f..30f5478f 100644
--- a/exampleSite/content/docs/multi-author/index.de.md
+++ b/exampleSite/content/docs/multi-author/index.de.md
@@ -1,5 +1,6 @@
---
title: "Mehrere Autoren"
+featureimage: "images/v3/multiple-authors.png"
weight: 8
draft: false
description: "Konfigurieren Sie mehrere Autoren für Ihre Artikel."
diff --git a/exampleSite/content/docs/multi-author/index.es.md b/exampleSite/content/docs/multi-author/index.es.md
index 49b7f0a5..27eab343 100644
--- a/exampleSite/content/docs/multi-author/index.es.md
+++ b/exampleSite/content/docs/multi-author/index.es.md
@@ -1,5 +1,6 @@
---
title: "Múltiples autores"
+featureimage: "images/v3/multiple-authors.png"
weight: 8
draft: false
description: "Configura múltiples autores para tus artículos."
diff --git a/exampleSite/content/docs/multi-author/index.fr.md b/exampleSite/content/docs/multi-author/index.fr.md
index 5992dab4..6c8071f6 100644
--- a/exampleSite/content/docs/multi-author/index.fr.md
+++ b/exampleSite/content/docs/multi-author/index.fr.md
@@ -1,5 +1,6 @@
---
title: "Auteurs multiples"
+featureimage: "images/v3/multiple-authors.png"
weight: 8
draft: false
description: "Configurez plusieurs auteurs pour vos articles."
diff --git a/exampleSite/content/docs/multi-author/index.it.md b/exampleSite/content/docs/multi-author/index.it.md
index 41be8573..eb080cdc 100644
--- a/exampleSite/content/docs/multi-author/index.it.md
+++ b/exampleSite/content/docs/multi-author/index.it.md
@@ -1,5 +1,6 @@
---
title: "Multiple Authors"
+featureimage: "images/v3/multiple-authors.png"
weight: 8
draft: false
description: "Configure multiple authors for your articles."
diff --git a/exampleSite/content/docs/multi-author/index.ja.md b/exampleSite/content/docs/multi-author/index.ja.md
index 9ebb0f57..0ec157de 100644
--- a/exampleSite/content/docs/multi-author/index.ja.md
+++ b/exampleSite/content/docs/multi-author/index.ja.md
@@ -1,5 +1,6 @@
---
title: "複数の著者"
+featureimage: "images/v3/multiple-authors.png"
weight: 8
draft: false
description: "記事に複数の著者を設定する。"
diff --git a/exampleSite/content/docs/multi-author/index.pt-br.md b/exampleSite/content/docs/multi-author/index.pt-br.md
index 58471298..ae66fde5 100644
--- a/exampleSite/content/docs/multi-author/index.pt-br.md
+++ b/exampleSite/content/docs/multi-author/index.pt-br.md
@@ -1,5 +1,6 @@
---
title: "Múltiplos autores"
+featureimage: "images/v3/multiple-authors.png"
weight: 8
draft: false
description: "Configure múltiplos autores para seus artigos."
diff --git a/exampleSite/content/docs/multi-author/index.pt-pt.md b/exampleSite/content/docs/multi-author/index.pt-pt.md
index 7cd459c8..0dac3024 100644
--- a/exampleSite/content/docs/multi-author/index.pt-pt.md
+++ b/exampleSite/content/docs/multi-author/index.pt-pt.md
@@ -1,5 +1,6 @@
---
title: "Múltiplos autores"
+featureimage: "images/v3/multiple-authors.png"
weight: 8
draft: false
description: "Configure múltiplos autores para os seus artigos."
diff --git a/exampleSite/content/docs/multi-author/index.zh-cn.md b/exampleSite/content/docs/multi-author/index.zh-cn.md
index 6d3b17b1..415bda2a 100644
--- a/exampleSite/content/docs/multi-author/index.zh-cn.md
+++ b/exampleSite/content/docs/multi-author/index.zh-cn.md
@@ -1,5 +1,6 @@
---
title: "多创作者模式"
+featureimage: "images/v3/multiple-authors.png"
weight: 8
draft: false
description: "为你的文章设置多个作者。"
diff --git a/exampleSite/content/docs/partials/index.de.md b/exampleSite/content/docs/partials/index.de.md
index 8c3c1311..39d80fca 100644
--- a/exampleSite/content/docs/partials/index.de.md
+++ b/exampleSite/content/docs/partials/index.de.md
@@ -1,5 +1,6 @@
---
title: "Partials"
+featureimage: "images/v3/partials.png"
weight: 9
draft: false
description: "Alle verfügbaren Partials in Blowfish."
diff --git a/exampleSite/content/docs/partials/index.es.md b/exampleSite/content/docs/partials/index.es.md
index 8975f46d..b5394b2f 100644
--- a/exampleSite/content/docs/partials/index.es.md
+++ b/exampleSite/content/docs/partials/index.es.md
@@ -1,5 +1,6 @@
---
title: "Partials"
+featureimage: "images/v3/partials.png"
weight: 9
draft: false
description: "Todos los partials disponibles en Blowfish."
diff --git a/exampleSite/content/docs/partials/index.fr.md b/exampleSite/content/docs/partials/index.fr.md
index 6b252d34..33c895bc 100644
--- a/exampleSite/content/docs/partials/index.fr.md
+++ b/exampleSite/content/docs/partials/index.fr.md
@@ -1,5 +1,6 @@
---
title: "Partials"
+featureimage: "images/v3/partials.png"
weight: 9
draft: false
description: "Tous les partials disponibles dans Blowfish."
diff --git a/exampleSite/content/docs/partials/index.it.md b/exampleSite/content/docs/partials/index.it.md
index 73d6644e..1074bd1a 100644
--- a/exampleSite/content/docs/partials/index.it.md
+++ b/exampleSite/content/docs/partials/index.it.md
@@ -1,5 +1,6 @@
---
title: "Partials"
+featureimage: "images/v3/partials.png"
weight: 9
draft: false
description: "All the partials available in Blowfish."
diff --git a/exampleSite/content/docs/partials/index.ja.md b/exampleSite/content/docs/partials/index.ja.md
index 6c23b890..90fdf14c 100644
--- a/exampleSite/content/docs/partials/index.ja.md
+++ b/exampleSite/content/docs/partials/index.ja.md
@@ -1,5 +1,6 @@
---
title: "パーシャル"
+featureimage: "images/v3/partials.png"
weight: 9
draft: false
description: "Blowfish で利用可能なすべてのパーシャル。"
diff --git a/exampleSite/content/docs/partials/index.pt-br.md b/exampleSite/content/docs/partials/index.pt-br.md
index 2318ddbb..41f19063 100644
--- a/exampleSite/content/docs/partials/index.pt-br.md
+++ b/exampleSite/content/docs/partials/index.pt-br.md
@@ -1,5 +1,6 @@
---
title: "Partials"
+featureimage: "images/v3/partials.png"
weight: 9
draft: false
description: "Todos os partials disponíveis no Blowfish."
diff --git a/exampleSite/content/docs/partials/index.pt-pt.md b/exampleSite/content/docs/partials/index.pt-pt.md
index d181aac3..0fc2a4fe 100644
--- a/exampleSite/content/docs/partials/index.pt-pt.md
+++ b/exampleSite/content/docs/partials/index.pt-pt.md
@@ -1,5 +1,6 @@
---
title: "Partials"
+featureimage: "images/v3/partials.png"
weight: 9
draft: false
description: "Todos os partials disponíveis no Blowfish."
diff --git a/exampleSite/content/docs/partials/index.zh-cn.md b/exampleSite/content/docs/partials/index.zh-cn.md
index faf7a184..f49cedf6 100644
--- a/exampleSite/content/docs/partials/index.zh-cn.md
+++ b/exampleSite/content/docs/partials/index.zh-cn.md
@@ -1,5 +1,6 @@
---
title: "局部模板(Partials)"
+featureimage: "images/v3/partials.png"
weight: 9
draft: false
description: "所有 Blowfish 可以配置的 Partials"
diff --git a/exampleSite/content/docs/series/index.de.md b/exampleSite/content/docs/series/index.de.md
index 502f4eb0..ac6d93cd 100644
--- a/exampleSite/content/docs/series/index.de.md
+++ b/exampleSite/content/docs/series/index.de.md
@@ -1,5 +1,6 @@
---
title: "Serien"
+featureimage: "images/v3/series.png"
weight: 12
draft: false
description: "Erfahren Sie, wie Sie Artikel zu einer Serie gruppieren."
diff --git a/exampleSite/content/docs/series/index.es.md b/exampleSite/content/docs/series/index.es.md
index 71fbca71..c92cc9e2 100644
--- a/exampleSite/content/docs/series/index.es.md
+++ b/exampleSite/content/docs/series/index.es.md
@@ -1,5 +1,6 @@
---
title: "Series"
+featureimage: "images/v3/series.png"
weight: 12
draft: false
description: "Aprende cómo agrupar artículos en una serie."
diff --git a/exampleSite/content/docs/series/index.fr.md b/exampleSite/content/docs/series/index.fr.md
index ed60e646..59394cec 100644
--- a/exampleSite/content/docs/series/index.fr.md
+++ b/exampleSite/content/docs/series/index.fr.md
@@ -1,5 +1,6 @@
---
title: "Séries"
+featureimage: "images/v3/series.png"
weight: 12
draft: false
description: "Apprenez à regrouper des articles dans une série."
diff --git a/exampleSite/content/docs/series/index.it.md b/exampleSite/content/docs/series/index.it.md
index d26208ad..6c617b2b 100644
--- a/exampleSite/content/docs/series/index.it.md
+++ b/exampleSite/content/docs/series/index.it.md
@@ -1,5 +1,6 @@
---
title: "Series"
+featureimage: "images/v3/series.png"
weight: 12
draft: false
description: "Learn how to group articles under a series."
diff --git a/exampleSite/content/docs/series/index.ja.md b/exampleSite/content/docs/series/index.ja.md
index dd4672ae..f166f3a3 100644
--- a/exampleSite/content/docs/series/index.ja.md
+++ b/exampleSite/content/docs/series/index.ja.md
@@ -1,5 +1,6 @@
---
title: "シリーズ"
+featureimage: "images/v3/series.png"
weight: 12
draft: false
description: "記事をシリーズの下にグループ化する方法を学びます。"
diff --git a/exampleSite/content/docs/series/index.pt-br.md b/exampleSite/content/docs/series/index.pt-br.md
index 6e9cc0e9..fdbaf35d 100644
--- a/exampleSite/content/docs/series/index.pt-br.md
+++ b/exampleSite/content/docs/series/index.pt-br.md
@@ -1,5 +1,6 @@
---
title: "Séries"
+featureimage: "images/v3/series.png"
weight: 12
draft: false
description: "Aprenda como agrupar artigos em uma série."
diff --git a/exampleSite/content/docs/series/index.pt-pt.md b/exampleSite/content/docs/series/index.pt-pt.md
index e691ac54..60944661 100644
--- a/exampleSite/content/docs/series/index.pt-pt.md
+++ b/exampleSite/content/docs/series/index.pt-pt.md
@@ -1,5 +1,6 @@
---
title: "Séries"
+featureimage: "images/v3/series.png"
weight: 12
draft: false
description: "Aprenda como agrupar artigos numa série."
diff --git a/exampleSite/content/docs/series/index.zh-cn.md b/exampleSite/content/docs/series/index.zh-cn.md
index 5de2df52..25bc7702 100644
--- a/exampleSite/content/docs/series/index.zh-cn.md
+++ b/exampleSite/content/docs/series/index.zh-cn.md
@@ -1,5 +1,6 @@
---
title: "系列"
+featureimage: "images/v3/series.png"
weight: 12
draft: false
description: "了解如何将文章分组到系列中。"
diff --git a/exampleSite/content/docs/shortcodes/index.de.md b/exampleSite/content/docs/shortcodes/index.de.md
index 643a4595..6bce2ee7 100644
--- a/exampleSite/content/docs/shortcodes/index.de.md
+++ b/exampleSite/content/docs/shortcodes/index.de.md
@@ -11,6 +11,128 @@ series_order: 8
Zusätzlich zu allen [Standard-Hugo-Shortcodes](https://gohugo.io/content-management/shortcodes/) fügt Blowfish einige zusätzliche für erweiterte Funktionalität hinzu.
+## Accordion
+
+`accordion` erstellt eine Reihe von auf- und zuklappbaren Panels. Verwenden Sie den Sub-Shortcode `accordionItem`, um jedes Element zu definieren. Mit dem Parameter `mode` können Sie steuern, ob mehrere Elemente gleichzeitig geöffnet sein können.
+
+
+| Parameter | Beschreibung |
+| --------- | --------------------------------------------------------------------------------------------------- |
+| `mode` | **Optional.** `collapse` (nur eines geöffnet) oder `open` (mehrere geöffnet). Standard: `collapse`. |
+| `separated` | **Optional.** `true`, um jedes Element als separate Karte anzuzeigen. Standard: `false` (verbundene Liste). |
+
+
+`accordionItem`-Parameter:
+
+
+| Parameter | Beschreibung |
+| --------- | --------------------------------------------------------------------------------------------------- |
+| `title` | **Erforderlich.** Titel, der in der Kopfzeile des Elements angezeigt wird. |
+| `open` | **Optional.** Auf `true` setzen, damit das Element standardmäßig geöffnet ist. |
+| `header` | **Optional.** Alias für `title`, aus Kompatibilität mit anderen Shortcodes beibehalten. |
+| `icon` | **Optional.** Name des Symbols, das vor dem Titel angezeigt wird. |
+| `align` | **Optional.** Textausrichtung innerhalb des Elements: `left`, `center`, `right` |
+
+
+**Beispiel 1: `mode="open"` (mehrere Elemente können gleichzeitig geöffnet sein) + `separated=true`**
+
+```md
+{{}}
+ {{}}
+ This item demonstrates Markdown rendering:
+ - **Bold text**
+ - Lists
+ - `inline code`
+ {{}}
+
+ {{}}
+ This item demonstrates shortcode rendering with md=false:
+
+ {{}}This is an inline alert.{{}}
+ {{}}
+{{}}
+```
+
+{{< accordion mode="open" separated=true >}}
+ {{< accordionItem title="Markdown example" icon="code" open=true >}}
+ This item demonstrates Markdown rendering:
+ - **Bold text**
+ - Lists
+ - `inline code`
+ {{< /accordionItem >}}
+
+ {{< accordionItem title="Shortcode example" md=false >}}
+ This item demonstrates shortcode rendering with md=false:
+
+ {{< alert >}}This is an inline alert.{{< /alert >}}
+ {{< /accordionItem >}}
+{{< /accordion >}}
+
+**Beispiel 2: `mode="collapse"` (nur ein Element gleichzeitig geöffnet)**
+
+```md
+{{}}
+ {{}}
+ This item uses Markdown with a short list:
+ 1. One
+ 2. Two
+ 3. Three
+ {{}}
+
+ {{}}
+ This item includes another shortcode:
+ {{}}Tip{{}}
+ {{}}
+{{}}
+```
+
+{{< accordion mode="collapse" >}}
+ {{< accordionItem title="First item" open=true >}}
+ This item uses Markdown with a short list:
+ 1. One
+ 2. Two
+ 3. Three
+ {{< /accordionItem >}}
+
+ {{< accordionItem title="Second item" md=false >}}
+ This item includes another shortcode:
+ {{< badge >}}Tip{{< /badge >}}
+ {{< /accordionItem >}}
+{{< /accordion >}}
+
+
+
+## Admonition
+
+Admonitions ermöglichen es Ihnen, auffällige Hinweisboxen in Ihren Inhalt einzufügen.
+
+Admonitions dienen einem ähnlichen Zweck wie der Alert-Shortcode, werden jedoch über Hugo-Render-Hooks implementiert. Der Hauptunterschied liegt in der Syntax: Admonitions verwenden Markdown-Syntax, was sie portabler über verschiedene Plattformen macht, während Shortcodes Hugo-spezifisch sind. Die Syntax ähnelt GitHub-Alerts:
+
+```md
+> [!NOTE]
+> Eine Admonition vom Typ Note.
+
+> [!TIP]+ Benutzerdefinierter Titel
+> Eine einklappbare Admonition mit benutzerdefiniertem Titel.
+```
+
+> [!NOTE]
+> Eine Admonition vom Typ Note.
+
+> [!TIP]+ Benutzerdefinierter Titel
+> Eine einklappbare Admonition mit benutzerdefiniertem Titel.
+
+Das Alert-Zeichen (`+` oder `-`) ist optional, um zu steuern, ob die Admonition eingeklappt ist oder nicht. Beachten Sie, dass das Alert-Zeichen nur mit Obsidian kompatibel ist.
+
+> [!INFO]- Unterstützte Typen
+> Gültige Admonition-Typen umfassen [GitHub-Alert-Typen](https://github.blog/changelog/2023-12-14-new-markdown-extension-alerts-provide-distinctive-styling-for-significant-content/) und [Obsidian-Callout-Typen](https://help.obsidian.md/callouts). Die Typen sind nicht case-sensitiv.
+>
+> **GitHub-Typen:** `NOTE`, `TIP`, `IMPORTANT`, `WARNING`, `CAUTION`
+> **Obsidian-Typen:** `note`, `abstract`, `info`, `todo`, `tip`, `success`, `question`, `warning`, `failure`, `danger`, `bug`, `example`, `quote`
+
+> [!INFO]- Admonition anpassen
+> Siehe die [Anleitung zur Anpassung von Admonition](https://github.com/nunocoracao/blowfish/blob/main/layouts/_default/_markup/render-blockquote.html).
+
## Alert
`alert` gibt seinen Inhalt als stilisierte Nachrichtenbox innerhalb Ihres Artikels aus. Es ist nützlich, um auf wichtige Informationen aufmerksam zu machen, die der Leser nicht übersehen sollte.
@@ -64,36 +186,38 @@ Dies ist ein Fehler!
-## Admonition
+## Ansible Galaxy Card
-Admonitions ermöglichen es Ihnen, auffällige Hinweisboxen in Ihren Inhalt einzufügen.
+`ansible` rendert eine Karte für einen [Ansible Galaxy](https://galaxy.ansible.com/)-Eintrag, der zur Build-Zeit abgerufen wird. Es akzeptiert entweder einen `role`- oder einen `collection`-Parameter, beide im Format `namespace.name`.
-Admonitions dienen einem ähnlichen Zweck wie der Alert-Shortcode, werden jedoch über Hugo-Render-Hooks implementiert. Der Hauptunterschied liegt in der Syntax: Admonitions verwenden Markdown-Syntax, was sie portabler über verschiedene Plattformen macht, während Shortcodes Hugo-spezifisch sind. Die Syntax ähnelt GitHub-Alerts:
+
+| Parameter | Beschreibung |
+| ------------ | ------------------------------------------------------------------------------------ |
+| `role` | [String] Galaxy-Rolle im Format `namespace.name`, z.B. `geerlingguy.docker` |
+| `collection` | [String] Galaxy-Collection im Format `namespace.name`, z.B. `community.general` |
+
+
+Setzen Sie pro Aufruf genau einen der Parameter `role` oder `collection`.
+
+Alle Kartenwerte werden zur Build-Zeit über Hugos `resources.GetRemote` abgerufen. Galaxy erlaubt keine Cross-Origin-Anfragen, daher wird die Karte im Browser nicht aktualisiert — bauen Sie die Website neu, um die Werte zu aktualisieren.
+
+**Beispiel 1: Rolle**
```md
-> [!NOTE]
-> Eine Admonition vom Typ Note.
-
-> [!TIP]+ Benutzerdefinierter Titel
-> Eine einklappbare Admonition mit benutzerdefiniertem Titel.
+{{}}
```
-> [!NOTE]
-> Eine Admonition vom Typ Note.
+{{< ansible role="geerlingguy.docker" >}}
-> [!TIP]+ Benutzerdefinierter Titel
-> Eine einklappbare Admonition mit benutzerdefiniertem Titel.
+**Beispiel 2: Collection**
-Das Alert-Zeichen (`+` oder `-`) ist optional, um zu steuern, ob die Admonition eingeklappt ist oder nicht. Beachten Sie, dass das Alert-Zeichen nur mit Obsidian kompatibel ist.
+```md
+{{}}
+```
-> [!INFO]- Unterstützte Typen
-> Gültige Admonition-Typen umfassen [GitHub-Alert-Typen](https://github.blog/changelog/2023-12-14-new-markdown-extension-alerts-provide-distinctive-styling-for-significant-content/) und [Obsidian-Callout-Typen](https://help.obsidian.md/callouts). Die Typen sind nicht case-sensitiv.
->
-> **GitHub-Typen:** `NOTE`, `TIP`, `IMPORTANT`, `WARNING`, `CAUTION`
-> **Obsidian-Typen:** `note`, `abstract`, `info`, `todo`, `tip`, `success`, `question`, `warning`, `failure`, `danger`, `bug`, `example`, `quote`
+{{< ansible collection="community.general" >}}
-> [!INFO]- Admonition anpassen
-> Siehe die [Anleitung zur Anpassung von Admonition](https://github.com/nunocoracao/blowfish/blob/main/layouts/_default/_markup/render-blockquote.html).
+
## Article
@@ -273,6 +397,85 @@ Dieser Shortcode ermöglicht das einfache Importieren von Code aus externen Quel
+
+## Feature grid
+
+Erstellen Sie ansprechende, responsive Feature-Bereiche, ohne Präsentations-Markup zu wiederholen. Verwenden Sie `feature-grid` als Container und fügen Sie für jedes Element einen `feature`-Shortcode hinzu. Das Raster verwendet auf großen Bildschirmen standardmäßig drei Spalten und kann auf vier eingestellt werden.
+
+
+| Parameter | Beschreibung |
+| --- | --- |
+| `columns` | Optionale Anzahl der Spalten auf großen Bildschirmen: `3` (Standard) oder `4`. |
+| `icon` | Symbolname für ein Feature. Standard: `wand-magic-sparkles`. |
+| `title` | Titel des Features. Markdown wird unterstützt. |
+| `url` | Optionales Ziel für den Feature-Link. |
+| `label` | Beschriftung des Links. Standard: `Learn more`. |
+
+
+**Beispiel:**
+
+```md
+{{}}
+{{}}
+Start from a thoughtful default, then adjust every meaningful detail.
+{{}}
+{{}}
+Compose rich content with small, reusable building blocks.
+{{}}
+{{}}
+Accessible defaults, responsive layouts, and dark mode included.
+{{}}
+{{}}
+```
+
+{{< feature-grid >}}
+{{< feature icon="wand-magic-sparkles" title="Make it yours" url="/docs/configuration/" >}}
+Start from a thoughtful default, then adjust every meaningful detail.
+{{< /feature >}}
+{{< feature icon="file-lines" title="Publish faster" url="/docs/shortcodes/" label="Browse shortcodes" >}}
+Compose rich content with small, reusable building blocks.
+{{< /feature >}}
+{{< feature icon="heart" title="Built for people" >}}
+Accessible defaults, responsive layouts, and dark mode included.
+{{< /feature >}}
+{{< /feature-grid >}}
+
+
+
## Figure
Blowfish enthält einen `figure`-Shortcode zum Hinzufügen von Bildern zu Inhalten. Der Shortcode ersetzt die grundlegende Hugo-Funktionalität, um zusätzliche Leistungsvorteile zu bieten.
@@ -360,13 +563,13 @@ Um Bilder zur Galerie hinzuzufügen, verwenden Sie `img`-Tags für jedes Bild un
```
{{< gallery >}}
-
-
-
-
-
-
-
+
+
+
+
+
+
+
{{< /gallery >}}
@@ -386,13 +589,13 @@ Um Bilder zur Galerie hinzuzufügen, verwenden Sie `img`-Tags für jedes Bild un
```
{{< gallery >}}
-
-
-
-
-
-
-
+
+
+
+
+
+
+
{{< /gallery >}}
@@ -730,6 +933,44 @@ Weitere Mermaid-Beispiele finden Sie auf der Seite [Diagramme und Flussdiagramme
+## Stats
+
+Verwenden Sie `stats` und `stat`, um prägnante, aussagekräftige Kennzahlen in einem responsiven Raster darzustellen. Das Raster verwendet auf großen Bildschirmen standardmäßig drei Spalten, mit `columns="4"` vier.
+
+```md
+{{}}
+{{}}Compose pages without bespoke templates.{{}}
+{{}}Keep your content in Markdown.{{}}
+{{}}Start with Hugo and Blowfish.{{}}
+{{}}
+```
+
+{{< stats >}}
+{{< stat value="40+" label="Shortcodes" >}}Compose pages without bespoke templates.{{< /stat >}}
+{{< stat value="100%" label="Portable" >}}Keep your content in Markdown.{{< /stat >}}
+{{< stat value="0" label="Required plugins" >}}Start with Hugo and Blowfish.{{< /stat >}}
+{{< /stats >}}
+
+
+
+## Steps
+
+Verwenden Sie `steps` und `step` für Onboarding, Prozesse, Roadmaps und Tutorials.
+
+```md
+{{}}
+{{}}Choose a colour scheme and homepage layout.{{}}
+{{}}Use standard Markdown and shortcodes.{{}}
+{{}}
+```
+
+{{< steps >}}
+{{< step number="1" title="Configure the theme" >}}Choose a colour scheme and homepage layout.{{< /step >}}
+{{< step number="2" title="Write your content" >}}Use standard Markdown and shortcodes.{{< /step >}}
+{{< /steps >}}
+
+
+
## Swatches
`swatches` gibt eine Reihe von bis zu drei verschiedenen Farben aus, um Farbelelemente wie eine Farbpalette zu präsentieren. Dieser Shortcode nimmt die `HEX`-Codes jeder Farbe und erstellt die visuellen Elemente für jede.
@@ -885,13 +1126,13 @@ Mit HTML-Code
{{< timelineItem icon="star" header="Shortcodes" badge="AWESOME" >}}
Mit anderen Shortcodes
{{< gallery >}}
-
-
-
-
-
-
-
+
+
+
+
+
+
+
{{< /gallery >}}
{{}}
{{< timelineItem icon="code" header="Another Awesome Header">}}
diff --git a/exampleSite/content/docs/shortcodes/index.es.md b/exampleSite/content/docs/shortcodes/index.es.md
index 616e6f9b..a56d50b3 100644
--- a/exampleSite/content/docs/shortcodes/index.es.md
+++ b/exampleSite/content/docs/shortcodes/index.es.md
@@ -11,6 +11,127 @@ series_order: 8
Además de todos los [shortcodes predeterminados de Hugo](https://gohugo.io/content-management/shortcodes/), Blowfish añade algunos adicionales para funcionalidad extra.
+## Accordion
+
+`accordion` crea un conjunto de paneles plegables. Usa el sub-shortcode `accordionItem` para definir cada elemento. Puedes controlar si varios elementos pueden estar abiertos al mismo tiempo mediante el parámetro `mode`.
+
+
+| Parámetro | Descripción |
+| --------- | --------------------------------------------------------------------------------------------------- |
+| `mode` | **Opcional.** `collapse` (solo uno abierto) u `open` (varios abiertos). Por defecto `collapse`. |
+| `separated` | **Opcional.** `true` para mostrar cada elemento como una tarjeta separada. Por defecto `false` (lista unida). |
+
+
+Parámetros de `accordionItem`:
+
+
+| Parámetro | Descripción |
+| --------- | --------------------------------------------------------------------------------------------------- |
+| `title` | **Requerido.** Título que se muestra en la cabecera del elemento. |
+| `open` | **Opcional.** Establécelo en `true` para que el elemento esté abierto por defecto. |
+| `header` | **Opcional.** Alias de `title`, mantenido por compatibilidad con otros shortcodes. |
+| `icon` | **Opcional.** Nombre del icono a mostrar antes del título. |
+| `align` | **Opcional.** Alinea el texto dentro del elemento: `left`, `center`, `right` |
+
+
+**Ejemplo 1: `mode="open"` (varios elementos pueden estar abiertos) + `separated=true`**
+
+```md
+{{}}
+ {{}}
+ This item demonstrates Markdown rendering:
+ - **Bold text**
+ - Lists
+ - `inline code`
+ {{}}
+
+ {{}}
+ This item demonstrates shortcode rendering with md=false:
+
+ {{}}This is an inline alert.{{}}
+ {{}}
+{{}}
+```
+
+{{< accordion mode="open" separated=true >}}
+ {{< accordionItem title="Markdown example" icon="code" open=true >}}
+ This item demonstrates Markdown rendering:
+ - **Bold text**
+ - Lists
+ - `inline code`
+ {{< /accordionItem >}}
+
+ {{< accordionItem title="Shortcode example" md=false >}}
+ This item demonstrates shortcode rendering with md=false:
+
+ {{< alert >}}This is an inline alert.{{< /alert >}}
+ {{< /accordionItem >}}
+{{< /accordion >}}
+
+**Ejemplo 2: `mode="collapse"` (solo un elemento abierto a la vez)**
+
+```md
+{{}}
+ {{}}
+ This item uses Markdown with a short list:
+ 1. One
+ 2. Two
+ 3. Three
+ {{}}
+
+ {{}}
+ This item includes another shortcode:
+ {{}}Tip{{}}
+ {{}}
+{{}}
+```
+
+{{< accordion mode="collapse" >}}
+ {{< accordionItem title="First item" open=true >}}
+ This item uses Markdown with a short list:
+ 1. One
+ 2. Two
+ 3. Three
+ {{< /accordionItem >}}
+
+ {{< accordionItem title="Second item" md=false >}}
+ This item includes another shortcode:
+ {{< badge >}}Tip{{< /badge >}}
+ {{< /accordionItem >}}
+{{< /accordion >}}
+
+
+
+## Admonition
+
+Las admonitions te permiten insertar llamativos cuadros de aviso en tu contenido.
+
+Las admonitions sirven un propósito similar al shortcode alert pero se implementan mediante hooks de renderizado de Hugo. La diferencia clave es la sintaxis: las admonitions usan sintaxis Markdown, haciéndolas más portables entre diferentes plataformas, mientras que los shortcodes son específicos de Hugo. La sintaxis se parece a las alertas de GitHub:
+
+```md
+> [!NOTE]
+> Una admonition de tipo Note.
+
+> [!TIP]+ Título personalizado
+> Una admonition plegable con título personalizado.
+```
+
+> [!NOTE]
+> Una admonition de tipo Note.
+
+> [!TIP]+ Título personalizado
+> Una admonition plegable con título personalizado.
+
+El signo de alerta (`+` o `-`) es opcional para controlar si la admonition está plegada o no. Ten en cuenta que el signo de alerta solo es compatible con Obsidian.
+
+> [!INFO]- Tipos soportados
+> Los tipos válidos de admonition incluyen [tipos de alerta de GitHub](https://github.blog/changelog/2023-12-14-new-markdown-extension-alerts-provide-distinctive-styling-for-significant-content/) y [tipos de callout de Obsidian](https://help.obsidian.md/callouts). Los tipos no distinguen entre mayúsculas y minúsculas.
+>
+> **Tipos de GitHub:** `NOTE`, `TIP`, `IMPORTANT`, `WARNING`, `CAUTION`
+> **Tipos de Obsidian:** `note`, `abstract`, `info`, `todo`, `tip`, `success`, `question`, `warning`, `failure`, `danger`, `bug`, `example`, `quote`
+
+
+
## Alert
`alert` muestra su contenido como una caja de mensaje estilizada dentro de tu artículo. Es útil para llamar la atención sobre información importante que no quieres que el lector se pierda.
@@ -64,33 +185,36 @@ No olvides [seguirme](https://twitter.com/nunocoracao) en Twitter.
-## Admonition
+## Ansible Galaxy Card
-Las admonitions te permiten insertar llamativos cuadros de aviso en tu contenido.
+`ansible` muestra una tarjeta para una entrada de [Ansible Galaxy](https://galaxy.ansible.com/), obtenida en el momento de la compilación. Acepta un parámetro `role` o `collection`, ambos en formato `namespace.name`.
-Las admonitions sirven un propósito similar al shortcode alert pero se implementan mediante hooks de renderizado de Hugo. La diferencia clave es la sintaxis: las admonitions usan sintaxis Markdown, haciéndolas más portables entre diferentes plataformas, mientras que los shortcodes son específicos de Hugo. La sintaxis se parece a las alertas de GitHub:
+
+| Parámetro | Descripción |
+| ------------ | ------------------------------------------------------------------------------------ |
+| `role` | [String] rol de Galaxy en el formato `namespace.name`, p. ej. `geerlingguy.docker` |
+| `collection` | [String] colección de Galaxy en el formato `namespace.name`, p. ej. `community.general` |
+
+
+Establece exactamente uno de `role` o `collection` por llamada.
+
+Todos los valores de la tarjeta se obtienen en el momento de la compilación mediante `resources.GetRemote` de Hugo. Galaxy no permite solicitudes de origen cruzado, por lo que la tarjeta no se actualiza en el navegador: recompila el sitio para actualizar los valores.
+
+**Ejemplo 1: Rol**
```md
-> [!NOTE]
-> Una admonition de tipo Note.
-
-> [!TIP]+ Título personalizado
-> Una admonition plegable con título personalizado.
+{{}}
```
-> [!NOTE]
-> Una admonition de tipo Note.
+{{< ansible role="geerlingguy.docker" >}}
-> [!TIP]+ Título personalizado
-> Una admonition plegable con título personalizado.
+**Ejemplo 2: Colección**
-El signo de alerta (`+` o `-`) es opcional para controlar si la admonition está plegada o no. Ten en cuenta que el signo de alerta solo es compatible con Obsidian.
+```md
+{{}}
+```
-> [!INFO]- Tipos soportados
-> Los tipos válidos de admonition incluyen [tipos de alerta de GitHub](https://github.blog/changelog/2023-12-14-new-markdown-extension-alerts-provide-distinctive-styling-for-significant-content/) y [tipos de callout de Obsidian](https://help.obsidian.md/callouts). Los tipos no distinguen entre mayúsculas y minúsculas.
->
-> **Tipos de GitHub:** `NOTE`, `TIP`, `IMPORTANT`, `WARNING`, `CAUTION`
-> **Tipos de Obsidian:** `note`, `abstract`, `info`, `todo`, `tip`, `success`, `question`, `warning`, `failure`, `danger`, `bug`, `example`, `quote`
+{{< ansible collection="community.general" >}}
@@ -272,6 +396,85 @@ Este shortcode permite importar código de fuentes externas fácilmente sin copi
+## CTA button
+
+Utiliza `cta` para una llamada a la acción clara y accesible dentro de documentación, páginas de destino o contenido extenso.
+
+
+| Parámetro | Descripción |
+| --- | --- |
+| `url` | URL de destino. Por defecto `#`. |
+| `label` | Texto del botón. Por defecto `Learn more`. |
+| `style` | `primary` (por defecto) u `outline`. |
+
+
+```md
+{{}}
+{{}}
+```
+
+{{< cta url="/docs/installation/" label="Start building" >}}
+
+{{< cta url="/docs/configuration/" label="Explore configuration" style="outline" >}}
+
+
+
+## Feature grid
+
+Crea secciones de características pulidas y adaptables sin repetir el marcado de presentación. Utiliza `feature-grid` como contenedor y añade un shortcode `feature` por cada elemento. La cuadrícula usa por defecto tres columnas en pantallas grandes y puede configurarse en cuatro.
+
+
+| Parámetro | Descripción |
+| --- | --- |
+| `columns` | Número opcional de columnas en pantallas grandes: `3` (por defecto) o `4`. |
+| `icon` | Nombre del icono de una característica. Por defecto `wand-magic-sparkles`. |
+| `title` | Título de la característica. Se admite Markdown. |
+| `url` | Destino opcional para el enlace de la característica. |
+| `label` | Etiqueta del enlace. Por defecto `Learn more`. |
+
+
+**Ejemplo:**
+
+```md
+{{}}
+{{}}
+Start from a thoughtful default, then adjust every meaningful detail.
+{{}}
+{{}}
+Compose rich content with small, reusable building blocks.
+{{}}
+{{}}
+Accessible defaults, responsive layouts, and dark mode included.
+{{}}
+{{}}
+```
+
+{{< feature-grid >}}
+{{< feature icon="wand-magic-sparkles" title="Make it yours" url="/docs/configuration/" >}}
+Start from a thoughtful default, then adjust every meaningful detail.
+{{< /feature >}}
+{{< feature icon="file-lines" title="Publish faster" url="/docs/shortcodes/" label="Browse shortcodes" >}}
+Compose rich content with small, reusable building blocks.
+{{< /feature >}}
+{{< feature icon="heart" title="Built for people" >}}
+Accessible defaults, responsive layouts, and dark mode included.
+{{< /feature >}}
+{{< /feature-grid >}}
+
+
+
## Figure
Blowfish incluye un shortcode `figure` para añadir imágenes al contenido. El shortcode reemplaza la funcionalidad base de Hugo para proporcionar beneficios de rendimiento adicionales.
@@ -359,13 +562,13 @@ Para añadir imágenes a la galería, usa etiquetas `img` para cada imagen y añ
```
{{< gallery >}}
-
-
-
-
-
-
-
+
+
+
+
+
+
+
{{< /gallery >}}
@@ -385,13 +588,13 @@ Para añadir imágenes a la galería, usa etiquetas `img` para cada imagen y añ
```
{{< gallery >}}
-
-
-
-
-
-
-
+
+
+
+
+
+
+
{{< /gallery >}}
@@ -729,6 +932,44 @@ Puedes ver ejemplos adicionales de Mermaid en la página de [ejemplos de diagram
+## Stats
+
+Utiliza `stats` y `stat` para presentar métricas concisas y de alto impacto en una cuadrícula adaptable. La cuadrícula usa tres columnas en pantallas grandes por defecto, o cuatro con `columns="4"`.
+
+```md
+{{}}
+{{}}Compose pages without bespoke templates.{{}}
+{{}}Keep your content in Markdown.{{}}
+{{}}Start with Hugo and Blowfish.{{}}
+{{}}
+```
+
+{{< stats >}}
+{{< stat value="40+" label="Shortcodes" >}}Compose pages without bespoke templates.{{< /stat >}}
+{{< stat value="100%" label="Portable" >}}Keep your content in Markdown.{{< /stat >}}
+{{< stat value="0" label="Required plugins" >}}Start with Hugo and Blowfish.{{< /stat >}}
+{{< /stats >}}
+
+
+
+## Steps
+
+Utiliza `steps` y `step` para procesos de incorporación, flujos de trabajo, hojas de ruta y tutoriales.
+
+```md
+{{}}
+{{}}Choose a colour scheme and homepage layout.{{}}
+{{}}Use standard Markdown and shortcodes.{{}}
+{{}}
+```
+
+{{< steps >}}
+{{< step number="1" title="Configure the theme" >}}Choose a colour scheme and homepage layout.{{< /step >}}
+{{< step number="2" title="Write your content" >}}Use standard Markdown and shortcodes.{{< /step >}}
+{{< /steps >}}
+
+
+
## Swatches
`swatches` muestra un conjunto de hasta tres colores diferentes para mostrar elementos de color como una paleta de colores. Este shortcode toma los códigos `HEX` de cada color y crea los elementos visuales para cada uno.
@@ -884,13 +1125,13 @@ Con código HTML
{{< timelineItem icon="star" header="Shortcodes" badge="AWESOME" >}}
Con otros shortcodes
{{< gallery >}}
-
-
-
-
-
-
-
+
+
+
+
+
+
+
{{< /gallery >}}
{{}}
{{< timelineItem icon="code" header="Another Awesome Header">}}
diff --git a/exampleSite/content/docs/shortcodes/index.fr.md b/exampleSite/content/docs/shortcodes/index.fr.md
index 7f36334b..2cbdcb20 100644
--- a/exampleSite/content/docs/shortcodes/index.fr.md
+++ b/exampleSite/content/docs/shortcodes/index.fr.md
@@ -11,6 +11,127 @@ series_order: 8
En plus de tous les [shortcodes Hugo par défaut](https://gohugo.io/content-management/shortcodes/), Blowfish en ajoute quelques-uns supplémentaires pour des fonctionnalités avancées.
+## Accordion
+
+`accordion` crée un ensemble de panneaux repliables. Utilisez le sous-shortcode `accordionItem` pour définir chaque élément. Vous pouvez contrôler si plusieurs éléments peuvent être ouverts en même temps avec le paramètre `mode`.
+
+
+| Paramètre | Description |
+| --------- | --------------------------------------------------------------------------------------------------- |
+| `mode` | **Optionnel.** `collapse` (un seul ouvert) ou `open` (plusieurs ouverts). Par défaut `collapse`. |
+| `separated` | **Optionnel.** `true` pour afficher chaque élément comme une carte séparée. Par défaut `false` (liste jointe). |
+
+
+Paramètres de `accordionItem` :
+
+
+| Paramètre | Description |
+| --------- | --------------------------------------------------------------------------------------------------- |
+| `title` | **Requis.** Titre affiché dans l'en-tête de l'élément. |
+| `open` | **Optionnel.** Définissez-le sur `true` pour que l'élément soit ouvert par défaut. |
+| `header` | **Optionnel.** Alias de `title`, conservé pour la compatibilité avec d'autres shortcodes. |
+| `icon` | **Optionnel.** Nom de l'icône à afficher avant le titre. |
+| `align` | **Optionnel.** Alignement du texte dans l'élément : `left`, `center`, `right` |
+
+
+**Exemple 1 : `mode="open"` (plusieurs éléments peuvent être ouverts) + `separated=true`**
+
+```md
+{{}}
+ {{}}
+ This item demonstrates Markdown rendering:
+ - **Bold text**
+ - Lists
+ - `inline code`
+ {{}}
+
+ {{}}
+ This item demonstrates shortcode rendering with md=false:
+
+ {{}}This is an inline alert.{{}}
+ {{}}
+{{}}
+```
+
+{{< accordion mode="open" separated=true >}}
+ {{< accordionItem title="Markdown example" icon="code" open=true >}}
+ This item demonstrates Markdown rendering:
+ - **Bold text**
+ - Lists
+ - `inline code`
+ {{< /accordionItem >}}
+
+ {{< accordionItem title="Shortcode example" md=false >}}
+ This item demonstrates shortcode rendering with md=false:
+
+ {{< alert >}}This is an inline alert.{{< /alert >}}
+ {{< /accordionItem >}}
+{{< /accordion >}}
+
+**Exemple 2 : `mode="collapse"` (un seul élément ouvert à la fois)**
+
+```md
+{{}}
+ {{}}
+ This item uses Markdown with a short list:
+ 1. One
+ 2. Two
+ 3. Three
+ {{}}
+
+ {{}}
+ This item includes another shortcode:
+ {{}}Tip{{}}
+ {{}}
+{{}}
+```
+
+{{< accordion mode="collapse" >}}
+ {{< accordionItem title="First item" open=true >}}
+ This item uses Markdown with a short list:
+ 1. One
+ 2. Two
+ 3. Three
+ {{< /accordionItem >}}
+
+ {{< accordionItem title="Second item" md=false >}}
+ This item includes another shortcode:
+ {{< badge >}}Tip{{< /badge >}}
+ {{< /accordionItem >}}
+{{< /accordion >}}
+
+
+
+## Admonition
+
+Les admonitions vous permettent d'insérer des encadrés d'avertissement accrocheurs dans votre contenu.
+
+Les admonitions servent un objectif similaire au shortcode alert mais sont implémentées via des hooks de rendu Hugo. La différence clé est la syntaxe : les admonitions utilisent la syntaxe Markdown, ce qui les rend plus portables entre différentes plateformes, tandis que les shortcodes sont spécifiques à Hugo. La syntaxe ressemble aux alertes GitHub :
+
+```md
+> [!NOTE]
+> Une admonition de type Note.
+
+> [!TIP]+ Titre personnalisé
+> Une admonition repliable avec un titre personnalisé.
+```
+
+> [!NOTE]
+> Une admonition de type Note.
+
+> [!TIP]+ Titre personnalisé
+> Une admonition repliable avec un titre personnalisé.
+
+Le signe d'alerte (`+` ou `-`) est optionnel pour contrôler si l'admonition est repliée ou non. Notez que le signe d'alerte n'est compatible qu'avec Obsidian.
+
+> [!INFO]- Types supportés
+> Les types d'admonition valides incluent les [types d'alerte GitHub](https://github.blog/changelog/2023-12-14-new-markdown-extension-alerts-provide-distinctive-styling-for-significant-content/) et les [types de callout Obsidian](https://help.obsidian.md/callouts). Les types ne sont pas sensibles à la casse.
+>
+> **Types GitHub :** `NOTE`, `TIP`, `IMPORTANT`, `WARNING`, `CAUTION`
+> **Types Obsidian :** `note`, `abstract`, `info`, `todo`, `tip`, `success`, `question`, `warning`, `failure`, `danger`, `bug`, `example`, `quote`
+
+
+
## Alert
`alert` affiche son contenu sous forme de boîte de message stylisée dans votre article. C'est utile pour attirer l'attention sur des informations importantes que vous ne voulez pas que le lecteur manque.
@@ -64,33 +185,36 @@ Ceci est une erreur !
-## Admonition
+## Ansible Galaxy Card
-Les admonitions vous permettent d'insérer des encadrés d'avertissement accrocheurs dans votre contenu.
+`ansible` affiche une carte pour une entrée [Ansible Galaxy](https://galaxy.ansible.com/), récupérée au moment de la compilation. Il accepte un paramètre `role` ou `collection`, tous deux au format `namespace.name`.
-Les admonitions servent un objectif similaire au shortcode alert mais sont implémentées via des hooks de rendu Hugo. La différence clé est la syntaxe : les admonitions utilisent la syntaxe Markdown, ce qui les rend plus portables entre différentes plateformes, tandis que les shortcodes sont spécifiques à Hugo. La syntaxe ressemble aux alertes GitHub :
+
+| Paramètre | Description |
+| ------------ | ------------------------------------------------------------------------------------ |
+| `role` | [String] rôle Galaxy au format `namespace.name`, par ex. `geerlingguy.docker` |
+| `collection` | [String] collection Galaxy au format `namespace.name`, par ex. `community.general` |
+
+
+Définissez exactement un seul des paramètres `role` ou `collection` par appel.
+
+Toutes les valeurs de la carte sont récupérées au moment de la compilation via `resources.GetRemote` de Hugo. Galaxy n'autorise pas les requêtes cross-origin, la carte n'est donc pas actualisée dans le navigateur — recompilez le site pour mettre à jour les valeurs.
+
+**Exemple 1 : Rôle**
```md
-> [!NOTE]
-> Une admonition de type Note.
-
-> [!TIP]+ Titre personnalisé
-> Une admonition repliable avec un titre personnalisé.
+{{}}
```
-> [!NOTE]
-> Une admonition de type Note.
+{{< ansible role="geerlingguy.docker" >}}
-> [!TIP]+ Titre personnalisé
-> Une admonition repliable avec un titre personnalisé.
+**Exemple 2 : Collection**
-Le signe d'alerte (`+` ou `-`) est optionnel pour contrôler si l'admonition est repliée ou non. Notez que le signe d'alerte n'est compatible qu'avec Obsidian.
+```md
+{{}}
+```
-> [!INFO]- Types supportés
-> Les types d'admonition valides incluent les [types d'alerte GitHub](https://github.blog/changelog/2023-12-14-new-markdown-extension-alerts-provide-distinctive-styling-for-significant-content/) et les [types de callout Obsidian](https://help.obsidian.md/callouts). Les types ne sont pas sensibles à la casse.
->
-> **Types GitHub :** `NOTE`, `TIP`, `IMPORTANT`, `WARNING`, `CAUTION`
-> **Types Obsidian :** `note`, `abstract`, `info`, `todo`, `tip`, `success`, `question`, `warning`, `failure`, `danger`, `bug`, `example`, `quote`
+{{< ansible collection="community.general" >}}
@@ -272,6 +396,85 @@ Ce shortcode permet d'importer facilement du code depuis des sources externes sa
+## CTA button
+
+Utilisez `cta` pour un appel à l'action clair et accessible dans la documentation, les pages d'atterrissage ou les contenus longs.
+
+
+| Paramètre | Description |
+| --- | --- |
+| `url` | URL de destination. Par défaut `#`. |
+| `label` | Texte du bouton. Par défaut `Learn more`. |
+| `style` | `primary` (par défaut) ou `outline`. |
+
+
+```md
+{{}}
+{{}}
+```
+
+{{< cta url="/docs/installation/" label="Start building" >}}
+
+{{< cta url="/docs/configuration/" label="Explore configuration" style="outline" >}}
+
+
+
+## Feature grid
+
+Créez des sections de fonctionnalités soignées et adaptatives sans répéter le balisage de présentation. Utilisez `feature-grid` comme conteneur, puis ajoutez un shortcode `feature` pour chaque élément. La grille utilise par défaut trois colonnes sur les grands écrans et peut être configurée sur quatre.
+
+
+| Paramètre | Description |
+| --- | --- |
+| `columns` | Nombre facultatif de colonnes sur grand écran : `3` (par défaut) ou `4`. |
+| `icon` | Nom de l'icône d'une fonctionnalité. Par défaut `wand-magic-sparkles`. |
+| `title` | Titre de la fonctionnalité. Markdown est pris en charge. |
+| `url` | Destination facultative du lien de la fonctionnalité. |
+| `label` | Libellé du lien. Par défaut `Learn more`. |
+
+
+**Exemple :**
+
+```md
+{{}}
+{{}}
+Start from a thoughtful default, then adjust every meaningful detail.
+{{}}
+{{}}
+Compose rich content with small, reusable building blocks.
+{{}}
+{{}}
+Accessible defaults, responsive layouts, and dark mode included.
+{{}}
+{{}}
+```
+
+{{< feature-grid >}}
+{{< feature icon="wand-magic-sparkles" title="Make it yours" url="/docs/configuration/" >}}
+Start from a thoughtful default, then adjust every meaningful detail.
+{{< /feature >}}
+{{< feature icon="file-lines" title="Publish faster" url="/docs/shortcodes/" label="Browse shortcodes" >}}
+Compose rich content with small, reusable building blocks.
+{{< /feature >}}
+{{< feature icon="heart" title="Built for people" >}}
+Accessible defaults, responsive layouts, and dark mode included.
+{{< /feature >}}
+{{< /feature-grid >}}
+
+
+
## Figure
Blowfish inclut un shortcode `figure` pour ajouter des images au contenu. Le shortcode remplace la fonctionnalité Hugo de base afin de fournir des avantages de performance supplémentaires.
@@ -359,13 +562,13 @@ Pour ajouter des images à la galerie, utilisez des balises `img` pour chaque im
```
{{< gallery >}}
-
-
-
-
-
-
-
+
+
+
+
+
+
+
{{< /gallery >}}
@@ -385,13 +588,13 @@ Pour ajouter des images à la galerie, utilisez des balises `img` pour chaque im
```
{{< gallery >}}
-
-
-
-
-
-
-
+
+
+
+
+
+
+
{{< /gallery >}}
@@ -729,6 +932,44 @@ Vous pouvez voir des exemples Mermaid supplémentaires sur la page [exemples de
+## Stats
+
+Utilisez `stats` et `stat` pour présenter des métriques concises et parlantes dans une grille adaptative. La grille utilise trois colonnes sur les grands écrans par défaut, ou quatre avec `columns="4"`.
+
+```md
+{{}}
+{{}}Compose pages without bespoke templates.{{}}
+{{}}Keep your content in Markdown.{{}}
+{{}}Start with Hugo and Blowfish.{{}}
+{{}}
+```
+
+{{< stats >}}
+{{< stat value="40+" label="Shortcodes" >}}Compose pages without bespoke templates.{{< /stat >}}
+{{< stat value="100%" label="Portable" >}}Keep your content in Markdown.{{< /stat >}}
+{{< stat value="0" label="Required plugins" >}}Start with Hugo and Blowfish.{{< /stat >}}
+{{< /stats >}}
+
+
+
+## Steps
+
+Utilisez `steps` et `step` pour l'intégration, les processus, les feuilles de route et les tutoriels.
+
+```md
+{{}}
+{{}}Choose a colour scheme and homepage layout.{{}}
+{{}}Use standard Markdown and shortcodes.{{}}
+{{}}
+```
+
+{{< steps >}}
+{{< step number="1" title="Configure the theme" >}}Choose a colour scheme and homepage layout.{{< /step >}}
+{{< step number="2" title="Write your content" >}}Use standard Markdown and shortcodes.{{< /step >}}
+{{< /steps >}}
+
+
+
## Swatches
`swatches` affiche un ensemble de jusqu'à trois couleurs différentes pour présenter des éléments de couleur comme une palette de couleurs. Ce shortcode prend les codes `HEX` de chaque couleur et crée les éléments visuels pour chacune.
@@ -884,13 +1125,13 @@ Avec du code HTML
{{< timelineItem icon="star" header="Shortcodes" badge="AWESOME" >}}
Avec d'autres shortcodes
{{< gallery >}}
-
-
-
-
-
-
-
+
+
+
+
+
+
+
{{< /gallery >}}
{{}}
{{< timelineItem icon="code" header="Another Awesome Header">}}
diff --git a/exampleSite/content/docs/shortcodes/index.it.md b/exampleSite/content/docs/shortcodes/index.it.md
index 04996f9d..39aaee86 100644
--- a/exampleSite/content/docs/shortcodes/index.it.md
+++ b/exampleSite/content/docs/shortcodes/index.it.md
@@ -11,6 +11,129 @@ series_order: 8
In addition to all the [default Hugo shortcodes](https://gohugo.io/content-management/shortcodes/), Blowfish adds a few extras for additional functionality.
+## Accordion
+
+`accordion` creates a collapsible set of panels. Use the `accordionItem` sub-shortcode to define each item. You can control whether multiple items can be open at the same time using the `mode` parameter.
+
+
+| Parameter | Description |
+| --------- | ------------------------------------------------------------------------------------------------- |
+| `mode` | **Optional.** `collapse` (single open) or `open` (multiple open). Defaults to `collapse`. |
+| `separated` | **Optional.** `true` to show each item as a separate card. Defaults to `false` (joined list). |
+
+
+`accordionItem` parameters:
+
+
+| Parameter | Description |
+| --------- | --------------------------------------------------------------------------------------------------- |
+| `title` | **Required.** Title shown in the item header. |
+| `open` | **Optional.** Set to `true` to have the item open by default. |
+| `header` | **Optional.** Alias for `title`, kept for compatibility with other shortcodes. |
+| `icon` | **Optional.** Icon name to display before the title. |
+| `align` | **Optional.** Align text within the item: `left`, `center`, `right` |
+
+
+**Example 1: `mode="open"` (multiple items can be open) + `separated=true`**
+
+```md
+{{}}
+ {{}}
+ This item demonstrates Markdown rendering:
+ - **Bold text**
+ - Lists
+ - `inline code`
+ {{}}
+
+ {{}}
+ This item demonstrates shortcode rendering with md=false:
+
+ {{}}This is an inline alert.{{}}
+ {{}}
+{{}}
+```
+
+{{< accordion mode="open" separated=true >}}
+ {{< accordionItem title="Markdown example" icon="code" open=true >}}
+ This item demonstrates Markdown rendering:
+ - **Bold text**
+ - Lists
+ - `inline code`
+ {{< /accordionItem >}}
+
+ {{< accordionItem title="Shortcode example" md=false >}}
+ This item demonstrates shortcode rendering with md=false:
+
+ {{< alert >}}This is an inline alert.{{< /alert >}}
+ {{< /accordionItem >}}
+{{< /accordion >}}
+
+**Example 2: `mode="collapse"` (only one item open at a time)**
+
+```md
+{{}}
+ {{}}
+ This item uses Markdown with a short list:
+ 1. One
+ 2. Two
+ 3. Three
+ {{}}
+
+ {{}}
+ This item includes another shortcode:
+ {{}}Tip{{}}
+ {{}}
+{{}}
+```
+
+{{< accordion mode="collapse" >}}
+ {{< accordionItem title="First item" open=true >}}
+ This item uses Markdown with a short list:
+ 1. One
+ 2. Two
+ 3. Three
+ {{< /accordionItem >}}
+
+ {{< accordionItem title="Second item" md=false >}}
+ This item includes another shortcode:
+ {{< badge >}}Tip{{< /badge >}}
+ {{< /accordionItem >}}
+{{< /accordion >}}
+
+
+
+## Admonition
+
+Admonitions allow you to insert eye-catching callout boxes in your content.
+
+Admonitions serve a similar purpose as the alert shortcode but are implemented via Hugo render hooks. The key difference is syntax: admonitions use Markdown syntax, making them more portable across different platforms, whereas shortcodes are specific to Hugo. The syntax resembles GitHub alerts:
+
+```md
+> [!TIP]
+> A Tip type admonition.
+
+> [!TIP]+ Custom Title
+> A collapsible admonition with custom title.
+{icon="twitter"}
+```
+
+> [!TIP]
+> A Tip type admonition.
+
+> [!TIP]+ Custom Title
+> A collapsible admonition with custom title.
+{icon="twitter"}
+
+The alert sign (`+` or `-`) is optional to control whether the admonition is folded or not. Note that alert sign is only compatible in Obsidian.
+
+> [!INFO]- Supported types
+> Valid admonition types include [GitHub alert types](https://github.blog/changelog/2023-12-14-new-markdown-extension-alerts-provide-distinctive-styling-for-significant-content/) and [Obsidian callout types](https://help.obsidian.md/callouts). The types are case-insensitive.
+>
+> **GitHub types:** `NOTE`, `TIP`, `IMPORTANT`, `WARNING`, `CAUTION`
+> **Obsidian types:** `note`, `abstract`, `info`, `todo`, `tip`, `success`, `question`, `warning`, `failure`, `danger`, `bug`, `example`, `quote`
+
+
+
## Alert
`alert` outputs its contents as a stylised message box within your article. It's useful for drawing attention to important information that you don't want the reader to miss.
@@ -64,35 +187,36 @@ This is an error!
-## Admonition
+## Ansible Galaxy Card
-Admonitions allow you to insert eye-catching callout boxes in your content.
+`ansible` renders a card for an [Ansible Galaxy](https://galaxy.ansible.com/) entry, fetched at build time. It accepts either a `role` or a `collection` parameter, both in `namespace.name` form.
-Admonitions serve a similar purpose as the alert shortcode but are implemented via Hugo render hooks. The key difference is syntax: admonitions use Markdown syntax, making them more portable across different platforms, whereas shortcodes are specific to Hugo. The syntax resembles GitHub alerts:
+
+| Parameter | Description |
+| ------------ | ------------------------------------------------------------------------------------ |
+| `role` | [String] Galaxy role in the format `namespace.name`, e.g. `geerlingguy.docker` |
+| `collection` | [String] Galaxy collection in the format `namespace.name`, e.g. `community.general` |
+
+
+Set exactly one of `role` or `collection` per call.
+
+All card values are fetched at build time via Hugo's `resources.GetRemote`. Galaxy does not allow cross-origin requests, so the card is not refreshed in the browser — rebuild the site to update the values.
+
+**Example 1: Role**
```md
-> [!TIP]
-> A Tip type admonition.
-
-> [!TIP]+ Custom Title
-> A collapsible admonition with custom title.
-{icon="twitter"}
+{{}}
```
-> [!TIP]
-> A Tip type admonition.
+{{< ansible role="geerlingguy.docker" >}}
-> [!TIP]+ Custom Title
-> A collapsible admonition with custom title.
-{icon="twitter"}
+**Example 2: Collection**
-The alert sign (`+` or `-`) is optional to control whether the admonition is folded or not. Note that alert sign is only compatible in Obsidian.
+```md
+{{}}
+```
-> [!INFO]- Supported types
-> Valid admonition types include [GitHub alert types](https://github.blog/changelog/2023-12-14-new-markdown-extension-alerts-provide-distinctive-styling-for-significant-content/) and [Obsidian callout types](https://help.obsidian.md/callouts). The types are case-insensitive.
->
-> **GitHub types:** `NOTE`, `TIP`, `IMPORTANT`, `WARNING`, `CAUTION`
-> **Obsidian types:** `note`, `abstract`, `info`, `todo`, `tip`, `success`, `question`, `warning`, `failure`, `danger`, `bug`, `example`, `quote`
+{{< ansible collection="community.general" >}}
@@ -274,6 +398,85 @@ This shortcode is for importing code from external sources easily without copyin
+
+## Feature grid
+
+Build polished, responsive feature sections without repeating presentation markup. Use `feature-grid` as the container, then add one `feature` shortcode for each item. The grid defaults to three columns on large screens and can be set to four.
+
+
+| Parameter | Description |
+| --- | --- |
+| `columns` | Optional number of large-screen columns: `3` (default) or `4`. |
+| `icon` | Icon name for a feature. Defaults to `wand-magic-sparkles`. |
+| `title` | Feature title. Markdown is supported. |
+| `url` | Optional destination for the feature link. |
+| `label` | Link label. Defaults to `Learn more`. |
+
+
+**Example:**
+
+```md
+{{}}
+{{}}
+Start from a thoughtful default, then adjust every meaningful detail.
+{{}}
+{{}}
+Compose rich content with small, reusable building blocks.
+{{}}
+{{}}
+Accessible defaults, responsive layouts, and dark mode included.
+{{}}
+{{}}
+```
+
+{{< feature-grid >}}
+{{< feature icon="wand-magic-sparkles" title="Make it yours" url="/docs/configuration/" >}}
+Start from a thoughtful default, then adjust every meaningful detail.
+{{< /feature >}}
+{{< feature icon="file-lines" title="Publish faster" url="/docs/shortcodes/" label="Browse shortcodes" >}}
+Compose rich content with small, reusable building blocks.
+{{< /feature >}}
+{{< feature icon="heart" title="Built for people" >}}
+Accessible defaults, responsive layouts, and dark mode included.
+{{< /feature >}}
+{{< /feature-grid >}}
+
+
+
## Figure
Blowfish includes a `figure` shortcode for adding images to content. The shortcode replaces the base Hugo functionality in order to provide additional performance benefits.
@@ -361,13 +564,13 @@ In order to add images to the gallery, use `img` tags for each image and add `cl
```
{{< gallery >}}
-
-
-
-
-
-
-
+
+
+
+
+
+
+
{{< /gallery >}}
@@ -387,13 +590,13 @@ In order to add images to the gallery, use `img` tags for each image and add `cl
```
{{< gallery >}}
-
-
-
-
-
-
-
+
+
+
+
+
+
+
{{< /gallery >}}
@@ -731,6 +934,44 @@ You can see some additional Mermaid examples on the [diagrams and flowcharts sam
+## Stats
+
+Use `stats` and `stat` to present concise, high-signal metrics in a responsive grid. The grid uses three columns on large screens by default, or four with `columns="4"`.
+
+```md
+{{}}
+{{}}Compose pages without bespoke templates.{{}}
+{{}}Keep your content in Markdown.{{}}
+{{}}Start with Hugo and Blowfish.{{}}
+{{}}
+```
+
+{{< stats >}}
+{{< stat value="40+" label="Shortcodes" >}}Compose pages without bespoke templates.{{< /stat >}}
+{{< stat value="100%" label="Portable" >}}Keep your content in Markdown.{{< /stat >}}
+{{< stat value="0" label="Required plugins" >}}Start with Hugo and Blowfish.{{< /stat >}}
+{{< /stats >}}
+
+
+
+## Steps
+
+Use `steps` and `step` for onboarding, processes, roadmaps, and tutorials.
+
+```md
+{{}}
+{{}}Choose a colour scheme and homepage layout.{{}}
+{{}}Use standard Markdown and shortcodes.{{}}
+{{}}
+```
+
+{{< steps >}}
+{{< step number="1" title="Configure the theme" >}}Choose a colour scheme and homepage layout.{{< /step >}}
+{{< step number="2" title="Write your content" >}}Use standard Markdown and shortcodes.{{< /step >}}
+{{< /steps >}}
+
+
+
## Swatches
`swatches` outputs a set of up to three different colors to showcase color elements like a color palette. This shortcode takes the `HEX` codes of each color and creates the visual elements for each.
@@ -886,13 +1127,13 @@ With html code
{{< timelineItem icon="star" header="Shortcodes" badge="AWESOME" >}}
With other shortcodes
{{< gallery >}}
-
-
-
-
-
-
-
+
+
+
+
+
+
+
{{< /gallery >}}
{{}}
{{< timelineItem icon="code" header="Another Awesome Header">}}
diff --git a/exampleSite/content/docs/shortcodes/index.ja.md b/exampleSite/content/docs/shortcodes/index.ja.md
index 41467791..0bdbd003 100644
--- a/exampleSite/content/docs/shortcodes/index.ja.md
+++ b/exampleSite/content/docs/shortcodes/index.ja.md
@@ -11,6 +11,129 @@ series_order: 8
[デフォルトの Hugo ショートコード](https://gohugo.io/content-management/shortcodes/)に加えて、Blowfish は機能拡張のためにいくつか独自のものを追加しています。
+## アコーディオン
+
+`accordion` は折りたたみ可能なパネルのセットを作成します。各項目は `accordionItem` サブショートコードで定義します。`mode` パラメータで、複数の項目を同時に開けるかどうかを制御できます。
+
+
+| パラメータ | 説明 |
+| --------- | --------------------------------------------------------------------------------------------------- |
+| `mode` | **オプション** `collapse`(1つのみ開く)または `open`(複数開く)。デフォルトは `collapse` です。 |
+| `separated` | **オプション** `true` にすると各項目が個別のカードとして表示されます。デフォルトは `false`(連結リスト)です。 |
+
+
+`accordionItem` のパラメータ:
+
+
+| パラメータ | 説明 |
+| --------- | --------------------------------------------------------------------------------------------------- |
+| `title` | **必須** 項目のヘッダーに表示されるタイトル。 |
+| `open` | **オプション** `true` に設定すると、その項目がデフォルトで開いた状態になります。 |
+| `header` | **オプション** `title` のエイリアス。他のショートコードとの互換性のために残されています。 |
+| `icon` | **オプション** タイトルの前に表示するアイコン名。 |
+| `align` | **オプション** 項目内のテキストの配置: `left`、`center`、`right` |
+
+
+**例1:** `mode="open"`(複数の項目を同時に開ける)+ `separated=true`
+
+```md
+{{}}
+ {{}}
+ This item demonstrates Markdown rendering:
+ - **Bold text**
+ - Lists
+ - `inline code`
+ {{}}
+
+ {{}}
+ This item demonstrates shortcode rendering with md=false:
+
+ {{}}This is an inline alert.{{}}
+ {{}}
+{{}}
+```
+
+{{< accordion mode="open" separated=true >}}
+ {{< accordionItem title="Markdown example" icon="code" open=true >}}
+ This item demonstrates Markdown rendering:
+ - **Bold text**
+ - Lists
+ - `inline code`
+ {{< /accordionItem >}}
+
+ {{< accordionItem title="Shortcode example" md=false >}}
+ This item demonstrates shortcode rendering with md=false:
+
+ {{< alert >}}This is an inline alert.{{< /alert >}}
+ {{< /accordionItem >}}
+{{< /accordion >}}
+
+**例2:** `mode="collapse"`(同時に開けるのは1項目のみ)
+
+```md
+{{}}
+ {{}}
+ This item uses Markdown with a short list:
+ 1. One
+ 2. Two
+ 3. Three
+ {{}}
+
+ {{}}
+ This item includes another shortcode:
+ {{}}Tip{{}}
+ {{}}
+{{}}
+```
+
+{{< accordion mode="collapse" >}}
+ {{< accordionItem title="First item" open=true >}}
+ This item uses Markdown with a short list:
+ 1. One
+ 2. Two
+ 3. Three
+ {{< /accordionItem >}}
+
+ {{< accordionItem title="Second item" md=false >}}
+ This item includes another shortcode:
+ {{< badge >}}Tip{{< /badge >}}
+ {{< /accordionItem >}}
+{{< /accordion >}}
+
+
+## 統計
+
+`stats` と `stat` を使用すると、簡潔で分かりやすい指標をレスポンシブなグリッドで表示できます。グリッドは大画面ではデフォルトで3列、`columns="4"` を指定すると4列になります。
+
+```md
+{{}}
+{{}}Compose pages without bespoke templates.{{}}
+{{}}Keep your content in Markdown.{{}}
+{{}}Start with Hugo and Blowfish.{{}}
+{{}}
+```
+
+{{< stats >}}
+{{< stat value="40+" label="Shortcodes" >}}Compose pages without bespoke templates.{{< /stat >}}
+{{< stat value="100%" label="Portable" >}}Keep your content in Markdown.{{< /stat >}}
+{{< stat value="0" label="Required plugins" >}}Start with Hugo and Blowfish.{{< /stat >}}
+{{< /stats >}}
+
+
+
+## ステップ
+
+`steps` と `step` は、オンボーディング、プロセス、ロードマップ、チュートリアルに使用できます。
+
+```md
+{{}}
+{{}}Choose a colour scheme and homepage layout.{{}}
+{{}}Use standard Markdown and shortcodes.{{}}
+{{}}
+```
+
+{{< steps >}}
+{{< step number="1" title="Configure the theme" >}}Choose a colour scheme and homepage layout.{{< /step >}}
+{{< step number="2" title="Write your content" >}}Use standard Markdown and shortcodes.{{< /step >}}
+{{< /steps >}}
+
+
+
## 色の見本
`swatches` は、カラーパレットなどのカラー要素を紹介するために、最大3つの異なる色のセットを出力します。このショートコードは、各色の `HEX` コードを受け取り、それぞれの視覚要素を作成します。
@@ -882,13 +1123,13 @@ HTML コード付き
{{< timelineItem icon="star" header="ショートコード" badge="素晴らしい" >}}
他のショートコード付き
{{< gallery >}}
-
-
-
-
-
-
-
+
+
+
+
+
+
+
{{< /gallery >}}
{{< /timelineItem >}}
{{< timelineItem icon="code" header="もう1つの素晴らしいヘッダー">}}
diff --git a/exampleSite/content/docs/shortcodes/index.md b/exampleSite/content/docs/shortcodes/index.md
index ef2da4db..d52f4e3f 100644
--- a/exampleSite/content/docs/shortcodes/index.md
+++ b/exampleSite/content/docs/shortcodes/index.md
@@ -12,91 +12,6 @@ series_order: 8
In addition to all the [default Hugo shortcodes](https://gohugo.io/content-management/shortcodes/), Blowfish adds a few extras for additional functionality.
-## Alert
-
-`alert` outputs its contents as a stylised message box within your article. It's useful for drawing attention to important information that you don't want the reader to miss.
-
-
-| Parameter | Description |
-| --- | --- |
-| `icon` | **Optional.** the icon to display on the left side. **Default:** `triangle-exclamation` (Check out the [icon shortcode](#icon) for more details on using icons.) |
-| `iconColor` | **Optional.** the color for the icon in basic CSS style. Can be either hex values (`#FFFFFF`) or color names (`white`) By default chosen based on the current color theme . |
-| `cardColor` | **Optional.** the color for the card background in basic CSS style. Can be either hex values (`#FFFFFF`) or color names (`white`) By default chosen based on the current color theme . |
-| `textColor` | **Optional.** the color for the text in basic CSS style. Can be either hex values (`#FFFFFF`) or color names (`white`) By default chosen based on the current color theme . |
-
-
-The input is written in Markdown so you can format it however you please.
-
-**Example 1:** No params
-
-```md
-{{}}
-**Warning!** This action is destructive!
-{{}}
-```
-
-{{< alert >}}
-**Warning!** This action is destructive!
-{{< /alert >}}
-
-**Example 2:** Unnamed param
-
-```md
-{{}}
-Don't forget to [follow me](https://twitter.com/nunocoracao) on Twitter.
-{{}}
-```
-
-{{< alert "twitter" >}}
-Don't forget to [follow me](https://twitter.com/nunocoracao) on Twitter.
-{{< /alert >}}
-
-**Example 3:** Named params
-
-```md
-{{}}
-This is an error!
-{{}}
-```
-
-{{< alert icon="fire" cardColor="#e63946" iconColor="#1d3557" textColor="#f1faee" >}}
-This is an error!
-{{< /alert >}}
-
-
-
-## Admonition
-
-Admonitions allow you to insert eye-catching callout boxes in your content.
-
-Admonitions serve a similar purpose as the alert shortcode but are implemented via Hugo render hooks. The key difference is syntax: admonitions use Markdown syntax, making them more portable across different platforms, whereas shortcodes are specific to Hugo. The syntax resembles GitHub alerts:
-
-```md
-> [!TIP]
-> A Tip type admonition.
-
-> [!TIP]+ Custom Title + Custom Icon
-> A collapsible admonition with custom title.
-{icon="twitter"}
-```
-
-> [!TIP]
-> A Tip type admonition.
-
-> [!TIP]+ Custom Title + Custom Icon
-> A collapsible admonition with custom title.
-{icon="twitter"}
-
-The alert sign (`+` or `-`) is optional to control whether the admonition is folded or not. Note that alert sign is only compatible in Obsidian.
-
-> [!INFO]- Supported types
-> Valid admonition types include [GitHub alert types](https://github.blog/changelog/2023-12-14-new-markdown-extension-alerts-provide-distinctive-styling-for-significant-content/) and [Obsidian callout types](https://help.obsidian.md/callouts). The types are case-insensitive.
->
-> **GitHub types:** `NOTE`, `TIP`, `IMPORTANT`, `WARNING`, `CAUTION`
-> **Obsidian types:** `note`, `abstract`, `info`, `todo`, `tip`, `success`, `question`, `warning`, `failure`, `danger`, `bug`, `example`, `quote`
-
-> [!INFO]- Customize admonition
-> See the [admonition customization guide](https://github.com/nunocoracao/blowfish/blob/main/layouts/_default/_markup/render-blockquote.html).
## Accordion
`accordion` creates a collapsible set of panels. Use the `accordionItem` sub-shortcode to define each item. You can control whether multiple items can be open at the same time using the `mode` parameter.
@@ -188,6 +103,91 @@ The alert sign (`+` or `-`) is optional to control whether the admonition is fol
+## Admonition
+
+Admonitions allow you to insert eye-catching callout boxes in your content.
+
+Admonitions serve a similar purpose as the alert shortcode but are implemented via Hugo render hooks. The key difference is syntax: admonitions use Markdown syntax, making them more portable across different platforms, whereas shortcodes are specific to Hugo. The syntax resembles GitHub alerts:
+
+```md
+> [!TIP]
+> A Tip type admonition.
+
+> [!TIP]+ Custom Title + Custom Icon
+> A collapsible admonition with custom title.
+{icon="twitter"}
+```
+
+> [!TIP]
+> A Tip type admonition.
+
+> [!TIP]+ Custom Title + Custom Icon
+> A collapsible admonition with custom title.
+{icon="twitter"}
+
+The alert sign (`+` or `-`) is optional to control whether the admonition is folded or not. Note that alert sign is only compatible in Obsidian.
+
+> [!INFO]- Supported types
+> Valid admonition types include [GitHub alert types](https://github.blog/changelog/2023-12-14-new-markdown-extension-alerts-provide-distinctive-styling-for-significant-content/) and [Obsidian callout types](https://help.obsidian.md/callouts). The types are case-insensitive.
+>
+> **GitHub types:** `NOTE`, `TIP`, `IMPORTANT`, `WARNING`, `CAUTION`
+> **Obsidian types:** `note`, `abstract`, `info`, `todo`, `tip`, `success`, `question`, `warning`, `failure`, `danger`, `bug`, `example`, `quote`
+
+> [!INFO]- Customize admonition
+> See the [admonition customization guide](https://github.com/nunocoracao/blowfish/blob/main/layouts/_default/_markup/render-blockquote.html).
+## Alert
+
+`alert` outputs its contents as a stylised message box within your article. It's useful for drawing attention to important information that you don't want the reader to miss.
+
+
+| Parameter | Description |
+| --- | --- |
+| `icon` | **Optional.** the icon to display on the left side. **Default:** `triangle-exclamation` (Check out the [icon shortcode](#icon) for more details on using icons.) |
+| `iconColor` | **Optional.** the color for the icon in basic CSS style. Can be either hex values (`#FFFFFF`) or color names (`white`) By default chosen based on the current color theme . |
+| `cardColor` | **Optional.** the color for the card background in basic CSS style. Can be either hex values (`#FFFFFF`) or color names (`white`) By default chosen based on the current color theme . |
+| `textColor` | **Optional.** the color for the text in basic CSS style. Can be either hex values (`#FFFFFF`) or color names (`white`) By default chosen based on the current color theme . |
+
+
+The input is written in Markdown so you can format it however you please.
+
+**Example 1:** No params
+
+```md
+{{}}
+**Warning!** This action is destructive!
+{{}}
+```
+
+{{< alert >}}
+**Warning!** This action is destructive!
+{{< /alert >}}
+
+**Example 2:** Unnamed param
+
+```md
+{{}}
+Don't forget to [follow me](https://twitter.com/nunocoracao) on Twitter.
+{{}}
+```
+
+{{< alert "twitter" >}}
+Don't forget to [follow me](https://twitter.com/nunocoracao) on Twitter.
+{{< /alert >}}
+
+**Example 3:** Named params
+
+```md
+{{}}
+This is an error!
+{{}}
+```
+
+{{< alert icon="fire" cardColor="#e63946" iconColor="#1d3557" textColor="#f1faee" >}}
+This is an error!
+{{< /alert >}}
+
+
+
## Ansible Galaxy Card
`ansible` renders a card for an [Ansible Galaxy](https://galaxy.ansible.com/) entry, fetched at build time. It accepts either a `role` or a `collection` parameter, both in `namespace.name` form.
@@ -422,6 +422,29 @@ This shortcode is for importing code from external sources easily without copyin
+
## Email
Creates an obfuscated mailto link:
@@ -434,6 +457,50 @@ Creates an obfuscated mailto link:
+## Feature grid
+
+Build polished, responsive feature sections without repeating presentation markup. Use `feature-grid` as the container, then add one `feature` shortcode for each item. The grid defaults to three columns on large screens and can be set to four.
+
+
+| Parameter | Description |
+| --- | --- |
+| `columns` | Optional number of large-screen columns: `3` (default) or `4`. |
+| `icon` | Icon name for a feature. Defaults to `wand-magic-sparkles`. |
+| `title` | Feature title. Markdown is supported. |
+| `url` | Optional destination for the feature link. |
+| `label` | Link label. Defaults to `Learn more`. |
+
+
+**Example:**
+
+```md
+{{}}
+{{}}
+Start from a thoughtful default, then adjust every meaningful detail.
+{{}}
+{{}}
+Compose rich content with small, reusable building blocks.
+{{}}
+{{}}
+Accessible defaults, responsive layouts, and dark mode included.
+{{}}
+{{}}
+```
+
+{{< feature-grid >}}
+{{< feature icon="wand-magic-sparkles" title="Make it yours" url="/docs/configuration/" >}}
+Start from a thoughtful default, then adjust every meaningful detail.
+{{< /feature >}}
+{{< feature icon="file-lines" title="Publish faster" url="/docs/shortcodes/" label="Browse shortcodes" >}}
+Compose rich content with small, reusable building blocks.
+{{< /feature >}}
+{{< feature icon="heart" title="Built for people" >}}
+Accessible defaults, responsive layouts, and dark mode included.
+{{< /feature >}}
+{{< /feature-grid >}}
+
+
+
## Figure
Blowfish includes a `figure` shortcode for adding images to content. The shortcode replaces the base Hugo functionality in order to provide additional performance benefits.
@@ -524,13 +591,13 @@ If you need captions, you can use the `figure` shortcode inside the gallery. Whe
```
{{< gallery >}}
-
-
-
-
-
-
-
+
+
+
+
+
+
+
{{< /gallery >}}
@@ -550,13 +617,13 @@ If you need captions, you can use the `figure` shortcode inside the gallery. Whe
```
{{< gallery >}}
-
-
-
-
-
-
-
+
+
+
+
+
+
+
{{< /gallery >}}
@@ -912,6 +979,44 @@ You can see some additional Mermaid examples on the [diagrams and flowcharts sam
+## Stats
+
+Use `stats` and `stat` to present concise, high-signal metrics in a responsive grid. The grid uses three columns on large screens by default, or four with `columns="4"`.
+
+```md
+{{}}
+{{}}Compose pages without bespoke templates.{{}}
+{{}}Keep your content in Markdown.{{}}
+{{}}Start with Hugo and Blowfish.{{}}
+{{}}
+```
+
+{{< stats >}}
+{{< stat value="40+" label="Shortcodes" >}}Compose pages without bespoke templates.{{< /stat >}}
+{{< stat value="100%" label="Portable" >}}Keep your content in Markdown.{{< /stat >}}
+{{< stat value="0" label="Required plugins" >}}Start with Hugo and Blowfish.{{< /stat >}}
+{{< /stats >}}
+
+
+
+## Steps
+
+Use `steps` and `step` for onboarding, processes, roadmaps, and tutorials.
+
+```md
+{{}}
+{{}}Choose a colour scheme and homepage layout.{{}}
+{{}}Use standard Markdown and shortcodes.{{}}
+{{}}
+```
+
+{{< steps >}}
+{{< step number="1" title="Configure the theme" >}}Choose a colour scheme and homepage layout.{{< /step >}}
+{{< step number="2" title="Write your content" >}}Use standard Markdown and shortcodes.{{< /step >}}
+{{< /steps >}}
+
+
+
## Swatches
`swatches` outputs a set of up to three different colors to showcase color elements like a color palette. This shortcode takes the `HEX` codes of each color and creates the visual elements for each.
@@ -1189,13 +1294,13 @@ With html code
{{< timelineItem icon="star" header="Shortcodes" badge="AWESOME" >}}
With other shortcodes
{{< gallery >}}
-
-
-
-
-
-
-
+
+
+
+
+
+
+
{{< /gallery >}}
{{}}
{{< timelineItem icon="code" header="Another Awesome Header">}}
@@ -1378,105 +1483,3 @@ More informations can be found on the [youtubeLite GitHub repo](https://github.c
-## Feature grid
-
-Build polished, responsive feature sections without repeating presentation markup. Use `feature-grid` as the container, then add one `feature` shortcode for each item. The grid defaults to three columns on large screens and can be set to four.
-
-
-| Parameter | Description |
-| --- | --- |
-| `columns` | Optional number of large-screen columns: `3` (default) or `4`. |
-| `icon` | Icon name for a feature. Defaults to `wand-magic-sparkles`. |
-| `title` | Feature title. Markdown is supported. |
-| `url` | Optional destination for the feature link. |
-| `label` | Link label. Defaults to `Learn more`. |
-
-
-**Example:**
-
-```md
-{{}}
-{{}}
-Start from a thoughtful default, then adjust every meaningful detail.
-{{}}
-{{}}
-Compose rich content with small, reusable building blocks.
-{{}}
-{{}}
-Accessible defaults, responsive layouts, and dark mode included.
-{{}}
-{{}}
-```
-
-{{< feature-grid >}}
-{{< feature icon="wand-magic-sparkles" title="Make it yours" url="/docs/configuration/" >}}
-Start from a thoughtful default, then adjust every meaningful detail.
-{{< /feature >}}
-{{< feature icon="file-lines" title="Publish faster" url="/docs/shortcodes/" label="Browse shortcodes" >}}
-Compose rich content with small, reusable building blocks.
-{{< /feature >}}
-{{< feature icon="heart" title="Built for people" >}}
-Accessible defaults, responsive layouts, and dark mode included.
-{{< /feature >}}
-{{< /feature-grid >}}
-
-
-
-## Stats
-
-Use `stats` and `stat` to present concise, high-signal metrics in a responsive grid. The grid uses three columns on large screens by default, or four with `columns="4"`.
-
-```md
-{{}}
-{{}}Compose pages without bespoke templates.{{}}
-{{}}Keep your content in Markdown.{{}}
-{{}}Start with Hugo and Blowfish.{{}}
-{{}}
-```
-
-{{< stats >}}
-{{< stat value="40+" label="Shortcodes" >}}Compose pages without bespoke templates.{{< /stat >}}
-{{< stat value="100%" label="Portable" >}}Keep your content in Markdown.{{< /stat >}}
-{{< stat value="0" label="Required plugins" >}}Start with Hugo and Blowfish.{{< /stat >}}
-{{< /stats >}}
-
-
-
-## Steps
-
-Use `steps` and `step` for onboarding, processes, roadmaps, and tutorials.
-
-```md
-{{}}
-{{}}Choose a colour scheme and homepage layout.{{}}
-{{}}Use standard Markdown and shortcodes.{{}}
-{{}}
-```
-
-{{< steps >}}
-{{< step number="1" title="Configure the theme" >}}Choose a colour scheme and homepage layout.{{< /step >}}
-{{< step number="2" title="Write your content" >}}Use standard Markdown and shortcodes.{{< /step >}}
-{{< /steps >}}
diff --git a/exampleSite/content/docs/shortcodes/index.pt-br.md b/exampleSite/content/docs/shortcodes/index.pt-br.md
index 57cd12ea..f2f76d5e 100644
--- a/exampleSite/content/docs/shortcodes/index.pt-br.md
+++ b/exampleSite/content/docs/shortcodes/index.pt-br.md
@@ -11,6 +11,127 @@ series_order: 8
Além de todos os [shortcodes padrão do Hugo](https://gohugo.io/content-management/shortcodes/), o Blowfish adiciona alguns extras para funcionalidades adicionais.
+## Accordion
+
+`accordion` cria um conjunto de painéis recolhíveis. Use o sub-shortcode `accordionItem` para definir cada item. Você pode controlar se vários itens podem ficar abertos ao mesmo tempo usando o parâmetro `mode`.
+
+
+| Parâmetro | Descrição |
+| --------- | --------------------------------------------------------------------------------------------------- |
+| `mode` | **Opcional.** `collapse` (apenas um aberto) ou `open` (vários abertos). O padrão é `collapse`. |
+| `separated` | **Opcional.** `true` para exibir cada item como um cartão separado. O padrão é `false` (lista unida). |
+
+
+Parâmetros de `accordionItem`:
+
+
+| Parâmetro | Descrição |
+| --------- | --------------------------------------------------------------------------------------------------- |
+| `title` | **Obrigatório.** Título exibido no cabeçalho do item. |
+| `open` | **Opcional.** Defina como `true` para que o item fique aberto por padrão. |
+| `header` | **Opcional.** Alias de `title`, mantido por compatibilidade com outros shortcodes. |
+| `icon` | **Opcional.** Nome do ícone a ser exibido antes do título. |
+| `align` | **Opcional.** Alinha o texto dentro do item: `left`, `center`, `right` |
+
+
+**Exemplo 1: `mode="open"` (vários itens podem ficar abertos) + `separated=true`**
+
+```md
+{{}}
+ {{}}
+ This item demonstrates Markdown rendering:
+ - **Bold text**
+ - Lists
+ - `inline code`
+ {{}}
+
+ {{}}
+ This item demonstrates shortcode rendering with md=false:
+
+ {{}}This is an inline alert.{{}}
+ {{}}
+{{}}
+```
+
+{{< accordion mode="open" separated=true >}}
+ {{< accordionItem title="Markdown example" icon="code" open=true >}}
+ This item demonstrates Markdown rendering:
+ - **Bold text**
+ - Lists
+ - `inline code`
+ {{< /accordionItem >}}
+
+ {{< accordionItem title="Shortcode example" md=false >}}
+ This item demonstrates shortcode rendering with md=false:
+
+ {{< alert >}}This is an inline alert.{{< /alert >}}
+ {{< /accordionItem >}}
+{{< /accordion >}}
+
+**Exemplo 2: `mode="collapse"` (apenas um item aberto por vez)**
+
+```md
+{{}}
+ {{}}
+ This item uses Markdown with a short list:
+ 1. One
+ 2. Two
+ 3. Three
+ {{}}
+
+ {{}}
+ This item includes another shortcode:
+ {{}}Tip{{}}
+ {{}}
+{{}}
+```
+
+{{< accordion mode="collapse" >}}
+ {{< accordionItem title="First item" open=true >}}
+ This item uses Markdown with a short list:
+ 1. One
+ 2. Two
+ 3. Three
+ {{< /accordionItem >}}
+
+ {{< accordionItem title="Second item" md=false >}}
+ This item includes another shortcode:
+ {{< badge >}}Tip{{< /badge >}}
+ {{< /accordionItem >}}
+{{< /accordion >}}
+
+
+
+## Admonition
+
+Admonitions permitem que você insira caixas de chamada atraentes no seu conteúdo.
+
+Admonitions servem um propósito similar ao shortcode alert, mas são implementadas via hooks de renderização do Hugo. A diferença principal é a sintaxe: admonitions usam sintaxe Markdown, tornando-as mais portáveis entre diferentes plataformas, enquanto shortcodes são específicos do Hugo. A sintaxe se assemelha aos alertas do GitHub:
+
+```md
+> [!NOTE]
+> Uma admonition do tipo Note.
+
+> [!TIP]+ Título personalizado
+> Uma admonition recolhível com título personalizado.
+```
+
+> [!NOTE]
+> Uma admonition do tipo Note.
+
+> [!TIP]+ Título personalizado
+> Uma admonition recolhível com título personalizado.
+
+O sinal de alerta (`+` ou `-`) é opcional para controlar se a admonition está recolhida ou não. Note que o sinal de alerta só é compatível com o Obsidian.
+
+> [!INFO]- Tipos suportados
+> Os tipos válidos de admonition incluem [tipos de alerta do GitHub](https://github.blog/changelog/2023-12-14-new-markdown-extension-alerts-provide-distinctive-styling-for-significant-content/) e [tipos de callout do Obsidian](https://help.obsidian.md/callouts). Os tipos não diferenciam maiúsculas de minúsculas.
+>
+> **Tipos do GitHub:** `NOTE`, `TIP`, `IMPORTANT`, `WARNING`, `CAUTION`
+> **Tipos do Obsidian:** `note`, `abstract`, `info`, `todo`, `tip`, `success`, `question`, `warning`, `failure`, `danger`, `bug`, `example`, `quote`
+
+
+
## Alert
`alert` exibe seu conteúdo como uma caixa de mensagem estilizada dentro do seu artigo. É útil para chamar a atenção para informações importantes que você não quer que o leitor perca.
@@ -64,33 +185,36 @@ Isto é um erro!
-## Admonition
+## Ansible Galaxy Card
-Admonitions permitem que você insira caixas de chamada atraentes no seu conteúdo.
+`ansible` renderiza um cartão para uma entrada do [Ansible Galaxy](https://galaxy.ansible.com/), obtida no momento da compilação. Ele aceita um parâmetro `role` ou `collection`, ambos no formato `namespace.name`.
-Admonitions servem um propósito similar ao shortcode alert, mas são implementadas via hooks de renderização do Hugo. A diferença principal é a sintaxe: admonitions usam sintaxe Markdown, tornando-as mais portáveis entre diferentes plataformas, enquanto shortcodes são específicos do Hugo. A sintaxe se assemelha aos alertas do GitHub:
+
+| Parâmetro | Descrição |
+| ------------ | ------------------------------------------------------------------------------------ |
+| `role` | [String] role do Galaxy no formato `namespace.name`, por exemplo `geerlingguy.docker` |
+| `collection` | [String] collection do Galaxy no formato `namespace.name`, por exemplo `community.general` |
+
+
+Defina exatamente um entre `role` ou `collection` por chamada.
+
+Todos os valores do cartão são obtidos no momento da compilação por meio do `resources.GetRemote` do Hugo. O Galaxy não permite requisições cross-origin, então o cartão não é atualizado no navegador — recompile o site para atualizar os valores.
+
+**Exemplo 1: Role**
```md
-> [!NOTE]
-> Uma admonition do tipo Note.
-
-> [!TIP]+ Título personalizado
-> Uma admonition recolhível com título personalizado.
+{{}}
```
-> [!NOTE]
-> Uma admonition do tipo Note.
+{{< ansible role="geerlingguy.docker" >}}
-> [!TIP]+ Título personalizado
-> Uma admonition recolhível com título personalizado.
+**Exemplo 2: Collection**
-O sinal de alerta (`+` ou `-`) é opcional para controlar se a admonition está recolhida ou não. Note que o sinal de alerta só é compatível com o Obsidian.
+```md
+{{}}
+```
-> [!INFO]- Tipos suportados
-> Os tipos válidos de admonition incluem [tipos de alerta do GitHub](https://github.blog/changelog/2023-12-14-new-markdown-extension-alerts-provide-distinctive-styling-for-significant-content/) e [tipos de callout do Obsidian](https://help.obsidian.md/callouts). Os tipos não diferenciam maiúsculas de minúsculas.
->
-> **Tipos do GitHub:** `NOTE`, `TIP`, `IMPORTANT`, `WARNING`, `CAUTION`
-> **Tipos do Obsidian:** `note`, `abstract`, `info`, `todo`, `tip`, `success`, `question`, `warning`, `failure`, `danger`, `bug`, `example`, `quote`
+{{< ansible collection="community.general" >}}
@@ -272,6 +396,85 @@ Este shortcode permite importar código de fontes externas facilmente sem copiar
+## CTA button
+
+Use `cta` para uma chamada para ação clara e acessível em documentação, páginas de destino ou conteúdo longo.
+
+
+| Parâmetro | Descrição |
+| --- | --- |
+| `url` | URL de destino. O padrão é `#`. |
+| `label` | Texto do botão. O padrão é `Learn more`. |
+| `style` | `primary` (padrão) ou `outline`. |
+
+
+```md
+{{}}
+{{}}
+```
+
+{{< cta url="/docs/installation/" label="Start building" >}}
+
+{{< cta url="/docs/configuration/" label="Explore configuration" style="outline" >}}
+
+
+
+## Email
+
+Cria um link mailto ofuscado:
+
+```md
+{{}}
+```
+
+{{< email email="mailto:hello@test.com" text="text" subject="Reply to awesome article" >}}
+
+
+
+## Feature grid
+
+Crie seções de recursos refinadas e responsivas sem repetir a marcação de apresentação. Use `feature-grid` como contêiner e adicione um shortcode `feature` para cada item. A grade usa três colunas em telas grandes por padrão e pode ser configurada para quatro.
+
+
+| Parâmetro | Descrição |
+| --- | --- |
+| `columns` | Número opcional de colunas em telas grandes: `3` (padrão) ou `4`. |
+| `icon` | Nome do ícone de um recurso. O padrão é `wand-magic-sparkles`. |
+| `title` | Título do recurso. Markdown é suportado. |
+| `url` | Destino opcional para o link do recurso. |
+| `label` | Rótulo do link. O padrão é `Learn more`. |
+
+
+**Exemplo:**
+
+```md
+{{}}
+{{}}
+Start from a thoughtful default, then adjust every meaningful detail.
+{{}}
+{{}}
+Compose rich content with small, reusable building blocks.
+{{}}
+{{}}
+Accessible defaults, responsive layouts, and dark mode included.
+{{}}
+{{}}
+```
+
+{{< feature-grid >}}
+{{< feature icon="wand-magic-sparkles" title="Make it yours" url="/docs/configuration/" >}}
+Start from a thoughtful default, then adjust every meaningful detail.
+{{< /feature >}}
+{{< feature icon="file-lines" title="Publish faster" url="/docs/shortcodes/" label="Browse shortcodes" >}}
+Compose rich content with small, reusable building blocks.
+{{< /feature >}}
+{{< feature icon="heart" title="Built for people" >}}
+Accessible defaults, responsive layouts, and dark mode included.
+{{< /feature >}}
+{{< /feature-grid >}}
+
+
+
## Figure
O Blowfish inclui um shortcode `figure` para adicionar imagens ao conteúdo. O shortcode substitui a funcionalidade base do Hugo para fornecer benefícios de desempenho adicionais.
@@ -359,13 +562,13 @@ Para adicionar imagens à galeria, use tags `img` para cada imagem e adicione `c
```
{{< gallery >}}
-
-
-
-
-
-
-
+
+
+
+
+
+
+
{{< /gallery >}}
@@ -385,13 +588,13 @@ Para adicionar imagens à galeria, use tags `img` para cada imagem e adicione `c
```
{{< gallery >}}
-
-
-
-
-
-
-
+
+
+
+
+
+
+
{{< /gallery >}}
@@ -729,6 +932,44 @@ Você pode ver exemplos adicionais do Mermaid na página de [exemplos de diagram
+## Stats
+
+Use `stats` e `stat` para apresentar métricas concisas e de alto impacto em uma grade responsiva. A grade usa três colunas em telas grandes por padrão, ou quatro com `columns="4"`.
+
+```md
+{{}}
+{{}}Compose pages without bespoke templates.{{}}
+{{}}Keep your content in Markdown.{{}}
+{{}}Start with Hugo and Blowfish.{{}}
+{{}}
+```
+
+{{< stats >}}
+{{< stat value="40+" label="Shortcodes" >}}Compose pages without bespoke templates.{{< /stat >}}
+{{< stat value="100%" label="Portable" >}}Keep your content in Markdown.{{< /stat >}}
+{{< stat value="0" label="Required plugins" >}}Start with Hugo and Blowfish.{{< /stat >}}
+{{< /stats >}}
+
+
+
+## Steps
+
+Use `steps` e `step` para onboarding, processos, roteiros e tutoriais.
+
+```md
+{{}}
+{{}}Choose a colour scheme and homepage layout.{{}}
+{{}}Use standard Markdown and shortcodes.{{}}
+{{}}
+```
+
+{{< steps >}}
+{{< step number="1" title="Configure the theme" >}}Choose a colour scheme and homepage layout.{{< /step >}}
+{{< step number="2" title="Write your content" >}}Use standard Markdown and shortcodes.{{< /step >}}
+{{< /steps >}}
+
+
+
## Swatches
`swatches` exibe um conjunto de até três cores diferentes para mostrar elementos de cor como uma paleta de cores. Este shortcode recebe os códigos `HEX` de cada cor e cria os elementos visuais para cada uma.
@@ -884,13 +1125,13 @@ Com código HTML
{{< timelineItem icon="star" header="Shortcodes" badge="AWESOME" >}}
Com outros shortcodes
{{< gallery >}}
-
-
-
-
-
-
-
+
+
+
+
+
+
+
{{< /gallery >}}
{{}}
{{< timelineItem icon="code" header="Another Awesome Header">}}
diff --git a/exampleSite/content/docs/shortcodes/index.pt-pt.md b/exampleSite/content/docs/shortcodes/index.pt-pt.md
index e10a8701..6759eb93 100644
--- a/exampleSite/content/docs/shortcodes/index.pt-pt.md
+++ b/exampleSite/content/docs/shortcodes/index.pt-pt.md
@@ -11,6 +11,127 @@ series_order: 8
Para além de todos os [shortcodes predefinidos do Hugo](https://gohugo.io/content-management/shortcodes/), o Blowfish adiciona alguns extras para funcionalidades adicionais.
+## Accordion
+
+`accordion` cria um conjunto de painéis expansíveis. Utilize o sub-shortcode `accordionItem` para definir cada item. Pode controlar se vários itens podem estar abertos ao mesmo tempo através do parâmetro `mode`.
+
+
+| Parâmetro | Descrição |
+| --------- | --------------------------------------------------------------------------------------------------- |
+| `mode` | **Opcional.** `collapse` (apenas um aberto) ou `open` (vários abertos). A predefinição é `collapse`. |
+| `separated` | **Opcional.** `true` para mostrar cada item como um cartão separado. A predefinição é `false` (lista unida). |
+
+
+Parâmetros de `accordionItem`:
+
+
+| Parâmetro | Descrição |
+| --------- | --------------------------------------------------------------------------------------------------- |
+| `title` | **Obrigatório.** Título mostrado no cabeçalho do item. |
+| `open` | **Opcional.** Defina como `true` para que o item esteja aberto por predefinição. |
+| `header` | **Opcional.** Alias de `title`, mantido por compatibilidade com outros shortcodes. |
+| `icon` | **Opcional.** Nome do ícone a mostrar antes do título. |
+| `align` | **Opcional.** Alinha o texto dentro do item: `left`, `center`, `right` |
+
+
+**Exemplo 1: `mode="open"` (vários itens podem estar abertos) + `separated=true`**
+
+```md
+{{}}
+ {{}}
+ This item demonstrates Markdown rendering:
+ - **Bold text**
+ - Lists
+ - `inline code`
+ {{}}
+
+ {{}}
+ This item demonstrates shortcode rendering with md=false:
+
+ {{}}This is an inline alert.{{}}
+ {{}}
+{{}}
+```
+
+{{< accordion mode="open" separated=true >}}
+ {{< accordionItem title="Markdown example" icon="code" open=true >}}
+ This item demonstrates Markdown rendering:
+ - **Bold text**
+ - Lists
+ - `inline code`
+ {{< /accordionItem >}}
+
+ {{< accordionItem title="Shortcode example" md=false >}}
+ This item demonstrates shortcode rendering with md=false:
+
+ {{< alert >}}This is an inline alert.{{< /alert >}}
+ {{< /accordionItem >}}
+{{< /accordion >}}
+
+**Exemplo 2: `mode="collapse"` (apenas um item aberto de cada vez)**
+
+```md
+{{}}
+ {{}}
+ This item uses Markdown with a short list:
+ 1. One
+ 2. Two
+ 3. Three
+ {{}}
+
+ {{}}
+ This item includes another shortcode:
+ {{}}Tip{{}}
+ {{}}
+{{}}
+```
+
+{{< accordion mode="collapse" >}}
+ {{< accordionItem title="First item" open=true >}}
+ This item uses Markdown with a short list:
+ 1. One
+ 2. Two
+ 3. Three
+ {{< /accordionItem >}}
+
+ {{< accordionItem title="Second item" md=false >}}
+ This item includes another shortcode:
+ {{< badge >}}Tip{{< /badge >}}
+ {{< /accordionItem >}}
+{{< /accordion >}}
+
+
+
+## Admonition
+
+As admonitions permitem-lhe inserir caixas de chamada atraentes no seu conteúdo.
+
+As admonitions servem um propósito semelhante ao shortcode alert, mas são implementadas através de hooks de renderização do Hugo. A diferença principal é a sintaxe: as admonitions utilizam sintaxe Markdown, tornando-as mais portáveis entre diferentes plataformas, enquanto os shortcodes são específicos do Hugo. A sintaxe assemelha-se aos alertas do GitHub:
+
+```md
+> [!NOTE]
+> Uma admonition do tipo Note.
+
+> [!TIP]+ Título personalizado
+> Uma admonition recolhível com título personalizado.
+```
+
+> [!NOTE]
+> Uma admonition do tipo Note.
+
+> [!TIP]+ Título personalizado
+> Uma admonition recolhível com título personalizado.
+
+O sinal de alerta (`+` ou `-`) é opcional para controlar se a admonition está recolhida ou não. Note que o sinal de alerta só é compatível com o Obsidian.
+
+> [!INFO]- Tipos suportados
+> Os tipos válidos de admonition incluem [tipos de alerta do GitHub](https://github.blog/changelog/2023-12-14-new-markdown-extension-alerts-provide-distinctive-styling-for-significant-content/) e [tipos de callout do Obsidian](https://help.obsidian.md/callouts). Os tipos não diferenciam maiúsculas de minúsculas.
+>
+> **Tipos do GitHub:** `NOTE`, `TIP`, `IMPORTANT`, `WARNING`, `CAUTION`
+> **Tipos do Obsidian:** `note`, `abstract`, `info`, `todo`, `tip`, `success`, `question`, `warning`, `failure`, `danger`, `bug`, `example`, `quote`
+
+
+
## Alert
`alert` apresenta o seu conteúdo como uma caixa de mensagem estilizada dentro do seu artigo. É útil para chamar a atenção para informações importantes que não quer que o leitor perca.
@@ -64,33 +185,36 @@ Isto é um erro!
-## Admonition
+## Ansible Galaxy Card
-As admonitions permitem-lhe inserir caixas de chamada atraentes no seu conteúdo.
+`ansible` renderiza um cartão para uma entrada do [Ansible Galaxy](https://galaxy.ansible.com/), obtida no momento da compilação. Aceita um parâmetro `role` ou `collection`, ambos no formato `namespace.name`.
-As admonitions servem um propósito semelhante ao shortcode alert, mas são implementadas através de hooks de renderização do Hugo. A diferença principal é a sintaxe: as admonitions utilizam sintaxe Markdown, tornando-as mais portáveis entre diferentes plataformas, enquanto os shortcodes são específicos do Hugo. A sintaxe assemelha-se aos alertas do GitHub:
+
+| Parâmetro | Descrição |
+| ------------ | ------------------------------------------------------------------------------------ |
+| `role` | [String] role do Galaxy no formato `namespace.name`, por exemplo `geerlingguy.docker` |
+| `collection` | [String] collection do Galaxy no formato `namespace.name`, por exemplo `community.general` |
+
+
+Defina exatamente um entre `role` ou `collection` por chamada.
+
+Todos os valores do cartão são obtidos no momento da compilação através do `resources.GetRemote` do Hugo. O Galaxy não permite pedidos cross-origin, pelo que o cartão não é atualizado no navegador — recompile o site para atualizar os valores.
+
+**Exemplo 1: Role**
```md
-> [!NOTE]
-> Uma admonition do tipo Note.
-
-> [!TIP]+ Título personalizado
-> Uma admonition recolhível com título personalizado.
+{{}}
```
-> [!NOTE]
-> Uma admonition do tipo Note.
+{{< ansible role="geerlingguy.docker" >}}
-> [!TIP]+ Título personalizado
-> Uma admonition recolhível com título personalizado.
+**Exemplo 2: Collection**
-O sinal de alerta (`+` ou `-`) é opcional para controlar se a admonition está recolhida ou não. Note que o sinal de alerta só é compatível com o Obsidian.
+```md
+{{}}
+```
-> [!INFO]- Tipos suportados
-> Os tipos válidos de admonition incluem [tipos de alerta do GitHub](https://github.blog/changelog/2023-12-14-new-markdown-extension-alerts-provide-distinctive-styling-for-significant-content/) e [tipos de callout do Obsidian](https://help.obsidian.md/callouts). Os tipos não diferenciam maiúsculas de minúsculas.
->
-> **Tipos do GitHub:** `NOTE`, `TIP`, `IMPORTANT`, `WARNING`, `CAUTION`
-> **Tipos do Obsidian:** `note`, `abstract`, `info`, `todo`, `tip`, `success`, `question`, `warning`, `failure`, `danger`, `bug`, `example`, `quote`
+{{< ansible collection="community.general" >}}
@@ -272,6 +396,85 @@ Este shortcode permite importar código de fontes externas facilmente sem copiar
+## CTA button
+
+Utilize `cta` para uma chamada para ação clara e acessível em documentação, páginas de destino ou conteúdo longo.
+
+
+| Parâmetro | Descrição |
+| --- | --- |
+| `url` | URL de destino. A predefinição é `#`. |
+| `label` | Texto do botão. A predefinição é `Learn more`. |
+| `style` | `primary` (predefinição) ou `outline`. |
+
+
+```md
+{{}}
+{{}}
+```
+
+{{< cta url="/docs/installation/" label="Start building" >}}
+
+{{< cta url="/docs/configuration/" label="Explore configuration" style="outline" >}}
+
+
+
+## Feature grid
+
+Crie secções de funcionalidades refinadas e responsivas sem repetir a marcação de apresentação. Utilize `feature-grid` como contentor e adicione um shortcode `feature` para cada item. A grelha usa três colunas em ecrãs grandes por predefinição e pode ser configurada para quatro.
+
+
+| Parâmetro | Descrição |
+| --- | --- |
+| `columns` | Número opcional de colunas em ecrãs grandes: `3` (predefinição) ou `4`. |
+| `icon` | Nome do ícone de uma funcionalidade. A predefinição é `wand-magic-sparkles`. |
+| `title` | Título da funcionalidade. Markdown é suportado. |
+| `url` | Destino opcional para a ligação da funcionalidade. |
+| `label` | Etiqueta da ligação. A predefinição é `Learn more`. |
+
+
+**Exemplo:**
+
+```md
+{{}}
+{{}}
+Start from a thoughtful default, then adjust every meaningful detail.
+{{}}
+{{}}
+Compose rich content with small, reusable building blocks.
+{{}}
+{{}}
+Accessible defaults, responsive layouts, and dark mode included.
+{{}}
+{{}}
+```
+
+{{< feature-grid >}}
+{{< feature icon="wand-magic-sparkles" title="Make it yours" url="/docs/configuration/" >}}
+Start from a thoughtful default, then adjust every meaningful detail.
+{{< /feature >}}
+{{< feature icon="file-lines" title="Publish faster" url="/docs/shortcodes/" label="Browse shortcodes" >}}
+Compose rich content with small, reusable building blocks.
+{{< /feature >}}
+{{< feature icon="heart" title="Built for people" >}}
+Accessible defaults, responsive layouts, and dark mode included.
+{{< /feature >}}
+{{< /feature-grid >}}
+
+
+
## Figure
O Blowfish inclui um shortcode `figure` para adicionar imagens ao conteúdo. O shortcode substitui a funcionalidade base do Hugo para fornecer benefícios de desempenho adicionais.
@@ -359,13 +562,13 @@ Para adicionar imagens à galeria, utilize tags `img` para cada imagem e adicion
```
{{< gallery >}}
-
-
-
-
-
-
-
+
+
+
+
+
+
+
{{< /gallery >}}
@@ -385,13 +588,13 @@ Para adicionar imagens à galeria, utilize tags `img` para cada imagem e adicion
```
{{< gallery >}}
-
-
-
-
-
-
-
+
+
+
+
+
+
+
{{< /gallery >}}
@@ -729,6 +932,44 @@ Pode ver exemplos adicionais do Mermaid na página de [exemplos de diagramas e f
+## Stats
+
+Utilize `stats` e `stat` para apresentar métricas concisas e de alto impacto numa grelha responsiva. A grelha usa três colunas em ecrãs grandes por predefinição, ou quatro com `columns="4"`.
+
+```md
+{{}}
+{{}}Compose pages without bespoke templates.{{}}
+{{}}Keep your content in Markdown.{{}}
+{{}}Start with Hugo and Blowfish.{{}}
+{{}}
+```
+
+{{< stats >}}
+{{< stat value="40+" label="Shortcodes" >}}Compose pages without bespoke templates.{{< /stat >}}
+{{< stat value="100%" label="Portable" >}}Keep your content in Markdown.{{< /stat >}}
+{{< stat value="0" label="Required plugins" >}}Start with Hugo and Blowfish.{{< /stat >}}
+{{< /stats >}}
+
+
+
+## Steps
+
+Utilize `steps` e `step` para onboarding, processos, roteiros e tutoriais.
+
+```md
+{{}}
+{{}}Choose a colour scheme and homepage layout.{{}}
+{{}}Use standard Markdown and shortcodes.{{}}
+{{}}
+```
+
+{{< steps >}}
+{{< step number="1" title="Configure the theme" >}}Choose a colour scheme and homepage layout.{{< /step >}}
+{{< step number="2" title="Write your content" >}}Use standard Markdown and shortcodes.{{< /step >}}
+{{< /steps >}}
+
+
+
## Swatches
`swatches` apresenta um conjunto de até três cores diferentes para mostrar elementos de cor como uma paleta de cores. Este shortcode recebe os códigos `HEX` de cada cor e cria os elementos visuais para cada uma.
@@ -884,13 +1125,13 @@ Com código HTML
{{< timelineItem icon="star" header="Shortcodes" badge="AWESOME" >}}
Com outros shortcodes
{{< gallery >}}
-
-
-
-
-
-
-
+
+
+
+
+
+
+
{{< /gallery >}}
{{}}
{{< timelineItem icon="code" header="Another Awesome Header">}}
diff --git a/exampleSite/content/docs/shortcodes/index.zh-cn.md b/exampleSite/content/docs/shortcodes/index.zh-cn.md
index 4c7e54d4..09685f10 100644
--- a/exampleSite/content/docs/shortcodes/index.zh-cn.md
+++ b/exampleSite/content/docs/shortcodes/index.zh-cn.md
@@ -11,6 +11,132 @@ series_order: 8
除了所有[默认 Hugo 简码](https://gohugo.io/content-management/shortcodes/) 之外，Blowfish 还添加了一些额外的功能。
+## 手风琴
+
+`accordion` 可以创建一组可折叠的面板。使用 `accordionItem` 子简码定义每个条目。您可以通过 `mode` 参数控制是否允许多个条目同时展开。
+
+
+| 参数 | 功能 |
+| --------- | --------------------------------------------------------------------------------------------------- |
+| `mode` | **可选** `collapse`(单个展开)或 `open`(多个展开)。默认为 `collapse`。 |
+| `separated` | **可选** `true` 时每个条目显示为独立卡片。默认为 `false`(连接列表)。 |
+
+
+`accordionItem` 参数:
+
+
+| 参数 | 功能 |
+| --------- | --------------------------------------------------------------------------------------------------- |
+| `title` | **必填** 条目标题栏中显示的标题。 |
+| `open` | **可选** 设置为 `true` 可使该条目默认展开。 |
+| `header` | **可选** `title` 的别名,为与其他简码兼容而保留。 |
+| `icon` | **可选** 显示在标题前的图标名称。 |
+| `align` | **可选** 条目内文本的对齐方式:`left`、`center`、`right` |
+
+
+**例1:** `mode="open"`(多个条目可同时展开)+ `separated=true`
+
+```md
+{{}}
+ {{}}
+ This item demonstrates Markdown rendering:
+ - **Bold text**
+ - Lists
+ - `inline code`
+ {{}}
+
+ {{}}
+ This item demonstrates shortcode rendering with md=false:
+
+ {{}}This is an inline alert.{{}}
+ {{}}
+{{}}
+```
+
+{{< accordion mode="open" separated=true >}}
+ {{< accordionItem title="Markdown example" icon="code" open=true >}}
+ This item demonstrates Markdown rendering:
+ - **Bold text**
+ - Lists
+ - `inline code`
+ {{< /accordionItem >}}
+
+ {{< accordionItem title="Shortcode example" md=false >}}
+ This item demonstrates shortcode rendering with md=false:
+
+ {{< alert >}}This is an inline alert.{{< /alert >}}
+ {{< /accordionItem >}}
+{{< /accordion >}}
+
+**例2:** `mode="collapse"`(同一时间仅展开一个条目)
+
+```md
+{{}}
+ {{}}
+ This item uses Markdown with a short list:
+ 1. One
+ 2. Two
+ 3. Three
+ {{}}
+
+ {{}}
+ This item includes another shortcode:
+ {{}}Tip{{}}
+ {{}}
+{{}}
+```
+
+{{< accordion mode="collapse" >}}
+ {{< accordionItem title="First item" open=true >}}
+ This item uses Markdown with a short list:
+ 1. One
+ 2. Two
+ 3. Three
+ {{< /accordionItem >}}
+
+ {{< accordionItem title="Second item" md=false >}}
+ This item includes another shortcode:
+ {{< badge >}}Tip{{< /badge >}}
+ {{< /accordionItem >}}
+{{< /accordion >}}
+
+
+## 统计数据
+
+使用 `stats` 和 `stat` 可以在响应式网格中展示简洁、醒目的指标数据。网格在大屏幕上默认为三列,使用 `columns="4"` 可设置为四列。
+
+```md
+{{}}
+{{}}Compose pages without bespoke templates.{{}}
+{{}}Keep your content in Markdown.{{}}
+{{}}Start with Hugo and Blowfish.{{}}
+{{}}
+```
+
+{{< stats >}}
+{{< stat value="40+" label="Shortcodes" >}}Compose pages without bespoke templates.{{< /stat >}}
+{{< stat value="100%" label="Portable" >}}Keep your content in Markdown.{{< /stat >}}
+{{< stat value="0" label="Required plugins" >}}Start with Hugo and Blowfish.{{< /stat >}}
+{{< /stats >}}
+
+
+
+## 步骤
+
+使用 `steps` 和 `step` 来展示入门引导、流程、路线图和教程。
+
+```md
+{{}}
+{{}}Choose a colour scheme and homepage layout.{{}}
+{{}}Use standard Markdown and shortcodes.{{}}
+{{}}
+```
+
+{{< steps >}}
+{{< step number="1" title="Configure the theme" >}}Choose a colour scheme and homepage layout.{{< /step >}}
+{{< step number="2" title="Write your content" >}}Use standard Markdown and shortcodes.{{< /step >}}
+{{< /steps >}}
+
+
+
## 色板
`swatches` 输出一组最多三种不同的颜色来展示颜色元素的调色板。该简码采用每种颜色的 `HEX` 码并为每种颜色创建预览。
@@ -996,13 +1237,13 @@ With html code
{{< timelineItem icon="star" header="Shortcodes" badge="AWESOME" >}}
With other shortcodes
{{< gallery >}}
-
-
-
-
-
-
-
+
+
+
+
+
+
+
{{< /gallery >}}
{{< /timelineItem >}}
diff --git a/exampleSite/content/docs/thumbnails/index.de.md b/exampleSite/content/docs/thumbnails/index.de.md
index 87757817..511d87ba 100644
--- a/exampleSite/content/docs/thumbnails/index.de.md
+++ b/exampleSite/content/docs/thumbnails/index.de.md
@@ -1,5 +1,6 @@
---
title: "Vorschaubilder"
+featureimage: "images/v3/thumbnails.png"
weight: 10
draft: false
description: "Aktivieren Sie Vorschaubilder für Ihre Artikel."
diff --git a/exampleSite/content/docs/thumbnails/index.es.md b/exampleSite/content/docs/thumbnails/index.es.md
index 915c73d0..d259a5b8 100644
--- a/exampleSite/content/docs/thumbnails/index.es.md
+++ b/exampleSite/content/docs/thumbnails/index.es.md
@@ -1,5 +1,6 @@
---
title: "Miniaturas"
+featureimage: "images/v3/thumbnails.png"
weight: 10
draft: false
description: "Activa las miniaturas para tus artículos."
diff --git a/exampleSite/content/docs/thumbnails/index.fr.md b/exampleSite/content/docs/thumbnails/index.fr.md
index 8878ecb2..325490e4 100644
--- a/exampleSite/content/docs/thumbnails/index.fr.md
+++ b/exampleSite/content/docs/thumbnails/index.fr.md
@@ -1,5 +1,6 @@
---
title: "Vignettes"
+featureimage: "images/v3/thumbnails.png"
weight: 10
draft: false
description: "Activez les vignettes pour vos articles."
diff --git a/exampleSite/content/docs/thumbnails/index.it.md b/exampleSite/content/docs/thumbnails/index.it.md
index a7f27a25..9c1602f4 100644
--- a/exampleSite/content/docs/thumbnails/index.it.md
+++ b/exampleSite/content/docs/thumbnails/index.it.md
@@ -1,5 +1,6 @@
---
title: "Thumbnails"
+featureimage: "images/v3/thumbnails.png"
weight: 10
draft: false
description: "Turn on thumbnails for your articles."
diff --git a/exampleSite/content/docs/thumbnails/index.ja.md b/exampleSite/content/docs/thumbnails/index.ja.md
index 33a37479..a04092fa 100644
--- a/exampleSite/content/docs/thumbnails/index.ja.md
+++ b/exampleSite/content/docs/thumbnails/index.ja.md
@@ -1,5 +1,6 @@
---
title: "サムネイル"
+featureimage: "images/v3/thumbnails.png"
weight: 10
draft: false
description: "記事にサムネイル画像を設定する。"
diff --git a/exampleSite/content/docs/thumbnails/index.pt-br.md b/exampleSite/content/docs/thumbnails/index.pt-br.md
index 051a1a53..4fa349db 100644
--- a/exampleSite/content/docs/thumbnails/index.pt-br.md
+++ b/exampleSite/content/docs/thumbnails/index.pt-br.md
@@ -1,5 +1,6 @@
---
title: "Miniaturas"
+featureimage: "images/v3/thumbnails.png"
weight: 10
draft: false
description: "Ative miniaturas para seus artigos."
diff --git a/exampleSite/content/docs/thumbnails/index.pt-pt.md b/exampleSite/content/docs/thumbnails/index.pt-pt.md
index 382ecf29..9517cef9 100644
--- a/exampleSite/content/docs/thumbnails/index.pt-pt.md
+++ b/exampleSite/content/docs/thumbnails/index.pt-pt.md
@@ -1,5 +1,6 @@
---
title: "Miniaturas"
+featureimage: "images/v3/thumbnails.png"
weight: 10
draft: false
description: "Ative miniaturas para os seus artigos."
diff --git a/exampleSite/content/docs/thumbnails/index.zh-cn.md b/exampleSite/content/docs/thumbnails/index.zh-cn.md
index 639182c7..a3d40191 100644
--- a/exampleSite/content/docs/thumbnails/index.zh-cn.md
+++ b/exampleSite/content/docs/thumbnails/index.zh-cn.md
@@ -1,5 +1,6 @@
---
title: "缩略图"
+featureimage: "images/v3/thumbnails.png"
weight: 10
draft: false
description: "为你的文章配置缩略图。"
diff --git a/exampleSite/content/docs/welcome/index.de.md b/exampleSite/content/docs/welcome/index.de.md
index a0e20fa2..e741318f 100644
--- a/exampleSite/content/docs/welcome/index.de.md
+++ b/exampleSite/content/docs/welcome/index.de.md
@@ -1,5 +1,6 @@
---
title: "Willkommen bei Blowfish"
+featureimage: "images/v3/welcome.png"
weight: 1
draft: false
description: "Entdecken Sie die Neuerungen in Blowfish Version 2.0."
diff --git a/exampleSite/content/docs/welcome/index.es.md b/exampleSite/content/docs/welcome/index.es.md
index b2237c0c..b289e8d5 100644
--- a/exampleSite/content/docs/welcome/index.es.md
+++ b/exampleSite/content/docs/welcome/index.es.md
@@ -1,5 +1,6 @@
---
title: "Bienvenido a Blowfish"
+featureimage: "images/v3/welcome.png"
weight: 1
draft: false
description: "Descubre las novedades de Blowfish versión 2.0."
diff --git a/exampleSite/content/docs/welcome/index.fr.md b/exampleSite/content/docs/welcome/index.fr.md
index ccf1c094..7129fe66 100644
--- a/exampleSite/content/docs/welcome/index.fr.md
+++ b/exampleSite/content/docs/welcome/index.fr.md
@@ -1,5 +1,6 @@
---
title: "Bienvenue sur Blowfish"
+featureimage: "images/v3/welcome.png"
weight: 1
draft: false
description: "Découvrez les nouveautés de Blowfish version 2.0."
diff --git a/exampleSite/content/docs/welcome/index.it.md b/exampleSite/content/docs/welcome/index.it.md
index 7578cf62..d21b97f6 100644
--- a/exampleSite/content/docs/welcome/index.it.md
+++ b/exampleSite/content/docs/welcome/index.it.md
@@ -1,5 +1,6 @@
---
title: "Benvenuti a Blowfish"
+featureimage: "images/v3/welcome.png"
weight: 1
draft: false
description: "Scopri le novità della versione 2.0 di Blowfish."
diff --git a/exampleSite/content/docs/welcome/index.ja.md b/exampleSite/content/docs/welcome/index.ja.md
index b00c14cd..458f4bee 100644
--- a/exampleSite/content/docs/welcome/index.ja.md
+++ b/exampleSite/content/docs/welcome/index.ja.md
@@ -1,5 +1,6 @@
---
title: "Blowfish へようこそ"
+featureimage: "images/v3/welcome.png"
weight: 1
draft: false
description: "Blowfish バージョン 2.0 の新機能をご紹介。"
diff --git a/exampleSite/content/docs/welcome/index.pt-br.md b/exampleSite/content/docs/welcome/index.pt-br.md
index a0cae48a..f05706e9 100644
--- a/exampleSite/content/docs/welcome/index.pt-br.md
+++ b/exampleSite/content/docs/welcome/index.pt-br.md
@@ -1,5 +1,6 @@
---
title: "Bem-vindo ao Blowfish"
+featureimage: "images/v3/welcome.png"
weight: 1
draft: false
description: "Descubra as novidades do Blowfish versão 2.0."
diff --git a/exampleSite/content/docs/welcome/index.pt-pt.md b/exampleSite/content/docs/welcome/index.pt-pt.md
index 1f3be561..27a96578 100644
--- a/exampleSite/content/docs/welcome/index.pt-pt.md
+++ b/exampleSite/content/docs/welcome/index.pt-pt.md
@@ -1,5 +1,6 @@
---
title: "Bem-vindo ao Blowfish"
+featureimage: "images/v3/welcome.png"
weight: 1
draft: false
description: "Descubra as novidades do Blowfish versão 2.0."
diff --git a/exampleSite/content/docs/welcome/index.zh-cn.md b/exampleSite/content/docs/welcome/index.zh-cn.md
index ebc45a3a..9733fcf9 100644
--- a/exampleSite/content/docs/welcome/index.zh-cn.md
+++ b/exampleSite/content/docs/welcome/index.zh-cn.md
@@ -1,5 +1,6 @@
---
title: "欢迎来到 Blowfish"
+featureimage: "images/v3/welcome.png"
weight: 1
draft: false
description: "探索 Blowfish 2.0版本的新功能。"
diff --git a/exampleSite/content/guides/202310-blowfish-tutorial/index.it.md b/exampleSite/content/guides/202310-blowfish-tutorial/index.it.md
index bb00516f..50235892 100644
--- a/exampleSite/content/guides/202310-blowfish-tutorial/index.it.md
+++ b/exampleSite/content/guides/202310-blowfish-tutorial/index.it.md
@@ -262,10 +262,10 @@ Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi nibh nisl, vulput
You can create additional articles to see what your site will look like once there is content in it. Your site should look like the images below. The main page shows the recent articles, each article is connected through others automatically via related section, you have tag aggregation, and full-text search.
{{< gallery >}}
-
-
-
-
+
+
+
+
{{< /gallery >}}
diff --git a/exampleSite/content/guides/202310-blowfish-tutorial/index.ja.md b/exampleSite/content/guides/202310-blowfish-tutorial/index.ja.md
index bb00516f..50235892 100644
--- a/exampleSite/content/guides/202310-blowfish-tutorial/index.ja.md
+++ b/exampleSite/content/guides/202310-blowfish-tutorial/index.ja.md
@@ -262,10 +262,10 @@ Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi nibh nisl, vulput
You can create additional articles to see what your site will look like once there is content in it. Your site should look like the images below. The main page shows the recent articles, each article is connected through others automatically via related section, you have tag aggregation, and full-text search.
{{< gallery >}}
-
-
-
-
+
+
+
+
{{< /gallery >}}
diff --git a/exampleSite/content/guides/202310-blowfish-tutorial/index.md b/exampleSite/content/guides/202310-blowfish-tutorial/index.md
index b34e4a30..70959d97 100644
--- a/exampleSite/content/guides/202310-blowfish-tutorial/index.md
+++ b/exampleSite/content/guides/202310-blowfish-tutorial/index.md
@@ -262,10 +262,10 @@ Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi nibh nisl, vulput
You can create additional articles to see what your site will look like once there is content in it. Your site should look like the images below. The main page shows the recent articles, each article is connected through others automatically via related section, you have tag aggregation, and full-text search.
{{< gallery >}}
-
-
-
-
+
+
+
+
{{< /gallery >}}
diff --git a/exampleSite/content/guides/202310-blowfish-tutorial/index.zh-cn.md b/exampleSite/content/guides/202310-blowfish-tutorial/index.zh-cn.md
index 79287f65..0639338c 100644
--- a/exampleSite/content/guides/202310-blowfish-tutorial/index.zh-cn.md
+++ b/exampleSite/content/guides/202310-blowfish-tutorial/index.zh-cn.md
@@ -265,10 +265,10 @@ Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi nibh nisl, vulput
主页显示最近的文章，每篇文章通过相关部分自动关联其他文章，有标签聚合和全文搜索。
{{< gallery >}}
-
-
-
-
+
+
+
+
{{< /gallery >}}
diff --git a/exampleSite/content/samples/_index.de.md b/exampleSite/content/samples/_index.de.md
index 9b0e3c4c..2277babb 100644
--- a/exampleSite/content/samples/_index.de.md
+++ b/exampleSite/content/samples/_index.de.md
@@ -5,7 +5,6 @@ description: "Sehen Sie, was mit Blowfish möglich ist."
cascade:
showEdit: false
showSummary: false
- hideFeatureImage: true
invertPagination: true
---
diff --git a/exampleSite/content/samples/_index.es.md b/exampleSite/content/samples/_index.es.md
index da41052a..229568f2 100644
--- a/exampleSite/content/samples/_index.es.md
+++ b/exampleSite/content/samples/_index.es.md
@@ -5,7 +5,6 @@ description: "Ve lo que es posible con Blowfish."
cascade:
showEdit: false
showSummary: false
- hideFeatureImage: true
invertPagination: true
---
diff --git a/exampleSite/content/samples/_index.fr.md b/exampleSite/content/samples/_index.fr.md
index bd1fa4a2..0efc0fde 100644
--- a/exampleSite/content/samples/_index.fr.md
+++ b/exampleSite/content/samples/_index.fr.md
@@ -5,7 +5,6 @@ description: "Voyez ce qui est possible avec Blowfish."
cascade:
showEdit: false
showSummary: false
- hideFeatureImage: true
invertPagination: true
---
diff --git a/exampleSite/content/samples/_index.it.md b/exampleSite/content/samples/_index.it.md
index 401d8cb2..01e64727 100755
--- a/exampleSite/content/samples/_index.it.md
+++ b/exampleSite/content/samples/_index.it.md
@@ -5,7 +5,6 @@ description: "Guarda cosa è possibile fare con Blowfish."
cascade:
showEdit: false
showSummary: false
- hideFeatureImage: true
invertPagination: true
---
{{< lead >}}
diff --git a/exampleSite/content/samples/_index.ja.md b/exampleSite/content/samples/_index.ja.md
index eaaf7b98..f656bf15 100755
--- a/exampleSite/content/samples/_index.ja.md
+++ b/exampleSite/content/samples/_index.ja.md
@@ -5,7 +5,6 @@ description: "Blowfish で何ができるのか閲覧する。"
cascade:
showEdit: false
showSummary: false
- hideFeatureImage: true
invertPagination: true
---
diff --git a/exampleSite/content/samples/_index.md b/exampleSite/content/samples/_index.md
index 26bcd97c..b6a5a522 100755
--- a/exampleSite/content/samples/_index.md
+++ b/exampleSite/content/samples/_index.md
@@ -5,7 +5,6 @@ description: "See what's possible with Blowfish."
cascade:
showEdit: false
showSummary: false
- hideFeatureImage: true
invertPagination: true
---
diff --git a/exampleSite/content/samples/_index.pt-br.md b/exampleSite/content/samples/_index.pt-br.md
index 36080c4e..ed2ec6a4 100644
--- a/exampleSite/content/samples/_index.pt-br.md
+++ b/exampleSite/content/samples/_index.pt-br.md
@@ -5,7 +5,6 @@ description: "Veja o que é possível com o Blowfish."
cascade:
showEdit: false
showSummary: false
- hideFeatureImage: true
invertPagination: true
---
diff --git a/exampleSite/content/samples/_index.pt-pt.md b/exampleSite/content/samples/_index.pt-pt.md
index 70889a18..06943010 100644
--- a/exampleSite/content/samples/_index.pt-pt.md
+++ b/exampleSite/content/samples/_index.pt-pt.md
@@ -5,7 +5,6 @@ description: "Veja o que é possível com o Blowfish."
cascade:
showEdit: false
showSummary: false
- hideFeatureImage: true
invertPagination: true
---
diff --git a/exampleSite/content/samples/_index.zh-cn.md b/exampleSite/content/samples/_index.zh-cn.md
index ef9d6777..92901d28 100644
--- a/exampleSite/content/samples/_index.zh-cn.md
+++ b/exampleSite/content/samples/_index.zh-cn.md
@@ -5,7 +5,6 @@ description: "来看看通过 Blowfish 能做到什么"
cascade:
showEdit: false
showSummary: false
- hideFeatureImage: true
invertPagination: true
---
diff --git a/exampleSite/content/samples/charts/feature.webp b/exampleSite/content/samples/charts/feature.webp
new file mode 100644
index 00000000..f5ab4d4b
Binary files /dev/null and b/exampleSite/content/samples/charts/feature.webp differ
diff --git a/exampleSite/content/samples/diagrams-flowcharts/feature.webp b/exampleSite/content/samples/diagrams-flowcharts/feature.webp
new file mode 100644
index 00000000..d7f60363
Binary files /dev/null and b/exampleSite/content/samples/diagrams-flowcharts/feature.webp differ
diff --git a/exampleSite/content/samples/emoji/feature.webp b/exampleSite/content/samples/emoji/feature.webp
new file mode 100644
index 00000000..827c1ea1
Binary files /dev/null and b/exampleSite/content/samples/emoji/feature.webp differ
diff --git a/exampleSite/content/samples/external/feature.webp b/exampleSite/content/samples/external/feature.webp
new file mode 100644
index 00000000..c0a3aaf8
Binary files /dev/null and b/exampleSite/content/samples/external/feature.webp differ
diff --git a/exampleSite/content/samples/icons/feature.webp b/exampleSite/content/samples/icons/feature.webp
new file mode 100644
index 00000000..29fff161
Binary files /dev/null and b/exampleSite/content/samples/icons/feature.webp differ
diff --git a/exampleSite/content/samples/markdown/feature.webp b/exampleSite/content/samples/markdown/feature.webp
new file mode 100644
index 00000000..5dcfdc45
Binary files /dev/null and b/exampleSite/content/samples/markdown/feature.webp differ
diff --git a/exampleSite/content/samples/mathematical-notation/feature.webp b/exampleSite/content/samples/mathematical-notation/feature.webp
new file mode 100644
index 00000000..80afca9f
Binary files /dev/null and b/exampleSite/content/samples/mathematical-notation/feature.webp differ
diff --git a/exampleSite/content/samples/multiple-authors/feature.webp b/exampleSite/content/samples/multiple-authors/feature.webp
new file mode 100644
index 00000000..b8886f84
Binary files /dev/null and b/exampleSite/content/samples/multiple-authors/feature.webp differ
diff --git a/exampleSite/content/samples/placeholder-text/feature.webp b/exampleSite/content/samples/placeholder-text/feature.webp
new file mode 100644
index 00000000..133061b8
Binary files /dev/null and b/exampleSite/content/samples/placeholder-text/feature.webp differ
diff --git a/exampleSite/content/samples/rich-content/feature.webp b/exampleSite/content/samples/rich-content/feature.webp
new file mode 100644
index 00000000..c1ca539d
Binary files /dev/null and b/exampleSite/content/samples/rich-content/feature.webp differ
diff --git a/exampleSite/content/samples/thumbnail_sample/feature.webp b/exampleSite/content/samples/thumbnail_sample/feature.webp
new file mode 100644
index 00000000..76ebb4db
Binary files /dev/null and b/exampleSite/content/samples/thumbnail_sample/feature.webp differ
- 
- 
- 
- 
- 
- 
+ 
- 
- 
- 
+