refactor(website): generate /blog/ by scanning for files

strager · strager · commit 3db5cacc1d4c · 2023-01-18T18:48:55.000-08:00
The list of links on /blog/ is manually maintained. This is prone to
mistakes; I could put the wrong title, or forget to link a post
altogether.

Generate the list of links on /blog/ by scanning the filesystem and
reading the front matter.
diff --git a/website/public/blog/bug-journey/index.ejs.html b/website/public/blog/bug-journey/index.ejs.html
@@ -1,5 +1,6 @@
 <!---{
 "title": "Sometimes it *is* a compiler bug",
+"linkLabelHTML": "Sometimes it <em>is</em> a compiler bug",
 "description": "My journey in finding and fixing a bug in a C++ toolchain",
 "blogDate": "2022-05-25T21:04:02-07:00"
 }--->
diff --git a/website/public/blog/index.ejs.html b/website/public/blog/index.ejs.html
@@ -9,6 +9,40 @@
   <head>
     <%- await include("../common-head.ejs.html") %> <%- await
     include("./blog-head.ejs.html") %>
+    <script>
+      //<%
+      let ejs = await import("ejs");
+      let fs = await import("node:fs");
+      let path = await import("node:path");
+      let { readFrontMatterFromFileAsync } = await importFileAsync("../../src/front-matter.mjs");
+
+      async function loadBlogPostsAsync() {
+        let directories = await fs.promises.readdir(absoluteFilePath('.'), {withFileTypes: true});
+        directories = directories.filter(dir => dir.isDirectory());
+        let posts = await Promise.all(directories.map(async dir => {
+          let indexPath = absoluteFilePath(path.join(dir.name, "index.ejs.html"));
+          let meta = await readFrontMatterFromFileAsync(indexPath);
+          if (typeof meta.blogDate === 'undefined') {
+            throw new Error(`Missing blogDate in front matter of ${indexPath}`);
+          }
+          return {
+            dir: dir.name,
+            meta: meta,
+          };
+        }));
+        sortPostsReverseChronologically(posts);
+        return posts;
+      }
+
+      function sortPostsReverseChronologically(posts) {
+        posts.sort((a, b) => {
+          if (a.meta.blogDate < b.meta.blogDate) return +1;
+          if (a.meta.blogDate > b.meta.blogDate) return -1;
+          return 0;
+        });
+      }
+      //%>
+    </script>
     <link href="../main.css" rel="stylesheet" />
   </head>
   <body class="side-bar-nav">
@@ -18,30 +52,13 @@
       <h2>quick-lint-js blog</h2>
 
       <ul>
+        <% for (let post of await loadBlogPostsAsync()) { %>
         <li>
-          <a href="cpp-vs-rust-build-times/"
-            >Is coding in Rust as bad as in C++?</a
-          >
-        </li>
-        <li>
-          <a href="bug-journey/">Sometimes it <em>is</em> a compiler bug</a>
-        </li>
-        <li>
-          <a href="show-js-errors-neovim-macos/"
-            >Show JavaScript errors in Neovim on macOS</a
-          >
-        </li>
-        <li>
-          <a href="version-2.0/">Release: version 2.0</a>
-        </li>
-        <li>
-          <a href="version-1.0/">Release: version 1.0</a>
-        </li>
-        <li>
-          <a href="syntax-errors-2021/"
-            >JavaScript syntax errors compared (2021)</a
+          <a href="<%= post.dir %>/"
+            ><%- post.meta.linkLabelHTML ?? ejs.escapeXML(post.meta.title) %></a
           >
         </li>
+        <% } %>
       </ul>
     </main>
 
diff --git a/website/public/blog/version-1.0/index.ejs.html b/website/public/blog/version-1.0/index.ejs.html
@@ -1,5 +1,6 @@
 <!---{
 "title": "Faster, easier, friendlier: how quick-lint-js will take over ESLint",
+"linkLabelHTML": "Release: version 1.0",
 "blogDate": "2021-12-13T19:27:37-08:00"
 }--->
 
diff --git a/website/public/blog/version-2.0/index.ejs.html b/website/public/blog/version-2.0/index.ejs.html
@@ -1,5 +1,6 @@
 <!---{
 "title": "Reacts rocks with quick-lint-js",
+"linkLabelHTML": "Release: version 2.0",
 "blogDate": "2022-02-04T21:43:20-08:00"
 }--->
 
diff --git a/website/src/front-matter.mjs b/website/src/front-matter.mjs
@@ -1,6 +1,8 @@
 // Copyright (C) 2020  Matthew "strager" Glazar
 // See end of file for extended copyright information.
 
+import fs from "node:fs";
+
 // @returns { data: object, strippedHTML: string }
 export function stripHTMLFrontMatter(html) {
   let match = html.match(/^<!---(?<json>.*?)--->\n*/s);
@@ -17,6 +19,11 @@ export function stripHTMLFrontMatter(html) {
   };
 }
 
+export async function readFrontMatterFromFileAsync(filePath) {
+  let html = await fs.promises.readFile(filePath, "utf-8");
+  return stripHTMLFrontMatter(html).data;
+}
+
 // quick-lint-js finds bugs in JavaScript programs.
 // Copyright (C) 2020  Matthew "strager" Glazar
 //
