fix blog config with topics

Author: jbolda

astro.config.mjs

@@ -238,9 +238,17 @@ export default defineConfig({
             {
               label: { en: 'References', 'zh-CN': '参考', es: 'Referencias' },
               id: 'references',
-              link: '/references',
-              icon: 'information',
+              link: '/reference/cli',
+              icon: 'document',
               items: [
+                {
+                  label: 'Command Line Interface',
+                  translations: {
+                    'zh-CN': '命令行接口（CLI）',
+                    es: 'Interfaz de línea de comandos',
+                  },
+                  link: '/reference/cli/',
+                },
                 {
                   label: 'Security',
                   translations: {
@@ -250,14 +258,6 @@ export default defineConfig({
                   collapsed: true,
                   autogenerate: { directory: 'reference/acl' },
                 },
-                {
-                  label: 'Command Line Interface',
-                  translations: {
-                    'zh-CN': '命令行接口（CLI）',
-                    es: 'Interfaz de línea de comandos',
-                  },
-                  link: '/reference/cli/',
-                },
                 {
                   label: 'Configuration',
                   translations: {
@@ -304,12 +304,16 @@ export default defineConfig({
             },
             {
               label: 'Blog',
+              id: 'blog',
               link: '/blog/',
-              icon: 'information',
+              icon: 'pen',
+              // Empty item to instruct it that is is local files, not an external link
+              //  this is actually filled in through the topics dir for `blog` below
+              items: [],
             },
           ],
           {
-            exclude: ['/blog', '/blog/**/*'],
+            topics: { blog: ['/blog', '/blog/*', '/blog/**/*'] },
           }
         ),
         starlightLinksValidator({

src/content/config.ts renamed to src/content.config.ts

@@ -1,15 +1,14 @@
 import { defineCollection } from 'astro:content';
 import { i18nSchema, docsSchema } from '@astrojs/starlight/schema';
-// TODO fix docsSchema usage
-// import { docsSchema } from 'src/schemas/docsSchema';
 import { docsLoader, i18nLoader } from '@astrojs/starlight/loaders';
+import { topicSchema } from 'starlight-sidebar-topics/schema';
 import { blogSchema } from 'starlight-blog/schema';
 
 export const collections = {
   docs: defineCollection({
     loader: docsLoader(),
     schema: docsSchema({
-      extend: (context) => blogSchema(context),
+      extend: (context) => blogSchema(context).merge(topicSchema),
     }),
   }),
   i18n: defineCollection({ loader: i18nLoader(), schema: i18nSchema() }),

src/content/docs/404.md

@@ -1,5 +1,6 @@
 ---
 title: '404'
+topic: guides # will show this sidebar
 template: doc
 editUrl: false
 tableOfContents: false