Documentación on Blowfish

Bienvenido a Blowfish

Mon, 01 Jan 0001 00:00:00 +0000

Blowfish está repleto de funcionalidades.

El objetivo original de Blowfish era desarrollar un tema simple y ligero. El tema es un fork de Congo y expande su visión inicial.

Instalación

Mon, 01 Jan 0001 00:00:00 +0000

Simplemente sigue el procedimiento estándar de Hugo Inicio Rápido 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.

Primeros Pasos

Mon, 01 Jan 0001 00:00:00 +0000

Esta sección asume que ya has instalado el tema Blowfish.

Acabamos de lanzar una herramienta CLI para ayudarte a empezar con Blowfish. Te ayudará con la instalación y configuración. Instala la herramienta CLI globalmente usando:

Configuración

Mon, 01 Jan 0001 00:00:00 +0000

Blowfish es un tema altamente personalizable y utiliza algunas de las últimas características de Hugo para simplificar su configuración.

El tema viene con una configuración predeterminada que te permite empezar con un blog básico o sitio web estático.

Diseño de página de inicio

Mon, 01 Jan 0001 00:00:00 +0000

Blowfish proporciona un diseño de página de inicio totalmente flexible. Hay dos plantillas principales para elegir con configuraciones adicionales para ajustar el diseño. Alternativamente, también puedes proporcionar tu propia plantilla y tener control total sobre el contenido de la página de inicio.

Shortcodes

Mon, 01 Jan 0001 00:00:00 +0000

Además de todos los shortcodes predeterminados de Hugo, Blowfish añade algunos adicionales para funcionalidad extra.

Alert
#

alert muestra su contenido como una caja de mensaje estilizada dentro de tu artículo. Es útil para llamar la atención sobre información importante que no quieres que el lector se pierda.

Front Matter

Mon, 01 Jan 0001 00:00:00 +0000

Además de los parámetros de front matter predeterminados de Hugo, Blowfish añade varias opciones adicionales para personalizar la presentación de artículos individuales. Todos los parámetros de front matter del tema disponibles se enumeran a continuación.

Múltiples autores

Mon, 01 Jan 0001 00:00:00 +0000

Algunos sitios web tienen más de un autor contribuyendo con contenido y por lo tanto requieren más de un único autor predeterminado para todo el sitio. Para esos casos de uso, Blowfish permite a los usuarios extender la lista de autores usando la función de múltiples autores.

Partials

Mon, 01 Jan 0001 00:00:00 +0000

Analytics
#

Blowfish proporciona soporte integrado para Fathom Analytics, Google Analytics y Umami Analytics. Fathom es una alternativa de pago a Google Analytics que respeta la privacidad del usuario.

Miniaturas

Mon, 01 Jan 0001 00:00:00 +0000

Miniaturas
#

Blowfish fue mejorado para facilitar añadir soporte visual a tus publicaciones. Para hacerlo, solo necesitas colocar un archivo de imagen (casi todos los formatos son soportados pero recomendamos .png o .jpg) que comience con feature* dentro del directorio principal de tu artículo, como se muestra en el ejemplo de abajo.

Ejemplos de contenido

Mon, 01 Jan 0001 00:00:00 +0000

Si has estado leyendo la documentación en orden, ahora deberías conocer todas las características y configuraciones disponibles en Blowfish. Esta página está diseñada para unir todo y ofrecer algunos ejemplos prácticos que podrías querer usar en tu proyecto Hugo.

Series

Mon, 01 Jan 0001 00:00:00 +0000

Blowfish proporciona una función para agrupar un conjunto de artículos bajo una “serie”. Colocar un artículo en una serie mostrará el resto de los artículos de la serie en cada página individual y proporcionará una forma rápida de navegar entre ellos. Puedes ver un ejemplo de esto arriba.

Personalización avanzada

Mon, 01 Jan 0001 00:00:00 +0000

Hay muchas formas de hacer cambios avanzados a Blowfish. Lee a continuación para aprender más sobre qué se puede personalizar y la mejor manera de lograr el resultado deseado.

Si necesitas más consejos, publica tus preguntas en GitHub Discussions.

Alojamiento y despliegue

Mon, 01 Jan 0001 00:00:00 +0000

