Add version menu to site, improve version partial, and more (#2557)

Author: chalin

assets/scss/td/_nav.scss

@@ -111,7 +111,7 @@ $td-link-underline-offsets: (
   }
 
   .td-light-dark-menu {
-    position: unset !important;
+    position: unset;
     display: flex;
     align-items: center;
     justify-content: center;
@@ -126,12 +126,29 @@ $td-link-underline-offsets: (
     }
   }
 
-  .td-lang-menu {
-    position: unset !important;
+  .td-lang-menu,
+  .td-version-menu {
+    position: unset;
     display: flex;
     align-items: center;
     justify-content: center;
 
+    .dropdown-item {
+      position: relative;
+      padding-left: 2.5rem;
+
+      &.active::before {
+        font: var(--fa-font-solid);
+        content: fa-content($fa-var-check);
+        position: absolute;
+        left: 0.75rem;
+        top: 50%;
+        transform: translateY(-50%);
+      }
+    }
+  }
+
+  .td-lang-menu {
     &__title {
       padding-left: 0;
       padding-right: 0;
@@ -160,20 +177,6 @@ $td-link-underline-offsets: (
         }
       }
     }
-
-    .dropdown-item {
-      position: relative;
-      padding-left: 2.5rem;
-
-      &.active::before {
-        font: var(--fa-font-solid);
-        content: fa-content($fa-var-check);
-        position: absolute;
-        left: 0.75rem;
-        top: 50%;
-        transform: translateY(-50%);
-      }
-    }
   }
 }
 

docsy.dev/config/_default/params.yaml

@@ -0,0 +1,24 @@
+# cSpell:ignore pagelinks
+#
+# Version related parameters
+#
+# archived_version: false # TODO: generalize status
+# version:
+#   status: archived # Then fetch include
+
+version: &docsyVersion 0.14.3-dev
+tdBuildId: 003-over-main-cf4f514b
+versionLatest: &versionLatest v0.14.2
+version_menu: *docsyVersion
+version_menu_pagelinks: true
+versions:
+  - name: Next
+    version: *docsyVersion
+    url: https://main--docsydocs.netlify.app
+    # TODO: use https://next.docsy.dev once it's available
+    # kind: next
+  - version: *versionLatest
+    url: https://www.docsy.dev
+    # kind: latest
+  - name: ---
+  - name: More coming soon...

docsy.dev/config/production/params.yaml

@@ -0,0 +1,9 @@
+version: &docsyVersion 0.14.2
+version_menu: *docsyVersion
+versions:
+  - name: Next
+    kind: next
+    url: https://main--docsydocs.netlify.app/
+  - version: *docsyVersion
+    kind: latest
+    url: https://www.docsy.dev

docsy.dev/content/en/docs/content/search.md

@@ -4,7 +4,7 @@ date: 2017-01-05
 weight: 3.5
 description: >
   Let users search your Docsy site with a choice of configurable search options.
-cSpell:ignore: GCSE
+cSpell:ignore: GCSE docsearch websearch fsdu nryfng
 ---
 
 Docsy offers multiple options that let your readers search your site content, so

docsy.dev/content/en/project/_index.md

@@ -37,6 +37,6 @@ Planned content organization (tentative):
 
 ## Site build information
 
-Docsy version: `{{% _param versionWithBuildId %}}`
+Docsy version: `{{% version %}}`
 
 {{% td/site-build-info/netlify team="docsydocs" %}}

docsy.dev/content/en/project/about/maintainer-notes.md

@@ -296,9 +296,10 @@ before any further changes are merged into the `main` branch:
 
    ```console
    $ npm run -s fix:version
-   ✓ Updated version: 0.14.2 → 0.14.3-dev+001-over-main-24e96f1c
-   ✓ Updated hugo.yaml version: 0.14.2 → 0.14.3-dev
-   ✓ Updated hugo.yaml versionWithBuildId: 0.14.2 → 0.14.3-dev+001-over-main-24e96f1c
+   ✓ Updated package.json version: 0.14.3 → 0.14.3-dev+003-over-main-cf4f514b
+   ✓ Updated docsy.dev/config/_default/params.yaml version: 0.14.3 → 0.14.3-dev
+   ✓ Updated docsy.dev/config/_default/params.yaml tdBuildId: (none) → 003-over-main-cf4f514b
+   ...
    $ npm run -s fix:version:example
    ...
    ```

docsy.dev/hugo.yaml

@@ -62,8 +62,6 @@ params:
     to_year: present
   privacy_policy: https://policies.google.com/privacy
   archived_version: false
-  version: 0.14.3-dev
-  versionWithBuildId: 0.14.3-dev+002-over-main-4edd8f61
   github_repo: https://github.com/google/docsy
   github_project_repo: https://github.com/google/docsy
   github_subdir: docsy.dev
@@ -147,6 +145,7 @@ params:
     enable: true
   drawio:
     enable: true
+
   # UG helpers: use with _param
   FA: <i class="fa-{1} fa-{2} text-{3} px-1"></i>
   FAS: <i class="fa-solid fa-{1} text-{2} px-1"></i>

docsy.dev/layouts/_shortcodes/version.html

@@ -0,0 +1,6 @@
+{{ with .Site.Params.version -}}
+  {{ . -}}
+  {{ with $.Site.Params.tdBuildId -}}
+    +{{ replace . "+" "-" -}}
+  {{ end -}}
+{{ end -}}