diff --git a/exampleSite/content/_index.de.md b/exampleSite/content/_index.de.md
index 6ec7e52e..bfbaae21 100644
--- a/exampleSite/content/_index.de.md
+++ b/exampleSite/content/_index.de.md
@@ -1,6 +1,7 @@
 ---
 title: "Baue eine Website, die unverwechselbar deine ist."
 description: "Ein modernes, flexibles Hugo-Theme für Blogs, Dokumentation, Portfolios und mehr."
+lastmod: 2026-08-30
 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"
@@ -35,3 +36,7 @@ Entdecke echte Websites, Community-Beiträge und Patterns, die sich in der Praxi
 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 >}}
+
+{{< alert >}}
+**Blowfish v3.5 ist verfügbar.** Starte eine neue Website mit `npx blowfish-tools new <site>` oder [aktualisiere eine bestehende Website]({{< ref "guides/202608-upgrade-to-blowfish-v3" >}}).
+{{< /alert >}}
diff --git a/exampleSite/content/_index.es.md b/exampleSite/content/_index.es.md
index db50d3fa..70e3e97f 100644
--- a/exampleSite/content/_index.es.md
+++ b/exampleSite/content/_index.es.md
@@ -1,6 +1,7 @@
 ---
 title: "Crea un sitio que sea inconfundiblemente tuyo."
 description: "Un tema de Hugo moderno y flexible para blogs, documentación, portafolios y más."
+lastmod: 2026-08-30
 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"
@@ -35,3 +36,7 @@ Explora sitios reales, contribuciones de la comunidad y patrones que funcionan e
 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 >}}
+
+{{< alert >}}
+**Blowfish v3.5 ya está disponible.** Crea un sitio nuevo con `npx blowfish-tools new <site>` o [actualiza un sitio existente]({{< ref "guides/202608-upgrade-to-blowfish-v3" >}}).
+{{< /alert >}}
diff --git a/exampleSite/content/_index.fr.md b/exampleSite/content/_index.fr.md
index f5579e74..d23aafbd 100644
--- a/exampleSite/content/_index.fr.md
+++ b/exampleSite/content/_index.fr.md
@@ -1,6 +1,7 @@
 ---
 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."
+lastmod: 2026-08-30
 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"
@@ -35,3 +36,7 @@ Découvrez des sites réels, des contributions de la communauté et des patterns
 Blowfish inclut un skill qui apprend à Claude Code et à d'autres agents de codage à installer, configurer et utiliser le thème.
 {{< /feature >}}
 {{< /feature-grid >}}
+
+{{< alert >}}
+**Blowfish v3.5 est disponible.** Créez un nouveau site avec `npx blowfish-tools new <site>` ou [mettez à niveau un site existant]({{< ref "guides/202608-upgrade-to-blowfish-v3" >}}).
+{{< /alert >}}
diff --git a/exampleSite/content/_index.it.md b/exampleSite/content/_index.it.md
index c2bada23..850e54be 100755
--- a/exampleSite/content/_index.it.md
+++ b/exampleSite/content/_index.it.md
@@ -1,6 +1,7 @@
 ---
 title: "Crea un sito che sia inconfondibilmente tuo."
 description: "Un tema Hugo moderno e flessibile per blog, documentazione, portfolio e altro."
+lastmod: 2026-08-30
 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"
@@ -35,3 +36,7 @@ Esplora siti reali, contributi della community e pattern che reggono in produzio
 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 >}}
+
+{{< alert >}}
+**Blowfish v3.5 è disponibile.** Crea un nuovo sito con `npx blowfish-tools new <site>` oppure [aggiorna un sito esistente]({{< ref "guides/202608-upgrade-to-blowfish-v3" >}}).
+{{< /alert >}}
diff --git a/exampleSite/content/_index.ja.md b/exampleSite/content/_index.ja.md
index f8f2fba7..672eb074 100755
--- a/exampleSite/content/_index.ja.md
+++ b/exampleSite/content/_index.ja.md
@@ -1,6 +1,7 @@
 ---
 title: "まぎれもなく自分らしいサイトを。"
 description: "ブログ、ドキュメント、ポートフォリオなどに使える、モダンで柔軟な Hugo テーマ。"
+lastmod: 2026-08-30
 heroLead: "Blowfish は表現力豊かなレイアウト、行き届いたデフォルト設定、実用的なコンテンツ部品を提供します。あなたは伝えたいことに集中するだけです。"
 heroButtons:
   - label: "はじめる"
@@ -35,3 +36,7 @@ heroImage: "images/v3/welcome.png"
 Blowfish には、Claude Code などのコーディングエージェントにテーマのインストール・設定・活用方法を教えるエージェントスキルが付属しています。
 {{< /feature >}}
 {{< /feature-grid >}}
+
+{{< alert >}}
+**Blowfish v3.5 が利用可能になりました。** `npx blowfish-tools new <site>` で新しいサイトを始めるか、[既存サイトをアップグレード]({{< ref "guides/202608-upgrade-to-blowfish-v3" >}})してください。
+{{< /alert >}}
diff --git a/exampleSite/content/_index.pt-br.md b/exampleSite/content/_index.pt-br.md
index 11db5d2f..1a6b73af 100644
--- a/exampleSite/content/_index.pt-br.md
+++ b/exampleSite/content/_index.pt-br.md
@@ -1,6 +1,7 @@
 ---
 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."
+lastmod: 2026-08-30
 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"
@@ -35,3 +36,7 @@ Explore sites reais, contribuições da comunidade e padrões que funcionam em p
 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 >}}
+
+{{< alert >}}
+**O Blowfish v3.5 está disponível.** Crie um novo site com `npx blowfish-tools new <site>` ou [atualize um site existente]({{< ref "guides/202608-upgrade-to-blowfish-v3" >}}).
+{{< /alert >}}
diff --git a/exampleSite/content/_index.pt-pt.md b/exampleSite/content/_index.pt-pt.md
index e47f1cd3..96fa4395 100644
--- a/exampleSite/content/_index.pt-pt.md
+++ b/exampleSite/content/_index.pt-pt.md
@@ -1,6 +1,7 @@
 ---
 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."
+lastmod: 2026-08-30
 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"
@@ -35,3 +36,7 @@ Explore sites reais, contribuições da comunidade e padrões que resistem em pr
 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 >}}
+
+{{< alert >}}
+**O Blowfish v3.5 está disponível.** Crie um novo site com `npx blowfish-tools new <site>` ou [atualize um site existente]({{< ref "guides/202608-upgrade-to-blowfish-v3" >}}).
+{{< /alert >}}
diff --git a/exampleSite/content/_index.zh-cn.md b/exampleSite/content/_index.zh-cn.md
index e1f10042..408c53a4 100644
--- a/exampleSite/content/_index.zh-cn.md
+++ b/exampleSite/content/_index.zh-cn.md
@@ -1,6 +1,7 @@
 ---
 title: "打造一个独一无二、真正属于你的网站。"
 description: "一款现代、灵活的 Hugo 主题，适用于博客、文档、作品集等。"
