Add Makefile options NODE and VOID_GUIDES

Author: deimonn

Makefile

@@ -1,6 +1,6 @@
 # *── Makefile ── Makefile for deimonn.dev ──*
 # │
-# │ Copyright (c) 2025 Deimonn
+# │ Copyright (c) 2025-2026 Deimonn
 # │
 # │ This file is licensed under the MIT License.
 # │
@@ -15,6 +15,20 @@
 # Create build directories.
 $(shell mkdir -p dist/assets obj)
 
+# *─────────*
+# │ Options
+# *
+
+# Node command line to use to run scripts.
+NODE ?= node
+
+# Path to the `void-guides` submodule.
+VOID_GUIDES ?= src/submodules/void-guides
+
+# *─────────*
+# │ Targets
+# *
+
 # List of all targets.
 targets =
 
@@ -67,30 +81,30 @@ targets += dist/index.html
 
 # Documentation for 'void-guides'.
 void_guides_sources = \
-	src/submodules/void-guides/index.md \
-	$(wildcard src/submodules/void-guides/*/*.md)
+	$(VOID_GUIDES)/index.md \
+	$(wildcard $(VOID_GUIDES)/*/*.md)
 void_guides_outputs = \
-	$(patsubst src/submodules/void-guides/%.md,dist/void-guides/%.html,$(void_guides_sources))
+	$(patsubst $(VOID_GUIDES)/%.md,dist/void-guides/%.html,$(void_guides_sources))
 
 dist/void-guides/search-db.json obj/void-guides/nav-db.json: \
     compile-db.js $(void_guides_sources)
 	mkdir -p dist/void-guides obj/void-guides
-	node compile-db.js \
-		void-guides void-guides/ \
+	$(NODE) compile-db.js \
+		'$(VOID_GUIDES)' void-guides void-guides/ \
 		$(sort $(void_guides_sources))
 
 dist/void-guides/%.html: \
     src/templates/docs.html src/main.html \
-    src/submodules/void-guides/%.md src/submodules/void-guides/categories.json \
+    $(VOID_GUIDES)/%.md $(VOID_GUIDES)/categories.json \
     compile-markdown.js obj/oro-theme.json obj/void-guides/nav-db.json
 
 	# Create directories.
 	mkdir -p "$$(dirname $(subst dist/void-guides/,obj/void-guides/,$@))"
 	mkdir -p "$$(dirname $@)"
 
 	# Compile markdown.
-	node compile-markdown.js \
-		void-guides void-guides/ \
+	$(NODE) compile-markdown.js \
+		'$(VOID_GUIDES)' void-guides void-guides/ \
 		$(patsubst dist/void-guides/%.html,%,$@)
 
 	# Generate page from template.

compile-db.js

@@ -1,6 +1,6 @@
 /*── compile-db.js ── Compilation of database ──*
  │
- │ Copyright (c) 2025 Deimonn
+ │ Copyright (c) 2025-2026 Deimonn
  │
  │ This file is licensed under the MIT License.
  │
@@ -19,19 +19,23 @@ function readFile(path) {
     return fs.readFileSync(path, { encoding: "utf-8" });
 }
 
+// Fetch arguments.
+const args = process.argv.slice(2);
+
+const submodule = args[0];
+const repo = args[1];
+const prefix = args[2].substring(repo.length + 1);
+
+const inputs = args.slice(3);
+
 // Variables and constants.
 let search = [];
 let nav = [];
 
-const repo = process.argv[2];
-const prefix = process.argv[3];
-
 const searchOutput = `dist/${repo}/search-db.json`;
 const navOutput = `obj/${repo}/nav-db.json`;
 
 // Parse inputs.
-const inputs = process.argv.slice(4);
-
 for (const input of inputs) {
     // Initialize entry and push it to search database.
     const entry = {
@@ -41,7 +45,10 @@ for (const input of inputs) {
     search.push(entry);
 
     // Generate link.
-    const href = input.substring(15 + prefix.length, input.length - 3);
+    const hrefStart = submodule.length + prefix.length + 1;
+    const hrefEnd = input.length - 3;
+
+    const href = input.substring(hrefStart, hrefEnd);
     entry.href = `/${repo}/${href}`;
 
     // Read file contents.

compile-markdown.js

@@ -1,6 +1,6 @@
 /*── compile-markdown.js ── Compilation of markdown docs ──*
  │
- │ Copyright (c) 2025 Deimonn
+ │ Copyright (c) 2025-2026 Deimonn
  │
  │ This file is licensed under the MIT License.
  │
@@ -25,11 +25,12 @@ function readFile(path) {
 // Fetch arguments.
 const args = process.argv.slice(2);
 
-const repo = args[0];
-const prefix = args[1].substring(repo.length + 1);
-const target = args[2];
+const submodule = args[0];
+const repo = args[1];
+const prefix = args[2].substring(repo.length + 1);
+const target = args[3];
 
-const input = `src/submodules/${repo}/${prefix}${target}.md`;
+const input = `${submodule}/${prefix}${target}.md`;
 const mainOutput = `obj/${repo}/${target}.html`;
 const navOutput = `obj/${repo}/${target}.nav.html`;
 const tocOutput = `obj/${repo}/${target}.toc.html`;
@@ -82,7 +83,7 @@ let mainHtml = await marked.parse(readFile(input), {
                 token.href = token.href.replace(/(\.md$)|(\.md(?=#))/, "");
 
                 // Validate existence.
-                let file = `src/submodules/${repo}/${prefix}`;
+                let file = `${submodule}/${prefix}`;
 
                 file += path.dirname(target) + "/";
                 file += token.href.replace(/#.*$/, "") + ".md";
@@ -196,17 +197,17 @@ if (headings.length == 0) {
 const categories = {};
 let dictionary = {};
 
-if (fs.existsSync(`src/submodules/${repo}/${prefix}categories.json`)) {
+if (fs.existsSync(`${submodule}/${prefix}categories.json`)) {
     dictionary = JSON.parse(
-        readFile(`src/submodules/${repo}/${prefix}categories.json`)
+        readFile(`${submodule}/${prefix}categories.json`)
     );
 }
 
 for (const entry of nav) {
     const path = entry.path;
 
     // Remove common prefix.
-    const file = path.substring(16 + repo.length + prefix.length);
+    const file = path.substring(submodule.length + prefix.length + 1);
     if (!file.includes("/")) {
         continue;
     }