Instalação

Simplesmente siga o procedimento padrão do Hugo Início Rápido para começar rapidamente.

Instruções detalhadas de instalação podem ser encontradas abaixo. Instruções para atualizar o tema também estão disponíveis.

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.

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

ou

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.

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

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

2. 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

3. 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"

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

5. Continue para configurar os arquivos de configuração do tema.

Instalação manual

#

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

   Baixar do Github

2. Extraia o arquivo, renomeie a pasta para blowfish e mova-a para o diretório themes/ dentro da pasta raiz do seu projeto Hugo.

3. 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.

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

Próximos passos

#

A instalação básica do Blowfish está agora completa. Continue para a seção Primeiros Passos 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.

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

   Baixar do Github

2. 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.

3. Reconstrua seu site e verifique se tudo funciona como esperado.