Merge pull request #170 from kevanstannard/syntax-lookup-dynamic-include

Syntax lookup dynamic include

Author: ryyppy

misc_docs/syntax/controlflow_ifelse.mdx

@@ -1,5 +1,9 @@
 ---
-test: "foo"
+id: "if-else"
+keywords: ["if", "else"]
+name: "if / else"
+summary: "This is the `if / else` control flow."
+category: "controlflow"
 ---
 
 Use `if / else` expressions to express a value trough a `true` / `false` condition.

package.json

@@ -43,7 +43,7 @@
     "test": "node scripts/test-examples.js && node scripts/test-hrefs.js",
     "check-dead-code": "reanalyze -dce",
     "check-for-exceptions": "reanalyze -exception",
-    "update-index": "node scripts/extract-indices.js && node scripts/extract-tocs.js && node -r esm scripts/generate_feed.js > public/blog/feed.xml",
+    "update-index": "node scripts/extract-indices.js && node scripts/extract-tocs.js && node scripts/extract-syntax.js && node -r esm scripts/generate_feed.js > public/blog/feed.xml",
     "now-build": "yarn run build",
     "export": "next export",
     "start": "next start -p $PORT",

scripts/extract-syntax.js

@@ -0,0 +1,37 @@
+const matter = require("gray-matter");
+const glob = require("glob");
+const path = require("path");
+const fs = require("fs");
+
+const processFile = filepath => {
+  const raw = fs.readFileSync(filepath, "utf8");
+  const { data } = matter(raw);
+
+  const syntaxPath = path.resolve("./misc_docs/syntax");
+  const relFilePath = path.relative(syntaxPath, filepath);
+  const parsedPath = path.parse(relFilePath);
+
+  if (data.id && data.keywords && data.name && data.summary && data.category) {
+    return {
+      file: parsedPath.name,
+      id: data.id,
+      keywords: data.keywords,
+      name: data.name,
+      summary: data.summary,
+      category: data.category
+    }
+  }
+
+  console.error("Metadata missing in " + parsedPath.name + ".mdx")
+  return null;
+};
+
+const extractSyntax = async version => {
+  const SYNTAX_MD_DIR = path.join(__dirname, "../misc_docs/syntax");
+  const SYNTAX_INDEX_FILE = path.join(__dirname, "../index_data/syntax_index.json");
+  const syntaxFiles = glob.sync(`${SYNTAX_MD_DIR}/*.md?(x)`);
+  const syntaxIndex = syntaxFiles.map(processFile).filter(Boolean).sort((a, b) => a.name.localeCompare(b.name))
+  fs.writeFileSync(SYNTAX_INDEX_FILE, JSON.stringify(syntaxIndex), "utf8");
+};
+
+extractSyntax()