Instalación

Simplemente sigue el procedimiento estándar de Hugo Inicio Rápido para ponerte en marcha rápidamente.

Las instrucciones de instalación detalladas se encuentran a continuación. También están disponibles instrucciones para actualizar el tema.

Instalación

#

Estas instrucciones te ayudarán a empezar con Hugo y Blowfish desde un estado completamente vacío. La mayoría de las dependencias mencionadas en esta guía se pueden instalar utilizando el gestor de paquetes de tu elección para tu plataforma.

Instalar Hugo

#

Si nunca has usado Hugo antes, necesitarás instalarlo en tu máquina local. Puedes verificar si ya está instalado ejecutando el comando hugo version.

Puedes encontrar instrucciones de instalación detalladas para tu plataforma en la documentación de Hugo.

Blowfish Tools (recomendado)

#

Acabamos de lanzar una nueva herramienta CLI para ayudarte a empezar con Blowfish. Creará un nuevo proyecto Hugo, instalará el tema y configurará los archivos de configuración del tema por ti. Todavía está en beta, así que por favor reporta cualquier problema que encuentres.

Instala la herramienta CLI globalmente usando npm (u otro gestor de paquetes):

npx blowfish-tools

o

npm i -g blowfish-tools

Luego ejecuta el comando blowfish-tools para iniciar una ejecución interactiva que te guiará a través de los casos de uso de creación y configuración.

blowfish-tools

También puedes ejecutar el comando blowfish-tools new para crear un nuevo proyecto Hugo e instalar el tema de una sola vez. Consulta la ayuda del CLI para más información.

blowfish-tools new mynewsite

Aquí hay un video corto de lo rápido que es empezar con Blowfish usando la herramienta CLI:

Instalación sin CLI

#

Crear un nuevo sitio

#

Ejecuta el comando hugo new site mywebsite para crear un nuevo sitio Hugo en un directorio llamado mywebsite.

Ten en cuenta que puedes nombrar el directorio del proyecto como quieras, pero las instrucciones a continuación asumen que se llama mywebsite. Si usas un nombre diferente, asegúrate de sustituirlo en consecuencia.

Descargar el tema Blowfish

#

Hay varias formas diferentes de instalar el tema Blowfish en tu sitio Hugo. De la más fácil a la más difícil de instalar y mantener, son:

• Submódulo Git (recomendado)
• Módulo Hugo
• Copia manual de archivos

Si no estás seguro, elige el método del submódulo Git.

Instalación con Git

#

Este método es el más rápido y fácil para mantener el tema actualizado. Además de Hugo y Go, también necesitarás asegurarte de tener Git instalado en tu máquina local.

Cambia al directorio de tu sitio Hugo (que creaste arriba), inicializa un nuevo repositorio git y añade Blowfish como submódulo.

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

Luego continúa para configurar los archivos de configuración del tema.

Instalación con Hugo

#

Para este método usarás Hugo para gestionar tus temas. Hugo usa Go para inicializar y gestionar módulos, así que asegúrate de tener go instalado antes de continuar.

1. Descarga e instala Go. Puedes verificar si ya está instalado usando el comando go version.

   Asegúrate de estar usando Go versión 1.12 o posterior, ya que Hugo lo requiere para que los módulos funcionen correctamente.

2. Desde el directorio de tu proyecto Hugo (que creaste arriba), inicializa los módulos para tu sitio:

   # Si estás gestionando tu proyecto en GitHub
   hugo mod init github.com/<username>/<repo-name>
   
   # Si estás gestionando tu proyecto localmente
   hugo mod init my-project

3. Añade el tema a tu configuración creando un nuevo archivo config/_default/module.toml y añadiendo lo siguiente:

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

4. Inicia tu servidor usando hugo server y el tema se descargará automáticamente.

5. Continúa para configurar los archivos de configuración del tema.

Instalación manual

#

1. Descarga la última versión del código fuente del tema.

   Descargar desde Github

2. Extrae el archivo, renombra la carpeta a blowfish y muévela al directorio themes/ dentro de la carpeta raíz de tu proyecto Hugo.

3. Continúa para configurar los archivos de configuración del tema.

Configurar archivos de configuración del tema

#

En la carpeta raíz de tu sitio, elimina el archivo hugo.toml que fue generado por Hugo. Copia los archivos de configuración *.toml del tema en tu carpeta config/_default/. Esto asegurará que tengas todas las configuraciones correctas del tema y te permitirá personalizar fácilmente el tema según tus necesidades.

Dependiendo de cómo instalaste el tema, encontrarás los archivos de configuración del tema en diferentes lugares:

• Módulos Hugo: En el directorio de caché de Hugo, o descarga una copia desde GitHub
• Submódulo Git o instalación manual: themes/blowfish/config/_default

Una vez que hayas copiado los archivos, tu carpeta de configuración debería verse así:

config/_default/
├─ hugo.toml
├─ languages.en.toml
├─ markup.toml
├─ menus.en.toml
├─ module.toml  # si instalaste usando Módulos Hugo
└─ params.toml

Siguientes pasos

#

La instalación básica de Blowfish está ahora completa. Continúa a la sección Primeros Pasos para aprender más sobre la configuración del tema.

Instalación de actualizaciones

#

De vez en cuando se publicarán nuevas versiones que aplican correcciones y añaden nuevas funcionalidades al tema. Para aprovechar estos cambios, necesitarás actualizar los archivos del tema en tu sitio.

Cómo hagas esto dependerá del método de instalación que elegiste cuando se instaló originalmente el tema. Las instrucciones para cada método se encuentran a continuación.

• Submódulo Git
• Módulo Hugo
• Copia manual de archivos

Actualización con Git

#

Los submódulos Git se pueden actualizar usando el comando git. Simplemente ejecuta el siguiente comando y la última versión del tema se descargará en tu repositorio local:

git submodule update --remote --merge

Una vez que el submódulo se haya actualizado, reconstruye tu sitio y verifica que todo funcione como se esperaba.

Actualización con Hugo

#

Hugo hace que actualizar módulos sea super fácil. Simplemente cambia a tu directorio de proyecto y ejecuta el siguiente comando:

hugo mod get -u

Hugo actualizará automáticamente cualquier módulo requerido para tu proyecto. Lo hace inspeccionando tus archivos module.toml y go.mod. Si tienes problemas con la actualización, verifica que estos archivos todavía estén configurados correctamente.

Luego simplemente reconstruye tu sitio y verifica que todo funcione como se esperaba.

Actualización manual

#

Actualizar Blowfish manualmente requiere que descargues la última copia del tema y reemplaces la versión antigua en tu proyecto.

1. Descarga la última versión del código fuente del tema.

   Descargar desde Github

2. Extrae el archivo, renombra la carpeta a blowfish y muévela al directorio themes/ dentro de la carpeta raíz de tu proyecto Hugo. Necesitarás sobrescribir el directorio existente para reemplazar todos los archivos del tema.

3. Reconstruye tu sitio y verifica que todo funcione como se esperaba.