Fix JSDoc config for Read the Docs

Add a JS-based JSDoc config wrapper that reads `READTHEDOCS_CANONICAL_URL` and sets `opts.basePath` dynamically for hosted docs paths. Update `jsdoc.json` to use the current clean-jsdoc-theme option format (template dist path plus top-level custom JS/CSS, favicon, and menu settings), and point `generate-docs` to the new `jsdoc.config.js` entrypoint.

Author: ReenigneArcher

jsdoc.config.js

@@ -0,0 +1,8 @@
+const config = require("./jsdoc.json");
+
+const canonicalUrl = process.env.READTHEDOCS_CANONICAL_URL;
+if (canonicalUrl) {
+  config.opts.basePath = new URL(canonicalUrl).pathname;
+}
+
+module.exports = config;

jsdoc.json

@@ -11,30 +11,27 @@
     "destination": "./_readthedocs/html",
     "recurse": true,
     "verbose": true,
-    "template": "node_modules/clean-jsdoc-theme",
-    "theme_opts": {
-      "add_scripts": "window.initCrowdIn('LizardByte-docs', null);",
-      "default_theme": "fallback-dark",
-      "favicon": "favicon.ico",
-      "include_css": ["./node_modules/@lizardbyte/shared-web/dist/crowdin-clean-jsdoc-css.css"],
-      "include_js": ["./node_modules/@lizardbyte/shared-web/dist/crowdin.js"],
-      "menu": [
-        {
-          "title": "Gamepad Tester",
-          "link": "https://app.lizardbyte.dev/gamepad-tester",
-          "target": "_blank",
-          "class": "",
-          "id": "jekyll-sample"
-        },
-        {
-          "title": "❤ Donate",
-          "link": "https://app.lizardbyte.dev",
-          "target": "_blank",
-          "class": "",
-          "id": "donate"
-        }
-      ]
-    }
+    "template": "node_modules/clean-jsdoc-theme/dist",
+    "customJs": "window.initCrowdIn('LizardByte-docs', null);",
+    "customCssFile": ["./node_modules/@lizardbyte/shared-web/dist/crowdin-clean-jsdoc-css.css"],
+    "customJsFile": ["./node_modules/@lizardbyte/shared-web/dist/crowdin.js"],
+    "favicon": "./docs/static/favicon.ico",
+    "menu": [
+      {
+        "title": "Gamepad Tester",
+        "link": "https://app.lizardbyte.dev/gamepad-tester",
+        "target": "_blank",
+        "class": "",
+        "id": "jekyll-sample"
+      },
+      {
+        "title": "❤ Donate",
+        "link": "https://app.lizardbyte.dev",
+        "target": "_blank",
+        "class": "",
+        "id": "donate"
+      }
+    ]
   },
   "markdown": {
     "hardwrap": false,

package.json

@@ -52,7 +52,7 @@
   },
   "scripts": {
     "build": "cross-env NODE_ENV=production webpack",
-    "generate-docs": "jsdoc --configure jsdoc.json --verbose",
+    "generate-docs": "jsdoc --configure jsdoc.config.js --verbose",
     "start": "webpack serve",
     "test": "npm-run-all test:unit test:report test:lint",
     "test:unit": "jest --coverage",