tetrabiodistributed / papra

Documentation repo for PAPRa - an open-source hardware (OSHW) Powered Air-Purifying Respirator (PAPR)
https://tetrabiodistributed.github.io/papra
MIT License
4 stars 7 forks source link

add dynamic search capability to navbar #43

Open capsulecorplab opened 3 years ago

capsulecorplab commented 3 years ago

Currently, the search bar in the navbar doesn't work, but even if it did, Docsy doesn't support dynamic search capability.

capsulecorplab commented 3 years ago

Closing this issue would likely require migrating to a new theme or re-scaffolding Hugo with a different static site generator. I'm currently experimenting with https://asciidocsy.netlify.app/docs, as it provides a good set of the features needed for a docs page, including dynamic search, permalinks, in-page edits, as well as built-in support for Asciidoc & Liquid, will be useful for generating PDF documents and other asciidoctor extensions that would enable out-of-the-box support for use cases s.a., #36 as well as #20. Will likely able to move forward with a migration after I publish a new docker image for https://github.com/capsulecorplab/asciidoctor-extended/, which is actually the base image for the image we're currently using.

capsulecorplab commented 3 years ago

Making some updates to the asciidoctor-extended base image that would serve to replace the Hugo-Asciidoctor-Plantuml docker image currently used for generating the PAPRa docs. The updated image would support dynamic search capability, pdf generation, revealjs, PlantUML, and the liquid template language used in dof, via the following asciidoctor extensions,

The image is tagged asciidocsy, since the updates are primarily intended to support Asciidocsy - a Jekyll theme, based on Docsy, with built-in support for Asciidoc (i.e., no need for Hugo's template language).

Feel free to add comments on the PR.