dbrun/blowfish
1
0
Fork 0
mirror of https://github.com/nunocoracao/blowfish.git synced 2026-01-30 16:31:52 +01:00
Code Issues Packages Projects Releases Wiki Activity

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

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

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

Hugo build now supports 9 languages total.

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

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

89
exampleSite/content/docs/homepage-layout/index.de.md Normal file
View File

@@ -0,0 +1,89 @@
---
title: "Homepage-Layout"
weight: 5
draft: false
description: "Konfiguration des Homepage-Layouts im Blowfish-Theme."
slug: "homepage-layout"
tags: ["homepage", "layouts", "dokumentation"]
series: ["Dokumentation"]
series_order: 5
---
Blowfish bietet ein vollständig flexibles Homepage-Layout. Es gibt zwei Hauptvorlagen zur Auswahl mit zusätzlichen Einstellungen zur Anpassung des Designs. Alternativ können Sie auch Ihre eigene Vorlage bereitstellen und die vollständige Kontrolle über den Homepage-Inhalt haben.
Das Layout der Homepage wird durch die Einstellung `homepage.layout` in der Konfigurationsdatei `params.toml` gesteuert. Zusätzlich haben alle Layouts die Option, eine Liste der [neuesten Artikel](#neueste-artikel) einzuschließen.
## Profil-Layout
Das Standard-Layout ist das Profil-Layout, das sich hervorragend für persönliche Websites und Blogs eignet. Es stellt die Details des Autors in den Vordergrund, indem es ein Bild und Links zu sozialen Profilen bereitstellt.
{{< figure src="img/home-profile.png" class="thumbnailshadow" >}}
Die Autoreninformationen werden in der Sprachen-Konfigurationsdatei bereitgestellt. Weitere Details zu den Parametern finden Sie in den Abschnitten [Erste Schritte]({{< ref "getting-started" >}}) und [Sprachkonfiguration]({{< ref "configuration##language-and-i18n" >}}).
Zusätzlich wird jeder Markdown-Inhalt, der im Homepage-Inhalt bereitgestellt wird, unter dem Autorenprofil platziert. Dies ermöglicht zusätzliche Flexibilität für die Anzeige einer Biografie oder anderer benutzerdefinierter Inhalte mit Shortcodes.
Um das Profil-Layout zu aktivieren, setzen Sie `homepage.layout = "profile"` in der Konfigurationsdatei `params.toml`.
## Seiten-Layout
Das Seiten-Layout ist einfach eine normale Inhaltsseite, die Ihren Markdown-Inhalt anzeigt. Es eignet sich hervorragend für statische Websites und bietet viel Flexibilität.
{{< figure src="img/home-page.png" class="thumbnailshadow" >}}
Um das Seiten-Layout zu aktivieren, setzen Sie `homepage.layout = "page"` in der Konfigurationsdatei `params.toml`.
## Hero-Layout
Das Hero-Layout vereint Ideen aus den Profil- und Card-Layouts. Es zeigt nicht nur Informationen über den Autor der Website an, sondern lädt auch Ihren Markdown darunter.
{{< figure src="img/home-hero.png" class="thumbnailshadow" >}}
Um das Hero-Layout zu aktivieren, setzen Sie `homepage.layout = "hero"` und `homepage.homepageImage` in der Konfigurationsdatei `params.toml`.
## Hintergrund-Layout
Das Hintergrund-Layout ist eine flüssigere Version des Hero-Layouts. Wie beim Hero-Layout zeigt es sowohl Informationen über den Autor der Website an als auch Ihren Markdown darunter.
{{< figure src="img/home-background.png" class="thumbnailshadow" >}}
Um das Hintergrund-Layout zu aktivieren, setzen Sie `homepage.layout = "background"` und `homepage.homepageImage` in der Konfigurationsdatei `params.toml`.
## Card-Layout
Das Card-Layout ist eine Erweiterung des Seiten-Layouts. Es bietet das gleiche Maß an Flexibilität, indem es auch Ihren Markdown-Inhalt anzeigt und ein Card-Bild zur Anzeige visueller Inhalte hinzufügt.
{{< figure src="img/home-card.png" class="thumbnailshadow" >}}
Um das Card-Layout zu aktivieren, setzen Sie `homepage.layout = "card"` und `homepage.homepageImage` in der Konfigurationsdatei `params.toml`.
## Benutzerdefiniertes Layout
Wenn die integrierten Homepage-Layouts für Ihre Bedürfnisse nicht ausreichen, haben Sie die Möglichkeit, Ihr eigenes benutzerdefiniertes Layout bereitzustellen. Dies ermöglicht Ihnen die vollständige Kontrolle über den Seiteninhalt und gibt Ihnen im Wesentlichen eine leere Leinwand zum Arbeiten.
Um das benutzerdefinierte Layout zu aktivieren, setzen Sie `homepage.layout = "custom"` in der Konfigurationsdatei `params.toml`.
Nachdem der Konfigurationswert gesetzt ist, erstellen Sie eine neue Datei `custom.html` und platzieren Sie sie in `layouts/partials/home/custom.html`. Alles, was in der Datei `custom.html` steht, wird nun im Inhaltsbereich der Website-Homepage platziert. Sie können beliebiges HTML, Tailwind oder Hugo-Templating-Funktionen verwenden, um Ihr Layout zu definieren.
Um [neueste Artikel](#neueste-artikel) im benutzerdefinierten Layout einzuschließen, verwenden Sie das Partial `recent-articles/main.html`.
Als Beispiel verwendet die [Homepage]({{< ref "/" >}}) auf dieser Website das benutzerdefinierte Layout, um zwischen dem Profil- und Seiten-Layout zu wechseln. Besuchen Sie das [GitHub-Repository](https://github.com/nunocoracao/blowfish/blob/main/exampleSite/layouts/partials/home/custom.html), um zu sehen, wie es funktioniert.
## Neueste Artikel
Alle Homepage-Layouts haben die Option, neueste Artikel unter dem Hauptseiteninhalt anzuzeigen. Um dies zu aktivieren, setzen Sie einfach die Einstellung `homepage.showRecent` auf `true` in der Konfigurationsdatei `params.toml`.
{{< figure src="img/home-list.png" class="thumbnailshadow" >}}
Die in diesem Abschnitt aufgelisteten Artikel werden von der Einstellung `mainSections` abgeleitet, die beliebige Inhaltstypen erlaubt, die Sie auf Ihrer Website verwenden. Wenn Sie beispielsweise Inhaltsabschnitte für _posts_ und _projects_ haben, könnten Sie diese Einstellung auf `["posts", "projects"]` setzen, und alle Artikel in diesen beiden Abschnitten würden verwendet, um die Liste der neuesten Artikel zu füllen. Das Theme erwartet, dass diese Einstellung ein Array ist, also wenn Sie nur einen Abschnitt für all Ihre Inhalte verwenden, sollten Sie dies entsprechend setzen: `["blog"]`.
## Thumbnails
Blowfish wurde so entwickelt, dass es einfach ist, visuelle Unterstützung zu Ihren Artikeln hinzuzufügen. Wenn Sie mit der Hugo-Artikelstruktur vertraut sind, müssen Sie nur eine Bilddatei (fast alle Formate werden unterstützt, aber wir empfehlen `.png` oder `.jpg`) in Ihrem Artikelordner platzieren, die mit `feature*` beginnt. Das ist alles, Blowfish kann dann das Bild sowohl als Thumbnail innerhalb Ihrer Website als auch für <a target="_blank" href="https://oembed.com/">oEmbed</a>-Karten auf sozialen Plattformen verwenden.
[Hier]({{< ref "thumbnails" >}}) finden Sie einen Leitfaden mit mehr Informationen und ein [Beispiel]({{< ref "thumbnail_sample" >}}), wenn Sie ein Beispiel sehen möchten.
## Card-Galerie
Blowfish unterstützt auch die Anzeige von Standard-Artikellisten als Card-Galerien. Sie können dies sowohl für den Bereich der neuesten Artikel auf der Homepage als auch für Artikellisten auf Ihrer gesamten Website konfigurieren. Für die Homepage können Sie `homepage.cardView` und `homepage.cardViewScreenWidth` verwenden; und für Listen verwenden Sie `list.cardView` und `list.cardViewScreenWidth`. Weitere Details finden Sie in der [Konfigurations-Dokumentation]({{< ref "configuration" >}}), und auf der Homepage gibt es eine Live-Demo.

89
exampleSite/content/docs/homepage-layout/index.es.md Normal file
View File

@@ -0,0 +1,89 @@
---
title: "Diseño de página de inicio"
weight: 5
draft: false
description: "Configuración del diseño de la página de inicio en el tema Blowfish."
slug: "homepage-layout"
tags: ["página de inicio", "diseños", "documentación"]
series: ["Documentación"]
series_order: 5
---
Blowfish proporciona un diseño de página de inicio totalmente flexible. Hay dos plantillas principales para elegir con configuraciones adicionales para ajustar el diseño. Alternativamente, también puedes proporcionar tu propia plantilla y tener control total sobre el contenido de la página de inicio.
El diseño de la página de inicio está controlado por la configuración `homepage.layout` en el archivo de configuración `params.toml`. Además, todos los diseños tienen la opción de incluir una lista de [artículos recientes](#artículos-recientes).
## Diseño Perfil
El diseño predeterminado es el diseño de perfil, que es ideal para sitios web personales y blogs. Pone los detalles del autor en primer plano proporcionando una imagen y enlaces a perfiles sociales.
{{< figure src="img/home-profile.png" class="thumbnailshadow" >}}
La información del autor se proporciona en el archivo de configuración de idiomas. Consulta las secciones [Primeros Pasos]({{< ref "getting-started" >}}) y [Configuración de idioma]({{< ref "configuration##language-and-i18n" >}}) para detalles de los parámetros.
Además, cualquier contenido Markdown que se proporcione en el contenido de la página de inicio se colocará debajo del perfil del autor. Esto permite flexibilidad adicional para mostrar una biografía u otro contenido personalizado usando shortcodes.
Para habilitar el diseño Perfil, establece `homepage.layout = "profile"` en el archivo de configuración `params.toml`.
## Diseño Página
El diseño de página es simplemente una página de contenido normal que muestra tu contenido Markdown. Es ideal para sitios web estáticos y proporciona mucha flexibilidad.
{{< figure src="img/home-page.png" class="thumbnailshadow" >}}
Para habilitar el diseño Página, establece `homepage.layout = "page"` en el archivo de configuración `params.toml`.
## Diseño Hero
El diseño hero combina ideas de los diseños de perfil y tarjeta. Este no solo muestra información sobre el autor del sitio sino que también carga tu markdown debajo.
{{< figure src="img/home-hero.png" class="thumbnailshadow" >}}
Para habilitar el diseño Hero, establece `homepage.layout = "hero"` y `homepage.homepageImage` en el archivo de configuración `params.toml`.
## Diseño Fondo
El diseño de fondo es una versión más suave del diseño hero. Como en el diseño Hero, este también muestra información sobre el autor del sitio y carga tu markdown debajo.
{{< figure src="img/home-background.png" class="thumbnailshadow" >}}
Para habilitar el diseño Fondo, establece `homepage.layout = "background"` y `homepage.homepageImage` en el archivo de configuración `params.toml`.
## Diseño Tarjeta
El diseño de tarjeta es una extensión del diseño de página. Proporciona el mismo nivel de flexibilidad mostrando también tu contenido markdown y añade una imagen de tarjeta para mostrar contenido visual.
{{< figure src="img/home-card.png" class="thumbnailshadow" >}}
Para habilitar el diseño Tarjeta, establece `homepage.layout = "card"` y `homepage.homepageImage` en el archivo de configuración `params.toml`.
## Diseño personalizado
Si los diseños de página de inicio integrados no son suficientes para tus necesidades, tienes la opción de proporcionar tu propio diseño personalizado. Esto te permite tener control total sobre el contenido de la página y esencialmente te da una página en blanco para trabajar.
Para habilitar el diseño personalizado, establece `homepage.layout = "custom"` en el archivo de configuración `params.toml`.
Con el valor de configuración establecido, crea un nuevo archivo `custom.html` y colócalo en `layouts/partials/home/custom.html`. Ahora, lo que esté en el archivo `custom.html` se colocará en el área de contenido de la página de inicio del sitio. Puedes usar cualquier HTML, Tailwind o funciones de plantillas Hugo que desees para definir tu diseño.
Para incluir [artículos recientes](#artículos-recientes) en el diseño personalizado, usa el partial `recent-articles/main.html`.
Como ejemplo, la [página de inicio]({{< ref "/" >}}) de este sitio usa el diseño personalizado para permitir alternar entre los diseños de perfil y página. Visita el [repositorio de GitHub](https://github.com/nunocoracao/blowfish/blob/main/exampleSite/layouts/partials/home/custom.html) para ver cómo funciona.
## Artículos recientes
Todos los diseños de página de inicio tienen la opción de mostrar artículos recientes debajo del contenido principal de la página. Para habilitar esto, simplemente establece la configuración `homepage.showRecent` en `true` en el archivo de configuración `params.toml`.
{{< figure src="img/home-list.png" class="thumbnailshadow" >}}
Los artículos listados en esta sección se derivan de la configuración `mainSections` que permite cualquier tipo de contenido que estés usando en tu sitio web. Por ejemplo, si tienes secciones de contenido para _posts_ y _projects_ podrías establecer esta configuración en `["posts", "projects"]` y todos los artículos en estas dos secciones se usarían para llenar la lista de recientes. El tema espera que esta configuración sea un array, así que si solo usas una sección para todo tu contenido, deberías establecerlo así: `["blog"]`.
## Miniaturas
Blowfish fue construido para que sea fácil agregar soporte visual a tus artículos. Si estás familiarizado con la estructura de artículos de Hugo, solo necesitas colocar un archivo de imagen (casi todos los formatos son compatibles pero recomendamos `.png` o `.jpg`) que comience con `feature*` dentro de tu carpeta de artículo. Y eso es todo, Blowfish podrá usar la imagen tanto como miniatura dentro de tu sitio web como para tarjetas <a target="_blank" href="https://oembed.com/">oEmbed</a> en plataformas sociales.
[Aquí]({{< ref "thumbnails" >}}) hay una guía con más información y un [ejemplo]({{< ref "thumbnail_sample" >}}) si quieres ver un ejemplo.
## Galería de tarjetas
Blowfish también admite mostrar las listas estándar de artículos como galerías de tarjetas. Puedes configurar esto tanto para la sección de recientes en la página de inicio como para las listas de artículos en todo tu sitio web. Para la página de inicio puedes usar `homepage.cardView` y `homepage.cardViewScreenWidth`; y para las listas usa `list.cardView` y `list.cardViewScreenWidth`. Consulta la [documentación de configuración]({{< ref "configuration" >}}) para más detalles, y la página de inicio para una demostración en vivo.

89
exampleSite/content/docs/homepage-layout/index.fr.md Normal file
View File

@@ -0,0 +1,89 @@
---
title: "Mise en page de la page d'accueil"
weight: 5
draft: false
description: "Configuration de la mise en page de la page d'accueil dans le thème Blowfish."
slug: "homepage-layout"
tags: ["page d'accueil", "mises en page", "documentation"]
series: ["Documentation"]
series_order: 5
---
Blowfish offre une mise en page de page d'accueil entièrement flexible. Il y a deux modèles principaux à choisir avec des paramètres supplémentaires pour ajuster le design. Alternativement, vous pouvez également fournir votre propre modèle et avoir un contrôle total sur le contenu de la page d'accueil.
La mise en page de la page d'accueil est contrôlée par le paramètre `homepage.layout` dans le fichier de configuration `params.toml`. De plus, toutes les mises en page ont l'option d'inclure une liste des [articles récents](#articles-récents).
## Mise en page Profil
La mise en page par défaut est la mise en page profil, idéale pour les sites web personnels et les blogs. Elle met les détails de l'auteur au premier plan en fournissant une image et des liens vers les profils sociaux.
{{< figure src="img/home-profile.png" class="thumbnailshadow" >}}
Les informations sur l'auteur sont fournies dans le fichier de configuration des langues. Consultez les sections [Premiers Pas]({{< ref "getting-started" >}}) et [Configuration de la langue]({{< ref "configuration##language-and-i18n" >}}) pour les détails des paramètres.
De plus, tout contenu Markdown fourni dans le contenu de la page d'accueil sera placé sous le profil de l'auteur. Cela permet une flexibilité supplémentaire pour afficher une bio ou d'autres contenus personnalisés en utilisant des shortcodes.
Pour activer la mise en page Profil, définissez `homepage.layout = "profile"` dans le fichier de configuration `params.toml`.
## Mise en page Page
La mise en page page est simplement une page de contenu normale qui affiche votre contenu Markdown. Elle est idéale pour les sites web statiques et offre beaucoup de flexibilité.
{{< figure src="img/home-page.png" class="thumbnailshadow" >}}
Pour activer la mise en page Page, définissez `homepage.layout = "page"` dans le fichier de configuration `params.toml`.
## Mise en page Hero
La mise en page hero rassemble des idées des mises en page profil et carte. Celle-ci affiche non seulement des informations sur l'auteur du site, mais charge également votre markdown en dessous.
{{< figure src="img/home-hero.png" class="thumbnailshadow" >}}
Pour activer la mise en page Hero, définissez `homepage.layout = "hero"` et `homepage.homepageImage` dans le fichier de configuration `params.toml`.
## Mise en page Arrière-plan
La mise en page arrière-plan est une version plus fluide de la mise en page hero. Comme pour la mise en page Hero, celle-ci affiche également les informations sur l'auteur du site et charge votre markdown en dessous.
{{< figure src="img/home-background.png" class="thumbnailshadow" >}}
Pour activer la mise en page Arrière-plan, définissez `homepage.layout = "background"` et `homepage.homepageImage` dans le fichier de configuration `params.toml`.
## Mise en page Carte
La mise en page carte est une extension de la mise en page page. Elle offre le même niveau de flexibilité en affichant également votre contenu markdown et ajoute une image de carte pour afficher du contenu visuel.
{{< figure src="img/home-card.png" class="thumbnailshadow" >}}
Pour activer la mise en page Carte, définissez `homepage.layout = "card"` et `homepage.homepageImage` dans le fichier de configuration `params.toml`.
## Mise en page personnalisée
Si les mises en page de page d'accueil intégrées ne sont pas suffisantes pour vos besoins, vous avez la possibilité de fournir votre propre mise en page personnalisée. Cela vous permet d'avoir un contrôle total sur le contenu de la page et vous donne essentiellement une page blanche pour travailler.
Pour activer la mise en page personnalisée, définissez `homepage.layout = "custom"` dans le fichier de configuration `params.toml`.
Avec la valeur de configuration définie, créez un nouveau fichier `custom.html` et placez-le dans `layouts/partials/home/custom.html`. Maintenant, tout ce qui est dans le fichier `custom.html` sera placé dans la zone de contenu de la page d'accueil du site. Vous pouvez utiliser n'importe quel HTML, Tailwind, ou fonctions de templating Hugo que vous souhaitez pour définir votre mise en page.
Pour inclure les [articles récents](#articles-récents) dans la mise en page personnalisée, utilisez le partial `recent-articles/main.html`.
Par exemple, la [page d'accueil]({{< ref "/" >}}) de ce site utilise la mise en page personnalisée pour permettre de basculer entre les mises en page profil et page. Visitez le [dépôt GitHub](https://github.com/nunocoracao/blowfish/blob/main/exampleSite/layouts/partials/home/custom.html) pour voir comment cela fonctionne.
## Articles récents
Toutes les mises en page de page d'accueil ont l'option d'afficher les articles récents sous le contenu principal de la page. Pour activer cela, définissez simplement le paramètre `homepage.showRecent` sur `true` dans le fichier de configuration `params.toml`.
{{< figure src="img/home-list.png" class="thumbnailshadow" >}}
Les articles listés dans cette section sont dérivés du paramètre `mainSections` qui permet d'utiliser n'importe quels types de contenu que vous utilisez sur votre site web. Par exemple, si vous avez des sections de contenu pour _posts_ et _projects_, vous pourriez définir ce paramètre sur `["posts", "projects"]` et tous les articles de ces deux sections seraient utilisés pour remplir la liste récente. Le thème s'attend à ce que ce paramètre soit un tableau, donc si vous n'utilisez qu'une seule section pour tout votre contenu, vous devriez le définir en conséquence : `["blog"]`.
## Vignettes
Blowfish a été conçu pour qu'il soit facile d'ajouter un support visuel à vos articles. Si vous êtes familier avec la structure des articles Hugo, il vous suffit de placer un fichier image (presque tous les formats sont pris en charge mais nous recommandons `.png` ou `.jpg`) qui commence par `feature*` dans votre dossier d'article. Et c'est tout, Blowfish pourra alors utiliser l'image à la fois comme vignette sur votre site et pour les cartes <a target="_blank" href="https://oembed.com/">oEmbed</a> sur les plateformes sociales.
[Voici]({{< ref "thumbnails" >}}) un guide avec plus d'informations et un [exemple]({{< ref "thumbnail_sample" >}}) si vous voulez voir un exemple.
## Galerie de cartes
Blowfish prend également en charge l'affichage des listes d'articles standard sous forme de galeries de cartes. Vous pouvez configurer cela à la fois pour la section récente sur la page d'accueil et pour les listes d'articles sur tout votre site web. Pour la page d'accueil, vous pouvez utiliser `homepage.cardView` et `homepage.cardViewScreenWidth` ; et pour les listes, utilisez `list.cardView` et `list.cardViewScreenWidth`. Consultez la [documentation de configuration]({{< ref "configuration" >}}) pour plus de détails, et la page d'accueil pour une démo en direct.

89
exampleSite/content/docs/homepage-layout/index.pt-br.md Normal file
View File

@@ -0,0 +1,89 @@
---
title: "Layout da Página Inicial"
weight: 5
draft: false
description: "Configurando o layout da página inicial no tema Blowfish."
slug: "homepage-layout"
tags: ["página inicial", "layouts", "documentação"]
series: ["Documentação"]
series_order: 5
---
O Blowfish fornece um layout de página inicial totalmente flexível. Existem dois modelos principais para escolher com configurações adicionais para ajustar o design. Alternativamente, você também pode fornecer seu próprio modelo e ter controle total sobre o conteúdo da página inicial.
O layout da página inicial é controlado pela configuração `homepage.layout` no arquivo de configuração `params.toml`. Além disso, todos os layouts têm a opção de incluir uma lista de [artigos recentes](#artigos-recentes).
## Layout Perfil
O layout padrão é o layout de perfil, que é ótimo para sites pessoais e blogs. Ele coloca os detalhes do autor em primeiro plano, fornecendo uma imagem e links para perfis sociais.
{{< figure src="img/home-profile.png" class="thumbnailshadow" >}}
As informações do autor são fornecidas no arquivo de configuração de idiomas. Consulte as seções [Primeiros Passos]({{< ref "getting-started" >}}) e [Configuração de Idioma]({{< ref "configuration##language-and-i18n" >}}) para detalhes dos parâmetros.
Além disso, qualquer conteúdo Markdown fornecido no conteúdo da página inicial será colocado abaixo do perfil do autor. Isso permite flexibilidade extra para exibir uma biografia ou outro conteúdo personalizado usando shortcodes.
Para habilitar o layout Perfil, defina `homepage.layout = "profile"` no arquivo de configuração `params.toml`.
## Layout Página
O layout de página é simplesmente uma página de conteúdo normal que exibe seu conteúdo Markdown. É ótimo para sites estáticos e fornece muita flexibilidade.
{{< figure src="img/home-page.png" class="thumbnailshadow" >}}
Para habilitar o layout Página, defina `homepage.layout = "page"` no arquivo de configuração `params.toml`.
## Layout Hero
O layout hero combina ideias dos layouts de perfil e cartão. Este não apenas exibe informações sobre o autor do site, mas também carrega seu markdown abaixo dele.
{{< figure src="img/home-hero.png" class="thumbnailshadow" >}}
Para habilitar o layout Hero, defina `homepage.layout = "hero"` e `homepage.homepageImage` no arquivo de configuração `params.toml`.
## Layout Fundo
O layout de fundo é uma versão mais suave do layout hero. Assim como no layout Hero, este também exibe informações sobre o autor do site e carrega seu markdown abaixo dele.
{{< figure src="img/home-background.png" class="thumbnailshadow" >}}
Para habilitar o layout Fundo, defina `homepage.layout = "background"` e `homepage.homepageImage` no arquivo de configuração `params.toml`.
## Layout Cartão
O layout de cartão é uma extensão do layout de página. Ele fornece o mesmo nível de flexibilidade, também exibindo seu conteúdo markdown e adiciona uma imagem de cartão para exibir conteúdo visual.
{{< figure src="img/home-card.png" class="thumbnailshadow" >}}
Para habilitar o layout Cartão, defina `homepage.layout = "card"` e `homepage.homepageImage` no arquivo de configuração `params.toml`.
## Layout personalizado
Se os layouts de página inicial integrados não forem suficientes para suas necessidades, você tem a opção de fornecer seu próprio layout personalizado. Isso permite que você tenha controle total sobre o conteúdo da página e essencialmente lhe dá uma tela em branco para trabalhar.
Para habilitar o layout personalizado, defina `homepage.layout = "custom"` no arquivo de configuração `params.toml`.
Com o valor de configuração definido, crie um novo arquivo `custom.html` e coloque-o em `layouts/partials/home/custom.html`. Agora, o que estiver no arquivo `custom.html` será colocado na área de conteúdo da página inicial do site. Você pode usar qualquer HTML, Tailwind ou funções de template Hugo que desejar para definir seu layout.
Para incluir [artigos recentes](#artigos-recentes) no layout personalizado, use o partial `recent-articles/main.html`.
Como exemplo, a [página inicial]({{< ref "/" >}}) deste site usa o layout personalizado para permitir alternar entre os layouts de perfil e página. Visite o [repositório GitHub](https://github.com/nunocoracao/blowfish/blob/main/exampleSite/layouts/partials/home/custom.html) para ver como funciona.
## Artigos recentes
Todos os layouts de página inicial têm a opção de exibir artigos recentes abaixo do conteúdo principal da página. Para habilitar isso, basta definir a configuração `homepage.showRecent` como `true` no arquivo de configuração `params.toml`.
{{< figure src="img/home-list.png" class="thumbnailshadow" >}}
Os artigos listados nesta seção são derivados da configuração `mainSections` que permite quaisquer tipos de conteúdo que você esteja usando em seu site. Por exemplo, se você tiver seções de conteúdo para _posts_ e _projects_, você poderia definir esta configuração como `["posts", "projects"]` e todos os artigos nessas duas seções seriam usados para preencher a lista de recentes. O tema espera que esta configuração seja um array, então se você usar apenas uma seção para todo o seu conteúdo, você deve definir assim: `["blog"]`.
## Miniaturas
O Blowfish foi construído para facilitar a adição de suporte visual aos seus artigos. Se você está familiarizado com a estrutura de artigos do Hugo, basta colocar um arquivo de imagem (quase todos os formatos são suportados, mas recomendamos `.png` ou `.jpg`) que comece com `feature*` dentro da pasta do seu artigo. E é isso, o Blowfish poderá usar a imagem tanto como miniatura dentro do seu site quanto para cartões <a target="_blank" href="https://oembed.com/">oEmbed</a> em plataformas sociais.
[Aqui]({{< ref "thumbnails" >}}) há um guia com mais informações e um [exemplo]({{< ref "thumbnail_sample" >}}) se você quiser ver um exemplo.
## Galeria de cartões
O Blowfish também suporta exibir as listas padrão de artigos como galerias de cartões. Você pode configurar isso tanto para a seção de recentes na página inicial quanto para listas de artigos em todo o seu site. Para a página inicial, você pode usar `homepage.cardView` e `homepage.cardViewScreenWidth`; e para listas, use `list.cardView` e `list.cardViewScreenWidth`. Consulte a [documentação de configuração]({{< ref "configuration" >}}) para mais detalhes, e a página inicial para uma demonstração ao vivo.

89
exampleSite/content/docs/homepage-layout/index.pt-pt.md Normal file
View File

@@ -0,0 +1,89 @@
---
title: "Layout da Página Inicial"
weight: 5
draft: false
description: "Configuração do layout da página inicial no tema Blowfish."
slug: "homepage-layout"
tags: ["página inicial", "layouts", "documentação"]
series: ["Documentação"]
series_order: 5
---
O Blowfish fornece um layout de página inicial totalmente flexível. Existem dois modelos principais para escolher com definições adicionais para ajustar o design. Alternativamente, também pode fornecer o seu próprio modelo e ter controlo total sobre o conteúdo da página inicial.
O layout da página inicial é controlado pela definição `homepage.layout` no ficheiro de configuração `params.toml`. Além disso, todos os layouts têm a opção de incluir uma lista de [artigos recentes](#artigos-recentes).
## Layout Perfil
O layout predefinido é o layout de perfil, que é ótimo para sites pessoais e blogues. Coloca os detalhes do autor em primeiro plano, fornecendo uma imagem e ligações para perfis sociais.
{{< figure src="img/home-profile.png" class="thumbnailshadow" >}}
As informações do autor são fornecidas no ficheiro de configuração de idiomas. Consulte as secções [Primeiros Passos]({{< ref "getting-started" >}}) e [Configuração de Idioma]({{< ref "configuration##language-and-i18n" >}}) para detalhes dos parâmetros.
Além disso, qualquer conteúdo Markdown fornecido no conteúdo da página inicial será colocado abaixo do perfil do autor. Isto permite flexibilidade extra para apresentar uma biografia ou outro conteúdo personalizado utilizando shortcodes.
Para ativar o layout Perfil, defina `homepage.layout = "profile"` no ficheiro de configuração `params.toml`.
## Layout Página
O layout de página é simplesmente uma página de conteúdo normal que apresenta o seu conteúdo Markdown. É ótimo para sites estáticos e fornece muita flexibilidade.
{{< figure src="img/home-page.png" class="thumbnailshadow" >}}
Para ativar o layout Página, defina `homepage.layout = "page"` no ficheiro de configuração `params.toml`.
## Layout Hero
O layout hero combina ideias dos layouts de perfil e cartão. Este não só apresenta informações sobre o autor do site, mas também carrega o seu markdown abaixo.
{{< figure src="img/home-hero.png" class="thumbnailshadow" >}}
Para ativar o layout Hero, defina `homepage.layout = "hero"` e `homepage.homepageImage` no ficheiro de configuração `params.toml`.
## Layout Fundo
O layout de fundo é uma versão mais suave do layout hero. Tal como no layout Hero, este também apresenta informações sobre o autor do site e carrega o seu markdown abaixo.
{{< figure src="img/home-background.png" class="thumbnailshadow" >}}
Para ativar o layout Fundo, defina `homepage.layout = "background"` e `homepage.homepageImage` no ficheiro de configuração `params.toml`.
## Layout Cartão
O layout de cartão é uma extensão do layout de página. Fornece o mesmo nível de flexibilidade, também apresentando o seu conteúdo markdown e adiciona uma imagem de cartão para apresentar conteúdo visual.
{{< figure src="img/home-card.png" class="thumbnailshadow" >}}
Para ativar o layout Cartão, defina `homepage.layout = "card"` e `homepage.homepageImage` no ficheiro de configuração `params.toml`.
## Layout personalizado
Se os layouts de página inicial integrados não forem suficientes para as suas necessidades, tem a opção de fornecer o seu próprio layout personalizado. Isto permite-lhe ter controlo total sobre o conteúdo da página e essencialmente dá-lhe uma tela em branco para trabalhar.
Para ativar o layout personalizado, defina `homepage.layout = "custom"` no ficheiro de configuração `params.toml`.
Com o valor de configuração definido, crie um novo ficheiro `custom.html` e coloque-o em `layouts/partials/home/custom.html`. Agora, o que estiver no ficheiro `custom.html` será colocado na área de conteúdo da página inicial do site. Pode utilizar qualquer HTML, Tailwind ou funções de template Hugo que desejar para definir o seu layout.
Para incluir [artigos recentes](#artigos-recentes) no layout personalizado, utilize o partial `recent-articles/main.html`.
Como exemplo, a [página inicial]({{< ref "/" >}}) deste site utiliza o layout personalizado para permitir alternar entre os layouts de perfil e página. Visite o [repositório GitHub](https://github.com/nunocoracao/blowfish/blob/main/exampleSite/layouts/partials/home/custom.html) para ver como funciona.
## Artigos recentes
Todos os layouts de página inicial têm a opção de apresentar artigos recentes abaixo do conteúdo principal da página. Para ativar isto, basta definir a configuração `homepage.showRecent` como `true` no ficheiro de configuração `params.toml`.
{{< figure src="img/home-list.png" class="thumbnailshadow" >}}
Os artigos listados nesta secção são derivados da definição `mainSections` que permite quaisquer tipos de conteúdo que esteja a utilizar no seu site. Por exemplo, se tiver secções de conteúdo para _posts_ e _projects_, poderia definir esta configuração como `["posts", "projects"]` e todos os artigos nestas duas secções seriam utilizados para preencher a lista de recentes. O tema espera que esta definição seja um array, pelo que se utilizar apenas uma secção para todo o seu conteúdo, deve definir assim: `["blog"]`.
## Miniaturas
O Blowfish foi construído para facilitar a adição de suporte visual aos seus artigos. Se está familiarizado com a estrutura de artigos do Hugo, basta colocar um ficheiro de imagem (quase todos os formatos são suportados, mas recomendamos `.png` ou `.jpg`) que comece com `feature*` dentro da pasta do seu artigo. E é isso, o Blowfish poderá utilizar a imagem tanto como miniatura dentro do seu site quanto para cartões <a target="_blank" href="https://oembed.com/">oEmbed</a> em plataformas sociais.
[Aqui]({{< ref "thumbnails" >}}) há um guia com mais informações e um [exemplo]({{< ref "thumbnail_sample" >}}) se quiser ver um exemplo.
## Galeria de cartões
O Blowfish também suporta apresentar as listas padrão de artigos como galerias de cartões. Pode configurar isto tanto para a secção de recentes na página inicial quanto para listas de artigos em todo o seu site. Para a página inicial, pode utilizar `homepage.cardView` e `homepage.cardViewScreenWidth`; e para listas, utilize `list.cardView` e `list.cardViewScreenWidth`. Consulte a [documentação de configuração]({{< ref "configuration" >}}) para mais detalhes, e a página inicial para uma demonstração ao vivo.