📝 Sync v3 docs and content across all nine languages

New shortcode sections, landing layout docs, agent skill sections, v2→v3 upgrade instructions, translated homepages, and sample article feature images. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-10-10 22:09:31 +00:00 · 2026-08-17 20:19:02 +01:00
1 parent 7659c5f23d
commit 5e0e09d415
@@ -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 >}}

-<div class="flex px-4 py-2 mb-8 text-base rounded-md bg-primary-100 dark:bg-primary-900">
-  <span class="flex items-center pe-3 text-primary-400">
-    {{< icon "triangle-exclamation" >}}
-  </span>
-  <span class="flex items-center justify-between grow dark:text-neutral-300">
-    <span class="prose dark:prose-invert">Dies ist eine Demo des <code id="layout">background</code> Layouts.</span>
-    <button
-      id="switch-layout-button"
-      class="px-4 mx-[3px] !text-neutral !no-underline rounded-md bg-primary-600 hover:!bg-primary-500 dark:bg-primary-800 dark:hover:!bg-primary-700"
-    >
-      Layout wechseln &orarr;
-    </button>
-  </span>
-</div>
-
-
-```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 >}}
@@ -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 >}}

-<div class="flex px-4 py-2 mb-8 text-base rounded-md bg-primary-100 dark:bg-primary-900">
-  <span class="flex items-center pe-3 text-primary-400">
-    {{< icon "triangle-exclamation" >}}
-  </span>
-  <span class="flex items-center justify-between grow dark:text-neutral-300">
-    <span class="prose dark:prose-invert">Esta es una demostración del layout <code id="layout">background</code>.</span>
-    <button
-      id="switch-layout-button"
-      class="px-4 mx-[3px] !text-neutral !no-underline rounded-md bg-primary-600 hover:!bg-primary-500 dark:bg-primary-800 dark:hover:!bg-primary-700"
-    >
-      Cambiar layout &orarr;
-    </button>
-  </span>
-</div>
-
-
-```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 >}}
@@ -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 >}}

-<div class="flex px-4 py-2 mb-8 text-base rounded-md bg-primary-100 dark:bg-primary-900">
-  <span class="flex items-center pe-3 text-primary-400">
-    {{< icon "triangle-exclamation" >}}
-  </span>
-  <span class="flex items-center justify-between grow dark:text-neutral-300">
-    <span class="prose dark:prose-invert">Ceci est une démo du layout <code id="layout">background</code>.</span>
-    <button
-      id="switch-layout-button"
-      class="px-4 mx-[3px] !text-neutral !no-underline rounded-md bg-primary-600 hover:!bg-primary-500 dark:bg-primary-800 dark:hover:!bg-primary-700"
-    >
-      Changer de layout &orarr;
-    </button>
-  </span>
-</div>
-
-
-```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 >}}
@@ -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"
 ---
-<div class="flex px-4 py-2 mb-8 text-base rounded-md bg-primary-100 dark:bg-primary-900">
-  <span class="flex items-center pe-3 text-primary-400">
-    {{< icon "triangle-exclamation" >}}
-  </span>
-  <span class="flex items-center justify-between grow dark:text-neutral-300">
-    <span class="prose dark:prose-invert">Questa è una demo del layout <code id="layout">background</code>.</span>
-    <button
-      id="switch-layout-button"
-      class="px-4 mx-[3px] !text-neutral !no-underline rounded-md bg-primary-600 hover:!bg-primary-500 dark:bg-primary-800 dark:hover:!bg-primary-700"
-    >
-      Cambia layout &orarr;
-    </button>
-  </span>
-</div>

+{{< 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 >}}
@@ -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 >}}

-<div class="flex px-4 py-2 mb-8 text-base rounded-md bg-primary-100 dark:bg-primary-900">
-  <span class="flex items-center pe-3 text-primary-400">
-    {{< icon "triangle-exclamation" >}}
-  </span>
-  <span class="flex items-center justify-between grow dark:text-neutral-300">
-    <span class="prose dark:prose-invert">こちらは <code id="layout">background</code> レイアウトのデモです。</span>
-    <button
-      id="switch-layout-button"
-      class="px-4 mx-[3px] !text-neutral !no-underline rounded-md bg-primary-600 hover:!bg-primary-500 dark:bg-primary-800 dark:hover:!bg-primary-700"
-    >
-      レイアウトを変更する&orarr;
-    </button>
-  </span>
-</div>
-
-
-```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 >}}
@@ -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" >}}
-&nbsp;
-{{< 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 >}}
@@ -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 >}}

