blowfish/README.pt-br.md

English | Français | Deutsch | Português (PT) | Português (BR) | Español | 日本語 | 简体中文 | Indonesian

Blowfish

Blowfish foi projetado para ser um tema poderoso e leve para Hugo. É construído usando Tailwind CSS com um design limpo e minimalista que prioriza o seu conteúdo.

🌏 Site de demonstração 📑 Documentação do tema 💎 Loja de produtos 🐛 Relatórios de bugs e problemas 💡 Perguntas e solicitações de recursos

Recursos

• Layout totalmente responsivo construído com Tailwind CSS 4
• Múltiplos esquemas de cores (ou personalize completamente o seu próprio)
• Modo escuro (forçado ligado/desligado ou alternância automática com botão do usuário)
• Múltiplos layouts de página inicial, incluindo uma landing page estilo produto com imagem hero, estatísticas e grades de recursos
• Cabeçalho flutuante com efeito de vidro e atalho de busca ⌘K / Ctrl+K
• Tela de fundo global com seções hero que se dissolvem nela ao rolar a página
• Barra de progresso de leitura para artigos
• Seletor interativo de layouts da página inicial para pré-visualizações ao vivo
• Skill de agente para que agentes de programação com IA (como o Claude Code) instalem e configurem o tema para você
• Páginas adequadas para impressão com estilos de impressão dedicados
• Configuração altamente personalizável
• Integração com Firebase para suportar dados dinâmicos
• Contagem de visualizações e mecanismo de curtidas
• Artigos relacionados
• Múltiplos autores
• Séries de artigos
• Ordenação de artigos baseada em data e peso
• Modo zen para leitura de artigos
• Flexível com qualquer tipo de conteúdo, taxonomias e menus
• Menus de cabeçalho e rodapé
• Menus aninhados e menu de sub-navegação
• Índice com rolagem
• Suporte a conteúdo multilíngue incluindo suporte para idiomas RTL
• Capacidade de linkar para posts em sites de terceiros
• Mais de 40 shortcodes incluindo Gallery, Timeline, GitHub cards, Carousels, Stats, grades de recursos, Steps e botões CTA
• Sintaxe de alertas do GitHub, 15 tipos, suporte recolhível
• Integração com Buymeacoffee
• Busca no site do lado do cliente alimentada por Fuse.js
• Diagramas e visualizações usando Mermaid
• Gráficos usando Chart.js
• Integração com TypeIt
• Embeds do Youtube com melhorias de performance
• Notação matemática usando KaTeX
• Ícones SVG do FontAwesome 6
• Redimensionamento automático de imagens usando Hugo Pipes
• Âncoras de cabeçalho, Índices, Cópia de código, Botões, Badges e mais
• Suporte a HTML e Emoji em artigos 🎉
• SEO amigável com links para compartilhamento em redes sociais
• Suporte a Fathom Analytics e Google Analytics
• Suporte a feeds RSS, Favicons e comentários
• Personalização avançada usando definições simples de cores e estilos do Tailwind
• Otimizado para performance e acessibilidade com pontuações perfeitas no Lighthouse
• Totalmente documentado com atualizações regulares

---

Documentação

Blowfish possui documentação extensa que cobre todos os aspectos do tema. Certifique-se de ler a documentação para saber mais sobre como usar o tema e seus recursos.

---

Instalação

Blowfish suporta vários métodos de instalação - como submódulo git, Hugo Module, ou como uma instalação completamente manual.

Instruções detalhadas para cada método podem ser encontradas na documentação de Instalação. Você deve consultar a documentação para a experiência de configuração mais simples. Abaixo está um guia de início rápido usando submódulos se você estiver usando git, ou Hugo modules se você já estiver confiante em instalar temas Hugo.

Início rápido com um agente de IA

Blowfish inclui um agent skill que ensina agentes de programação com IA — como o Claude Code — a instalar, configurar e construir sites com o tema. Instale-o a partir do marketplace de plugins do Blowfish no Claude Code:

/plugin marketplace add nunocoracao/blowfish
/plugin install blowfish@blowfish

Ou simplesmente copie a pasta do skill para o repositório do seu site em .claude/skills/blowfish/ — os agentes detectam skills de projeto automaticamente. Depois peça ao seu agente para configurar o Blowfish para você.

