blowfish/index.es.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

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.

{{< alert >}} Asegúrate de estar usando Hugo versión 0.141.0 o posterior, ya que el tema aprovecha algunas de las últimas características de Hugo. {{< /alert >}}

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

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.

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

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

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

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"
```
Inicia tu servidor usando hugo server y el tema se descargará automáticamente.
Continúa para configurar los archivos de configuración del tema.

Instalación manual

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

{{< button href="https://github.com/nunocoracao/blowfish/releases/latest" target="_blank" >}}Descargar desde Github{{< /button >}}
Extrae el archivo, renombra la carpeta a blowfish y muévela al directorio themes/ dentro de la carpeta raíz de tu proyecto Hugo.
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.

{{< alert >}} Nota: ¡No debes sobrescribir el archivo module.toml si ya existe uno en tu proyecto! {{< /alert >}}

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

{{< alert >}} Importante: Si no usaste Módulos Hugo para instalar Blowfish, debes añadir la línea theme = "blowfish" en la parte superior de tu archivo hugo.toml. {{< /alert >}}

Siguientes pasos

La instalación básica de Blowfish está ahora completa. Continúa a la sección [Primeros Pasos]({{< ref "getting-started" >}}) 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.

{{< alert >}} Ten en cuenta que cualquier personalización local que hayas hecho a los archivos del tema se perderá durante este proceso. {{< /alert >}}

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

{{< button href="https://github.com/nunocoracao/blowfish/releases/latest" target="_blank" >}}Descargar desde Github{{< /button >}}
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.
Reconstruye tu sitio y verifica que todo funcione como se esperaba.

9.4 KiB Raw Blame History