Add 5 new languages to exampleSite: German, French, Spanish, Portuguese

Add complete translations for:
- German (de)
- French (fr)
- Spanish (es)
- Portuguese Brazil (pt-br)
- Portuguese Portugal (pt-pt)

Changes include:
- Language config files (languages.*.toml)
- Menu config files (menus.*.toml)
- Translated docs section (16 files x 5 langs)
- Translated homepage, guides, samples
- Translated examples, authors, tags sections
- Translated users section (112 dirs x 5 langs)
- Fixed YAML front matter formatting in user files

Hugo build now supports 9 languages total.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Nuno Coração
2025-12-22 22:49:50 +00:00
parent e41621dbbc
commit 1d88d5b296
1136 changed files with 30934 additions and 3999 deletions

View File

@@ -0,0 +1,125 @@
---
title: "Konfiguration"
weight: 4
draft: false
description: "Alle in Blowfish verfügbaren Konfigurationsvariablen."
slug: "configuration"
tags: ["konfiguration", "dokumentation"]
series: ["Dokumentation"]
series_order: 4
---
Blowfish ist ein hochgradig anpassbares Theme und nutzt einige der neuesten Hugo-Funktionen, um die Konfiguration zu vereinfachen.
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 >}}
> 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.
Die Standard-Theme-Konfiguration ist in jeder Datei dokumentiert, sodass Sie die Einstellungen frei an Ihre Bedürfnisse anpassen können.
{{< alert >}}
Wie in den [Installationsanweisungen]({{< ref "/docs/installation#set-up-theme-configuration-files" >}}) beschrieben, sollten Sie Ihre Theme-Konfiguration anpassen, indem Sie die Dateien im Ordner `config/_default/` Ihres Hugo-Projekts ändern und die Datei `hugo.toml` im Projektstammverzeichnis löschen.
{{< /alert >}}
## Website-Konfiguration
Standard-Hugo-Konfigurationsvariablen werden im gesamten Theme berücksichtigt, es gibt jedoch einige spezifische Dinge, die für die beste Erfahrung konfiguriert werden sollten.
Die Website-Konfiguration wird über die Datei `config/_default/hugo.toml` verwaltet. Die folgende Tabelle zeigt alle Einstellungen, die Blowfish nutzt.
Beachten Sie, dass die in dieser Tabelle angegebenen Variablennamen die Punktnotation verwenden, um die TOML-Datenstruktur zu vereinfachen (d.h. `outputs.home` bezieht sich auf `[outputs] home`).
<!-- prettier-ignore-start -->
| Name | Standard | Beschreibung |
| --- | --- | --- |
| `theme` | `"blowfish"` | Bei Verwendung von Hugo-Modulen sollte dieser Konfigurationswert entfernt werden. Für alle anderen Installationstypen muss dies auf `blowfish` gesetzt werden, damit das Theme funktioniert. |
| `baseURL` | _Nicht gesetzt_ | Die URL zum Stammverzeichnis der Website. |
| `defaultContentLanguage` | `"en"` | Dieser Wert bestimmt die Standardsprache der Theme-Komponenten und Inhalte. Siehe den Abschnitt [Sprache und i18n](#sprache-und-i18n) unten für unterstützte Sprachcodes. |
| `enableRobotsTXT` | `true` | Wenn aktiviert, wird eine `robots.txt`-Datei im Website-Stammverzeichnis erstellt, die Suchmaschinen das Crawlen der gesamten Website ermöglicht. Wenn Sie Ihre eigene vorgefertigte `robots.txt` bereitstellen möchten, setzen Sie dies auf `false` und platzieren Sie Ihre Datei im `static`-Verzeichnis. Für vollständige Kontrolle können Sie ein [benutzerdefiniertes Layout]({{< ref "content-examples#custom-layouts" >}}) bereitstellen, um diese Datei zu generieren. |
| `pagination.pagerSize` | `10` | Die Anzahl der Artikel, die auf jeder Seite der Artikelliste angezeigt werden. |
| `summaryLength` | `0` | Die Anzahl der Wörter, die zur Generierung der Artikelzusammenfassung verwendet werden, wenn keine im [Front Matter]({{< ref "front-matter" >}}) angegeben ist. Ein Wert von `0` verwendet den ersten Satz. Dieser Wert hat keine Auswirkung, wenn Zusammenfassungen ausgeblendet sind. |
| `outputs.home` | `["HTML", "RSS", "JSON"]` | Die für die Website generierten Ausgabeformate. Blowfish benötigt HTML, RSS und JSON, damit alle Theme-Komponenten korrekt funktionieren. |
| `permalinks` | _Nicht gesetzt_ | Siehe die [Hugo-Dokumentation](https://gohugo.io/configuration/permalinks/) für die Permalink-Konfiguration. |
| `taxonomies` | _Nicht gesetzt_ | Siehe den Abschnitt [Inhalte organisieren]({{< ref "getting-started#organising-content" >}}) für die Taxonomie-Konfiguration. |
<!-- prettier-ignore-end -->
## Thumbnails
Blowfish wurde so entwickelt, dass es einfach ist, visuelle Unterstützung zu Ihren Artikeln hinzuzufügen. Wenn Sie mit der Hugo-Artikelstruktur vertraut sind, müssen Sie nur eine Bilddatei (fast alle Formate werden unterstützt, aber wir empfehlen `.png` oder `.jpg`) in Ihrem Artikelordner platzieren, die mit `feature*` beginnt. Das ist alles, Blowfish kann dann das Bild sowohl als Thumbnail innerhalb Ihrer Website als auch für <a target="_blank" href="https://oembed.com/">oEmbed</a>-Karten auf sozialen Plattformen verwenden.
[Hier]({{< ref "thumbnails" >}}) finden Sie auch einen Leitfaden mit mehr Informationen und ein [Beispiel]({{< ref "thumbnail_sample" >}}), wenn Sie sehen möchten, wie Sie es machen können.
## Sprache und i18n
Blowfish ist für vollständig mehrsprachige Websites optimiert und Theme-Assets sind standardmäßig in mehrere Sprachen übersetzt. Die Sprachkonfiguration ermöglicht es Ihnen, mehrere Versionen Ihres Inhalts zu generieren, um Ihren Besuchern ein angepasstes Erlebnis in ihrer Muttersprache zu bieten.
Das Theme unterstützt derzeit standardmäßig die folgenden Sprachen:
| Sprache | Code |
| --- | --- |
| Arabisch | `ar` |
| Bulgarisch | `bg` |
| Bengali | `bn` |
| Katalanisch | `ca` |
| Tschechisch | `cs` |
| Deutsch | `de` |
| Englisch | `en` |
| Esperanto | `eo` |
| Spanisch (Spanien) | `es` |
| Finnisch | `fi` |
| Französisch | `fr` |
| Galizisch | `gl` |
| Hebräisch | `he` |
| Kroatisch | `hr` |
| Ungarisch | `hu` |
| Indonesisch | `id` |
| Italienisch | `it` |
| Japanisch | `ja` |
| Koreanisch | `ko` |
| Niederländisch | `nl` |
| Persisch | `fa` |
| Polnisch | `pl` |
| Portugiesisch (Brasilien) | `pt-br` |
| Portugiesisch (Portugal) | `pt-pt` |
| Rumänisch | `ro` |
| Russisch | `ru` |
| Thai | `th` |
| Türkisch | `tr` |
| Vietnamesisch | `vi` |
| Vereinfachtes Chinesisch (China) | `zh-cn` |
| Traditionelles Chinesisch (Taiwan) | `zh-tw` |
Die Standardübersetzungen können überschrieben werden, indem Sie eine benutzerdefinierte Datei in `i18n/[code].yaml` erstellen, die die Übersetzungsstrings enthält. Sie können diese Methode auch verwenden, um neue Sprachen hinzuzufügen. Wenn Sie eine neue Übersetzung mit der Community teilen möchten, [öffnen Sie bitte einen Pull Request](https://github.com/nunocoracao/blowfish/pulls).
### Konfiguration
Um so flexibel wie möglich zu sein, muss für jede Sprache auf der Website eine Sprachkonfigurationsdatei erstellt werden. Standardmäßig enthält Blowfish eine englische Sprachkonfiguration unter `config/_default/languages.en.toml`.
Die Standarddatei kann als Vorlage verwendet werden, um zusätzliche Sprachen zu erstellen, oder umbenannt werden, wenn Sie Ihre Website in einer anderen Sprache als Englisch verfassen möchten. Benennen Sie die Datei einfach im Format `languages.[language-code].toml`.
{{< alert >}}
**Hinweis:** Stellen Sie sicher, dass der Parameter `defaultContentLanguage` in der [Website-Konfiguration](#website-konfiguration) mit dem Sprachcode in Ihrem Sprachkonfigurationsdateinamen übereinstimmt.
{{< /alert >}}
Detaillierte Informationen zu allen verfügbaren Konfigurationsparametern finden Sie in der englischen Dokumentation, da die Parameternamen technisch sind und im Original belassen werden.
## Theme-Parameter
Blowfish bietet eine große Anzahl von Konfigurationsparametern, die steuern, wie das Theme funktioniert. Die vollständige Liste aller verfügbaren Parameter finden Sie in der Datei `config/_default/params.toml`.
Viele der Artikel-Standardeinstellungen können auf Artikelebene überschrieben werden, indem sie im Front Matter angegeben werden. Weitere Details finden Sie im Abschnitt [Front Matter]({{< ref "front-matter" >}}).
## Weitere Konfigurationsdateien
Das Theme enthält auch eine `markup.toml`-Konfigurationsdatei. Diese Datei enthält einige wichtige Parameter, die sicherstellen, dass Hugo korrekt konfiguriert ist, um mit Blowfish erstellte Websites zu generieren.
Stellen Sie immer sicher, dass diese Datei im Konfigurationsverzeichnis vorhanden ist und dass die erforderlichen Werte gesetzt sind. Andernfalls können bestimmte Funktionen nicht korrekt funktionieren und es kann zu unbeabsichtigtem Verhalten kommen.

View File

@@ -0,0 +1,125 @@
---
title: "Configuración"
weight: 4
draft: false
description: "Todas las variables de configuración disponibles en Blowfish."
slug: "configuration"
tags: ["configuración", "documentación"]
series: ["Documentación"]
series_order: 4
---
Blowfish es un tema altamente personalizable y utiliza algunas de las últimas características de Hugo para simplificar su configuración.
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 >}}
> 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.
La configuración predeterminada del tema está documentada en cada archivo para que puedas ajustar libremente la configuración según tus necesidades.
{{< alert >}}
Como se describe en las [instrucciones de instalación]({{< ref "/docs/installation#set-up-theme-configuration-files" >}}), debes ajustar la configuración de tu tema modificando los archivos en la carpeta `config/_default/` de tu proyecto Hugo y eliminar el archivo `hugo.toml` en la raíz de tu proyecto.
{{< /alert >}}
## Configuración del sitio
Las variables de configuración estándar de Hugo se respetan en todo el tema, sin embargo, hay algunas cosas específicas que deben configurarse para la mejor experiencia.
La configuración del sitio se gestiona a través del archivo `config/_default/hugo.toml`. La tabla a continuación describe todas las configuraciones que Blowfish aprovecha.
Ten en cuenta que los nombres de variables proporcionados en esta tabla usan notación de puntos para simplificar la estructura de datos TOML (es decir, `outputs.home` se refiere a `[outputs] home`).
<!-- prettier-ignore-start -->
| Nombre | Predeterminado | Descripción |
| --- | --- | --- |
| `theme` | `"blowfish"` | Al usar Módulos Hugo, este valor de configuración debe eliminarse. Para todos los demás tipos de instalación, esto debe establecerse en `blowfish` para que el tema funcione. |
| `baseURL` | _No establecido_ | La URL a la raíz del sitio web. |
| `defaultContentLanguage` | `"en"` | Este valor determina el idioma predeterminado de los componentes del tema y el contenido. Consulta la sección [idioma e i18n](#idioma-e-i18n) a continuación para los códigos de idioma compatibles. |
| `enableRobotsTXT` | `true` | Cuando está habilitado, se creará un archivo `robots.txt` en la raíz del sitio que permite a los motores de búsqueda rastrear todo el sitio. Si prefieres proporcionar tu propio `robots.txt` prefabricado, establece en `false` y coloca tu archivo en el directorio `static`. Para control completo, puedes proporcionar un [diseño personalizado]({{< ref "content-examples#custom-layouts" >}}) para generar este archivo. |
| `pagination.pagerSize` | `10` | El número de artículos listados en cada página de la lista de artículos. |
| `summaryLength` | `0` | El número de palabras que se utilizan para generar el resumen del artículo cuando no se proporciona uno en el [front matter]({{< ref "front-matter" >}}). Un valor de `0` usará la primera oración. Este valor no tiene efecto cuando los resúmenes están ocultos. |
| `outputs.home` | `["HTML", "RSS", "JSON"]` | Los formatos de salida que se generan para el sitio. Blowfish requiere HTML, RSS y JSON para que todos los componentes del tema funcionen correctamente. |
| `permalinks` | _No establecido_ | Consulta la [documentación de Hugo](https://gohugo.io/configuration/permalinks/) para la configuración de permalinks. |
| `taxonomies` | _No establecido_ | Consulta la sección [Organización del contenido]({{< ref "getting-started#organising-content" >}}) para la configuración de taxonomías. |
<!-- prettier-ignore-end -->
## Miniaturas
Blowfish fue construido para que sea fácil agregar soporte visual a tus artículos. Si estás familiarizado con la estructura de artículos de Hugo, solo necesitas colocar un archivo de imagen (casi todos los formatos son compatibles pero recomendamos `.png` o `.jpg`) que comience con `feature*` dentro de tu carpeta de artículo. Y eso es todo, Blowfish podrá usar la imagen tanto como miniatura dentro de tu sitio web como para tarjetas <a target="_blank" href="https://oembed.com/">oEmbed</a> en plataformas sociales.
[Aquí]({{< ref "thumbnails" >}}) también hay una guía con más información y un [ejemplo]({{< ref "thumbnail_sample" >}}) si quieres ver cómo puedes hacerlo.
## Idioma e i18n
Blowfish está optimizado para sitios web completamente multilingües y los recursos del tema están traducidos a varios idiomas de forma predeterminada. La configuración de idioma te permite generar múltiples versiones de tu contenido para proporcionar una experiencia personalizada a tus visitantes en su idioma nativo.
El tema actualmente soporta los siguientes idiomas por defecto:
| Idioma | Código |
| --- | --- |
| Árabe | `ar` |
| Búlgaro | `bg` |
| Bengalí | `bn` |
| Catalán | `ca` |
| Checo | `cs` |
| Alemán | `de` |
| Inglés | `en` |
| Esperanto | `eo` |
| Español (España) | `es` |
| Finlandés | `fi` |
| Francés | `fr` |
| Gallego | `gl` |
| Hebreo | `he` |
| Croata | `hr` |
| Húngaro | `hu` |
| Indonesio | `id` |
| Italiano | `it` |
| Japonés | `ja` |
| Coreano | `ko` |
| Neerlandés | `nl` |
| Persa | `fa` |
| Polaco | `pl` |
| Portugués (Brasil) | `pt-br` |
| Portugués (Portugal) | `pt-pt` |
| Rumano | `ro` |
| Ruso | `ru` |
| Tailandés | `th` |
| Turco | `tr` |
| Vietnamita | `vi` |
| Chino simplificado (China) | `zh-cn` |
| Chino tradicional (Taiwán) | `zh-tw` |
Las traducciones predeterminadas pueden sobrescribirse creando un archivo personalizado en `i18n/[code].yaml` que contenga las cadenas de traducción. También puedes usar este método para agregar nuevos idiomas. Si deseas compartir una nueva traducción con la comunidad, por favor [abre una pull request](https://github.com/nunocoracao/blowfish/pulls).
### Configuración
Para ser lo más flexible posible, se debe crear un archivo de configuración de idioma para cada idioma en el sitio web. Por defecto, Blowfish incluye una configuración de idioma en inglés en `config/_default/languages.en.toml`.
El archivo predeterminado puede usarse como plantilla para crear idiomas adicionales, o renombrarse si deseas escribir tu sitio web en un idioma diferente al inglés. Simplemente nombra el archivo usando el formato `languages.[language-code].toml`.
{{< alert >}}
**Nota:** Asegúrate de que el parámetro `defaultContentLanguage` en la [configuración del sitio](#configuración-del-sitio) coincida con el código de idioma en el nombre del archivo de configuración de idioma.
{{< /alert >}}
Para información detallada sobre todos los parámetros de configuración disponibles, consulta la documentación en inglés ya que los nombres de parámetros son técnicos y permanecen en su forma original.
## Parámetros del tema
Blowfish proporciona un gran número de parámetros de configuración que controlan cómo funciona el tema. La lista completa de todos los parámetros disponibles se encuentra en el archivo `config/_default/params.toml`.
Muchos de los valores predeterminados de artículos pueden sobrescribirse por artículo especificándolos en el front matter. Consulta la sección [Front Matter]({{< ref "front-matter" >}}) para más detalles.
## Otros archivos de configuración
El tema también incluye un archivo de configuración `markup.toml`. Este archivo contiene algunos parámetros importantes que aseguran que Hugo esté correctamente configurado para generar sitios construidos con Blowfish.
Siempre asegúrate de que este archivo esté presente en el directorio de configuración y que los valores requeridos estén establecidos. No hacerlo puede causar que ciertas características funcionen incorrectamente y podría resultar en comportamiento no deseado.

View File

@@ -0,0 +1,125 @@
---
title: "Configuration"
weight: 4
draft: false
description: "Toutes les variables de configuration disponibles dans Blowfish."
slug: "configuration"
tags: ["configuration", "documentation"]
series: ["Documentation"]
series_order: 4
---
Blowfish est un thème hautement personnalisable et utilise certaines des dernières fonctionnalités de Hugo pour simplifier sa configuration.
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 >}}
> 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.
La configuration par défaut du thème est documentée dans chaque fichier afin que vous puissiez librement ajuster les paramètres selon vos besoins.
{{< alert >}}
Comme indiqué dans les [instructions d'installation]({{< ref "/docs/installation#set-up-theme-configuration-files" >}}), vous devez ajuster la configuration de votre thème en modifiant les fichiers dans le dossier `config/_default/` de votre projet Hugo et supprimer le fichier `hugo.toml` à la racine de votre projet.
{{< /alert >}}
## Configuration du site
Les variables de configuration Hugo standard sont respectées dans tout le thème, cependant il y a certaines choses spécifiques qui doivent être configurées pour une meilleure expérience.
La configuration du site est gérée via le fichier `config/_default/hugo.toml`. Le tableau ci-dessous présente tous les paramètres que Blowfish utilise.
Notez que les noms de variables fournis dans ce tableau utilisent la notation pointée pour simplifier la structure de données TOML (c'est-à-dire que `outputs.home` fait référence à `[outputs] home`).
<!-- prettier-ignore-start -->
| Nom | Défaut | Description |
| --- | --- | --- |
| `theme` | `"blowfish"` | Lors de l'utilisation des modules Hugo, cette valeur de configuration doit être supprimée. Pour tous les autres types d'installation, cela doit être défini sur `blowfish` pour que le thème fonctionne. |
| `baseURL` | _Non défini_ | L'URL vers la racine du site web. |
| `defaultContentLanguage` | `"en"` | Cette valeur détermine la langue par défaut des composants du thème et du contenu. Consultez la section [langue et i18n](#langue-et-i18n) ci-dessous pour les codes de langue pris en charge. |
| `enableRobotsTXT` | `true` | Lorsqu'il est activé, un fichier `robots.txt` sera créé à la racine du site permettant aux moteurs de recherche d'explorer l'ensemble du site. Si vous préférez fournir votre propre `robots.txt` préfabriqué, définissez sur `false` et placez votre fichier dans le répertoire `static`. Pour un contrôle complet, vous pouvez fournir une [mise en page personnalisée]({{< ref "content-examples#custom-layouts" >}}) pour générer ce fichier. |
| `pagination.pagerSize` | `10` | Le nombre d'articles listés sur chaque page de la liste d'articles. |
| `summaryLength` | `0` | Le nombre de mots utilisés pour générer le résumé de l'article lorsqu'aucun n'est fourni dans le [front matter]({{< ref "front-matter" >}}). Une valeur de `0` utilisera la première phrase. Cette valeur n'a aucun effet lorsque les résumés sont masqués. |
| `outputs.home` | `["HTML", "RSS", "JSON"]` | Les formats de sortie générés pour le site. Blowfish nécessite HTML, RSS et JSON pour que tous les composants du thème fonctionnent correctement. |
| `permalinks` | _Non défini_ | Consultez la [documentation Hugo](https://gohugo.io/configuration/permalinks/) pour la configuration des permaliens. |
| `taxonomies` | _Non défini_ | Consultez la section [Organisation du contenu]({{< ref "getting-started#organising-content" >}}) pour la configuration des taxonomies. |
<!-- prettier-ignore-end -->
## Vignettes
Blowfish a été conçu pour qu'il soit facile d'ajouter un support visuel à vos articles. Si vous êtes familier avec la structure des articles Hugo, il vous suffit de placer un fichier image (presque tous les formats sont pris en charge mais nous recommandons `.png` ou `.jpg`) qui commence par `feature*` dans votre dossier d'article. Et c'est tout, Blowfish pourra alors utiliser l'image à la fois comme vignette sur votre site et pour les cartes <a target="_blank" href="https://oembed.com/">oEmbed</a> sur les plateformes sociales.
[Voici]({{< ref "thumbnails" >}}) également un guide avec plus d'informations et un [exemple]({{< ref "thumbnail_sample" >}}) si vous voulez voir comment faire.
## Langue et i18n
Blowfish est optimisé pour les sites web entièrement multilingues et les ressources du thème sont traduites dans plusieurs langues par défaut. La configuration de la langue vous permet de générer plusieurs versions de votre contenu pour offrir une expérience personnalisée à vos visiteurs dans leur langue maternelle.
Le thème prend actuellement en charge les langues suivantes par défaut :
| Langue | Code |
| --- | --- |
| Arabe | `ar` |
| Bulgare | `bg` |
| Bengali | `bn` |
| Catalan | `ca` |
| Tchèque | `cs` |
| Allemand | `de` |
| Anglais | `en` |
| Espéranto | `eo` |
| Espagnol (Espagne) | `es` |
| Finnois | `fi` |
| Français | `fr` |
| Galicien | `gl` |
| Hébreu | `he` |
| Croate | `hr` |
| Hongrois | `hu` |
| Indonésien | `id` |
| Italien | `it` |
| Japonais | `ja` |
| Coréen | `ko` |
| Néerlandais | `nl` |
| Persan | `fa` |
| Polonais | `pl` |
| Portugais (Brésil) | `pt-br` |
| Portugais (Portugal) | `pt-pt` |
| Roumain | `ro` |
| Russe | `ru` |
| Thaï | `th` |
| Turc | `tr` |
| Vietnamien | `vi` |
| Chinois simplifié (Chine) | `zh-cn` |
| Chinois traditionnel (Taïwan) | `zh-tw` |
Les traductions par défaut peuvent être remplacées en créant un fichier personnalisé dans `i18n/[code].yaml` contenant les chaînes de traduction. Vous pouvez également utiliser cette méthode pour ajouter de nouvelles langues. Si vous souhaitez partager une nouvelle traduction avec la communauté, veuillez [ouvrir une pull request](https://github.com/nunocoracao/blowfish/pulls).
### Configuration
Afin d'être aussi flexible que possible, un fichier de configuration de langue doit être créé pour chaque langue du site. Par défaut, Blowfish inclut une configuration de langue anglaise dans `config/_default/languages.en.toml`.
Le fichier par défaut peut être utilisé comme modèle pour créer des langues supplémentaires, ou renommé si vous souhaitez rédiger votre site dans une langue autre que l'anglais. Nommez simplement le fichier en utilisant le format `languages.[language-code].toml`.
{{< alert >}}
**Note :** Assurez-vous que le paramètre `defaultContentLanguage` dans la [configuration du site](#configuration-du-site) correspond au code de langue dans le nom de fichier de configuration de langue.
{{< /alert >}}
Pour des informations détaillées sur tous les paramètres de configuration disponibles, consultez la documentation en anglais car les noms de paramètres sont techniques et restent dans leur forme originale.
## Paramètres du thème
Blowfish fournit un grand nombre de paramètres de configuration qui contrôlent le fonctionnement du thème. La liste complète de tous les paramètres disponibles se trouve dans le fichier `config/_default/params.toml`.
De nombreuses valeurs par défaut des articles peuvent être remplacées article par article en les spécifiant dans le front matter. Consultez la section [Front Matter]({{< ref "front-matter" >}}) pour plus de détails.
## Autres fichiers de configuration
Le thème inclut également un fichier de configuration `markup.toml`. Ce fichier contient des paramètres importants qui garantissent que Hugo est correctement configuré pour générer des sites construits avec Blowfish.
Assurez-vous toujours que ce fichier est présent dans le répertoire de configuration et que les valeurs requises sont définies. Ne pas le faire peut entraîner un fonctionnement incorrect de certaines fonctionnalités et un comportement inattendu.

View File

@@ -0,0 +1,125 @@
---
title: "Configuração"
weight: 4
draft: false
description: "Todas as variáveis de configuração disponíveis no Blowfish."
slug: "configuration"
tags: ["configuração", "documentação"]
series: ["Documentação"]
series_order: 4
---
O Blowfish é um tema altamente personalizável e usa alguns dos recursos mais recentes do Hugo para simplificar sua configuração.
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 >}}
> 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.
A configuração padrão do tema está documentada em cada arquivo para que você possa ajustar livremente as configurações de acordo com suas necessidades.
{{< alert >}}
Conforme descrito nas [instruções de instalação]({{< ref "/docs/installation#set-up-theme-configuration-files" >}}), você deve ajustar a configuração do seu tema modificando os arquivos na pasta `config/_default/` do seu projeto Hugo e excluir o arquivo `hugo.toml` na raiz do seu projeto.
{{< /alert >}}
## Configuração do site
As variáveis de configuração padrão do Hugo são respeitadas em todo o tema, no entanto, há algumas coisas específicas que devem ser configuradas para a melhor experiência.
A configuração do site é gerenciada através do arquivo `config/_default/hugo.toml`. A tabela abaixo descreve todas as configurações que o Blowfish aproveita.
Observe que os nomes de variáveis fornecidos nesta tabela usam notação de ponto para simplificar a estrutura de dados TOML (ou seja, `outputs.home` refere-se a `[outputs] home`).
<!-- prettier-ignore-start -->
| Nome | Padrão | Descrição |
| --- | --- | --- |
| `theme` | `"blowfish"` | Ao usar Módulos Hugo, este valor de configuração deve ser removido. Para todos os outros tipos de instalação, isso deve ser definido como `blowfish` para que o tema funcione. |
| `baseURL` | _Não definido_ | A URL para a raiz do site. |
| `defaultContentLanguage` | `"en"` | Este valor determina o idioma padrão dos componentes do tema e do conteúdo. Consulte a seção [idioma e i18n](#idioma-e-i18n) abaixo para códigos de idioma suportados. |
| `enableRobotsTXT` | `true` | Quando habilitado, um arquivo `robots.txt` será criado na raiz do site que permite que os mecanismos de busca rastreiem todo o site. Se você preferir fornecer seu próprio `robots.txt` pré-fabricado, defina como `false` e coloque seu arquivo no diretório `static`. Para controle completo, você pode fornecer um [layout personalizado]({{< ref "content-examples#custom-layouts" >}}) para gerar este arquivo. |
| `pagination.pagerSize` | `10` | O número de artigos listados em cada página da lista de artigos. |
| `summaryLength` | `0` | O número de palavras usadas para gerar o resumo do artigo quando não é fornecido no [front matter]({{< ref "front-matter" >}}). Um valor de `0` usará a primeira frase. Este valor não tem efeito quando os resumos estão ocultos. |
| `outputs.home` | `["HTML", "RSS", "JSON"]` | Os formatos de saída gerados para o site. O Blowfish requer HTML, RSS e JSON para que todos os componentes do tema funcionem corretamente. |
| `permalinks` | _Não definido_ | Consulte a [documentação do Hugo](https://gohugo.io/configuration/permalinks/) para configuração de permalinks. |
| `taxonomies` | _Não definido_ | Consulte a seção [Organizando conteúdo]({{< ref "getting-started#organising-content" >}}) para configuração de taxonomias. |
<!-- prettier-ignore-end -->
## Miniaturas
O Blowfish foi construído para facilitar a adição de suporte visual aos seus artigos. Se você está familiarizado com a estrutura de artigos do Hugo, basta colocar um arquivo de imagem (quase todos os formatos são suportados, mas recomendamos `.png` ou `.jpg`) que comece com `feature*` dentro da pasta do seu artigo. E é isso, o Blowfish poderá usar a imagem tanto como miniatura dentro do seu site quanto para cartões <a target="_blank" href="https://oembed.com/">oEmbed</a> em plataformas sociais.
[Aqui]({{< ref "thumbnails" >}}) também há um guia com mais informações e um [exemplo]({{< ref "thumbnail_sample" >}}) se você quiser ver como fazer.
## Idioma e i18n
O Blowfish é otimizado para sites totalmente multilíngues e os recursos do tema são traduzidos para vários idiomas por padrão. A configuração de idioma permite gerar múltiplas versões do seu conteúdo para fornecer uma experiência personalizada aos seus visitantes em seu idioma nativo.
O tema atualmente suporta os seguintes idiomas por padrão:
| Idioma | Código |
| --- | --- |
| Árabe | `ar` |
| Búlgaro | `bg` |
| Bengali | `bn` |
| Catalão | `ca` |
| Tcheco | `cs` |
| Alemão | `de` |
| Inglês | `en` |
| Esperanto | `eo` |
| Espanhol (Espanha) | `es` |
| Finlandês | `fi` |
| Francês | `fr` |
| Galego | `gl` |
| Hebraico | `he` |
| Croata | `hr` |
| Húngaro | `hu` |
| Indonésio | `id` |
| Italiano | `it` |
| Japonês | `ja` |
| Coreano | `ko` |
| Holandês | `nl` |
| Persa | `fa` |
| Polonês | `pl` |
| Português (Brasil) | `pt-br` |
| Português (Portugal) | `pt-pt` |
| Romeno | `ro` |
| Russo | `ru` |
| Tailandês | `th` |
| Turco | `tr` |
| Vietnamita | `vi` |
| Chinês simplificado (China) | `zh-cn` |
| Chinês tradicional (Taiwan) | `zh-tw` |
As traduções padrão podem ser substituídas criando um arquivo personalizado em `i18n/[code].yaml` contendo as strings de tradução. Você também pode usar este método para adicionar novos idiomas. Se quiser compartilhar uma nova tradução com a comunidade, por favor [abra um pull request](https://github.com/nunocoracao/blowfish/pulls).
### Configuração
Para ser o mais flexível possível, um arquivo de configuração de idioma precisa ser criado para cada idioma no site. Por padrão, o Blowfish inclui uma configuração de idioma em inglês em `config/_default/languages.en.toml`.
O arquivo padrão pode ser usado como modelo para criar idiomas adicionais, ou renomeado se você deseja escrever seu site em um idioma diferente do inglês. Simplesmente nomeie o arquivo usando o formato `languages.[language-code].toml`.
{{< alert >}}
**Nota:** Certifique-se de que o parâmetro `defaultContentLanguage` na [configuração do site](#configuração-do-site) corresponda ao código de idioma no nome do arquivo de configuração de idioma.
{{< /alert >}}
Para informações detalhadas sobre todos os parâmetros de configuração disponíveis, consulte a documentação em inglês, pois os nomes dos parâmetros são técnicos e permanecem em sua forma original.
## Parâmetros do tema
O Blowfish fornece um grande número de parâmetros de configuração que controlam como o tema funciona. A lista completa de todos os parâmetros disponíveis está no arquivo `config/_default/params.toml`.
Muitos dos padrões de artigos podem ser substituídos por artigo, especificando-os no front matter. Consulte a seção [Front Matter]({{< ref "front-matter" >}}) para mais detalhes.
## Outros arquivos de configuração
O tema também inclui um arquivo de configuração `markup.toml`. Este arquivo contém alguns parâmetros importantes que garantem que o Hugo esteja corretamente configurado para gerar sites construídos com o Blowfish.
Sempre certifique-se de que este arquivo esteja presente no diretório de configuração e que os valores necessários estejam definidos. Não fazer isso pode fazer com que certos recursos funcionem incorretamente e pode resultar em comportamento não intencional.

View File

@@ -0,0 +1,125 @@
---
title: "Configuração"
weight: 4
draft: false
description: "Todas as variáveis de configuração disponíveis no Blowfish."
slug: "configuration"
tags: ["configuração", "documentação"]
series: ["Documentação"]
series_order: 4
---
O Blowfish é um tema altamente personalizável e utiliza algumas das funcionalidades mais recentes do Hugo para simplificar a sua configuração.
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 >}}
> 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.
A configuração predefinida do tema está documentada em cada ficheiro para que possa ajustar livremente as definições de acordo com as suas necessidades.
{{< alert >}}
Conforme descrito nas [instruções de instalação]({{< ref "/docs/installation#set-up-theme-configuration-files" >}}), deve ajustar a configuração do seu tema modificando os ficheiros na pasta `config/_default/` do seu projeto Hugo e eliminar o ficheiro `hugo.toml` na raiz do seu projeto.
{{< /alert >}}
## Configuração do site
As variáveis de configuração padrão do Hugo são respeitadas em todo o tema, no entanto, há algumas coisas específicas que devem ser configuradas para a melhor experiência.
A configuração do site é gerida através do ficheiro `config/_default/hugo.toml`. A tabela abaixo descreve todas as definições que o Blowfish aproveita.
Note que os nomes de variáveis fornecidos nesta tabela utilizam notação de ponto para simplificar a estrutura de dados TOML (ou seja, `outputs.home` refere-se a `[outputs] home`).
<!-- prettier-ignore-start -->
| Nome | Predefinição | Descrição |
| --- | --- | --- |
| `theme` | `"blowfish"` | Ao utilizar Módulos Hugo, este valor de configuração deve ser removido. Para todos os outros tipos de instalação, isto deve ser definido como `blowfish` para que o tema funcione. |
| `baseURL` | _Não definido_ | O URL para a raiz do site. |
| `defaultContentLanguage` | `"en"` | Este valor determina o idioma predefinido dos componentes do tema e do conteúdo. Consulte a secção [idioma e i18n](#idioma-e-i18n) abaixo para códigos de idioma suportados. |
| `enableRobotsTXT` | `true` | Quando ativado, um ficheiro `robots.txt` será criado na raiz do site que permite que os motores de busca rastreiem todo o site. Se preferir fornecer o seu próprio `robots.txt` pré-fabricado, defina como `false` e coloque o seu ficheiro no diretório `static`. Para controlo completo, pode fornecer um [layout personalizado]({{< ref "content-examples#custom-layouts" >}}) para gerar este ficheiro. |
| `pagination.pagerSize` | `10` | O número de artigos listados em cada página da lista de artigos. |
| `summaryLength` | `0` | O número de palavras utilizadas para gerar o resumo do artigo quando não é fornecido no [front matter]({{< ref "front-matter" >}}). Um valor de `0` utilizará a primeira frase. Este valor não tem efeito quando os resumos estão ocultos. |
| `outputs.home` | `["HTML", "RSS", "JSON"]` | Os formatos de saída gerados para o site. O Blowfish requer HTML, RSS e JSON para que todos os componentes do tema funcionem corretamente. |
| `permalinks` | _Não definido_ | Consulte a [documentação do Hugo](https://gohugo.io/configuration/permalinks/) para configuração de permalinks. |
| `taxonomies` | _Não definido_ | Consulte a secção [Organização do conteúdo]({{< ref "getting-started#organising-content" >}}) para configuração de taxonomias. |
<!-- prettier-ignore-end -->
## Miniaturas
O Blowfish foi construído para facilitar a adição de suporte visual aos seus artigos. Se está familiarizado com a estrutura de artigos do Hugo, basta colocar um ficheiro de imagem (quase todos os formatos são suportados, mas recomendamos `.png` ou `.jpg`) que comece com `feature*` dentro da pasta do seu artigo. E é isso, o Blowfish poderá utilizar a imagem tanto como miniatura dentro do seu site quanto para cartões <a target="_blank" href="https://oembed.com/">oEmbed</a> em plataformas sociais.
[Aqui]({{< ref "thumbnails" >}}) também há um guia com mais informações e um [exemplo]({{< ref "thumbnail_sample" >}}) se quiser ver como fazer.
## Idioma e i18n
O Blowfish está otimizado para sites totalmente multilingues e os recursos do tema são traduzidos para vários idiomas por predefinição. A configuração de idioma permite gerar múltiplas versões do seu conteúdo para fornecer uma experiência personalizada aos seus visitantes no seu idioma nativo.
O tema atualmente suporta os seguintes idiomas por predefinição:
| Idioma | Código |
| --- | --- |
| Árabe | `ar` |
| Búlgaro | `bg` |
| Bengali | `bn` |
| Catalão | `ca` |
| Checo | `cs` |
| Alemão | `de` |
| Inglês | `en` |
| Esperanto | `eo` |
| Espanhol (Espanha) | `es` |
| Finlandês | `fi` |
| Francês | `fr` |
| Galego | `gl` |
| Hebraico | `he` |
| Croata | `hr` |
| Húngaro | `hu` |
| Indonésio | `id` |
| Italiano | `it` |
| Japonês | `ja` |
| Coreano | `ko` |
| Holandês | `nl` |
| Persa | `fa` |
| Polaco | `pl` |
| Português (Brasil) | `pt-br` |
| Português (Portugal) | `pt-pt` |
| Romeno | `ro` |
| Russo | `ru` |
| Tailandês | `th` |
| Turco | `tr` |
| Vietnamita | `vi` |
| Chinês simplificado (China) | `zh-cn` |
| Chinês tradicional (Taiwan) | `zh-tw` |
As traduções predefinidas podem ser substituídas criando um ficheiro personalizado em `i18n/[code].yaml` contendo as strings de tradução. Também pode utilizar este método para adicionar novos idiomas. Se quiser partilhar uma nova tradução com a comunidade, por favor [abra um pull request](https://github.com/nunocoracao/blowfish/pulls).
### Configuração
Para ser o mais flexível possível, um ficheiro de configuração de idioma precisa de ser criado para cada idioma no site. Por predefinição, o Blowfish inclui uma configuração de idioma em inglês em `config/_default/languages.en.toml`.
O ficheiro predefinido pode ser utilizado como modelo para criar idiomas adicionais, ou renomeado se deseja escrever o seu site num idioma diferente do inglês. Simplesmente nomeie o ficheiro utilizando o formato `languages.[language-code].toml`.
{{< alert >}}
**Nota:** Certifique-se de que o parâmetro `defaultContentLanguage` na [configuração do site](#configuração-do-site) corresponda ao código de idioma no nome do ficheiro de configuração de idioma.
{{< /alert >}}
Para informações detalhadas sobre todos os parâmetros de configuração disponíveis, consulte a documentação em inglês, pois os nomes dos parâmetros são técnicos e permanecem na sua forma original.
## Parâmetros do tema
O Blowfish fornece um grande número de parâmetros de configuração que controlam como o tema funciona. A lista completa de todos os parâmetros disponíveis está no ficheiro `config/_default/params.toml`.
Muitas das predefinições de artigos podem ser substituídas por artigo, especificando-as no front matter. Consulte a secção [Front Matter]({{< ref "front-matter" >}}) para mais detalhes.
## Outros ficheiros de configuração
O tema também inclui um ficheiro de configuração `markup.toml`. Este ficheiro contém alguns parâmetros importantes que garantem que o Hugo está corretamente configurado para gerar sites construídos com o Blowfish.
Certifique-se sempre de que este ficheiro está presente no diretório de configuração e que os valores necessários estão definidos. Não fazer isso pode fazer com que certas funcionalidades funcionem incorretamente e pode resultar em comportamento não intencional.