Allow configurable vitepress directory

Author: josbeir

.github/workflows/docs-validation.yml

@@ -8,6 +8,11 @@ on:
         required: false
         type: string
         default: 'docs'
+      vitepress-path:
+        description: 'Path to the .vitepress directory (e.g. ".vitepress" or "docs/.vitepress")'
+        required: false
+        type: string
+        default: '.vitepress'
       enable-toc-check:
         description: 'Enable TOC link validation (requires .vitepress/toc_*.json)'
         required: false
@@ -69,7 +74,7 @@ jobs:
         uses: actions/checkout@v6
 
       - name: Validate config.js syntax
-        run: node --check .vitepress/config.js
+        run: node --check "${{ inputs.vitepress-path }}/config.js"
 
   json-lint:
     name: Validate JSON Files
@@ -82,9 +87,9 @@ jobs:
       - name: Validate JSON syntax
         run: |
           shopt -s nullglob
-          files=(.vitepress/toc_*.json)
+          files=("${{ inputs.vitepress-path }}"/toc_*.json)
           if [ ${#files[@]} -eq 0 ]; then
-            echo "No .vitepress/toc_*.json files found"
+            echo "No ${{ inputs.vitepress-path }}/toc_*.json files found"
             exit 1
           fi
           for file in "${files[@]}"; do
@@ -113,7 +118,7 @@ jobs:
             docs-validation/check-toc-links.cjs
 
       - name: Check TOC links exist
-        run: node .docs-tools/docs-validation/check-toc-links.cjs
+        run: node .docs-tools/docs-validation/check-toc-links.cjs --vitepress-path "${{ inputs.vitepress-path }}" --docs-path "${{ inputs.docs-path }}"
 
   markdown-lint:
     name: Lint Markdown

docs-validation/check-toc-links.cjs

@@ -59,7 +59,19 @@ function getLangFromTocFile(tocFile) {
  * Main validation function
  */
 function validateTocFiles() {
-  const tocFiles = fs.readdirSync(".vitepress").filter((f) => f.match(/^toc_.*\.json$/)).map((f) => `.vitepress/${f}`);
+  const args = process.argv.slice(2);
+  let vitepressPath = ".vitepress";
+  let docsBasePath = "docs";
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--vitepress-path" && i + 1 < args.length) {
+      vitepressPath = args[++i];
+    } else if (args[i] === "--docs-path" && i + 1 < args.length) {
+      docsBasePath = args[++i];
+    }
+  }
+
+  const tocFiles = fs.readdirSync(vitepressPath).filter((f) => f.match(/^toc_.*\.json$/)).map((f) => path.join(vitepressPath, f));
 
   if (tocFiles.length === 0) {
     console.error("No toc_*.json files found");
@@ -75,7 +87,7 @@ function validateTocFiles() {
       continue;
     }
 
-    const docsDir = path.join("docs", lang);
+    const docsDir = path.join(docsBasePath, lang);
     if (!fs.existsSync(docsDir)) {
       console.error(`Docs directory not found: ${docsDir}`);
       hasErrors = true;