From acd74954b5dd0a10f683744d11635bb1b1b76076 Mon Sep 17 00:00:00 2001
From: Geo <gcushen@users.noreply.github.com>
Date: Fri, 3 Jun 2022 00:40:52 +0100
Subject: [PATCH] feat: more flexible hooks system

1. Use more standard hook names:
- head-start
- head-end
- body-end
- footer-start
- toc-start
- toc-end

2. Enable multiple files per hook. For example, a starter template may have `hooks/head-end/tpl.html` and a user may have customizations in `hooks/head-end/user.html`

custom_head.html -> hooks/head-end/custom.html
custom_js.html -> hooks/body-end/custom.html

Deprecates custom_head.html and custom_js.html but they remain supported for now.
---
 wowchemy/layouts/partials/book_layout.html    |   4 +-
 wowchemy/layouts/partials/custom_head.html    |   4 -
 wowchemy/layouts/partials/custom_js.html      |   4 -
 .../layouts/partials/functions/get_hook.html  |  18 +
 wowchemy/layouts/partials/hooks/footer.html   |   2 -
 .../layouts/partials/hooks/page_toc_end.html  |   0
 .../partials/hooks/page_toc_start.html        |   0
 wowchemy/layouts/partials/site_footer.html    |   2 +-
 wowchemy/layouts/partials/site_head.html      |  11 +-
 wowchemy/layouts/partials/site_js.html        | 395 +++++++++---------
 10 files changed, 231 insertions(+), 209 deletions(-)
 delete mode 100644 wowchemy/layouts/partials/custom_head.html
 delete mode 100644 wowchemy/layouts/partials/custom_js.html
 create mode 100644 wowchemy/layouts/partials/functions/get_hook.html
 delete mode 100644 wowchemy/layouts/partials/hooks/footer.html
 delete mode 100644 wowchemy/layouts/partials/hooks/page_toc_end.html
 delete mode 100644 wowchemy/layouts/partials/hooks/page_toc_start.html

diff --git a/wowchemy/layouts/partials/book_layout.html b/wowchemy/layouts/partials/book_layout.html
index 693fc438d..d73c1e8e4 100644
--- a/wowchemy/layouts/partials/book_layout.html
+++ b/wowchemy/layouts/partials/book_layout.html
@@ -12,7 +12,7 @@
     {{/* Show ToC by default. */}}
     {{ if ne .Params.toc false }}
     <div class="d-none d-xl-block col-xl-2 docs-toc">
-      {{ partial "hooks/page_toc_start" . }}
+      {{ partial "functions/get_hook" (dict "hook" "toc-start" "context" .) }}
 
       <ul class="nav toc-top">
         <li><a href="#" id="back_to_top" class="docs-toc-title">{{ i18n "on_this_page" }}</a></li>
@@ -20,7 +20,7 @@
 
       {{ .TableOfContents }}
 
-      {{ partial "hooks/page_toc_end" . }}
+      {{ partial "functions/get_hook" (dict "hook" "toc-end" "context" .) }}
     </div>
     {{ end }}
 
