Merge branch 'main' into reteps/docs-move

Author: reteps

.gitignore

@@ -14,6 +14,9 @@ yarn-error.log
 public/build
 out
 
+# Other generated files
+public/blog/rss.xml
+
 # macOS files
 .DS_Store
 

package.json

@@ -40,6 +40,7 @@
     "remark-emoji": "^5.0.2",
     "remark-gfm": "^4.0.1",
     "remark-math": "^6.0.0",
+    "rss": "^1.2.2",
     "slugify": "^1.6.6",
     "unified": "^11.0.5",
     "unist-util-visit": "^5.0.0",
@@ -49,6 +50,7 @@
     "@types/fs-extra": "^11.0.4",
     "@types/node": "^24.1.0",
     "@types/react": "^19.1.9",
+    "@types/rss": "^0.0.32",
     "@types/unist": "^3.0.3",
     "eslint": "^9.32.0",
     "eslint-config-next": "^16.1.1",

src/lib/rss.ts

@@ -0,0 +1,41 @@
+import fs from "fs/promises";
+import path from "path";
+import RSS from "rss";
+import { BlogPostWithSlug } from "./blog";
+
+const SITE_URL = process.env.VERCEL_PROJECT_PRODUCTION_URL
+  ? `https://${process.env.VERCEL_PROJECT_PRODUCTION_URL}`
+  : "https://www.prairielearn.com";
+const BLOG_URL = `${SITE_URL}/about/blog`;
+
+export async function generateRssFeed(
+  posts: BlogPostWithSlug[],
+): Promise<void> {
+  const feed = new RSS({
+    title: "PrairieLearn Blog",
+    description:
+      "News, updates, teaching strategies, and deep dives from the PrairieLearn team.",
+    feed_url: `${SITE_URL}/blog/rss.xml`,
+    site_url: BLOG_URL,
+    language: "en-us",
+  });
+
+  for (const post of posts) {
+    feed.item({
+      title: post.title,
+      description: post.excerpt || "",
+      url: `${BLOG_URL}/${post.slug}`,
+      guid: `${BLOG_URL}/${post.slug}`,
+      categories: post.tags || [],
+      author: post.author,
+      date: new Date(post.date),
+    });
+  }
+
+  const outputDir = path.join(process.cwd(), "public", "blog");
+  await fs.mkdir(outputDir, { recursive: true });
+  await fs.writeFile(
+    path.join(outputDir, "rss.xml"),
+    feed.xml({ indent: true }),
+  );
+}

src/pages/about/blog/index.tsx

@@ -7,7 +7,8 @@ import { Heading } from "../../../components/Heading";
 import Stack from "../../../components/Stack";
 import { TagList } from "../../../components/Tag";
 import { format } from "date-fns";
-import { getAllPosts, BlogPost, BlogPostWithSlug } from "../../../lib/blog";
+import { getAllPosts, BlogPostWithSlug } from "../../../lib/blog";
+import { generateRssFeed } from "../../../lib/rss";
 
 import styles from "./index.module.scss";
 
@@ -42,6 +43,12 @@ export default function BlogIndex({ posts }: BlogIndexProps) {
           name="description"
           content="News, updates, teaching strategies, and deep dives from the PrairieLearn team."
         />
+        <link
+          rel="alternate"
+          type="application/rss+xml"
+          title="PrairieLearn Blog RSS Feed"
+          href="/blog/rss.xml"
+        />
       </Head>
 
       <PageBanner
@@ -76,6 +83,8 @@ export default function BlogIndex({ posts }: BlogIndexProps) {
 export const getStaticProps: GetStaticProps<BlogIndexProps> = async () => {
   const posts = await getAllPosts();
 
+  await generateRssFeed(posts);
+
   return {
     props: {
       posts,

yarn.lock

@@ -1213,6 +1213,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@types/rss@npm:^0.0.32":
+  version: 0.0.32
+  resolution: "@types/rss@npm:0.0.32"
+  checksum: 10c0/b8e214cde30f0d31ad468bcdc8f5370ce7a4b0dc6f2cb131dcfa115a90b6dbc765c4f668e551d5638072f8c1f25e0e81048c3c684b046c91803a9e0dec157c72
+  languageName: node
+  linkType: hard
+
 "@types/unist@npm:*, @types/unist@npm:^3.0.0, @types/unist@npm:^3.0.3":
   version: 3.0.3
   resolution: "@types/unist@npm:3.0.3"
@@ -4141,6 +4148,7 @@ __metadata:
     "@types/fs-extra": "npm:^11.0.4"
     "@types/node": "npm:^24.1.0"
     "@types/react": "npm:^19.1.9"
+    "@types/rss": "npm:^0.0.32"
     "@types/unist": "npm:^3.0.3"
     bootstrap: "npm:^5.3.7"
     bootstrap-icons: "npm:^1.13.1"
@@ -4171,6 +4179,7 @@ __metadata:
     remark-emoji: "npm:^5.0.2"
     remark-gfm: "npm:^4.0.1"
     remark-math: "npm:^6.0.0"
+    rss: "npm:^1.2.2"
     sass: "npm:^1.89.2"
     slugify: "npm:^1.6.6"
     typescript: "npm:^5.8.3"
@@ -4894,6 +4903,22 @@ __metadata:
   languageName: node
   linkType: hard
 
+"mime-db@npm:~1.25.0":
+  version: 1.25.0
+  resolution: "mime-db@npm:1.25.0"
+  checksum: 10c0/a90951c80700314d6131e106cbf56ae94718d046e9669a5afd7f91e603248da328aad5b63314865fd9547f4688465ac62d1ace59e1ffdb73688452a28a9c3622
+  languageName: node
+  linkType: hard
+
+"mime-types@npm:2.1.13":
+  version: 2.1.13
+  resolution: "mime-types@npm:2.1.13"
+  dependencies:
+    mime-db: "npm:~1.25.0"
+  checksum: 10c0/a53a0453f7863fa2d823025ce92978f5142a18528316caa53cbb1d4212be847973e9a5f2466362cbd2351a512e369252fc2c88c9c5bbc85df4bd8b42214f1785
+  languageName: node
+  linkType: hard
+
 "minimatch@npm:^3.1.2":
   version: 3.1.2
   resolution: "minimatch@npm:3.1.2"
@@ -5970,6 +5995,16 @@ __metadata:
   languageName: node
   linkType: hard
 
+"rss@npm:^1.2.2":
+  version: 1.2.2
+  resolution: "rss@npm:1.2.2"
+  dependencies:
+    mime-types: "npm:2.1.13"
+    xml: "npm:1.0.1"
+  checksum: 10c0/7e37a6ed1820b69476c76e4fefe09f69dd7505408e9fc7690441a5190aca2e2e2faf8d19575fd1efd66debfb178893374fbff9abf68e5416f5e4d4cccb7ae8b9
+  languageName: node
+  linkType: hard
+
 "run-parallel@npm:^1.1.9":
   version: 1.2.0
   resolution: "run-parallel@npm:1.2.0"
@@ -7161,6 +7196,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"xml@npm:1.0.1":
+  version: 1.0.1
+  resolution: "xml@npm:1.0.1"
+  checksum: 10c0/04bcc9b8b5e7b49392072fbd9c6b0f0958bd8e8f8606fee460318e43991349a68cbc5384038d179ff15aef7d222285f69ca0f067f53d071084eb14c7fdb30411
+  languageName: node
+  linkType: hard
+
 "yallist@npm:^3.0.2":
   version: 3.1.1
   resolution: "yallist@npm:3.1.1"