add Pagefind Search for bndtools website

see https://pagefind.app/docs/installation/
and https://pagefind.app/docs/

Signed-off-by: Christoph Rueger <[email protected]>

Author: chrisrueger

.github/scripts/docs.sh

@@ -4,3 +4,6 @@ gem --version
 bundle --version
 
 bundle exec jekyll build
+
+# create search index under _site/pagefind
+./pagefind --verbose --site _site

.github/workflows/cibuild.yml

@@ -36,6 +36,18 @@ jobs:
       with:
         ruby-version: 2.7
         bundler-cache: true
+    
+    # Download and install the Pagefind binary
+    # see releases: https://github.com/CloudCannon/pagefind/releases
+    - name: Install Pagefind for Search
+      run: |
+        curl -L https://github.com/CloudCannon/pagefind/releases/download/v1.3.0/pagefind-v1.3.0-x86_64-unknown-linux-musl.tar.gz \
+          -o pagefind.tar.gz
+        tar xzf pagefind.tar.gz
+        chmod +x pagefind
+    
     - name: Build
       run: |
         ./.github/scripts/docs.sh
+
+    

.gitignore

@@ -6,3 +6,4 @@
 /vendor/
 /bundler/
 .jekyll-metadata
+pagefind*

_config.yml

@@ -64,4 +64,5 @@ exclude:
   - '.project'
   - 'run.sh'
   - '/vendor'
+  - '/pagefind'
 

_layouts/baselayout.html

@@ -7,6 +7,15 @@
 
     <div class="row main-container">
 
+      <link href="/pagefind/pagefind-ui.css" rel="stylesheet">
+      <script src="/pagefind/pagefind-ui.js"></script>
+      <div id="search"></div>
+      <script>
+          window.addEventListener('DOMContentLoaded', (event) => {
+              new PagefindUI({ element: "#search", showSubResults: true });
+          });
+      </script>
+
       <!-- Main Content -->
       <div class="large-9 medium-8 medium-push-4 large-push-3 columns">
         <div class="off-canvas-wrap move" data-offcanvas>
@@ -21,8 +30,9 @@
             </aside>
 
             <!-- main content goes here -->
+            <main data-pagefind-body>
             {{content}}
-            
+            </main>
           <!-- close the off-canvas menu -->
           <a class="exit-off-canvas"></a>
 

run-pagefind.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+set -ev
+
+# Build into _site folder
+export BUNDLE_GEMFILE=$PWD/Gemfile
+bundle install --jobs=3 --retry=3 --path=vendor
+bundle exec jekyll clean
+bundle exec jekyll build -w --incremental 
+
+# Run and serve the _site folder with search working
+./pagefind --site _site --serve