diff --git a/wowchemy/layouts/partials/custom_head.html b/wowchemy/layouts/partials/custom_head.html
deleted file mode 100644
index 7f262fae1..000000000
--- a/wowchemy/layouts/partials/custom_head.html
+++ /dev/null
@@ -1,4 +0,0 @@
-{{/* Do not directly modify this file! */}}
-{{/* Instead, create a `layouts/partials/custom_head.html` file in your site and add your code to it. */}}
-
-{{/* This partial is included in `themes/academic/layouts/partials/site_head.html`. */}}
diff --git a/wowchemy/layouts/partials/custom_js.html b/wowchemy/layouts/partials/custom_js.html
deleted file mode 100644
index 8d081963f..000000000
--- a/wowchemy/layouts/partials/custom_js.html
+++ /dev/null
@@ -1,4 +0,0 @@
-{{/* Do not directly modify this file! */}}
-{{/* Instead, create a `layouts/partials/custom_js.html` file in your site and add your code to it. */}}
-
-{{/* This partial is included in `themes/academic/layouts/partials/site_js.html`. */}}
diff --git a/wowchemy/layouts/partials/functions/get_hook.html b/wowchemy/layouts/partials/functions/get_hook.html
new file mode 100644
index 000000000..c1a0a0e41
--- /dev/null
+++ b/wowchemy/layouts/partials/functions/get_hook.html
@@ -0,0 +1,18 @@
+{{/* Function to inject custom code into layouts without overriding files. */}}
+{{/* Input: hook folder name (str) */}}
+{{/* Output: loaded (bool) */}}
+
+{{ $loaded := false }}
+{{ $partial_dir := printf "hooks/%s/" .hook }}
+{{ $hook_dir_path := path.Join "layouts/partials" $partial_dir }}
+{{ if fileExists $hook_dir_path }}
+  {{ range os.ReadDir $hook_dir_path }}
+    {{ if not .IsDir }}
+      {{ $partial_path := path.Join $partial_dir .Name }}
+      {{ partial $partial_path . }}
+      {{ $loaded = true }}
+    {{ end }}
+  {{ end }}
+{{ end }}
+{{/* The return statement below is for debug purposes only and prevents the above partial(s) being included in the page */}}
+{{/* return $loaded */}}
diff --git a/wowchemy/layouts/partials/hooks/footer.html b/wowchemy/layouts/partials/hooks/footer.html
deleted file mode 100644
index 9c47df60b..000000000
--- a/wowchemy/layouts/partials/hooks/footer.html
+++ /dev/null
@@ -1,2 +0,0 @@
-{{/* Override this file to add a custom footer to every page. */}}
-{{/* This partial is included in `layouts/partials/site_footer.html`. */}}
diff --git a/wowchemy/layouts/partials/hooks/page_toc_end.html b/wowchemy/layouts/partials/hooks/page_toc_end.html
deleted file mode 100644
index e69de29bb..000000000
diff --git a/wowchemy/layouts/partials/hooks/page_toc_start.html b/wowchemy/layouts/partials/hooks/page_toc_start.html
deleted file mode 100644
index e69de29bb..000000000
diff --git a/wowchemy/layouts/partials/site_footer.html b/wowchemy/layouts/partials/site_footer.html
index 82a14b7ab..34c13e010 100644
--- a/wowchemy/layouts/partials/site_footer.html
+++ b/wowchemy/layouts/partials/site_footer.html
@@ -1,6 +1,6 @@
 <footer class="site-footer">
 
-  {{ partial "hooks/footer" . }}
+  {{ partial "functions/get_hook" (dict "hook" "footer-start" "context" .) }}
 
   {{ if .IsTranslated | and site.Params.footer.show_translations }}
     <div class="powered-by d-flex flex-wrap pb-2 justify-content-center">
diff --git a/wowchemy/layouts/partials/site_head.html b/wowchemy/layouts/partials/site_head.html
index a5fe5cbe1..b7e51a0d8 100644
--- a/wowchemy/layouts/partials/site_head.html
+++ b/wowchemy/layouts/partials/site_head.html
@@ -9,6 +9,9 @@
     <meta name="generator" content="Wowchemy {{ site.Data.wowchemy.version }} for Hugo" />
   {{ end }}
 
+  {{/* EXTENSIBILITY HOOK: HEAD-START */}}
+  {{ partial "functions/get_hook" (dict "hook" "head-start" "context" .) }}
+
   {{ if .Params.private }}
     <meta name="robots" content="noindex" />
   {{- end -}}
@@ -305,7 +308,13 @@
 
   {{ partial "jsonld/main" (dict "page" . "summary" $desc) }}
   {{ partial "cookie_consent" . }}
-  {{ partial "custom_head" . }}
 
   <title>{{$title}}</title>
+
+  {{/* EXTENSIBILITY HOOK: HEAD-END */}}
+  {{/* Deprecated custom_head hook */}}
+  {{ if templates.Exists "partials/custom_head" }}
+    {{ partial "custom_head" . }}
+  {{ end }}
+  {{ partial "functions/get_hook" (dict "hook" "head-end" "context" .) }}
 </head>
