Package Exports

hydesearch
hydesearch/dist/HydeSearch.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (hydesearch) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Experimental Frontend Search Engine for Hyde Documentation Sites

jsDelivr hits (GitHub) NPM Downloads

#CodingInPublic

Contains both the frontend interface and the TypeScript source code for the plugin.

Usage

Add the following snippet to your HTML to define the position of the search input:

<div id="hyde-search">
    <noscript>
        The search feature requires JavaScript to be enabled in your browser.
    </noscript>
    <input type="search" name="search" id="search-input" placeholder="Search..." autocomplete="off">
</div>

Then, load and initialize the plugin:

<script src="dist/HydeSearch.js" defer></script>

<script>
    window.addEventListener('load', function() {
        // Replace with the HTTP location of your JSON search index.
        // Note that HydeSearch assumes the JSON is safe and trusted. Use strict CORS policies.
        const searchIndexLocation = 'tests/search.json';
        const Search = new HydeSearch(searchIndexLocation);

        Search.init();
    });
</script>

Contributing

PRs, issues, and feedback are welcome! I'd especially love to get help writing tests!

Development

While this tool was created to be used with HydePHP, and thus is rather opinionated, I imagine it can easily be used with any other static site generator.

If developing a third party integration, make sure that the generated JSON follows the expected searchindex schema.

License

The MIT License

hydesearch