hugo search fuse js

Pesquisa ao vivo do Hugo usando Fuse.js e Mark.js

Este não é um tema independente. Este é um componente do tema Hugo.

Para usar este componente,

1. Adicione isto ao arquivo de configuração TOML do seu site:

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

2. Execute hugo mod tidy no diretório principal do site. O repositório principal do site também precisa ser um módulo Hugo (precisa ter seu próprio go.mod ). Para torná-lo um, execute hugo mod init <your site url or any unique string> no repositório do seu site antes de executar esta etapa.

3. Crie content/search.md com o parâmetro layout definido como "search" e o parâmetro output definido como ["html", "json"] . O conteúdo ou corpo deste search.md não é usado pelo modelo search.html que faz parte deste componente do tema.

   Aqui está um exemplo search.md :

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

Requisitos

Você precisa instalar a versão mais recente do Go em https://go.dev/doc/install porque este componente do tema requer comandos hugo mod .. para funcionar.

Esta atualização na mudança para o uso de Módulos Hugo foi testada pela última vez com Hugo v0.92.0.

1. Seu tema principal deve ser estruturado usando modelo base e blocos, e
2. O modelo base precisa definir os blocos main e footer (mostrados no link anterior).

Se o tema principal não atender a esses requisitos, você precisará editar a parte search.html para que a pesquisa funcione. Você pode encontrá-lo em layouts/_default/search.html neste componente.

E se o tema principal não tiver baseof.html ?

Você tem duas opções:

1. Edite o search.html para adequá-lo ao seu tema.
2. Atualize o tema para usar a nova abordagem "modelo base e blocos".

E se o tema principal tiver baseof.html , mas não tiver os blocos main e/ou footer ?

É muito fácil adicionar esses blocos sem quebrar o tema existente.

Para adicionar o bloco main , adicione-o ao seu baseof.html no local apropriado:

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

E da mesma forma adicione o seguinte se o bloco footer estiver faltando:

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

Por exemplo, consulte o snippet baseof.html nos documentos do Hugo.

Créditos

• Funcionalidade de pesquisa por fuse.js.
• Destaque de palavras-chave por mark.js.
• Implementação inicial do Hugo por @eddiewebb nesta essência.
• Embalagem de componentes tema Hugo por @kaushalmodi.
• Remoção de jQuery e integração de polyfill do IE por @lpar.
• Polyfills de compatibilidade com o IE:
  • Promessas
  • Buscar
  • URLSearchParams
  • API de modelo e fragmento
  • Nó.remove