Merge pull request #20229 from cockroachdb/feat/archival-page

Add archived documentation page with v19.2 support

Author: ebembi-crdb

src/current/_includes/corestyle.scss

@@ -1064,6 +1064,16 @@ div#feature-highlights .feature-description {
 	}
 }
 
+
+.sidebar__tag--new {
+  background: #6933ff;
+  color: #fff;
+  font-size: 10px;
+  padding: 2px 6px;
+  border-radius: 4px;
+  margin-left: 8px;
+}
+
 .roles-table {
   table {
     width: 100%;                // Let the table stretch to the full container width
@@ -1104,3 +1114,4 @@ div#feature-highlights .feature-description {
     width: 1%;                  // Hint browser to minimize these columns if possible
   }
 }
+

src/current/_includes/sidebar-all-releases.json

@@ -73,4 +73,11 @@
   "urls": [
     "/releases/unsupported-versions.html"
   ]
+},
+{
+  "title": "Archived Documentation",
+  "urls": [
+   
+  "/releases/archived-documentation.html"
+  ]
 }

src/current/_includes/sidebar.js.html

@@ -55,7 +55,6 @@
       // source for the underlying version, like v1.0 or v1.1.
       // Otherwise, the sidebar for a `stable` page would
       // inappropriately link to the underlying `v1.0` page instead
-      // of the `stable` alias.
       const pageVersion = (function () {
         const pathComponents = location.pathname
           .replace(sidebar.baseUrl, '')
@@ -89,7 +88,7 @@
       // entry, if any, into the `.collapsed-header` element above.
       function renderItems(items, paths) {
         if (!items || items.length == 0)
-            return $();
+          return $();
 
         const lis = items.map(function (item) {
           const urls = (item.urls || []).map(function (url) {
@@ -103,20 +102,13 @@
           });
 
           // this ensures page will be highlighted in sidebar if URL is accessed with or without `.html` appended
-          var activePathname
-          if (!/^https?:/.test(location.pathname)) {
-            activePathname = location.pathname
+          var activePathname = location.pathname;
+          if (activePathname.includes("/index.html")) {
+            activePathname = activePathname.replace("/index.html", "/");
           }
-          else {
-            activePathname = location.pathname
+          if (activePathname.includes(".html")) {
+            activePathname = activePathname.replace(".html", "");
           }
-          if (location.pathname.includes("/index.html")) {
-            activePathname = activePathname.replace("/index.html", "/")
-          }
-          if (location.pathname.includes(".html")) {
-            activePathname = activePathname.replace(".html", "")
-          }
-          // console.log(urls);
 
           const active = (urls.indexOf(activePathname) !== -1);
           if (active) {
@@ -136,8 +128,19 @@
             .attr("href", urls[0] || "#")
             .html(item.title);
 
+          // ── **INJECT TAG BADGE HERE** ─────────────────────────
+          if (item.tag) {
+            a.append(" ")
+             .append(
+               $("<span>")
+                 .addClass("sidebar__tag sidebar__tag--new")
+                 .text(item.tag)
+             );
+          }
+          // ──────────────────────────────────────────────────────
+
           if (subitems.length > 0 && !item.is_top_level) {
-              a.append(" ").append($("<div>").addClass("nav-expand"));
+            a.append(" ").append($("<div>").addClass("nav-expand"));
           }
 
           return $("<li>")
@@ -165,7 +168,7 @@
         // Version directories either are one of the named version
         // aliases specified in _config.yml or have the form "vX.X",
         // like "v1.0" or "v1.10".
-        return {{ site.versions | jsonify }}[d] || /^v\d+.\d+$/.test(d);
+        return {{ site.versions | jsonify }}[d] || /^v\d+\.\d+$/.test(d);
       },
       items: {%- include_cached {{ include.sidebar_data }} -%}
     };

src/current/releases/archived-documentation.md

@@ -0,0 +1,36 @@
+---
+title: Archived Documentation
+summary: Documentation for CockroachDB versions that are no longer supported
+
+toc: false          # hide “On this page” nav
+docs_area: releases
+---
+
+
+This page contains downloads of archived documentation for CockroachDB versions that are no longer supported.
+
+{{ site.data.alerts.callout_info }}
+Cockroach Labs recommends using a [supported version]({% link releases/release-support-policy.md %}) of CockroachDB for which documentation is actively maintained. The archived documentation on this page is provided **as-is** and is no longer maintained.
+{{ site.data.alerts.end }}
+
+## Archived versions  
+
+The table below contains links to archived documentation for versions of CockroachDB that are [no longer supported]({% link releases/release-support-policy.md %}#unsupported-versions).  
+
+
+<div class="wide-overflow" markdown="1">
+
+<table>
+  <thead>
+    <tr><th>Version</th><th>Downloads</th></tr>
+  </thead>
+  <tbody>
+    <tr><td><strong>v19.2</strong></td>
+        <td><a href="https://storage.googleapis.com/crdbdocs-archive/archive_19.2.zip" class="download-link">ZIP</a></td></tr>
+  </tbody>
+</table>
+
+</div>
+
+## Looking for current documentation?
+Visit our [current documentation](/docs/stable/) for the latest CockroachDB versions.