-<div class="flex px-4 py-2 mb-8 text-base rounded-md bg-primary-100 dark:bg-primary-900">
-  <span class="flex items-center pe-3 text-primary-400">
-    {{< icon "triangle-exclamation" >}}
-  </span>
-  <span class="flex items-center justify-between grow dark:text-neutral-300">
-    <span class="prose dark:prose-invert">Esta é uma demonstração do layout <code id="layout">background</code>.</span>
-    <button
-      id="switch-layout-button"
-      class="px-4 mx-[3px] !text-neutral !no-underline rounded-md bg-primary-600 hover:!bg-primary-500 dark:bg-primary-800 dark:hover:!bg-primary-700"
-    >
-      Mudar layout &orarr;
-    </button>
-  </span>
-</div>
-
-
-```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 >}}
@@ -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 >}}

-<div class="flex px-4 py-2 mb-8 text-base rounded-md bg-primary-100 dark:bg-primary-900">
-  <span class="flex items-center pe-3 text-primary-400">
-    {{< icon "triangle-exclamation" >}}
-  </span>
-  <span class="flex items-center justify-between grow dark:text-neutral-300">
-    <span class="prose dark:prose-invert">Esta é uma demonstração do layout <code id="layout">background</code>.</span>
-    <button
-      id="switch-layout-button"
-      class="px-4 mx-[3px] !text-neutral !no-underline rounded-md bg-primary-600 hover:!bg-primary-500 dark:bg-primary-800 dark:hover:!bg-primary-700"
-    >
-      Mudar layout &orarr;
-    </button>
-  </span>
-</div>
-
-
-```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 >}}
@@ -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 >}}

-<div class="flex px-4 py-2 mb-8 text-base rounded-md bg-primary-100 dark:bg-primary-900">
-  <span class="flex items-center pe-3 text-primary-400">
-    {{< icon "triangle-exclamation" >}}
-  </span>
-  <span class="flex items-center justify-between grow dark:text-neutral-300">
-    <span class="prose dark:prose-invert"> 这是 <code id="layout">background</code> 的样式示例。</span>
-    <button
-      id="switch-layout-button"
-      class="px-4 mx-[3px] !text-neutral !no-underline rounded-md bg-primary-600 hover:!bg-primary-500 dark:bg-primary-800 dark:hover:!bg-primary-700"
-    >
-      切换 layout &orarr;
-    </button>
-  </span>
-</div>
-
-
-```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 >}}
@@ -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."
@@ -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."
@@ -1,5 +1,6 @@
 ---
 title: "Personnalisation avancée"
+featureimage: "images/v3/advanced-customisation.png"
 weight: 13
 draft: false
 description: "Apprenez à construire Blowfish manuellement."
@@ -1,5 +1,6 @@
 ---
 title: "Advanced Customisation"
+featureimage: "images/v3/advanced-customisation.png"
 weight: 13
 draft: false
 description: "Learn how to build Blowfish manually."
@@ -1,5 +1,6 @@
 ---
 title: "高度なカスタマイズ"
+featureimage: "images/v3/advanced-customisation.png"
 weight: 13
 draft: false
 description: "Blowfishを手動でビルドする方法を学びましょう。"
@@ -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."
@@ -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."
@@ -1,5 +1,6 @@
 ---
 title: 进阶自定义
+featureimage: "images/v3/advanced-customisation.png"
 weight: 13
 draft: false
 description: "了解如何手动构建 Blowfish。"
@@ -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.
@@ -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.
@@ -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.
@@ -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 (`![](image.jpg)`). |
 | `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. |
