Docs: split changelog into per-release files

Use these as the body for (future) GitHub releases

Author: lovell

.github/workflows/ci.yml

@@ -314,6 +314,12 @@ jobs:
           path: npm
       - name: Create npm workspace tarball
         run: tar -vcaf npm-workspace.tar.xz --directory npm --exclude=from-local-build.js .
+      - name: Parse semver for tag
+        if: startsWith(github.ref, 'refs/tags/v')
+        uses: madhead/semver-utils@v4
+        id: semver
+        with:
+          version: ${{ github.ref_name }}
       - name: Create GitHub release for tag
         if: startsWith(github.ref, 'refs/tags/v')
         uses: ncipollo/release-action@v1
@@ -322,3 +328,4 @@ jobs:
           artifactContentType: application/x-xz
           prerelease: ${{ contains(github.ref, '-rc') }}
           makeLatest: ${{ !contains(github.ref, '-rc') }}
+          bodyFile: "docs/src/content/docs/changelog/v${{ steps.semver.outputs.major }}.${{ steps.semver.outputs.minor }}.${{ steps.semver.outputs.patch }}.md"

docs/astro.config.mjs

@@ -1,6 +1,9 @@
 // @ts-check
 import { defineConfig } from 'astro/config';
 import starlight from '@astrojs/starlight';
+import starlightAutoSidebar from 'starlight-auto-sidebar';
+
+import { version } from '../package.json';
 
 export default defineConfig({
   site: 'https://sharp.pixelplumbing.com',
@@ -68,12 +71,20 @@ export default defineConfig({
           ]
         },
         { label: 'Performance', slug: 'performance' },
-        { label: 'Changelog', slug: 'changelog' }
+        {
+          label: 'Changelog',
+          collapsed: true,
+          autogenerate: { directory: 'changelog' }
+        }
       ],
       social: [
         { icon: 'openCollective', label: 'Open Collective', href: 'https://opencollective.com/libvips' },
         { icon: 'github', label: 'GitHub', href: 'https://github.com/lovell/sharp' }
-      ]
+      ],
+      plugins: [starlightAutoSidebar()]
     })
-  ]
+  ],
+  redirects: {
+    '/changelog': `/changelog/v${version}`
+  }
 });

docs/package.json

@@ -11,7 +11,8 @@
     "astro": "astro"
   },
   "dependencies": {
-    "@astrojs/starlight": "^0.34.3",
-    "astro": "^5.7.13"
+    "@astrojs/starlight": "^0.34.6",
+    "astro": "^5.11.1",
+    "starlight-auto-sidebar": "^0.1.2"
   }
 }

docs/src/content.config.ts

@@ -1,7 +1,10 @@
 import { defineCollection } from 'astro:content';
 import { docsLoader } from '@astrojs/starlight/loaders';
 import { docsSchema } from '@astrojs/starlight/schema';
+import { autoSidebarLoader } from 'starlight-auto-sidebar/loader'
+import { autoSidebarSchema } from 'starlight-auto-sidebar/schema'
 
 export const collections = {
 	docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
+	autoSidebar: defineCollection({ loader: autoSidebarLoader(), schema: autoSidebarSchema() })
 };