mirror of
https://github.com/nunocoracao/blowfish.git
synced 2026-10-23 20:25:25 +00:00
58 lines
3.5 KiB
Markdown
58 lines
3.5 KiB
Markdown
---
|
|
title: "Bem-vindo ao Blowfish"
|
|
featureimage: "images/v3/welcome.png"
|
|
weight: 1
|
|
draft: false
|
|
description: "Crie um site Hugo rápido e expressivo com layouts flexíveis, ferramentas de conteúdo rico e um fluxo de trabalho pronto para agentes."
|
|
lastmod: 2026-08-30
|
|
tags: ["novo", "documentação"]
|
|
series: ["Documentação"]
|
|
series_order: 1
|
|
---
|
|
|
|
{{< lead >}}
|
|
O Blowfish 3 é um tema Hugo moderno para blogs, documentação, portfólios e sites que não cabem em um modelo rígido.
|
|
{{< /lead >}}
|
|
|
|
{{< alert >}}
|
|
Crie um novo site com `npx blowfish-tools new <site>` e siga o [guia de instalação]({{< ref "docs/installation" >}}). Sites Blowfish existentes podem migrar para a v3 sem mudanças incompatíveis na configuração.
|
|
{{< /alert >}}
|
|
|
|
## Crie o site que você imagina
|
|
|
|
O Blowfish oferece uma base sólida sem determinar o resultado. Escolha layouts de página inicial de perfil, landing, hero, cartões ou fundo. Defina cores, tipografia, navegação, modo escuro e apresentação de artigos na configuração do site. Use front matter quando uma página precisar ser diferente.
|
|
|
|
Seu conteúdo continua sendo Hugo portátil: Markdown, page bundles, taxonomias, menus e arquivos de configuração no repositório. Não há editor proprietário ou dependência de plataforma.
|
|
|
|
## Publique conteúdo mais rico com menos código
|
|
|
|
Escreva em Markdown e use os [mais de 40 shortcodes]({{< ref "docs/shortcodes" >}}) quando precisar. Adicione botões, alertas, ícones, abas, galerias, gráficos, diagramas, cards do GitHub, vídeos e exemplos de código sem manter templates pontuais.
|
|
|
|
O Blowfish também cuida do que está ao redor do conteúdo: imagens de destaque e miniaturas responsivas, busca, ferramentas de leitura, índices, metadados sociais e de SEO, dados estruturados, controles de acessibilidade e analytics, comentários ou visualizações e curtidas com Firebase opcionais.
|
|
|
|
## Para cada leitor
|
|
|
|
Crie sites multilíngues com conteúdo traduzido, menus por idioma e traduções de interface incluídas. O Blowfish suporta idiomas RTL e LTR no mesmo projeto, além de alternância de aparência, navegação responsiva e busca acessível por teclado.
|
|
|
|
Por baixo do capô, o Blowfish usa recursos atuais do Hugo e Tailwind CSS 4, mantendo o modelo de conteúdo e configuração claro e sob seu controle.
|
|
|
|
## Dê ao seu agente o contexto necessário
|
|
|
|
O Blowfish inclui uma [skill para agentes](https://github.com/nunocoracao/blowfish/tree/main/.claude/skills/blowfish) para agentes de programação com IA como o Claude Code. Ela ensina onde fica a configuração, como funcionam layouts e front matter, quais shortcodes existem e como criar um site Blowfish sem adivinhações.
|
|
|
|
Instale-a no Claude Code:
|
|
|
|
```shell
|
|
/plugin marketplace add nunocoracao/blowfish
|
|
/plugin install blowfish@blowfish
|
|
```
|
|
|
|
Você também pode copiar a skill para `.claude/skills/blowfish/` no projeto. O agente poderá ajudar com configuração, estrutura de conteúdo, design de páginas e implementação consciente do tema, enquanto seu site continua no repositório.
|
|
|
|
## Escolha o próximo passo
|
|
|
|
- Novo no Blowfish? Comece pela [Instalação]({{< ref "docs/installation" >}}).
|
|
- Quer dar forma ao site? Leia [Primeiros passos]({{< ref "docs/getting-started" >}}) e [Configuração]({{< ref "docs/configuration" >}}).
|
|
- Quer ver as possibilidades? Explore [Shortcodes]({{< ref "docs/shortcodes" >}}), [Amostras]({{< ref "samples" >}}) e a [Galeria]({{< ref "examples" >}}).
|
|
- Vai migrar um site existente? Siga o [guia de atualização para o Blowfish 3]({{< ref "guides/202608-upgrade-to-blowfish-v3" >}}).
|