From f4804ae1c40abb12064fb297df5fd8dc577764a3 Mon Sep 17 00:00:00 2001
From: Joseph H Kennedy <me@jhkennedy.org>
Date: Thu, 17 Mar 2022 14:13:54 -0800
Subject: [PATCH 01/32] sleep and upgrad e pip to avoid race conditions

---
 .github/workflows/tag-and-distribute.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/tag-and-distribute.yml b/.github/workflows/tag-and-distribute.yml
index d69eb96..351b24e 100644
--- a/.github/workflows/tag-and-distribute.yml
+++ b/.github/workflows/tag-and-distribute.yml
@@ -98,4 +98,6 @@ jobs:
       - name: Pip install ${{ needs.package.outputs.SDIST_VERSION }}
         shell: bash -l {0}
         run: |
+          sleep 30s
+          python -m pip install --upgrade pip
           python -m pip install mkdocs-asf-theme==${{ needs.package.outputs.SDIST_VERSION }}

From ee141e62fa2ebd72a3efee93a81b9a0c4f871166 Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Thu, 28 Sep 2023 11:00:59 -0800
Subject: [PATCH 02/32] pin `mkdocs-material` to latest version

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 1f76b24..861b458 100644
--- a/setup.py
+++ b/setup.py
@@ -31,7 +31,7 @@
 
     install_requires=[
         'mkdocs',
-        'mkdocs-material>=6.2.1,<7.0',
+        'mkdocs-material==9.4.2',
     ],
 
     packages=find_packages(),

From 9cef4fa24688b782db48f3dc14b758dbdb7ec52e Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Fri, 29 Sep 2023 11:59:20 -0800
Subject: [PATCH 03/32] update header

---
 asf_theme/partials/header.html | 102 +++++++++++++++++++++------------
 1 file changed, 66 insertions(+), 36 deletions(-)

diff --git a/asf_theme/partials/header.html b/asf_theme/partials/header.html
index 33e3d52..fd8ced6 100644
--- a/asf_theme/partials/header.html
+++ b/asf_theme/partials/header.html
@@ -1,5 +1,5 @@
 <!--
-  Copyright (c) 2016-2020 Martin Donath <martin.donath@squidfunk.com>
+  Copyright (c) 2016-2023 Martin Donath <martin.donath@squidfunk.com>
 
   Permission is hereby granted, free of charge, to any person obtaining a copy
   of this software and associated documentation files (the "Software"), to
@@ -20,75 +20,105 @@
   IN THE SOFTWARE.
 -->
 
-<!-- Mitigate bug: https://github.com/mkdocs/mkdocs/issues/2191 -->
-{% set site_url = config.site_url | default(nav.homepage.url, true) | url %}
-{% if not config.use_directory_urls and site_url[0] == site_url[-1] == "." %}
-  {% set site_url = site_url ~ "/index.html" %}
+<!-- Determine classes -->
+{% set class = "md-header" %}
+{% if "navigation.tabs.sticky" in features %}
+  {% set class = class ~ " md-header--shadow md-header--lifted" %}
+{% elif "navigation.tabs" not in features %}
+  {% set class = class ~ " md-header--shadow" %}
 {% endif %}
 
-<!-- Application header -->
-<header class="md-header" data-md-component="header">
-
-  <!-- Top-level navigation -->
-  <nav class="md-header-nav md-grid" aria-label="{{ lang.t('header.title') }}">
+<!-- Header -->
+<header class="{{ class }}" data-md-component="header">
+  <nav
+    class="md-header__inner md-grid"
+    aria-label="{{ lang.t('header') }}"
+  >
 
     {% if config.theme.asf_logo %}
-      <!-- Link to ASF -->
-      <a
-        href="{{ config.theme.asf_logo_url }}"
-        title="ASF"
-        class="md-header-nav__button md-logo"
-        aria-label="ASF"
-      >
+    <!-- Link to ASF -->
+    <a
+      href="{{ config.theme.asf_logo_url }}"
+      title="ASF"
+      class="md-header-nav__button md-logo"
+      aria-label="ASF"
+    >
       <img src="{{ config.theme.asf_logo | url }}" alt="logo" />
+    </a>
     {% endif %}
+
     <!-- Link to home -->
     <a
-      href="{{ site_url }}"
+      href="{{ config.extra.homepage | d(nav.homepage.url, true) | url }}"
       title="{{ config.site_name | e }}"
-      class="md-header-nav__button md-logo"
+      class="md-header__button md-logo"
       aria-label="{{ config.site_name }}"
+      data-md-component="logo"
     >
       {% include "partials/logo.html" %}
     </a>
 
     <!-- Button to open drawer -->
-    <label class="md-header-nav__button md-icon" for="__drawer">
-      {% include ".icons/material/menu" ~ ".svg" %}
+    <label class="md-header__button md-icon" for="__drawer">
+      {% set icon = config.theme.icon.menu or "material/menu" %}
+      {% include ".icons/" ~ icon ~ ".svg" %}
     </label>
 
     <!-- Header title -->
-    <div class="md-header-nav__title" data-md-component="header-title">
-      {% if config.site_name == page.title %}
-        <div class="md-header-nav__ellipsis md-ellipsis">
-          {{ config.site_name }}
-        </div>
-      {% else %}
-        <div class="md-header-nav__ellipsis">
-          <span class="md-header-nav__topic md-ellipsis">
+    <div class="md-header__title" data-md-component="header-title">
+      <div class="md-header__ellipsis">
+        <div class="md-header__topic">
+          <span class="md-ellipsis">
             {{ config.site_name }}
           </span>
-          <span class="md-header-nav__topic md-ellipsis">
-            {% if page and page.meta and page.meta.title %}
+        </div>
+        <div class="md-header__topic" data-md-component="header-topic">
+          <span class="md-ellipsis">
+            {% if page.meta and page.meta.title %}
               {{ page.meta.title }}
             {% else %}
               {{ page.title }}
             {% endif %}
           </span>
         </div>
-      {% endif %}
+      </div>
     </div>
 
-    {% if "search" in config["plugins"] %}
-     <!-- Search interface -->
+    <!-- Color palette toggle -->
+    {% if config.theme.palette %}
+      {% if not config.theme.palette is mapping %}
+        {% include "partials/palette.html" %}
+      {% endif %}
+    {% endif %}
+
+    <!-- Site language selector -->
+    {% if config.extra.alternate %}
+      {% include "partials/alternate.html" %}
+    {% endif %}
+
+    <!-- Button to open search modal -->
+    {% if "material/search" in config.plugins %}
+      <label class="md-header__button md-icon" for="__search">
+        {% set icon = config.theme.icon.search or "material/magnify" %}
+        {% include ".icons/" ~ icon ~ ".svg" %}
+      </label>
+
+      <!-- Search interface -->
       {% include "partials/search.html" %}
     {% endif %}
 
-    <!-- Repository containing source -->
+    <!-- Repository information -->
     {% if config.repo_url %}
-      <div class="md-header-nav__source">
+      <div class="md-header__source">
         {% include "partials/source.html" %}
       </div>
     {% endif %}
   </nav>
+
+  <!-- Navigation tabs (sticky) -->
+  {% if "navigation.tabs.sticky" in features %}
+    {% if "navigation.tabs" in features %}
+      {% include "partials/tabs.html" %}
+    {% endif %}
+  {% endif %}
 </header>

From 192bafe35e0944176745ea09a1aab4d97e303902 Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Fri, 29 Sep 2023 13:39:28 -0800
Subject: [PATCH 04/32] fix logos

---
 asf_theme/assets/stylesheets/asf.css | 2 +-
 asf_theme/partials/header.html       | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/asf_theme/assets/stylesheets/asf.css b/asf_theme/assets/stylesheets/asf.css
index 2f28529..783357f 100644
--- a/asf_theme/assets/stylesheets/asf.css
+++ b/asf_theme/assets/stylesheets/asf.css
@@ -18,7 +18,7 @@ a {
 
 }
 
