blowfish/index.pt-br.md at 6f6323ff55b71c610d64e72b88b44da05cd43449

dbrun/blowfish

Fork 0

mirror of https://github.com/nunocoracao/blowfish.git synced 2026-01-30 16:31:52 +01:00

Files

rxchi1d 6f6323ff55 chore(docs): align Hugo minimum version

2025-12-24 14:27:21 +08:00

9.4 KiB

Raw Blame History

title, weight, draft, description, slug, tags, series, series_order

title

weight

draft

description

slug

Instalação

Estas instruções vão te ajudar a começar com Hugo e Blowfish a partir de um estado completamente vazio. A maioria das dependências mencionadas neste guia pode ser instalada usando o gerenciador de pacotes de sua escolha para sua plataforma.

Instalar Hugo

Se você nunca usou Hugo antes, precisará instalá-lo em sua máquina local. Você pode verificar se já está instalado executando o comando hugo version.

{{< alert >}} Certifique-se de estar usando Hugo versão 0.141.0 ou posterior, pois o tema aproveita alguns dos recursos mais recentes do Hugo. {{< /alert >}}

Você pode encontrar instruções de instalação detalhadas para sua plataforma na documentação do Hugo.

Blowfish Tools (recomendado)

Acabamos de lançar uma nova ferramenta CLI para ajudá-lo a começar com o Blowfish. Ela criará um novo projeto Hugo, instalará o tema e configurará os arquivos de configuração do tema para você. Ainda está em beta, então por favor reporte quaisquer problemas que encontrar.

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

npx blowfish-tools

npm i -g blowfish-tools

Em seguida, execute o comando blowfish-tools para iniciar uma execução interativa que irá guiá-lo através dos 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 só vez. Verifique a ajuda do CLI para mais informações.

blowfish-tools new mynewsite

Aqui está um vídeo curto de quão rápido é começar com o Blowfish usando a ferramenta CLI:

Instalação sem CLI

Criar um novo site

Execute o comando hugo new site mywebsite para criar um novo site Hugo em um diretório chamado mywebsite.

Note que você pode nomear o diretório do projeto como quiser, mas as instruções abaixo assumem que ele se chama mywebsite. Se você usar um nome diferente, certifique-se de substituí-lo adequadamente.

Baixar o tema Blowfish

Existem várias maneiras diferentes de instalar o tema Blowfish em seu site Hugo. Da mais fácil para a mais difícil de instalar e manter, são:

Submódulo Git (recomendado)
Módulo Hugo
Cópia manual de arquivos

Se você não tem certeza, escolha o método do submódulo Git.

Instalação com Git

Este método é o mais rápido e fácil para manter o tema atualizado. Além do Hugo e Go, você também precisará garantir que o Git esteja instalado em sua máquina local.

Mude para o diretório do seu site Hugo (que você criou acima), inicialize um novo repositório git e adicione o Blowfish como submódulo.

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

Em seguida, continue para configurar os arquivos de configuração do tema.

Instalação com Hugo

Para este método, você usará o Hugo para gerenciar seus temas. O Hugo usa Go para inicializar e gerenciar módulos, então certifique-se de ter o go instalado antes de prosseguir.

Baixe e instale o Go. Você pode verificar se já está instalado usando o comando go version.

{{< alert >}} Certifique-se de estar usando Go versão 1.12 ou posterior, pois o Hugo exige isso para que os módulos funcionem corretamente. {{< /alert >}}

Do diretório do seu projeto Hugo (que você criou acima), inicialize os módulos para seu site:

# Se você está gerenciando seu projeto no GitHub
hugo mod init github.com/<username>/<repo-name>

# Se você está gerenciando seu projeto localmente
hugo mod init my-project

Adicione o tema à sua configuração criando um novo arquivo config/_default/module.toml e adicionando o seguinte:
```
[[imports]]
disable = false
path = "github.com/nunocoracao/blowfish/v2"
```
Inicie seu servidor usando hugo server e o tema será baixado automaticamente.
Continue para configurar os arquivos de configuração do tema.

