feat: per-tag page

Author: nullishamy

.github/workflows/tola-build.yaml

@@ -10,23 +10,37 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v6
 
-      - name: Set Node.js 24.x
+      - name: Setup Node.js 24.x
         uses: actions/setup-node@v6
         with:
           node-version: 24
+          
+      - name: Setup Deno
+        uses: denoland/setup-deno@v2
+        with:
+          deno-version: lts
 
       - name: Install tailwindcss
         run: |
           npm init -y
           npm i tailwindcss @tailwindcss/cli
           
-      - name: Tola build
+      - name: Tola build (data files)
         run: |
           wget 'https://github.com/tola-rs/tola-ssg/releases/download/v0.6.5/tola-x86_64-linux-static.tar.gz'
           tar xzvf tola-*
           chmod +x ./tola
           ls -lah
           PATH="./node_modules/.bin:$PATH" ./tola build
+          
+      - name: Tag generation
+        run: |
+          cd scripts
+          deno run -A gen-tags.ts
+          
+      - name: Tola build (final)
+        run: |
+          PATH="./node_modules/.bin:$PATH" ./tola build
         
       - name: Upload Artifacts
         uses: actions/upload-pages-artifact@v3

content/tags.typ

@@ -0,0 +1,13 @@
+#import "/templates/page.typ": page
+#import "/utils/helpers.typ" as utils
+
+#show: page.with(title: "home")
+
+#html.h1(class: "text-4xl font-bold text-center mb-8")[all tags]
+
+#let tags = json("/_data/tags.json")
+#html.div(class: "flex flex-col gap-2")[
+    #for tag in tags.keys() {
+        html.a(href: "/tags/" + tag)[#text("#" + tag)]
+    }
+]

content/tags/tag.typ.tmpl

@@ -0,0 +1,7 @@
+#import "/templates/tag.typ": tag-listing
+
+#let args = (
+    tag: "{TAG}"
+)
+
+#show: tag-listing.with(..args)

flake.nix

@@ -27,6 +27,7 @@
             inputs.tola.packages.${pkgs.system}.default
             tailwindcss_4
             typstyle
+            deno
           ]; 
         };
       };

scripts/gen-tags.ts

@@ -0,0 +1,17 @@
+const tagJsonPath = "../public/_data/tags.json"
+const templatePath = "../content/tags/tag.typ.tmpl"
+const outputRoot = "../content/tags/"
+
+const tags = JSON.parse(Deno.readTextFileSync(tagJsonPath))
+const tagNames = Object.keys(tags)
+console.log("generating files for", tagNames.length, "tags")
+
+let template = Deno.readTextFileSync(templatePath)
+
+for (const tag of tagNames) {
+  const newFile = template.replace("{TAG}", tag)
+  const outputPath = outputRoot + tag + ".typ"
+  
+  Deno.writeTextFileSync(outputPath, newFile);
+  console.log("wrote to", outputPath, "for tag", tag)
+}

templates/tag.typ

@@ -0,0 +1,18 @@
+#import "/templates/base.typ": base, colors
+#import "/utils/helpers.typ" as utils
+
+#let tag-listing(tag: none, body) = {
+    show: base
+    
+    html.h1(class: "text-4xl font-bold text-center mb-8")[posts tagged '#tag']
+    
+    let pages = json("/_data/pages.json")
+    let tags = json("/_data/tags.json")
+    let postsWithTag = tags.at(tag, default: ())
+    html.div(class: "flex flex-col items-center")[
+        #for taggedPost in postsWithTag {
+            let post = pages.filter(p => p.url == taggedPost.url).at(0)
+            utils.post-card(post)
+        }
+    ]
+}

utils/helpers.typ

@@ -1,9 +1,4 @@
-// Shared utilities
-// Import: #import "/utils/helpers.typ": *
-
-
 #let hr = html.hr(class: "border-text/50 my-4")
-
 #let nav-link(href, label) = html.a(
     class: "text-muted hover:text-accent transition-colors",
     href: href,
@@ -17,32 +12,22 @@
     }
     #body
 ]
-// Helper for flex rows.
-// We use a safelist comment to ensure Tailwind generates these classes.
+
 // safelist: gap-1 gap-2 gap-3 gap-4 gap-5 gap-6 gap-8
 #let flex-row(gap: "4", ..items) = html.div(
     class: "flex flex-wrap gap-" + gap + " items-center",
 )[#for item in items.pos() { item }]
 
 #let to-string(value) = repr(value)
 
-// ----------------------------------------------------------------------------
-// Post Helpers
-// ----------------------------------------------------------------------------
-
-// Helper to fetching posts from the virtual JSON file
-// - Filters for pages with "/posts/" anywhere in URL (supports path_prefix)
-// - Excludes drafts
-// - Sorts by date (newest first)
-
 // Helper to render a consistent post card
 // - post: The post object from get-posts()
 #let post-card(post) = {
     let date = post.at("date", default: "")
     // Cleaner approach: Wrap the whole card in a block-level anchor tag.
     // HTML5 allows block elements (div, h3, p) inside anchor tags.
     html.a(
-        class: "block mb-6 p-4 border border-white/10 rounded-lg bg-surface/50 hover:bg-surface transition-colors no-underline group",
+        class: "block mb-6 p-4 border border-white/10 rounded-lg bg-surface/50 hover:bg-surface transition-colors no-underline group w-full",
         href: post.url,
     )[
         #html.h3(