Display docs.

Author: brixen

package-lock.json

@@ -10,6 +10,7 @@
     "astro": "astro"
   },
   "dependencies": {
+    "@astrojs/rss": "^4.0.14",
     "@astrojs/solid-js": "^5.1.2",
     "@shoelace-style/shoelace": "^2.20.1",
     "astro": "^5.6.1",

package.json

@@ -0,0 +1,58 @@
+---
+import { getCollection } from "astro:content";
+
+const articles = await getCollection("articles");
+const tutorials = await getCollection("tutorials");
+const howtos = await getCollection("howtos");
+const reference = await getCollection("reference");
+---
+
+    <aside class="hidden sm:block">
+    <h1 class="mb-2 px-2 text-xs font-semibold uppercase tracking-wide">
+      Documentation
+    </h1>
+
+    <section>
+      <h2 class="mb-2 px-2 text-xs font-semibold uppercase tracking-wide">
+        Articles
+      </h2>
+      <ul class="mb-2 px-2 text-xs tracking-wide">
+        {articles.map((d) => (
+        <li><a href={`/docs/articles/${d.id}/`}>{d.data.title}</a></li>
+        ))}
+      </ul>
+    </section>
+
+    <section>
+      <h2 class="mb-2 px-2 text-xs font-semibold uppercase tracking-wide">
+        Tutorials
+      </h2>
+      <ul>
+        {tutorials.map((d) => (
+          <li><a href={`/docs/${d.slug}/`}>{d.data.title}</a></li>
+        ))}
+      </ul>
+    </section>
+
+    <section>
+      <h2 class="mb-2 px-2 text-xs font-semibold uppercase tracking-wide">
+        How-to guides
+      </h2>
+      <ul>
+        {howtos.map((d) => (
+          <li><a href={`/docs/${d.slug}/`}>{d.data.title}</a></li>
+        ))}
+      </ul>
+    </section>
+
+    <section>
+      <h2 class="mb-2 px-2 text-xs font-semibold uppercase tracking-wide opacity-70">
+        Reference
+      </h2>
+      <ul>
+        {reference.map((d) => (
+          <li><a href={`/docs/${d.slug}/`}>{d.data.title}</a></li>
+        ))}
+      </ul>
+    </section>
+    </aside>

src/components/DocList.astro

@@ -1,18 +1,24 @@
 ---
-import { siBluesky, siGithub, siDiscord, siYoutube } from "simple-icons";
+import { siBluesky, siGithub, siDiscord, siRss, siYoutube } from "simple-icons";
 
 const icons = [
   { icon: siBluesky, url: "https://bsky.app/profile/rubinius.com" },
   { icon: siDiscord, url: "https://discord.gg/25GuZR4fBN" },
   // { icon: siYoutube, url: "" },
   { icon: siGithub, url: "https://github.com/rubinius/" },
+  { icon: siRss, url: "/rss.xml" },
 ];
 ---
 
 <div class="flex gap-2 items-end">
   {icons.map(({ icon, color, dark, url }) => (
-  <a class="text-fg/60 rounded-sm hover:text-fg/100 hover:ring-1 hover:p-1 hover:ring-accent/60" href={url}>
-    <svg fill="currentColor" viewBox="0 0 24 24" aria-label={icon.title} width="24" height="24">
+  <a class="rounded-full ring-1 p-1.5
+            bg-bg text-fg/60
+            transition-colors
+            hover:bg-fg hover:text-bg
+            hover:ring-accent/60"
+            href={url}>
+    <svg fill="currentColor" viewBox="0 0 24 24" aria-label={icon.title} width="20" height="20">
       <path d={icon.path} />
     </svg>
   </a>

src/components/SocialIcons.astro

@@ -1,16 +1,14 @@
 import { defineCollection, z } from 'astro:content';
+import { glob } from "astro/loaders";
 
-const docs = defineCollection({
-  type: "content",
-  schema: z.object({
-    title: z.string(),
-    tags: z.array(z.string()).optional(),
-    order: z.number().optional(),
-  }),
+const docsSchema = z.object({
+  title: z.string(),
+  tags: z.array(z.string()).optional(),
+  order: z.number().optional(),
 });
 
 const blog = defineCollection({
-  type: "content",
+  loader: glob({ pattern: "**/*.mdoc", base: "./src/content/blog" }),
   schema: z.object({
     title: z.string(),
     subtitle: z.string().optional(),
@@ -22,7 +20,30 @@ const blog = defineCollection({
   }),
 });
 
+const articles = defineCollection({
+  loader: glob({ pattern: "**/*.mdoc", base: "./src/content/docs/articles" }),
+  schema: docsSchema,
+});
+
+const tutorials = defineCollection({
+  loader: glob({ pattern: "**/*.mdoc", base: "./src/content/docs/tutorials" }),
+  schema: docsSchema,
+});
+
+const howtos = defineCollection({
+  loader: glob({ pattern: "**/*.mdoc", base: "./src/content/docs/howtos" }),
+  schema: docsSchema,
+});
+
+const reference = defineCollection({
+  loader: glob({ pattern: "**/*.mdoc", base: "./src/content/docs/reference" }),
+  schema: docsSchema,
+});
+
 export const collections = {
-  blog: blog,
-  docs: docs,
+  blog,
+  articles,
+  tutorials,
+  howtos,
+  reference,
 };

src/content/config.ts

@@ -1,5 +1,5 @@
 ---
-title: The Rubinius Build System
+title: The Build System
 ---
 
 ## A Little History
@@ -43,6 +43,24 @@ system just must do it its own way, it can remix easily and safely.
 The rest of this article explains in detail how the Rubinius build system
 works.
 
+Scale:
+
+1. Large galaxy: Linux;
+1. Small galaxy: LLVM;
+1. Solar system: Rubinius;
+1. Jupiter-sized planet: rbx compiler;
+1. Earth-sized planet: Ruby core library;
+1. Large mountain on earth: A library like OpenFHE;
+1. Big hill: A library like libasio;
+1. A large rock: Python PEG parser;
+1. A smaller rock: CLI11 command line libray.
+
+Anything the size of a rock should be a separately-buildable package, and anything larger than a rock should only be a composition of such packages.
+
+Every biological system is a collection of well-bounded components, most of them microscopic. Only humans, in their infinite "wisdom" conjure something like Bazel.
+
+Why would anyone want to install Java to build a C/C++ library?
+
 ## Setting Boundaries
 
 Some reasons to put a component in its own repository:
@@ -54,3 +72,23 @@ Some reasons to put a component in its own repository:
 * It has particular testing or security concerns;
 
 **( This document is a draft work-in-progress. )**
+
+```
+make help
+Usage:
+  make <target>
+
+Dependencies
+  setup            Clone all components
+  config           Configure
+
+Development
+  build            Build all components
+
+Testing
+  test             Run the tests
+
+Maintenance
+  clean            Remove all build artifacts
+  help             Display this help
+```

src/content/docs/articles/the-rubinius-build-system.mdoc

@@ -0,0 +1,21 @@
+---
+title: The Roadmap
+---
+
+These are the current milestones organized by GitHub repository:
+
+* **[rubinius/compiler-ng](https://github.com/rubinius/compiler-ng)**
+  * [1a: LLVM end-to-end compiler](https://github.com/rubinius/compiler-ng/milestone/1)
+  * [1b: Language interface to the compiler](https://github.com/rubinius/compiler-ng/milestone/2)
+  * [3a: Tier-1 JIT](https://github.com/rubinius/compiler-ng/milestone/3)
+  * [3b: Language interface to the JIT](https://github.com/rubinius/compiler-ng/milestone/4)
+  * [4: Language updates](https://github.com/rubinius/compiler-ng/milestone/5)
+  * [10: Tier-N JIT](https://github.com/rubinius/compiler-ng/milestone/6)
+
+* **[rubinius/rubinius](https://github.com/rubinius/rubinius)**
+  * [2: Rubinius build system & GitHub Actions](https://github.com/rubinius/rubinius/milestone/6)
+  * [5: Rubygems+Bundler running](https://github.com/rubinius/rubinius/milestone/7)
+  * [6: Ruby core library passing specs](https://github.com/rubinius/rubinius/milestone/8)
+  * [7: Ruby standard library passing specs](https://github.com/rubinius/rubinius/milestone/9)
+  * [8: Metasploit passing specs](https://github.com/rubinius/rubinius/milestone/10)
+  * [9: Rails and Hanami passing specs](https://github.com/rubinius/rubinius/milestone/11)

src/content/docs/articles/the-rubinius-roadmap.mdoc

@@ -30,7 +30,7 @@ export async function getBlogList(): Promise<Array<{ title: string; path: string
   posts.sort(cmpBlog);
   return posts.map((p) => ({
     title: p.data.title,
-    path: `/blog/${p.slug}/`,
+    path: `/blog/${p.id}/`,
   }));
 }