Public/blowfish
1
0 Fork 0
mirror of https://github.com/nunocoracao/blowfish.git synced 2026-11-02 00:59:44 +00:00
Code Issues Packages Projects Releases Wiki Activity

📝 Sync v3 docs and content across all nine languages

Browse Source 
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>
This commit is contained in:
Nuno CoraçãoandClaude Fable 5 authored and Nuno C. committed 2026-08-17 20:19:02 +01:00
1 parent 7659c5f23d
commit 5e0e09d415
164 files changed
+3466 -941
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

exampleSite/content/docs/configuration/index.de.md
+3 -7
View File
@@ -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.
exampleSite/content/docs/configuration/index.es.md
+3 -7
View File
@@ -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.
exampleSite/content/docs/configuration/index.fr.md
+3 -7
View File
@@ -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.
exampleSite/content/docs/configuration/index.it.md
+10 -10
View File
@@ -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. |
exampleSite/content/docs/configuration/index.ja.md
+10 -10
View File
@@ -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つの記事に設定されます。 |
exampleSite/content/docs/configuration/index.md
+4 -8
View File
@@ -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. |
exampleSite/content/docs/configuration/index.pt-br.md
+3 -7
View File
@@ -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.
exampleSite/content/docs/configuration/index.pt-pt.md
+3 -7
View File
@@ -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.
exampleSite/content/docs/configuration/index.zh-cn.md
+10 -10
View File
@@ -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篇文章。 |