mirror of
https://github.com/nunocoracao/blowfish.git
synced 2026-01-30 15:31:52 +00:00
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
@@ -0,0 +1,60 @@
|
||||
---
|
||||
title: "Front Matter"
|
||||
weight: 7
|
||||
draft: false
|
||||
description: "Alle in Blowfish verfügbaren Front-Matter-Variablen."
|
||||
slug: "front-matter"
|
||||
tags: ["front matter", "konfiguration", "dokumentation"]
|
||||
series: ["Dokumentation"]
|
||||
series_order: 7
|
||||
---
|
||||
|
||||
Zusätzlich zu den [Standard-Hugo-Front-Matter-Parametern](https://gohugo.io/content-management/front-matter/#front-matter-variables) fügt Blowfish eine Reihe zusätzlicher Optionen hinzu, um die Darstellung einzelner Artikel anzupassen. Alle verfügbaren Theme-Front-Matter-Parameter sind unten aufgelistet.
|
||||
|
||||
Die Standardwerte der Front-Matter-Parameter werden von der [Basiskonfiguration]({{< ref "configuration" >}}) des Themes geerbt, sodass Sie diese Parameter nur in Ihrem Front Matter angeben müssen, wenn Sie die Standardwerte überschreiben möchten.
|
||||
|
||||
<!-- prettier-ignore-start -->
|
||||
| Name | Standard | Beschreibung |
|
||||
| --- | --- | --- |
|
||||
| `title` | _Nicht gesetzt_ | Der Name des Artikels. |
|
||||
| `description` | _Nicht gesetzt_ | Die Textbeschreibung für den Artikel. Wird in den HTML-Metadaten verwendet. |
|
||||
| `externalUrl` | _Nicht gesetzt_ | Wenn dieser Artikel auf einer Drittanbieter-Website veröffentlicht wird, die URL zu diesem Artikel. Die Angabe einer URL verhindert die Generierung einer Inhaltsseite und alle Verweise auf diesen Artikel verlinken direkt zur Drittanbieter-Website. |
|
||||
| `editURL` | `article.editURL` | Wenn `showEdit` aktiv ist, die URL für den Bearbeitungslink. |
|
||||
| `editAppendPath` | `article.editAppendPath` | Wenn `showEdit` aktiv ist, ob der Pfad zum aktuellen Artikel an die unter `editURL` gesetzte URL angehängt werden soll. |
|
||||
| `groupByYear` | `list.groupByYear` | Ob Artikel auf Listenseiten nach Jahr gruppiert werden. |
|
||||
| `menu` | _Nicht gesetzt_ | Wenn ein Wert angegeben wird, erscheint ein Link zu diesem Artikel in den genannten Menüs. Gültige Werte sind `main` oder `footer`. |
|
||||
| `robots` | _Nicht gesetzt_ | String, der angibt, wie Robots diesen Artikel behandeln sollen. Wenn gesetzt, wird er im Seitenkopf ausgegeben. Siehe [Googles Dokumentation](https://developers.google.com/search/docs/advanced/robots/robots_meta_tag#directives) für gültige Werte. |
|
||||
| `sharingLinks` | `article.sharingLinks` | Welche Teilen-Links am Ende dieses Artikels angezeigt werden. Wenn nicht angegeben oder auf `false` gesetzt, werden keine Links angezeigt. |
|
||||
| `showAuthor` | `article.showAuthor` | Ob die Autorenbox für den Standardautor in der Artikelfußzeile angezeigt wird. |
|
||||
| `showAuthorBottom` | `article.showAuthorBottom` | Autorenboxen werden am unteren Rand jeder Seite statt oben angezeigt. |
|
||||
| `authors` | _Nicht gesetzt_ | Array von Werten für Autoren, überschreibt bei Angabe die `showAuthor`-Einstellungen für Seite oder Website. Wird für die Funktion mehrerer Autoren verwendet, siehe [diese Seite]({{< ref "multi-author" >}}) für Details zur Konfiguration. |
|
||||
| `showAuthorsBadges` | `article.showAuthorsBadges` | Ob die `authors`-Taxonomien im Artikel- oder Listen-Header angezeigt werden. Dies erfordert die Einrichtung von `multiple authors` und der `authors`-Taxonomie. Siehe [diese Seite]({{< ref "multi-author" >}}) für Details. |
|
||||
| `featureimage` | _Nicht gesetzt_ | Link zum Feature-Bild |
|
||||
| `featureimagecaption` | _Nicht gesetzt_ | Bildunterschrift für das Feature-Bild. Wird nur im heroStyle `big` angezeigt |
|
||||
| `showHero` | `article.showHero` | Ob das Thumbnail-Bild als Hero-Bild innerhalb der Artikelseite angezeigt wird. |
|
||||
| `heroStyle` | `article.heroStyle` | Stil zur Anzeige des Hero-Bildes, gültige Optionen sind: `basic`, `big`, `background`, `thumbAndBackground`. |
|
||||
| `imagePosition` | _Nicht gesetzt_ | Setzt die Position des Feature-Bildes mit dem `object-position`-Attribut. Gültige Werte sind wie in der [MDN-Dokumentation](https://developer.mozilla.org/en-US/docs/Web/CSS/object-position#try_it) angegeben. |
|
||||
| `showBreadcrumbs` | `article.showBreadcrumbs` oder `list.showBreadcrumbs` | Ob Breadcrumbs im Artikel- oder Listen-Header angezeigt werden. |
|
||||
| `showDate` | `article.showDate` | Ob das Artikeldatum angezeigt wird. Das Datum wird mit dem Parameter `date` gesetzt. |
|
||||
| `showDateUpdated` | `article.showDateUpdated` | Ob das Datum angezeigt wird, an dem der Artikel aktualisiert wurde. Das Datum wird mit dem Parameter `lastmod` gesetzt. |
|
||||
| `showEdit` | `article.showEdit` | Ob der Link zum Bearbeiten des Artikelinhalts angezeigt werden soll. |
|
||||
| `showHeadingAnchors` | `article.showHeadingAnchors` | Ob Überschriften-Anker-Links neben Überschriften in diesem Artikel angezeigt werden. |
|
||||
| `showPagination` | `article.showPagination` | Ob die Links zum nächsten/vorherigen Artikel in der Artikelfußzeile angezeigt werden. |
|
||||
| `invertPagination` | `article.invertPagination` | Ob die Richtung der Links zum nächsten/vorherigen Artikel umgekehrt werden soll. |
|
||||
| `showReadingTime` | `article.showReadingTime` | Ob die Artikel-Lesezeit angezeigt wird. |
|
||||
| `showTaxonomies` | `article.showTaxonomies` | Ob die mit diesem Artikel verbundenen Taxonomien angezeigt werden. |
|
||||
| `showTableOfContents` | `article.showTableOfContents` | Ob das Inhaltsverzeichnis bei diesem Artikel angezeigt wird. |
|
||||
| `showWordCount` | `article.showWordCount` | Ob die Artikel-Wortanzahl angezeigt wird. |
|
||||
| `showComments` | `article.showComments` | Ob das [Kommentar-Partial]({{< ref "partials#comments" >}}) nach der Artikelfußzeile eingefügt wird. |
|
||||
| `showSummary` | `list.showSummary` | Ob die Artikelzusammenfassung auf Listenseiten angezeigt werden soll. |
|
||||
| `showViews` | `article.showViews` | Ob Artikelaufrufe in Listen und Detailansicht angezeigt werden sollen. Dies erfordert eine Firebase-Integration. Siehe [diese Seite]({{< ref "firebase-views" >}}) für eine Anleitung zur Firebase-Integration. |
|
||||
| `showLikes` | `article.showLikes` | Ob Artikel-Likes in Listen und Detailansicht angezeigt werden sollen. Dies erfordert eine Firebase-Integration. Siehe [diese Seite]({{< ref "firebase-views" >}}) für eine Anleitung zur Firebase-Integration. |
|
||||
| `seriesOpened` | `article.seriesOpened` | Ob das Serien-Modul standardmäßig geöffnet angezeigt wird oder nicht. |
|
||||
| `series` | _Nicht gesetzt_ | Array von Serien, zu denen der Artikel gehört, wir empfehlen nur eine Serie pro Artikel. |
|
||||
| `series_order` | _Nicht gesetzt_ | Nummer des Artikels innerhalb der Serie. |
|
||||
| `summary` | Automatisch generiert mit `summaryLength` (siehe [Website-Konfiguration]({{< ref "configuration#site-configuration" >}})) | Wenn `showSummary` aktiviert ist, ist dies der Markdown-String, der als Zusammenfassung für diesen Artikel verwendet wird. |
|
||||
| `xml` | `true` außer wenn durch `sitemap.excludedKinds` ausgeschlossen | Ob dieser Artikel in der generierten `/sitemap.xml`-Datei enthalten ist. |
|
||||
| `excludeFromSearch` | `false` | Ob dieser Artikel von der Sitemap und dem Suchindex ausgeschlossen werden soll. Wenn `true`, erscheint die Seite nicht in `sitemap.xml` oder `index.json`. |
|
||||
| `layoutBackgroundBlur` | `true` | Lässt das Hintergrundbild im background heroStyle beim Scrollen verschwimmen |
|
||||
| `layoutBackgroundHeaderSpace` | `true` | Fügt Abstand zwischen Header und Body hinzu. |
|
||||
<!-- prettier-ignore-end -->
|
||||
@@ -0,0 +1,60 @@
|
||||
---
|
||||
title: "Front Matter"
|
||||
weight: 7
|
||||
draft: false
|
||||
description: "Todas las variables de front matter disponibles en Blowfish."
|
||||
slug: "front-matter"
|
||||
tags: ["front matter", "configuración", "documentación"]
|
||||
series: ["Documentación"]
|
||||
series_order: 7
|
||||
---
|
||||
|
||||
Además de los [parámetros de front matter predeterminados de Hugo](https://gohugo.io/content-management/front-matter/#front-matter-variables), Blowfish añade varias opciones adicionales para personalizar la presentación de artículos individuales. Todos los parámetros de front matter del tema disponibles se enumeran a continuación.
|
||||
|
||||
Los valores predeterminados de los parámetros de front matter se heredan de la [configuración base]({{< ref "configuration" >}}) del tema, por lo que solo necesitas especificar estos parámetros en tu front matter cuando quieras anular el valor predeterminado.
|
||||
|
||||
<!-- prettier-ignore-start -->
|
||||
| Nombre | Predeterminado | Descripción |
|
||||
| --- | --- | --- |
|
||||
| `title` | _No establecido_ | El nombre del artículo. |
|
||||
| `description` | _No establecido_ | La descripción de texto del artículo. Se utiliza en los metadatos HTML. |
|
||||
| `externalUrl` | _No establecido_ | Si este artículo está publicado en un sitio web de terceros, la URL a este artículo. Proporcionar una URL evitará que se genere una página de contenido y cualquier referencia a este artículo enlazará directamente al sitio web de terceros. |
|
||||
| `editURL` | `article.editURL` | Cuando `showEdit` está activo, la URL para el enlace de edición. |
|
||||
| `editAppendPath` | `article.editAppendPath` | Cuando `showEdit` está activo, si la ruta al artículo actual debe añadirse a la URL establecida en `editURL`. |
|
||||
| `groupByYear` | `list.groupByYear` | Si los artículos se agrupan por año en las páginas de lista. |
|
||||
| `menu` | _No establecido_ | Cuando se proporciona un valor, aparecerá un enlace a este artículo en los menús nombrados. Los valores válidos son `main` o `footer`. |
|
||||
| `robots` | _No establecido_ | Cadena que indica cómo los robots deben manejar este artículo. Si se establece, se mostrará en el encabezado de la página. Consulta la [documentación de Google](https://developers.google.com/search/docs/advanced/robots/robots_meta_tag#directives) para valores válidos. |
|
||||
| `sharingLinks` | `article.sharingLinks` | Qué enlaces de compartir mostrar al final de este artículo. Cuando no se proporciona o se establece en `false`, no se mostrarán enlaces. |
|
||||
| `showAuthor` | `article.showAuthor` | Si la caja del autor para el autor predeterminado se muestra en el pie de página del artículo. |
|
||||
| `showAuthorBottom` | `article.showAuthorBottom` | Las cajas de autor se muestran en la parte inferior de cada página en lugar de arriba. |
|
||||
| `authors` | _No establecido_ | Array de valores para autores, si se establece anula la configuración de `showAuthor` para la página o el sitio. Se usa en la función de múltiples autores, consulta [esta página]({{< ref "multi-author" >}}) para más detalles sobre cómo configurar esa función. |
|
||||
| `showAuthorsBadges` | `article.showAuthorsBadges` | Si las taxonomías de `authors` se muestran en el encabezado del artículo o lista. Esto requiere la configuración de `multiple authors` y la taxonomía `authors`. Consulta [esta página]({{< ref "multi-author" >}}) para más detalles. |
|
||||
| `featureimage` | _No establecido_ | Enlace para la imagen destacada |
|
||||
| `featureimagecaption` | _No establecido_ | Leyenda para la imagen destacada. Solo se muestra en heroStyle `big` |
|
||||
| `showHero` | `article.showHero` | Si la imagen en miniatura se mostrará como imagen hero dentro de la página del artículo. |
|
||||
| `heroStyle` | `article.heroStyle` | Estilo para mostrar la imagen hero, las opciones válidas son: `basic`, `big`, `background`, `thumbAndBackground`. |
|
||||
| `imagePosition` | _No establecido_ | Establece la posición de la imagen destacada usando el atributo `object-position`. Los valores válidos son los especificados en la [documentación MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/object-position#try_it). |
|
||||
| `showBreadcrumbs` | `article.showBreadcrumbs` o `list.showBreadcrumbs` | Si las migas de pan se muestran en el encabezado del artículo o lista. |
|
||||
| `showDate` | `article.showDate` | Si se muestra la fecha del artículo. La fecha se establece usando el parámetro `date`. |
|
||||
| `showDateUpdated` | `article.showDateUpdated` | Si se muestra la fecha en que se actualizó el artículo. La fecha se establece usando el parámetro `lastmod`. |
|
||||
| `showEdit` | `article.showEdit` | Si se debe mostrar el enlace para editar el contenido del artículo. |
|
||||
| `showHeadingAnchors` | `article.showHeadingAnchors` | Si los enlaces de anclaje de encabezados se muestran junto a los encabezados en este artículo. |
|
||||
| `showPagination` | `article.showPagination` | Si los enlaces al artículo siguiente/anterior se muestran en el pie de página del artículo. |
|
||||
| `invertPagination` | `article.invertPagination` | Si se debe invertir la dirección de los enlaces al artículo siguiente/anterior. |
|
||||
| `showReadingTime` | `article.showReadingTime` | Si se muestra el tiempo de lectura del artículo. |
|
||||
| `showTaxonomies` | `article.showTaxonomies` | Si se muestran las taxonomías relacionadas con este artículo. |
|
||||
| `showTableOfContents` | `article.showTableOfContents` | Si se muestra la tabla de contenidos en este artículo. |
|
||||
| `showWordCount` | `article.showWordCount` | Si se muestra el recuento de palabras del artículo. |
|
||||
| `showComments` | `article.showComments` | Si el [partial de comentarios]({{< ref "partials#comments" >}}) se incluye después del pie de página del artículo. |
|
||||
| `showSummary` | `list.showSummary` | Si el resumen del artículo debe mostrarse en las páginas de lista. |
|
||||
| `showViews` | `article.showViews` | Si las vistas del artículo deben mostrarse en listas y vista detallada. Esto requiere una integración con Firebase. Consulta [esta página]({{< ref "firebase-views" >}}) para una guía sobre cómo integrar Firebase. |
|
||||
| `showLikes` | `article.showLikes` | Si los likes del artículo deben mostrarse en listas y vista detallada. Esto requiere una integración con Firebase. Consulta [esta página]({{< ref "firebase-views" >}}) para una guía sobre cómo integrar Firebase. |
|
||||
| `seriesOpened` | `article.seriesOpened` | Si el módulo de serie se mostrará abierto por defecto o no. |
|
||||
| `series` | _No establecido_ | Array de series a las que pertenece el artículo, recomendamos usar solo una serie por artículo. |
|
||||
| `series_order` | _No establecido_ | Número del artículo dentro de la serie. |
|
||||
| `summary` | Generado automáticamente usando `summaryLength` (ver [configuración del sitio]({{< ref "configuration#site-configuration" >}})) | Cuando `showSummary` está habilitado, esta es la cadena Markdown que se usará como resumen para este artículo. |
|
||||
| `xml` | `true` a menos que sea excluido por `sitemap.excludedKinds` | Si este artículo se incluye en el archivo `/sitemap.xml` generado. |
|
||||
| `excludeFromSearch` | `false` | Si este artículo debe excluirse del sitemap y el índice de búsqueda. Cuando es `true`, la página no aparecerá en `sitemap.xml` ni `index.json`. |
|
||||
| `layoutBackgroundBlur` | `true` | Hace que la imagen de fondo en el heroStyle background se difumine con el desplazamiento |
|
||||
| `layoutBackgroundHeaderSpace` | `true` | Añade espacio entre el encabezado y el cuerpo. |
|
||||
<!-- prettier-ignore-end -->
|
||||
@@ -0,0 +1,60 @@
|
||||
---
|
||||
title: "Front Matter"
|
||||
weight: 7
|
||||
draft: false
|
||||
description: "Toutes les variables front matter disponibles dans Blowfish."
|
||||
slug: "front-matter"
|
||||
tags: ["front matter", "configuration", "documentation"]
|
||||
series: ["Documentation"]
|
||||
series_order: 7
|
||||
---
|
||||
|
||||
En plus des [paramètres front matter Hugo par défaut](https://gohugo.io/content-management/front-matter/#front-matter-variables), Blowfish ajoute un certain nombre d'options supplémentaires pour personnaliser la présentation des articles individuels. Tous les paramètres front matter du thème disponibles sont listés ci-dessous.
|
||||
|
||||
Les valeurs par défaut des paramètres front matter sont héritées de la [configuration de base]({{< ref "configuration" >}}) du thème, vous n'avez donc besoin de spécifier ces paramètres dans votre front matter que lorsque vous souhaitez remplacer la valeur par défaut.
|
||||
|
||||
<!-- prettier-ignore-start -->
|
||||
| Nom | Défaut | Description |
|
||||
| --- | --- | --- |
|
||||
| `title` | _Non défini_ | Le nom de l'article. |
|
||||
| `description` | _Non défini_ | La description textuelle de l'article. Elle est utilisée dans les métadonnées HTML. |
|
||||
| `externalUrl` | _Non défini_ | Si cet article est publié sur un site tiers, l'URL vers cet article. Fournir une URL empêchera la génération d'une page de contenu et toutes les références à cet article pointeront directement vers le site tiers. |
|
||||
| `editURL` | `article.editURL` | Lorsque `showEdit` est actif, l'URL du lien d'édition. |
|
||||
| `editAppendPath` | `article.editAppendPath` | Lorsque `showEdit` est actif, si le chemin vers l'article actuel doit être ajouté à l'URL définie dans `editURL`. |
|
||||
| `groupByYear` | `list.groupByYear` | Si les articles sont groupés par année sur les pages de liste. |
|
||||
| `menu` | _Non défini_ | Lorsqu'une valeur est fournie, un lien vers cet article apparaîtra dans les menus nommés. Les valeurs valides sont `main` ou `footer`. |
|
||||
| `robots` | _Non défini_ | Chaîne indiquant comment les robots doivent traiter cet article. Si défini, il sera affiché dans l'en-tête de la page. Consultez [la documentation Google](https://developers.google.com/search/docs/advanced/robots/robots_meta_tag#directives) pour les valeurs valides. |
|
||||
| `sharingLinks` | `article.sharingLinks` | Quels liens de partage afficher à la fin de cet article. Lorsque non fourni ou défini sur `false`, aucun lien ne sera affiché. |
|
||||
| `showAuthor` | `article.showAuthor` | Si la boîte auteur pour l'auteur par défaut est affichée dans le pied de page de l'article. |
|
||||
| `showAuthorBottom` | `article.showAuthorBottom` | Les boîtes auteur sont affichées en bas de chaque page au lieu du haut. |
|
||||
| `authors` | _Non défini_ | Tableau de valeurs pour les auteurs, si défini, il remplace les paramètres `showAuthor` pour la page ou le site. Utilisé pour la fonctionnalité de multiples auteurs, consultez [cette page]({{< ref "multi-author" >}}) pour plus de détails sur la configuration. |
|
||||
| `showAuthorsBadges` | `article.showAuthorsBadges` | Si les taxonomies `authors` sont affichées dans l'en-tête de l'article ou de la liste. Cela nécessite la configuration de `multiple authors` et de la taxonomie `authors`. Consultez [cette page]({{< ref "multi-author" >}}) pour plus de détails. |
|
||||
| `featureimage` | _Non défini_ | Lien pour l'image mise en avant |
|
||||
| `featureimagecaption` | _Non défini_ | Légende pour l'image mise en avant. Affichée uniquement dans le heroStyle `big` |
|
||||
| `showHero` | `article.showHero` | Si l'image vignette sera affichée comme image hero dans la page de l'article. |
|
||||
| `heroStyle` | `article.heroStyle` | Style d'affichage de l'image hero, les options valides sont : `basic`, `big`, `background`, `thumbAndBackground`. |
|
||||
| `imagePosition` | _Non défini_ | Définit la position de l'image mise en avant en utilisant l'attribut `object-position`. Les valeurs valides sont comme spécifié dans la [documentation MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/object-position#try_it). |
|
||||
| `showBreadcrumbs` | `article.showBreadcrumbs` ou `list.showBreadcrumbs` | Si les fils d'Ariane sont affichés dans l'en-tête de l'article ou de la liste. |
|
||||
| `showDate` | `article.showDate` | Si la date de l'article est affichée. La date est définie avec le paramètre `date`. |
|
||||
| `showDateUpdated` | `article.showDateUpdated` | Si la date de mise à jour de l'article est affichée. La date est définie avec le paramètre `lastmod`. |
|
||||
| `showEdit` | `article.showEdit` | Si le lien pour éditer le contenu de l'article doit être affiché. |
|
||||
| `showHeadingAnchors` | `article.showHeadingAnchors` | Si les liens d'ancrage des titres sont affichés à côté des titres dans cet article. |
|
||||
| `showPagination` | `article.showPagination` | Si les liens article suivant/précédent sont affichés dans le pied de page de l'article. |
|
||||
| `invertPagination` | `article.invertPagination` | Si la direction des liens article suivant/précédent doit être inversée. |
|
||||
| `showReadingTime` | `article.showReadingTime` | Si le temps de lecture de l'article est affiché. |
|
||||
| `showTaxonomies` | `article.showTaxonomies` | Si les taxonomies liées à cet article sont affichées. |
|
||||
| `showTableOfContents` | `article.showTableOfContents` | Si la table des matières est affichée sur cet article. |
|
||||
| `showWordCount` | `article.showWordCount` | Si le nombre de mots de l'article est affiché. |
|
||||
| `showComments` | `article.showComments` | Si le [partial commentaires]({{< ref "partials#comments" >}}) est inclus après le pied de page de l'article. |
|
||||
| `showSummary` | `list.showSummary` | Si le résumé de l'article doit être affiché sur les pages de liste. |
|
||||
| `showViews` | `article.showViews` | Si les vues de l'article doivent être affichées dans les listes et la vue détaillée. Cela nécessite une intégration Firebase. Consultez [cette page]({{< ref "firebase-views" >}}) pour un guide sur l'intégration de Firebase. |
|
||||
| `showLikes` | `article.showLikes` | Si les likes de l'article doivent être affichés dans les listes et la vue détaillée. Cela nécessite une intégration Firebase. Consultez [cette page]({{< ref "firebase-views" >}}) pour un guide sur l'intégration de Firebase. |
|
||||
| `seriesOpened` | `article.seriesOpened` | Si le module de série sera affiché ouvert par défaut ou non. |
|
||||
| `series` | _Non défini_ | Tableau des séries auxquelles l'article appartient, nous recommandons d'utiliser une seule série par article. |
|
||||
| `series_order` | _Non défini_ | Numéro de l'article dans la série. |
|
||||
| `summary` | Généré automatiquement avec `summaryLength` (voir [configuration du site]({{< ref "configuration#site-configuration" >}})) | Lorsque `showSummary` est activé, c'est la chaîne Markdown à utiliser comme résumé pour cet article. |
|
||||
| `xml` | `true` sauf exclusion par `sitemap.excludedKinds` | Si cet article est inclus dans le fichier `/sitemap.xml` généré. |
|
||||
| `excludeFromSearch` | `false` | Si cet article doit être exclu du sitemap et de l'index de recherche. Lorsque `true`, la page n'apparaîtra pas dans `sitemap.xml` ou `index.json`. |
|
||||
| `layoutBackgroundBlur` | `true` | Fait flouter l'image d'arrière-plan dans le heroStyle background avec le défilement |
|
||||
| `layoutBackgroundHeaderSpace` | `true` | Ajoute de l'espace entre l'en-tête et le corps. |
|
||||
<!-- prettier-ignore-end -->
|
||||
@@ -0,0 +1,60 @@
|
||||
---
|
||||
title: "Front Matter"
|
||||
weight: 7
|
||||
draft: false
|
||||
description: "Todas as variáveis de front matter disponíveis no Blowfish."
|
||||
slug: "front-matter"
|
||||
tags: ["front matter", "configuração", "documentação"]
|
||||
series: ["Documentação"]
|
||||
series_order: 7
|
||||
---
|
||||
|
||||
Além dos [parâmetros de front matter padrão do Hugo](https://gohugo.io/content-management/front-matter/#front-matter-variables), o Blowfish adiciona várias opções adicionais para personalizar a apresentação de artigos individuais. Todos os parâmetros de front matter do tema disponíveis estão listados abaixo.
|
||||
|
||||
Os valores padrão dos parâmetros de front matter são herdados da [configuração base]({{< ref "configuration" >}}) do tema, então você só precisa especificar esses parâmetros no seu front matter quando quiser substituir o padrão.
|
||||
|
||||
<!-- prettier-ignore-start -->
|
||||
| Nome | Padrão | Descrição |
|
||||
| --- | --- | --- |
|
||||
| `title` | _Não definido_ | O nome do artigo. |
|
||||
| `description` | _Não definido_ | A descrição de texto do artigo. É usada nos metadados HTML. |
|
||||
| `externalUrl` | _Não definido_ | Se este artigo está publicado em um site de terceiros, a URL para este artigo. Fornecer uma URL impedirá a geração de uma página de conteúdo e quaisquer referências a este artigo vincularão diretamente ao site de terceiros. |
|
||||
| `editURL` | `article.editURL` | Quando `showEdit` está ativo, a URL para o link de edição. |
|
||||
| `editAppendPath` | `article.editAppendPath` | Quando `showEdit` está ativo, se o caminho para o artigo atual deve ser anexado à URL definida em `editURL`. |
|
||||
| `groupByYear` | `list.groupByYear` | Se os artigos são agrupados por ano nas páginas de lista. |
|
||||
| `menu` | _Não definido_ | Quando um valor é fornecido, um link para este artigo aparecerá nos menus nomeados. Valores válidos são `main` ou `footer`. |
|
||||
| `robots` | _Não definido_ | String que indica como os robôs devem tratar este artigo. Se definido, será exibido no cabeçalho da página. Consulte a [documentação do Google](https://developers.google.com/search/docs/advanced/robots/robots_meta_tag#directives) para valores válidos. |
|
||||
| `sharingLinks` | `article.sharingLinks` | Quais links de compartilhamento exibir no final deste artigo. Quando não fornecido ou definido como `false`, nenhum link será exibido. |
|
||||
| `showAuthor` | `article.showAuthor` | Se a caixa do autor para o autor padrão é exibida no rodapé do artigo. |
|
||||
| `showAuthorBottom` | `article.showAuthorBottom` | As caixas de autor são exibidas na parte inferior de cada página em vez do topo. |
|
||||
| `authors` | _Não definido_ | Array de valores para autores, se definido substitui as configurações de `showAuthor` para a página ou site. Usado no recurso de múltiplos autores, consulte [esta página]({{< ref "multi-author" >}}) para mais detalhes sobre como configurar esse recurso. |
|
||||
| `showAuthorsBadges` | `article.showAuthorsBadges` | Se as taxonomias de `authors` são exibidas no cabeçalho do artigo ou lista. Isso requer a configuração de `multiple authors` e a taxonomia `authors`. Consulte [esta página]({{< ref "multi-author" >}}) para mais detalhes. |
|
||||
| `featureimage` | _Não definido_ | Link para a imagem de destaque |
|
||||
| `featureimagecaption` | _Não definido_ | Legenda para a imagem de destaque. Exibida apenas no heroStyle `big` |
|
||||
| `showHero` | `article.showHero` | Se a imagem em miniatura será mostrada como imagem hero dentro da página do artigo. |
|
||||
| `heroStyle` | `article.heroStyle` | Estilo para exibir a imagem hero, opções válidas são: `basic`, `big`, `background`, `thumbAndBackground`. |
|
||||
| `imagePosition` | _Não definido_ | Define a posição da imagem de destaque usando o atributo `object-position`. Valores válidos são como especificado na [documentação MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/object-position#try_it). |
|
||||
| `showBreadcrumbs` | `article.showBreadcrumbs` ou `list.showBreadcrumbs` | Se as migalhas de pão são exibidas no cabeçalho do artigo ou lista. |
|
||||
| `showDate` | `article.showDate` | Se a data do artigo é exibida. A data é definida usando o parâmetro `date`. |
|
||||
| `showDateUpdated` | `article.showDateUpdated` | Se a data em que o artigo foi atualizado é exibida. A data é definida usando o parâmetro `lastmod`. |
|
||||
| `showEdit` | `article.showEdit` | Se o link para editar o conteúdo do artigo deve ser exibido. |
|
||||
| `showHeadingAnchors` | `article.showHeadingAnchors` | Se os links de âncora de cabeçalho são exibidos ao lado dos cabeçalhos neste artigo. |
|
||||
| `showPagination` | `article.showPagination` | Se os links do artigo anterior/próximo são exibidos no rodapé do artigo. |
|
||||
| `invertPagination` | `article.invertPagination` | Se a direção dos links do artigo anterior/próximo deve ser invertida. |
|
||||
| `showReadingTime` | `article.showReadingTime` | Se o tempo de leitura do artigo é exibido. |
|
||||
| `showTaxonomies` | `article.showTaxonomies` | Se as taxonomias relacionadas a este artigo são exibidas. |
|
||||
| `showTableOfContents` | `article.showTableOfContents` | Se o índice é exibido neste artigo. |
|
||||
| `showWordCount` | `article.showWordCount` | Se a contagem de palavras do artigo é exibida. |
|
||||
| `showComments` | `article.showComments` | Se o [partial de comentários]({{< ref "partials#comments" >}}) é incluído após o rodapé do artigo. |
|
||||
| `showSummary` | `list.showSummary` | Se o resumo do artigo deve ser exibido nas páginas de lista. |
|
||||
| `showViews` | `article.showViews` | Se as visualizações do artigo devem ser exibidas em listas e visualização detalhada. Isso requer uma integração com Firebase. Consulte [esta página]({{< ref "firebase-views" >}}) para um guia sobre como integrar o Firebase. |
|
||||
| `showLikes` | `article.showLikes` | Se os likes do artigo devem ser exibidos em listas e visualização detalhada. Isso requer uma integração com Firebase. Consulte [esta página]({{< ref "firebase-views" >}}) para um guia sobre como integrar o Firebase. |
|
||||
| `seriesOpened` | `article.seriesOpened` | Se o módulo de série será exibido aberto por padrão ou não. |
|
||||
| `series` | _Não definido_ | Array de séries às quais o artigo pertence, recomendamos usar apenas uma série por artigo. |
|
||||
| `series_order` | _Não definido_ | Número do artigo dentro da série. |
|
||||
| `summary` | Gerado automaticamente usando `summaryLength` (veja [configuração do site]({{< ref "configuration#site-configuration" >}})) | Quando `showSummary` está habilitado, esta é a string Markdown a ser usada como resumo para este artigo. |
|
||||
| `xml` | `true` a menos que excluído por `sitemap.excludedKinds` | Se este artigo é incluído no arquivo `/sitemap.xml` gerado. |
|
||||
| `excludeFromSearch` | `false` | Se este artigo deve ser excluído do sitemap e índice de pesquisa. Quando `true`, a página não aparecerá em `sitemap.xml` ou `index.json`. |
|
||||
| `layoutBackgroundBlur` | `true` | Faz a imagem de fundo no heroStyle background desfocar com a rolagem |
|
||||
| `layoutBackgroundHeaderSpace` | `true` | Adiciona espaço entre o cabeçalho e o corpo. |
|
||||
<!-- prettier-ignore-end -->
|
||||
@@ -0,0 +1,60 @@
|
||||
---
|
||||
title: "Front Matter"
|
||||
weight: 7
|
||||
draft: false
|
||||
description: "Todas as variáveis de front matter disponíveis no Blowfish."
|
||||
slug: "front-matter"
|
||||
tags: ["front matter", "configuração", "documentação"]
|
||||
series: ["Documentação"]
|
||||
series_order: 7
|
||||
---
|
||||
|
||||
Além dos [parâmetros de front matter padrão do Hugo](https://gohugo.io/content-management/front-matter/#front-matter-variables), o Blowfish adiciona várias opções adicionais para personalizar a apresentação de artigos individuais. Todos os parâmetros de front matter do tema disponíveis estão listados abaixo.
|
||||
|
||||
Os valores predefinidos dos parâmetros de front matter são herdados da [configuração base]({{< ref "configuration" >}}) do tema, pelo que só precisa de especificar estes parâmetros no seu front matter quando quiser substituir a predefinição.
|
||||
|
||||
<!-- prettier-ignore-start -->
|
||||
| Nome | Predefinição | Descrição |
|
||||
| --- | --- | --- |
|
||||
| `title` | _Não definido_ | O nome do artigo. |
|
||||
| `description` | _Não definido_ | A descrição de texto do artigo. É utilizada nos metadados HTML. |
|
||||
| `externalUrl` | _Não definido_ | Se este artigo está publicado num site de terceiros, o URL para este artigo. Fornecer um URL impedirá a geração de uma página de conteúdo e quaisquer referências a este artigo vincularão diretamente ao site de terceiros. |
|
||||
| `editURL` | `article.editURL` | Quando `showEdit` está ativo, o URL para a ligação de edição. |
|
||||
| `editAppendPath` | `article.editAppendPath` | Quando `showEdit` está ativo, se o caminho para o artigo atual deve ser anexado ao URL definido em `editURL`. |
|
||||
| `groupByYear` | `list.groupByYear` | Se os artigos são agrupados por ano nas páginas de lista. |
|
||||
| `menu` | _Não definido_ | Quando um valor é fornecido, uma ligação para este artigo aparecerá nos menus nomeados. Valores válidos são `main` ou `footer`. |
|
||||
| `robots` | _Não definido_ | String que indica como os robôs devem tratar este artigo. Se definido, será apresentado no cabeçalho da página. Consulte a [documentação do Google](https://developers.google.com/search/docs/advanced/robots/robots_meta_tag#directives) para valores válidos. |
|
||||
| `sharingLinks` | `article.sharingLinks` | Quais ligações de partilha apresentar no final deste artigo. Quando não fornecido ou definido como `false`, nenhuma ligação será apresentada. |
|
||||
| `showAuthor` | `article.showAuthor` | Se a caixa do autor para o autor predefinido é apresentada no rodapé do artigo. |
|
||||
| `showAuthorBottom` | `article.showAuthorBottom` | As caixas de autor são apresentadas na parte inferior de cada página em vez do topo. |
|
||||
| `authors` | _Não definido_ | Array de valores para autores, se definido substitui as definições de `showAuthor` para a página ou site. Utilizado na funcionalidade de múltiplos autores, consulte [esta página]({{< ref "multi-author" >}}) para mais detalhes sobre como configurar essa funcionalidade. |
|
||||
| `showAuthorsBadges` | `article.showAuthorsBadges` | Se as taxonomias de `authors` são apresentadas no cabeçalho do artigo ou lista. Isto requer a configuração de `multiple authors` e a taxonomia `authors`. Consulte [esta página]({{< ref "multi-author" >}}) para mais detalhes. |
|
||||
| `featureimage` | _Não definido_ | Ligação para a imagem de destaque |
|
||||
| `featureimagecaption` | _Não definido_ | Legenda para a imagem de destaque. Apresentada apenas no heroStyle `big` |
|
||||
| `showHero` | `article.showHero` | Se a imagem em miniatura será mostrada como imagem hero dentro da página do artigo. |
|
||||
| `heroStyle` | `article.heroStyle` | Estilo para apresentar a imagem hero, opções válidas são: `basic`, `big`, `background`, `thumbAndBackground`. |
|
||||
| `imagePosition` | _Não definido_ | Define a posição da imagem de destaque utilizando o atributo `object-position`. Valores válidos são como especificado na [documentação MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/object-position#try_it). |
|
||||
| `showBreadcrumbs` | `article.showBreadcrumbs` ou `list.showBreadcrumbs` | Se as migalhas de pão são apresentadas no cabeçalho do artigo ou lista. |
|
||||
| `showDate` | `article.showDate` | Se a data do artigo é apresentada. A data é definida utilizando o parâmetro `date`. |
|
||||
| `showDateUpdated` | `article.showDateUpdated` | Se a data em que o artigo foi atualizado é apresentada. A data é definida utilizando o parâmetro `lastmod`. |
|
||||
| `showEdit` | `article.showEdit` | Se a ligação para editar o conteúdo do artigo deve ser apresentada. |
|
||||
| `showHeadingAnchors` | `article.showHeadingAnchors` | Se as ligações de âncora de cabeçalho são apresentadas junto aos cabeçalhos neste artigo. |
|
||||
| `showPagination` | `article.showPagination` | Se as ligações do artigo anterior/próximo são apresentadas no rodapé do artigo. |
|
||||
| `invertPagination` | `article.invertPagination` | Se a direção das ligações do artigo anterior/próximo deve ser invertida. |
|
||||
| `showReadingTime` | `article.showReadingTime` | Se o tempo de leitura do artigo é apresentado. |
|
||||
| `showTaxonomies` | `article.showTaxonomies` | Se as taxonomias relacionadas com este artigo são apresentadas. |
|
||||
| `showTableOfContents` | `article.showTableOfContents` | Se o índice é apresentado neste artigo. |
|
||||
| `showWordCount` | `article.showWordCount` | Se a contagem de palavras do artigo é apresentada. |
|
||||
| `showComments` | `article.showComments` | Se o [partial de comentários]({{< ref "partials#comments" >}}) é incluído após o rodapé do artigo. |
|
||||
| `showSummary` | `list.showSummary` | Se o resumo do artigo deve ser apresentado nas páginas de lista. |
|
||||
| `showViews` | `article.showViews` | Se as visualizações do artigo devem ser apresentadas em listas e visualização detalhada. Isto requer uma integração com Firebase. Consulte [esta página]({{< ref "firebase-views" >}}) para um guia sobre como integrar o Firebase. |
|
||||
| `showLikes` | `article.showLikes` | Se os gostos do artigo devem ser apresentados em listas e visualização detalhada. Isto requer uma integração com Firebase. Consulte [esta página]({{< ref "firebase-views" >}}) para um guia sobre como integrar o Firebase. |
|
||||
| `seriesOpened` | `article.seriesOpened` | Se o módulo de série será apresentado aberto por predefinição ou não. |
|
||||
| `series` | _Não definido_ | Array de séries às quais o artigo pertence, recomendamos utilizar apenas uma série por artigo. |
|
||||
| `series_order` | _Não definido_ | Número do artigo dentro da série. |
|
||||
| `summary` | Gerado automaticamente utilizando `summaryLength` (veja [configuração do site]({{< ref "configuration#site-configuration" >}})) | Quando `showSummary` está ativado, esta é a string Markdown a ser utilizada como resumo para este artigo. |
|
||||
| `xml` | `true` a menos que excluído por `sitemap.excludedKinds` | Se este artigo é incluído no ficheiro `/sitemap.xml` gerado. |
|
||||
| `excludeFromSearch` | `false` | Se este artigo deve ser excluído do sitemap e índice de pesquisa. Quando `true`, a página não aparecerá em `sitemap.xml` ou `index.json`. |
|
||||
| `layoutBackgroundBlur` | `true` | Faz a imagem de fundo no heroStyle background desfocar com a rolagem |
|
||||
| `layoutBackgroundHeaderSpace` | `true` | Adiciona espaço entre o cabeçalho e o corpo. |
|
||||
<!-- prettier-ignore-end -->
|
||||
Reference in New Issue
Block a user