Generate jsdoc with jsdoc-to-markdown

Author: clementbiron

.github/workflows/gh-pages.yml

@@ -46,9 +46,6 @@ jobs:
       - name: Build with Hugo
         run: npm run build
 
-      - name: Build JSDoc
-        run: npm run jsdoc
-
       - name: Print public files
         run: |
           cd public

.github/workflows/test.yml

@@ -30,5 +30,3 @@ jobs:
           extended: true # Prevent error building site: POSTCSS: failed to transform, see https://gohugo.io/troubleshooting/faq/#i-get-this-feature-is-not-available-in-your-current-hugo-version
       - name: Build with Hugo
         run: npm run build
-      - name: Build JSDoc
-        run: npm run jsdoc

package.json

@@ -13,14 +13,15 @@
   "license": "CC BY-SA 4.0",
   "author": "Open Terms Archive",
   "scripts": {
-    "build": "hugo --minify",
+    "build": "npm run jsdoc && hugo --minify",
     "test": "npm run lint:markdown && npm run lint:css && npm run lint:js && npm run test:links",
     "pretest:links": "npm run build",
     "test:links": "linkinator ./public --recurse --verbosity error",
     "lint:markdown": "markdownlint *.md content/**/*.md",
     "lint:css": "stylelint \"themes/opentermsarchive/assets/css/*.css\"",
     "lint:js": "eslint themes/opentermsarchive/assets/js/",
-    "start:dev": "hugo serve --watch --logLevel debug --disableFastRender --ignoreCache"
+    "start:dev": "npm run jsdoc && hugo serve --watch --logLevel debug --disableFastRender --ignoreCache",
+    "jsdoc": "jsdoc2md --files './node_modules/@opentermsarchive/engine/src/**/*.js' --template scripts/jsdoc/template/node.hbs -g grouped --name-format -d 4 > content/api/node.md"
   },
   "devDependencies": {
     "eslint": "^8.31.0",