diff --git a/wowchemy/layouts/partials/site_js.html b/wowchemy/layouts/partials/site_js.html
index af077d340..8eff4649e 100644
--- a/wowchemy/layouts/partials/site_js.html
+++ b/wowchemy/layouts/partials/site_js.html
@@ -1,197 +1,202 @@
-    {{ $scr := $.Scratch }}
-
-    {{/* Rename _vendor dir as GitHub Pages doesn't automatically publish folders with underscores. */}}
-    {{ $libs := slice }}
-    {{- $lib_names := slice "jquery.min" "bootstrap.bundle.min" "instantpage" -}}
-    {{- range $lib_names -}}
-        {{- $libs = $libs | append (resources.Get (printf "js/_vendor/%s.js" .) ) -}}
-    {{- end -}}
-    {{ $libs := $libs | resources.Concat "js/vendor-bundle.js" | minify }}
-    {{- if hugo.IsProduction -}}
-      {{ $libs = $libs | fingerprint "md5" }}
-    {{- end -}}
-    <script src="{{ $libs.RelPermalink }}"></script>
-
-    {{/* Attempt to load local vendor JS, otherwise load from CDN. */}}
-    {{ $js := site.Data.assets.js }}
-    {{ if not ($scr.Get "use_cdn") }}
-      <script src="{{ printf "/js/vendor/%s" ($scr.Get "vendor_js_filename") | relURL }}"></script>
-    {{ else }}
-      {{ if .Page.Store.Get "has_isotope" }}
-        {{ printf "<script src=\"%s\" integrity=\"%s\" crossorigin=\"anonymous\"></script>" (printf $js.imagesLoaded.url $js.imagesLoaded.version) $js.imagesLoaded.sri | safeHTML }}
-        {{ printf "<script src=\"%s\" integrity=\"%s\" crossorigin=\"anonymous\"></script>" (printf $js.isotope.url $js.isotope.version) $js.isotope.sri | safeHTML }}
-      {{ end }}
-
-      {{/* Workaround `.HasShortcode "gallery"` detection issue on `home/` WidgetPage v1 */}}
-      {{ if ($scr.Get "HasNestedGalleryShortcode") | or site.Params.require_fancybox }}
-        {{ printf "<script src=\"%s\" integrity=\"%s\" crossorigin=\"anonymous\"></script>" (printf $js.fancybox.url $js.fancybox.version) $js.fancybox.sri | safeHTML }}
-      {{ end }}
-
-      {{ if .Page.Store.Get "has_mermaid" }}
-        {{/* Title attribute is used by wowchemy-theming.js to detect Mermaid */}}
-        {{ printf "<script src=\"%s\" integrity=\"%s\" crossorigin=\"anonymous\" title=\"mermaid\"></script>" (printf $js.mermaid.url $js.mermaid.version) $js.mermaid.sri | safeHTML }}
-      {{ end }}
-
-    {{ end }}
-
-    {{/* Maps JS. */}}
-    {{ $map_provider := lower site.Params.features.map.provider }}
-    {{ if eq $map_provider "google" }}
-      <script async defer src="https://maps.googleapis.com/maps/api/js?key={{ site.Params.features.map.api_key }}"></script>
-      {{ if ($scr.Get "use_cdn") }}
-        {{ printf "<script src=\"%s\" integrity=\"%s\" crossorigin=\"anonymous\"></script>" (printf $js.gmaps.url $js.gmaps.version) $js.gmaps.sri | safeHTML }}
-      {{ end }}
-    {{ else if (in (slice "mapnik" "mapbox") $map_provider) | and ($scr.Get "use_cdn") }}
-      {{ printf "<script src=\"%s\" integrity=\"%s\" crossorigin=\"anonymous\"></script>" (printf $js.leaflet.url $js.leaflet.version) $js.leaflet.sri | safeHTML }}
-    {{ end }}
-
-    {{/* Load hash anchors for documentation pages. */}}
-    {{ if in (slice "book" "docs") .Type }}
-    {{ printf "<script src=\"%s\" integrity=\"%s\" crossorigin=\"anonymous\"></script>" (printf $js.anchor.url $js.anchor.version) $js.anchor.sri | safeHTML }}
-    <script>
-      anchors.add();
-    </script>
-    {{ end }}
-
-    {{ $algoliaConfig := dict }}
-    {{ $search_provider := lower site.Params.features.search.provider }}
-    {{ if eq $search_provider "wowchemy" }}
-      {{/* Wowchemy built-in search result template (Fuse). */}}
-      <script id="search-hit-fuse-template" type="text/x-template">
-        <div class="search-hit" id="summary-{{"{{key}}"}}">
-          <div class="search-hit-content">
-            <div class="search-hit-name">
-              {{ printf "<a href=\"%s\">%s</a>" "{{relpermalink}}" "{{title}}" | safeHTML }}
-              <div class="article-metadata search-hit-type">{{"{{type}}"}}</div>
-              <p class="search-hit-description">{{"{{snippet}}"}}</p>
-            </div>
-          </div>
+{{ $scr := $.Scratch }}
+
+{{/* Rename _vendor dir as GitHub Pages doesn't automatically publish folders with underscores. */}}
+{{ $libs := slice }}
+{{- $lib_names := slice "jquery.min" "bootstrap.bundle.min" "instantpage" -}}
+{{- range $lib_names -}}
+    {{- $libs = $libs | append (resources.Get (printf "js/_vendor/%s.js" .) ) -}}
+{{- end -}}
+{{ $libs := $libs | resources.Concat "js/vendor-bundle.js" | minify }}
+{{- if hugo.IsProduction -}}
+  {{ $libs = $libs | fingerprint "md5" }}
+{{- end -}}
+<script src="{{ $libs.RelPermalink }}"></script>
+
+{{/* Attempt to load local vendor JS, otherwise load from CDN. */}}
+{{ $js := site.Data.assets.js }}
+{{ if not ($scr.Get "use_cdn") }}
+  <script src="{{ printf "/js/vendor/%s" ($scr.Get "vendor_js_filename") | relURL }}"></script>
+{{ else }}
+  {{ if .Page.Store.Get "has_isotope" }}
+    {{ printf "<script src=\"%s\" integrity=\"%s\" crossorigin=\"anonymous\"></script>" (printf $js.imagesLoaded.url $js.imagesLoaded.version) $js.imagesLoaded.sri | safeHTML }}
+    {{ printf "<script src=\"%s\" integrity=\"%s\" crossorigin=\"anonymous\"></script>" (printf $js.isotope.url $js.isotope.version) $js.isotope.sri | safeHTML }}
+  {{ end }}
+
+  {{/* Workaround `.HasShortcode "gallery"` detection issue on `home/` WidgetPage v1 */}}
+  {{ if ($scr.Get "HasNestedGalleryShortcode") | or site.Params.require_fancybox }}
+    {{ printf "<script src=\"%s\" integrity=\"%s\" crossorigin=\"anonymous\"></script>" (printf $js.fancybox.url $js.fancybox.version) $js.fancybox.sri | safeHTML }}
+  {{ end }}
+
+  {{ if .Page.Store.Get "has_mermaid" }}
+    {{/* Title attribute is used by wowchemy-theming.js to detect Mermaid */}}
+    {{ printf "<script src=\"%s\" integrity=\"%s\" crossorigin=\"anonymous\" title=\"mermaid\"></script>" (printf $js.mermaid.url $js.mermaid.version) $js.mermaid.sri | safeHTML }}
+  {{ end }}
+
+{{ end }}
+
+{{/* Maps JS. */}}
+{{ $map_provider := lower site.Params.features.map.provider }}
+{{ if eq $map_provider "google" }}
+  <script async defer src="https://maps.googleapis.com/maps/api/js?key={{ site.Params.features.map.api_key }}"></script>
+  {{ if ($scr.Get "use_cdn") }}
+    {{ printf "<script src=\"%s\" integrity=\"%s\" crossorigin=\"anonymous\"></script>" (printf $js.gmaps.url $js.gmaps.version) $js.gmaps.sri | safeHTML }}
+  {{ end }}
+{{ else if (in (slice "mapnik" "mapbox") $map_provider) | and ($scr.Get "use_cdn") }}
+  {{ printf "<script src=\"%s\" integrity=\"%s\" crossorigin=\"anonymous\"></script>" (printf $js.leaflet.url $js.leaflet.version) $js.leaflet.sri | safeHTML }}
+{{ end }}
+
+{{/* Load hash anchors for documentation pages. */}}
+{{ if in (slice "book" "docs") .Type }}
+{{ printf "<script src=\"%s\" integrity=\"%s\" crossorigin=\"anonymous\"></script>" (printf $js.anchor.url $js.anchor.version) $js.anchor.sri | safeHTML }}
+<script>
+  anchors.add();
+</script>
+{{ end }}
+
+{{ $algoliaConfig := dict }}
+{{ $search_provider := lower site.Params.features.search.provider }}
+{{ if eq $search_provider "wowchemy" }}
+  {{/* Wowchemy built-in search result template (Fuse). */}}
+  <script id="search-hit-fuse-template" type="text/x-template">
+    <div class="search-hit" id="summary-{{"{{key}}"}}">
+      <div class="search-hit-content">
+        <div class="search-hit-name">
+          {{ printf "<a href=\"%s\">%s</a>" "{{relpermalink}}" "{{title}}" | safeHTML }}
+          <div class="article-metadata search-hit-type">{{"{{type}}"}}</div>
+          <p class="search-hit-description">{{"{{snippet}}"}}</p>
         </div>
