mirror of
https://github.com/nunocoracao/blowfish.git
synced 2026-01-30 16:31:52 +01:00
212 lines
9.4 KiB
Markdown
212 lines
9.4 KiB
Markdown
---
|
|
title: "Instalación"
|
|
weight: 2
|
|
draft: false
|
|
description: "Cómo instalar el tema Blowfish."
|
|
slug: "installation"
|
|
tags: ["instalación", "documentación"]
|
|
series: ["Documentación"]
|
|
series_order: 2
|
|
---
|
|
|
|
Simplemente sigue el procedimiento estándar de Hugo [Inicio Rápido](https://gohugo.io/getting-started/quick-start/) 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-de-actualizaciones).
|
|
|
|
## 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](https://gohugo.io/getting-started/installing). 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](https://gohugo.io/getting-started/installing).
|
|
|
|
### 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](https://github.com/nunocoracao/blowfish-tools).
|
|
|
|
Instala la herramienta CLI globalmente usando npm (u otro gestor de paquetes):
|
|
```shell
|
|
npx blowfish-tools
|
|
```
|
|
o
|
|
|
|
```shell
|
|
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.
|
|
```shell
|
|
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.
|
|
```shell
|
|
blowfish-tools new mynewsite
|
|
```
|
|
|
|
Aquí hay un video corto de lo rápido que es empezar con Blowfish usando la herramienta CLI:
|
|
|
|
<iframe width="100%" height="350" src="https://www.youtube.com/embed/SgXhGb-7QbU?si=ce44baicuQ6zMeXz" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
|
|
|
|
### 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](#instalación-con-git) (recomendado)
|
|
- [Módulo Hugo](#instalación-con-hugo)
|
|
- [Copia manual de archivos](#instalación-manual)
|
|
|
|
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.
|
|
|
|
```bash
|
|
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](#configurar-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](https://golang.org/dl/) 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 >}}
|
|
|
|
2. Desde el directorio de tu proyecto Hugo (que creaste arriba), inicializa los módulos para tu sitio:
|
|
|
|
```shell
|
|
# 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:
|
|
|
|
```toml
|
|
[[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](#configurar-archivos-de-configuración-del-tema).
|
|
|
|
#### Instalación manual
|
|
|
|
1. 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 >}}
|
|
|
|
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).
|
|
|
|
#### 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](https://github.com/nunocoracao/blowfish/releases/latest/download/config-default.zip) 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í:
|
|
|
|
```shell
|
|
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](https://github.com/nunocoracao/blowfish/releases) 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](#actualización-con-git)
|
|
- [Módulo Hugo](#actualización-con-hugo)
|
|
- [Copia manual de archivos](#actualización-manual)
|
|
|
|
### 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:
|
|
|
|
```shell
|
|
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:
|
|
|
|
```shell
|
|
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 >}}
|
|
|
|
1. 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 >}}
|
|
|
|
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.
|