mirror of
https://github.com/nunocoracao/blowfish.git
synced 2026-11-17 00:15:51 +00:00
📝 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:
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
|
||||
|
||||
|
||||
Reference in new issue
Block a user