hugo search fuse js

Búsqueda en vivo de Hugo usando Fuse.js y Mark.js

Este no es un tema independiente. Este es un componente del tema Hugo.

Para utilizar este componente,

1. Agregue esto al archivo de configuración TOML de su sitio:

   [ module ]
     [[ module . imports ]]
       path = " github.com/kaushalmodi/hugo-search-fuse-js "

2. Ejecute hugo mod tidy en el directorio principal de su sitio. El repositorio del sitio principal también debe ser un módulo Hugo (debe tener su propio go.mod ). Para convertirlo en uno, ejecute hugo mod init <your site url or any unique string> en el repositorio de su sitio antes de realizar este paso.

3. Cree content/search.md con el parámetro layout establecido en "buscar" y el parámetro output establecido en ["html", "json"] . El contenido o el cuerpo de este search.md no lo utiliza la plantilla search.html que forma parte de este componente de tema.

   Aquí hay un ejemplo search.md :

    +++
   title = " Search "
   layout = " search "
   outputs = [ " html " , " json " ]
   [ sitemap ]
     priority = 0.1
   +++

Requisitos

Debe instalar la última versión de Go desde https://go.dev/doc/install porque este componente del tema requiere comandos hugo mod .. para funcionar.

Esta actualización sobre el cambio al uso de módulos Hugo se probó por última vez con Hugo v0.92.0.

1. Su tema principal debe estar estructurado utilizando una plantilla y bloques base, y
2. La plantilla base debe definir los bloques main y footer (que se muestran en el enlace anterior).

Si el tema principal no cumple con estos requisitos, deberá editar el archivo parcial search.html para que la búsqueda funcione. Puede encontrarlo en layouts/_default/search.html en este componente.

¿Qué pasa si el tema principal no tiene baseof.html ?

Tienes dos opciones:

1. Edite search.html para que se ajuste a su tema.
2. Actualice el tema para utilizar el nuevo enfoque de "plantilla base y bloques".

¿Qué pasa si el tema principal tiene baseof.html , pero no tiene los bloques main y/o footer ?

Es muy fácil agregar esos bloques sin romper el tema existente.

Para agregar el bloque main , agregue esto a su baseof.html en el lugar apropiado:

 {{ block "main" . }}{{ end }}

Y de manera similar agregue lo siguiente si falta el bloque footer :

 {{ block "footer" . }}{{ end }}

Para ver un ejemplo, consulte el fragmento baseof.html en los documentos de Hugo.

Créditos

• Funcionalidad de búsqueda por fuse.js.
• Resaltado de palabras clave por mark.js.
• Implementación inicial de Hugo por @eddiewebb en esta esencia.
• Empaquetado de componentes del tema Hugo por @kaushalmodi.
• Eliminación de jQuery e integración de IE polyfill por @lpar.
• Polyfills de compatibilidad con IE:
  • Promesas
  • Buscar
  • Parámetros de búsqueda de URL
  • API de plantilla y fragmento
  • Nodo.eliminar