mirror of
https://github.com/nunocoracao/blowfish.git
synced 2026-01-30 15:31:52 +00:00
Add 5 new languages to exampleSite: German, French, Spanish, Portuguese
Add complete translations for: - German (de) - French (fr) - Spanish (es) - Portuguese Brazil (pt-br) - Portuguese Portugal (pt-pt) Changes include: - Language config files (languages.*.toml) - Menu config files (menus.*.toml) - Translated docs section (16 files x 5 langs) - Translated homepage, guides, samples - Translated examples, authors, tags sections - Translated users section (112 dirs x 5 langs) - Fixed YAML front matter formatting in user files Hugo build now supports 9 languages total. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Nuno Coração
@@ -0,0 +1,211 @@
|
||||
---
|
||||
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.87.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.
|
||||
Reference in New Issue
Block a user