@@ -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 記法（例：`![](image.jpg)`）の画像の画像サイズ変更と最適化機能のみを無効にします。他の画像には適用されます。 |
 | `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つの記事に設定されます。 |
@@ -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. |
@@ -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.
@@ -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.
@@ -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篇文章。 |
@@ -1,5 +1,6 @@
 ---
 title: "Inhaltsbeispiele"
+featureimage: "images/v3/content-examples.png"
 weight: 11
 draft: false
 description: "Alle verfügbaren Partials in Blowfish."
@@ -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."
@@ -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."
@@ -1,5 +1,6 @@
 ---
 title: "Content Examples"
+featureimage: "images/v3/content-examples.png"
 weight: 11
 draft: false
 description: "All the partials available in Blowfish."
@@ -1,5 +1,6 @@
 ---
 title: "コンテンツの例"
+featureimage: "images/v3/content-examples.png"
 weight: 11
 draft: false
 description: "Blowfish で利用可能なすべてのパーシャル。"
@@ -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."
@@ -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."
@@ -1,5 +1,6 @@
 ---
 title: "内容示例"
+featureimage: "images/v3/content-examples.png"
 weight: 11
 draft: false
 description: "包含 Blowfish 中所有可用部分的示例、"
@@ -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."
@@ -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."
@@ -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."
@@ -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."
@@ -1,5 +1,6 @@
 ---
 title: "Firebase: 閲覧数といいね"
+featureimage: "images/v3/content-network.png"
 weight: 15
 draft: false
 description: "Firebase を統合して、閲覧数といいねの動的データを取得する方法を学びます。"
@@ -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."
@@ -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."
@@ -1,5 +1,6 @@
 ---
 title: "Firebase: 阅读量 & 点赞量"
+featureimage: "images/v3/content-network.png"
 weight: 15
 draft: false
 description: "了解 Blowfish 如何集成 Firebase，并动态显示阅读量和点赞量。"
@@ -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."
@@ -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."
@@ -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."
@@ -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."
@@ -1,5 +1,6 @@
 ---
 title: "フロントマター"
+featureimage: "images/v3/front-matter.png"
 weight: 7
 draft: false
 description: "Blowfish で利用可能なすべてのフロントマター変数。"
@@ -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."
@@ -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."
@@ -1,5 +1,6 @@
 ---
 title: "Front Matter(文件头信息)"
+featureimage: "images/v3/front-matter.png"
 weight: 7
 draft: false
 description: "文本主要介绍 Blowfish 中页面中可以添加的所有的 Front Matter 参数。"
@@ -13,12 +13,8 @@ series_order: 3
 Dieser Abschnitt setzt voraus, dass Sie das [Blowfish-Theme bereits installiert]({{< ref "docs/installation" >}}) haben.
 {{< /alert >}}

-</br>
-{{< 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.
@@ -13,12 +13,8 @@ series_order: 3
 Esta sección asume que ya has [instalado el tema Blowfish]({{< ref "docs/installation" >}}).
 {{< /alert >}}

-</br>
-{{< 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.
@@ -13,12 +13,8 @@ series_order: 3
 Cette section suppose que vous avez déjà [installé le thème Blowfish]({{< ref "docs/installation" >}}).
 {{< /alert >}}

-</br>
-{{< 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.
@@ -13,12 +13,8 @@ series_order: 3
 Questa sezione presuppone che tu abbia già [installato il tema Blowfish]({{< ref "docs/installation" >}}).
 {{< /alert >}}

-</br>
-{{< 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.
@@ -13,12 +13,8 @@ series_order: 3
 このセクションでは、[Blowfish テーマをすでにインストールしている]({{< ref "docs/installation" >}})ことを前提としています。
 {{< /alert >}}

-</br>
-{{< alert "fire" >}}
-Blowfish の使用開始を支援する CLI ツールをリリースしました。インストールと設定に役立ちます。次のコマンドで CLI ツールをグローバルにインストールします。
-```bash
-npx blowfish-tools
-```
+{{< alert "wand-magic-sparkles" >}}
+AI コーディングエージェントを使っていますか？Blowfish には、Claude Code などのエージェントにテーマのインストール・設定・活用方法を教える**エージェントスキル**が付属しています。セットアップ方法は[インストールページ]({{< ref "docs/installation" >}})をご覧ください。
 {{< /alert >}}

 Blowfish に同梱されている設定ファイルには、テーマが認識できるすべての設定が含まれています。デフォルトでは、これらの多くはコメントアウトされていますが、コメントを解除するだけで特定の機能を有効化または変更できます。
@@ -14,12 +14,8 @@ series_order: 3
 This section assumes you have already [installed the Blowfish theme]({{< ref "docs/installation" >}}).
 {{< /alert >}}

-</br>
-{{< 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.
@@ -13,12 +13,8 @@ series_order: 3
 Esta seção assume que você já [instalou o tema Blowfish]({{< ref "docs/installation" >}}).
 {{< /alert >}}

-</br>
-{{< 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.
@@ -13,12 +13,8 @@ series_order: 3
 Esta secção assume que já [instalou o tema Blowfish]({{< ref "docs/installation" >}}).
 {{< /alert >}}

-</br>
-{{< 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.
@@ -13,12 +13,8 @@ series_order: 3
 本节内容需要已经阅读了 [安装 Blowfish 主题]({{< ref "docs/installation" >}})。
 {{< /alert >}}

-</br>
-{{< alert "fire" >}}
-我们刚刚推出了一个 CLI 工具，用来帮助你快速开始 Blowfish。 它将帮助你安装和配置 Blowfish 主题。 可以使用以下命令全局安装 CLI 工具：
-```bash
-npx blowfish-tools
-```
+{{< alert "wand-magic-sparkles" >}}
+在使用 AI 编程智能体？Blowfish 附带一个**智能体技能**，可以教 Claude Code 等智能体如何安装、配置和使用本主题 — 请参阅[安装页面]({{< ref "docs/installation" >}})进行设置。
 {{< /alert >}}

 Blowfish 中的配置文件中包含了主题需要的所有可能的设置选项。但默认情况下大多数设置都是被注释的，你只需要取消注释就可以激活或者修改设定选项。
@@ -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

@@ -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

@@ -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

@@ -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

@@ -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)にアクセスしてください。

 ## 最新記事

@@ -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
@@ -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

@@ -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

@@ -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)查看它的具体配置方式。

 ## 最近文章

@@ -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."
@@ -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."
@@ -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."
@@ -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."
@@ -1,5 +1,6 @@
 ---
 title: "ホスティングとデプロイ"
+featureimage: "images/v3/publishing-system.png"
 weight: 14
 draft: false
 description: "Blowfish サイトのデプロイ方法について説明します。"
@@ -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."
@@ -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."
@@ -1,5 +1,6 @@
 ---
 title: "托管和部署"
+featureimage: "images/v3/publishing-system.png"
 weight: 14
 draft: false
 description: "了解如何部署 Blowfish 网页。"
@@ -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.
@@ -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.
@@ -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.
@@ -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.
@@ -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" >}})で新しいオプトイン機能（フローティングヘッダー、ランディングレイアウト、背景キャンバス、読書プログレスバーなど）を確認してください。
@@ -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.
@@ -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.
@@ -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.
@@ -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" >}})了解新的可选功能 — 悬浮菜单、着陆页布局、全局背景、阅读进度条等。
@@ -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."
@@ -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."
@@ -1,5 +1,6 @@
 ---
 title: "Auteurs multiples"
+featureimage: "images/v3/multiple-authors.png"
 weight: 8
 draft: false
 description: "Configurez plusieurs auteurs pour vos articles."
@@ -1,5 +1,6 @@
 ---
 title: "Multiple Authors"
+featureimage: "images/v3/multiple-authors.png"
 weight: 8
 draft: false
 description: "Configure multiple authors for your articles."
@@ -1,5 +1,6 @@
 ---
 title: "複数の著者"
+featureimage: "images/v3/multiple-authors.png"
 weight: 8
 draft: false
 description: "記事に複数の著者を設定する。"
@@ -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."
@@ -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."
@@ -1,5 +1,6 @@
 ---
 title: "多创作者模式"
+featureimage: "images/v3/multiple-authors.png"
 weight: 8
 draft: false
 description: "为你的文章设置多个作者。"
@@ -1,5 +1,6 @@
 ---
 title: "Partials"
+featureimage: "images/v3/partials.png"
 weight: 9
 draft: false
 description: "Alle verfügbaren Partials in Blowfish."