🌐 Localize discovery content

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" >}}).

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" >}}).

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" >}}).

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" >}}).

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" >}})に従ってください。

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" >}}).

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" >}}).

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" >}})操作。

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

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

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

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

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" >}})でアイデアを探してください。
 
 ---

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

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

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" >}})获取灵感。
 
 ---