+lastmod: 2026-08-30
 heroLead: "Blowfish 提供富有表现力的布局、贴心的默认配置和实用的内容组件，让你专注于想要表达的内容。"
 heroButtons:
   - label: "快速开始"
@@ -35,3 +36,7 @@ heroImage: "images/v3/welcome.png"
 Blowfish 附带一个智能体技能，教 Claude Code 等编程智能体安装、配置和使用本主题。
 {{< /feature >}}
 {{< /feature-grid >}}
+
+{{< alert >}}
+**Blowfish v3.5 已发布。** 使用 `npx blowfish-tools new <site>` 创建新网站，或[升级现有网站]({{< ref "guides/202608-upgrade-to-blowfish-v3" >}})。
+{{< /alert >}}
diff --git a/exampleSite/content/docs/welcome/index.de.md b/exampleSite/content/docs/welcome/index.de.md
index e741318f..51722602 100644
--- a/exampleSite/content/docs/welcome/index.de.md
+++ b/exampleSite/content/docs/welcome/index.de.md
@@ -3,16 +3,21 @@ title: "Willkommen bei Blowfish"
 featureimage: "images/v3/welcome.png"
 weight: 1
 draft: false
-description: "Entdecken Sie die Neuerungen in Blowfish Version 2.0."
+description: "Beginnen Sie mit der aktuellen Version von Blowfish, einem modernen Hugo-Theme für Blogs, Dokumentation, Portfolios und mehr."
+lastmod: 2026-08-30
 tags: ["neu", "dokumentation"]
 series: ["Dokumentation"]
 series_order: 1
 ---
 
 {{< lead >}}
-Blowfish ist vollgepackt mit unzähligen Funktionen.
+Blowfish 3 ist ein modernes Hugo-Theme für Blogs, Dokumentation, Portfolios und mehr.
 {{< /lead >}}
 
+{{< alert >}}
+Sie möchten möglichst schnell eine neue Website erstellen? Führen Sie `npx blowfish-tools new <site>` aus und folgen Sie anschließend der [Installationsanleitung]({{< ref "docs/installation" >}}). Die folgenden Abschnitte dokumentieren die wichtigsten Funktionen aus Blowfish 2, die auch in der aktuellen Version verfügbar sind.
+{{< /alert >}}
+
 Das ursprüngliche Ziel von Blowfish war es, ein Theme zu entwickeln, das einfach und leichtgewichtig ist. Das Theme ist ein Fork von <a target="_blank" href="https://github.com/nunocoracao/congo">Congo</a> und erweitert dessen ursprüngliche Vision.
 
 ## Tailwind CSS 3.0
diff --git a/exampleSite/content/docs/welcome/index.es.md b/exampleSite/content/docs/welcome/index.es.md
index b289e8d5..c52f1bc5 100644
--- a/exampleSite/content/docs/welcome/index.es.md
+++ b/exampleSite/content/docs/welcome/index.es.md
@@ -3,16 +3,21 @@ title: "Bienvenido a Blowfish"
 featureimage: "images/v3/welcome.png"
 weight: 1
 draft: false
-description: "Descubre las novedades de Blowfish versión 2.0."
+description: "Empieza a crear con la versión actual de Blowfish, un tema Hugo moderno para blogs, documentación, portafolios y más."
+lastmod: 2026-08-30
 tags: ["nuevo", "documentación"]
 series: ["Documentación"]
 series_order: 1
 ---
 
 {{< lead >}}
-Blowfish está repleto de funcionalidades.
+Blowfish 3 es un tema Hugo moderno para blogs, documentación, portafolios y más.
 {{< /lead >}}
 
+{{< alert >}}
+¿Buscas la forma más rápida de crear un sitio? Ejecuta `npx blowfish-tools new <site>` y luego sigue la [guía de instalación]({{< ref "docs/installation" >}}). Las secciones siguientes documentan las principales funciones introducidas en Blowfish 2, que siguen disponibles en la versión actual.
+{{< /alert >}}
+
 El objetivo original de Blowfish era desarrollar un tema simple y ligero. El tema es un fork de <a target="_blank" href="https://github.com/nunocoracao/congo">Congo</a> y expande su visión inicial.
 
 ## Tailwind CSS 3.0
diff --git a/exampleSite/content/docs/welcome/index.fr.md b/exampleSite/content/docs/welcome/index.fr.md
index 7129fe66..827b1575 100644
--- a/exampleSite/content/docs/welcome/index.fr.md
+++ b/exampleSite/content/docs/welcome/index.fr.md
@@ -3,16 +3,21 @@ title: "Bienvenue sur Blowfish"
 featureimage: "images/v3/welcome.png"
 weight: 1
 draft: false
-description: "Découvrez les nouveautés de Blowfish version 2.0."
+description: "Commencez à créer avec la version actuelle de Blowfish, un thème Hugo moderne pour les blogs, la documentation, les portfolios et plus encore."
+lastmod: 2026-08-30
 tags: ["nouveau", "documentation"]
 series: ["Documentation"]
 series_order: 1
 ---
 
 {{< lead >}}
-Blowfish regorge de fonctionnalités.
+Blowfish 3 est un thème Hugo moderne pour les blogs, la documentation, les portfolios et plus encore.
 {{< /lead >}}
 
