From 769ac0e624b6f817d3846309da154f65837a8ea6 Mon Sep 17 00:00:00 2001
From: George Cushen <gcushen@users.noreply.github.com>
Date: Wed, 7 Sep 2022 21:51:28 +0100
Subject: [PATCH] feat: add support for Algolia Docsearch

In params.yaml:

```
  search:
    provider: docsearch
    docsearch:
      app_id: ''
      api_key: ''
      index_name: ''
```
---
 modules/wowchemy/layouts/partials/book_sidebar.html | 2 ++
 modules/wowchemy/layouts/partials/navbar.html       | 5 +++--
 modules/wowchemy/layouts/partials/site_head.html    | 2 ++
 modules/wowchemy/layouts/partials/site_js.html      | 4 ++++
 4 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/modules/wowchemy/layouts/partials/book_sidebar.html b/modules/wowchemy/layouts/partials/book_sidebar.html
index a21cf56e..b9b7fb58 100644
--- a/modules/wowchemy/layouts/partials/book_sidebar.html
+++ b/modules/wowchemy/layouts/partials/book_sidebar.html
@@ -21,6 +21,8 @@
     <span class="sidebar-search-text">{{ i18n "search_placeholder" }}</span>
     <span class="sidebar-search-shortcut">/</span>
   </button>
+  {{ else if eq (lower site.Params.features.search.provider) "docsearch" }}
+  <div id="docsearch"></div>
   {{ end }}
 </form>
 
diff --git a/modules/wowchemy/layouts/partials/navbar.html b/modules/wowchemy/layouts/partials/navbar.html
index 2b2d5af6..6d79dd1b 100644
--- a/modules/wowchemy/layouts/partials/navbar.html
+++ b/modules/wowchemy/layouts/partials/navbar.html
@@ -13,7 +13,7 @@
   {{ $logo = (partial "functions/get_logo" (dict "constraint" "max_height" "size" 70)) }}
 {{ end }}
 
-<header class="header--fixed">
+<header>
   <nav class="navbar navbar-expand-lg navbar-light compensate-for-scrollbar" id="navbar-main">
     <div class="container-xl">
 
@@ -157,8 +157,9 @@
           {{ end }}
         {{ end }}
 
+        {{/* Override: hide search icon if provider is Docsearch so we only show Docsearch once in the docs sidebar. */}}
         {{ $show_search := site.Params.header.navbar.show_search | default true }}
-        {{ if and site.Params.features.search.provider $show_search }}
+        {{ if and site.Params.features.search.provider $show_search | and (ne (lower site.Params.features.search.provider) "docsearch") }}
         <li class="nav-item">
           <a class="nav-link js-search" href="#" aria-label="{{ i18n "search" }}"><i class="fas fa-search" aria-hidden="true"></i></a>
         </li>
diff --git a/modules/wowchemy/layouts/partials/site_head.html b/modules/wowchemy/layouts/partials/site_head.html
index fc0d7faa..8dbbf2ec 100644
--- a/modules/wowchemy/layouts/partials/site_head.html
+++ b/modules/wowchemy/layouts/partials/site_head.html
@@ -108,6 +108,8 @@
 
     {{ if eq (lower site.Params.features.search.provider) "algolia" }}
       {{ printf "<link rel=\"stylesheet\" href=\"%s\" integrity=\"%s\" crossorigin=\"anonymous\">" (printf $css.instantsearch.url $css.instantsearch.version) $css.instantsearch.sri | safeHTML }}
+    {{ else if eq (lower site.Params.features.search.provider) "docsearch" }}
+      <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@docsearch/css@3" />
     {{ end }}
 
     {{/* Load async scripts. */}}
diff --git a/modules/wowchemy/layouts/partials/site_js.html b/modules/wowchemy/layouts/partials/site_js.html
index ef68a87f..be9f0fb9 100644
--- a/modules/wowchemy/layouts/partials/site_js.html
+++ b/modules/wowchemy/layouts/partials/site_js.html
@@ -89,6 +89,10 @@
     {{ printf "<script src=\"%s\" crossorigin=\"anonymous\"></script>" (printf $js.instantsearch.url $js.instantsearch.version) | safeHTML }}
   {{ end }}
   {{ $algoliaConfig = dict "appId" (site.Params.features.search.algolia.app_id | default "") "apiKey" (site.Params.features.search.algolia.api_key | default "") "indexName" (site.Params.features.search.algolia.index_name | default "") "analytics" (site.Params.features.search.algolia.analytics | default false) "personalization" (site.Params.features.search.algolia.personalization | default false) }}
+{{ else if eq $search_provider "docsearch" }}
+  {{ $docsearch_config := dict "appId" (site.Params.features.search.docsearch.app_id | default "") "apiKey" (site.Params.features.search.docsearch.api_key | default "") "indexName" (site.Params.features.search.docsearch.index_name | default "") "container" (site.Params.features.search.docsearch.container | default "#docsearch") }}
+  <script src="https://cdn.jsdelivr.net/npm/@docsearch/js@3"></script>
+  {{ printf "<script>docsearch(%s);</script>" ($docsearch_config | jsonify) | safeHTML }}
 {{ end }}
 
 {{/* Charts */}}