mirror of
https://github.com/nunocoracao/blowfish.git
synced 2026-10-10 22:09:31 +00:00
193 lines
11 KiB
Markdown
193 lines
11 KiB
Markdown
[English](https://github.com/nunocoracao/blowfish/blob/main/README.md) | [Français](https://github.com/nunocoracao/blowfish/blob/main/README.fr.md) | [Deutsch](https://github.com/nunocoracao/blowfish/blob/main/README.de.md) | [Português (PT)](https://github.com/nunocoracao/blowfish/blob/main/README.pt-pt.md) | [Português (BR)](https://github.com/nunocoracao/blowfish/blob/main/README.pt-br.md) | Español | [日本語](https://github.com/nunocoracao/blowfish/blob/main/README.ja.md) | [简体中文](https://github.com/nunocoracao/blowfish/blob/main/README.zh-cn.md) | [Indonesian](https://github.com/nunocoracao/blowfish/blob/main/README.id.md)
|
|
# Blowfish
|
|
[](https://app.netlify.com/sites/snazzy-dango-efb2ec/deploys)
|
|
[](https://github.com/gohugoio/hugo/releases/tag/v0.162.0)
|
|
[](https://github.com/nunocoracao/blowfish/blob/main/LICENSE)
|
|
[](https://themes.gohugo.io/themes/blowfish/)
|
|
|
|
|
|
Blowfish está diseñado para ser un tema potente y ligero para [Hugo](https://gohugo.io). Está construido usando Tailwind CSS con un diseño limpio y minimalista que prioriza tu contenido.
|
|
|
|
|
|
|
|
|
|
🌏 [Sitio de demostración](https://blowfish.page/)
|
|
📑 [Documentación del tema](https://blowfish.page/docs/)
|
|
🐛 [Reportes de errores y problemas](https://github.com/nunocoracao/blowfish/issues)
|
|
💡 [Preguntas y solicitudes de funcionalidades](https://github.com/nunocoracao/blowfish/discussions)
|
|
|
|
|
|
<a href="https://www.buymeacoffee.com/nunocoracao" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a>
|
|
|
|
|
|
## Características
|
|
|
|
- Diseño totalmente responsive construido con Tailwind CSS 4
|
|
- Múltiples esquemas de color (o personaliza completamente el tuyo propio)
|
|
- Modo oscuro (forzado activado/desactivado o cambio automático con opción de usuario)
|
|
- Múltiples diseños de página de inicio, incluyendo una landing page estilo producto con imagen hero, estadísticas y cuadrículas de características
|
|
- Encabezado flotante con efecto cristal y atajo de búsqueda ⌘K / Ctrl+K
|
|
- Lienzo de fondo global con secciones hero que se disuelven en él al hacer scroll
|
|
- Barra de progreso de lectura para artículos
|
|
- Selector interactivo de diseños de página de inicio para previsualizaciones en vivo
|
|
- Skill de agente para que los agentes de programación con IA (como Claude Code) instalen y configuren el tema por ti
|
|
- Páginas aptas para impresión con estilos de impresión dedicados
|
|
- Configuración altamente personalizable
|
|
- Integración con Firebase para soportar datos dinámicos
|
|
- Contador de vistas y mecanismo de likes
|
|
- Artículos relacionados
|
|
- Múltiples autores
|
|
- Series de artículos
|
|
- Ordenación de artículos basada en fecha y peso
|
|
- Modo zen para lectura de artículos
|
|
- Flexible con cualquier tipo de contenido, taxonomías y menús
|
|
- Menús de encabezado y pie de página
|
|
- Menús anidados y menú de sub-navegación
|
|
- Tabla de contenidos con desplazamiento
|
|
- Soporte de contenido multilingüe incluyendo idiomas RTL
|
|
- Capacidad de enlazar a publicaciones en sitios web de terceros
|
|
- Más de 40 shortcodes incluyendo Gallery, Timeline, GitHub cards, Carousels, Stats, cuadrículas de características, Steps y botones CTA
|
|
- Sintaxis de GitHub Alerts, 15 tipos, soporte plegable
|
|
- Integración con Buy Me a Coffee y Ko-fi
|
|
- Búsqueda en el sitio del lado del cliente impulsada por Fuse.js
|
|
- Diagramas y visualizaciones usando Mermaid
|
|
- Gráficos usando Chart.js
|
|
- Integración con TypeIt
|
|
- Incrustaciones de Youtube con mejoras de rendimiento
|
|
- Notación matemática usando KaTeX
|
|
- Iconos SVG de FontAwesome 6
|
|
- Redimensionamiento automático de imágenes usando Hugo Pipes
|
|
- Anclajes de encabezados, Tablas de contenidos, Copia de código, Botones, Insignias y más
|
|
- Soporte de HTML y Emoji en artículos 🎉
|
|
- SEO amigable con enlaces para compartir en redes sociales
|
|
- Soporte para Fathom Analytics y Google Analytics
|
|
- Feeds RSS, Favicons y soporte de comentarios
|
|
- Personalización avanzada usando definiciones de colores y estilos simples de Tailwind
|
|
- Optimizado para rendimiento y accesibilidad con puntuaciones perfectas en Lighthouse
|
|
- Completamente documentado con actualizaciones regulares
|
|
|
|
---
|
|
|
|
|
|
|
|
## Documentación
|
|
|
|
Blowfish tiene [documentación extensa](https://blowfish.page/docs/) que cubre todos los aspectos del tema. Asegúrate de [leer la documentación](https://blowfish.page/docs/) para aprender más sobre cómo usar el tema y sus características.
|
|
|
|
---
|
|
|
|
## Instalación
|
|
|
|
Blowfish soporta varios métodos de instalación - como submódulo de git, módulo de Hugo, o como una instalación completamente manual.
|
|
|
|
Las instrucciones detalladas para cada método se pueden encontrar en la documentación de [Instalación](https://blowfish.page/docs/installation). Deberías consultar la documentación para obtener la experiencia de configuración más simple. A continuación se presenta una guía de inicio rápido usando submódulos si estás usando git, o módulos de Hugo si ya tienes confianza instalando temas de Hugo.
|
|
|
|
### Inicio rápido con un agente de IA
|
|
|
|
Blowfish incluye un [agent skill](https://github.com/nunocoracao/blowfish/tree/main/.claude/skills/blowfish) que enseña a los agentes de programación con IA — como Claude Code — a instalar, configurar y construir sitios con el tema. Instálalo desde el marketplace de plugins de Blowfish en Claude Code:
|
|
|
|
```shell
|
|
/plugin marketplace add nunocoracao/blowfish
|
|
/plugin install blowfish@blowfish
|
|
```
|
|
|
|
O simplemente copia la carpeta del skill en el repositorio de tu sitio en `.claude/skills/blowfish/` — los agentes detectan los skills de proyecto automáticamente. Después pídele a tu agente que configure Blowfish por ti.
|
|
|
|
### Inicio rápido usando Blowfish Tools
|
|
|
|
> **Nota:** Asegúrate de tener **Node.js**, **Git** y **Hugo** instalados, y de haber creado un nuevo proyecto Hugo antes de continuar.
|
|
|
|
Blowfish Tools es una herramienta CLI que te ayuda a comenzar con Blowfish. Creará un nuevo proyecto Hugo, instalará el tema y configurará los archivos de configuración del tema por ti. 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
|
|
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 de CLI para más información.
|
|
```shell
|
|
blowfish-tools new mynewsite
|
|
```
|
|
|
|
### Inicio rápido usando submódulos de git
|
|
|
|
> **Nota:** Asegúrate de tener **Git** y **Hugo** instalados, y de haber creado un nuevo proyecto Hugo antes de continuar.
|
|
|
|
1. Desde el directorio de tu proyecto, inicializa git:
|
|
|
|
```shell
|
|
git init
|
|
```
|
|
|
|
2. Configura Blowfish como un submódulo de git:
|
|
|
|
```shell
|
|
git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blowfish
|
|
```
|
|
|
|
3. En la carpeta raíz de tu sitio web, elimina el archivo `hugo.toml` que fue generado por Hugo. Copia los archivos de configuración `*.toml` del tema en tu carpeta `config/_default/`.
|
|
|
|
Encontrarás estos archivos de configuración del tema en el directorio de caché de Hugo, o [descarga una copia](https://github.com/nunocoracao/blowfish/releases/latest/download/config-default.zip) desde GitHub.
|
|
|
|
4. Sigue las instrucciones de [Primeros Pasos](https://blowfish.page/docs/getting-started/) para configurar tu sitio web.
|
|
|
|
### Inicio rápido usando Hugo
|
|
|
|
> **Nota:** Asegúrate de tener **Go** y **Hugo** instalados, y de haber creado un nuevo proyecto Hugo antes de continuar.
|
|
|
|
1. Desde el directorio de tu proyecto, inicializa los Módulos de Hugo:
|
|
|
|
```shell
|
|
hugo mod init github.com/<username>/<repo-name>
|
|
```
|
|
|
|
2. Crea `config/_default/module.toml` y agrega lo siguiente:
|
|
|
|
```toml
|
|
[[imports]]
|
|
path = "github.com/nunocoracao/blowfish/v3"
|
|
```
|
|
|
|
3. Inicia tu servidor usando `hugo server` y el tema se descargará automáticamente.
|
|
|
|
4. En la carpeta raíz de tu sitio web, elimina el archivo `hugo.toml` que fue generado por Hugo. Copia los archivos de configuración `*.toml` del tema en tu carpeta `config/_default/`.
|
|
|
|
> **Nota:** ¡No sobrescribas el archivo `module.toml` que creaste arriba!
|
|
|
|
Encontrarás estos archivos de configuración del tema en el directorio de caché de Hugo, o [descarga una copia](https://github.com/nunocoracao/blowfish/releases/latest/download/config-default.zip) desde GitHub.
|
|
|
|
5. Sigue las instrucciones de [Primeros Pasos](https://blowfish.page/docs/getting-started/) para configurar tu sitio web.
|
|
|
|
### Instalación de actualizaciones del tema
|
|
|
|
A medida que se publiquen nuevas versiones, puedes actualizar el tema usando Hugo. Simplemente ejecuta `hugo mod get -u` desde el directorio de tu proyecto y el tema se actualizará automáticamente a la última versión.
|
|
|
|
Las [instrucciones de actualización](https://blowfish.page/docs/installation/#installing-updates) detalladas están disponibles en la documentación.
|
|
|
|
### Actualización de v2 a v3
|
|
|
|
Blowfish v3 es totalmente retrocompatible: cada nueva característica es opcional y no se ha eliminado ninguna opción de configuración ni plantilla. Las instalaciones con submódulo de git y manuales se actualizan como de costumbre sin cambios; los usuarios de módulos de Hugo solo tienen que cambiar la ruta de importación en `config/_default/module.toml` de `github.com/nunocoracao/blowfish/v2` a `github.com/nunocoracao/blowfish/v3` y ejecutar `hugo mod get -u`. Consulta las [instrucciones de actualización](https://blowfish.page/docs/installation/#upgrading-from-v2-to-v3) para más detalles.
|
|
|
|
---
|
|
|
|
## Contribuciones
|
|
|
|
Se espera que Blowfish evolucione con el tiempo. Tengo la intención de seguir agregando características y haciendo cambios según sea necesario.
|
|
|
|
Siéntete libre de ponerte en contacto con cualquier problema o sugerencia de nuevas características que te gustaría ver.
|
|
|
|
- 🐛 **Reportes de errores y problemas:** Usa [GitHub Issues](https://github.com/nunocoracao/blowfish/issues)
|
|
- 💡 **Ideas para nuevas características:** Abre una discusión en [GitHub Discussions](https://github.com/nunocoracao/blowfish/discussions)
|
|
- 🙋♀️ **Preguntas generales:** Dirígete a [GitHub Discussions](https://github.com/nunocoracao/blowfish/discussions)
|
|
|
|
Si puedes corregir un error o implementar una nueva característica, acepto PRs para este propósito. Aprende más en las [guías de contribución](https://github.com/nunocoracao/blowfish/blob/main/CONTRIBUTING.md).
|
|
|
|
---
|
|
|
|
<a rel="me" href="https://masto.ai/@blowfish">Mastodon</a>
|