-.md-header-nav__button.md-logo img {
+.md-header__button.md-logo img {
   height: 2.0rem;
   width: auto;
   display: inline-block;
diff --git a/asf_theme/partials/header.html b/asf_theme/partials/header.html
index fd8ced6..cdbe0b4 100644
--- a/asf_theme/partials/header.html
+++ b/asf_theme/partials/header.html
@@ -40,8 +40,9 @@
     <a
       href="{{ config.theme.asf_logo_url }}"
       title="ASF"
-      class="md-header-nav__button md-logo"
+      class="md-header__button md-logo"
       aria-label="ASF"
+      data-md-component="logo"
     >
       <img src="{{ config.theme.asf_logo | url }}" alt="logo" />
     </a>

From 0cdea1062bceb81cd2f7140e711aa8b9fa252be0 Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Fri, 29 Sep 2023 15:52:57 -0800
Subject: [PATCH 05/32] Start updating the footer

---
 asf_theme/assets/stylesheets/asf.css | 22 +++++--
 asf_theme/mkdocs_theme.yml           | 16 ++---
 asf_theme/partials/copyright.html    | 43 ++++++++++++++
 asf_theme/partials/footer.html       | 88 +++++++++++++---------------
 asf_theme/partials/social.html       | 52 ----------------
 5 files changed, 111 insertions(+), 110 deletions(-)
 create mode 100644 asf_theme/partials/copyright.html
 delete mode 100644 asf_theme/partials/social.html

diff --git a/asf_theme/assets/stylesheets/asf.css b/asf_theme/assets/stylesheets/asf.css
index 783357f..cd358a4 100644
--- a/asf_theme/assets/stylesheets/asf.css
+++ b/asf_theme/assets/stylesheets/asf.css
@@ -10,7 +10,7 @@ a {
   color: rgba(248, 248, 248, 100);
 }
 
-.md-header, .md-footer {
+.md-header {
   background: rgb(101, 102, 92);
   background: linear-gradient(180deg, rgba(101, 102, 92, 1) 0%, rgba(106, 106, 106, 1) 100%);
   box-shadow: 0 5px 20px 0 rgba(0, 0, 0, 0.5);
@@ -18,6 +18,14 @@ a {
 
 }
 
+.md-footer {
+  background: rgb(101, 102, 92, 1);
+  /* TODO: get linear gradient to display correctly */
+  /*background: linear-gradient(180deg, rgba(101, 102, 92, 1) 0%, rgba(106, 106, 106, 1) 100%);*/
+  box-shadow: 0 5px 20px 0 rgba(0, 0, 0, 0.5);
+  transition: background 0.3s, border 0.3s, border-radius 0.3s, box-shadow 0.3s;
+}
+
 .md-header__button.md-logo img {
   height: 2.0rem;
   width: auto;
@@ -25,7 +33,7 @@ a {
   margin-top: -7px;
 }
 
-.md-footer-nav {
+.md-footer {
   background-image: url("../images/map.png");
   background-repeat: no-repeat;
   background-size: cover;
@@ -34,6 +42,12 @@ a {
   border-top: 58px solid #ffcd00;
 }
 
+.md-footer-meta.md-typeset {
+  position: absolute;
+  bottom: 0;
+  width: 100%;
+}
+
 .md-footer-container {
   display: flex;
   flex-direction: row;
@@ -82,11 +96,11 @@ a {
   background-color: black;
 }
 
-.md-footer-copyright-link {
+.md-copyright-link {
   color: #1bb0ce !important;
 }
 
-.md-footer-copyright {
+.md-copyright {
   margin-left: 0;
 }
 
diff --git a/asf_theme/mkdocs_theme.yml b/asf_theme/mkdocs_theme.yml
index cab50c7..3547e46 100644
--- a/asf_theme/mkdocs_theme.yml
+++ b/asf_theme/mkdocs_theme.yml
@@ -16,14 +16,16 @@ asf_logo_url: https://asf.alaska.edu/
 # ASF's copyright text
 copyright: Alaska Satellite Facility
 
+# TODO: get these to display on hyp3-docs
 # ASF's social links
-social:
-  - icon: fontawesome/brands/facebook-f
-    link: https://www.facebook.com/AKSatellite
-  - icon: fontawesome/brands/twitter
-    link: https://twitter.com/Ak_Satellite
-  - icon: fontawesome/brands/youtube
-    link: https://www.youtube.com/channel/UChCfI0oVWw4qDwEidnDskJQ
+extra:
+  social:
+    - icon: fontawesome/brands/facebook-f
+      link: https://www.facebook.com/AKSatellite
+    - icon: fontawesome/brands/twitter
+      link: https://twitter.com/Ak_Satellite
+    - icon: fontawesome/brands/youtube
+      link: https://www.youtube.com/channel/UChCfI0oVWw4qDwEidnDskJQ
 
 # ASF's Google Analytics
 google_analytics:
diff --git a/asf_theme/partials/copyright.html b/asf_theme/partials/copyright.html
new file mode 100644
index 0000000..e46e8dd
--- /dev/null
+++ b/asf_theme/partials/copyright.html
@@ -0,0 +1,43 @@
+<!--
+  Copyright (c) 2016-2023 Martin Donath <martin.donath@squidfunk.com>
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to
+  deal in the Software without restriction, including without limitation the
+  rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+  sell copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in
+  all copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+  FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+  IN THE SOFTWARE.
+-->
+
+<!-- Copyright and theme information -->
+<div class="md-copyright">
+  <div class="md-copyright__highlight">
+    {% if config.copyright or config.theme.copyright %}
+      &copy; <span id="copyright-year"></span>
+      <script type="text/javascript">
+          current_year = new Date().getFullYear();
+          document.getElementById("copyright-year").innerHTML=current_year;
+      </script>
+      {{ config.copyright if config.copyright else config.theme.copyright}}
+    {% endif %}
+    <!-- ASF non-discrimination disclaimer-->
+    &nbsp;&nbsp;
+    <a href="https://www.alaska.edu/nondiscrimination"
+       target="_blank"
+       class="md-copyright-link">
+      UA is an AA/EO employer and educational institution and prohibits
+      illegal discrimination against any individual
+    </a>
+  </div>
+</div>
\ No newline at end of file
diff --git a/asf_theme/partials/footer.html b/asf_theme/partials/footer.html
index 46c1b4a..e785111 100644
--- a/asf_theme/partials/footer.html
+++ b/asf_theme/partials/footer.html
@@ -1,5 +1,5 @@
 <!--
-  Copyright (c) 2016-2020 Martin Donath <martin.donath@squidfunk.com>
+  Copyright (c) 2016-2023 Martin Donath <martin.donath@squidfunk.com>
 
   Permission is hereby granted, free of charge, to any person obtaining a copy
   of this software and associated documentation files (the "Software"), to
@@ -20,30 +20,38 @@
   IN THE SOFTWARE.
 -->
 
-{% import "partials/language.html" as lang with context %}
-
-<!-- Application footer -->
+<!-- Footer -->
 <footer class="md-footer">
 
   <!-- Link to previous and/or next page -->
-  {% if page.previous_page or page.next_page %}
-    <div class="md-footer-nav">
+  {% if "navigation.footer" in features %}
+    {% if page.previous_page or page.next_page %}
+      {% if page.meta and page.meta.hide %}
+        {% set hidden = "hidden" if "footer" in page.meta.hide %}
+      {% endif %}
       <nav
-        class="md-footer-nav__inner md-grid"
-        aria-label="{{ lang.t('footer.title') }}"
+        class="md-footer__inner md-grid"
+        aria-label="{{ lang.t('footer') }}"
+        {{ hidden }}
       >
 
         <!-- Link to previous page -->
         {% if page.previous_page %}
-          <a href="{{ page.previous_page.url | url }}" class="md-footer-nav__link md-footer-nav__link--prev" rel="prev">
-            <div class="md-footer-nav__button md-icon">
-              {% include ".icons/material/arrow-left.svg" %}
+          {% set direction = lang.t("footer.previous") %}
+          <a
+            href="{{ page.previous_page.url | url }}"
+            class="md-footer__link md-footer__link--prev"
+            aria-label="{{ direction }}: {{ page.previous_page.title | e }}"
+          >
+            <div class="md-footer__button md-icon">
+              {% set icon = config.theme.icon.previous or "material/arrow-left" %}
+              {% include ".icons/" ~ icon ~ ".svg" %}
             </div>
-            <div class="md-footer-nav__title">
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                {{ direction }}
+              </span>
               <div class="md-ellipsis">
-                <span class="md-footer-nav__direction">
-                  {{ lang.t("footer.previous") }}
-                </span>
                 {{ page.previous_page.title }}
               </div>
             </div>
@@ -52,22 +60,28 @@
 
         <!-- Link to next page -->
         {% if page.next_page %}
-          <a href="{{ page.next_page.url | url }}" class="md-footer-nav__link md-footer-nav__link--next" rel="next">
-            <div class="md-footer-nav__title">
+          {% set direction = lang.t("footer.next") %}
+          <a
+            href="{{ page.next_page.url | url }}"
+            class="md-footer__link md-footer__link--next"
+            aria-label="{{ direction }}: {{ page.next_page.title | e }}"
+          >
+            <div class="md-footer__title">
+              <span class="md-footer__direction">
+                {{ direction }}
+              </span>
               <div class="md-ellipsis">
-                <span class="md-footer-nav__direction">
-                  {{ lang.t("footer.next") }}
-                </span>
                 {{ page.next_page.title }}
               </div>
             </div>
-            <div class="md-footer-nav__button md-icon">
-              {% include ".icons/material/arrow-right.svg" %}
+            <div class="md-footer__button md-icon">
+              {% set icon = config.theme.icon.next or "material/arrow-right" %}
+              {% include ".icons/" ~ icon ~ ".svg" %}
             </div>
           </a>
         {% endif %}
       </nav>
-
+    {% endif %}
       <!-- ASF Footer information-->
       <div class="md-grid">
         <div class="md-footer-container md-grid">
@@ -104,37 +118,17 @@ <h1>Contact Info</h1>
           </div>
         </div>
       </div>
-    </div>
   {% endif %}
 
   <!-- Further information -->
   <div class="md-footer-meta md-typeset">
     <div class="md-footer-meta__inner md-grid">
-
-      <!-- Copyright and theme information -->
-      <div class="md-footer-copyright">
-        <div class="md-footer-copyright__highlight">
-          {% if config.copyright or config.theme.copyright %}
-            &copy; <span id="copyright-year"></span>
-            <script type="text/javascript">
-                current_year = new Date().getFullYear();
-                document.getElementById("copyright-year").innerHTML=current_year;
-            </script>
-            {{ config.copyright if config.copyright else config.theme.copyright}}
-          {% endif %}
-          <!-- ASF non-discrimination disclaimer-->
-          &nbsp;&nbsp;
-          <a href="https://www.alaska.edu/nondiscrimination"
-             target="_blank"
-             class="md-footer-copyright-link">
-            UA is an AA/EO employer and educational institution and prohibits
-            illegal discrimination against any individual
-          </a>
-        </div>
-      </div>
+      {% include "partials/copyright.html" %}
 
       <!-- Social links -->
-      {% include "partials/social.html" %}
+      {% if config.extra.social %}
+        {% include "partials/social.html" %}
+      {% endif %}
     </div>
   </div>
 </footer>
diff --git a/asf_theme/partials/social.html b/asf_theme/partials/social.html
deleted file mode 100644
index b378624..0000000
--- a/asf_theme/partials/social.html
+++ /dev/null
@@ -1,52 +0,0 @@
-<!--
-  Copyright (c) 2016-2020 Martin Donath <martin.donath@squidfunk.com>
-
-  Permission is hereby granted, free of charge, to any person obtaining a copy
-  of this software and associated documentation files (the "Software"), to
-  deal in the Software without restriction, including without limitation the
-  rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
-  sell copies of the Software, and to permit persons to whom the Software is
-  furnished to do so, subject to the following conditions:
-
-  The above copyright notice and this permission notice shall be included in
-  all copies or substantial portions of the Software.
-
-  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-  FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE
-  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-  FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
-  IN THE SOFTWARE.
--->
-
-<!-- Social links in footer -->
-<div class="md-footer-social">
-    {% for social in config.theme.social %}
-      {% set title = social.name %}
-      {% if not title and "//" in social.link %}
-        {% set _,url = social.link.split("//") %}
-        {% set title = url.split("/")[0] %}
-      {% endif %}
-      <a href="{{ social.link }}" target="_blank" rel="noopener" title="{{ title | e }}" class="md-footer-social__link">
-        {% include ".icons/" ~ social.icon ~ ".svg" %}
-      </a>
-    {% endfor %}
-    {% if config.extra.social %}
-        {% for social in config.extra.social %}
-          {% set title = social.name %}
-          {% if not title and "//" in social.link %}
-            {% set _,url = social.link.split("//") %}
-            {% set title = url.split("/")[0] %}
-          {% endif %}
-          <a
-            href="{{ social.link }}"
-            target="_blank" rel="noopener"
-            title="{{ title | e }}"
-            class="md-footer-social__link"
-          >
-            {% include ".icons/" ~ social.icon ~ ".svg" %}
-          </a>
-        {% endfor %}
-    {% endif %}
-</div>

From d1b3d354e6cda6e1d5b092f241e0e20428bca3fb Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Mon, 2 Oct 2023 10:00:16 -0800
Subject: [PATCH 06/32] Get social icons to display

---
 asf_theme/mkdocs_theme.yml     | 16 +++++-------
 asf_theme/partials/social.html | 48 ++++++++++++++++++++++++++++++++++
 2 files changed, 55 insertions(+), 9 deletions(-)
 create mode 100644 asf_theme/partials/social.html

diff --git a/asf_theme/mkdocs_theme.yml b/asf_theme/mkdocs_theme.yml
index 3547e46..cab50c7 100644
--- a/asf_theme/mkdocs_theme.yml
+++ b/asf_theme/mkdocs_theme.yml
@@ -16,16 +16,14 @@ asf_logo_url: https://asf.alaska.edu/
 # ASF's copyright text
 copyright: Alaska Satellite Facility
 
-# TODO: get these to display on hyp3-docs
 # ASF's social links
-extra:
-  social:
-    - icon: fontawesome/brands/facebook-f
-      link: https://www.facebook.com/AKSatellite
-    - icon: fontawesome/brands/twitter
-      link: https://twitter.com/Ak_Satellite
-    - icon: fontawesome/brands/youtube
-      link: https://www.youtube.com/channel/UChCfI0oVWw4qDwEidnDskJQ
+social:
+  - icon: fontawesome/brands/facebook-f
+    link: https://www.facebook.com/AKSatellite
+  - icon: fontawesome/brands/twitter
+    link: https://twitter.com/Ak_Satellite
+  - icon: fontawesome/brands/youtube
+    link: https://www.youtube.com/channel/UChCfI0oVWw4qDwEidnDskJQ
 
 # ASF's Google Analytics
 google_analytics:
diff --git a/asf_theme/partials/social.html b/asf_theme/partials/social.html
new file mode 100644
index 0000000..39760c5
--- /dev/null
+++ b/asf_theme/partials/social.html
@@ -0,0 +1,48 @@
+<!--
+  Copyright (c) 2016-2023 Martin Donath <martin.donath@squidfunk.com>
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to
+  deal in the Software without restriction, including without limitation the
+  rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+  sell copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in
+  all copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+  FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+  IN THE SOFTWARE.
+-->
+
+<!-- Social links -->
+<div class="md-social">
+  {% for social in config.theme.social + config.extra.social %}
+
+    <!-- Automatically set rel=me for Mastodon -->
+    {% set rel = "noopener" %}
+    {% if "mastodon" in social.icon %}
+      {% set rel = rel ~ " me" %}
+    {% endif %}
+
+    <!-- Compute title and render link -->
+    {% set title = social.name %}
+    {% if not title and "//" in social.link %}
+      {% set _, url = social.link.split("//") %}
+      {% set title  = url.split("/")[0] %}
+    {% endif %}
+    <a
+      href="{{ social.link }}"
+      target="_blank" rel="{{ rel }}"
+      title="{{ title | e }}"
+      class="md-social__link"
+    >
+      {% include ".icons/" ~ social.icon ~ ".svg" %}
+    </a>
+  {% endfor %}
+</div>

From 01bba6f15f5b99f06f9cbd205d19f61941358fec Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Mon, 2 Oct 2023 10:21:06 -0800
Subject: [PATCH 07/32] remove logo.html

---
 asf_theme/partials/logo.html | 28 ----------------------------
 1 file changed, 28 deletions(-)
 delete mode 100644 asf_theme/partials/logo.html

diff --git a/asf_theme/partials/logo.html b/asf_theme/partials/logo.html
deleted file mode 100644
index 59844c9..0000000
--- a/asf_theme/partials/logo.html
+++ /dev/null
@@ -1,28 +0,0 @@
-<!--
-  Copyright (c) 2016-2020 Martin Donath <martin.donath@squidfunk.com>
-
-  Permission is hereby granted, free of charge, to any person obtaining a copy
-  of this software and associated documentation files (the "Software"), to
-  deal in the Software without restriction, including without limitation the
-  rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
-  sell copies of the Software, and to permit persons to whom the Software is
-  furnished to do so, subject to the following conditions:
-
-  The above copyright notice and this permission notice shall be included in
-  all copies or substantial portions of the Software.
-
-  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-  FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE
-  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-  FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
-  IN THE SOFTWARE.
--->
-
-<!-- Logo -->
-{% if config.theme.logo %}
-  <img src="{{ config.theme.logo | url }}" alt="logo" />
-{% elif config.theme.icon.logo %}
-  {% include ".icons/" ~ config.theme.icon.logo ~ ".svg" %}
-{% endif %}

From db9ad47462bca2d35b60e0ac96f54cf9d0944e6d Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Mon, 2 Oct 2023 11:22:08 -0800
Subject: [PATCH 08/32] fix sidebar title font color

---
 asf_theme/assets/stylesheets/asf.css | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/asf_theme/assets/stylesheets/asf.css b/asf_theme/assets/stylesheets/asf.css
index cd358a4..ae04c28 100644
--- a/asf_theme/assets/stylesheets/asf.css
+++ b/asf_theme/assets/stylesheets/asf.css
@@ -104,6 +104,10 @@ a {
   margin-left: 0;
 }
 
+.md-nav__title {
+  color: black;
+}
+
 .expert-rec-search {
   margin-top: 10px;
 }

From bdc3948e7ffbba5acb88496de17e1024050cb467 Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Mon, 2 Oct 2023 12:08:21 -0800
Subject: [PATCH 09/32] fix footer size

---
 asf_theme/assets/stylesheets/asf.css | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/asf_theme/assets/stylesheets/asf.css b/asf_theme/assets/stylesheets/asf.css
index ae04c28..9619075 100644
--- a/asf_theme/assets/stylesheets/asf.css
+++ b/asf_theme/assets/stylesheets/asf.css
@@ -37,8 +37,8 @@ a {
   background-image: url("../images/map.png");
   background-repeat: no-repeat;
   background-size: cover;
-  background-position: center center;
-  min-height: 510px;
+  background-position: center 128%;
+  min-height: 574px;
   border-top: 58px solid #ffcd00;
 }
 

From f6a7a8d462d43ce16250be61042432c62a34d13d Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Mon, 2 Oct 2023 12:15:29 -0800
Subject: [PATCH 10/32] restore md-footer style to broken version

---
 asf_theme/assets/stylesheets/asf.css | 10 +---------
 1 file changed, 1 insertion(+), 9 deletions(-)

diff --git a/asf_theme/assets/stylesheets/asf.css b/asf_theme/assets/stylesheets/asf.css
index 9619075..15be3c7 100644
--- a/asf_theme/assets/stylesheets/asf.css
+++ b/asf_theme/assets/stylesheets/asf.css
@@ -10,7 +10,7 @@ a {
   color: rgba(248, 248, 248, 100);
 }
 
-.md-header {
+.md-header, .md-footer {
   background: rgb(101, 102, 92);
   background: linear-gradient(180deg, rgba(101, 102, 92, 1) 0%, rgba(106, 106, 106, 1) 100%);
   box-shadow: 0 5px 20px 0 rgba(0, 0, 0, 0.5);
@@ -18,14 +18,6 @@ a {
 
 }
 
-.md-footer {
-  background: rgb(101, 102, 92, 1);
-  /* TODO: get linear gradient to display correctly */
-  /*background: linear-gradient(180deg, rgba(101, 102, 92, 1) 0%, rgba(106, 106, 106, 1) 100%);*/
-  box-shadow: 0 5px 20px 0 rgba(0, 0, 0, 0.5);
-  transition: background 0.3s, border 0.3s, border-radius 0.3s, box-shadow 0.3s;
-}
-
 .md-header__button.md-logo img {
   height: 2.0rem;
   width: auto;

From 1e0fb221c4297556d2da720ce9636ad8b4b4fdfa Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Mon, 2 Oct 2023 12:20:32 -0800
Subject: [PATCH 11/32] remove footer gradient

---
 asf_theme/assets/stylesheets/asf.css | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/asf_theme/assets/stylesheets/asf.css b/asf_theme/assets/stylesheets/asf.css
index 15be3c7..426d6f6 100644
--- a/asf_theme/assets/stylesheets/asf.css
+++ b/asf_theme/assets/stylesheets/asf.css
@@ -10,7 +10,7 @@ a {
   color: rgba(248, 248, 248, 100);
 }
 
-.md-header, .md-footer {
+.md-header {
   background: rgb(101, 102, 92);
   background: linear-gradient(180deg, rgba(101, 102, 92, 1) 0%, rgba(106, 106, 106, 1) 100%);
   box-shadow: 0 5px 20px 0 rgba(0, 0, 0, 0.5);
@@ -18,6 +18,15 @@ a {
 
 }
 
+.md-footer {
+  background: rgb(101, 102, 92);
+  /* TODO: linear gradient doesn't display properly */
+  /*background: linear-gradient(180deg, rgba(101, 102, 92, 1) 0%, rgba(106, 106, 106, 1) 100%);*/
+  box-shadow: 0 5px 20px 0 rgba(0, 0, 0, 0.5);
+  transition: background 0.3s, border 0.3s, border-radius 0.3s, box-shadow 0.3s;
+
+}
+
 .md-header__button.md-logo img {
   height: 2.0rem;
   width: auto;

From a6909bf51a64d713e6b9fc7aa0425d63ed42457f Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Mon, 2 Oct 2023 12:32:34 -0800
Subject: [PATCH 12/32] restore footer background image to center

---
 asf_theme/assets/stylesheets/asf.css | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/asf_theme/assets/stylesheets/asf.css b/asf_theme/assets/stylesheets/asf.css
index 426d6f6..d16121c 100644
--- a/asf_theme/assets/stylesheets/asf.css
+++ b/asf_theme/assets/stylesheets/asf.css
@@ -38,7 +38,7 @@ a {
   background-image: url("../images/map.png");
   background-repeat: no-repeat;
   background-size: cover;
-  background-position: center 128%;
+  background-position: center center;
   min-height: 574px;
   border-top: 58px solid #ffcd00;
 }

From bb707282ee0b515e63033fe31ce43c4aace82e73 Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Wed, 4 Oct 2023 10:15:34 -0800
Subject: [PATCH 13/32] lighten footer background

---
 asf_theme/assets/stylesheets/asf.css | 28 +++++++++++-----------------
 1 file changed, 11 insertions(+), 17 deletions(-)

diff --git a/asf_theme/assets/stylesheets/asf.css b/asf_theme/assets/stylesheets/asf.css
index d16121c..7f4871b 100644
--- a/asf_theme/assets/stylesheets/asf.css
+++ b/asf_theme/assets/stylesheets/asf.css
@@ -10,31 +10,18 @@ a {
   color: rgba(248, 248, 248, 100);
 }
 
-.md-header {
-  background: rgb(101, 102, 92);
-  background: linear-gradient(180deg, rgba(101, 102, 92, 1) 0%, rgba(106, 106, 106, 1) 100%);
+.md-header, .md-footer {
   box-shadow: 0 5px 20px 0 rgba(0, 0, 0, 0.5);
   transition: background 0.3s, border 0.3s, border-radius 0.3s, box-shadow 0.3s;
-
 }
 
-.md-footer {
+.md-header {
   background: rgb(101, 102, 92);
-  /* TODO: linear gradient doesn't display properly */
-  /*background: linear-gradient(180deg, rgba(101, 102, 92, 1) 0%, rgba(106, 106, 106, 1) 100%);*/
-  box-shadow: 0 5px 20px 0 rgba(0, 0, 0, 0.5);
-  transition: background 0.3s, border 0.3s, border-radius 0.3s, box-shadow 0.3s;
-
-}
-
-.md-header__button.md-logo img {
-  height: 2.0rem;
-  width: auto;
-  display: inline-block;
-  margin-top: -7px;
+  background: linear-gradient(180deg, rgba(101, 102, 92, 1) 0%, rgba(106, 106, 106, 1) 100%);
 }
 
 .md-footer {
+  background: rgb(106, 106, 106);
   background-image: url("../images/map.png");
   background-repeat: no-repeat;
   background-size: cover;
@@ -43,6 +30,13 @@ a {
   border-top: 58px solid #ffcd00;
 }
 
+.md-header__button.md-logo img {
+  height: 2.0rem;
+  width: auto;
+  display: inline-block;
+  margin-top: -7px;
+}
+
 .md-footer-meta.md-typeset {
   position: absolute;
   bottom: 0;

From d936877d0b22bdb7bd4093b80154ca4745988174 Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Wed, 4 Oct 2023 10:45:42 -0800
Subject: [PATCH 14/32] Cite upstream files

---
 asf_theme/partials/copyright.html | 2 ++
 asf_theme/partials/footer.html    | 2 ++
 asf_theme/partials/header.html    | 2 ++
 asf_theme/partials/social.html    | 2 ++
 4 files changed, 8 insertions(+)

diff --git a/asf_theme/partials/copyright.html b/asf_theme/partials/copyright.html
index e46e8dd..1ee61a8 100644
--- a/asf_theme/partials/copyright.html
+++ b/asf_theme/partials/copyright.html
@@ -20,6 +20,8 @@
   IN THE SOFTWARE.
 -->
 
+<!-- Adapted from https://github.com/squidfunk/mkdocs-material/blob/9.4.2/src/templates/partials/copyright.html -->
+
 <!-- Copyright and theme information -->
 <div class="md-copyright">
   <div class="md-copyright__highlight">
diff --git a/asf_theme/partials/footer.html b/asf_theme/partials/footer.html
index e785111..e834837 100644
--- a/asf_theme/partials/footer.html
+++ b/asf_theme/partials/footer.html
@@ -20,6 +20,8 @@
   IN THE SOFTWARE.
 -->
 
+<!-- Adapted from https://github.com/squidfunk/mkdocs-material/blob/9.4.2/src/templates/partials/footer.html -->
+
 <!-- Footer -->
 <footer class="md-footer">
 
diff --git a/asf_theme/partials/header.html b/asf_theme/partials/header.html
index cdbe0b4..c659995 100644
--- a/asf_theme/partials/header.html
+++ b/asf_theme/partials/header.html
@@ -20,6 +20,8 @@
   IN THE SOFTWARE.
 -->
 
+<!-- Adapted from https://github.com/squidfunk/mkdocs-material/blob/9.4.2/src/templates/partials/header.html -->
+
 <!-- Determine classes -->
 {% set class = "md-header" %}
 {% if "navigation.tabs.sticky" in features %}
diff --git a/asf_theme/partials/social.html b/asf_theme/partials/social.html
index 39760c5..3ff529e 100644
--- a/asf_theme/partials/social.html
+++ b/asf_theme/partials/social.html
@@ -20,6 +20,8 @@
   IN THE SOFTWARE.
 -->
 
+<!-- Adapted from https://github.com/squidfunk/mkdocs-material/blob/9.4.2/src/templates/partials/social.html -->
+
 <!-- Social links -->
 <div class="md-social">
   {% for social in config.theme.social + config.extra.social %}

From 92c6cc512c1653284d40ee861d8f3443d9c92210 Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Wed, 4 Oct 2023 11:00:48 -0800
Subject: [PATCH 15/32] always include social

---
 asf_theme/partials/footer.html | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/asf_theme/partials/footer.html b/asf_theme/partials/footer.html
index e834837..2fc460e 100644
--- a/asf_theme/partials/footer.html
+++ b/asf_theme/partials/footer.html
@@ -128,9 +128,7 @@ <h1>Contact Info</h1>
       {% include "partials/copyright.html" %}
 
       <!-- Social links -->
-      {% if config.extra.social %}
-        {% include "partials/social.html" %}
-      {% endif %}
+      {% include "partials/social.html" %}
     </div>
   </div>
 </footer>

From 831d2cb9bdccaa695b804e64e4e1f768e5fa0377 Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Wed, 4 Oct 2023 11:43:53 -0800
Subject: [PATCH 16/32] changelog

---
 CHANGELOG.md | 22 +++++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index d99d21e..398b0a2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,27 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [PEP 440](https://www.python.org/dev/peps/pep-0440/) 
 and uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.0]
+
+### Changed
+- Upgraded `mkdocs-material` to v9.4.2. We have updated our templates in [asf_theme/partials](./asf_theme/partials) to match the [upstream versions](https://github.com/squidfunk/mkdocs-material/tree/9.4.2/src/templates/partials) as closely as possible. This introduces breaking changes. In particular:
+    - If you want a footer, you should make the following change to your website's `mkdocs.yml` file:
+      ```diff
+      theme:
+        features:
+      +    - navigation.footer
+      ```
+    - If you currently use the search plugin, you should make the following change to your website's `mkdocs.yml` file:
+      ```diff
+      plugins:
+      -  - search
+      +  - material/search
+      ```
+    - You should carefully review your website to confirm that everything still renders and functions as expected.
+    - If anything does not work as expected, you may want to read the [`mkdocs-material` upgrade guide](https://squidfunk.github.io/mkdocs-material/upgrade/) starting at [Upgrading from 6.x to 7.x](https://squidfunk.github.io/mkdocs-material/upgrade/#upgrading-from-6x-to-7x) for any other important changes that may apply to your website.
+
+### Fixed
+- Fixed <https://github.com/ASFHyP3/mkdocs-asf-theme/issues/27> by upgrading `mkdocs-material`.
 
 ## [0.2.4](https://github.com/ASFHyP3/mkdocs-asf-theme/compare/v0.2.3...v0.2.4)
 
@@ -17,7 +38,6 @@ and uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 ### Fixed
 - ASF logo and background map now appear correctly in "Project" or repo level sites
 
-
 ## [0.2.2](https://github.com/ASFHyP3/mkdocs-asf-theme/compare/v0.2.1...v0.2.2)
 
 ### Changed

From 69e6324e08e69c7e04e6c3f73486c4f88b52029e Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Wed, 4 Oct 2023 13:09:17 -0800
Subject: [PATCH 17/32] Add `create-jira-issue.yml`

---
 .github/workflows/create-jira-issue.yml | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
 create mode 100644 .github/workflows/create-jira-issue.yml

diff --git a/.github/workflows/create-jira-issue.yml b/.github/workflows/create-jira-issue.yml
new file mode 100644
index 0000000..3615af1
--- /dev/null
+++ b/.github/workflows/create-jira-issue.yml
@@ -0,0 +1,15 @@
+name: Create Jira issue
+
+on:
+  issues:
+    types: [labeled]
+
+jobs:
+  call-create-jira-issue-workflow:
+    uses: ASFHyP3/actions/.github/workflows/reusable-create-jira-issue.yml@v0.8.2
+    secrets:
+      JIRA_BASE_URL: ${{ secrets.JIRA_BASE_URL }}
+      JIRA_USER_EMAIL: ${{ secrets.JIRA_USER_EMAIL }}
+      JIRA_API_TOKEN: ${{ secrets.JIRA_API_TOKEN }}
+      JIRA_PROJECT: ${{ secrets.JIRA_PROJECT }}
+      JIRA_FIELDS: ${{ secrets.JIRA_FIELDS }}

From f8715410bd0d7b143174ef96bd5fd2c03dd9d9d6 Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Wed, 4 Oct 2023 13:18:43 -0800
Subject: [PATCH 18/32] remove gitleaks

---
 .github/workflows/static-analysis.yml | 34 +----------------
 .gitleaks.toml                        | 55 ---------------------------
 .trufflehog.txt                       |  1 -
 3 files changed, 2 insertions(+), 88 deletions(-)
 delete mode 100644 .gitleaks.toml

diff --git a/.github/workflows/static-analysis.yml b/.github/workflows/static-analysis.yml
index db5df4d..209c902 100644
--- a/.github/workflows/static-analysis.yml
+++ b/.github/workflows/static-analysis.yml
@@ -3,35 +3,5 @@ name: Static analysis
 on: push
 
 jobs:
-  gitleaks:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v2
-        with:
-          fetch-depth: 0
-
-      - name: Scan for secrets with gitleaks
-        uses: zricethezav/gitleaks-action@master
-
-
-  trufflehog:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v2
-        with:
-          fetch-depth: 0
-
-      - uses: actions/setup-python@v1
-        with:
-          python-version: 3.8
-
-      - name: Install dependencies
-        run: |
-          python -m pip install trufflehog gitdb2=="2.*"
-
-      - name: Scan for secrets with trufflehog
-        run: |
-          git fetch origin +refs/tags/*:refs/tags/*
-          export LAST_TAG_HASH=$(git show-ref --hash -- $(git describe --abbrev=0))
-          trufflehog --regex --entropy True --since_commit "${LAST_TAG_HASH}" \
-              --exclude_paths .trufflehog.txt file://"${PWD}"
+  call-secrets-analysis-workflow:
+    uses: ASFHyP3/actions/.github/workflows/reusable-secrets-analysis.yml@v0.8.2
diff --git a/.gitleaks.toml b/.gitleaks.toml
deleted file mode 100644
index cddfcd7..0000000
--- a/.gitleaks.toml
+++ /dev/null
@@ -1,55 +0,0 @@
-title = "gitleaks config"
-[[rules]]
-    description = "AWS Manager ID"
-    regex = '''(A3T[A-Z0-9]|AKIA|AGPA|AIDA|AROA|AIPA|ANPA|ANVA|ASIA)[A-Z0-9]{16}'''
-    tags = ["key", "AWS"]
-[[rules]]
-    description = "AWS Secret Key"
-    regex = '''(?i)aws(.{0,20})?(?-i)[0-9a-zA-Z\/+]{40}'''
-    tags = ["key", "AWS"]
-[[rules]]
-    description = "AWS MWS key"
-    regex = '''amzn\.mws\.[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}'''
-    tags = ["key", "AWS", "MWS"]
-[[rules]]
-    description = "Github"
-    regex = '''(?i)github(.{0,20})?(?-i)[0-9a-zA-Z]{35,40}'''
-    tags = ["key", "Github"]
-[[rules]]
-    description = "Asymmetric Private Key"
-    regex = '''-----BEGIN ((EC|PGP|DSA|RSA|OPENSSH) )?PRIVATE KEY( BLOCK)?-----'''
-    tags = ["key", "AsymmetricPrivateKey"]
-[[rules]]
-    description = "Generic Credential"
-    regex = '''(?i)(api_key|apikey|secret|password|pass|pw|key)(.{0,20})?[0-9a-zA-Z]{16,45}'''
-    tags = ["key", "API", "generic"]
-    [[rules.whitelist]]
-        regex = '''KeyChecking.no.*'''
-        description = "Ignore ssh settings for GitLab tools-bot"
-[[rules]]
-    description = "Google API key"
-    regex = '''AIza[0-9A-Za-z\\-_]{35}'''
-    tags = ["key", "Google"]
-[[rules]]
-    description = "Google (GCP) Service Account"
-    regex = '''"type": "service_account"'''
-    tags = ["key", "Google"]
-[[rules]]
-    description = "Heroku API key"
-    regex = '''(?i)heroku(.{0,20})?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}'''
-    tags = ["key", "Heroku"]
-[[rules]]
-    description = "MailChimp API key"
-    regex = '''(?i)(mailchimp|mc)(.{0,20})?[0-9a-f]{32}-us[0-9]{1,2}'''
-    tags = ["key", "Mailchimp"]
-[[rules]]
-    description = "Mailgun API key"
-    regex = '''((?i)(mailgun|mg)(.{0,20})?)?key-[0-9a-z]{32}'''
-    tags = ["key", "Mailgun"]
-[[rules]]
-    description = "Slack Webhook"
-    regex = '''https://hooks.slack.com/services/T[a-zA-Z0-9_]{8}/B[a-zA-Z0-9_]{8}/[a-zA-Z0-9_]{24}'''
-    tags = ["key", "slack"]
-[whitelist]
-    description = "Whitelisted files"
-    files = ['''(^.*gitleaks.toml$|(.*?)(jpg|gif|doc|pdf|bin)$)''']
diff --git a/.trufflehog.txt b/.trufflehog.txt
index a68ca36..5701147 100644
--- a/.trufflehog.txt
+++ b/.trufflehog.txt
@@ -1,2 +1 @@
-.*gitleaks.toml$
 .*mkdocs_theme.yml$

From 906614124e73b1cd70cdc937f9d7d47a645c144b Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Wed, 4 Oct 2023 13:50:34 -0800
Subject: [PATCH 19/32] go back to search plugin

---
 asf_theme/partials/header.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/asf_theme/partials/header.html b/asf_theme/partials/header.html
index c659995..d391b7f 100644
--- a/asf_theme/partials/header.html
+++ b/asf_theme/partials/header.html
@@ -100,7 +100,7 @@
     {% endif %}
 
     <!-- Button to open search modal -->
-    {% if "material/search" in config.plugins %}
+    {% if "search" in config.plugins %}
       <label class="md-header__button md-icon" for="__search">
         {% set icon = config.theme.icon.search or "material/magnify" %}
         {% include ".icons/" ~ icon ~ ".svg" %}

From 9920c1e9ca8fb123c3389fdeec6a53a31fae0eb5 Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Wed, 4 Oct 2023 13:52:43 -0800
Subject: [PATCH 20/32] update changelog

---
 CHANGELOG.md | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 398b0a2..e93e171 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -16,12 +16,6 @@ and uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
         features:
       +    - navigation.footer
       ```
-    - If you currently use the search plugin, you should make the following change to your website's `mkdocs.yml` file:
-      ```diff
-      plugins:
-      -  - search
-      +  - material/search
-      ```
     - You should carefully review your website to confirm that everything still renders and functions as expected.
     - If anything does not work as expected, you may want to read the [`mkdocs-material` upgrade guide](https://squidfunk.github.io/mkdocs-material/upgrade/) starting at [Upgrading from 6.x to 7.x](https://squidfunk.github.io/mkdocs-material/upgrade/#upgrading-from-6x-to-7x) for any other important changes that may apply to your website.
 

From 48051802507025ea827cde3ab7209e22a5ef69aa Mon Sep 17 00:00:00 2001
From: Joseph H Kennedy <me@jhkennedy.org>
Date: Thu, 5 Oct 2023 10:40:22 -0800
Subject: [PATCH 21/32] drop background and box shadow for nav titles

---
 asf_theme/assets/stylesheets/asf.css | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/asf_theme/assets/stylesheets/asf.css b/asf_theme/assets/stylesheets/asf.css
index 7f4871b..a5b0063 100644
--- a/asf_theme/assets/stylesheets/asf.css
+++ b/asf_theme/assets/stylesheets/asf.css
@@ -99,8 +99,20 @@ a {
   margin-left: 0;
 }
 
+.md-nav--primary .md-nav__title {
+  box-shadow: none;
+  background: none;
+}
+
+.md-nav--secondary .md-nav__title {
+  box-shadow: none;
+  background: none;
+}
+
+
 .md-nav__title {
   color: black;
+  box-shadow: none;
 }
 
 .expert-rec-search {

From e2f1a5f5a90916a5ad0c4ccd010d9602d9d471f7 Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Thu, 5 Oct 2023 13:34:11 -0800
Subject: [PATCH 22/32] fix sidebar heading background color

---
 asf_theme/assets/stylesheets/asf.css | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/asf_theme/assets/stylesheets/asf.css b/asf_theme/assets/stylesheets/asf.css
index a5b0063..f9b0ed8 100644
--- a/asf_theme/assets/stylesheets/asf.css
+++ b/asf_theme/assets/stylesheets/asf.css
@@ -99,19 +99,17 @@ a {
   margin-left: 0;
 }
 
-.md-nav--primary .md-nav__title {
-  box-shadow: none;
-  background: none;
+.md-nav__title {
+  color: black;
 }
 
-.md-nav--secondary .md-nav__title {
+.md-nav--primary .md-nav__title {
+  background: #f8f8f8;
   box-shadow: none;
-  background: none;
 }
 
-
-.md-nav__title {
-  color: black;
+.md-nav--secondary .md-nav__title {
+  background: #f8f8f8;
   box-shadow: none;
 }
 

From b239518c892f14d0b4420c4106549df51261bd55 Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Fri, 6 Oct 2023 10:02:39 -0800
Subject: [PATCH 23/32] cite base.html in main.html

---
 asf_theme/main.html | 1 +
 1 file changed, 1 insertion(+)

diff --git a/asf_theme/main.html b/asf_theme/main.html
index b0bfb27..6aeaeed 100644
--- a/asf_theme/main.html
+++ b/asf_theme/main.html
@@ -1,3 +1,4 @@
+<!-- Extends https://github.com/squidfunk/mkdocs-material/blob/9.4.2/src/templates/base.html -->
 {% extends "base.html" %}
 {% block styles %}
     {{ super() }}

From 3581576b1da87161ca1942fd0860f30ff44bef0d Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Fri, 6 Oct 2023 10:12:09 -0800
Subject: [PATCH 24/32] drop google analytics

---
 README.md                                     | 18 ------
 asf_theme/main.html                           |  5 --
 asf_theme/mkdocs_theme.yml                    |  5 --
 .../partials/integrations/analytics.html      | 58 -------------------
 4 files changed, 86 deletions(-)
 delete mode 100644 asf_theme/partials/integrations/analytics.html

diff --git a/README.md b/README.md
index a623c03..b87b3bc 100644
--- a/README.md
+++ b/README.md
@@ -40,24 +40,6 @@ consider either:
 * Opening a pull request to this theme with your customizations so they are available
   to all ASF documentation sites
 
-### Analytics
-
-This theme will provide Google Analytics integration for an ASF documentation site.
-However, analytics can be customized in your `mkdocs.yml` with
-```yaml
-google_analytics:
-  - UA-XXXXXXXX-X
-  - auto  # or a specific site URL
-```
-
-To turn off analytics entirely, remove the site level `google_analytics`
-configuration and clear the theme one with
-```yaml
-theme:
-  name: asf-theme
-  google_analytics:
-```
-
 ### Logos
 
 This theme will provide both the ASF logo and a site logo.
diff --git a/asf_theme/main.html b/asf_theme/main.html
index 6aeaeed..3a44f2b 100644
--- a/asf_theme/main.html
+++ b/asf_theme/main.html
@@ -20,11 +20,6 @@
         data-current-daac="ASF DAAC">
 </script>
 {% endblock %}
-{% block analytics %}
-  {% if config.google_analytics or config.theme.google_analytics %}
-    {% include "partials/integrations/analytics.html" %}
-  {% endif %}
-{% endblock %}
 {% block scripts %}
     {{ super() }}
     <script src="{{ 'assets/javascripts/expert-rec-search.js' | url }}"></script>
diff --git a/asf_theme/mkdocs_theme.yml b/asf_theme/mkdocs_theme.yml
index cab50c7..d33df7c 100644
--- a/asf_theme/mkdocs_theme.yml
+++ b/asf_theme/mkdocs_theme.yml
@@ -24,8 +24,3 @@ social:
     link: https://twitter.com/Ak_Satellite
   - icon: fontawesome/brands/youtube
     link: https://www.youtube.com/channel/UChCfI0oVWw4qDwEidnDskJQ
-
-# ASF's Google Analytics
-google_analytics:
-  - UA-991100-5
-  - search.asf.alaska.edu
diff --git a/asf_theme/partials/integrations/analytics.html b/asf_theme/partials/integrations/analytics.html
deleted file mode 100644
index 5342cfd..0000000
--- a/asf_theme/partials/integrations/analytics.html
+++ /dev/null
@@ -1,58 +0,0 @@
-<!--
-  Copyright (c) 2016-2020 Martin Donath <martin.donath@squidfunk.com>
-
-  Permission is hereby granted, free of charge, to any person obtaining a copy
-  of this software and associated documentation files (the "Software"), to
-  deal in the Software without restriction, including without limitation the
-  rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
-  sell copies of the Software, and to permit persons to whom the Software is
-  furnished to do so, subject to the following conditions:
-
-  The above copyright notice and this permission notice shall be included in
-  all copies or substantial portions of the Software.
-
-  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-  FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE
-  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-  FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
-  IN THE SOFTWARE.
--->
-
-<!-- Google Analytics integration -->
-{% if config.google_analytics %}
-  {% set analytics = config.google_analytics %}
-{% else %}
-  {% set analytics = config.theme.google_analytics %}
-{% endif %}
-<script type="application/javascript">
-  window.ga = window.ga || function() {
-    (ga.q = ga.q || []).push(arguments)
-  }
-  ga.l = +new Date
-
-  /* Set up integration and send page view */
-  ga("create", "{{ analytics[0] }}", "{{ analytics[1] }}")
-  ga("set", "anonymizeIp", true)
-  ga("send", "pageview")
-
-  /* Register handler to log search on blur */
-  document.addEventListener("DOMContentLoaded", function() {
-    if (document.forms.search) {
-      var query = document.forms.search.query
-      query.addEventListener("blur", function() {
-        if (this.value) {
-          var path = document.location.pathname;
-          ga("send", "pageview", path + "?q=" + this.value)
-        }
-      })
-    }
-  })
-
-  /* Send page view on document switch (instant loading, custom event) */
-  document.addEventListener("DOMContentSwitch", function() {
-    ga("send", "pageview", document.location.pathname)
-  })
-</script>
-<script async src="https://www.google-analytics.com/analytics.js"></script>

From e64b41c1d0808b0d3b2a3d5644842d2f1d2a2c99 Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Fri, 6 Oct 2023 10:18:04 -0800
Subject: [PATCH 25/32] update changelog and readme regarding analytics

---
 CHANGELOG.md | 1 +
 README.md    | 5 +++++
 2 files changed, 6 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index e93e171..7383251 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -10,6 +10,7 @@ and uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ### Changed
 - Upgraded `mkdocs-material` to v9.4.2. We have updated our templates in [asf_theme/partials](./asf_theme/partials) to match the [upstream versions](https://github.com/squidfunk/mkdocs-material/tree/9.4.2/src/templates/partials) as closely as possible. This introduces breaking changes. In particular:
+    - Analytics is no longer provided by default. You should follow <https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-analytics/> to enable analytics for your website.
     - If you want a footer, you should make the following change to your website's `mkdocs.yml` file:
       ```diff
       theme:
diff --git a/README.md b/README.md
index b87b3bc..9846ddb 100644
--- a/README.md
+++ b/README.md
@@ -40,6 +40,11 @@ consider either:
 * Opening a pull request to this theme with your customizations so they are available
   to all ASF documentation sites
 
+### Analytics
+
+You can follow <https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-analytics/>
+to enable analytics for your site.
+
 ### Logos
 
 This theme will provide both the ASF logo and a site logo.

From e892d992c3825766a0fafea1b047d430d41891cf Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Fri, 6 Oct 2023 10:49:12 -0800
Subject: [PATCH 26/32] Warn against navigation.instant

---
 README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/README.md b/README.md
index 9846ddb..c711d04 100644
--- a/README.md
+++ b/README.md
@@ -27,6 +27,10 @@ which generates [ASF HyP3's documentation](https://hyp3-docs.asf.alaska.edu/).
 
 ## Customization
 
+> [!WARNING]
+> You should NOT include the `navigation.instant` feature in your `mkdocs.yml`.
+> See <https://github.com/ASFHyP3/hyp3-docs/pull/371> for more information.
+
 This theme has been developed with sensible defaults to be used out-of-the-box by
 ASF documentation sites. While sections below describe how to customize the
 ASF-specific features of this theme, we hope most users won't need them.

From 96847cc2546a8373f079dcf34376d67f254d4f73 Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Fri, 6 Oct 2023 10:54:21 -0800
Subject: [PATCH 27/32] fix changelog

---
 CHANGELOG.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7383251..3c0e2ae 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -10,7 +10,6 @@ and uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ### Changed
 - Upgraded `mkdocs-material` to v9.4.2. We have updated our templates in [asf_theme/partials](./asf_theme/partials) to match the [upstream versions](https://github.com/squidfunk/mkdocs-material/tree/9.4.2/src/templates/partials) as closely as possible. This introduces breaking changes. In particular:
-    - Analytics is no longer provided by default. You should follow <https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-analytics/> to enable analytics for your website.
     - If you want a footer, you should make the following change to your website's `mkdocs.yml` file:
       ```diff
       theme:
@@ -20,6 +19,9 @@ and uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
     - You should carefully review your website to confirm that everything still renders and functions as expected.
     - If anything does not work as expected, you may want to read the [`mkdocs-material` upgrade guide](https://squidfunk.github.io/mkdocs-material/upgrade/) starting at [Upgrading from 6.x to 7.x](https://squidfunk.github.io/mkdocs-material/upgrade/#upgrading-from-6x-to-7x) for any other important changes that may apply to your website.
 
+### Removed
+- Analytics is no longer provided by default. You should follow <https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-analytics/> to enable analytics for your website.
+
 ### Fixed
 - Fixed <https://github.com/ASFHyP3/mkdocs-asf-theme/issues/27> by upgrading `mkdocs-material`.
 

From 8f2fc42a1c943b59641f41542bdb63e246e42f65 Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Fri, 6 Oct 2023 11:26:55 -0800
Subject: [PATCH 28/32] add upgrade guide to README

---
 README.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/README.md b/README.md
index c711d04..7293f50 100644
--- a/README.md
+++ b/README.md
@@ -136,3 +136,29 @@ theme:
     - icon: fontawesome/brands/gitter
       link: https://gitter.im/ASFHyP3/community
 ```
+
+## Development
+
+### Upgrading `mkdocs-material` to a new major version
+
+When upgrading the `mkdocs-material` dependency to a new major version,
+you should reference the [upgrade guide](https://squidfunk.github.io/mkdocs-material/upgrade/)
+for any important changes.
+
+In particular, you should update each template `.html` file in [asf_theme/partials](./asf_theme/partials)
+to match the latest upstream version as closely as possible.
+Each template file should include a comment near the top of the file
+with a link to the upstream version upon which it was based.
+When updating a particular template file,
+you can `diff` it against the linked upstream version to see what changes were made.
+Then you can apply those changes to the *latest* upstream version of the file.
+
+For example, when updating `header.html` from major version 9 to 10,
+you can `diff` our version of `header.html` against the `9.x.x` upstream version linked near the top of the file.
+Then you can download the latest `10.x.x` upstream version from <https://github.com/squidfunk/mkdocs-material>
+and apply the `diff` changes, adapting them as necessary for the latest version of `mkdocs-material`.
+
+You may also have to update
+[asf_theme/assets/stylesheets/asf.css](./asf_theme/assets/stylesheets/asf.css),
+[asf_theme/main.html](./asf_theme/main.html),
+and [asf_theme/mkdocs_theme.yml](./asf_theme/mkdocs_theme.yml) as appropriate.

From 8aeaf07112b06686d9f7b03d86900ceec69228e4 Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Fri, 6 Oct 2023 11:30:08 -0800
Subject: [PATCH 29/32] update mkdocs-material pin

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 861b458..9f7c560 100644
--- a/setup.py
+++ b/setup.py
@@ -31,7 +31,7 @@
 
     install_requires=[
         'mkdocs',
-        'mkdocs-material==9.4.2',
+        'mkdocs-material~=9',
     ],
 
     packages=find_packages(),

From 2d7afce44b560ca7723302e92b9e3ac4c78a8736 Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Fri, 6 Oct 2023 12:15:22 -0800
Subject: [PATCH 30/32] fix `mkdocs-material` pin

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 9f7c560..cf4989c 100644
--- a/setup.py
+++ b/setup.py
@@ -31,7 +31,7 @@
 
     install_requires=[
         'mkdocs',
-        'mkdocs-material~=9',
+        'mkdocs-material>=9.4.2,<10.0',
     ],
 
     packages=find_packages(),

From 2a23509ccd7e000160d8aec1e752bcbdb9a21fb5 Mon Sep 17 00:00:00 2001
From: Jake Herrmann <jtherrmann@alaska.edu>
Date: Fri, 6 Oct 2023 12:18:51 -0800
Subject: [PATCH 31/32] Update setup.py

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index cf4989c..84ed543 100644
--- a/setup.py
+++ b/setup.py
@@ -31,7 +31,7 @@
 
     install_requires=[
         'mkdocs',
-        'mkdocs-material>=9.4.2,<10.0',
+        'mkdocs-material>=9.4.2,<10',
     ],
 
     packages=find_packages(),

From 61a90c74d7aa77c8362c16ca85030d518508cd4d Mon Sep 17 00:00:00 2001
From: Joseph H Kennedy <me@jhkennedy.org>
Date: Fri, 6 Oct 2023 12:43:44 -0800
Subject: [PATCH 32/32] Update asf_theme/partials/copyright.html

---
 asf_theme/partials/copyright.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/asf_theme/partials/copyright.html b/asf_theme/partials/copyright.html
index 1ee61a8..48310b2 100644
--- a/asf_theme/partials/copyright.html
+++ b/asf_theme/partials/copyright.html
@@ -42,4 +42,4 @@
       illegal discrimination against any individual
     </a>
   </div>
-</div>
\ No newline at end of file
+</div>