Início rápido usando Blowfish Tools

Nota: Certifique-se de ter Node.js, Git e Hugo instalados, e que você criou um novo projeto Hugo antes de prosseguir.

Blowfish Tools é uma ferramenta CLI que ajuda você a começar com Blowfish. Ela criará um novo projeto Hugo, instalará o tema e configurará os arquivos de configuração do tema para você. Por favor reporte quaisquer problemas que encontrar.

Instale a ferramenta CLI globalmente usando npm (ou outro gerenciador de pacotes):

npm i -g blowfish-tools

Em seguida, execute o comando blowfish-tools para iniciar uma execução interativa que o guiará pelos casos de uso de criação e configuração.

blowfish-tools

Você também pode executar o comando blowfish-tools new para criar um novo projeto Hugo e instalar o tema de uma vez. Verifique a ajuda da CLI para mais informações.

blowfish-tools new mynewsite

Início rápido usando submódulos git

Nota: Certifique-se de ter Git e Hugo instalados, e que você criou um novo projeto Hugo antes de prosseguir.

1. Do diretório do seu projeto, inicialize o git:

   git init
   

2. Configure Blowfish como um submódulo git:

   git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blowfish
   

3. Na pasta raiz do seu site, exclua o arquivo hugo.toml que foi gerado pelo Hugo. Copie os arquivos de configuração *.toml do tema para sua pasta config/_default/.

   Você encontrará esses arquivos de configuração do tema no diretório de cache do Hugo, ou baixe uma cópia do GitHub.

4. Siga as instruções de Primeiros Passos para configurar seu site.

Início rápido usando Hugo

Nota: Certifique-se de ter Go e Hugo instalados, e que você criou um novo projeto Hugo antes de prosseguir.

1. Do diretório do seu projeto, inicialize os Hugo Modules:

   hugo mod init github.com/<username>/<repo-name>
   

2. Crie config/_default/module.toml e adicione o seguinte:

   [[imports]]
   path = "github.com/nunocoracao/blowfish/v3"
   

3. Inicie seu servidor usando hugo server e o tema será baixado automaticamente.

4. Na pasta raiz do seu site, exclua o arquivo hugo.toml que foi gerado pelo Hugo. Copie os arquivos de configuração *.toml do tema para sua pasta config/_default/.

   Nota: Não sobrescreva o arquivo module.toml que você criou acima!

   Você encontrará esses arquivos de configuração do tema no diretório de cache do Hugo, ou baixe uma cópia do GitHub.

5. Siga as instruções de Primeiros Passos para configurar seu site.

Instalando atualizações do tema

À medida que novos lançamentos são publicados, você pode atualizar o tema usando Hugo. Simplesmente execute hugo mod get -u do diretório do seu projeto e o tema será atualizado automaticamente para a versão mais recente.

Instruções detalhadas de atualização estão disponíveis na documentação.

Atualizando da v2 para a v3

Blowfish v3 é totalmente retrocompatível: todos os novos recursos são opcionais e nenhuma opção de configuração ou template foi removida. As instalações por submódulo git e manuais são atualizadas normalmente, sem alterações; usuários de módulos Hugo só precisam alterar o caminho de importação em config/_default/module.toml de github.com/nunocoracao/blowfish/v2 para github.com/nunocoracao/blowfish/v3 e executar hugo mod get -u. Consulte as instruções de atualização para mais detalhes.

---

Contribuindo

Blowfish deve evoluir ao longo do tempo. Pretendo continuar adicionando recursos e fazendo alterações conforme necessário.

Sinta-se à vontade para entrar em contato com quaisquer problemas ou sugestões de novos recursos que você gostaria de ver.

• 🐛 Relatórios de bugs e problemas: Use GitHub Issues
• 💡 Ideias para novos recursos: Abra uma discussão em GitHub Discussions
• 🙋‍♀️ Perguntas gerais: Vá para GitHub Discussions

Se você for capaz de corrigir um bug ou implementar um novo recurso, dou as boas-vindas a PRs para este propósito. Saiba mais nas diretrizes de contribuição.

---

Stargazers ao longo do tempo

Mastodon