Adapt GenType & Community docs to new layout architecture

- Create sidebar files
- Also adds missing frontmatters

Author: ryyppy

data/sidebar_community.json

@@ -0,0 +1,6 @@
+{
+  "Resources": [
+    "overview",
+    "code-of-conduct"
+  ]
+}

data/sidebar_gentype_latest.json

@@ -0,0 +1,10 @@
+{
+  "Overview": [
+    "introduction",
+    "getting-started",
+    "usage"
+  ],
+  "Advanced": [
+    "supported-types"
+  ]
+}

next.config.js

@@ -28,7 +28,16 @@ const config = {
       }
     }
     return config
-  }
+  },
+  async redirects() {
+    return [
+      {
+        source: '/community',
+        destination: '/community/overview',
+        permanent: true,
+      },
+    ]
+  },
 };
 
 module.exports = withMdx(withTM(withCSS(config)));

pages/community/code-of-conduct.mdx

@@ -1,3 +1,9 @@
+---
+title: "Code of Conduct"
+description: "Our working codex for the ReScript community"
+canonical: "/community/code-of-conduct"
+---
+
 # Code of Conduct
 
 ## Our Pledge

pages/community.mdx renamed to pages/community/overview.mdx

@@ -1,3 +1,9 @@
+---
+title: "Overview"
+description: "Community Resources Overview"
+canonical: "/community/overview"
+---
+
 # Community
 
 ## Core Team

pages/docs/gentype/latest/getting-started.mdx

@@ -1,3 +1,9 @@
+---
+title: "Getting Started"
+description: "How to get started with genType in your ReScript projects"
+canonical: "/docs/gentype/latest/getting-started"
+---
+
 # Getting Started
 
 `genType` is tightly integrated in the ReScript Compiler. It only requires minimal setup.

pages/docs/gentype/latest/introduction.mdx

@@ -1,3 +1,9 @@
+---
+title: "Introduction"
+description: "GenType - Interoperability between ReScript and TypeScript / Flow"
+canonical: "/docs/gentype/latest/introduction"
+---
+
 # GenType
 
 `genType` is a code generation tool that lets you export ReScript values and types to use in JavaScript, and import JavaScript values and types into ReScript.

pages/docs/gentype/latest/supported-types.mdx

@@ -1,3 +1,9 @@
+---
+title: "Supported Types"
+description: "Supported types and value convertion in GenType"
+canonical: "/docs/gentype/latest/supported-types"
+---
+
 # Supported Types
 
 <Intro>

scripts/extract-tocs.js

@@ -181,21 +181,39 @@ const createV800ManualToc = () => {
 
 const createGenTypeToc = () => {
   const MD_DIR = path.join(__dirname, "../pages/docs/gentype/latest");
-  const TARGET_FILE = path.join(__dirname, "../index_data/gentype_toc.json");
+  const SIDEBAR_JSON = path.join(__dirname, "../data/sidebar_gentype_latest.json");
+  const TARGET_FILE = path.join(__dirname, "../index_data/gentype_latest_toc.json");
 
-  const files = glob.sync(`${MD_DIR}/*.md?(x)`);
-  const result = files.map(processFile);
+  const sidebarJson = JSON.parse(fs.readFileSync(SIDEBAR_JSON));
+
+  const FILE_ORDER = Object.values(sidebarJson).reduce((acc, items) => {
+    return acc.concat(items)
+  },[]);
+
+  const files = glob.sync(`${MD_DIR}/*.?(js|md?(x))`);
+  const ordered = orderFiles(files, FILE_ORDER);
+
+  const result = ordered.map((filepath) => processFile(filepath, sidebarJson));
   const toc = createTOC(result);
 
   fs.writeFileSync(TARGET_FILE, JSON.stringify(toc), "utf8");
 };
 
 const createCommunityToc = () => {
   const MD_DIR = path.join(__dirname, "../pages/community");
+  const SIDEBAR_JSON = path.join(__dirname, "../data/sidebar_community.json");
   const TARGET_FILE = path.join(__dirname, "../index_data/community_toc.json");
 
-  const files = glob.sync(`${MD_DIR}/*.md?(x)`);
-  const result = files.map(processFile);
+  const sidebarJson = JSON.parse(fs.readFileSync(SIDEBAR_JSON));
+
+  const FILE_ORDER = Object.values(sidebarJson).reduce((acc, items) => {
+    return acc.concat(items)
+  },[]);
+
+  const files = glob.sync(`${MD_DIR}/*.?(js|md?(x))`);
+  const ordered = orderFiles(files, FILE_ORDER);
+
+  const result = ordered.map((filepath) => processFile(filepath, sidebarJson));
   const toc = createTOC(result);
 
   fs.writeFileSync(TARGET_FILE, JSON.stringify(toc), "utf8");