Display all pulsar api versions as list

docs/api/pulsar.md

@@ -2,7 +2,7 @@
 title: Pulsar API
 layout: doc.ejs
 includeTemplate:
-  - latest_pulsar_version
+  - pulsar_versions
 ---
 
 The Pulsar API is what makes Pulsar so incredibly customizable. All packages consume it, including the packages built into the editor.

helpers/index.js

@@ -1,6 +1,8 @@
-
 // View helpers. Available in EJS templates via the `helpers` namespace.
 
+const fs = require("fs");
+const semver = require("semver");
+
 module.exports = {
   nextAndPreviousSidebarEntries(url, sidebar) {
     let prev = null, next = null;
@@ -12,5 +14,33 @@ module.exports = {
       if (index < lastIndex) next = sidebar[index + 1];
     }
     return [prev, next];
+  },
+
+  getAllPulsarVersions() {
+    // Returns an array of Pulsar semver versions, in order, and without 'latest'
+
+    let verArr = [];
+
+    const verDocs = fs.readdirSync("./pulsar-api/content");
+
+    for (const doc of verDocs) {
+      let clean = doc.replace(".json", "");
+
+      let name = clean;
+
+      if (!name.startsWith("v")) {
+        name = "v" + name;
+      }
+
+      verArr.push({
+        name: name,
+        link: clean
+      });
+    }
+
+    // Sort version array in order
+    verArr.sort((a, b) => { return semver.rcompare(a.name, b.name); });
+
+    return verArr;
   }
 };

layouts/pulsar_versions.ejs

@@ -0,0 +1,31 @@
+
+<%
+  const pulsarApiVersions = helpers.getAllPulsarVersions();
+-%>
+
+<ul class="list">
+
+  <li class="list-item">
+    <div class="list-item__inner">
+      <h3 class="list-item__name">
+        <a href="/api/pulsar/latest">
+          Latest API documentation
+        </a>
+      </h3>
+    </div>
+  </li>
+
+  <h3>All versions</h3>
+  <% for (const pulsarVersion of pulsarApiVersions) { %>
+    <li class="list-item">
+      <div class="list-item__inner">
+        <h4 class="list-item__name">
+          <a href="/api/pulsar/<%=pulsarVersion.link%>">
+            <%=pulsarVersion.name%>
+          </a>
+        </h4>
+      </div>
+    </li>
+  <% } %>
+
+</ul>