-      </script>
-      {{ if ($scr.Get "use_cdn") }}
-        {{ printf "<script src=\"%s\" integrity=\"%s\" crossorigin=\"anonymous\"></script>" (printf $js.fuse.url $js.fuse.version) $js.fuse.sri | safeHTML }}
-        {{ printf "<script src=\"%s\" integrity=\"%s\" crossorigin=\"anonymous\"></script>" (printf $js.mark.url $js.mark.version) $js.mark.sri | safeHTML }}
-      {{ end }}
-    {{ else if eq $search_provider "algolia" }}
-      {{/* Algolia search result template. */}}
-      <script id="search-hit-algolia-template" type="text/html">
-        <div class="search-hit">
-          <div class="search-hit-content">
-            <div class="search-hit-name">
-              {{ printf "<a href=\"%s\">{{#helpers.highlight}}{ \"attribute\": \"title\" }{{/helpers.highlight}}</a>" "{{relpermalink}}" | safeHTML }}
-            </div>
-            <div class="article-metadata search-hit-type">{{"{{type}}"}}</div>
-            <p class="search-hit-description">{{ safeHTML "{{#helpers.highlight}}{ \"attribute\": \"summary\" }{{/helpers.highlight}}" }}</p>
-          </div>
+      </div>
+    </div>
+  </script>
+  {{ if ($scr.Get "use_cdn") }}
+    {{ printf "<script src=\"%s\" integrity=\"%s\" crossorigin=\"anonymous\"></script>" (printf $js.fuse.url $js.fuse.version) $js.fuse.sri | safeHTML }}
+    {{ printf "<script src=\"%s\" integrity=\"%s\" crossorigin=\"anonymous\"></script>" (printf $js.mark.url $js.mark.version) $js.mark.sri | safeHTML }}
+  {{ end }}
+{{ else if eq $search_provider "algolia" }}
+  {{/* Algolia search result template. */}}
+  <script id="search-hit-algolia-template" type="text/html">
+    <div class="search-hit">
+      <div class="search-hit-content">
+        <div class="search-hit-name">
+          {{ printf "<a href=\"%s\">{{#helpers.highlight}}{ \"attribute\": \"title\" }{{/helpers.highlight}}</a>" "{{relpermalink}}" | safeHTML }}
         </div>
