9.8 KiB
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 💎 Tienda de merchandising 🐛 Reportes de errores y problemas 💡 Preguntas y solicitudes de funcionalidades
Características
- Diseño totalmente responsive construido con Tailwind CSS 3.0
- 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)
- 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 diseños de página de inicio
- 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
- Soporte para varios shortcodes como Gallery, Timeline, GitHub cards y Carousels
- Sintaxis de GitHub Alerts, 15 tipos, soporte plegable
- Integración con Buymeacoffee
- 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 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.
Acabamos de lanzar una nueva herramienta CLI para ayudarte a comenzar 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):
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.
-
Desde el directorio de tu proyecto, inicializa git:
git init -
Configura Blowfish como un submódulo de git:
git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blowfish -
En la carpeta raíz de tu sitio web, elimina el archivo
hugo.tomlque fue generado por Hugo. Copia los archivos de configuración*.tomldel tema en tu carpetaconfig/_default/.Encontrarás estos archivos de configuración del tema en el directorio de caché de Hugo, o descarga una copia desde GitHub.
-
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.
-
Desde el directorio de tu proyecto, inicializa los Módulos de Hugo:
hugo mod init github.com/<username>/<repo-name> -
Crea
config/_default/module.tomly agrega lo siguiente:[[imports]] path = "github.com/nunocoracao/blowfish/v2" -
Inicia tu servidor usando
hugo servery el tema se descargará automáticamente. -
En la carpeta raíz de tu sitio web, elimina el archivo
hugo.tomlque fue generado por Hugo. Copia los archivos de configuración*.tomldel tema en tu carpetaconfig/_default/.Nota: ¡No sobrescribas el archivo
module.tomlque creaste arriba!Encontrarás estos archivos de configuración del tema en el directorio de caché de Hugo, o descarga una copia desde GitHub.
-
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.
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.


