📝 Sync v3 docs and content across all nine languages

New shortcode sections, landing layout docs, agent skill sections,
v2→v3 upgrade instructions, translated homepages, and sample
article feature images.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Nuno CoraçãoandClaude Fable 5 authored and Nuno C. committed 2026-08-17 20:19:02 +01:00
1 parent 7659c5f23d
commit 5e0e09d415
164 files changed
+3466 -941

No files matched your search

@@ -1,5 +1,6 @@
---
title: "Layout da Página Inicial"
featureimage: "images/v3/homepage-layout.png"
weight: 5
draft: false
description: "Configurando o layout da página inicial no tema Blowfish."
@@ -9,7 +10,7 @@ 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 Blowfish fornece layouts flexíveis de página inicial com configurações para ajustar cada 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).
@@ -57,6 +58,38 @@ O layout de cartão é uma extensão do layout de página. Ele fornece o mesmo n
Para habilitar o layout Cartão, defina `homepage.layout = "card"` e `homepage.homepageImage` no arquivo de configuração `params.toml`.
## Layout Landing
O layout Landing foi projetado para sites de produtos, hubs de documentação e sites pessoais que precisam de uma abertura mais marcante. Ele começa com um hero espaçoso e editorial — legenda superior (eyebrow), título de impacto, parágrafo de destaque e botões de call-to-action — opcionalmente apoiado por uma imagem hero de largura total que se dissolve no plano de fundo global, com uma animação de entrada escalonada que é desativada automaticamente para visitantes que preferem movimento reduzido. Tudo abaixo do hero é Markdown padrão e shortcodes do Blowfish, então a página inteira permanece portátil e fácil de manter.
{{< figure src="img/home-landing.png" class="thumbnailshadow" >}}
Para habilitar o layout Landing, defina `homepage.layout = "landing"` no arquivo de configuração `params.toml`.
O hero é controlado pelo front matter de `content/_index.md`. Todos os campos são opcionais — qualquer campo que você omitir simplesmente não é renderizado:
```yaml
---
title: "Build a site that feels unmistakably yours."
heroCaption: "Blowfish" # eyebrow above the title; defaults to the author name
heroLead: "A short statement that expands on the title."
heroButtons:
- label: "Get started"
url: "/docs/installation/"
- label: "Explore the docs"
url: "/docs/"
style: "outline" # "primary" (default) or "outline"
---
```
| Front matter | Descrição |
| ------------ | ----------- |
| `heroCaption` | Pequena legenda em maiúsculas acima do título. O padrão é `params.Author.name`. |
| `heroLead` | Parágrafo de destaque renderizado abaixo do título. Suporta Markdown. |
| `heroButtons` | Lista de botões de call-to-action (`label`, `url` e `style` opcional). Usa o mesmo estilo do [shortcode `cta`]({{< ref "shortcodes#cta-button" >}}). |
O corpo Markdown de `_index.md` é renderizado abaixo do hero, então estatísticas, grades de recursos, passos e quaisquer outros shortcodes podem construir o restante da página. O layout Landing combina bem com a opção `backgroundCanvas` para todo o site, descrita na [documentação de configuração]({{< ref "configuration" >}}).
## Layout personalizado
@@ -68,7 +101,7 @@ Com o valor de configuração definido, crie um novo arquivo `custom.html` e col
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.
O site de exemplo incluído usa o layout Landing integrado e shortcodes de conteúdo padrão. Visite o [repositório GitHub](https://github.com/nunocoracao/blowfish/tree/main/exampleSite) para ver como ele está configurado.
## Artigos recentes