Hay muchas formas de desplegar tu sitio web Hugo construido con Blowfish. El tema está diseñado para ser flexible en casi cualquier escenario de despliegue.

Blowfish usa URLs relativas en todo el tema. Esto permite que los sitios se desplieguen fácilmente en subcarpetas y hosts como GitHub Pages. Normalmente no se requiere ninguna configuración especial siempre que el parámetro baseURL haya sido configurado en el archivo hugo.toml.

Firebase: Vistas & Likes

Mon, 01 Jan 0001 00:00:00 +0000

Para poder soportar datos dinámicos en tu sitio web, hemos añadido soporte para integrar Firebase. Esto te permitirá usar la función de vistas en listas y publicaciones.

Ve al sitio web de Firebase y crea una cuenta gratis
Crea un nuevo proyecto
Selecciona la ubicación de analytics
Configura Firebase en Blowfish obteniendo las variables para tu proyecto y configurándolas en el archivo params.toml. Más detalles se pueden encontrar en esta página. Puedes encontrar un ejemplo del archivo que Firebase proporcionará abajo, observa los parámetros dentro del objeto FirebaseConfig.

// Import the functions you need from the SDKs you need
import { initializeApp } from "firebase/app";
import { getAnalytics } from "firebase/analytics";
// TODO: Add SDKs for Firebase products that you want to use
// https://firebase.google.com/docs/web/setup#available-libraries

// Your web app's Firebase configuration
// For Firebase JS SDK v7.20.0 and later, measurementId is optional
const firebaseConfig = {
  apiKey: "AIzaSyB5tqlqDky77Vb4Tc4apiHV4hRZI18KGiY",
  authDomain: "blowfish-21fff.firebaseapp.com",
  projectId: "blowfish-21fff",
  storageBucket: "blowfish-21fff.appspot.com",
  messagingSenderId: "60108104191",
  appId: "1:60108104191:web:039842ebe1370698b487ca",
  measurementId: "G-PEDMYR1V0K"
};

// Initialize Firebase
const app = initializeApp(firebaseConfig);
const analytics = getAnalytics(app);

Configurar Firestore - Selecciona Build y abre Firestore. Crea una nueva base de datos y elige iniciar en modo producción. Selecciona la ubicación del servidor y espera. Una vez iniciado, necesitas configurar las reglas. Simplemente copia y pega el archivo de abajo y presiona publicar. Estas reglas aseguran que las vistas solo pueden incrementarse en 1, y los likes solo pueden cambiarse en +1 o -1 (y nunca bajar de 0).

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    // Views - read anyone, only increment by 1
    match /views/{document} {
      allow read: if request.auth != null;
      allow create: if request.auth != null
                    && request.resource.data.keys().hasOnly(['views'])
                    && request.resource.data.views == 1;
      allow update: if request.auth != null
                    && request.resource.data.diff(resource.data).affectedKeys().hasOnly(['views'])
                    && request.resource.data.views == resource.data.views + 1;
    }

    // Likes - read anyone, only +1 or -1
    match /likes/{document} {
      allow read: if request.auth != null;
      allow create: if request.auth != null
                    && request.resource.data.keys().hasOnly(['likes'])
                    && request.resource.data.likes == 1;
      allow update: if request.auth != null
                    && request.resource.data.diff(resource.data).affectedKeys().hasOnly(['likes'])
                    && (request.resource.data.likes == resource.data.likes + 1
                        || request.resource.data.likes == resource.data.likes - 1)
                    && request.resource.data.likes >= 0;
    }

    // Deny everything else
    match /{document=**} {
      allow read, write: if false;
    }
  }
}

Habilitar autorización anónima - Selecciona Build y abre Authentication. Selecciona comenzar, haz clic en Anónimo y actívalo, guarda.
Disfruta - ahora puedes activar vistas y likes en Blowfish para todos (o específicos) artículos.

Documentación on Blowfish

Bienvenido a Blowfish

Instalación

Primeros Pasos

Configuración

Diseño de página de inicio

Shortcodes

Alert #

Front Matter

Múltiples autores

Partials

Analytics #

Miniaturas

Miniaturas #

Ejemplos de contenido

Series

Personalización avanzada

Alojamiento y despliegue

Firebase: Vistas & Likes

Alert
#

Analytics
#

Miniaturas
#