+{{< alert >}}
+Vous cherchez le moyen le plus rapide de créer un site ? Exécutez `npx blowfish-tools new <site>`, puis suivez le [guide d'installation]({{< ref "docs/installation" >}}). Les sections ci-dessous présentent les principales fonctionnalités introduites avec Blowfish 2, toujours disponibles dans la version actuelle.
+{{< /alert >}}
+
 L'objectif initial de Blowfish était de développer un thème simple et léger. Le thème est un fork de <a target="_blank" href="https://github.com/nunocoracao/congo">Congo</a> et étend sa vision initiale.
 
 ## Tailwind CSS 3.0
diff --git a/exampleSite/content/docs/welcome/index.it.md b/exampleSite/content/docs/welcome/index.it.md
index d21b97f6..76e732e8 100644
--- a/exampleSite/content/docs/welcome/index.it.md
+++ b/exampleSite/content/docs/welcome/index.it.md
@@ -3,16 +3,21 @@ title: "Benvenuti a Blowfish"
 featureimage: "images/v3/welcome.png"
 weight: 1
 draft: false
-description: "Scopri le novità della versione 2.0 di Blowfish."
+description: "Inizia a creare con la versione attuale di Blowfish, un tema Hugo moderno per blog, documentazione, portfolio e altro."
+lastmod: 2026-08-30
 tags: ["novità", "documenti"]
 series: ["Documentazione"]
 series_order: 1
 ---
 
 {{< lead >}}
-Blowfish è ricco di tantissime funzionalità.
+Blowfish 3 è un tema Hugo moderno per blog, documentazione, portfolio e altro.
 {{< /lead >}}
 
+{{< alert >}}
+Cerchi il modo più rapido per creare un nuovo sito? Esegui `npx blowfish-tools new <site>`, quindi segui la [guida all'installazione]({{< ref "docs/installation" >}}). Le sezioni seguenti documentano le principali funzionalità introdotte con Blowfish 2, ancora disponibili nella versione attuale.
+{{< /alert >}}
+
 Lo scopo originale di Blowfish era quello di sviluppare un tema semplice e leggero. Il tema è un fork del <a target="_blank" href="https://github.com/nunocoracao/congo">Congo</a> e ne espande la visione iniziale.
 
 ## Tailwind CSS 3.0
@@ -76,4 +81,4 @@ Le nuove funzionalità di ridimensionamento delle immagini forniscono inoltre il
 
 ## Molto altro ancora
 
-Ci sono innumerevoli altre funzioni da esplorare. Dalla possibilità di visualizzare tassonomie su articoli e pagine di elenchi, all'uso del nuovo parametro autore `headline` per personalizzare la propria homepage. Sono stati inoltre migliorati i dati strutturati JSON-LD, che ottimizzano ulteriormente le prestazioni SEO.
\ No newline at end of file
+Ci sono innumerevoli altre funzioni da esplorare. Dalla possibilità di visualizzare tassonomie su articoli e pagine di elenchi, all'uso del nuovo parametro autore `headline` per personalizzare la propria homepage. Sono stati inoltre migliorati i dati strutturati JSON-LD, che ottimizzano ulteriormente le prestazioni SEO.
diff --git a/exampleSite/content/docs/welcome/index.ja.md b/exampleSite/content/docs/welcome/index.ja.md
index 458f4bee..7d6a41a6 100644
--- a/exampleSite/content/docs/welcome/index.ja.md
+++ b/exampleSite/content/docs/welcome/index.ja.md
@@ -3,16 +3,21 @@ title: "Blowfish へようこそ"
 featureimage: "images/v3/welcome.png"
 weight: 1
 draft: false
-description: "Blowfish バージョン 2.0 の新機能をご紹介。"
+description: "ブログ、ドキュメント、ポートフォリオなどに使えるモダンな Hugo テーマ、Blowfish の現行バージョンでサイトを作り始めましょう。"
+lastmod: 2026-08-30
 tags: ["new", "docs"]
 series: ["Documentation"]
 series_order: 1
 ---
 
 {{< lead >}}
-Blowfish にはたくさんの機能が詰まっています。
+Blowfish 3 は、ブログ、ドキュメント、ポートフォリオなどに使えるモダンな Hugo テーマです。
 {{< /lead >}}
 
+{{< alert >}}
+新しいサイトを最短で始めるには、`npx blowfish-tools new <site>` を実行してから[インストールガイド]({{< ref "docs/installation" >}})に従ってください。以下のセクションでは、現行リリースでも利用できる Blowfish 2 で導入された主な機能を紹介します。
+{{< /alert >}}
+
 元々、Blowfish の目標は、シンプルで軽量なテーマを開発することでした。このテーマは <a target="_blank" href="https://github.com/nunocoracao/congo">Congo</a> をフォークし、その当初のビジョンを発展させたものです。
 
 ## Tailwind CSS 3.0
diff --git a/exampleSite/content/docs/welcome/index.pt-br.md b/exampleSite/content/docs/welcome/index.pt-br.md
index f05706e9..b45491e1 100644
--- a/exampleSite/content/docs/welcome/index.pt-br.md
+++ b/exampleSite/content/docs/welcome/index.pt-br.md
@@ -3,16 +3,21 @@ title: "Bem-vindo ao Blowfish"
 featureimage: "images/v3/welcome.png"
 weight: 1
 draft: false
-description: "Descubra as novidades do Blowfish versão 2.0."
+description: "Comece a criar com a versão atual do Blowfish, um tema Hugo moderno para blogs, documentação, portfólios e muito mais."
+lastmod: 2026-08-30
 tags: ["novo", "documentação"]
 series: ["Documentação"]
 series_order: 1
 ---
 
 {{< lead >}}
-O Blowfish está repleto de funcionalidades.
+O Blowfish 3 é um tema Hugo moderno para blogs, documentação, portfólios e muito mais.
 {{< /lead >}}
 
+{{< alert >}}
+Quer o caminho mais rápido para um novo site? Execute `npx blowfish-tools new <site>` e siga o [guia de instalação]({{< ref "docs/installation" >}}). As seções abaixo documentam os principais recursos introduzidos no Blowfish 2, que continuam disponíveis na versão atual.
+{{< /alert >}}
+
 O objetivo original do Blowfish era desenvolver um tema simples e leve. O tema é um fork do <a target="_blank" href="https://github.com/nunocoracao/congo">Congo</a> e expande sua visão inicial.
 
 ## Tailwind CSS 3.0
diff --git a/exampleSite/content/docs/welcome/index.pt-pt.md b/exampleSite/content/docs/welcome/index.pt-pt.md
index 27a96578..a269de16 100644
--- a/exampleSite/content/docs/welcome/index.pt-pt.md
+++ b/exampleSite/content/docs/welcome/index.pt-pt.md
@@ -3,16 +3,21 @@ title: "Bem-vindo ao Blowfish"
 featureimage: "images/v3/welcome.png"
 weight: 1
 draft: false
-description: "Descubra as novidades do Blowfish versão 2.0."
+description: "Comece a criar com a versão atual do Blowfish, um tema Hugo moderno para blogs, documentação, portefólios e muito mais."
+lastmod: 2026-08-30
 tags: ["novo", "documentação"]
 series: ["Documentação"]
 series_order: 1
 ---
 
 {{< lead >}}
-O Blowfish está repleto de funcionalidades.
+O Blowfish 3 é um tema Hugo moderno para blogs, documentação, portefólios e muito mais.
 {{< /lead >}}
 
+{{< alert >}}
+Procura a forma mais rápida de criar um novo site? Execute `npx blowfish-tools new <site>` e siga o [guia de instalação]({{< ref "docs/installation" >}}). As secções abaixo documentam as principais funcionalidades introduzidas no Blowfish 2, que continuam disponíveis na versão atual.
+{{< /alert >}}
+
 O objetivo original do Blowfish era desenvolver um tema simples e leve. O tema é um fork do <a target="_blank" href="https://github.com/nunocoracao/congo">Congo</a> e expande a sua visão inicial.
 
 ## Tailwind CSS 3.0
diff --git a/exampleSite/content/docs/welcome/index.zh-cn.md b/exampleSite/content/docs/welcome/index.zh-cn.md
index 9733fcf9..b72d27ea 100644
--- a/exampleSite/content/docs/welcome/index.zh-cn.md
+++ b/exampleSite/content/docs/welcome/index.zh-cn.md
@@ -3,16 +3,21 @@ title: "欢迎来到 Blowfish"
 featureimage: "images/v3/welcome.png"
 weight: 1
 draft: false
-description: "探索 Blowfish 2.0版本的新功能。"
+description: "使用 Blowfish 当前版本开始构建网站，它是一款适用于博客、文档、作品集等的现代 Hugo 主题。"
+lastmod: 2026-08-30
 tags: ["新手", "文档"]
 series: ["部署教程"]
 series_order: 1
 ---
 
 {{< lead >}}
-Blowfish 包含了大量的特性功能。
+Blowfish 3 是一款适用于博客、文档、作品集等的现代 Hugo 主题。
 {{< /lead >}}
 
+{{< alert >}}
+想最快创建新网站？运行 `npx blowfish-tools new <site>`，然后按照[安装指南]({{< ref "docs/installation" >}})操作。以下章节介绍 Blowfish 2 新增的主要功能，这些功能在当前版本中仍然可用。
+{{< /alert >}}
+
 Blowfish 的目标是开发一个简单且轻量级的主题。 该主题是 <a target="_blank" href="https://github.com/nunocoracao/congo">Congo</a> 的一个分支，并进行了大量扩展。
 
 ## Tailwind CSS 3.0
@@ -88,4 +93,4 @@ Blowfish 2.0版本的重大变化是增加了自动调整图片大小的功能
 
 欢迎来尝试和探索强大而轻量的 Blowfish 2.0，打造优雅、个性化的创作之旅！
 
-如果你对 Blowfish 有更加创意的想法，欢迎随时[提交](https://github.com/nunocoracao/blowfish/discussions)，期待与你共同营造 Blowfish 的开源文化！
\ No newline at end of file
+如果你对 Blowfish 有更加创意的想法，欢迎随时[提交](https://github.com/nunocoracao/blowfish/discussions)，期待与你共同营造 Blowfish 的开源文化！
diff --git a/exampleSite/content/guides/202608-upgrade-to-blowfish-v3/index.de.md b/exampleSite/content/guides/202608-upgrade-to-blowfish-v3/index.de.md
new file mode 100644
index 00000000..3901df20
--- /dev/null
+++ b/exampleSite/content/guides/202608-upgrade-to-blowfish-v3/index.de.md
@@ -0,0 +1,48 @@
+---
+title: "Eine bestehende Hugo-Website auf Blowfish 3 aktualisieren"
+description: "Migrieren Sie eine bestehende Blowfish-Website auf Version 3, ohne die Konfiguration ändern zu müssen."
+date: 2026-08-30
+lastmod: 2026-08-30
+tags: ["blowfish", "hugo", "migration", "v3"]
+showauthor: false
+authors: ["nunocoracao"]
+---
+
+{{< lead >}}
+Blowfish 3 ist abwärtskompatibel. Bestehende Websites können aktualisiert werden, ohne Konfiguration oder Inhalte neu schreiben zu müssen.
+{{< /lead >}}
+
+## Vor dem Upgrade
+
+Committen Sie den aktuellen Stand Ihrer Website und stellen Sie sicher, dass Ihre Hugo-Version innerhalb des von Blowfish angegebenen Bereichs liegt. Falls Sie eigene Dateien im Theme-Verzeichnis haben, verschieben Sie diese zuerst in die Verzeichnisse `assets/` oder `layouts/` Ihrer Website, damit sie bei Updates nicht überschrieben werden.
+
+## Installation aktualisieren
+
+### Hugo-Modul
+
+Ergänzen Sie den Modulpfad in `config/_default/module.toml` um `/v3` und aktualisieren Sie anschließend die Abhängigkeiten:
+
+```toml
+[[imports]]
+path = "github.com/nunocoracao/blowfish/v3"
+```
+
+```shell
+hugo mod get -u
+```
+
+### Git-Submodul
+
+```shell
+git submodule update --remote --merge
+```
+
+### Manuelle Installation
+
+Laden Sie das neueste Release herunter, ersetzen Sie `themes/blowfish/` und behalten Sie Ihre Website-Konfiguration in `config/_default/`.
+
+## Ergebnis überprüfen
+
+Führen Sie `hugo server` aus, prüfen Sie Ihre Homepage und einen repräsentativen Artikel und veröffentlichen Sie anschließend wie gewohnt. Neue Funktionen von Blowfish 3 sind optional, daher sollte Ihre bestehende Website unverändert dargestellt werden.
+
+Für eine neue Website verwenden Sie stattdessen `npx blowfish-tools new <site>` und folgen der [Installationsanleitung]({{< ref "docs/installation" >}}).
diff --git a/exampleSite/content/guides/202608-upgrade-to-blowfish-v3/index.es.md b/exampleSite/content/guides/202608-upgrade-to-blowfish-v3/index.es.md
new file mode 100644
index 00000000..c1fc01c4
--- /dev/null
+++ b/exampleSite/content/guides/202608-upgrade-to-blowfish-v3/index.es.md
@@ -0,0 +1,48 @@
+---
+title: "Actualiza un sitio Hugo existente a Blowfish 3"
+description: "Pasa un sitio existente de Blowfish a la versión 3 sin cambios de configuración incompatibles."
+date: 2026-08-30
+lastmod: 2026-08-30
+tags: ["blowfish", "hugo", "migration", "v3"]
+showauthor: false
+authors: ["nunocoracao"]
+---
+
+{{< lead >}}
+Blowfish 3 es compatible con versiones anteriores. Los sitios existentes pueden actualizarse sin reescribir su configuración ni su contenido.
+{{< /lead >}}
+
+## Antes de actualizar
+
+Haz un commit de tu sitio actual y asegúrate de que tu versión de Hugo esté dentro del rango declarado por Blowfish. Si tienes archivos personalizados dentro del directorio del tema, muévelos primero a los directorios `assets/` o `layouts/` de tu sitio para que las actualizaciones no los sobrescriban.
+
+## Actualiza tu instalación
+
+### Módulo de Hugo
+
+Actualiza la ruta del módulo en `config/_default/module.toml` para incluir `/v3` y luego actualiza las dependencias:
+
+```toml
+[[imports]]
+path = "github.com/nunocoracao/blowfish/v3"
+```
+
+```shell
+hugo mod get -u
+```
+
+### Submódulo de Git
+
+```shell
+git submodule update --remote --merge
+```
+
+### Instalación manual
+
+Descarga la última versión, sustituye `themes/blowfish/` y conserva la configuración de tu sitio en `config/_default/`.
+
+## Verifica el resultado
+
+Ejecuta `hugo server`, revisa tu página de inicio y un artículo representativo, y luego publica como de costumbre. Las nuevas funciones de Blowfish 3 son opcionales, por lo que tu sitio existente debería mostrarse igual que antes.
+
+Para un sitio nuevo, usa `npx blowfish-tools new <site>` y sigue la [guía de instalación]({{< ref "docs/installation" >}}).
diff --git a/exampleSite/content/guides/202608-upgrade-to-blowfish-v3/index.fr.md b/exampleSite/content/guides/202608-upgrade-to-blowfish-v3/index.fr.md
new file mode 100644
index 00000000..752ef9ba
--- /dev/null
+++ b/exampleSite/content/guides/202608-upgrade-to-blowfish-v3/index.fr.md
@@ -0,0 +1,48 @@
+---
+title: "Mettre à niveau un site Hugo existant vers Blowfish 3"
+description: "Faites passer un site Blowfish existant à la version 3 sans modification incompatible de la configuration."
+date: 2026-08-30
+lastmod: 2026-08-30
+tags: ["blowfish", "hugo", "migration", "v3"]
+showauthor: false
+authors: ["nunocoracao"]
+---
+
+{{< lead >}}
+Blowfish 3 est rétrocompatible. Les sites existants peuvent être mis à niveau sans réécrire leur configuration ni leur contenu.
+{{< /lead >}}
+
+## Avant la mise à niveau
+
+Validez l'état actuel de votre site et assurez-vous que votre version de Hugo est comprise dans la plage déclarée par Blowfish. Si vous avez des fichiers personnalisés dans le répertoire du thème, déplacez-les d'abord dans les répertoires `assets/` ou `layouts/` de votre site afin que les mises à niveau ne les écrasent pas.
+
+## Mettre à niveau votre installation
+
+### Module Hugo
+
+Modifiez le chemin du module dans `config/_default/module.toml` pour inclure `/v3`, puis actualisez les dépendances :
+
+```toml
+[[imports]]
+path = "github.com/nunocoracao/blowfish/v3"
+```
+
+```shell
+hugo mod get -u
+```
+
+### Sous-module Git
+
+```shell
+git submodule update --remote --merge
+```
+
+### Installation manuelle
+
+Téléchargez la dernière version, remplacez `themes/blowfish/` et conservez la configuration de votre site dans `config/_default/`.
+
+## Vérifier le résultat
+
+Exécutez `hugo server`, vérifiez votre page d'accueil et un article représentatif, puis déployez comme d'habitude. Les nouvelles fonctionnalités de Blowfish 3 sont optionnelles, votre site existant devrait donc s'afficher comme auparavant.
+
+Pour un nouveau site, utilisez plutôt `npx blowfish-tools new <site>` et suivez le [guide d'installation]({{< ref "docs/installation" >}}).
diff --git a/exampleSite/content/guides/202608-upgrade-to-blowfish-v3/index.it.md b/exampleSite/content/guides/202608-upgrade-to-blowfish-v3/index.it.md
new file mode 100644
index 00000000..d9e11404
--- /dev/null
+++ b/exampleSite/content/guides/202608-upgrade-to-blowfish-v3/index.it.md
@@ -0,0 +1,48 @@
+---
+title: "Aggiorna un sito Hugo esistente a Blowfish 3"
+description: "Porta un sito Blowfish esistente alla versione 3 senza modifiche incompatibili alla configurazione."
+date: 2026-08-30
+lastmod: 2026-08-30
+tags: ["blowfish", "hugo", "migration", "v3"]
+showauthor: false
+authors: ["nunocoracao"]
+---
+
+{{< lead >}}
+Blowfish 3 è retrocompatibile. I siti esistenti possono essere aggiornati senza riscrivere la configurazione o i contenuti.
+{{< /lead >}}
+
+## Prima dell'aggiornamento
+
+Esegui il commit del sito attuale e assicurati che la versione di Hugo rientri nell'intervallo dichiarato da Blowfish. Se hai file personalizzati nella directory del tema, spostali prima nelle directory `assets/` o `layouts/` del sito, così gli aggiornamenti non li sovrascriveranno.
+
+## Aggiorna l'installazione
+
+### Modulo Hugo
+
+Aggiorna il percorso del modulo in `config/_default/module.toml` includendo `/v3`, quindi aggiorna le dipendenze:
+
+```toml
+[[imports]]
+path = "github.com/nunocoracao/blowfish/v3"
+```
+
+```shell
+hugo mod get -u
+```
+
+### Sottomodulo Git
+
+```shell
+git submodule update --remote --merge
+```
+
+### Installazione manuale
+
+Scarica l'ultima release, sostituisci `themes/blowfish/` e mantieni la configurazione del sito in `config/_default/`.
+
+## Verifica il risultato
+
+Esegui `hugo server`, controlla la homepage e un articolo rappresentativo, quindi pubblica come di consueto. Le nuove funzionalità di Blowfish 3 sono opzionali, quindi il sito esistente dovrebbe essere visualizzato come prima.
+
+Per un nuovo sito, usa invece `npx blowfish-tools new <site>` e segui la [guida all'installazione]({{< ref "docs/installation" >}}).
diff --git a/exampleSite/content/guides/202608-upgrade-to-blowfish-v3/index.ja.md b/exampleSite/content/guides/202608-upgrade-to-blowfish-v3/index.ja.md
new file mode 100644
index 00000000..a1fe5b47
--- /dev/null
+++ b/exampleSite/content/guides/202608-upgrade-to-blowfish-v3/index.ja.md
@@ -0,0 +1,48 @@
+---
+title: "既存の Hugo サイトを Blowfish 3 にアップグレードする"
+description: "互換性を損なう設定変更なしに、既存の Blowfish サイトをバージョン 3 に移行します。"
+date: 2026-08-30
+lastmod: 2026-08-30
+tags: ["blowfish", "hugo", "migration", "v3"]
+showauthor: false
+authors: ["nunocoracao"]
+---
+
+{{< lead >}}
+Blowfish 3 は後方互換です。既存のサイトは設定やコンテンツを書き直すことなくアップグレードできます。
+{{< /lead >}}
+
+## アップグレード前に
+
+現在のサイトをコミットし、Hugo のバージョンが Blowfish で指定された範囲内にあることを確認してください。テーマディレクトリ内に独自ファイルがある場合は、アップグレードで上書きされないよう、先にサイトの `assets/` または `layouts/` ディレクトリへ移動してください。
+
+## インストールをアップグレードする
+
+### Hugo モジュール
+
+`config/_default/module.toml` のモジュールパスに `/v3` を追加し、依存関係を更新します。
+
+```toml
+[[imports]]
+path = "github.com/nunocoracao/blowfish/v3"
+```
+
+```shell
+hugo mod get -u
+```
+
+### Git サブモジュール
+
+```shell
+git submodule update --remote --merge
+```
+
+### 手動インストール
+
+最新リリースをダウンロードして `themes/blowfish/` を置き換え、サイト固有の設定は `config/_default/` に残してください。
+
+## 結果を確認する
+
+`hugo server` を実行し、ホームページと代表的な記事を確認してから、通常どおりデプロイしてください。Blowfish 3 の新機能はオプトインのため、既存サイトは以前と同じように表示されるはずです。
+
+新しいサイトを作る場合は、`npx blowfish-tools new <site>` を使い、[インストールガイド]({{< ref "docs/installation" >}})に従ってください。
diff --git a/exampleSite/content/guides/202608-upgrade-to-blowfish-v3/index.pt-br.md b/exampleSite/content/guides/202608-upgrade-to-blowfish-v3/index.pt-br.md
new file mode 100644
index 00000000..b73cef84
--- /dev/null
+++ b/exampleSite/content/guides/202608-upgrade-to-blowfish-v3/index.pt-br.md
@@ -0,0 +1,48 @@
+---
+title: "Atualize um site Hugo existente para o Blowfish 3"
+description: "Leve um site Blowfish existente para a versão 3 sem mudanças incompatíveis na configuração."
+date: 2026-08-30
+lastmod: 2026-08-30
+tags: ["blowfish", "hugo", "migration", "v3"]
+showauthor: false
+authors: ["nunocoracao"]
+---
+
+{{< lead >}}
+O Blowfish 3 é compatível com versões anteriores. Sites existentes podem ser atualizados sem reescrever a configuração ou o conteúdo.
+{{< /lead >}}
+
+## Antes de atualizar
+
+Faça commit do seu site atual e certifique-se de que a versão do Hugo esteja dentro do intervalo declarado pelo Blowfish. Se você tiver arquivos personalizados no diretório do tema, mova-os primeiro para os diretórios `assets/` ou `layouts/` do seu site, para que as atualizações não os sobrescrevam.
+
+## Atualize sua instalação
+
+### Módulo Hugo
+
+Atualize o caminho do módulo em `config/_default/module.toml` para incluir `/v3` e depois atualize as dependências:
+
+```toml
+[[imports]]
+path = "github.com/nunocoracao/blowfish/v3"
+```
+
+```shell
+hugo mod get -u
+```
+
+### Submódulo Git
+
+```shell
+git submodule update --remote --merge
+```
+
+### Instalação manual
+
+Baixe a versão mais recente, substitua `themes/blowfish/` e mantenha a configuração do seu site em `config/_default/`.
+
+## Verifique o resultado
+
+Execute `hugo server`, verifique sua página inicial e um artigo representativo e publique como de costume. Os novos recursos do Blowfish 3 são opcionais, então seu site existente deve ser renderizado como antes.
+
+Para um site novo, use `npx blowfish-tools new <site>` e siga o [guia de instalação]({{< ref "docs/installation" >}}).
diff --git a/exampleSite/content/guides/202608-upgrade-to-blowfish-v3/index.pt-pt.md b/exampleSite/content/guides/202608-upgrade-to-blowfish-v3/index.pt-pt.md
new file mode 100644
index 00000000..ce0e9f88
--- /dev/null
+++ b/exampleSite/content/guides/202608-upgrade-to-blowfish-v3/index.pt-pt.md
@@ -0,0 +1,48 @@
+---
+title: "Atualize um site Hugo existente para o Blowfish 3"
+description: "Passe um site Blowfish existente para a versão 3 sem alterações incompatíveis na configuração."
+date: 2026-08-30
+lastmod: 2026-08-30
+tags: ["blowfish", "hugo", "migration", "v3"]
+showauthor: false
+authors: ["nunocoracao"]
+---
+
+{{< lead >}}
+O Blowfish 3 é retrocompatível. Os sites existentes podem ser atualizados sem reescrever a configuração ou o conteúdo.
+{{< /lead >}}
+
+## Antes de atualizar
+
+Faça commit do estado atual do seu site e certifique-se de que a versão do Hugo se encontra dentro do intervalo declarado pelo Blowfish. Se tiver ficheiros personalizados dentro do diretório do tema, mova-os primeiro para os diretórios `assets/` ou `layouts/` do seu site para que as atualizações não os substituam.
+
+## Atualize a sua instalação
+
+### Módulo Hugo
+
+Atualize o caminho do módulo em `config/_default/module.toml` para incluir `/v3` e, depois, atualize as dependências:
+
+```toml
+[[imports]]
+path = "github.com/nunocoracao/blowfish/v3"
+```
+
+```shell
+hugo mod get -u
+```
+
+### Submódulo Git
+
+```shell
+git submodule update --remote --merge
+```
+
+### Instalação manual
+
+Descarregue a versão mais recente, substitua `themes/blowfish/` e mantenha a configuração do seu site em `config/_default/`.
+
+## Verifique o resultado
+
+Execute `hugo server`, verifique a sua página inicial e um artigo representativo e publique como habitualmente. As novas funcionalidades do Blowfish 3 são opcionais, pelo que o seu site existente deverá ser apresentado como antes.
+
+Para um novo site, utilize `npx blowfish-tools new <site>` e siga o [guia de instalação]({{< ref "docs/installation" >}}).
diff --git a/exampleSite/content/guides/202608-upgrade-to-blowfish-v3/index.zh-cn.md b/exampleSite/content/guides/202608-upgrade-to-blowfish-v3/index.zh-cn.md
new file mode 100644
index 00000000..88d1e477
--- /dev/null
+++ b/exampleSite/content/guides/202608-upgrade-to-blowfish-v3/index.zh-cn.md
@@ -0,0 +1,48 @@
+---
+title: "将现有 Hugo 网站升级到 Blowfish 3"
+description: "无需进行破坏性配置更改，即可将现有 Blowfish 网站迁移到版本 3。"
+date: 2026-08-30
+lastmod: 2026-08-30
+tags: ["blowfish", "hugo", "migration", "v3"]
+showauthor: false
+authors: ["nunocoracao"]
+---
+
+{{< lead >}}
+Blowfish 3 向后兼容。现有网站无需重写配置或内容即可升级。
+{{< /lead >}}
+
+## 升级前准备
+
+提交当前网站的更改，并确保 Hugo 版本处于 Blowfish 声明的支持范围内。如果主题目录中有自定义文件，请先将它们移至网站的 `assets/` 或 `layouts/` 目录，以免升级时被覆盖。
+
+## 升级安装方式
+
+### Hugo 模块
+
+在 `config/_default/module.toml` 中更新模块路径以包含 `/v3`，然后刷新依赖：
+
+```toml
+[[imports]]
+path = "github.com/nunocoracao/blowfish/v3"
+```
+
+```shell
+hugo mod get -u
+```
+
+### Git 子模块
+
+```shell
+git submodule update --remote --merge
+```
+
+### 手动安装
+
+下载最新发行版，替换 `themes/blowfish/`，并将站点级配置保留在 `config/_default/` 中。
+
+## 验证结果
+
+运行 `hugo server`，检查主页和一篇有代表性的文章，然后照常部署。Blowfish 3 的新功能均为可选功能，因此现有网站应该和之前一样正常渲染。
+
+如果要创建新网站，请使用 `npx blowfish-tools new <site>` 并按照[安装指南]({{< ref "docs/installation" >}})操作。
diff --git a/exampleSite/content/guides/_index.de.md b/exampleSite/content/guides/_index.de.md
index 50fa1569..669cd808 100644
--- a/exampleSite/content/guides/_index.de.md
+++ b/exampleSite/content/guides/_index.de.md
@@ -1,6 +1,7 @@
 ---
-title: "Rezepte"
-description: "Rezepte, Anleitungen und Tutorials für Blowfish"
+title: "Anleitungen"
+description: "Praktische Anleitungen zum Erstellen, Migrieren und Veröffentlichen von Hugo-Websites mit Blowfish"
+lastmod: 2026-08-30
 
 cascade:
   showDate: false
@@ -9,11 +10,11 @@ cascade:
 ---
 
 {{< lead >}}
-Rezepte, Anleitungen und Tutorials für Blowfish
+Praktische Anleitungen zum Erstellen, Migrieren und Veröffentlichen von Hugo-Websites mit Blowfish.
 {{< /lead >}}
 
 **Blowfish-Nutzer?** Um Ihre Anleitung zu dieser Liste hinzuzufügen, [schauen Sie sich die Vorlage an](/guides/template/).
 
-Dieser Bereich enthält Anleitungen für verschiedene Szenarien zur Konfiguration Ihres Themes. Wenn Sie neu sind, schauen Sie sich die [Installations]({{< ref "docs/installation" >}})-Anleitung an, um zu beginnen, oder besuchen Sie den [Beispiele]({{< ref "samples" >}})-Bereich, um zu sehen, was Blowfish kann.
+Beginnen Sie mit der [Installation]({{< ref "docs/installation" >}}), aktualisieren Sie eine bestehende Website auf [Blowfish 3]({{< ref "guides/202608-upgrade-to-blowfish-v3" >}}) oder lassen Sie sich im [Showcase]({{< ref "examples" >}}) inspirieren.
 
 ---
diff --git a/exampleSite/content/guides/_index.es.md b/exampleSite/content/guides/_index.es.md
index 71584dbe..e3caf2e2 100644
--- a/exampleSite/content/guides/_index.es.md
+++ b/exampleSite/content/guides/_index.es.md
@@ -1,6 +1,7 @@
 ---
-title: "Recetas"
-description: "Recetas, guías y tutoriales para Blowfish"
+title: "Guías"
+description: "Guías prácticas para crear, migrar y publicar sitios Hugo con Blowfish"
+lastmod: 2026-08-30
 
 cascade:
   showDate: false
@@ -9,11 +10,11 @@ cascade:
 ---
 
 {{< lead >}}
-Recetas, guías y tutoriales para Blowfish
+Guías prácticas para crear, migrar y publicar sitios Hugo con Blowfish.
 {{< /lead >}}
 
 **¿Usuario de Blowfish?** Para añadir tu guía a esta lista, [consulta la plantilla](/guides/template/).
 
-Esta sección contiene guías para varios escenarios sobre cómo configurar tu tema. Si eres nuevo, consulta la guía de [Instalación]({{< ref "docs/installation" >}}) para comenzar o visita la sección de [Muestras]({{< ref "samples" >}}) para ver lo que Blowfish puede hacer.
+Empieza con la [instalación]({{< ref "docs/installation" >}}), actualiza un sitio existente a [Blowfish 3]({{< ref "guides/202608-upgrade-to-blowfish-v3" >}}) o explora la [Galería]({{< ref "examples" >}}) para inspirarte.
 
 ---
diff --git a/exampleSite/content/guides/_index.fr.md b/exampleSite/content/guides/_index.fr.md
index 37049e38..293ff0fd 100644
--- a/exampleSite/content/guides/_index.fr.md
+++ b/exampleSite/content/guides/_index.fr.md
@@ -1,6 +1,7 @@
 ---
-title: "Recettes"
-description: "Recettes, guides et tutoriels pour Blowfish"
+title: "Guides"
+description: "Guides pratiques pour créer, migrer et publier des sites Hugo avec Blowfish"
+lastmod: 2026-08-30
 
 cascade:
   showDate: false
@@ -9,11 +10,11 @@ cascade:
 ---
 
 {{< lead >}}
-Recettes, guides et tutoriels pour Blowfish
+Guides pratiques pour créer, migrer et publier des sites Hugo avec Blowfish.
 {{< /lead >}}
 
 **Utilisateur de Blowfish ?** Pour ajouter votre guide à cette liste, [consultez le modèle](/guides/template/).
 
-Cette section contient des guides pour divers scénarios de configuration de votre thème. Si vous êtes nouveau, consultez le guide d'[Installation]({{< ref "docs/installation" >}}) pour commencer ou visitez la section [Échantillons]({{< ref "samples" >}}) pour voir ce que Blowfish peut faire.
+Commencez par l'[installation]({{< ref "docs/installation" >}}), mettez à niveau un site existant vers [Blowfish 3]({{< ref "guides/202608-upgrade-to-blowfish-v3" >}}) ou parcourez la [vitrine]({{< ref "examples" >}}) pour vous inspirer.
 
 ---
diff --git a/exampleSite/content/guides/_index.it.md b/exampleSite/content/guides/_index.it.md
index 8286ffac..0f4c1270 100755
--- a/exampleSite/content/guides/_index.it.md
+++ b/exampleSite/content/guides/_index.it.md
@@ -1,6 +1,7 @@
 ---
-title: "Recipes"
-description: "Recipes, guides, and tutorials for Blowfish"
+title: "Guide"
+description: "Guide pratiche per creare, migrare e pubblicare siti Hugo con Blowfish"
+lastmod: 2026-08-30
 
 cascade:
   showDate: false
@@ -9,11 +10,11 @@ cascade:
 ---
 
 {{< lead >}}
-Recipes, guides, and tutorials for Blowfish
+Guide pratiche per creare, migrare e pubblicare siti Hugo con Blowfish.
 {{< /lead >}}
 
 **Blowfish user?** To add your guide to this list, [check the template](/guides/template/).
 
-This section contains guides for a variety of scenarios on how to configure your theme. If you're new, check out the [Installation]({{< ref "docs/installation" >}}) guide to begin or visit the [Samples]({{< ref "samples" >}}) section to see what Blowfish can do.
+Inizia dall'[installazione]({{< ref "docs/installation" >}}), aggiorna un sito esistente a [Blowfish 3]({{< ref "guides/202608-upgrade-to-blowfish-v3" >}}) oppure esplora la [galleria]({{< ref "examples" >}}) per trovare ispirazione.
 
 ---
diff --git a/exampleSite/content/guides/_index.ja.md b/exampleSite/content/guides/_index.ja.md
index 1e6c818e..3436ee66 100755
--- a/exampleSite/content/guides/_index.ja.md
+++ b/exampleSite/content/guides/_index.ja.md
@@ -1,6 +1,7 @@
 ---
-title: "レシピ"
-description: "Blowfish のためのレシピ、ガイド、チュートリアル"
+title: "ガイド"
+description: "Blowfish で Hugo サイトを構築、移行、公開するための実践ガイド"
+lastmod: 2026-08-30
 
 cascade:
   showDate: false
@@ -9,11 +10,11 @@ cascade:
 ---
 
 {{< lead >}}
-Blowfish のためのレシピ、ガイド、チュートリアル
+Blowfish で Hugo サイトを構築、移行、公開するための実践ガイド。
 {{< /lead >}}
 
 **Blowfish ユーザーですか?** この一覧にあなたのガイドを加える際は、[テンプレートを確認](/guides/template/)してください。
 
-このセクションではあなたのテーマの設定方法する様々なシナリオを含んでいます。新しく作成する場合は、開始するために[インストール]({{< ref "docs/installation" >}})ガイド、または Blowfish が何が出来るか[サンプル]({{< ref "samples" >}})セクションに訪れてください。
+[インストール]({{< ref "docs/installation" >}})から始めるか、既存サイトを [Blowfish 3]({{< ref "guides/202608-upgrade-to-blowfish-v3" >}}) にアップグレードするか、[ショーケース]({{< ref "examples" >}})でアイデアを探してください。
 
 ---
diff --git a/exampleSite/content/guides/_index.pt-br.md b/exampleSite/content/guides/_index.pt-br.md
index 53a4b1ca..f9fa85ea 100644
--- a/exampleSite/content/guides/_index.pt-br.md
+++ b/exampleSite/content/guides/_index.pt-br.md
@@ -1,6 +1,7 @@
 ---
-title: "Receitas"
-description: "Receitas, guias e tutoriais para o Blowfish"
+title: "Guias"
+description: "Guias práticos para criar, migrar e publicar sites Hugo com Blowfish"
+lastmod: 2026-08-30
 
 cascade:
   showDate: false
@@ -9,11 +10,11 @@ cascade:
 ---
 
 {{< lead >}}
-Receitas, guias e tutoriais para o Blowfish
+Guias práticos para criar, migrar e publicar sites Hugo com Blowfish.
 {{< /lead >}}
 
 **Usuário do Blowfish?** Para adicionar seu guia a esta lista, [confira o template](/guides/template/).
 
-Esta seção contém guias para vários cenários sobre como configurar seu tema. Se você é novo, confira o guia de [Instalação]({{< ref "docs/installation" >}}) para começar ou visite a seção de [Amostras]({{< ref "samples" >}}) para ver o que o Blowfish pode fazer.
+Comece pela [instalação]({{< ref "docs/installation" >}}), atualize um site existente para o [Blowfish 3]({{< ref "guides/202608-upgrade-to-blowfish-v3" >}}) ou explore a [galeria]({{< ref "examples" >}}) para se inspirar.
 
 ---
diff --git a/exampleSite/content/guides/_index.pt-pt.md b/exampleSite/content/guides/_index.pt-pt.md
index f2320965..8f391995 100644
--- a/exampleSite/content/guides/_index.pt-pt.md
+++ b/exampleSite/content/guides/_index.pt-pt.md
@@ -1,6 +1,7 @@
 ---
-title: "Receitas"
-description: "Receitas, guias e tutoriais para o Blowfish"
+title: "Guias"
+description: "Guias práticos para criar, migrar e publicar sites Hugo com Blowfish"
+lastmod: 2026-08-30
 
 cascade:
   showDate: false
@@ -9,11 +10,11 @@ cascade:
 ---
 
 {{< lead >}}
-Receitas, guias e tutoriais para o Blowfish
+Guias práticos para criar, migrar e publicar sites Hugo com Blowfish.
 {{< /lead >}}
 
 **Utilizador do Blowfish?** Para adicionar o seu guia a esta lista, [consulte o template](/guides/template/).
 
-Esta secção contém guias para vários cenários sobre como configurar o seu tema. Se é novo, consulte o guia de [Instalação]({{< ref "docs/installation" >}}) para começar ou visite a secção de [Amostras]({{< ref "samples" >}}) para ver o que o Blowfish pode fazer.
+Comece pela [instalação]({{< ref "docs/installation" >}}), atualize um site existente para o [Blowfish 3]({{< ref "guides/202608-upgrade-to-blowfish-v3" >}}) ou explore a [galeria]({{< ref "examples" >}}) para se inspirar.
 
 ---
diff --git a/exampleSite/content/guides/_index.zh-cn.md b/exampleSite/content/guides/_index.zh-cn.md
index e2c4d1a3..8f9dfaca 100755
--- a/exampleSite/content/guides/_index.zh-cn.md
+++ b/exampleSite/content/guides/_index.zh-cn.md
@@ -1,6 +1,7 @@
 ---
-title: "使用指南"
-description: "Blowfish 的使用指南和教程"
+title: "指南"
+description: "使用 Blowfish 构建、迁移和发布 Hugo 网站的实用指南"
+lastmod: 2026-08-30
 
 cascade:
   showDate: false
@@ -9,11 +10,11 @@ cascade:
 ---
 
 {{< lead >}}
-Blowfish 的使用指南和教程
+使用 Blowfish 构建、迁移和发布 Hugo 网站的实用指南。
 {{< /lead >}}
 
 **您是 Blowfish 的用户吗?** 要将您自己编写的指南添加到此列表，请查看[参考模板](/guides/template/)。
 
-本部分包含有关如何配置主题的各种指南。如果您是新用户，请查看 [安装]({{< ref "docs/installation" >}}) 指南或查看 [示例]({{< ref "samples" >}}) 部分来了解 Blowfish 能做出什么效果的网页。
+从[安装]({{< ref "docs/installation" >}})开始，将现有网站升级到 [Blowfish 3]({{< ref "guides/202608-upgrade-to-blowfish-v3" >}})，或浏览[展示案例]({{< ref "examples" >}})获取灵感。
 
 ---