mirror of
https://github.com/nunocoracao/blowfish.git
synced 2026-01-30 16:31:52 +01: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
147
exampleSite/content/docs/partials/index.de.md
Normal file
147
exampleSite/content/docs/partials/index.de.md
Normal file
@@ -0,0 +1,147 @@
|
||||
---
|
||||
title: "Partials"
|
||||
weight: 9
|
||||
draft: false
|
||||
description: "Alle verfügbaren Partials in Blowfish."
|
||||
slug: "partials"
|
||||
tags: ["partials", "analytics", "datenschutz", "kommentare", "favicons", "icon", "dokumentation"]
|
||||
series: ["Dokumentation"]
|
||||
series_order: 9
|
||||
---
|
||||
|
||||
## Analytics
|
||||
|
||||
Blowfish bietet integrierte Unterstützung für Fathom Analytics, Google Analytics und Umami Analytics. Fathom ist eine kostenpflichtige Alternative zu Google Analytics, die die Privatsphäre der Benutzer respektiert.
|
||||
|
||||
### Fathom Analytics
|
||||
|
||||
Um die Fathom Analytics-Unterstützung zu aktivieren, geben Sie einfach Ihren Fathom-Site-Code in der Datei `config/_default/params.toml` an. Wenn Sie auch die benutzerdefinierte Domain-Funktion von Fathom verwenden und deren Skript von Ihrer Domain bereitstellen möchten, können Sie zusätzlich den Konfigurationswert `domain` angeben. Wenn Sie keinen `domain`-Wert angeben, wird das Skript direkt von Fathom DNS geladen.
|
||||
|
||||
```toml
|
||||
# config/_default/params.toml
|
||||
|
||||
[fathomAnalytics]
|
||||
site = "ABC12345"
|
||||
domain = "llama.yoursite.com"
|
||||
```
|
||||
|
||||
### Google Analytics
|
||||
|
||||
Die Google Analytics-Unterstützung wird über das interne Hugo-Partial bereitgestellt. Geben Sie einfach den `googleAnalytics`-Schlüssel in der Datei `config/_default/hugo.toml` an und das Skript wird automatisch hinzugefügt.
|
||||
|
||||
Sowohl Version 3 (analytics.js) als auch Version 4 (gtag.js) werden unterstützt, basierend auf dem angegebenen Konfigurationswert:
|
||||
|
||||
```toml
|
||||
# config/_default/hugo.toml
|
||||
|
||||
# Version 3
|
||||
googleAnalytics = "UA-PROPERTY_ID"
|
||||
# Version 4
|
||||
googleAnalytics = "G-MEASUREMENT_ID"
|
||||
```
|
||||
|
||||
### Umami Analytics
|
||||
|
||||
Um die Umami Analytics-Unterstützung zu aktivieren, geben Sie einfach Ihren [Umami-Tracking-Code](https://umami.is/docs/collect-data) in der Datei `config/_default/params.toml` an.
|
||||
Wenn Sie auch die benutzerdefinierte Domain-Funktion von Umami verwenden und deren Skript von Ihrer Domain bereitstellen möchten, können Sie zusätzlich den Konfigurationswert `domain` angeben. Wenn Sie keinen `domain`-Wert angeben, wird das Skript direkt von Umami DNS (analytics.umami.is) geladen.
|
||||
Wenn Sie möchten, dass der Tracker nur auf bestimmten Domains ausgeführt wird, können Sie den Konfigurationswert `dataDomains` angeben. Wenn Sie keinen `dataDomains`-Wert angeben, wird das Skript auf jeder Website ausgeführt, bei der `domain` und `websiteid` übereinstimmen. Wenn die Umgebungsvariable `TRACKER_SCRIPT_NAME` konfiguriert ist, können Sie einen benutzerdefinierten Skriptnamen `scriptName` angeben. Wenn sie nicht konfiguriert ist, kommentieren Sie sie entweder aus oder verwenden Sie den Standard `script.js`.
|
||||
|
||||
{{< alert >}}
|
||||
**Hinweis:** Wenn Sie Umami Analytics aktivieren, unterstützt Blowfish [Umami Track Event](https://umami.is/docs/track-events) automatisch. Wenn Sie Track Event nicht unterstützen möchten, muss der Parameter `enableTrackEvent` auf `false` gesetzt werden.
|
||||
{{< /alert >}}
|
||||
|
||||
```toml
|
||||
# config/_default/params.toml
|
||||
|
||||
[umamiAnalytics]
|
||||
websiteid = "ABC12345"
|
||||
domain = "llama.yoursite.com"
|
||||
dataDomains = "yoursite.com,yoursite2.com"
|
||||
scriptName = "TRACKER_SCRIPT_NAME"
|
||||
enableTrackEvent = true
|
||||
```
|
||||
|
||||
### Seline Analytics
|
||||
|
||||
Um die Seline Analytics-Unterstützung zu aktivieren, geben Sie einfach Ihren [Seline-Token](https://seline.so/docs/install-seline) in der Datei `config/_default/params.toml` an.
|
||||
|
||||
{{< alert >}}
|
||||
**Hinweis:** Wenn Sie Seline Analytics aktivieren, unterstützt Blowfish [Seline Track Event](https://seline.so/docs/custom-events) automatisch. Wenn Sie Track Event nicht unterstützen möchten, muss der Parameter `enableTrackEvent` auf `false` gesetzt werden.
|
||||
{{< /alert >}}
|
||||
|
||||
```toml
|
||||
# config/_default/params.toml
|
||||
|
||||
[selineAnalytics]
|
||||
token = "XXXXXX"
|
||||
enableTrackEvent = true
|
||||
```
|
||||
|
||||
### Benutzerdefinierte Analytics-Anbieter
|
||||
|
||||
Wenn Sie einen anderen Analytics-Anbieter auf Ihrer Website verwenden möchten, können Sie auch das Analytics-Partial überschreiben und Ihr eigenes Skript bereitstellen. Erstellen Sie einfach die Datei `layouts/partials/extend-head.html` in Ihrem Projekt und sie wird automatisch in den `<head>` der Website eingefügt.
|
||||
|
||||
## Kommentare
|
||||
|
||||
Um Kommentare zu Ihren Artikeln hinzuzufügen, enthält Blowfish Unterstützung für ein Kommentar-Partial, das am Ende jeder Artikelseite eingefügt wird. Stellen Sie einfach eine `layouts/partials/comments.html` bereit, die den Code enthält, der zum Anzeigen Ihrer gewählten Kommentare erforderlich ist.
|
||||
|
||||
Sie können entweder die integrierte Hugo Disqus-Vorlage verwenden oder Ihren eigenen benutzerdefinierten Code bereitstellen. Weitere Informationen finden Sie in der [Hugo-Dokumentation](https://gohugo.io/content-management/comments/).
|
||||
|
||||
Sobald das Partial bereitgestellt wurde, wird die feinere Kontrolle darüber, wo Kommentare angezeigt werden, über den Parameter `showComments` verwaltet. Dieser Wert kann auf Theme-Ebene in der `params.toml` [Konfigurationsdatei]({{< ref "configuration#theme-parameters" >}}) oder pro Artikel durch Einbeziehung in das [Front Matter]({{< ref "front-matter" >}}) festgelegt werden. Der Parameter ist standardmäßig `false`, daher muss er an einem dieser Orte auf `true` gesetzt werden, damit Kommentare angezeigt werden.
|
||||
|
||||
## Favicons
|
||||
|
||||
Blowfish stellt einen Standardsatz leerer Favicons zum Einstieg bereit, aber Sie können Ihre eigenen Assets bereitstellen, um sie zu überschreiben. Der einfachste Weg, neue Favicon-Assets zu erhalten, ist die Generierung über einen Drittanbieter wie [favicon.io](https://favicon.io).
|
||||
|
||||
Icon-Assets sollten direkt im `static/`-Ordner Ihrer Website platziert und wie in der folgenden Auflistung benannt werden. Wenn Sie [favicon.io](https://favicon.io) verwenden, werden dies die Dateinamen sein, die automatisch für Sie generiert werden, aber Sie können Ihre eigenen Assets bereitstellen, wenn Sie möchten.
|
||||
|
||||
```shell
|
||||
static/
|
||||
├─ android-chrome-192x192.png
|
||||
├─ android-chrome-512x512.png
|
||||
├─ apple-touch-icon.png
|
||||
├─ favicon-16x16.png
|
||||
├─ favicon-32x32.png
|
||||
├─ favicon.ico
|
||||
└─ site.webmanifest
|
||||
```
|
||||
|
||||
Alternativ können Sie auch das Standard-Favicon-Verhalten vollständig überschreiben und Ihre eigenen Favicon-HTML-Tags und Assets bereitstellen. Erstellen Sie einfach eine `layouts/partials/favicons.html`-Datei in Ihrem Projekt und diese wird anstelle der Standard-Assets in den `<head>` der Website eingefügt.
|
||||
|
||||
## Icon
|
||||
|
||||
Ähnlich wie beim [Icon-Shortcode]({{< ref "shortcodes#icon" >}}) können Sie Icons in Ihren eigenen Templates und Partials einbinden, indem Sie Blowfishs `icon.html`-Partial verwenden. Das Partial nimmt einen Parameter entgegen, der der Name des einzufügenden Icons ist.
|
||||
|
||||
**Beispiel:**
|
||||
|
||||
```go
|
||||
{{ partial "icon.html" "github" }}
|
||||
```
|
||||
|
||||
Icons werden mit Hugo-Pipelines gefüllt, was sie sehr flexibel macht. Blowfish enthält eine Reihe von integrierten Icons für soziale Netzwerke, Links und andere Zwecke. Auf der Seite [Icon-Beispiele]({{< ref "samples/icons" >}}) finden Sie eine vollständige Liste der unterstützten Icons.
|
||||
|
||||
Benutzerdefinierte Icons können hinzugefügt werden, indem Sie Ihre eigenen Icon-Assets im Verzeichnis `assets/icons/` Ihres Projekts bereitstellen. Das Icon kann dann im Partial mit dem SVG-Dateinamen ohne die Erweiterung `.svg` referenziert werden.
|
||||
|
||||
Icons können auch im Artikelinhalt verwendet werden, indem Sie den [Icon-Shortcode]({{< ref "shortcodes#icon" >}}) aufrufen.
|
||||
|
||||
## Erweiterungen
|
||||
|
||||
Blowfish bietet auch eine Reihe von Erweiterungs-Partials, die eine Erweiterung der Basisfunktionalität ermöglichen.
|
||||
|
||||
### Artikel-Link
|
||||
|
||||
Wenn Sie zusätzlichen Code nach Artikel-Links einfügen möchten, erstellen Sie eine `layouts/partials/extend-article-link.html`-Datei. Dies ist besonders leistungsstark in Kombination mit dem [`badge`]({{< ref "shortcodes#badge" >}})-Shortcode, der verwendet werden kann, um Metadaten für bestimmte Artikel hervorzuheben.
|
||||
|
||||
### Head und Footer
|
||||
|
||||
Das Theme ermöglicht das Einfügen von zusätzlichem Code direkt in die `<head>`- und `<footer>`-Abschnitte der Vorlage. Diese können nützlich sein, um Skripte oder andere Logik bereitzustellen, die nicht Teil des Themes ist.
|
||||
|
||||
Erstellen Sie einfach entweder `layouts/partials/extend-head.html` oder `layouts/partials/extend-footer.html` und diese werden automatisch in Ihren Website-Build eingefügt. Beide Partials werden als letzte Elemente in `<head>` und `<footer>` eingefügt, sodass sie verwendet werden können, um Theme-Standardeinstellungen zu überschreiben.
|
||||
|
||||
### Nicht-gecachte Head-Erweiterung
|
||||
|
||||
Das `extend-head.html` wird [gecacht](https://gohugo.io/functions/partials/includecached/), und Blowfish unterstützt auch eine nicht-gecachte Head-Erweiterung zum **bedingten** Einbinden von Skripten oder Metadaten basierend auf Seiteneigenschaften. Um diese Funktion zu nutzen, erstellen Sie eine `layouts/partials/extend-head-uncached.html`-Datei in Ihrem Projekt. Diese Datei wird im `<head>`-HTML-Tag eingefügt.
|
||||
|
||||
Dies ist nützlich, wenn Sie dynamische Elemente—wie Skripte oder Metadaten—basierend auf Eigenschaften wie Shortcodes, Front-Matter-Flags oder anderen seitenspezifischen Daten einbinden müssen, die nicht über Builds hinweg gecacht werden sollten.
|
||||
|
||||
Zum Beispiel können Sie zum dynamischen Laden einer CDN-JavaScript-Datei basierend auf dem Erscheinen eines Shortcodes die [HasShortcode](https://gohugo.io/methods/page/hasshortcode/#article)-Methode innerhalb von `extend-head-uncached.html` verwenden.
|
||||
147
exampleSite/content/docs/partials/index.es.md
Normal file
147
exampleSite/content/docs/partials/index.es.md
Normal file
@@ -0,0 +1,147 @@
|
||||
---
|
||||
title: "Partials"
|
||||
weight: 9
|
||||
draft: false
|
||||
description: "Todos los partials disponibles en Blowfish."
|
||||
slug: "partials"
|
||||
tags: ["partials", "analytics", "privacidad", "comentarios", "favicons", "icon", "documentación"]
|
||||
series: ["Documentación"]
|
||||
series_order: 9
|
||||
---
|
||||
|
||||
## Analytics
|
||||
|
||||
Blowfish proporciona soporte integrado para Fathom Analytics, Google Analytics y Umami Analytics. Fathom es una alternativa de pago a Google Analytics que respeta la privacidad del usuario.
|
||||
|
||||
### Fathom Analytics
|
||||
|
||||
Para habilitar el soporte de Fathom Analytics, simplemente proporciona tu código de sitio de Fathom en el archivo `config/_default/params.toml`. Si también utilizas la función de dominio personalizado de Fathom y deseas servir su script desde tu dominio, también puedes proporcionar adicionalmente el valor de configuración `domain`. Si no proporcionas un valor `domain`, el script se cargará directamente desde el DNS de Fathom.
|
||||
|
||||
```toml
|
||||
# config/_default/params.toml
|
||||
|
||||
[fathomAnalytics]
|
||||
site = "ABC12345"
|
||||
domain = "llama.yoursite.com"
|
||||
```
|
||||
|
||||
### Google Analytics
|
||||
|
||||
El soporte de Google Analytics se proporciona a través del partial interno de Hugo. Simplemente proporciona la clave `googleAnalytics` en el archivo `config/_default/hugo.toml` y el script se añadirá automáticamente.
|
||||
|
||||
Se soportan tanto la versión 3 (analytics.js) como la versión 4 (gtag.js), según el valor de configuración proporcionado:
|
||||
|
||||
```toml
|
||||
# config/_default/hugo.toml
|
||||
|
||||
# versión 3
|
||||
googleAnalytics = "UA-PROPERTY_ID"
|
||||
# versión 4
|
||||
googleAnalytics = "G-MEASUREMENT_ID"
|
||||
```
|
||||
|
||||
### Umami Analytics
|
||||
|
||||
Para habilitar el soporte de Umami Analytics, simplemente proporciona tu [código de seguimiento de Umami](https://umami.is/docs/collect-data) en el archivo `config/_default/params.toml`.
|
||||
Si también utilizas la función de dominio personalizado de Umami y deseas servir su script desde tu dominio, también puedes proporcionar adicionalmente el valor de configuración `domain`. Si no proporcionas un valor `domain`, el script se cargará directamente desde el DNS de Umami (analytics.umami.is).
|
||||
Si quieres que el rastreador solo se ejecute en dominios específicos, puedes proporcionar el valor de configuración `dataDomains`. Si no proporcionas un valor `dataDomains`, el script se ejecutará en cualquier sitio web donde coincidan `domain` y `websiteid`. Si la variable de entorno `TRACKER_SCRIPT_NAME` está configurada, puedes especificar un nombre de script personalizado `scriptName`. Si no está configurada, coméntala o usa el valor predeterminado `script.js`.
|
||||
|
||||
{{< alert >}}
|
||||
**Nota:** Si habilitas Umami Analytics, Blowfish soportará [Umami Track Event](https://umami.is/docs/track-events) automáticamente. Si no deseas soportar Track Event, el parámetro `enableTrackEvent` debe establecerse en `false`.
|
||||
{{< /alert >}}
|
||||
|
||||
```toml
|
||||
# config/_default/params.toml
|
||||
|
||||
[umamiAnalytics]
|
||||
websiteid = "ABC12345"
|
||||
domain = "llama.yoursite.com"
|
||||
dataDomains = "yoursite.com,yoursite2.com"
|
||||
scriptName = "TRACKER_SCRIPT_NAME"
|
||||
enableTrackEvent = true
|
||||
```
|
||||
|
||||
### Seline Analytics
|
||||
|
||||
Para habilitar el soporte de Seline Analytics, simplemente proporciona tu [token de Seline](https://seline.so/docs/install-seline) en el archivo `config/_default/params.toml`.
|
||||
|
||||
{{< alert >}}
|
||||
**Nota:** Si habilitas Seline Analytics, Blowfish soportará [Seline Track Event](https://seline.so/docs/custom-events) automáticamente. Si no deseas soportar Track Event, el parámetro `enableTrackEvent` debe establecerse en `false`.
|
||||
{{< /alert >}}
|
||||
|
||||
```toml
|
||||
# config/_default/params.toml
|
||||
|
||||
[selineAnalytics]
|
||||
token = "XXXXXX"
|
||||
enableTrackEvent = true
|
||||
```
|
||||
|
||||
### Proveedores de analytics personalizados
|
||||
|
||||
Si deseas usar un proveedor de analytics diferente en tu sitio web, también puedes sobrescribir el partial de analytics y proporcionar tu propio script. Simplemente crea el archivo `layouts/partials/extend-head.html` en tu proyecto y se incluirá automáticamente en el `<head>` del sitio web.
|
||||
|
||||
## Comentarios
|
||||
|
||||
Para añadir comentarios a tus artículos, Blowfish incluye soporte para un partial de comentarios que se incluye en la base de cada página de artículo. Simplemente proporciona un `layouts/partials/comments.html` que contenga el código requerido para mostrar tus comentarios elegidos.
|
||||
|
||||
Puedes usar ya sea la plantilla Disqus integrada de Hugo o proporcionar tu propio código personalizado. Consulta la [documentación de Hugo](https://gohugo.io/content-management/comments/) para más información.
|
||||
|
||||
Una vez que se ha proporcionado el partial, el control más fino sobre dónde se muestran los comentarios se gestiona usando el parámetro `showComments`. Este valor puede establecerse a nivel de tema en el [archivo de configuración]({{< ref "configuration#theme-parameters" >}}) `params.toml`, o por artículo incluyéndolo en el [front matter]({{< ref "front-matter" >}}). El parámetro es `false` por defecto, por lo que debe establecerse en `true` en una de estas ubicaciones para que se muestren los comentarios.
|
||||
|
||||
## Favicons
|
||||
|
||||
Blowfish proporciona un conjunto predeterminado de favicons en blanco para comenzar, pero puedes proporcionar tus propios recursos para sobrescribirlos. La forma más fácil de obtener nuevos recursos de favicon es generarlos usando un proveedor de terceros como [favicon.io](https://favicon.io).
|
||||
|
||||
Los recursos de iconos deben colocarse directamente en la carpeta `static/` de tu sitio web y nombrarse según la lista a continuación. Si usas [favicon.io](https://favicon.io), estos serán los nombres de archivo que se generarán automáticamente para ti, pero puedes proporcionar tus propios recursos si lo deseas.
|
||||
|
||||
```shell
|
||||
static/
|
||||
├─ android-chrome-192x192.png
|
||||
├─ android-chrome-512x512.png
|
||||
├─ apple-touch-icon.png
|
||||
├─ favicon-16x16.png
|
||||
├─ favicon-32x32.png
|
||||
├─ favicon.ico
|
||||
└─ site.webmanifest
|
||||
```
|
||||
|
||||
Alternativamente, también puedes sobrescribir completamente el comportamiento predeterminado de favicon y proporcionar tus propias etiquetas HTML de favicon y recursos. Simplemente proporciona un archivo `layouts/partials/favicons.html` en tu proyecto y este se inyectará en el `<head>` del sitio en lugar de los recursos predeterminados.
|
||||
|
||||
## Icon
|
||||
|
||||
Similar al [shortcode icon]({{< ref "shortcodes#icon" >}}), puedes incluir iconos en tus propios templates y partials usando el partial `icon.html` de Blowfish. El partial toma un parámetro que es el nombre del icono a incluir.
|
||||
|
||||
**Ejemplo:**
|
||||
|
||||
```go
|
||||
{{ partial "icon.html" "github" }}
|
||||
```
|
||||
|
||||
Los iconos se rellenan usando pipelines de Hugo, lo que los hace muy flexibles. Blowfish incluye varios iconos integrados para redes sociales, enlaces y otros propósitos. Consulta la página de [ejemplos de iconos]({{< ref "samples/icons" >}}) para una lista completa de los iconos soportados.
|
||||
|
||||
Se pueden añadir iconos personalizados proporcionando tus propios recursos de iconos en el directorio `assets/icons/` de tu proyecto. El icono puede luego referenciarse en el partial usando el nombre del archivo SVG sin la extensión `.svg`.
|
||||
|
||||
Los iconos también pueden usarse en el contenido de artículos llamando al [shortcode icon]({{< ref "shortcodes#icon" >}}).
|
||||
|
||||
## Extensiones
|
||||
|
||||
Blowfish también proporciona varios partials de extensión que permiten ampliar la funcionalidad base.
|
||||
|
||||
### Enlace de artículo
|
||||
|
||||
Si deseas insertar código adicional después de los enlaces de artículos, crea un archivo `layouts/partials/extend-article-link.html`. Esto es especialmente poderoso cuando se combina con el shortcode [`badge`]({{< ref "shortcodes#badge" >}}) que puede usarse para resaltar metadatos de ciertos artículos.
|
||||
|
||||
### Head y Footer
|
||||
|
||||
El tema permite insertar código adicional directamente en las secciones `<head>` y `<footer>` de la plantilla. Estos pueden ser útiles para proporcionar scripts u otra lógica que no forma parte del tema.
|
||||
|
||||
Simplemente crea ya sea `layouts/partials/extend-head.html` o `layouts/partials/extend-footer.html` y estos se incluirán automáticamente en la construcción de tu sitio web. Ambos partials se inyectan como los últimos elementos en `<head>` y `<footer>`, por lo que pueden usarse para sobrescribir los valores predeterminados del tema.
|
||||
|
||||
### Extensión Head sin caché
|
||||
|
||||
El `extend-head.html` está [en caché](https://gohugo.io/functions/partials/includecached/), y Blowfish también soporta una extensión head sin caché para incluir **condicionalmente** scripts o metadatos basados en propiedades a nivel de página. Para usar esta función, crea un archivo `layouts/partials/extend-head-uncached.html` en tu proyecto. Este archivo se incluirá en la etiqueta HTML `<head>`.
|
||||
|
||||
Esto es útil cuando necesitas incluir elementos dinámicos—como scripts o metadatos—basados en propiedades como shortcodes, flags de front matter, u otros datos específicos de la página que no deben almacenarse en caché entre builds.
|
||||
|
||||
Por ejemplo, para cargar dinámicamente un archivo JavaScript de CDN basado en la aparición de un shortcode, puedes usar el método [HasShortcode](https://gohugo.io/methods/page/hasshortcode/#article) dentro de `extend-head-uncached.html`.
|
||||
147
exampleSite/content/docs/partials/index.fr.md
Normal file
147
exampleSite/content/docs/partials/index.fr.md
Normal file
@@ -0,0 +1,147 @@
|
||||
---
|
||||
title: "Partials"
|
||||
weight: 9
|
||||
draft: false
|
||||
description: "Tous les partials disponibles dans Blowfish."
|
||||
slug: "partials"
|
||||
tags: ["partials", "analytics", "confidentialité", "commentaires", "favicons", "icon", "documentation"]
|
||||
series: ["Documentation"]
|
||||
series_order: 9
|
||||
---
|
||||
|
||||
## Analytics
|
||||
|
||||
Blowfish offre une prise en charge intégrée de Fathom Analytics, Google Analytics et Umami Analytics. Fathom est une alternative payante à Google Analytics qui respecte la vie privée des utilisateurs.
|
||||
|
||||
### Fathom Analytics
|
||||
|
||||
Pour activer la prise en charge de Fathom Analytics, fournissez simplement votre code de site Fathom dans le fichier `config/_default/params.toml`. Si vous utilisez également la fonctionnalité de domaine personnalisé de Fathom et souhaitez servir leur script depuis votre domaine, vous pouvez également fournir la valeur de configuration `domain`. Si vous ne fournissez pas de valeur `domain`, le script se chargera directement depuis le DNS de Fathom.
|
||||
|
||||
```toml
|
||||
# config/_default/params.toml
|
||||
|
||||
[fathomAnalytics]
|
||||
site = "ABC12345"
|
||||
domain = "llama.yoursite.com"
|
||||
```
|
||||
|
||||
### Google Analytics
|
||||
|
||||
La prise en charge de Google Analytics est fournie via le partial interne de Hugo. Fournissez simplement la clé `googleAnalytics` dans le fichier `config/_default/hugo.toml` et le script sera ajouté automatiquement.
|
||||
|
||||
Les versions 3 (analytics.js) et 4 (gtag.js) sont prises en charge, selon la valeur de configuration fournie :
|
||||
|
||||
```toml
|
||||
# config/_default/hugo.toml
|
||||
|
||||
# version 3
|
||||
googleAnalytics = "UA-PROPERTY_ID"
|
||||
# version 4
|
||||
googleAnalytics = "G-MEASUREMENT_ID"
|
||||
```
|
||||
|
||||
### Umami Analytics
|
||||
|
||||
Pour activer la prise en charge d'Umami Analytics, fournissez simplement votre [code de suivi Umami](https://umami.is/docs/collect-data) dans le fichier `config/_default/params.toml`.
|
||||
Si vous utilisez également la fonctionnalité de domaine personnalisé d'Umami et souhaitez servir leur script depuis votre domaine, vous pouvez également fournir la valeur de configuration `domain`. Si vous ne fournissez pas de valeur `domain`, le script se chargera directement depuis le DNS d'Umami (analytics.umami.is).
|
||||
Si vous souhaitez que le tracker ne s'exécute que sur des domaines spécifiques, vous pouvez fournir la valeur de configuration `dataDomains`. Si vous ne fournissez pas de valeur `dataDomains`, le script s'exécutera sur tout site web où `domain` et `websiteid` correspondent. Si la variable d'environnement `TRACKER_SCRIPT_NAME` est configurée, vous pouvez spécifier un nom de script personnalisé `scriptName`. Si elle n'est pas configurée, commentez-la ou utilisez la valeur par défaut `script.js`.
|
||||
|
||||
{{< alert >}}
|
||||
**Note :** Si vous activez Umami Analytics, Blowfish prendra en charge [Umami Track Event](https://umami.is/docs/track-events) automatiquement. Si vous ne souhaitez pas prendre en charge Track Event, le paramètre `enableTrackEvent` doit être défini sur `false`.
|
||||
{{< /alert >}}
|
||||
|
||||
```toml
|
||||
# config/_default/params.toml
|
||||
|
||||
[umamiAnalytics]
|
||||
websiteid = "ABC12345"
|
||||
domain = "llama.yoursite.com"
|
||||
dataDomains = "yoursite.com,yoursite2.com"
|
||||
scriptName = "TRACKER_SCRIPT_NAME"
|
||||
enableTrackEvent = true
|
||||
```
|
||||
|
||||
### Seline Analytics
|
||||
|
||||
Pour activer la prise en charge de Seline Analytics, fournissez simplement votre [token Seline](https://seline.so/docs/install-seline) dans le fichier `config/_default/params.toml`.
|
||||
|
||||
{{< alert >}}
|
||||
**Note :** Si vous activez Seline Analytics, Blowfish prendra en charge [Seline Track Event](https://seline.so/docs/custom-events) automatiquement. Si vous ne souhaitez pas prendre en charge Track Event, le paramètre `enableTrackEvent` doit être défini sur `false`.
|
||||
{{< /alert >}}
|
||||
|
||||
```toml
|
||||
# config/_default/params.toml
|
||||
|
||||
[selineAnalytics]
|
||||
token = "XXXXXX"
|
||||
enableTrackEvent = true
|
||||
```
|
||||
|
||||
### Fournisseurs d'analytics personnalisés
|
||||
|
||||
Si vous souhaitez utiliser un autre fournisseur d'analytics sur votre site web, vous pouvez également remplacer le partial analytics et fournir votre propre script. Créez simplement le fichier `layouts/partials/extend-head.html` dans votre projet et il sera automatiquement inclus dans le `<head>` du site web.
|
||||
|
||||
## Commentaires
|
||||
|
||||
Pour ajouter des commentaires à vos articles, Blowfish inclut la prise en charge d'un partial de commentaires qui est inclus en bas de chaque page d'article. Fournissez simplement un `layouts/partials/comments.html` contenant le code requis pour afficher vos commentaires choisis.
|
||||
|
||||
Vous pouvez utiliser soit le modèle Disqus intégré de Hugo, soit fournir votre propre code personnalisé. Consultez la [documentation Hugo](https://gohugo.io/content-management/comments/) pour plus d'informations.
|
||||
|
||||
Une fois le partial fourni, le contrôle plus fin de l'endroit où les commentaires sont affichés est ensuite géré via le paramètre `showComments`. Cette valeur peut être définie au niveau du thème dans le [fichier de configuration]({{< ref "configuration#theme-parameters" >}}) `params.toml`, ou par article en l'incluant dans le [front matter]({{< ref "front-matter" >}}). Le paramètre est par défaut `false`, il doit donc être défini sur `true` dans l'un de ces emplacements pour que les commentaires soient affichés.
|
||||
|
||||
## Favicons
|
||||
|
||||
Blowfish fournit un ensemble par défaut de favicons vides pour commencer, mais vous pouvez fournir vos propres ressources pour les remplacer. Le moyen le plus simple d'obtenir de nouvelles ressources favicon est de les générer à l'aide d'un fournisseur tiers comme [favicon.io](https://favicon.io).
|
||||
|
||||
Les ressources d'icônes doivent être placées directement dans le dossier `static/` de votre site web et nommées selon la liste ci-dessous. Si vous utilisez [favicon.io](https://favicon.io), ce seront les noms de fichiers qui seront automatiquement générés pour vous, mais vous pouvez fournir vos propres ressources si vous le souhaitez.
|
||||
|
||||
```shell
|
||||
static/
|
||||
├─ android-chrome-192x192.png
|
||||
├─ android-chrome-512x512.png
|
||||
├─ apple-touch-icon.png
|
||||
├─ favicon-16x16.png
|
||||
├─ favicon-32x32.png
|
||||
├─ favicon.ico
|
||||
└─ site.webmanifest
|
||||
```
|
||||
|
||||
Alternativement, vous pouvez également remplacer complètement le comportement par défaut des favicons et fournir vos propres balises HTML favicon et ressources. Créez simplement un fichier `layouts/partials/favicons.html` dans votre projet et celui-ci sera injecté dans le `<head>` du site à la place des ressources par défaut.
|
||||
|
||||
## Icon
|
||||
|
||||
Similaire au [shortcode icon]({{< ref "shortcodes#icon" >}}), vous pouvez inclure des icônes dans vos propres templates et partials en utilisant le partial `icon.html` de Blowfish. Le partial prend un paramètre qui est le nom de l'icône à inclure.
|
||||
|
||||
**Exemple :**
|
||||
|
||||
```go
|
||||
{{ partial "icon.html" "github" }}
|
||||
```
|
||||
|
||||
Les icônes sont remplies à l'aide des pipelines Hugo, ce qui les rend très flexibles. Blowfish inclut un certain nombre d'icônes intégrées pour les réseaux sociaux, les liens et d'autres usages. Consultez la page [exemples d'icônes]({{< ref "samples/icons" >}}) pour une liste complète des icônes prises en charge.
|
||||
|
||||
Des icônes personnalisées peuvent être ajoutées en fournissant vos propres ressources d'icônes dans le répertoire `assets/icons/` de votre projet. L'icône peut ensuite être référencée dans le partial en utilisant le nom du fichier SVG sans l'extension `.svg`.
|
||||
|
||||
Les icônes peuvent également être utilisées dans le contenu des articles en appelant le [shortcode icon]({{< ref "shortcodes#icon" >}}).
|
||||
|
||||
## Extensions
|
||||
|
||||
Blowfish fournit également un certain nombre de partials d'extension qui permettent d'étendre les fonctionnalités de base.
|
||||
|
||||
### Lien d'article
|
||||
|
||||
Si vous souhaitez insérer du code supplémentaire après les liens d'articles, créez un fichier `layouts/partials/extend-article-link.html`. C'est particulièrement puissant en combinaison avec le shortcode [`badge`]({{< ref "shortcodes#badge" >}}) qui peut être utilisé pour mettre en évidence les métadonnées de certains articles.
|
||||
|
||||
### Head et Footer
|
||||
|
||||
Le thème permet d'insérer du code supplémentaire directement dans les sections `<head>` et `<footer>` du template. Ceux-ci peuvent être utiles pour fournir des scripts ou d'autres logiques qui ne font pas partie du thème.
|
||||
|
||||
Créez simplement soit `layouts/partials/extend-head.html` soit `layouts/partials/extend-footer.html` et ceux-ci seront automatiquement inclus dans la construction de votre site web. Les deux partials sont injectés comme derniers éléments dans `<head>` et `<footer>`, ils peuvent donc être utilisés pour remplacer les valeurs par défaut du thème.
|
||||
|
||||
### Extension Head non mise en cache
|
||||
|
||||
Le `extend-head.html` est [mis en cache](https://gohugo.io/functions/partials/includecached/), et Blowfish prend également en charge une extension head non mise en cache pour inclure **conditionnellement** des scripts ou des métadonnées basées sur les propriétés au niveau de la page. Pour utiliser cette fonctionnalité, créez un fichier `layouts/partials/extend-head-uncached.html` dans votre projet. Ce fichier sera inclus dans la balise HTML `<head>`.
|
||||
|
||||
C'est utile lorsque vous devez inclure des éléments dynamiques—comme des scripts ou des métadonnées—basés sur des propriétés comme les shortcodes, les flags front matter, ou d'autres données spécifiques à la page qui ne devraient pas être mises en cache entre les builds.
|
||||
|
||||
Par exemple, pour charger dynamiquement un fichier JavaScript CDN basé sur l'apparition d'un shortcode, vous pouvez utiliser la méthode [HasShortcode](https://gohugo.io/methods/page/hasshortcode/#article) dans `extend-head-uncached.html`.
|
||||
147
exampleSite/content/docs/partials/index.pt-br.md
Normal file
147
exampleSite/content/docs/partials/index.pt-br.md
Normal file
@@ -0,0 +1,147 @@
|
||||
---
|
||||
title: "Partials"
|
||||
weight: 9
|
||||
draft: false
|
||||
description: "Todos os partials disponíveis no Blowfish."
|
||||
slug: "partials"
|
||||
tags: ["partials", "analytics", "privacidade", "comentários", "favicons", "icon", "documentação"]
|
||||
series: ["Documentação"]
|
||||
series_order: 9
|
||||
---
|
||||
|
||||
## Analytics
|
||||
|
||||
O Blowfish fornece suporte integrado para Fathom Analytics, Google Analytics e Umami Analytics. O Fathom é uma alternativa paga ao Google Analytics que respeita a privacidade do usuário.
|
||||
|
||||
### Fathom Analytics
|
||||
|
||||
Para habilitar o suporte ao Fathom Analytics, simplesmente forneça seu código de site do Fathom no arquivo `config/_default/params.toml`. Se você também usa o recurso de domínio personalizado do Fathom e gostaria de servir o script deles do seu domínio, você também pode fornecer adicionalmente o valor de configuração `domain`. Se você não fornecer um valor `domain`, o script será carregado diretamente do DNS do Fathom.
|
||||
|
||||
```toml
|
||||
# config/_default/params.toml
|
||||
|
||||
[fathomAnalytics]
|
||||
site = "ABC12345"
|
||||
domain = "llama.yoursite.com"
|
||||
```
|
||||
|
||||
### Google Analytics
|
||||
|
||||
O suporte ao Google Analytics é fornecido através do partial interno do Hugo. Simplesmente forneça a chave `googleAnalytics` no arquivo `config/_default/hugo.toml` e o script será adicionado automaticamente.
|
||||
|
||||
Tanto a versão 3 (analytics.js) quanto a versão 4 (gtag.js) são suportadas, com base no valor de configuração fornecido:
|
||||
|
||||
```toml
|
||||
# config/_default/hugo.toml
|
||||
|
||||
# versão 3
|
||||
googleAnalytics = "UA-PROPERTY_ID"
|
||||
# versão 4
|
||||
googleAnalytics = "G-MEASUREMENT_ID"
|
||||
```
|
||||
|
||||
### Umami Analytics
|
||||
|
||||
Para habilitar o suporte ao Umami Analytics, simplesmente forneça seu [código de rastreamento do Umami](https://umami.is/docs/collect-data) no arquivo `config/_default/params.toml`.
|
||||
Se você também usa o recurso de domínio personalizado do Umami e gostaria de servir o script deles do seu domínio, você também pode fornecer adicionalmente o valor de configuração `domain`. Se você não fornecer um valor `domain`, o script será carregado diretamente do DNS do Umami (analytics.umami.is).
|
||||
Se você quiser que o rastreador execute apenas em domínios específicos, você pode fornecer o valor de configuração `dataDomains`. Se você não fornecer um valor `dataDomains`, o script será executado em qualquer site onde `domain` e `websiteid` correspondam. Se a variável de ambiente `TRACKER_SCRIPT_NAME` estiver configurada, você pode especificar um nome de script personalizado `scriptName`. Se não estiver configurada, comente-a ou use o padrão `script.js`.
|
||||
|
||||
{{< alert >}}
|
||||
**Nota:** Se você habilitar o Umami Analytics, o Blowfish suportará [Umami Track Event](https://umami.is/docs/track-events) automaticamente. Se você não quiser suportar Track Event, o parâmetro `enableTrackEvent` deve ser definido como `false`.
|
||||
{{< /alert >}}
|
||||
|
||||
```toml
|
||||
# config/_default/params.toml
|
||||
|
||||
[umamiAnalytics]
|
||||
websiteid = "ABC12345"
|
||||
domain = "llama.yoursite.com"
|
||||
dataDomains = "yoursite.com,yoursite2.com"
|
||||
scriptName = "TRACKER_SCRIPT_NAME"
|
||||
enableTrackEvent = true
|
||||
```
|
||||
|
||||
### Seline Analytics
|
||||
|
||||
Para habilitar o suporte ao Seline Analytics, simplesmente forneça seu [token do Seline](https://seline.so/docs/install-seline) no arquivo `config/_default/params.toml`.
|
||||
|
||||
{{< alert >}}
|
||||
**Nota:** Se você habilitar o Seline Analytics, o Blowfish suportará [Seline Track Event](https://seline.so/docs/custom-events) automaticamente. Se você não quiser suportar Track Event, o parâmetro `enableTrackEvent` deve ser definido como `false`.
|
||||
{{< /alert >}}
|
||||
|
||||
```toml
|
||||
# config/_default/params.toml
|
||||
|
||||
[selineAnalytics]
|
||||
token = "XXXXXX"
|
||||
enableTrackEvent = true
|
||||
```
|
||||
|
||||
### Provedores de analytics personalizados
|
||||
|
||||
Se você deseja usar um provedor de analytics diferente em seu site, você também pode sobrescrever o partial de analytics e fornecer seu próprio script. Simplesmente crie o arquivo `layouts/partials/extend-head.html` em seu projeto e ele será automaticamente incluído no `<head>` do site.
|
||||
|
||||
## Comentários
|
||||
|
||||
Para adicionar comentários aos seus artigos, o Blowfish inclui suporte para um partial de comentários que é incluído na base de cada página de artigo. Simplesmente forneça um `layouts/partials/comments.html` contendo o código necessário para exibir seus comentários escolhidos.
|
||||
|
||||
Você pode usar o template Disqus integrado do Hugo ou fornecer seu próprio código personalizado. Consulte a [documentação do Hugo](https://gohugo.io/content-management/comments/) para mais informações.
|
||||
|
||||
Uma vez que o partial foi fornecido, o controle mais fino sobre onde os comentários são exibidos é gerenciado usando o parâmetro `showComments`. Este valor pode ser definido no nível do tema no [arquivo de configuração]({{< ref "configuration#theme-parameters" >}}) `params.toml`, ou por artigo incluindo-o no [front matter]({{< ref "front-matter" >}}). O parâmetro é `false` por padrão, então deve ser definido como `true` em um desses locais para que os comentários sejam exibidos.
|
||||
|
||||
## Favicons
|
||||
|
||||
O Blowfish fornece um conjunto padrão de favicons em branco para começar, mas você pode fornecer seus próprios recursos para sobrescrevê-los. A maneira mais fácil de obter novos recursos de favicon é gerá-los usando um provedor de terceiros como [favicon.io](https://favicon.io).
|
||||
|
||||
Os recursos de ícones devem ser colocados diretamente na pasta `static/` do seu site e nomeados conforme a lista abaixo. Se você usar o [favicon.io](https://favicon.io), esses serão os nomes de arquivo que serão gerados automaticamente para você, mas você pode fornecer seus próprios recursos se desejar.
|
||||
|
||||
```shell
|
||||
static/
|
||||
├─ android-chrome-192x192.png
|
||||
├─ android-chrome-512x512.png
|
||||
├─ apple-touch-icon.png
|
||||
├─ favicon-16x16.png
|
||||
├─ favicon-32x32.png
|
||||
├─ favicon.ico
|
||||
└─ site.webmanifest
|
||||
```
|
||||
|
||||
Alternativamente, você também pode sobrescrever completamente o comportamento padrão de favicon e fornecer suas próprias tags HTML de favicon e recursos. Simplesmente forneça um arquivo `layouts/partials/favicons.html` em seu projeto e ele será injetado no `<head>` do site no lugar dos recursos padrão.
|
||||
|
||||
## Icon
|
||||
|
||||
Similar ao [shortcode icon]({{< ref "shortcodes#icon" >}}), você pode incluir ícones em seus próprios templates e partials usando o partial `icon.html` do Blowfish. O partial recebe um parâmetro que é o nome do ícone a ser incluído.
|
||||
|
||||
**Exemplo:**
|
||||
|
||||
```go
|
||||
{{ partial "icon.html" "github" }}
|
||||
```
|
||||
|
||||
Os ícones são preenchidos usando pipelines do Hugo, o que os torna muito flexíveis. O Blowfish inclui vários ícones integrados para redes sociais, links e outros propósitos. Confira a página de [exemplos de ícones]({{< ref "samples/icons" >}}) para uma lista completa dos ícones suportados.
|
||||
|
||||
Ícones personalizados podem ser adicionados fornecendo seus próprios recursos de ícones no diretório `assets/icons/` do seu projeto. O ícone pode então ser referenciado no partial usando o nome do arquivo SVG sem a extensão `.svg`.
|
||||
|
||||
Os ícones também podem ser usados no conteúdo de artigos chamando o [shortcode icon]({{< ref "shortcodes#icon" >}}).
|
||||
|
||||
## Extensões
|
||||
|
||||
O Blowfish também fornece vários partials de extensão que permitem expandir a funcionalidade base.
|
||||
|
||||
### Link de artigo
|
||||
|
||||
Se você deseja inserir código adicional após links de artigos, crie um arquivo `layouts/partials/extend-article-link.html`. Isso é especialmente poderoso quando combinado com o shortcode [`badge`]({{< ref "shortcodes#badge" >}}) que pode ser usado para destacar metadados de certos artigos.
|
||||
|
||||
### Head e Footer
|
||||
|
||||
O tema permite inserir código adicional diretamente nas seções `<head>` e `<footer>` do template. Estes podem ser úteis para fornecer scripts ou outra lógica que não faz parte do tema.
|
||||
|
||||
Simplesmente crie `layouts/partials/extend-head.html` ou `layouts/partials/extend-footer.html` e estes serão automaticamente incluídos na construção do seu site. Ambos os partials são injetados como os últimos itens em `<head>` e `<footer>`, para que possam ser usados para sobrescrever os padrões do tema.
|
||||
|
||||
### Extensão Head sem cache
|
||||
|
||||
O `extend-head.html` é [armazenado em cache](https://gohugo.io/functions/partials/includecached/), e o Blowfish também suporta uma extensão head sem cache para incluir **condicionalmente** scripts ou metadados com base em propriedades no nível da página. Para usar esse recurso, crie um arquivo `layouts/partials/extend-head-uncached.html` em seu projeto. Este arquivo será incluído na tag HTML `<head>`.
|
||||
|
||||
Isso é útil quando você precisa incluir elementos dinâmicos—como scripts ou metadados—com base em propriedades como shortcodes, flags de front matter ou outros dados específicos da página que não devem ser armazenados em cache entre builds.
|
||||
|
||||
Por exemplo, para carregar dinamicamente um arquivo JavaScript de CDN com base na aparição de um shortcode, você pode usar o método [HasShortcode](https://gohugo.io/methods/page/hasshortcode/#article) dentro de `extend-head-uncached.html`.
|
||||
147
exampleSite/content/docs/partials/index.pt-pt.md
Normal file
147
exampleSite/content/docs/partials/index.pt-pt.md
Normal file
@@ -0,0 +1,147 @@
|
||||
---
|
||||
title: "Partials"
|
||||
weight: 9
|
||||
draft: false
|
||||
description: "Todos os partials disponíveis no Blowfish."
|
||||
slug: "partials"
|
||||
tags: ["partials", "analytics", "privacidade", "comentários", "favicons", "icon", "documentação"]
|
||||
series: ["Documentação"]
|
||||
series_order: 9
|
||||
---
|
||||
|
||||
## Analytics
|
||||
|
||||
O Blowfish fornece suporte integrado para Fathom Analytics, Google Analytics e Umami Analytics. O Fathom é uma alternativa paga ao Google Analytics que respeita a privacidade do utilizador.
|
||||
|
||||
### Fathom Analytics
|
||||
|
||||
Para ativar o suporte ao Fathom Analytics, basta fornecer o seu código de site do Fathom no ficheiro `config/_default/params.toml`. Se também utiliza a funcionalidade de domínio personalizado do Fathom e gostaria de servir o script deles do seu domínio, pode também fornecer adicionalmente o valor de configuração `domain`. Se não fornecer um valor `domain`, o script será carregado diretamente do DNS do Fathom.
|
||||
|
||||
```toml
|
||||
# config/_default/params.toml
|
||||
|
||||
[fathomAnalytics]
|
||||
site = "ABC12345"
|
||||
domain = "llama.yoursite.com"
|
||||
```
|
||||
|
||||
### Google Analytics
|
||||
|
||||
O suporte ao Google Analytics é fornecido através do partial interno do Hugo. Basta fornecer a chave `googleAnalytics` no ficheiro `config/_default/hugo.toml` e o script será adicionado automaticamente.
|
||||
|
||||
Tanto a versão 3 (analytics.js) como a versão 4 (gtag.js) são suportadas, com base no valor de configuração fornecido:
|
||||
|
||||
```toml
|
||||
# config/_default/hugo.toml
|
||||
|
||||
# versão 3
|
||||
googleAnalytics = "UA-PROPERTY_ID"
|
||||
# versão 4
|
||||
googleAnalytics = "G-MEASUREMENT_ID"
|
||||
```
|
||||
|
||||
### Umami Analytics
|
||||
|
||||
Para ativar o suporte ao Umami Analytics, basta fornecer o seu [código de rastreamento do Umami](https://umami.is/docs/collect-data) no ficheiro `config/_default/params.toml`.
|
||||
Se também utiliza a funcionalidade de domínio personalizado do Umami e gostaria de servir o script deles do seu domínio, pode também fornecer adicionalmente o valor de configuração `domain`. Se não fornecer um valor `domain`, o script será carregado diretamente do DNS do Umami (analytics.umami.is).
|
||||
Se quiser que o rastreador execute apenas em domínios específicos, pode fornecer o valor de configuração `dataDomains`. Se não fornecer um valor `dataDomains`, o script será executado em qualquer site onde `domain` e `websiteid` correspondam. Se a variável de ambiente `TRACKER_SCRIPT_NAME` estiver configurada, pode especificar um nome de script personalizado `scriptName`. Se não estiver configurada, comente-a ou utilize a predefinição `script.js`.
|
||||
|
||||
{{< alert >}}
|
||||
**Nota:** Se ativar o Umami Analytics, o Blowfish suportará [Umami Track Event](https://umami.is/docs/track-events) automaticamente. Se não quiser suportar Track Event, o parâmetro `enableTrackEvent` deve ser definido como `false`.
|
||||
{{< /alert >}}
|
||||
|
||||
```toml
|
||||
# config/_default/params.toml
|
||||
|
||||
[umamiAnalytics]
|
||||
websiteid = "ABC12345"
|
||||
domain = "llama.yoursite.com"
|
||||
dataDomains = "yoursite.com,yoursite2.com"
|
||||
scriptName = "TRACKER_SCRIPT_NAME"
|
||||
enableTrackEvent = true
|
||||
```
|
||||
|
||||
### Seline Analytics
|
||||
|
||||
Para ativar o suporte ao Seline Analytics, basta fornecer o seu [token do Seline](https://seline.so/docs/install-seline) no ficheiro `config/_default/params.toml`.
|
||||
|
||||
{{< alert >}}
|
||||
**Nota:** Se ativar o Seline Analytics, o Blowfish suportará [Seline Track Event](https://seline.so/docs/custom-events) automaticamente. Se não quiser suportar Track Event, o parâmetro `enableTrackEvent` deve ser definido como `false`.
|
||||
{{< /alert >}}
|
||||
|
||||
```toml
|
||||
# config/_default/params.toml
|
||||
|
||||
[selineAnalytics]
|
||||
token = "XXXXXX"
|
||||
enableTrackEvent = true
|
||||
```
|
||||
|
||||
### Fornecedores de analytics personalizados
|
||||
|
||||
Se deseja utilizar um fornecedor de analytics diferente no seu site, pode também substituir o partial de analytics e fornecer o seu próprio script. Basta criar o ficheiro `layouts/partials/extend-head.html` no seu projeto e será automaticamente incluído no `<head>` do site.
|
||||
|
||||
## Comentários
|
||||
|
||||
Para adicionar comentários aos seus artigos, o Blowfish inclui suporte para um partial de comentários que é incluído na base de cada página de artigo. Basta fornecer um `layouts/partials/comments.html` contendo o código necessário para apresentar os seus comentários escolhidos.
|
||||
|
||||
Pode utilizar o template Disqus integrado do Hugo ou fornecer o seu próprio código personalizado. Consulte a [documentação do Hugo](https://gohugo.io/content-management/comments/) para mais informações.
|
||||
|
||||
Uma vez que o partial foi fornecido, o controlo mais fino sobre onde os comentários são apresentados é gerido utilizando o parâmetro `showComments`. Este valor pode ser definido ao nível do tema no [ficheiro de configuração]({{< ref "configuration#theme-parameters" >}}) `params.toml`, ou por artigo incluindo-o no [front matter]({{< ref "front-matter" >}}). O parâmetro é `false` por predefinição, pelo que deve ser definido como `true` num destes locais para que os comentários sejam apresentados.
|
||||
|
||||
## Favicons
|
||||
|
||||
O Blowfish fornece um conjunto predefinido de favicons em branco para começar, mas pode fornecer os seus próprios recursos para substituí-los. A forma mais fácil de obter novos recursos de favicon é gerá-los utilizando um fornecedor de terceiros como [favicon.io](https://favicon.io).
|
||||
|
||||
Os recursos de ícones devem ser colocados diretamente na pasta `static/` do seu site e nomeados conforme a lista abaixo. Se utilizar o [favicon.io](https://favicon.io), estes serão os nomes de ficheiro que serão gerados automaticamente para si, mas pode fornecer os seus próprios recursos se desejar.
|
||||
|
||||
```shell
|
||||
static/
|
||||
├─ android-chrome-192x192.png
|
||||
├─ android-chrome-512x512.png
|
||||
├─ apple-touch-icon.png
|
||||
├─ favicon-16x16.png
|
||||
├─ favicon-32x32.png
|
||||
├─ favicon.ico
|
||||
└─ site.webmanifest
|
||||
```
|
||||
|
||||
Alternativamente, pode também substituir completamente o comportamento predefinido de favicon e fornecer as suas próprias tags HTML de favicon e recursos. Basta fornecer um ficheiro `layouts/partials/favicons.html` no seu projeto e este será injetado no `<head>` do site em vez dos recursos predefinidos.
|
||||
|
||||
## Icon
|
||||
|
||||
Semelhante ao [shortcode icon]({{< ref "shortcodes#icon" >}}), pode incluir ícones nos seus próprios templates e partials utilizando o partial `icon.html` do Blowfish. O partial recebe um parâmetro que é o nome do ícone a incluir.
|
||||
|
||||
**Exemplo:**
|
||||
|
||||
```go
|
||||
{{ partial "icon.html" "github" }}
|
||||
```
|
||||
|
||||
Os ícones são preenchidos utilizando pipelines do Hugo, o que os torna muito flexíveis. O Blowfish inclui vários ícones integrados para redes sociais, ligações e outros propósitos. Consulte a página de [exemplos de ícones]({{< ref "samples/icons" >}}) para uma lista completa dos ícones suportados.
|
||||
|
||||
Ícones personalizados podem ser adicionados fornecendo os seus próprios recursos de ícones no diretório `assets/icons/` do seu projeto. O ícone pode então ser referenciado no partial utilizando o nome do ficheiro SVG sem a extensão `.svg`.
|
||||
|
||||
Os ícones também podem ser utilizados no conteúdo de artigos chamando o [shortcode icon]({{< ref "shortcodes#icon" >}}).
|
||||
|
||||
## Extensões
|
||||
|
||||
O Blowfish também fornece vários partials de extensão que permitem expandir a funcionalidade base.
|
||||
|
||||
### Ligação de artigo
|
||||
|
||||
Se deseja inserir código adicional após ligações de artigos, crie um ficheiro `layouts/partials/extend-article-link.html`. Isto é especialmente poderoso quando combinado com o shortcode [`badge`]({{< ref "shortcodes#badge" >}}) que pode ser utilizado para destacar metadados de certos artigos.
|
||||
|
||||
### Head e Footer
|
||||
|
||||
O tema permite inserir código adicional diretamente nas secções `<head>` e `<footer>` do template. Estes podem ser úteis para fornecer scripts ou outra lógica que não faz parte do tema.
|
||||
|
||||
Basta criar `layouts/partials/extend-head.html` ou `layouts/partials/extend-footer.html` e estes serão automaticamente incluídos na construção do seu site. Ambos os partials são injetados como os últimos itens em `<head>` e `<footer>`, para que possam ser utilizados para substituir as predefinições do tema.
|
||||
|
||||
### Extensão Head sem cache
|
||||
|
||||
O `extend-head.html` é [armazenado em cache](https://gohugo.io/functions/partials/includecached/), e o Blowfish também suporta uma extensão head sem cache para incluir **condicionalmente** scripts ou metadados com base em propriedades ao nível da página. Para utilizar esta funcionalidade, crie um ficheiro `layouts/partials/extend-head-uncached.html` no seu projeto. Este ficheiro será incluído na tag HTML `<head>`.
|
||||
|
||||
Isto é útil quando precisa de incluir elementos dinâmicos—como scripts ou metadados—com base em propriedades como shortcodes, flags de front matter ou outros dados específicos da página que não devem ser armazenados em cache entre builds.
|
||||
|
||||
Por exemplo, para carregar dinamicamente um ficheiro JavaScript de CDN com base na aparição de um shortcode, pode utilizar o método [HasShortcode](https://gohugo.io/methods/page/hasshortcode/#article) dentro de `extend-head-uncached.html`.
|
||||
Reference in New Issue
Block a user