blowfish/README.pt-pt.md

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

Blowfish

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

🌏 Site de demonstração 📑 Documentação do tema 💎 Loja de merchandising 🐛 Relatórios de erros & problemas 💡 Questões & pedidos de funcionalidades

Funcionalidades

• Layout totalmente responsivo construído com Tailwind CSS 3.0
• Múltiplos esquemas de cores (ou personalize completamente o seu próprio)
• Modo escuro (forçado ligado/desligado ou alternância automática com seletor do utilizador)
• Configuração altamente personalizável
• Integração com Firebase para suportar dados dinâmicos
• Contagem de visualizações & mecanismo de gostos
• Artigos relacionados
• Múltiplos layouts de página inicial
• 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 & menu de sub-navegação
• Índice de conteúdos com scroll
• Suporte para conteúdo multilingue incluindo suporte para línguas RTL
• Capacidade de criar links para publicações em sites de terceiros
• Suporte para vários shortcodes como Gallery, Timeline, GitHub cards e Carousels
• Sintaxe GitHub Alerts, 15 tipos, suporte para elementos expansíveis
• Integração Buymeacoffee
• Pesquisa no site do lado do cliente alimentada por Fuse.js
• Diagramas e visualizações usando Mermaid
• Gráficos usando Chart.js
• Integração TypeIt
• Embeds de Youtube com melhorias de desempenho
• Notação matemática usando KaTeX
• Ícones SVG do FontAwesome 6
• Redimensionamento automático de imagens usando Hugo Pipes
• Âncoras de cabeçalhos, Índices de Conteúdos, Cópia de código, Botões, Badges e mais
• Suporte HTML e Emoji em artigos 🎉
• Otimizado para SEO com links para partilha em redes sociais
• Suporte para Fathom Analytics e Google Analytics
• Feeds RSS, Favicons e suporte para comentários
• Personalização avançada usando definições simples de cores e estilos do Tailwind
• Otimizado para desempenho e acessibilidade com pontuações perfeitas no Lighthouse
• Totalmente documentado com atualizações regulares

---

Documentação

Blowfish tem documentação extensa que cobre todos os aspetos do tema. Certifique-se de ler a documentação para saber mais sobre como usar o tema e as suas funcionalidades.

---

Instalação

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

Instruções detalhadas para cada método podem ser encontradas na documentação de Instalação. 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 estiver a usar git, ou módulos Hugo se já está confiante na instalação de temas Hugo.

Início rápido usando Blowfish Tools

Nota: Certifique-se de que tem Node.js, Git e Hugo instalados, e que criou um novo projeto Hugo antes de continuar.

Acabámos de lançar uma nova ferramenta CLI para ajudá-lo a começar com Blowfish. Ela irá criar um novo projeto Hugo, instalar o tema e configurar os ficheiros de configuração do tema para si. Ainda está em beta por isso reporte quaisquer problemas que encontrar.

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

npm i -g blowfish-tools

Depois execute o comando blowfish-tools para iniciar uma execução interativa que irá guiá-lo através da criação e casos de uso de configuração.

blowfish-tools

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

blowfish-tools new mynewsite

Início rápido usando submódulos git

Nota: Certifique-se de que tem Git e Hugo instalados, e que criou um novo projeto Hugo antes de continuar.

1. A partir 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, elimine o ficheiro hugo.toml que foi gerado pelo Hugo. Copie os ficheiros de configuração *.toml do tema para a sua pasta config/_default/.

   Irá encontrar estes ficheiros de configuração do tema no diretório de cache do Hugo, ou descarregue uma cópia do GitHub.

4. Siga as instruções de Introdução para configurar o seu site.

Início rápido usando Hugo

Nota: Certifique-se de que tem Go e Hugo instalados, e que criou um novo projeto Hugo antes de continuar.

1. A partir do diretório do seu projeto, inicialize os Módulos Hugo:

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

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

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

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

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

   Nota: Não sobrescreva o ficheiro module.toml que criou acima!

   Irá encontrar estes ficheiros de configuração do tema no diretório de cache do Hugo, ou descarregue uma cópia do GitHub.

5. Siga as instruções de Introdução para configurar o seu site.

Instalar atualizações do tema

À medida que novas versões são publicadas, pode atualizar o tema usando Hugo. Simplesmente execute hugo mod get -u a partir do diretório do seu projeto e o tema será automaticamente atualizado para a versão mais recente.

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

---

Contribuir

Espera-se que Blowfish evolua ao longo do tempo. Pretendo continuar a adicionar funcionalidades e fazer alterações conforme necessário.

Sinta-se à vontade para entrar em contacto com quaisquer problemas ou sugestões para novas funcionalidades que gostaria de ver.

• 🐛 Relatórios de erros & problemas: Use GitHub Issues
• 💡 Ideias para novas funcionalidades: Abra uma discussão em GitHub Discussions
• 🙋‍♀️ Questões gerais: Dirija-se a GitHub Discussions

Se conseguir corrigir um erro ou implementar uma nova funcionalidade, aceito PRs para este propósito. Saiba mais nas diretrizes de contribuição.

---

Stargazers ao longo do tempo

Mastodon