add docs

readme.md

@@ -22,4 +22,4 @@ Pages is licensed under the [MIT License](LICENSE).
 
 ## Acknowledgments
 
-This website is derived from zeon-studio's [astroplate](https://github.com/zeon-studio/astroplate).
+This template is derived from zeon-studio's [astroplate](https://github.com/zeon-studio/astroplate), with structure borrowed from jordienr's [astro-design-system](https://github.com/jordienr/astro-design-system) and TheOtterlord's [manual](https://github.com/TheOtterlord/manual).

src/config/config.json

@@ -19,7 +19,8 @@
     "default_theme": "system",
     "pagination": 4,
     "summary_length": 200,
-    "blog_folder": "blog"
+    "blog_folder": "blog",
+    "docs_folder": "docs"
   },
 
   "metadata": {

src/config/config.ts

@@ -0,0 +1,11 @@
+export const SIDEBAR = [
+  { text: "Get Started", header: true },
+  { text: "Installation", link: "/docs/get-started/installation" },
+  { text: "Introduction", link: "/docs/get-started/introduction" },
+
+  { text: "Guides", header: true },
+  { text: "Migrate from Z", link: "docs/guides/intrmigrate-from-z" },
+
+  { text: "Tutorials", header: true },
+  { text: "Build X", link: "docs/tutorials/build-x" },
+];

src/config/docs.json

@@ -0,0 +1,12 @@
+{
+  "Get Started": [
+    "/docs/get-started/introduction/",
+    "/docs/get-started/installation/"
+  ],
+  "Tutorials": [
+    "/docs/tutorials/build-x/"
+  ],
+  "Guides": [
+    "/docs/guides/migrate-from-z/"
+  ]
+}

src/config/menu.json

@@ -8,6 +8,10 @@
       "name": "About",
       "url": "/about"
     },
+    {
+      "name": "Docs",
+      "url": "/docs"
+    },
     {
       "name": "Pages",
       "url": "",

src/content/config.ts

@@ -1,6 +1,25 @@
 import { defineCollection, z } from "astro:content";
 
-// Post collection schema
+// Author collection schema
+const authorsCollection = defineCollection({
+  schema: z.object({
+    title: z.string(),
+    meta_title: z.string().optional(),
+    email: z.string().optional(),
+    image: z.string().optional(),
+    description: z.string().optional(),
+    social: z.array(
+        z.object({
+            name: z.string().optional(),
+            icon: z.string().optional(),
+            link: z.string().optional(),
+          }).optional(),
+      ).optional(),
+    draft: z.boolean().optional(),
+  }),
+});
+
+// Blog collection schema
 const blogCollection = defineCollection({
   schema: z.object({
     title: z.string(),
@@ -15,21 +34,11 @@ const blogCollection = defineCollection({
   }),
 });
 
-// Author collection schema
-const authorsCollection = defineCollection({
+// Docs collection schema
+const docsCollection = defineCollection({
   schema: z.object({
     title: z.string(),
-    meta_title: z.string().optional(),
-    email: z.string().optional(),
-    image: z.string().optional(),
     description: z.string().optional(),
-    social: z.array(
-        z.object({
-            name: z.string().optional(),
-            icon: z.string().optional(),
-            link: z.string().optional(),
-          }).optional(),
-      ).optional(),
     draft: z.boolean().optional(),
   }),
 });
@@ -47,7 +56,8 @@ const pagesCollection = defineCollection({
 
 // Export collections
 export const collections = {
-  blog: blogCollection,
   authors: authorsCollection,
+  blog: blogCollection,
+  docs: docsCollection,
   pages: pagesCollection,
 };

src/content/docs/get-started/installation.md

@@ -0,0 +1,7 @@
+---
+title: Installation
+---
+
+## A header
+
+hello there