docs: Update JSDoc config for Read the Docs paths

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,54 +11,48 @@
     "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": [
-        "./dist/clean-jsdoc-theme-css.css",
-        "./dist/crowdin-clean-jsdoc-css.css"
-      ],
-      "include_js": ["./dist/crowdin.js"],
-      "menu": [
-        {
-          "title": "Jekyll Sample",
-          "link": "jekyll",
-          "target": "_blank",
-          "class": "",
-          "id": "jekyll-sample"
-        },
-        {
-          "title": "Doxygen Sample",
-          "link": "doxygen/html",
-          "target": "_blank",
-          "class": "",
-          "id": "doxygen-sample"
-        },
-        {
-          "title": "Sphinx Sample",
-          "link": "sphinx/html",
-          "target": "_blank",
-          "class": "",
-          "id": "sphinx-sample"
-        },
-        {
-          "title": "Rustdoc Sample",
-          "link": "rustdoc/doc/shared_web_rustdoc_example",
-          "target": "_blank",
-          "class": "",
-          "id": "rustdoc-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": ["./dist/crowdin-clean-jsdoc-css.css"],
+    "customJsFile": ["./dist/crowdin.js"],
+    "favicon": "./docs/static/favicon.ico",
+    "menu": [
+      {
+        "title": "Jekyll Sample",
+        "link": "jekyll",
+        "target": "_blank",
+        "class": "",
+        "id": "jekyll-sample"
+      },
+      {
+        "title": "Doxygen Sample",
+        "link": "doxygen/html",
+        "target": "_blank",
+        "class": "",
+        "id": "doxygen-sample"
+      },
+      {
+        "title": "Sphinx Sample",
+        "link": "sphinx/html",
+        "target": "_blank",
+        "class": "",
+        "id": "sphinx-sample"
+      },
+      {
+        "title": "Rustdoc Sample",
+        "link": "rustdoc/doc/shared_web_rustdoc_example",
+        "target": "_blank",
+        "class": "",
+        "id": "rustdoc-sample"
+      },
+      {
+        "title": "❤ Donate",
+        "link": "https://app.lizardbyte.dev",
+        "target": "_blank",
+        "class": "",
+        "id": "donate"
+      }
+    ]
   },
   "markdown": {
     "hardwrap": false,

package.json

@@ -68,7 +68,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",