Sidebar rework

Author: FileEX

web/astro.config.mjs

@@ -73,7 +73,7 @@ export default defineConfig({
           label: "Welcome",
           items: [
             {
-              label: "Introduction",
+              label: "Main page",
               link: "/",
             },
             {
@@ -83,27 +83,49 @@ export default defineConfig({
           ],
         },
         {
+          label: "Guides",
+          items: [
+            {label: "Scripting introduction", link: "/guides/Scripting-introduction"},
+            {label: "Introduction to scripting GUI", link: "/guides/GUI-introduction"},
+            {label: "Script security", link: "/guides/Script-security"},
+            {label: "Introduction to CEF", link: "/guides/CEF-introduction"},
+          ]
+        },
+        {
+          /* Autogenerate doesn't allow the items to be sorted alphabetically here
+            For some reason, the following setting doesn't work at all (https://starlight.astro.build/guides/sidebar/#customizing-autogenerated-links-in-frontmatter):
+            sidebar:
+              order: X
+          */
+
           label: "Articles",
-          autogenerate: { directory: "articles" },
+          items: [
+            {label: "Cross-compiling MTASA on Linux using msvc-wine", slug: "articles/wine-build"},
+            {label: "Serial", slug: "articles/serial"},
+          ]
         },
         {
           label: "Reference",
           items: [
             {
-              label: "Resources",
+              label: "Resources & Mechanics",
               items: [
-                { label: "Element data", link: "/reference/Element_data"},
-                { label: "Lua API", link: "/reference/Lua_API" },
-                { label: "ID Lists", link: "/reference/ID_Lists" },
-                { label: "Meta.xml", link: "/reference/Meta.xml" },
-                {label: 'Predefined variables', link: '/reference/Predefined_variables'},
+                {label: "Element data", link: "/reference/Element_data"},
+                {label: "Game processing order", link: "/reference/Game_Processing_Order"},
+                {label: "ID Lists", link: "/reference/ID_Lists" },
+                {label: "Lua API", link: "/reference/Lua_API" },
+                {label: "Meta.xml", link: "/reference/Meta.xml" },
+                {label: "Predefined variables", link: '/reference/Predefined_variables'},
                 {label: "Resource Web Access", link: "/reference/Resource_Web_Access"},
-                {label: "CEF Tutorial", link: "/reference/CEF-tutorial"},
-                {label: "Game processing order", link: '/reference/Game_Processing_Order'},
-                {label: "Texture pixels", link: '/reference/Pixels'},
+                {label: "Shaders", link: "/reference/shaders"},
+                {label: "Texture pixels", link: "/reference/Pixels"},
+              ],
+            },
+            {
+              label: "API Structure",
+              items: [
                 {
                   label: "Functions",
-                  collapsed: true,
                   badge: { text: "Help Wanted", variant: "tip" },
                   items: [
                     {
@@ -126,7 +148,6 @@ export default defineConfig({
                 },
                 {
                   label: "Events",
-                  collapsed: true,
                   items: [
                     { label: "Event System", link: "/reference/Event_System" },
                     {
@@ -160,8 +181,8 @@ export default defineConfig({
                     { label: "About OOP", link: "/reference/OOP" },
                     { label: "OOP Classes", link: "/reference/OOP_Classes" },
                   ],
-                },
-              ],
+                }
+              ]
             },
             {
               label: "Configuration",

web/src/content/docs/articles/serial.mdx

@@ -1,6 +1,3 @@
----
-title: Serial
----
 import NoteBox from '@src/components/NoteBox.astro';
 
 <div id="_top"/>

web/src/content/docs/articles/wine-build.mdx

@@ -1,6 +1,3 @@
----
-title: Cross-compiling MTASA on Linux using msvc-wine
----
 import NoteBox from '@src/components/NoteBox.astro';
 
 <div id="_top"/>

web/src/pages/reference/CEF-tutorial.mdx web/src/pages/guides/CEF-introduction.mdxweb/src/pages/reference/CEF-tutorial.mdx renamed to web/src/pages/guides/CEF-introduction.mdx

@@ -7,7 +7,7 @@ import NoteBox from '@src/components/NoteBox.astro';
 
 <AutoStarlightPage frontmatter={{
     template: 'doc',
-    title: 'CEF Tutorial',
+    title: 'CEF Introduction',
     tableOfContents: true
 }}>
 

…ntent/docs/articles/GUI-Introduction.mdx web/src/pages/guides/GUI-introduction.mdxweb/src/content/docs/articles/GUI-Introduction.mdx renamed to web/src/pages/guides/GUI-introduction.mdx web/src/content/docs/articles/GUI-Introduction.mdx renamed to web/src/pages/guides/GUI-introduction.mdx

@@ -3,10 +3,4 @@ title: Scripting Introduction
 description: A tutorial on how to use the MTA scripting capabilities
 ---
 
-## Test - this shows in TOC
-
-### This also shows
-
-#### This doesn't
-
-Lmao
+TODO