change post URLs from /blog/slug to /YYYY/MM/slug

Preserves the Blogger-era year/month URL structure as the canonical path
so that blog.python.org/2026/02/python-3150-alpha-6/ works natively.
Redirects from .html legacy URLs now just strip the extension at the
same path instead of mapping to a completely different route.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: JacobCoffee

keystatic.config.tsx

@@ -122,7 +122,7 @@ export default config({
       format: { contentField: "content" },
       columns: ["publishDate", "author"],
       entryLayout: "content",
-      previewUrl: "/blog/{slug}",
+      // previewUrl requires computed year/month — not supported by Keystatic template syntax
       schema: {
         title: fields.slug({ name: { label: "Title" } }),
         publishDate: fields.date({ label: "Publish Date", validation: { isRequired: true } }),

scripts/migrate-blogger.ts

@@ -460,9 +460,12 @@ async function migrate() {
       const mdxContent = `${frontmatter}\n\n${markdown}\n`;
       fs.writeFileSync(path.join(postDir, "index.md"), mdxContent, "utf-8");
 
-      // Track redirect: legacy path → new path
+      // Track redirect: legacy .html path → route path (publishDate year/month + slug)
       if (legacyFilename) {
-        redirects[legacyFilename] = `/blog/${slug}`;
+        const pd = new Date(publishDate);
+        const y = pd.getUTCFullYear();
+        const m = String(pd.getUTCMonth() + 1).padStart(2, "0");
+        redirects[legacyFilename] = `/${y}/${m}/${slug}`;
       }
 
       migrated++;

src/components/BlogPostCard.astro

@@ -1,5 +1,5 @@
 ---
-import { formatDate, slugify, withBase } from "../lib/utils";
+import { formatDate, postUrl, slugify, withBase } from "../lib/utils";
 
 interface Props {
   slug: string;
@@ -18,7 +18,7 @@ const { slug, title, publishDate, author, description, tags, showEditLink = true
 <article class="post-card group relative px-5 py-4">
   <div class="flex items-start justify-between gap-4">
     <div class="min-w-0 flex-1">
-      <a href={withBase(`/blog/${slug}`)} class="block">
+      <a href={withBase(postUrl(slug, publishDate))} class="block">
         <h3 class="text-base font-semibold leading-snug text-zinc-900 transition-colors group-hover:text-[#306998] dark:text-zinc-100 dark:group-hover:text-[#ffd43b]" style="font-family: var(--font-display);">
           {title}
         </h3>

src/components/CommandPalette.tsx

@@ -5,6 +5,7 @@ import { useCallback, useEffect, useRef, useState } from "react";
 
 interface PostEntry {
   id: string;
+  url: string;
   title: string;
   description: string;
   author: string;
@@ -292,7 +293,7 @@ export default function CommandPalette({ open: controlledOpen, onOpenChange }: P
                   <Command.Item
                     key={post.id}
                     value={`post-${post.id}`}
-                    onSelect={() => navigate(withBase(`/blog/${post.id}`))}
+                    onSelect={() => navigate(withBase(post.url))}
                   >
                     <div className="cmdk-post-icon" aria-hidden="true">
                       <ArticleIcon />

src/components/Footer.astro

@@ -57,12 +57,9 @@ const year = new Date().getFullYear();
       <p class="text-xs text-zinc-400 dark:text-zinc-500">
         &copy; {year} Python Software Foundation
       </p>
-      <div class="flex items-center gap-1 text-xs text-zinc-400 dark:text-zinc-500">
-        <span>Powered by</span>
-        <a href="https://astro.build" class="underline decoration-zinc-300 underline-offset-2 hover:text-zinc-600 dark:decoration-zinc-600 dark:hover:text-zinc-300">Astro</a>
-        <span>&</span>
-        <a href="https://keystatic.com" class="underline decoration-zinc-300 underline-offset-2 hover:text-zinc-600 dark:decoration-zinc-600 dark:hover:text-zinc-300">Keystatic</a>
-      </div>
+      <p class="text-xs text-zinc-400 dark:text-zinc-500">
+        <a href="https://creativecommons.org/licenses/by-nc-sa/3.0/" rel="noopener noreferrer" class="underline decoration-zinc-300 underline-offset-2 hover:text-zinc-600 dark:decoration-zinc-600 dark:hover:text-zinc-300">CC BY-NC-SA 3.0</a>
+      </p>
     </div>
   </div>
 </footer>

src/data/redirects.json

@@ -24,6 +24,16 @@ export function withBase(path: string): string {
   return `${base}${path.startsWith("/") ? path : `/${path}`}`;
 }
 
+/**
+ * Returns the URL path for a blog post: /YYYY/MM/slug
+ */
+export function postUrl(slug: string, publishDate: string | Date): string {
+  const d = typeof publishDate === "string" ? new Date(publishDate) : publishDate;
+  const year = d.getUTCFullYear();
+  const month = String(d.getUTCMonth() + 1).padStart(2, "0");
+  return `/${year}/${month}/${slug}`;
+}
+
 export function slugify(text: string): string {
   return text
     .normalize("NFD")

src/lib/utils.ts

@@ -1,22 +1,29 @@
 ---
-import type { GetStaticPaths } from "astro";
-import type { CollectionEntry } from "astro:content";
-import BlogPostLayout from "../../layouts/BlogPostLayout.astro";
+import type { InferGetStaticPropsType } from "astro";
+import BlogPostLayout from "../../../layouts/BlogPostLayout.astro";
 import { getCollection, render } from "astro:content";
 
 export const prerender = true;
 
-export const getStaticPaths: GetStaticPaths = async () => {
+export async function getStaticPaths() {
   const posts = await getCollection("posts");
   return posts
     .filter((p) => p.data.published)
-    .map((post) => ({
-      params: { slug: post.id },
-      props: { post },
-    }));
-};
+    .map((post) => {
+      const d = post.data.publishDate;
+      return {
+        params: {
+          year: String(d.getUTCFullYear()),
+          month: String(d.getUTCMonth() + 1).padStart(2, "0"),
+          slug: post.id,
+        },
+        props: { post },
+      };
+    });
+}
 
-const { post } = Astro.props as { post: CollectionEntry<"posts"> };
+type Props = InferGetStaticPropsType<typeof getStaticPaths>;
+const { post } = Astro.props;
 const { Content, remarkPluginFrontmatter } = await render(post);
 const references = (remarkPluginFrontmatter?.references ?? []) as Array<{ type: string; label: string; url: string }>;
 ---

src/pages/blog/[slug].astro src/pages/[year]/[month]/[slug].astrosrc/pages/blog/[slug].astro renamed to src/pages/[year]/[month]/[slug].astro

@@ -3,7 +3,7 @@ export const prerender = true;
 
 import BaseLayout from "../layouts/BaseLayout.astro";
 import PythonLogo from "../components/PythonLogo.astro";
-import { formatDate, withBase } from "../lib/utils";
+import { formatDate, postUrl, withBase } from "../lib/utils";
 import { getCollection } from "astro:content";
 
 const allPosts = await getCollection("posts");
@@ -51,7 +51,7 @@ const authors = new Set(posts.map((p) => p.data.author));
             <span class="text-xs font-bold uppercase tracking-[0.15em] text-[#306998] dark:text-[#ffd43b]">Latest</span>
           </div>
 
-          <a href={withBase(`/blog/${featured.id}`)} class="group block">
+          <a href={withBase(postUrl(featured.id, featured.data.publishDate))} class="group block">
             <h1
               class="max-w-4xl text-3xl font-extrabold leading-[1.15] tracking-tight text-zinc-900 transition-colors group-hover:text-[#306998] dark:text-zinc-100 dark:group-hover:text-[#ffd43b] sm:text-4xl lg:text-5xl"
               style="font-family: var(--font-display); letter-spacing: -0.02em;"
@@ -121,7 +121,7 @@ const authors = new Set(posts.map((p) => p.data.author));
       <div class="grid gap-px overflow-hidden rounded-xl border border-zinc-200 bg-zinc-200 dark:border-zinc-800 dark:bg-zinc-800 sm:grid-cols-2">
         {recent.map((post) => (
           <article class="post-card group relative bg-white p-5 dark:bg-[#0f1117]">
-            <a href={withBase(`/blog/${post.id}`)} class="block">
+            <a href={withBase(postUrl(post.id, post.data.publishDate))} class="block">
               <h3 class="text-[0.9375rem] font-semibold leading-snug text-zinc-900 transition-colors group-hover:text-[#306998] dark:text-zinc-100 dark:group-hover:text-[#ffd43b]" style="font-family: var(--font-display);">
                 {post.data.title}
               </h3>

src/pages/index.astro

@@ -1,7 +1,7 @@
 import rss from "@astrojs/rss";
 import type { APIContext } from "astro";
 import { getCollection } from "astro:content";
-import { withBase } from "../lib/utils";
+import { postUrl, withBase } from "../lib/utils";
 
 export const prerender = true;
 
@@ -20,7 +20,7 @@ export async function GET(context: APIContext) {
       title: post.data.title,
       pubDate: post.data.publishDate,
       description: post.data.description ?? "",
-      link: withBase(`/blog/${post.id}/`),
+      link: withBase(`${postUrl(post.id, post.data.publishDate)}/`),
       author: post.data.author,
       categories: post.data.tags,
     })),