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
224
exampleSite/content/docs/getting-started/index.de.md
Normal file
224
exampleSite/content/docs/getting-started/index.de.md
Normal file
@@ -0,0 +1,224 @@
|
||||
---
|
||||
title: "Erste Schritte"
|
||||
weight: 3
|
||||
draft: false
|
||||
description: "Alle in Blowfish verfügbaren Front-Matter-Variablen."
|
||||
slug: "getting-started"
|
||||
tags: ["installation", "dokumentation"]
|
||||
series: ["Dokumentation"]
|
||||
series_order: 3
|
||||
---
|
||||
|
||||
{{< alert >}}
|
||||
Dieser Abschnitt setzt voraus, dass Sie das [Blowfish-Theme bereits installiert]({{< ref "docs/installation" >}}) haben.
|
||||
{{< /alert >}}
|
||||
|
||||
</br>
|
||||
{{< alert "fire" >}}
|
||||
Wir haben gerade ein CLI-Tool veröffentlicht, das Ihnen beim Einstieg mit Blowfish hilft. Es unterstützt Sie bei Installation und Konfiguration. Installieren Sie das CLI-Tool global mit:
|
||||
```bash
|
||||
npx blowfish-tools
|
||||
```
|
||||
{{< /alert >}}
|
||||
|
||||
Die mit Blowfish gelieferten Konfigurationsdateien enthalten alle möglichen Einstellungen, die das Theme erkennt. Standardmäßig sind viele davon auskommentiert, aber Sie können sie einfach einkommentieren, um eine bestimmte Funktion zu aktivieren oder zu ändern.
|
||||
|
||||
## Grundkonfiguration
|
||||
|
||||
Bevor Sie Inhalte erstellen, sollten Sie für eine neue Installation einige Dinge festlegen. Beginnen Sie in der Datei `hugo.toml` und setzen Sie die Parameter `baseURL` und `languageCode`. Der `languageCode` sollte auf die Hauptsprache eingestellt werden, in der Sie Ihre Inhalte verfassen werden.
|
||||
|
||||
```toml
|
||||
# config/_default/hugo.toml
|
||||
|
||||
baseURL = "https://your_domain.com/"
|
||||
languageCode = "de"
|
||||
```
|
||||
|
||||
Der nächste Schritt ist die Konfiguration der Spracheinstellungen. Obwohl Blowfish mehrsprachige Setups unterstützt, konfigurieren Sie vorerst nur die Hauptsprache.
|
||||
|
||||
Suchen Sie die Datei `languages.en.toml` im Konfigurationsordner. Wenn Ihre Hauptsprache Englisch ist, können Sie diese Datei so verwenden, wie sie ist. Andernfalls benennen Sie sie um, sodass sie den richtigen Sprachcode im Dateinamen enthält. Für Deutsch benennen Sie die Datei beispielsweise in `languages.de.toml` um.
|
||||
|
||||
{{< alert >}}
|
||||
Beachten Sie, dass der Sprachcode im Dateinamen der Sprachkonfiguration mit der Einstellung `languageCode` in `hugo.toml` übereinstimmen sollte.
|
||||
{{< /alert >}}
|
||||
|
||||
```toml
|
||||
# config/_default/languages.de.toml
|
||||
|
||||
title = "Meine tolle Website"
|
||||
|
||||
[params.author]
|
||||
name = "Mein Name"
|
||||
image = "img/author.jpg"
|
||||
headline = "Ein grundsätzlich toller Mensch"
|
||||
bio = "Ein bisschen über mich"
|
||||
links = [
|
||||
{ twitter = "https://twitter.com/username" }
|
||||
]
|
||||
```
|
||||
|
||||
Die `[params.author]`-Konfiguration bestimmt, wie die Autoreninformationen auf der Website angezeigt werden. Das Bild sollte im `assets/`-Ordner der Website platziert werden. Links werden in der Reihenfolge angezeigt, in der sie aufgelistet sind.
|
||||
|
||||
Wenn Sie mehr Details benötigen, werden weitere Informationen zu jeder dieser Konfigurationsoptionen im Abschnitt [Konfiguration]({{< ref "configuration" >}}) behandelt.
|
||||
|
||||
## Farbschemata
|
||||
|
||||
Blowfish wird mit einer Reihe von Farbschemata geliefert. Sie können die integrierten Schemata unten ausprobieren:
|
||||
|
||||
{{< theme-switcher >}}
|
||||
|
||||
Jedes Farbschema in Blowfish basiert auf einer Drei-Farben-Palette, die konsistent im gesamten Theme verwendet wird. Jede dieser Hauptfarben basiert auf den Zehn-Stufen-Farbpaletten, die in [Tailwind CSS](https://tailwindcss.com/docs/customizing-colors#color-palette-reference) enthalten sind.
|
||||
|
||||
Obwohl dies die Standardschemata sind, können Sie auch Ihre eigenen erstellen. Weitere Details finden Sie im Abschnitt [Erweiterte Anpassung]({{< ref "advanced-customisation#colour-schemes" >}}).
|
||||
|
||||
## Inhalte organisieren
|
||||
|
||||
Standardmäßig zwingt Blowfish Sie nicht, einen bestimmten Inhaltstyp zu verwenden. So können Sie Ihre Inhalte nach Belieben definieren. Sie bevorzugen vielleicht _Seiten_ für eine statische Website, _Beiträge_ für einen Blog oder _Projekte_ für ein Portfolio.
|
||||
|
||||
Hier ist ein kurzer Überblick über ein grundlegendes Blowfish-Projekt. Alle Inhalte werden im Ordner `content` platziert:
|
||||
|
||||
```shell
|
||||
.
|
||||
├── assets
|
||||
│ └── img
|
||||
│ └── author.jpg
|
||||
├── config
|
||||
│ └── _default
|
||||
├── content
|
||||
│ ├── _index.md
|
||||
│ ├── about.md
|
||||
│ └── posts
|
||||
│ ├── _index.md
|
||||
│ ├── first-post.md
|
||||
│ └── another-post
|
||||
│ ├── aardvark.jpg
|
||||
│ └── index.md
|
||||
└── themes
|
||||
└── blowfish
|
||||
```
|
||||
|
||||
Es ist wichtig, ein gutes Verständnis davon zu haben, wie Hugo erwartet, dass Inhalte organisiert werden, da das Theme darauf ausgelegt ist, die Hugo-Seitenbündel voll auszunutzen. Lesen Sie unbedingt die [offizielle Hugo-Dokumentation](https://gohugo.io/content-management/organization/) für weitere Informationen.
|
||||
|
||||
Blowfish ist auch flexibel, wenn es um Taxonomien geht. Einige Leute bevorzugen _Tags_ und _Kategorien_, um ihre Inhalte zu gruppieren, andere bevorzugen _Themen_.
|
||||
|
||||
Hugo verwendet standardmäßig Posts, Tags und Kategorien, und das funktioniert gut, wenn das ist, was Sie möchten. Wenn Sie dies jedoch anpassen möchten, können Sie dies tun, indem Sie eine `taxonomies.toml`-Konfigurationsdatei erstellen:
|
||||
|
||||
```toml
|
||||
# config/_default/taxonomies.toml
|
||||
|
||||
topic = "topics"
|
||||
```
|
||||
|
||||
Dies ersetzt die Standard-_Tags_ und _Kategorien_ durch _Themen_. Weitere Informationen zur Benennung von Taxonomien finden Sie in der [Hugo-Taxonomie-Dokumentation](https://gohugo.io/content-management/taxonomies/).
|
||||
|
||||
Wenn Sie eine neue Taxonomie erstellen, müssen Sie die Navigationslinks auf der Website anpassen, um auf die richtigen Abschnitte zu verweisen, was unten behandelt wird.
|
||||
|
||||
## Menüs
|
||||
|
||||
Blowfish hat zwei Menüs, die angepasst werden können, um dem Inhalt und Layout Ihrer Website zu entsprechen. Das `main`-Menü erscheint in der Kopfzeile der Website und das `footer`-Menü erscheint unten auf der Seite, direkt über dem Copyright-Hinweis.
|
||||
|
||||
Beide Menüs werden in der Datei `menus.de.toml` konfiguriert. Ähnlich wie bei der Sprachkonfigurationsdatei können Sie diese Datei umbenennen und `de` durch den Sprachcode ersetzen, den Sie verwenden möchten, wenn Sie eine andere Sprache verwenden möchten.
|
||||
|
||||
```toml
|
||||
# config/_default/menus.toml
|
||||
|
||||
[[main]]
|
||||
name = "Blog"
|
||||
pageRef = "posts"
|
||||
weight = 10
|
||||
|
||||
[[main]]
|
||||
name = "Themen"
|
||||
pageRef = "topics"
|
||||
weight = 20
|
||||
|
||||
[[main]]
|
||||
pre = "github"
|
||||
name = "GitHub"
|
||||
url = "https://github.com/nunocoracao/blowfish"
|
||||
weight = 30
|
||||
|
||||
[[main]]
|
||||
identifier = "github2"
|
||||
pre = "github"
|
||||
url = "https://github.com/nunocoracao/blowfish"
|
||||
weight = 40
|
||||
|
||||
[[footer]]
|
||||
name = "Datenschutz"
|
||||
url = "https://external-link"
|
||||
```
|
||||
|
||||
Der Parameter `name` gibt den Text an, der im Menülink verwendet wird. Sie können optional auch einen `title` angeben, der das HTML-Title-Attribut für den Link füllt.
|
||||
|
||||
Der Parameter `pageRef` ermöglicht es Ihnen, einfach auf Hugo-Inhaltsseiten und Taxonomien zu verweisen. Es ist der schnellste Weg, das Menü zu konfigurieren, da Sie einfach auf jedes Hugo-Inhaltselement verweisen können und es automatisch den korrekten Link erstellt. Um auf externe URLs zu verlinken, kann der Parameter `url` verwendet werden.
|
||||
|
||||
Der Parameter `pre` ermöglicht es Ihnen, ein Icon aus [Blowfishs Icon-Set]({{< ref "samples/icons" >}}) im Menüeintrag zu platzieren. Dieser Parameter kann mit dem Parameter `name` oder allein verwendet werden. Wenn Sie mehrere Menüeinträge nur mit Icons verwenden möchten, setzen Sie bitte den Parameter `identifier`, da Hugo sonst den Namenstag als ID verwendet und wahrscheinlich nicht alle Menüeinträge anzeigt.
|
||||
|
||||
Menülinks werden vom niedrigsten zum höchsten `weight` sortiert und dann alphabetisch nach `name`.
|
||||
|
||||
Beide Menüs sind völlig optional und können auskommentiert werden, wenn sie nicht benötigt werden. Verwenden Sie die in der Datei bereitgestellte Vorlage als Leitfaden.
|
||||
|
||||
### Verschachtelte Menüs
|
||||
|
||||
Das Theme unterstützt auch verschachtelte Menüs. Um sie zu verwenden, müssen Sie nur einen übergeordneten Eintrag in `menu.toml` definieren und seine Untermenüs mit dem Parameter `parent` referenzieren. Alle Eigenschaften können für Untermenüs verwendet werden. `pageRef` und `url` können auch im übergeordneten Eintrag verwendet werden. Verschachtelte Menüs sind nur im Hauptmenü verfügbar, nicht für die Fußzeile.
|
||||
|
||||
```toml
|
||||
# config/_default/menus.toml
|
||||
|
||||
[[main]]
|
||||
name = "Übergeordnet"
|
||||
weight = 20
|
||||
|
||||
[[main]]
|
||||
name = "Untermenü 1"
|
||||
parent = "Übergeordnet"
|
||||
pageRef = "samples"
|
||||
weight = 20
|
||||
|
||||
[[main]]
|
||||
name = "Untermenü 2"
|
||||
parent = "Übergeordnet"
|
||||
pageRef = "samples"
|
||||
weight = 20
|
||||
|
||||
[[main]]
|
||||
name = "Untermenü 3"
|
||||
parent = "Übergeordnet"
|
||||
pre = "github"
|
||||
pageRef = "samples"
|
||||
weight = 20
|
||||
```
|
||||
|
||||
### Unternavigationsmenü
|
||||
|
||||
Zusätzlich können Sie auch ein Unternavigationsmenü konfigurieren. Definieren Sie einfach neue Menüeinträge als `subnavigation` in `menus.toml`.
|
||||
Dies rendert eine zweite Zeile mit Unterkategorien unter dem Hauptkopfzeilenmenü.
|
||||
|
||||
```toml
|
||||
# config/_default/menus.toml
|
||||
|
||||
[[subnavigation]]
|
||||
name = "Ein interessantes Thema"
|
||||
pageRef = "tags/interesting-topic"
|
||||
weight = 10
|
||||
|
||||
[[subnavigation]]
|
||||
name = "Meine tolle Kategorie"
|
||||
pageRef = "categories/awesome"
|
||||
weight = 20
|
||||
```
|
||||
|
||||
Der Standard-`name` ist der `pageRef` in Titelschreibweise.
|
||||
|
||||
## Thumbnails & Hintergründe
|
||||
|
||||
Blowfish wurde so entwickelt, dass es einfach ist, visuelle Unterstützung zu Ihren Artikeln hinzuzufügen. Wenn Sie mit der Hugo-Artikelstruktur vertraut sind, müssen Sie nur eine Bilddatei (fast alle Formate werden unterstützt, aber wir empfehlen `.png` oder `.jpg`) in Ihrem Artikelordner platzieren, die mit `feature*` beginnt. Das ist alles, Blowfish kann dann das Bild sowohl als Thumbnail innerhalb Ihrer Website als auch für <a target="_blank" href="https://oembed.com/">oEmbed</a>-Karten auf sozialen Plattformen verwenden.
|
||||
|
||||
[Hier]({{< ref "thumbnails" >}}) finden Sie auch einen Leitfaden mit mehr Informationen und ein [Beispiel]({{< ref "thumbnail_sample" >}}), wenn Sie sehen möchten, wie Sie es machen können.
|
||||
|
||||
Zusätzlich unterstützt Blowfish auch Hintergrund-Heldenbilder in Artikeln und Listen. Um ein anderes Bild als das vorgestellte zu verwenden, fügen Sie eine Bilddatei hinzu, deren Name mit `background*` beginnt.
|
||||
|
||||
## Detaillierte Konfiguration
|
||||
|
||||
Die obigen Schritte sind die Mindestkonfiguration. Wenn Sie jetzt `hugo server` ausführen, wird Ihnen eine leere Blowfish-Website präsentiert. Die detaillierte Konfiguration wird im Abschnitt [Konfiguration]({{< ref "configuration" >}}) behandelt.
|
||||
224
exampleSite/content/docs/getting-started/index.es.md
Normal file
224
exampleSite/content/docs/getting-started/index.es.md
Normal file
@@ -0,0 +1,224 @@
|
||||
---
|
||||
title: "Primeros Pasos"
|
||||
weight: 3
|
||||
draft: false
|
||||
description: "Todas las variables de front matter disponibles en Blowfish."
|
||||
slug: "getting-started"
|
||||
tags: ["instalación", "documentación"]
|
||||
series: ["Documentación"]
|
||||
series_order: 3
|
||||
---
|
||||
|
||||
{{< alert >}}
|
||||
Esta sección asume que ya has [instalado el tema Blowfish]({{< ref "docs/installation" >}}).
|
||||
{{< /alert >}}
|
||||
|
||||
</br>
|
||||
{{< alert "fire" >}}
|
||||
Acabamos de lanzar una herramienta CLI para ayudarte a empezar con Blowfish. Te ayudará con la instalación y configuración. Instala la herramienta CLI globalmente usando:
|
||||
```bash
|
||||
npx blowfish-tools
|
||||
```
|
||||
{{< /alert >}}
|
||||
|
||||
Los archivos de configuración que vienen con Blowfish contienen todas las configuraciones posibles que el tema reconoce. Por defecto, muchas de estas están comentadas, pero puedes simplemente descomentarlas para activar o cambiar una característica específica.
|
||||
|
||||
## Configuración básica
|
||||
|
||||
Antes de crear cualquier contenido, hay algunas cosas que debes configurar para una nueva instalación. Comenzando en el archivo `hugo.toml`, establece los parámetros `baseURL` y `languageCode`. El `languageCode` debe configurarse con el idioma principal que usarás para escribir tu contenido.
|
||||
|
||||
```toml
|
||||
# config/_default/hugo.toml
|
||||
|
||||
baseURL = "https://your_domain.com/"
|
||||
languageCode = "es"
|
||||
```
|
||||
|
||||
El siguiente paso es configurar los ajustes de idioma. Aunque Blowfish admite configuraciones multilingües, por ahora, solo configura el idioma principal.
|
||||
|
||||
Localiza el archivo `languages.en.toml` en la carpeta de configuración. Si tu idioma principal es el inglés, puedes usar este archivo tal cual. De lo contrario, renómbralo para que incluya el código de idioma correcto en el nombre del archivo. Por ejemplo, para español, renombra el archivo a `languages.es.toml`.
|
||||
|
||||
{{< alert >}}
|
||||
Ten en cuenta que el código de idioma en el nombre del archivo de configuración de idioma debe coincidir con la configuración `languageCode` en `hugo.toml`.
|
||||
{{< /alert >}}
|
||||
|
||||
```toml
|
||||
# config/_default/languages.es.toml
|
||||
|
||||
title = "Mi sitio web increíble"
|
||||
|
||||
[params.author]
|
||||
name = "Mi nombre"
|
||||
image = "img/author.jpg"
|
||||
headline = "Un ser humano generalmente increíble"
|
||||
bio = "Un poco sobre mí"
|
||||
links = [
|
||||
{ twitter = "https://twitter.com/username" }
|
||||
]
|
||||
```
|
||||
|
||||
La configuración `[params.author]` determina cómo se muestra la información del autor en el sitio web. La imagen debe colocarse en la carpeta `assets/` del sitio. Los enlaces se mostrarán en el orden en que están listados.
|
||||
|
||||
Si necesitas más detalles, se cubre información adicional sobre cada una de estas opciones de configuración en la sección [Configuración]({{< ref "configuration" >}}).
|
||||
|
||||
## Esquemas de colores
|
||||
|
||||
Blowfish viene con varios esquemas de colores listos para usar. Puedes probar los esquemas integrados a continuación:
|
||||
|
||||
{{< theme-switcher >}}
|
||||
|
||||
Cada esquema de colores en Blowfish está construido sobre una paleta de tres colores que se usa consistentemente en todo el tema. Cada uno de estos colores principales está basado en las paletas de colores de diez tonos incluidas en [Tailwind CSS](https://tailwindcss.com/docs/customizing-colors#color-palette-reference).
|
||||
|
||||
Aunque estos son los esquemas predeterminados, también puedes crear los tuyos propios. Consulta la sección [Personalización Avanzada]({{< ref "advanced-customisation#colour-schemes" >}}) para más detalles.
|
||||
|
||||
## Organización del contenido
|
||||
|
||||
Por defecto, Blowfish no te obliga a usar un tipo de contenido particular. Al hacerlo, eres libre de definir tu contenido como desees. Podrías preferir _páginas_ para un sitio estático, _publicaciones_ para un blog, o _proyectos_ para un portafolio.
|
||||
|
||||
Aquí hay una descripción general rápida de un proyecto Blowfish básico. Todo el contenido se coloca dentro de la carpeta `content`:
|
||||
|
||||
```shell
|
||||
.
|
||||
├── assets
|
||||
│ └── img
|
||||
│ └── author.jpg
|
||||
├── config
|
||||
│ └── _default
|
||||
├── content
|
||||
│ ├── _index.md
|
||||
│ ├── about.md
|
||||
│ └── posts
|
||||
│ ├── _index.md
|
||||
│ ├── first-post.md
|
||||
│ └── another-post
|
||||
│ ├── aardvark.jpg
|
||||
│ └── index.md
|
||||
└── themes
|
||||
└── blowfish
|
||||
```
|
||||
|
||||
Es importante tener una comprensión firme de cómo Hugo espera que se organice el contenido, ya que el tema está diseñado para aprovechar al máximo los bundles de páginas de Hugo. Asegúrate de leer la [documentación oficial de Hugo](https://gohugo.io/content-management/organization/) para más información.
|
||||
|
||||
Blowfish también es flexible cuando se trata de taxonomías. Algunas personas prefieren usar _tags_ y _categorías_ para agrupar su contenido, otros prefieren usar _temas_.
|
||||
|
||||
Hugo usa por defecto posts, tags y categorías, y esto funcionará bien si eso es lo que quieres. Sin embargo, si deseas personalizar esto, puedes hacerlo creando un archivo de configuración `taxonomies.toml`:
|
||||
|
||||
```toml
|
||||
# config/_default/taxonomies.toml
|
||||
|
||||
topic = "topics"
|
||||
```
|
||||
|
||||
Esto reemplazará los _tags_ y _categorías_ predeterminados con _temas_. Consulta la [documentación de taxonomías de Hugo](https://gohugo.io/content-management/taxonomies/) para más información sobre cómo nombrar taxonomías.
|
||||
|
||||
Cuando creas una nueva taxonomía, necesitarás ajustar los enlaces de navegación en el sitio web para apuntar a las secciones correctas, lo cual se cubre a continuación.
|
||||
|
||||
## Menús
|
||||
|
||||
Blowfish tiene dos menús que se pueden personalizar para adaptarse al contenido y diseño de tu sitio. El menú `main` aparece en el encabezado del sitio y el menú `footer` aparece en la parte inferior de la página justo antes del aviso de copyright.
|
||||
|
||||
Ambos menús se configuran en el archivo `menus.es.toml`. De manera similar al archivo de configuración de idiomas, si deseas usar otro idioma, renombra este archivo y reemplaza `en` con el código de idioma que deseas usar.
|
||||
|
||||
```toml
|
||||
# config/_default/menus.toml
|
||||
|
||||
[[main]]
|
||||
name = "Blog"
|
||||
pageRef = "posts"
|
||||
weight = 10
|
||||
|
||||
[[main]]
|
||||
name = "Temas"
|
||||
pageRef = "topics"
|
||||
weight = 20
|
||||
|
||||
[[main]]
|
||||
pre = "github"
|
||||
name = "GitHub"
|
||||
url = "https://github.com/nunocoracao/blowfish"
|
||||
weight = 30
|
||||
|
||||
[[main]]
|
||||
identifier = "github2"
|
||||
pre = "github"
|
||||
url = "https://github.com/nunocoracao/blowfish"
|
||||
weight = 40
|
||||
|
||||
[[footer]]
|
||||
name = "Privacidad"
|
||||
url = "https://external-link"
|
||||
```
|
||||
|
||||
El parámetro `name` especifica el texto que se usa en el enlace del menú. También puedes proporcionar opcionalmente un `title` que llena el atributo title HTML para el enlace.
|
||||
|
||||
El parámetro `pageRef` te permite referenciar fácilmente páginas de contenido y taxonomías de Hugo. Es la forma más rápida de configurar el menú ya que puedes simplemente referirte a cualquier elemento de contenido de Hugo y automáticamente construirá el enlace correcto. Para enlazar a URLs externas, se puede usar el parámetro `url`.
|
||||
|
||||
El parámetro `pre` te permite colocar un icono del [conjunto de iconos de Blowfish]({{< ref "samples/icons" >}}) en la entrada del menú. Este parámetro se puede usar con el parámetro `name` o por sí solo. Si quieres usar múltiples entradas de menú con solo iconos, por favor establece el parámetro `identifier`, de lo contrario Hugo usará por defecto el tag de nombre como id y probablemente no mostrará todas las entradas del menú.
|
||||
|
||||
Los enlaces del menú se ordenarán del `weight` más bajo al más alto, y luego alfabéticamente por `name`.
|
||||
|
||||
Ambos menús son completamente opcionales y pueden comentarse si no se necesitan. Usa la plantilla proporcionada en el archivo como guía.
|
||||
|
||||
### Menús anidados
|
||||
|
||||
El tema también admite menús anidados. Para usarlos, solo necesitas definir una entrada padre en `menu.toml` y sus submenús usando el parámetro `parent` para referenciar al padre. Todas las propiedades se pueden usar para submenús. `pageRef` y `url` también se pueden usar en la entrada padre. Los menús anidados solo están disponibles en el menú principal, no para el pie de página.
|
||||
|
||||
```toml
|
||||
# config/_default/menus.toml
|
||||
|
||||
[[main]]
|
||||
name = "Padre"
|
||||
weight = 20
|
||||
|
||||
[[main]]
|
||||
name = "sub-menú 1"
|
||||
parent = "Padre"
|
||||
pageRef = "samples"
|
||||
weight = 20
|
||||
|
||||
[[main]]
|
||||
name = "sub-menú 2"
|
||||
parent = "Padre"
|
||||
pageRef = "samples"
|
||||
weight = 20
|
||||
|
||||
[[main]]
|
||||
name = "sub-menú 3"
|
||||
parent = "Padre"
|
||||
pre = "github"
|
||||
pageRef = "samples"
|
||||
weight = 20
|
||||
```
|
||||
|
||||
### Menú de sub-navegación
|
||||
|
||||
Adicionalmente, también puedes configurar un menú de sub-navegación. Solo define nuevas entradas de menú como `subnavigation` en `menus.toml`.
|
||||
Esto renderizará una segunda línea con subcategorías debajo del menú principal del encabezado.
|
||||
|
||||
```toml
|
||||
# config/_default/menus.toml
|
||||
|
||||
[[subnavigation]]
|
||||
name = "Un tema interesante"
|
||||
pageRef = "tags/interesting-topic"
|
||||
weight = 10
|
||||
|
||||
[[subnavigation]]
|
||||
name = "Mi categoría increíble"
|
||||
pageRef = "categories/awesome"
|
||||
weight = 20
|
||||
```
|
||||
|
||||
El `name` predeterminado es el `pageRef` en formato de título.
|
||||
|
||||
## Miniaturas y Fondos
|
||||
|
||||
Blowfish fue construido para que sea fácil agregar soporte visual a tus artículos. Si estás familiarizado con la estructura de artículos de Hugo, solo necesitas colocar un archivo de imagen (casi todos los formatos son compatibles pero recomendamos `.png` o `.jpg`) que comience con `feature*` dentro de tu carpeta de artículo. Y eso es todo, Blowfish podrá usar la imagen tanto como miniatura dentro de tu sitio web como para tarjetas <a target="_blank" href="https://oembed.com/">oEmbed</a> en plataformas sociales.
|
||||
|
||||
[Aquí]({{< ref "thumbnails" >}}) también hay una guía con más información y un [ejemplo]({{< ref "thumbnail_sample" >}}) si quieres ver cómo puedes hacerlo.
|
||||
|
||||
Adicionalmente, Blowfish también admite imágenes hero de fondo en artículos y listas. Para usar una imagen diferente a la destacada, agrega un archivo de imagen cuyo nombre comience con `background*`.
|
||||
|
||||
## Configuración detallada
|
||||
|
||||
Los pasos anteriores son la configuración mínima. Si ahora ejecutas `hugo server` se te presentará un sitio web Blowfish en blanco. La configuración detallada se cubre en la sección [Configuración]({{< ref "configuration" >}}).
|
||||
224
exampleSite/content/docs/getting-started/index.fr.md
Normal file
224
exampleSite/content/docs/getting-started/index.fr.md
Normal file
@@ -0,0 +1,224 @@
|
||||
---
|
||||
title: "Premiers Pas"
|
||||
weight: 3
|
||||
draft: false
|
||||
description: "Toutes les variables front matter disponibles dans Blowfish."
|
||||
slug: "getting-started"
|
||||
tags: ["installation", "documentation"]
|
||||
series: ["Documentation"]
|
||||
series_order: 3
|
||||
---
|
||||
|
||||
{{< alert >}}
|
||||
Cette section suppose que vous avez déjà [installé le thème Blowfish]({{< ref "docs/installation" >}}).
|
||||
{{< /alert >}}
|
||||
|
||||
</br>
|
||||
{{< alert "fire" >}}
|
||||
Nous venons de lancer un outil CLI pour vous aider à démarrer avec Blowfish. Il vous aidera avec l'installation et la configuration. Installez l'outil CLI globalement en utilisant :
|
||||
```bash
|
||||
npx blowfish-tools
|
||||
```
|
||||
{{< /alert >}}
|
||||
|
||||
Les fichiers de configuration livrés avec Blowfish contiennent tous les paramètres possibles que le thème reconnaît. Par défaut, beaucoup d'entre eux sont commentés, mais vous pouvez simplement les décommenter pour activer ou modifier une fonctionnalité spécifique.
|
||||
|
||||
## Configuration de base
|
||||
|
||||
Avant de créer du contenu, il y a quelques éléments à définir pour une nouvelle installation. En commençant par le fichier `hugo.toml`, définissez les paramètres `baseURL` et `languageCode`. Le `languageCode` doit être défini sur la langue principale que vous utiliserez pour rédiger votre contenu.
|
||||
|
||||
```toml
|
||||
# config/_default/hugo.toml
|
||||
|
||||
baseURL = "https://your_domain.com/"
|
||||
languageCode = "fr"
|
||||
```
|
||||
|
||||
L'étape suivante consiste à configurer les paramètres de langue. Bien que Blowfish prenne en charge les configurations multilingues, pour l'instant, configurez simplement la langue principale.
|
||||
|
||||
Localisez le fichier `languages.en.toml` dans le dossier de configuration. Si votre langue principale est l'anglais, vous pouvez utiliser ce fichier tel quel. Sinon, renommez-le pour qu'il inclue le code de langue correct dans le nom du fichier. Par exemple, pour le français, renommez le fichier en `languages.fr.toml`.
|
||||
|
||||
{{< alert >}}
|
||||
Notez que le code de langue dans le nom du fichier de configuration de langue doit correspondre au paramètre `languageCode` dans `hugo.toml`.
|
||||
{{< /alert >}}
|
||||
|
||||
```toml
|
||||
# config/_default/languages.fr.toml
|
||||
|
||||
title = "Mon super site web"
|
||||
|
||||
[params.author]
|
||||
name = "Mon nom"
|
||||
image = "img/author.jpg"
|
||||
headline = "Un être humain généralement génial"
|
||||
bio = "Un peu sur moi"
|
||||
links = [
|
||||
{ twitter = "https://twitter.com/username" }
|
||||
]
|
||||
```
|
||||
|
||||
La configuration `[params.author]` détermine comment les informations de l'auteur sont affichées sur le site. L'image doit être placée dans le dossier `assets/` du site. Les liens seront affichés dans l'ordre où ils sont listés.
|
||||
|
||||
Si vous avez besoin de plus de détails, des informations supplémentaires sur chacune de ces options de configuration sont couvertes dans la section [Configuration]({{< ref "configuration" >}}).
|
||||
|
||||
## Schémas de couleurs
|
||||
|
||||
Blowfish est livré avec plusieurs schémas de couleurs prêts à l'emploi. Vous pouvez essayer les schémas intégrés ci-dessous :
|
||||
|
||||
{{< theme-switcher >}}
|
||||
|
||||
Chaque schéma de couleurs dans Blowfish est construit sur une palette de trois couleurs utilisée de manière cohérente dans tout le thème. Chacune de ces couleurs principales est basée sur les palettes de couleurs à dix nuances incluses dans [Tailwind CSS](https://tailwindcss.com/docs/customizing-colors#color-palette-reference).
|
||||
|
||||
Bien que ce soient les schémas par défaut, vous pouvez également créer les vôtres. Consultez la section [Personnalisation avancée]({{< ref "advanced-customisation#colour-schemes" >}}) pour plus de détails.
|
||||
|
||||
## Organisation du contenu
|
||||
|
||||
Par défaut, Blowfish ne vous oblige pas à utiliser un type de contenu particulier. Ce faisant, vous êtes libre de définir votre contenu comme vous le souhaitez. Vous pourriez préférer des _pages_ pour un site statique, des _articles_ pour un blog, ou des _projets_ pour un portfolio.
|
||||
|
||||
Voici un aperçu rapide d'un projet Blowfish de base. Tout le contenu est placé dans le dossier `content` :
|
||||
|
||||
```shell
|
||||
.
|
||||
├── assets
|
||||
│ └── img
|
||||
│ └── author.jpg
|
||||
├── config
|
||||
│ └── _default
|
||||
├── content
|
||||
│ ├── _index.md
|
||||
│ ├── about.md
|
||||
│ └── posts
|
||||
│ ├── _index.md
|
||||
│ ├── first-post.md
|
||||
│ └── another-post
|
||||
│ ├── aardvark.jpg
|
||||
│ └── index.md
|
||||
└── themes
|
||||
└── blowfish
|
||||
```
|
||||
|
||||
Il est important d'avoir une bonne compréhension de la façon dont Hugo s'attend à ce que le contenu soit organisé, car le thème est conçu pour tirer pleinement parti des bundles de pages Hugo. Assurez-vous de lire la [documentation officielle Hugo](https://gohugo.io/content-management/organization/) pour plus d'informations.
|
||||
|
||||
Blowfish est également flexible en ce qui concerne les taxonomies. Certaines personnes préfèrent utiliser des _tags_ et des _catégories_ pour regrouper leur contenu, d'autres préfèrent utiliser des _sujets_.
|
||||
|
||||
Hugo utilise par défaut les posts, tags et catégories, et cela fonctionnera bien si c'est ce que vous voulez. Si vous souhaitez personnaliser cela, vous pouvez le faire en créant un fichier de configuration `taxonomies.toml` :
|
||||
|
||||
```toml
|
||||
# config/_default/taxonomies.toml
|
||||
|
||||
topic = "topics"
|
||||
```
|
||||
|
||||
Cela remplacera les _tags_ et _catégories_ par défaut par des _sujets_. Consultez la [documentation des taxonomies Hugo](https://gohugo.io/content-management/taxonomies/) pour plus d'informations sur la dénomination des taxonomies.
|
||||
|
||||
Lorsque vous créez une nouvelle taxonomie, vous devrez ajuster les liens de navigation sur le site pour pointer vers les bonnes sections, ce qui est couvert ci-dessous.
|
||||
|
||||
## Menus
|
||||
|
||||
Blowfish dispose de deux menus qui peuvent être personnalisés pour s'adapter au contenu et à la mise en page de votre site. Le menu `main` apparaît dans l'en-tête du site et le menu `footer` apparaît en bas de la page, juste avant la mention de copyright.
|
||||
|
||||
Les deux menus sont configurés dans le fichier `menus.fr.toml`. De même que pour le fichier de configuration de langue, si vous souhaitez utiliser une autre langue, renommez ce fichier et remplacez `en` par le code de langue que vous souhaitez utiliser.
|
||||
|
||||
```toml
|
||||
# config/_default/menus.toml
|
||||
|
||||
[[main]]
|
||||
name = "Blog"
|
||||
pageRef = "posts"
|
||||
weight = 10
|
||||
|
||||
[[main]]
|
||||
name = "Sujets"
|
||||
pageRef = "topics"
|
||||
weight = 20
|
||||
|
||||
[[main]]
|
||||
pre = "github"
|
||||
name = "GitHub"
|
||||
url = "https://github.com/nunocoracao/blowfish"
|
||||
weight = 30
|
||||
|
||||
[[main]]
|
||||
identifier = "github2"
|
||||
pre = "github"
|
||||
url = "https://github.com/nunocoracao/blowfish"
|
||||
weight = 40
|
||||
|
||||
[[footer]]
|
||||
name = "Confidentialité"
|
||||
url = "https://external-link"
|
||||
```
|
||||
|
||||
Le paramètre `name` spécifie le texte utilisé dans le lien du menu. Vous pouvez également fournir optionnellement un `title` qui remplit l'attribut title HTML pour le lien.
|
||||
|
||||
Le paramètre `pageRef` vous permet de référencer facilement les pages de contenu Hugo et les taxonomies. C'est le moyen le plus rapide de configurer le menu car vous pouvez simplement faire référence à n'importe quel élément de contenu Hugo et il construira automatiquement le lien correct. Pour créer des liens vers des URL externes, le paramètre `url` peut être utilisé.
|
||||
|
||||
Le paramètre `pre` vous permet de placer une icône du [jeu d'icônes de Blowfish]({{< ref "samples/icons" >}}) sur l'entrée de menu. Ce paramètre peut être utilisé avec le paramètre `name` ou seul. Si vous souhaitez utiliser plusieurs entrées de menu avec seulement des icônes, veuillez définir le paramètre `identifier` sinon Hugo utilisera par défaut le tag de nommage comme id et n'affichera probablement pas toutes les entrées de menu.
|
||||
|
||||
Les liens de menu seront triés du poids le plus bas au plus élevé, puis par ordre alphabétique de `name`.
|
||||
|
||||
Les deux menus sont entièrement optionnels et peuvent être commentés s'ils ne sont pas nécessaires. Utilisez le modèle fourni dans le fichier comme guide.
|
||||
|
||||
### Menus imbriqués
|
||||
|
||||
Le thème prend également en charge les menus imbriqués. Pour les utiliser, il vous suffit de définir une entrée parent dans `menu.toml` et ses sous-menus en utilisant le paramètre `parent` pour référencer le parent. Toutes les propriétés peuvent être utilisées pour les sous-menus. `pageRef` et `url` peuvent également être utilisés dans l'entrée parent. Les menus imbriqués ne sont disponibles que dans le menu principal, pas pour le pied de page.
|
||||
|
||||
```toml
|
||||
# config/_default/menus.toml
|
||||
|
||||
[[main]]
|
||||
name = "Parent"
|
||||
weight = 20
|
||||
|
||||
[[main]]
|
||||
name = "sous-menu 1"
|
||||
parent = "Parent"
|
||||
pageRef = "samples"
|
||||
weight = 20
|
||||
|
||||
[[main]]
|
||||
name = "sous-menu 2"
|
||||
parent = "Parent"
|
||||
pageRef = "samples"
|
||||
weight = 20
|
||||
|
||||
[[main]]
|
||||
name = "sous-menu 3"
|
||||
parent = "Parent"
|
||||
pre = "github"
|
||||
pageRef = "samples"
|
||||
weight = 20
|
||||
```
|
||||
|
||||
### Menu de sous-navigation
|
||||
|
||||
De plus, vous pouvez également configurer un menu de sous-navigation. Définissez simplement de nouvelles entrées de menu comme `subnavigation` dans `menus.toml`.
|
||||
Cela affichera une deuxième ligne avec des sous-catégories sous le menu d'en-tête principal.
|
||||
|
||||
```toml
|
||||
# config/_default/menus.toml
|
||||
|
||||
[[subnavigation]]
|
||||
name = "Un sujet intéressant"
|
||||
pageRef = "tags/interesting-topic"
|
||||
weight = 10
|
||||
|
||||
[[subnavigation]]
|
||||
name = "Ma catégorie géniale"
|
||||
pageRef = "categories/awesome"
|
||||
weight = 20
|
||||
```
|
||||
|
||||
Le `name` par défaut est le `pageRef` en majuscules.
|
||||
|
||||
## Vignettes et arrière-plans
|
||||
|
||||
Blowfish a été conçu pour qu'il soit facile d'ajouter un support visuel à vos articles. Si vous êtes familier avec la structure des articles Hugo, il vous suffit de placer un fichier image (presque tous les formats sont pris en charge mais nous recommandons `.png` ou `.jpg`) qui commence par `feature*` dans votre dossier d'article. Et c'est tout, Blowfish pourra alors utiliser l'image à la fois comme vignette sur votre site et pour les cartes <a target="_blank" href="https://oembed.com/">oEmbed</a> sur les plateformes sociales.
|
||||
|
||||
[Voici]({{< ref "thumbnails" >}}) également un guide avec plus d'informations et un [exemple]({{< ref "thumbnail_sample" >}}) si vous voulez voir comment vous pouvez le faire.
|
||||
|
||||
De plus, Blowfish prend également en charge les images hero d'arrière-plan dans les articles et les listes. Pour utiliser une image différente de celle mise en avant, ajoutez un fichier image dont le nom commence par `background*`.
|
||||
|
||||
## Configuration détaillée
|
||||
|
||||
Les étapes ci-dessus sont la configuration minimale. Si vous exécutez maintenant `hugo server`, vous obtiendrez un site Blowfish vierge. La configuration détaillée est couverte dans la section [Configuration]({{< ref "configuration" >}}).
|
||||
224
exampleSite/content/docs/getting-started/index.pt-br.md
Normal file
224
exampleSite/content/docs/getting-started/index.pt-br.md
Normal file
@@ -0,0 +1,224 @@
|
||||
---
|
||||
title: "Primeiros Passos"
|
||||
weight: 3
|
||||
draft: false
|
||||
description: "Todas as variáveis de front matter disponíveis no Blowfish."
|
||||
slug: "getting-started"
|
||||
tags: ["instalação", "documentação"]
|
||||
series: ["Documentação"]
|
||||
series_order: 3
|
||||
---
|
||||
|
||||
{{< alert >}}
|
||||
Esta seção assume que você já [instalou o tema Blowfish]({{< ref "docs/installation" >}}).
|
||||
{{< /alert >}}
|
||||
|
||||
</br>
|
||||
{{< alert "fire" >}}
|
||||
Acabamos de lançar uma ferramenta CLI para ajudá-lo a começar com o Blowfish. Ela ajudará com a instalação e configuração. Instale a ferramenta CLI globalmente usando:
|
||||
```bash
|
||||
npx blowfish-tools
|
||||
```
|
||||
{{< /alert >}}
|
||||
|
||||
Os arquivos de configuração que acompanham o Blowfish contêm todas as configurações possíveis que o tema reconhece. Por padrão, muitas delas estão comentadas, mas você pode simplesmente descomentá-las para ativar ou alterar uma funcionalidade específica.
|
||||
|
||||
## Configuração básica
|
||||
|
||||
Antes de criar qualquer conteúdo, há algumas coisas que você deve configurar para uma nova instalação. Começando no arquivo `hugo.toml`, defina os parâmetros `baseURL` e `languageCode`. O `languageCode` deve ser definido para o idioma principal que você usará para escrever seu conteúdo.
|
||||
|
||||
```toml
|
||||
# config/_default/hugo.toml
|
||||
|
||||
baseURL = "https://your_domain.com/"
|
||||
languageCode = "pt-br"
|
||||
```
|
||||
|
||||
O próximo passo é configurar as definições de idioma. Embora o Blowfish suporte configurações multilíngues, por enquanto, apenas configure o idioma principal.
|
||||
|
||||
Localize o arquivo `languages.en.toml` na pasta de configuração. Se seu idioma principal for inglês, você pode usar este arquivo como está. Caso contrário, renomeie-o para incluir o código de idioma correto no nome do arquivo. Por exemplo, para português brasileiro, renomeie o arquivo para `languages.pt-br.toml`.
|
||||
|
||||
{{< alert >}}
|
||||
Note que o código de idioma no nome do arquivo de configuração de idioma deve corresponder à configuração `languageCode` em `hugo.toml`.
|
||||
{{< /alert >}}
|
||||
|
||||
```toml
|
||||
# config/_default/languages.pt-br.toml
|
||||
|
||||
title = "Meu site incrível"
|
||||
|
||||
[params.author]
|
||||
name = "Meu nome"
|
||||
image = "img/author.jpg"
|
||||
headline = "Um ser humano geralmente incrível"
|
||||
bio = "Um pouco sobre mim"
|
||||
links = [
|
||||
{ twitter = "https://twitter.com/username" }
|
||||
]
|
||||
```
|
||||
|
||||
A configuração `[params.author]` determina como as informações do autor são exibidas no site. A imagem deve ser colocada na pasta `assets/` do site. Os links serão exibidos na ordem em que estão listados.
|
||||
|
||||
Se você precisar de mais detalhes, informações adicionais sobre cada uma dessas opções de configuração são cobertas na seção [Configuração]({{< ref "configuration" >}}).
|
||||
|
||||
## Esquemas de cores
|
||||
|
||||
O Blowfish vem com vários esquemas de cores prontos para uso. Você pode experimentar os esquemas integrados abaixo:
|
||||
|
||||
{{< theme-switcher >}}
|
||||
|
||||
Cada esquema de cores no Blowfish é construído sobre uma paleta de três cores que é usada consistentemente em todo o tema. Cada uma dessas cores principais é baseada nas paletas de cores de dez tons incluídas no [Tailwind CSS](https://tailwindcss.com/docs/customizing-colors#color-palette-reference).
|
||||
|
||||
Embora esses sejam os esquemas padrão, você também pode criar os seus próprios. Consulte a seção [Personalização Avançada]({{< ref "advanced-customisation#colour-schemes" >}}) para mais detalhes.
|
||||
|
||||
## Organizando conteúdo
|
||||
|
||||
Por padrão, o Blowfish não força você a usar um tipo de conteúdo específico. Ao fazer isso, você é livre para definir seu conteúdo como desejar. Você pode preferir _páginas_ para um site estático, _posts_ para um blog, ou _projetos_ para um portfólio.
|
||||
|
||||
Aqui está uma visão geral rápida de um projeto Blowfish básico. Todo o conteúdo é colocado dentro da pasta `content`:
|
||||
|
||||
```shell
|
||||
.
|
||||
├── assets
|
||||
│ └── img
|
||||
│ └── author.jpg
|
||||
├── config
|
||||
│ └── _default
|
||||
├── content
|
||||
│ ├── _index.md
|
||||
│ ├── about.md
|
||||
│ └── posts
|
||||
│ ├── _index.md
|
||||
│ ├── first-post.md
|
||||
│ └── another-post
|
||||
│ ├── aardvark.jpg
|
||||
│ └── index.md
|
||||
└── themes
|
||||
└── blowfish
|
||||
```
|
||||
|
||||
É importante ter uma compreensão firme de como o Hugo espera que o conteúdo seja organizado, pois o tema é projetado para aproveitar ao máximo os bundles de páginas do Hugo. Certifique-se de ler a [documentação oficial do Hugo](https://gohugo.io/content-management/organization/) para mais informações.
|
||||
|
||||
O Blowfish também é flexível quando se trata de taxonomias. Algumas pessoas preferem usar _tags_ e _categorias_ para agrupar seu conteúdo, outras preferem usar _tópicos_.
|
||||
|
||||
O Hugo usa por padrão posts, tags e categorias, e isso funcionará bem se é isso que você quer. Se você deseja personalizar isso, no entanto, pode fazê-lo criando um arquivo de configuração `taxonomies.toml`:
|
||||
|
||||
```toml
|
||||
# config/_default/taxonomies.toml
|
||||
|
||||
topic = "topics"
|
||||
```
|
||||
|
||||
Isso substituirá os _tags_ e _categorias_ padrão por _tópicos_. Consulte a [documentação de taxonomias do Hugo](https://gohugo.io/content-management/taxonomies/) para mais informações sobre como nomear taxonomias.
|
||||
|
||||
Quando você cria uma nova taxonomia, precisará ajustar os links de navegação no site para apontar para as seções corretas, o que é coberto abaixo.
|
||||
|
||||
## Menus
|
||||
|
||||
O Blowfish tem dois menus que podem ser personalizados para se adequar ao conteúdo e layout do seu site. O menu `main` aparece no cabeçalho do site e o menu `footer` aparece na parte inferior da página, logo antes do aviso de copyright.
|
||||
|
||||
Ambos os menus são configurados no arquivo `menus.pt-br.toml`. De forma semelhante ao arquivo de configuração de idiomas, se você deseja usar outro idioma, renomeie este arquivo e substitua `en` pelo código de idioma que deseja usar.
|
||||
|
||||
```toml
|
||||
# config/_default/menus.toml
|
||||
|
||||
[[main]]
|
||||
name = "Blog"
|
||||
pageRef = "posts"
|
||||
weight = 10
|
||||
|
||||
[[main]]
|
||||
name = "Tópicos"
|
||||
pageRef = "topics"
|
||||
weight = 20
|
||||
|
||||
[[main]]
|
||||
pre = "github"
|
||||
name = "GitHub"
|
||||
url = "https://github.com/nunocoracao/blowfish"
|
||||
weight = 30
|
||||
|
||||
[[main]]
|
||||
identifier = "github2"
|
||||
pre = "github"
|
||||
url = "https://github.com/nunocoracao/blowfish"
|
||||
weight = 40
|
||||
|
||||
[[footer]]
|
||||
name = "Privacidade"
|
||||
url = "https://external-link"
|
||||
```
|
||||
|
||||
O parâmetro `name` especifica o texto que é usado no link do menu. Você também pode opcionalmente fornecer um `title` que preenche o atributo title HTML para o link.
|
||||
|
||||
O parâmetro `pageRef` permite que você faça referência facilmente a páginas de conteúdo e taxonomias do Hugo. É a maneira mais rápida de configurar o menu, pois você pode simplesmente se referir a qualquer item de conteúdo do Hugo e ele automaticamente construirá o link correto. Para vincular a URLs externos, o parâmetro `url` pode ser usado.
|
||||
|
||||
O parâmetro `pre` permite que você coloque um ícone do [conjunto de ícones do Blowfish]({{< ref "samples/icons" >}}) na entrada do menu. Este parâmetro pode ser usado com o parâmetro `name` ou sozinho. Se você quiser usar várias entradas de menu apenas com ícones, por favor defina o parâmetro `identifier`, caso contrário o Hugo usará por padrão a tag de nome como id e provavelmente não exibirá todas as entradas do menu.
|
||||
|
||||
Os links do menu serão ordenados do menor para o maior `weight`, e depois alfabeticamente por `name`.
|
||||
|
||||
Ambos os menus são completamente opcionais e podem ser comentados se não forem necessários. Use o modelo fornecido no arquivo como guia.
|
||||
|
||||
### Menus aninhados
|
||||
|
||||
O tema também suporta menus aninhados. Para usá-los, você só precisa definir uma entrada pai em `menu.toml` e seus submenus usando o parâmetro `parent` para referenciar o pai. Todas as propriedades podem ser usadas para submenus. `pageRef` e `url` também podem ser usados na entrada pai. Menus aninhados estão disponíveis apenas no menu principal, não para o rodapé.
|
||||
|
||||
```toml
|
||||
# config/_default/menus.toml
|
||||
|
||||
[[main]]
|
||||
name = "Pai"
|
||||
weight = 20
|
||||
|
||||
[[main]]
|
||||
name = "sub-menu 1"
|
||||
parent = "Pai"
|
||||
pageRef = "samples"
|
||||
weight = 20
|
||||
|
||||
[[main]]
|
||||
name = "sub-menu 2"
|
||||
parent = "Pai"
|
||||
pageRef = "samples"
|
||||
weight = 20
|
||||
|
||||
[[main]]
|
||||
name = "sub-menu 3"
|
||||
parent = "Pai"
|
||||
pre = "github"
|
||||
pageRef = "samples"
|
||||
weight = 20
|
||||
```
|
||||
|
||||
### Menu de sub-navegação
|
||||
|
||||
Adicionalmente, você também pode configurar um menu de sub-navegação. Basta definir novas entradas de menu como `subnavigation` em `menus.toml`.
|
||||
Isso renderizará uma segunda linha com subcategorias abaixo do menu principal do cabeçalho.
|
||||
|
||||
```toml
|
||||
# config/_default/menus.toml
|
||||
|
||||
[[subnavigation]]
|
||||
name = "Um tópico interessante"
|
||||
pageRef = "tags/interesting-topic"
|
||||
weight = 10
|
||||
|
||||
[[subnavigation]]
|
||||
name = "Minha categoria incrível"
|
||||
pageRef = "categories/awesome"
|
||||
weight = 20
|
||||
```
|
||||
|
||||
O `name` padrão é o `pageRef` em formato de título.
|
||||
|
||||
## Miniaturas e Fundos
|
||||
|
||||
O Blowfish foi construído para facilitar a adição de suporte visual aos seus artigos. Se você está familiarizado com a estrutura de artigos do Hugo, basta colocar um arquivo de imagem (quase todos os formatos são suportados, mas recomendamos `.png` ou `.jpg`) que comece com `feature*` dentro da pasta do seu artigo. E é isso, o Blowfish poderá então usar a imagem tanto como miniatura dentro do seu site quanto para cartões <a target="_blank" href="https://oembed.com/">oEmbed</a> em plataformas sociais.
|
||||
|
||||
[Aqui]({{< ref "thumbnails" >}}) também há um guia com mais informações e um [exemplo]({{< ref "thumbnail_sample" >}}) se você quiser ver como pode fazer isso.
|
||||
|
||||
Adicionalmente, o Blowfish também suporta imagens hero de fundo em artigos e listas. Para usar uma imagem diferente da destacada, adicione um arquivo de imagem cujo nome comece com `background*`.
|
||||
|
||||
## Configuração detalhada
|
||||
|
||||
Os passos acima são a configuração mínima. Se você agora executar `hugo server`, será apresentado um site Blowfish em branco. A configuração detalhada é coberta na seção [Configuração]({{< ref "configuration" >}}).
|
||||
224
exampleSite/content/docs/getting-started/index.pt-pt.md
Normal file
224
exampleSite/content/docs/getting-started/index.pt-pt.md
Normal file
@@ -0,0 +1,224 @@
|
||||
---
|
||||
title: "Primeiros Passos"
|
||||
weight: 3
|
||||
draft: false
|
||||
description: "Todas as variáveis de front matter disponíveis no Blowfish."
|
||||
slug: "getting-started"
|
||||
tags: ["instalação", "documentação"]
|
||||
series: ["Documentação"]
|
||||
series_order: 3
|
||||
---
|
||||
|
||||
{{< alert >}}
|
||||
Esta secção assume que já [instalou o tema Blowfish]({{< ref "docs/installation" >}}).
|
||||
{{< /alert >}}
|
||||
|
||||
</br>
|
||||
{{< alert "fire" >}}
|
||||
Acabámos de lançar uma ferramenta CLI para o ajudar a começar com o Blowfish. Irá ajudá-lo com a instalação e configuração. Instale a ferramenta CLI globalmente utilizando:
|
||||
```bash
|
||||
npx blowfish-tools
|
||||
```
|
||||
{{< /alert >}}
|
||||
|
||||
Os ficheiros de configuração que acompanham o Blowfish contêm todas as definições possíveis que o tema reconhece. Por defeito, muitas delas estão comentadas, mas pode simplesmente descomentá-las para ativar ou alterar uma funcionalidade específica.
|
||||
|
||||
## Configuração básica
|
||||
|
||||
Antes de criar qualquer conteúdo, há algumas coisas que deve configurar para uma nova instalação. Começando no ficheiro `hugo.toml`, defina os parâmetros `baseURL` e `languageCode`. O `languageCode` deve ser definido para o idioma principal que utilizará para escrever o seu conteúdo.
|
||||
|
||||
```toml
|
||||
# config/_default/hugo.toml
|
||||
|
||||
baseURL = "https://your_domain.com/"
|
||||
languageCode = "pt-pt"
|
||||
```
|
||||
|
||||
O próximo passo é configurar as definições de idioma. Embora o Blowfish suporte configurações multilingues, por agora, apenas configure o idioma principal.
|
||||
|
||||
Localize o ficheiro `languages.en.toml` na pasta de configuração. Se o seu idioma principal for inglês, pode utilizar este ficheiro tal como está. Caso contrário, renomeie-o para incluir o código de idioma correto no nome do ficheiro. Por exemplo, para português europeu, renomeie o ficheiro para `languages.pt-pt.toml`.
|
||||
|
||||
{{< alert >}}
|
||||
Note que o código de idioma no nome do ficheiro de configuração de idioma deve corresponder à definição `languageCode` em `hugo.toml`.
|
||||
{{< /alert >}}
|
||||
|
||||
```toml
|
||||
# config/_default/languages.pt-pt.toml
|
||||
|
||||
title = "O meu site fantástico"
|
||||
|
||||
[params.author]
|
||||
name = "O meu nome"
|
||||
image = "img/author.jpg"
|
||||
headline = "Um ser humano geralmente fantástico"
|
||||
bio = "Um pouco sobre mim"
|
||||
links = [
|
||||
{ twitter = "https://twitter.com/username" }
|
||||
]
|
||||
```
|
||||
|
||||
A configuração `[params.author]` determina como as informações do autor são apresentadas no site. A imagem deve ser colocada na pasta `assets/` do site. As ligações serão apresentadas na ordem em que estão listadas.
|
||||
|
||||
Se precisar de mais detalhes, informações adicionais sobre cada uma destas opções de configuração são cobertas na secção [Configuração]({{< ref "configuration" >}}).
|
||||
|
||||
## Esquemas de cores
|
||||
|
||||
O Blowfish vem com vários esquemas de cores prontos a usar. Pode experimentar os esquemas integrados abaixo:
|
||||
|
||||
{{< theme-switcher >}}
|
||||
|
||||
Cada esquema de cores no Blowfish é construído sobre uma paleta de três cores que é utilizada consistentemente em todo o tema. Cada uma destas cores principais é baseada nas paletas de cores de dez tons incluídas no [Tailwind CSS](https://tailwindcss.com/docs/customizing-colors#color-palette-reference).
|
||||
|
||||
Embora estes sejam os esquemas predefinidos, também pode criar os seus próprios. Consulte a secção [Personalização Avançada]({{< ref "advanced-customisation#colour-schemes" >}}) para mais detalhes.
|
||||
|
||||
## Organização do conteúdo
|
||||
|
||||
Por defeito, o Blowfish não o obriga a utilizar um tipo de conteúdo específico. Ao fazê-lo, é livre de definir o seu conteúdo como desejar. Pode preferir _páginas_ para um site estático, _publicações_ para um blogue, ou _projetos_ para um portfólio.
|
||||
|
||||
Aqui está uma visão geral rápida de um projeto Blowfish básico. Todo o conteúdo é colocado dentro da pasta `content`:
|
||||
|
||||
```shell
|
||||
.
|
||||
├── assets
|
||||
│ └── img
|
||||
│ └── author.jpg
|
||||
├── config
|
||||
│ └── _default
|
||||
├── content
|
||||
│ ├── _index.md
|
||||
│ ├── about.md
|
||||
│ └── posts
|
||||
│ ├── _index.md
|
||||
│ ├── first-post.md
|
||||
│ └── another-post
|
||||
│ ├── aardvark.jpg
|
||||
│ └── index.md
|
||||
└── themes
|
||||
└── blowfish
|
||||
```
|
||||
|
||||
É importante ter uma compreensão firme de como o Hugo espera que o conteúdo seja organizado, pois o tema é projetado para aproveitar ao máximo os bundles de páginas do Hugo. Certifique-se de ler a [documentação oficial do Hugo](https://gohugo.io/content-management/organization/) para mais informações.
|
||||
|
||||
O Blowfish também é flexível quando se trata de taxonomias. Algumas pessoas preferem utilizar _tags_ e _categorias_ para agrupar o seu conteúdo, outras preferem utilizar _tópicos_.
|
||||
|
||||
O Hugo utiliza por defeito posts, tags e categorias, e isso funcionará bem se é isso que pretende. Se desejar personalizar isto, no entanto, pode fazê-lo criando um ficheiro de configuração `taxonomies.toml`:
|
||||
|
||||
```toml
|
||||
# config/_default/taxonomies.toml
|
||||
|
||||
topic = "topics"
|
||||
```
|
||||
|
||||
Isto substituirá os _tags_ e _categorias_ predefinidos por _tópicos_. Consulte a [documentação de taxonomias do Hugo](https://gohugo.io/content-management/taxonomies/) para mais informações sobre como nomear taxonomias.
|
||||
|
||||
Quando cria uma nova taxonomia, precisará de ajustar as ligações de navegação no site para apontar para as secções corretas, o que é coberto abaixo.
|
||||
|
||||
## Menus
|
||||
|
||||
O Blowfish tem dois menus que podem ser personalizados para se adequar ao conteúdo e layout do seu site. O menu `main` aparece no cabeçalho do site e o menu `footer` aparece na parte inferior da página, logo antes do aviso de direitos de autor.
|
||||
|
||||
Ambos os menus são configurados no ficheiro `menus.pt-pt.toml`. De forma semelhante ao ficheiro de configuração de idiomas, se desejar utilizar outro idioma, renomeie este ficheiro e substitua `en` pelo código de idioma que deseja utilizar.
|
||||
|
||||
```toml
|
||||
# config/_default/menus.toml
|
||||
|
||||
[[main]]
|
||||
name = "Blogue"
|
||||
pageRef = "posts"
|
||||
weight = 10
|
||||
|
||||
[[main]]
|
||||
name = "Tópicos"
|
||||
pageRef = "topics"
|
||||
weight = 20
|
||||
|
||||
[[main]]
|
||||
pre = "github"
|
||||
name = "GitHub"
|
||||
url = "https://github.com/nunocoracao/blowfish"
|
||||
weight = 30
|
||||
|
||||
[[main]]
|
||||
identifier = "github2"
|
||||
pre = "github"
|
||||
url = "https://github.com/nunocoracao/blowfish"
|
||||
weight = 40
|
||||
|
||||
[[footer]]
|
||||
name = "Privacidade"
|
||||
url = "https://external-link"
|
||||
```
|
||||
|
||||
O parâmetro `name` especifica o texto que é utilizado na ligação do menu. Também pode opcionalmente fornecer um `title` que preenche o atributo title HTML para a ligação.
|
||||
|
||||
O parâmetro `pageRef` permite-lhe fazer referência facilmente a páginas de conteúdo e taxonomias do Hugo. É a forma mais rápida de configurar o menu, pois pode simplesmente referir-se a qualquer item de conteúdo do Hugo e este construirá automaticamente a ligação correta. Para criar ligações para URLs externos, o parâmetro `url` pode ser utilizado.
|
||||
|
||||
O parâmetro `pre` permite-lhe colocar um ícone do [conjunto de ícones do Blowfish]({{< ref "samples/icons" >}}) na entrada do menu. Este parâmetro pode ser utilizado com o parâmetro `name` ou sozinho. Se quiser utilizar várias entradas de menu apenas com ícones, por favor defina o parâmetro `identifier`, caso contrário o Hugo utilizará por defeito a tag de nome como id e provavelmente não apresentará todas as entradas do menu.
|
||||
|
||||
As ligações do menu serão ordenadas do menor para o maior `weight`, e depois alfabeticamente por `name`.
|
||||
|
||||
Ambos os menus são completamente opcionais e podem ser comentados se não forem necessários. Utilize o modelo fornecido no ficheiro como guia.
|
||||
|
||||
### Menus aninhados
|
||||
|
||||
O tema também suporta menus aninhados. Para utilizá-los, só precisa de definir uma entrada pai em `menu.toml` e os seus submenus utilizando o parâmetro `parent` para referenciar o pai. Todas as propriedades podem ser utilizadas para submenus. `pageRef` e `url` também podem ser utilizados na entrada pai. Menus aninhados estão disponíveis apenas no menu principal, não para o rodapé.
|
||||
|
||||
```toml
|
||||
# config/_default/menus.toml
|
||||
|
||||
[[main]]
|
||||
name = "Pai"
|
||||
weight = 20
|
||||
|
||||
[[main]]
|
||||
name = "sub-menu 1"
|
||||
parent = "Pai"
|
||||
pageRef = "samples"
|
||||
weight = 20
|
||||
|
||||
[[main]]
|
||||
name = "sub-menu 2"
|
||||
parent = "Pai"
|
||||
pageRef = "samples"
|
||||
weight = 20
|
||||
|
||||
[[main]]
|
||||
name = "sub-menu 3"
|
||||
parent = "Pai"
|
||||
pre = "github"
|
||||
pageRef = "samples"
|
||||
weight = 20
|
||||
```
|
||||
|
||||
### Menu de sub-navegação
|
||||
|
||||
Adicionalmente, também pode configurar um menu de sub-navegação. Basta definir novas entradas de menu como `subnavigation` em `menus.toml`.
|
||||
Isto irá renderizar uma segunda linha com subcategorias abaixo do menu principal do cabeçalho.
|
||||
|
||||
```toml
|
||||
# config/_default/menus.toml
|
||||
|
||||
[[subnavigation]]
|
||||
name = "Um tópico interessante"
|
||||
pageRef = "tags/interesting-topic"
|
||||
weight = 10
|
||||
|
||||
[[subnavigation]]
|
||||
name = "A minha categoria fantástica"
|
||||
pageRef = "categories/awesome"
|
||||
weight = 20
|
||||
```
|
||||
|
||||
O `name` predefinido é o `pageRef` em formato de título.
|
||||
|
||||
## Miniaturas e Fundos
|
||||
|
||||
O Blowfish foi construído para facilitar a adição de suporte visual aos seus artigos. Se está familiarizado com a estrutura de artigos do Hugo, basta colocar um ficheiro de imagem (quase todos os formatos são suportados, mas recomendamos `.png` ou `.jpg`) que comece com `feature*` dentro da pasta do seu artigo. E é isso, o Blowfish poderá então utilizar a imagem tanto como miniatura dentro do seu site quanto para cartões <a target="_blank" href="https://oembed.com/">oEmbed</a> em plataformas sociais.
|
||||
|
||||
[Aqui]({{< ref "thumbnails" >}}) também há um guia com mais informações e um [exemplo]({{< ref "thumbnail_sample" >}}) se quiser ver como pode fazer isso.
|
||||
|
||||
Adicionalmente, o Blowfish também suporta imagens hero de fundo em artigos e listas. Para utilizar uma imagem diferente da destacada, adicione um ficheiro de imagem cujo nome comece com `background*`.
|
||||
|
||||
## Configuração detalhada
|
||||
|
||||
Os passos acima são a configuração mínima. Se agora executar `hugo server`, será apresentado um site Blowfish em branco. A configuração detalhada é coberta na secção [Configuração]({{< ref "configuration" >}}).
|
||||
Reference in New Issue
Block a user