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
102
exampleSite/content/docs/multi-author/index.de.md
Normal file
102
exampleSite/content/docs/multi-author/index.de.md
Normal file
@@ -0,0 +1,102 @@
|
||||
---
|
||||
title: "Mehrere Autoren"
|
||||
weight: 8
|
||||
draft: false
|
||||
description: "Konfigurieren Sie mehrere Autoren für Ihre Artikel."
|
||||
slug: "multi-author"
|
||||
tags: ["autoren", "konfiguration", "dokumentation"]
|
||||
series: ["Dokumentation"]
|
||||
series_order: 10
|
||||
showAuthor: true
|
||||
authors:
|
||||
- "nunocoracao"
|
||||
showAuthorsBadges : false
|
||||
---
|
||||
|
||||
|
||||
Einige Websites haben mehr als einen Autor, der Inhalte beisteuert, und benötigen daher mehr als einen einzelnen Standardautor für die gesamte Website. Für diese Anwendungsfälle ermöglicht Blowfish den Benutzern, die Liste der Autoren mithilfe der Funktion für mehrere Autoren zu erweitern.
|
||||
|
||||
Um alles abwärtskompatibel zu halten, ermöglicht diese Funktion nur die Definition zusätzlicher Autoren und ändert in keiner Weise die vorherige Autorenfunktionalität, die über Konfigurationsdateien verwendet wird.
|
||||
|
||||
|
||||
## Autoren erstellen
|
||||
|
||||
Der erste Schritt zum Erstellen neuer Autoren ist das Einrichten eines neuen Ordners in `./data/authors`. Dann können Sie einfach neue `json`-Dateien darin hinzufügen, eine für jeden neuen Autor. Der Name der Datei wird der `key` für diesen Autor sein, wenn Sie ihn in Ihren Artikeln referenzieren.
|
||||
|
||||
Lassen Sie uns als Beispiel eine Datei namens `nunocoracao.json` in `./data/authors` erstellen. Der Inhalt der Datei sollte dem unten stehenden ähneln. `name`, `image`, `bio` und `social` sind die 4 Parameter, die derzeit für Autoren unterstützt werden. Sie spiegeln die Konfigurationen wider, die für den Standardautor in den Konfigurationsdateien verfügbar sind.
|
||||
|
||||
_Hinweis: Der Schlüssel im Social-Objekt wird verwendet, um eines der Theme-Icons abzurufen. Sie können jedes der in Ihrer Installation verfügbaren Icons verwenden._
|
||||
|
||||
```json
|
||||
{
|
||||
"name": "Nuno Coração",
|
||||
"image" : "img/nuno_avatar.jpg",
|
||||
"bio": "Theme Creator",
|
||||
"social": [
|
||||
{ "linkedin": "https://linkedin.com/in/nunocoracao" },
|
||||
{ "twitter": "https://twitter.com/nunocoracao" },
|
||||
{ "instagram": "https://instagram.com/nunocoracao" },
|
||||
{ "medium": "https://medium.com/@nunocoracao" },
|
||||
{ "github": "https://github.com/nunocoracao" },
|
||||
{ "goodreads": "http://goodreads.com/nunocoracao" },
|
||||
{ "keybase": "https://keybase.io/nunocoracao" },
|
||||
{ "reddit": "https://reddit.com/user/nunoheart" }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
## Autoren in Artikeln referenzieren
|
||||
|
||||
Nachdem Sie einen Autor erstellt haben, ist der nächste Schritt, ihn in einem oder mehreren Artikeln zu referenzieren. Im folgenden Beispiel referenzieren wir den im vorherigen Schritt erstellten Autor mit seinem `key`.
|
||||
|
||||
Dies wird einen zusätzlichen Autor mit den in der `json`-Datei bereitgestellten Daten rendern. Diese Funktion ändert in keiner Weise den für die gesamte Website konfigurierten Standardautor, und daher können Sie beide separat steuern. Mit dem Parameter `showAuthor` können Sie konfigurieren, ob der Standardautor angezeigt werden soll - das ist der normale Anwendungsfall für einen Einzelautoren-Blog. Der neue Front-Matter-Parameter `authors` ermöglicht es Ihnen, Autoren speziell für einen Artikel zu definieren, und sie werden unabhängig von den Konfigurationen für den Standard-Website-Autor gerendert.
|
||||
|
||||
```md
|
||||
---
|
||||
title: "Multiple Authors"
|
||||
date: 2020-08-10
|
||||
draft: false
|
||||
description: "Configure multiple authors for your articles."
|
||||
slug: "multi-author"
|
||||
tags: ["authors", "config", "docs"]
|
||||
showAuthor: true
|
||||
authors:
|
||||
- "nunocoracao"
|
||||
showAuthorsBadges : false
|
||||
---
|
||||
```
|
||||
|
||||
Im Beispiel, das dem Markdown der aktuellen Seite entspricht, werden sowohl der Standardautor als auch der neue angezeigt. Sie können jetzt nach unten scrollen, um das Ergebnis zu sehen.
|
||||
|
||||
## Die Autoren-Taxonomie erstellen
|
||||
|
||||
Um Listen von Artikeln für jeden Ihrer Autoren zu erhalten, können Sie die `authors`-Taxonomie konfigurieren, die einige weitere interessante Konfigurationen eröffnet. Dies ist ein optionaler Schritt im Prozess, der nicht erforderlich ist, um die Autoren in Ihren Artikeln anzuzeigen.
|
||||
|
||||
Der erste Schritt ist die Konfiguration der `authors`-Taxonomie in Ihrer `hugo.toml`-Datei, wie im folgenden Beispiel. Obwohl `tag` und `category` standardmäßig mit Hugo definiert sind, müssen Sie sie erneut hinzufügen, sobald Sie einen spezifischen Taxonomie-Abschnitt hinzufügen, da die Website sie sonst nicht verarbeitet.
|
||||
|
||||
```toml
|
||||
[taxonomies]
|
||||
tag = "tags"
|
||||
category = "categories"
|
||||
author = "authors"
|
||||
```
|
||||
|
||||
Und das war's im Grunde. Jetzt haben Sie Seiten, die Ihre Autoren referenzieren und für jeden die entsprechende Liste von Artikeln anzeigen, an denen sie teilnehmen. Sie können auch `article.showAuthorsBadges` in der Konfigurationsdatei oder `showAuthorsBadges` in jedem Artikel verwenden, um zu wählen, ob die `authors`-Taxonomie als Badges in jedem Beitragselement angezeigt werden soll. Diese Dokumentation ist so konfiguriert, dass keine Autoren angezeigt werden, aber wenn Sie sich das unten referenzierte Beispiel ansehen, werden Sie die Autoren als Badges sehen.
|
||||
|
||||
Schließlich können Sie jeder Autorenseite mehr Details hinzufügen, sodass sie eine kleine Bio, Links oder andere Informationen anzeigt, die zu Ihrem Anwendungsfall passen. Um dies zu erreichen, erstellen Sie einen Ordner mit dem `key` für jeden Autor in `./content/authors` und platzieren Sie darin eine `_index.md`-Datei. Für das obige Beispiel würden wir mit einer Datei `.content/authors/nunocoracao/_index.md` enden. Darin können Sie den tatsächlichen Namen des Autors und den Inhalt seiner Seite konfigurieren. Autoren auf dieser Dokumentations-Website sind so konfiguriert, sodass Sie einen Blick darauf werfen können, indem Sie auf der Website herumspielen.
|
||||
|
||||
```md
|
||||
---
|
||||
title: "Nuno Coração"
|
||||
---
|
||||
|
||||
Nuno's awesome dummy bio.
|
||||
|
||||
```
|
||||
|
||||
## Beispiel
|
||||
|
||||
Dieses Beispiel unten zeigt einen Fall, bei dem der Standard-Website-Autor deaktiviert ist und der Artikel mehrere Autoren hat.
|
||||
|
||||
{{< article link="/samples/multiple-authors/" >}}
|
||||
102
exampleSite/content/docs/multi-author/index.es.md
Normal file
102
exampleSite/content/docs/multi-author/index.es.md
Normal file
@@ -0,0 +1,102 @@
|
||||
---
|
||||
title: "Múltiples autores"
|
||||
weight: 8
|
||||
draft: false
|
||||
description: "Configura múltiples autores para tus artículos."
|
||||
slug: "multi-author"
|
||||
tags: ["autores", "configuración", "documentación"]
|
||||
series: ["Documentación"]
|
||||
series_order: 10
|
||||
showAuthor: true
|
||||
authors:
|
||||
- "nunocoracao"
|
||||
showAuthorsBadges : false
|
||||
---
|
||||
|
||||
|
||||
Algunos sitios web tienen más de un autor contribuyendo con contenido y por lo tanto requieren más de un único autor predeterminado para todo el sitio. Para esos casos de uso, Blowfish permite a los usuarios extender la lista de autores usando la función de múltiples autores.
|
||||
|
||||
Para mantener todo compatible hacia atrás, esta función solo permite la definición de autores adicionales y no cambia de ninguna manera la funcionalidad de autor anterior que se usa a través de archivos de configuración.
|
||||
|
||||
|
||||
## Crear autores
|
||||
|
||||
El primer paso para crear nuevos autores es configurar una nueva carpeta en `./data/authors`. Luego puedes simplemente añadir nuevos archivos `json` dentro, uno para cada nuevo autor. El nombre del archivo será la `clave` para ese autor al referenciarlo en tus artículos.
|
||||
|
||||
Como ejemplo, vamos a crear un archivo llamado `nunocoracao.json` dentro de `./data/authors`. El contenido del archivo debería ser similar al de abajo. `name`, `image`, `bio` y `social` son los 4 parámetros soportados actualmente para autores. Reflejan las configuraciones disponibles para el autor predeterminado en los archivos de configuración.
|
||||
|
||||
_Nota: la clave en el objeto social se usará para obtener uno de los iconos del tema, siéntete libre de usar cualquiera de los iconos disponibles en tu instalación._
|
||||
|
||||
```json
|
||||
{
|
||||
"name": "Nuno Coração",
|
||||
"image" : "img/nuno_avatar.jpg",
|
||||
"bio": "Theme Creator",
|
||||
"social": [
|
||||
{ "linkedin": "https://linkedin.com/in/nunocoracao" },
|
||||
{ "twitter": "https://twitter.com/nunocoracao" },
|
||||
{ "instagram": "https://instagram.com/nunocoracao" },
|
||||
{ "medium": "https://medium.com/@nunocoracao" },
|
||||
{ "github": "https://github.com/nunocoracao" },
|
||||
{ "goodreads": "http://goodreads.com/nunocoracao" },
|
||||
{ "keybase": "https://keybase.io/nunocoracao" },
|
||||
{ "reddit": "https://reddit.com/user/nunoheart" }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
## Referenciar autores en artículos
|
||||
|
||||
Ahora que has creado un autor, el siguiente paso es referenciarlo en uno o más artículos. En el ejemplo de abajo, referenciamos el autor creado en el paso anterior usando su `clave`.
|
||||
|
||||
Esto renderizará un autor adicional usando los datos proporcionados en el archivo `json`. Esta función no cambia de ninguna manera el autor predeterminado configurado para el sitio general, y por lo tanto, puedes controlar ambos por separado. Usando el parámetro `showAuthor`, puedes configurar si mostrar el autor predeterminado, ese es el caso de uso normal para un blog de un solo autor. El nuevo parámetro front matter `authors` te permite definir autores específicamente para un artículo, y serán renderizados independientemente de las configuraciones para el autor del sitio predeterminado.
|
||||
|
||||
```md
|
||||
---
|
||||
title: "Multiple Authors"
|
||||
date: 2020-08-10
|
||||
draft: false
|
||||
description: "Configure multiple authors for your articles."
|
||||
slug: "multi-author"
|
||||
tags: ["authors", "config", "docs"]
|
||||
showAuthor: true
|
||||
authors:
|
||||
- "nunocoracao"
|
||||
showAuthorsBadges : false
|
||||
---
|
||||
```
|
||||
|
||||
En el ejemplo, que coincide con el markdown de la página actual, tanto el autor predeterminado como el nuevo serán mostrados. Puedes desplazarte hacia abajo ahora para ver el resultado.
|
||||
|
||||
## Crear la taxonomía de autores
|
||||
|
||||
Para obtener listas de artículos para cada uno de tus autores puedes configurar la taxonomía `authors`, que abre algunas configuraciones más que podrían ser interesantes. Este es un paso opcional en el proceso que no es requerido para mostrar los autores en tus artículos.
|
||||
|
||||
El primer paso es configurar la taxonomía `authors` en tu archivo `hugo.toml`, como en el ejemplo de abajo. Aunque `tag` y `category` están definidos por defecto con Hugo, una vez que añades una sección de taxonomías específica necesitas añadirlos de nuevo, de lo contrario el sitio no los procesará.
|
||||
|
||||
```toml
|
||||
[taxonomies]
|
||||
tag = "tags"
|
||||
category = "categories"
|
||||
author = "authors"
|
||||
```
|
||||
|
||||
Y eso es básicamente todo. Ahora tendrás páginas que referencian a tus autores y, para cada uno, muestran la lista respectiva de artículos donde participan. También puedes usar `article.showAuthorsBadges` en el archivo de configuración, o `showAuthorsBadges` en cada artículo para elegir si mostrar la taxonomía `authors` como badges en cada elemento de publicación. Como ejemplo, esta documentación está configurada para no mostrar autores pero si miras la muestra referenciada abajo verás los autores mostrados como badges.
|
||||
|
||||
Por último, puedes añadir más detalle a cada página de autor para que muestre una pequeña bio, enlaces, o cualquier información que se ajuste a tu caso de uso. Para lograr eso, crea una carpeta con la `clave` para cada autor dentro de `./content/authors` y dentro de cada carpeta coloca un archivo `_index.md`. Para el ejemplo de arriba, terminaríamos con un archivo `.content/authors/nunocoracao/_index.md`. Dentro, puedes configurar el nombre real del autor y el contenido de su página. Los autores en este sitio de documentación están configurados así, por lo que puedes echar un vistazo jugando con el sitio.
|
||||
|
||||
```md
|
||||
---
|
||||
title: "Nuno Coração"
|
||||
---
|
||||
|
||||
Nuno's awesome dummy bio.
|
||||
|
||||
```
|
||||
|
||||
## Ejemplo
|
||||
|
||||
Esta muestra de abajo muestra un ejemplo donde el autor del sitio predeterminado está desactivado y el artículo tiene múltiples autores.
|
||||
|
||||
{{< article link="/samples/multiple-authors/" >}}
|
||||
102
exampleSite/content/docs/multi-author/index.fr.md
Normal file
102
exampleSite/content/docs/multi-author/index.fr.md
Normal file
@@ -0,0 +1,102 @@
|
||||
---
|
||||
title: "Auteurs multiples"
|
||||
weight: 8
|
||||
draft: false
|
||||
description: "Configurez plusieurs auteurs pour vos articles."
|
||||
slug: "multi-author"
|
||||
tags: ["auteurs", "configuration", "documentation"]
|
||||
series: ["Documentation"]
|
||||
series_order: 10
|
||||
showAuthor: true
|
||||
authors:
|
||||
- "nunocoracao"
|
||||
showAuthorsBadges : false
|
||||
---
|
||||
|
||||
|
||||
Certains sites web ont plus d'un auteur contribuant au contenu et nécessitent donc plus qu'un seul auteur par défaut pour l'ensemble du site. Pour ces cas d'utilisation, Blowfish permet aux utilisateurs d'étendre la liste des auteurs en utilisant la fonctionnalité d'auteurs multiples.
|
||||
|
||||
Pour garder tout rétrocompatible, cette fonctionnalité permet uniquement la définition d'auteurs supplémentaires et ne change en rien la fonctionnalité d'auteur précédente qui est utilisée via les fichiers de configuration.
|
||||
|
||||
|
||||
## Créer des auteurs
|
||||
|
||||
La première étape pour créer de nouveaux auteurs est de configurer un nouveau dossier dans `./data/authors`. Ensuite, vous pouvez simplement ajouter de nouveaux fichiers `json` à l'intérieur, un pour chaque nouvel auteur. Le nom du fichier sera la `clé` pour cet auteur lors de sa référence dans vos articles.
|
||||
|
||||
Par exemple, créons un fichier appelé `nunocoracao.json` dans `./data/authors`. Le contenu du fichier devrait être similaire à celui ci-dessous. `name`, `image`, `bio` et `social` sont les 4 paramètres actuellement supportés pour les auteurs. Ils reflètent les configurations disponibles pour l'auteur par défaut dans les fichiers de configuration.
|
||||
|
||||
_Note : la clé dans l'objet social sera utilisée pour récupérer l'une des icônes du thème, n'hésitez pas à utiliser n'importe quelle icône disponible dans votre installation._
|
||||
|
||||
```json
|
||||
{
|
||||
"name": "Nuno Coração",
|
||||
"image" : "img/nuno_avatar.jpg",
|
||||
"bio": "Theme Creator",
|
||||
"social": [
|
||||
{ "linkedin": "https://linkedin.com/in/nunocoracao" },
|
||||
{ "twitter": "https://twitter.com/nunocoracao" },
|
||||
{ "instagram": "https://instagram.com/nunocoracao" },
|
||||
{ "medium": "https://medium.com/@nunocoracao" },
|
||||
{ "github": "https://github.com/nunocoracao" },
|
||||
{ "goodreads": "http://goodreads.com/nunocoracao" },
|
||||
{ "keybase": "https://keybase.io/nunocoracao" },
|
||||
{ "reddit": "https://reddit.com/user/nunoheart" }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
## Référencer les auteurs dans les articles
|
||||
|
||||
Maintenant que vous avez créé un auteur, l'étape suivante est de le référencer dans un ou plusieurs articles. Dans l'exemple ci-dessous, nous référençons l'auteur créé à l'étape précédente en utilisant sa `clé`.
|
||||
|
||||
Cela affichera un auteur supplémentaire en utilisant les données fournies dans le fichier `json`. Cette fonctionnalité ne change en rien l'auteur par défaut configuré pour l'ensemble du site, et donc, vous pouvez contrôler les deux séparément. En utilisant le paramètre `showAuthor`, vous pouvez configurer s'il faut afficher l'auteur par défaut, c'est le cas d'utilisation normal pour un blog à auteur unique. Le nouveau paramètre front matter `authors` vous permet de définir des auteurs spécifiquement pour un article, et ils seront rendus indépendamment des configurations pour l'auteur du site par défaut.
|
||||
|
||||
```md
|
||||
---
|
||||
title: "Multiple Authors"
|
||||
date: 2020-08-10
|
||||
draft: false
|
||||
description: "Configure multiple authors for your articles."
|
||||
slug: "multi-author"
|
||||
tags: ["authors", "config", "docs"]
|
||||
showAuthor: true
|
||||
authors:
|
||||
- "nunocoracao"
|
||||
showAuthorsBadges : false
|
||||
---
|
||||
```
|
||||
|
||||
Dans l'exemple, qui correspond au markdown de la page actuelle, à la fois l'auteur par défaut et le nouveau seront affichés. Vous pouvez faire défiler vers le bas maintenant pour voir le résultat.
|
||||
|
||||
## Créer la taxonomie des auteurs
|
||||
|
||||
Pour obtenir des listes d'articles pour chacun de vos auteurs, vous pouvez configurer la taxonomie `authors`, qui ouvre quelques configurations supplémentaires qui pourraient être intéressantes. C'est une étape optionnelle dans le processus qui n'est pas requise pour afficher les auteurs dans vos articles.
|
||||
|
||||
La première étape est de configurer la taxonomie `authors` dans votre fichier `hugo.toml`, comme dans l'exemple ci-dessous. Même si `tag` et `category` sont définis par défaut avec Hugo, une fois que vous ajoutez une section taxonomies spécifique, vous devez les ajouter à nouveau sinon le site ne les traitera pas.
|
||||
|
||||
```toml
|
||||
[taxonomies]
|
||||
tag = "tags"
|
||||
category = "categories"
|
||||
author = "authors"
|
||||
```
|
||||
|
||||
Et c'est à peu près tout. Maintenant vous aurez des pages qui référencent vos auteurs et, pour chacun, affichent la liste respective d'articles où ils participent. Vous pouvez également utiliser `article.showAuthorsBadges` dans le fichier de configuration, ou `showAuthorsBadges` sur chaque article pour choisir d'afficher ou non la taxonomie `authors` comme badges dans chaque élément de publication. Par exemple, cette documentation est configurée pour ne pas afficher les auteurs mais si vous regardez l'exemple référencé ci-dessous, vous verrez les auteurs affichés comme badges.
|
||||
|
||||
Enfin, vous pouvez ajouter plus de détails à chaque page d'auteur pour qu'elle affiche une petite bio, des liens, ou toute information qui correspond à votre cas d'utilisation. Pour y parvenir, créez un dossier avec la `clé` pour chaque auteur dans `./content/authors` et placez à l'intérieur un fichier `_index.md`. Pour l'exemple ci-dessus, nous finirions avec un fichier `.content/authors/nunocoracao/_index.md`. À l'intérieur, vous pouvez configurer le nom réel de l'auteur et le contenu de sa page. Les auteurs sur ce site de documentation sont configurés ainsi, donc vous pouvez y jeter un œil en jouant avec le site.
|
||||
|
||||
```md
|
||||
---
|
||||
title: "Nuno Coração"
|
||||
---
|
||||
|
||||
Nuno's awesome dummy bio.
|
||||
|
||||
```
|
||||
|
||||
## Exemple
|
||||
|
||||
Cet exemple ci-dessous montre un cas où l'auteur du site par défaut est désactivé et l'article a plusieurs auteurs.
|
||||
|
||||
{{< article link="/samples/multiple-authors/" >}}
|
||||
102
exampleSite/content/docs/multi-author/index.pt-br.md
Normal file
102
exampleSite/content/docs/multi-author/index.pt-br.md
Normal file
@@ -0,0 +1,102 @@
|
||||
---
|
||||
title: "Múltiplos autores"
|
||||
weight: 8
|
||||
draft: false
|
||||
description: "Configure múltiplos autores para seus artigos."
|
||||
slug: "multi-author"
|
||||
tags: ["autores", "configuração", "documentação"]
|
||||
series: ["Documentação"]
|
||||
series_order: 10
|
||||
showAuthor: true
|
||||
authors:
|
||||
- "nunocoracao"
|
||||
showAuthorsBadges : false
|
||||
---
|
||||
|
||||
|
||||
Alguns sites têm mais de um autor contribuindo com conteúdo e, portanto, requerem mais de um único autor padrão para todo o site. Para esses casos de uso, o Blowfish permite aos usuários estender a lista de autores usando o recurso de múltiplos autores.
|
||||
|
||||
Para manter tudo compatível com versões anteriores, este recurso permite apenas a definição de autores adicionais e não altera de nenhuma forma a funcionalidade de autor anterior que é usada através dos arquivos de configuração.
|
||||
|
||||
|
||||
## Criar autores
|
||||
|
||||
O primeiro passo para criar novos autores é configurar uma nova pasta em `./data/authors`. Então você pode simplesmente adicionar novos arquivos `json` dentro, um para cada novo autor. O nome do arquivo será a `chave` para aquele autor ao referenciá-lo em seus artigos.
|
||||
|
||||
Como exemplo, vamos criar um arquivo chamado `nunocoracao.json` dentro de `./data/authors`. O conteúdo do arquivo deve ser semelhante ao abaixo. `name`, `image`, `bio` e `social` são os 4 parâmetros suportados atualmente para autores. Eles espelham as configurações disponíveis para o autor padrão nos arquivos de configuração.
|
||||
|
||||
_Nota: a chave no objeto social será usada para buscar um dos ícones do tema, sinta-se à vontade para usar qualquer um dos ícones disponíveis em sua instalação._
|
||||
|
||||
```json
|
||||
{
|
||||
"name": "Nuno Coração",
|
||||
"image" : "img/nuno_avatar.jpg",
|
||||
"bio": "Theme Creator",
|
||||
"social": [
|
||||
{ "linkedin": "https://linkedin.com/in/nunocoracao" },
|
||||
{ "twitter": "https://twitter.com/nunocoracao" },
|
||||
{ "instagram": "https://instagram.com/nunocoracao" },
|
||||
{ "medium": "https://medium.com/@nunocoracao" },
|
||||
{ "github": "https://github.com/nunocoracao" },
|
||||
{ "goodreads": "http://goodreads.com/nunocoracao" },
|
||||
{ "keybase": "https://keybase.io/nunocoracao" },
|
||||
{ "reddit": "https://reddit.com/user/nunoheart" }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
## Referenciar autores em artigos
|
||||
|
||||
Agora que você criou um autor, o próximo passo é referenciá-lo em um ou mais artigos. No exemplo abaixo, referenciamos o autor criado no passo anterior usando sua `chave`.
|
||||
|
||||
Isso renderizará um autor adicional usando os dados fornecidos no arquivo `json`. Este recurso não altera de nenhuma forma o autor padrão configurado para o site geral, e portanto, você pode controlar ambos separadamente. Usando o parâmetro `showAuthor`, você pode configurar se deseja mostrar o autor padrão, esse é o caso de uso normal para um blog de autor único. O novo parâmetro front matter `authors` permite definir autores especificamente para um artigo, e eles serão renderizados independentemente das configurações para o autor padrão do site.
|
||||
|
||||
```md
|
||||
---
|
||||
title: "Multiple Authors"
|
||||
date: 2020-08-10
|
||||
draft: false
|
||||
description: "Configure multiple authors for your articles."
|
||||
slug: "multi-author"
|
||||
tags: ["authors", "config", "docs"]
|
||||
showAuthor: true
|
||||
authors:
|
||||
- "nunocoracao"
|
||||
showAuthorsBadges : false
|
||||
---
|
||||
```
|
||||
|
||||
No exemplo, que corresponde ao markdown da página atual, tanto o autor padrão quanto o novo serão exibidos. Você pode rolar para baixo agora para ver o resultado.
|
||||
|
||||
## Criar a taxonomia de autores
|
||||
|
||||
Para obter listas de artigos para cada um de seus autores, você pode configurar a taxonomia `authors`, que abre algumas configurações mais que podem ser interessantes. Este é um passo opcional no processo que não é necessário para exibir os autores em seus artigos.
|
||||
|
||||
O primeiro passo é configurar a taxonomia `authors` em seu arquivo `hugo.toml`, como no exemplo abaixo. Embora `tag` e `category` sejam definidos por padrão com Hugo, uma vez que você adiciona uma seção de taxonomias específica, você precisa adicioná-los novamente, caso contrário o site não os processará.
|
||||
|
||||
```toml
|
||||
[taxonomies]
|
||||
tag = "tags"
|
||||
category = "categories"
|
||||
author = "authors"
|
||||
```
|
||||
|
||||
E é basicamente isso. Agora você terá páginas que referenciam seus autores e, para cada um, mostram a respectiva lista de artigos onde eles participam. Você também pode usar `article.showAuthorsBadges` no arquivo de configuração, ou `showAuthorsBadges` em cada artigo para escolher se deseja exibir a taxonomia `authors` como badges em cada item de postagem. Como exemplo, esta documentação está configurada para não exibir autores, mas se você olhar a amostra referenciada abaixo, verá os autores exibidos como badges.
|
||||
|
||||
Por último, você pode adicionar mais detalhes a cada página de autor para que ela exiba uma pequena bio, links ou qualquer informação que se adeque ao seu caso de uso. Para conseguir isso, crie uma pasta com a `chave` para cada autor dentro de `./content/authors` e dentro de cada pasta coloque um arquivo `_index.md`. Para o exemplo acima, terminaríamos com um arquivo `.content/authors/nunocoracao/_index.md`. Dentro, você pode configurar o nome real do autor e o conteúdo de sua página. Os autores neste site de documentação estão configurados assim, então você pode dar uma olhada jogando com o site.
|
||||
|
||||
```md
|
||||
---
|
||||
title: "Nuno Coração"
|
||||
---
|
||||
|
||||
Nuno's awesome dummy bio.
|
||||
|
||||
```
|
||||
|
||||
## Exemplo
|
||||
|
||||
Esta amostra abaixo mostra um exemplo onde o autor padrão do site está desativado e o artigo tem múltiplos autores.
|
||||
|
||||
{{< article link="/samples/multiple-authors/" >}}
|
||||
102
exampleSite/content/docs/multi-author/index.pt-pt.md
Normal file
102
exampleSite/content/docs/multi-author/index.pt-pt.md
Normal file
@@ -0,0 +1,102 @@
|
||||
---
|
||||
title: "Múltiplos autores"
|
||||
weight: 8
|
||||
draft: false
|
||||
description: "Configure múltiplos autores para os seus artigos."
|
||||
slug: "multi-author"
|
||||
tags: ["autores", "configuração", "documentação"]
|
||||
series: ["Documentação"]
|
||||
series_order: 10
|
||||
showAuthor: true
|
||||
authors:
|
||||
- "nunocoracao"
|
||||
showAuthorsBadges : false
|
||||
---
|
||||
|
||||
|
||||
Alguns websites têm mais do que um autor a contribuir com conteúdo e, portanto, requerem mais do que um único autor predefinido para todo o site. Para esses casos de uso, o Blowfish permite aos utilizadores estender a lista de autores utilizando a funcionalidade de múltiplos autores.
|
||||
|
||||
Para manter tudo compatível com versões anteriores, esta funcionalidade apenas permite a definição de autores adicionais e não altera de nenhuma forma a funcionalidade de autor anterior que é utilizada através dos ficheiros de configuração.
|
||||
|
||||
|
||||
## Criar autores
|
||||
|
||||
O primeiro passo para criar novos autores é configurar uma nova pasta em `./data/authors`. Depois pode simplesmente adicionar novos ficheiros `json` dentro, um para cada novo autor. O nome do ficheiro será a `chave` para esse autor ao referenciá-lo nos seus artigos.
|
||||
|
||||
Como exemplo, vamos criar um ficheiro chamado `nunocoracao.json` dentro de `./data/authors`. O conteúdo do ficheiro deve ser semelhante ao abaixo. `name`, `image`, `bio` e `social` são os 4 parâmetros suportados atualmente para autores. Eles espelham as configurações disponíveis para o autor predefinido nos ficheiros de configuração.
|
||||
|
||||
_Nota: a chave no objeto social será utilizada para obter um dos ícones do tema, sinta-se à vontade para utilizar qualquer um dos ícones disponíveis na sua instalação._
|
||||
|
||||
```json
|
||||
{
|
||||
"name": "Nuno Coração",
|
||||
"image" : "img/nuno_avatar.jpg",
|
||||
"bio": "Theme Creator",
|
||||
"social": [
|
||||
{ "linkedin": "https://linkedin.com/in/nunocoracao" },
|
||||
{ "twitter": "https://twitter.com/nunocoracao" },
|
||||
{ "instagram": "https://instagram.com/nunocoracao" },
|
||||
{ "medium": "https://medium.com/@nunocoracao" },
|
||||
{ "github": "https://github.com/nunocoracao" },
|
||||
{ "goodreads": "http://goodreads.com/nunocoracao" },
|
||||
{ "keybase": "https://keybase.io/nunocoracao" },
|
||||
{ "reddit": "https://reddit.com/user/nunoheart" }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
## Referenciar autores em artigos
|
||||
|
||||
Agora que criou um autor, o próximo passo é referenciá-lo em um ou mais artigos. No exemplo abaixo, referenciamos o autor criado no passo anterior utilizando a sua `chave`.
|
||||
|
||||
Isto irá renderizar um autor adicional utilizando os dados fornecidos no ficheiro `json`. Esta funcionalidade não altera de nenhuma forma o autor predefinido configurado para o site geral, e portanto, pode controlar ambos separadamente. Utilizando o parâmetro `showAuthor`, pode configurar se deseja mostrar o autor predefinido, esse é o caso de uso normal para um blogue de autor único. O novo parâmetro front matter `authors` permite definir autores especificamente para um artigo, e eles serão renderizados independentemente das configurações para o autor predefinido do site.
|
||||
|
||||
```md
|
||||
---
|
||||
title: "Multiple Authors"
|
||||
date: 2020-08-10
|
||||
draft: false
|
||||
description: "Configure multiple authors for your articles."
|
||||
slug: "multi-author"
|
||||
tags: ["authors", "config", "docs"]
|
||||
showAuthor: true
|
||||
authors:
|
||||
- "nunocoracao"
|
||||
showAuthorsBadges : false
|
||||
---
|
||||
```
|
||||
|
||||
No exemplo, que corresponde ao markdown da página atual, tanto o autor predefinido quanto o novo serão apresentados. Pode fazer scroll para baixo agora para ver o resultado.
|
||||
|
||||
## Criar a taxonomia de autores
|
||||
|
||||
Para obter listas de artigos para cada um dos seus autores, pode configurar a taxonomia `authors`, que abre algumas configurações mais que podem ser interessantes. Este é um passo opcional no processo que não é necessário para apresentar os autores nos seus artigos.
|
||||
|
||||
O primeiro passo é configurar a taxonomia `authors` no seu ficheiro `hugo.toml`, como no exemplo abaixo. Embora `tag` e `category` sejam definidos por predefinição com Hugo, assim que adiciona uma secção de taxonomias específica, precisa de adicioná-los novamente, caso contrário o site não os processará.
|
||||
|
||||
```toml
|
||||
[taxonomies]
|
||||
tag = "tags"
|
||||
category = "categories"
|
||||
author = "authors"
|
||||
```
|
||||
|
||||
E é basicamente isso. Agora terá páginas que referenciam os seus autores e, para cada um, mostram a respetiva lista de artigos onde participam. Também pode utilizar `article.showAuthorsBadges` no ficheiro de configuração, ou `showAuthorsBadges` em cada artigo para escolher se deseja apresentar a taxonomia `authors` como badges em cada item de publicação. Como exemplo, esta documentação está configurada para não apresentar autores, mas se olhar para a amostra referenciada abaixo, verá os autores apresentados como badges.
|
||||
|
||||
Por último, pode adicionar mais detalhes a cada página de autor para que apresente uma pequena bio, ligações ou qualquer informação que se adeque ao seu caso de uso. Para conseguir isso, crie uma pasta com a `chave` para cada autor dentro de `./content/authors` e dentro de cada pasta coloque um ficheiro `_index.md`. Para o exemplo acima, terminaríamos com um ficheiro `.content/authors/nunocoracao/_index.md`. Dentro, pode configurar o nome real do autor e o conteúdo da sua página. Os autores neste website de documentação estão configurados assim, portanto pode dar uma vista de olhos navegando pelo site.
|
||||
|
||||
```md
|
||||
---
|
||||
title: "Nuno Coração"
|
||||
---
|
||||
|
||||
Nuno's awesome dummy bio.
|
||||
|
||||
```
|
||||
|
||||
## Exemplo
|
||||
|
||||
Esta amostra abaixo mostra um exemplo onde o autor predefinido do site está desativado e o artigo tem múltiplos autores.
|
||||
|
||||
{{< article link="/samples/multiple-authors/" >}}
|
||||
Reference in New Issue
Block a user