Streamline other format lists

Author: lucperkins

src/pages/llms-full.txt.ts

@@ -1,5 +1,6 @@
 import { conceptPagePath, startPagePath } from "../lib/utils";
 import { site } from "../site";
+import { FORMATS } from "./llms.txt";
 import type { APIRoute } from "astro";
 import { getCollection } from "astro:content";
 import Handlebars from "handlebars";
@@ -38,18 +39,7 @@ export const GET: APIRoute = async () => {
       href: `${root}/${conceptPagePath(slug)}`,
       content: body,
     })),
-    otherFormats: [
-      {
-        root,
-        file: "llms.txt",
-        description: "the main version",
-      },
-      {
-        root,
-        file: "llms-full.txt",
-        description: "complete content in one file",
-      },
-    ],
+    otherFormats: [FORMATS.small, FORMATS.standard],
   });
 
   return new Response(content, {

src/pages/llms-small.txt.ts

@@ -1,4 +1,5 @@
 import { site } from "../site";
+import { FORMATS } from "./llms.txt";
 import type { APIRoute } from "astro";
 import { getCollection } from "astro:content";
 import Handlebars from "handlebars";
@@ -28,18 +29,7 @@ export const GET: APIRoute = async () => {
     conceptPages: conceptPages.map(({ data: { title } }) => ({
       title,
     })),
-    otherFormats: [
-      {
-        root,
-        file: "llms.txt",
-        description: "the main version",
-      },
-      {
-        root,
-        file: "llms-full.txt",
-        description: "complete content in one file",
-      },
-    ],
+    otherFormats: [FORMATS.standard, FORMATS.full],
   });
 
   return new Response(content, {

src/pages/llms.txt.ts

@@ -8,6 +8,27 @@ import path from "node:path";
 
 const { url: root, title, description: tagline, llms } = site;
 
+export const FORMATS: Record<
+  string,
+  { root: string; file: string; description: string }
+> = {
+  standard: {
+    root,
+    file: "llms.txt",
+    description: "the main version",
+  },
+  small: {
+    root,
+    file: "llms-small.txt",
+    description: "compact structure-only version",
+  },
+  full: {
+    root,
+    file: "llms-full.txt",
+    description: "complete content in one file",
+  },
+};
+
 const templateFile = fs.readFileSync(
   path.join(process.cwd(), "src/templates/llms.txt.hbs"),
   "utf-8",
@@ -32,18 +53,7 @@ export const GET: APIRoute = async () => {
       title,
       href: `${root}/${conceptPagePath(slug)}`,
     })),
-    otherFormats: [
-      {
-        root,
-        file: "llms-small.txt",
-        description: "compact structure-only version",
-      },
-      {
-        root,
-        file: "llms-full.txt",
-        description: "complete content in one file",
-      },
-    ],
+    otherFormats: [FORMATS.small, FORMATS.full],
   });
 
   return new Response(content, {

src/site.ts

@@ -57,7 +57,7 @@ export const site: Site = {
   description: "Your guide to learning Nix and flakes",
   llms: {
     description:
-      "Zero to Nix is an opinionated learning resource for Nix created by [Determinate Systems](https://determinate.systems/llms.txt). It takes you on a [learning journey](#start-pages) from installing Nix to exploring Nix development environments to building Nix packages and more. It also offers a series of [concept pages](#concept-pages) covering some of the trickier corners of Nix.",
+      "Zero to Nix is a flake-centric resource for learning Nix created by [Determinate Systems](https://determinate.systems/llms.txt). It takes you on a [learning journey](#start-pages) from installing Nix to exploring Nix development environments to building Nix packages and more. It also offers a series of [concept pages](#concept-pages) covering some of the trickier corners of Nix.",
   },
   githubUrl: "https://github.com/DeterminateSystems/zero-to-nix",
   languages: ["C++", "Go", "Haskell", "JavaScript", "Python", "Rust", "Scala"],