blowfish/README.es.md

English | Français | Deutsch | Português (PT) | Português (BR) | Español | 日本語 | 简体中文 | Indonesian

Blowfish

Blowfish está diseñado para ser un tema potente y ligero para Hugo. Está construido usando Tailwind CSS con un diseño limpio y minimalista que prioriza tu contenido.

🌏 Sitio de demostración 📑 Documentación del tema 🐛 Reportes de errores y problemas 💡 Preguntas y solicitudes de funcionalidades

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 que cubre todos los aspectos del tema. Asegúrate de leer la documentación 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. 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 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:

/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.

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

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 de CLI para más información.

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:

   git init
   

2. Configura Blowfish como un submódulo de git:

   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 desde GitHub.

4. Sigue las instrucciones de Primeros Pasos 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:

   hugo mod init github.com/<username>/<repo-name>
   

2. Crea config/_default/module.toml y agrega lo siguiente:

   [[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 desde GitHub.

5. Sigue las instrucciones de Primeros Pasos 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 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 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
• 💡 Ideas para nuevas características: Abre una discusión en GitHub Discussions
• 🙋‍♀️ Preguntas generales: Dirígete a GitHub 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.

---

Mastodon