-      </script>
-      {{ if ($scr.Get "use_cdn") }}
-        {{ 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) }}
-    {{ end }}
-
-    {{/* Charts */}}
-    {{ if .HasShortcode "chart" }}
-      {{ printf "<script src=\"%s\" integrity=\"%s\" crossorigin=\"anonymous\"></script>" (printf $js.plotly.url $js.plotly.version) $js.plotly.sri | safeHTML }}
-    {{ end }}
-
-    {{/* Disqus Comment Count JS. */}}
-    {{/* Note: count can appear both in listing previews and on the content page itself. */}}
-    {{ $comments_provider := trim (site.Params.features.comment.provider | lower) " " }}
-    {{ if eq $comments_provider "disqus" | and (site.Params.features.comment.disqus.show_count | default true) }}
-      <script id="dsq-count-scr" src="https://{{site.Params.features.comment.disqus.shortname}}.disqus.com/count.js" async></script>
-    {{end}}
-
-    {{ $js_search_params := dict }}
-    {{ if in (slice "wowchemy" "algolia") $search_provider }}
-      {{/* Configure search engine. */}}
-      {{ $min_length := site.Params.features.search.wowchemy.min_length | default 1 }}
-      {{ $threshold := site.Params.features.search.wowchemy.threshold | default 0.3 }}
-      {{ $search_config := dict "indexURI" ("/index.json" | relLangURL) "threshold" $threshold "minLength" $min_length }}
-      {{ $search_i18n := dict "placeholder" (i18n "search_placeholder") "results" (i18n "search_results") "no_results" (i18n "search_no_results") }}
-      {{ $content_types := dict "post" (i18n "posts") "project" (i18n "projects") "publication" (i18n "publications") "event" (i18n "talks") "slides" (i18n "slides") "authors" (i18n "authors") }}
-      {{ $js_search_params = dict "search_config" $search_config "algoliaConfig" $algoliaConfig "i18n" $search_i18n "content_type" $content_types }}
-    {{ end }}
-
-    {{ if eq $search_provider "algolia" }}
-    {{ $js_algolia_search := resources.Get "js/algolia-search.js" | js.Build (dict "format" "esm" "targetPath" (printf "%s/js/algolia-search-built.js" .Lang) "params" $js_search_params) }}
-    {{- if hugo.IsProduction -}}
-      {{- $js_algolia_search = $js_algolia_search | minify | fingerprint "md5" -}}
-    {{- end -}}
-    <script src="{{ $js_algolia_search.RelPermalink }}" type="module"></script>
-    {{ end }}
-
-    {{/* Page Data */}}
-    {{ $default_headroom := not (.IsHome | or (eq .Type "book")) }}
-    {{ $use_headroom := cond (isset $.Params "header.on_scroll") (eq $.Params.header.on_scroll "disappear") (default $default_headroom) }}
-    {{ printf "<script id=\"page-data\" type=\"application/json\">%s</script>" (dict "use_headroom" $use_headroom | jsonify) | safeHTML}}
-
-    {{/* Headroom */}}
-    {{ if $use_headroom }}
-      {{ $headroom := resources.Get "js/wowchemy-headroom.js" | js.Build (dict "format" "esm" "minify" true) }}
-      {{- if hugo.IsProduction -}}
-        {{- $headroom = $headroom | fingerprint "md5" -}}
-      {{- end -}}
-      <script src="{{ $headroom.RelPermalink }}" type="module"></script>
-    {{- end -}}
-
-    {{ $js_license := printf "/*! Wowchemy v%s | https://wowchemy.com/ */\n" site.Data.wowchemy.version }}
-    {{ $js_license := $js_license | printf "%s/*! Copyright 2016-present George Cushen (https://georgecushen.com/) */\n" }}
-    {{ $js_license := $js_license | printf "%s/*! License: https://github.com/wowchemy/wowchemy-hugo-themes/blob/main/LICENSE.md */\n" }}
-    {{ $js_bundle_head := $js_license | resources.FromString "js/bundle-head.js" }}
-    {{ $i18n := dict "copy" (i18n "btn_copy") "copied" (i18n "btn_copied" | default "Copied") }}
-    {{ $js_params := dict "hugoEnvironment" hugo.Environment "searchEnabled" (in (slice "wowchemy" "algolia") $search_provider) "i18n" $i18n }}
-    {{ $js_academic := resources.Get "js/wowchemy.js" | js.Build (dict "targetPath" (printf "%s/js/wow-core.js" .Lang ) "params" $js_params) }}
-    {{ $js_bundle := slice $js_academic }}
-    {{ if eq $search_provider "wowchemy" }}
-      {{ $js_academic_search := resources.Get "js/wowchemy-search.js" | js.Build (dict "targetPath" (printf "%s/js/wow-search-built.js" .Lang) "params" $js_search_params) }}
-      {{ $js_bundle = $js_bundle | append $js_academic_search }}
-    {{ end }}
-    {{ range site.Params.plugins_js }}
-      {{ $js_bundle = $js_bundle | append (resources.Get (printf "js/%s.js" .)) }}
-    {{ end }}
-    {{ $js_bundle = $js_bundle | resources.Concat (printf "%s/js/wowchemy-bundle.js" .Lang) }}
-    {{- if hugo.IsProduction -}}
-      {{- $js_bundle = $js_bundle | js.Build (dict "format" "iife") | minify -}}
-    {{- else -}}
-      {{- $js_bundle = $js_bundle | js.Build (dict "format" "iife" "sourceMap" "inline") -}}
-    {{- end -}}
-    {{ $js_bundle = slice $js_bundle_head $js_bundle | resources.Concat (printf "%s/js/wowchemy.min.js" .Lang) }}
-    {{- if hugo.IsProduction -}}
-      {{ $js_bundle = $js_bundle | fingerprint "md5" }}
-    {{- end -}}
-    <script src="{{ $js_bundle.RelPermalink }}"></script>
-
-    {{/* Maps */}}
-    {{ if site.Params.features.map.provider }}
-      {{ $js := resources.Get "js/wowchemy-map.js" | js.Build (dict "format" "esm" "minify" true) }}
-      {{- if hugo.IsProduction -}}
-        {{- $js = $js | fingerprint "md5" -}}
-      {{- end -}}
-      <script src="{{ $js.RelPermalink }}" type="module"></script>
-    {{- end -}}
-
-    {{/* Carousel */}}
-    {{ $hasCarousel := where site.Pages "Params.widget" "slider" }}
-    {{ if $hasCarousel }}
-      {{ $js := resources.Get "js/wowchemy-carousel.js" | js.Build (dict "format" "esm" "minify" true) }}
-      {{- if hugo.IsProduction -}}
-        {{- $js = $js | fingerprint "md5" -}}
-      {{- end -}}
-      <script src="{{ $js.RelPermalink }}" type="module"></script>
-    {{- end -}}
-
-    {{/* Publications */}}
-    {{ $hasPublications := where site.Pages "Type" "publication" }}
-    {{ if $hasPublications }}
-      {{ partial "citation" . }}
-
-      {{ $js := resources.Get "js/wowchemy-publication.js" | js.Build (dict "format" "esm" "minify" true) }}
-      {{- if hugo.IsProduction -}}
-        {{- $js = $js | fingerprint "md5" -}}
-      {{- end -}}
-      <script src="{{ $js.RelPermalink }}" type="module"></script>
-    {{- end -}}
-
-    {{ partial "custom_js" . }}
+        <div class="article-metadata search-hit-type">{{"{{type}}"}}</div>
+        <p class="search-hit-description">{{ safeHTML "{{#helpers.highlight}}{ \"attribute\": \"summary\" }{{/helpers.highlight}}" }}</p>
+      </div>
+    </div>
+  </script>
+  {{ if ($scr.Get "use_cdn") }}
+    {{ 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) }}
+{{ end }}
+
+{{/* Charts */}}
+{{ if .HasShortcode "chart" }}
+  {{ printf "<script src=\"%s\" integrity=\"%s\" crossorigin=\"anonymous\"></script>" (printf $js.plotly.url $js.plotly.version) $js.plotly.sri | safeHTML }}
+{{ end }}
+
+{{/* Disqus Comment Count JS. */}}
+{{/* Note: count can appear both in listing previews and on the content page itself. */}}
+{{ $comments_provider := trim (site.Params.features.comment.provider | lower) " " }}
+{{ if eq $comments_provider "disqus" | and (site.Params.features.comment.disqus.show_count | default true) }}
+  <script id="dsq-count-scr" src="https://{{site.Params.features.comment.disqus.shortname}}.disqus.com/count.js" async></script>
+{{end}}
+
+{{ $js_search_params := dict }}
+{{ if in (slice "wowchemy" "algolia") $search_provider }}
+  {{/* Configure search engine. */}}
+  {{ $min_length := site.Params.features.search.wowchemy.min_length | default 1 }}
+  {{ $threshold := site.Params.features.search.wowchemy.threshold | default 0.3 }}
+  {{ $search_config := dict "indexURI" ("/index.json" | relLangURL) "threshold" $threshold "minLength" $min_length }}
+  {{ $search_i18n := dict "placeholder" (i18n "search_placeholder") "results" (i18n "search_results") "no_results" (i18n "search_no_results") }}
+  {{ $content_types := dict "post" (i18n "posts") "project" (i18n "projects") "publication" (i18n "publications") "event" (i18n "talks") "slides" (i18n "slides") "authors" (i18n "authors") }}
+  {{ $js_search_params = dict "search_config" $search_config "algoliaConfig" $algoliaConfig "i18n" $search_i18n "content_type" $content_types }}
+{{ end }}
+
+{{ if eq $search_provider "algolia" }}
+{{ $js_algolia_search := resources.Get "js/algolia-search.js" | js.Build (dict "format" "esm" "targetPath" (printf "%s/js/algolia-search-built.js" .Lang) "params" $js_search_params) }}
+{{- if hugo.IsProduction -}}
+  {{- $js_algolia_search = $js_algolia_search | minify | fingerprint "md5" -}}
+{{- end -}}
+<script src="{{ $js_algolia_search.RelPermalink }}" type="module"></script>
+{{ end }}
+
+{{/* Page Data */}}
+{{ $default_headroom := not (.IsHome | or (eq .Type "book")) }}
+{{ $use_headroom := cond (isset $.Params "header.on_scroll") (eq $.Params.header.on_scroll "disappear") (default $default_headroom) }}
+{{ printf "<script id=\"page-data\" type=\"application/json\">%s</script>" (dict "use_headroom" $use_headroom | jsonify) | safeHTML}}
+
+{{/* Headroom */}}
+{{ if $use_headroom }}
+  {{ $headroom := resources.Get "js/wowchemy-headroom.js" | js.Build (dict "format" "esm" "minify" true) }}
+  {{- if hugo.IsProduction -}}
+    {{- $headroom = $headroom | fingerprint "md5" -}}
+  {{- end -}}
+  <script src="{{ $headroom.RelPermalink }}" type="module"></script>
+{{- end -}}
+
+{{ $js_license := printf "/*! Wowchemy v%s | https://wowchemy.com/ */\n" site.Data.wowchemy.version }}
+{{ $js_license := $js_license | printf "%s/*! Copyright 2016-present George Cushen (https://georgecushen.com/) */\n" }}
+{{ $js_license := $js_license | printf "%s/*! License: https://github.com/wowchemy/wowchemy-hugo-themes/blob/main/LICENSE.md */\n" }}
+{{ $js_bundle_head := $js_license | resources.FromString "js/bundle-head.js" }}
+{{ $i18n := dict "copy" (i18n "btn_copy") "copied" (i18n "btn_copied" | default "Copied") }}
+{{ $js_params := dict "hugoEnvironment" hugo.Environment "searchEnabled" (in (slice "wowchemy" "algolia") $search_provider) "i18n" $i18n }}
+{{ $js_academic := resources.Get "js/wowchemy.js" | js.Build (dict "targetPath" (printf "%s/js/wow-core.js" .Lang ) "params" $js_params) }}
+{{ $js_bundle := slice $js_academic }}
+{{ if eq $search_provider "wowchemy" }}
+  {{ $js_academic_search := resources.Get "js/wowchemy-search.js" | js.Build (dict "targetPath" (printf "%s/js/wow-search-built.js" .Lang) "params" $js_search_params) }}
+  {{ $js_bundle = $js_bundle | append $js_academic_search }}
+{{ end }}
+{{ range site.Params.plugins_js }}
+  {{ $js_bundle = $js_bundle | append (resources.Get (printf "js/%s.js" .)) }}
+{{ end }}
+{{ $js_bundle = $js_bundle | resources.Concat (printf "%s/js/wowchemy-bundle.js" .Lang) }}
+{{- if hugo.IsProduction -}}
+  {{- $js_bundle = $js_bundle | js.Build (dict "format" "iife") | minify -}}
+{{- else -}}
+  {{- $js_bundle = $js_bundle | js.Build (dict "format" "iife" "sourceMap" "inline") -}}
+{{- end -}}
+{{ $js_bundle = slice $js_bundle_head $js_bundle | resources.Concat (printf "%s/js/wowchemy.min.js" .Lang) }}
+{{- if hugo.IsProduction -}}
+  {{ $js_bundle = $js_bundle | fingerprint "md5" }}
+{{- end -}}
+<script src="{{ $js_bundle.RelPermalink }}"></script>
+
+{{/* Maps */}}
+{{ if site.Params.features.map.provider }}
+  {{ $js := resources.Get "js/wowchemy-map.js" | js.Build (dict "format" "esm" "minify" true) }}
+  {{- if hugo.IsProduction -}}
+    {{- $js = $js | fingerprint "md5" -}}
+  {{- end -}}
+  <script src="{{ $js.RelPermalink }}" type="module"></script>
+{{- end -}}
+
+{{/* Carousel */}}
+{{ $hasCarousel := where site.Pages "Params.widget" "slider" }}
+{{ if $hasCarousel }}
+  {{ $js := resources.Get "js/wowchemy-carousel.js" | js.Build (dict "format" "esm" "minify" true) }}
+  {{- if hugo.IsProduction -}}
+    {{- $js = $js | fingerprint "md5" -}}
+  {{- end -}}
+  <script src="{{ $js.RelPermalink }}" type="module"></script>
+{{- end -}}
+
+{{/* Publications */}}
+{{ $hasPublications := where site.Pages "Type" "publication" }}
+{{ if $hasPublications }}
+  {{ partial "citation" . }}
+
+  {{ $js := resources.Get "js/wowchemy-publication.js" | js.Build (dict "format" "esm" "minify" true) }}
+  {{- if hugo.IsProduction -}}
+    {{- $js = $js | fingerprint "md5" -}}
+  {{- end -}}
+  <script src="{{ $js.RelPermalink }}" type="module"></script>
+{{- end -}}
+
+{{/* EXTENSIBILITY HOOK: BODY-END */}}
+{{/* Deprecated custom_js hook */}}
+{{ if templates.Exists "partials/custom_js" }}
+  {{ partial "custom_js" . }}
+{{ end }}
+{{ partial "functions/get_hook" (dict "hook" "body-end" "context" .) }}