Instalação manual

Baixe a versão mais recente do código-fonte do tema.

{{< button href="https://github.com/nunocoracao/blowfish/releases/latest" target="_blank" >}}Baixar do Github{{< /button >}}
Extraia o arquivo, renomeie a pasta para blowfish e mova-a para o diretório themes/ dentro da pasta raiz do seu projeto Hugo.
Continue para configurar os arquivos de configuração do tema.

Configurar arquivos de configuração do tema

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/. Isso garantirá que você tenha todas as configurações corretas do tema e permitirá personalizar facilmente o tema de acordo com suas necessidades.

{{< alert >}} Nota: Você não deve sobrescrever o arquivo module.toml se já existir um em seu projeto! {{< /alert >}}

Dependendo de como você instalou o tema, você encontrará os arquivos de configuração do tema em lugares diferentes:

Módulos Hugo: No diretório de cache do Hugo, ou baixe uma cópia do GitHub
Submódulo Git ou instalação manual: themes/blowfish/config/_default

Depois de copiar os arquivos, sua pasta de configuração deve ficar assim:

config/_default/
├─ hugo.toml
├─ languages.en.toml
├─ markup.toml
├─ menus.en.toml
├─ module.toml  # se você instalou usando Módulos Hugo
└─ params.toml

{{< alert >}} Importante: Se você não usou Módulos Hugo para instalar o Blowfish, você deve adicionar a linha theme = "blowfish" no topo do seu arquivo hugo.toml. {{< /alert >}}

Próximos passos

A instalação básica do Blowfish está agora completa. Continue para a seção [Primeiros Passos]({{< ref "getting-started" >}}) para saber mais sobre a configuração do tema.

Instalando atualizações

De tempos em tempos, novas versões serão publicadas que aplicam correções e adicionam novas funcionalidades ao tema. Para aproveitar essas mudanças, você precisará atualizar os arquivos do tema em seu site.

Como você fará isso dependerá do método de instalação que você escolheu quando o tema foi originalmente instalado. Instruções para cada método podem ser encontradas abaixo.

Submódulo Git
Módulo Hugo
Cópia manual de arquivos

Atualização com Git

Submódulos Git podem ser atualizados usando o comando git. Simplesmente execute o seguinte comando e a versão mais recente do tema será baixada em seu repositório local:

git submodule update --remote --merge

Depois que o submódulo for atualizado, reconstrua seu site e verifique se tudo funciona como esperado.

Atualização com Hugo

O Hugo torna a atualização de módulos super fácil. Simplesmente mude para o diretório do seu projeto e execute o seguinte comando:

hugo mod get -u

O Hugo atualizará automaticamente quaisquer módulos necessários para seu projeto. Ele faz isso inspecionando seus arquivos module.toml e go.mod. Se você tiver problemas com a atualização, verifique se esses arquivos ainda estão configurados corretamente.

Em seguida, simplesmente reconstrua seu site e verifique se tudo funciona como esperado.

Atualização manual

Atualizar o Blowfish manualmente requer que você baixe a cópia mais recente do tema e substitua a versão antiga em seu projeto.

{{< alert >}} Note que quaisquer personalizações locais que você tenha feito nos arquivos do tema serão perdidas durante este processo. {{< /alert >}}

Baixe a versão mais recente do código-fonte do tema.

{{< button href="https://github.com/nunocoracao/blowfish/releases/latest" target="_blank" >}}Baixar do Github{{< /button >}}
Extraia o arquivo, renomeie a pasta para blowfish e mova-a para o diretório themes/ dentro da pasta raiz do seu projeto Hugo. Você precisará sobrescrever o diretório existente para substituir todos os arquivos do tema.
Reconstrua seu site e verifique se tudo funciona como esperado.

9.4 KiB Raw Blame History