Merge branch '5.next' into 5.next-console-ux

Author: markstory

.github/.markdownlint-cli2.jsonc

@@ -75,7 +75,7 @@
     "no-emphasis-as-heading": false
   },
   "customRules": [
-    "./markdownlint-rules/no-space-after-fence.js"
+    "./markdownlint-rules/no-space-after-fence.cjs"
   ],
   "ignores": [
     "node_modules/**"

bin/check-links.js .github/check-links.cjsbin/check-links.js renamed to .github/check-links.cjs

@@ -51,15 +51,15 @@ function checkLink(link, docsDir, lang) {
  * e.g., "toc_en.json" -> "en"
  */
 function getLangFromTocFile(tocFile) {
-  const match = tocFile.match(/^toc_(\w+)\.json$/);
+  const match = tocFile.match(/toc_(\w+)\.json$/);
   return match ? match[1] : null;
 }
 
 /**
  * Main validation function
  */
 function validateTocFiles() {
-  const tocFiles = fs.readdirSync(".").filter((f) => f.match(/^toc_.*\.json$/));
+  const tocFiles = fs.readdirSync(".vitepress").filter((f) => f.match(/^toc_.*\.json$/)).map((f) => `.vitepress/${f}`);
 
   if (tocFiles.length === 0) {
     console.error("No toc_*.json files found");

bin/check-toc-links.js .github/check-toc-links.cjsbin/check-toc-links.js renamed to .github/check-toc-links.cjs

@@ -28,7 +28,7 @@ jobs:
         uses: actions/checkout@v6
 
       - name: Validate config.js syntax
-        run: node --check config.js
+        run: node --check .vitepress/config.js
 
   json-lint:
     name: Validate JSON Files
@@ -40,7 +40,7 @@ jobs:
 
       - name: Validate JSON syntax
         run: |
-          for file in toc_*.json; do
+          for file in .vitepress/toc_*.json; do
             if ! jq empty "$file" 2>/dev/null; then
               echo "Invalid JSON: $file"
               exit 1
@@ -57,7 +57,7 @@ jobs:
         uses: actions/checkout@v6
 
       - name: Check TOC links exist
-        run: node bin/check-toc-links.js
+        run: node .github/check-toc-links.cjs
 
   markdown-lint:
     name: Lint Markdown
@@ -68,7 +68,7 @@ jobs:
         uses: actions/checkout@v6
 
       - name: Lint markdown files
-        uses: DavidAnson/markdownlint-cli2-action@v22
+        uses: DavidAnson/markdownlint-cli2-action@v23
         with:
           config: './.github/.markdownlint-cli2.jsonc'
           globs: 'docs/**/*.md'
@@ -121,4 +121,4 @@ jobs:
 
       - name: Check internal links
         if: steps.changed-files.outputs.files != ''
-        run: node bin/check-links.js --baseline .github/linkchecker-baseline.json ${{ steps.changed-files.outputs.files }}
+        run: node .github/check-links.cjs --baseline .github/linkchecker-baseline.json ${{ steps.changed-files.outputs.files }}

…rkdownlint-rules/no-space-after-fence.js …kdownlint-rules/no-space-after-fence.cjs.github/markdownlint-rules/no-space-after-fence.js renamed to .github/markdownlint-rules/no-space-after-fence.cjs .github/markdownlint-rules/no-space-after-fence.js renamed to .github/markdownlint-rules/no-space-after-fence.cjs

@@ -5,6 +5,10 @@
 .vitepress/.temp
 /node_modules/
 .temp/
+docs/public/favicon/
+docs/public/fonts/
+docs/public/icons/
+docs/public/logo.svg
 
 # IDE and editor specific files #
 #################################

.github/workflows/docs-validation.yml

@@ -1,3 +1,5 @@
+import baseConfig, { substitutionsReplacer } from '@cakephp/docs-skeleton/config'
+
 import { createRequire } from "module";
 const require = createRequire(import.meta.url);
 const toc_en = require("./toc_en.json");
@@ -17,8 +19,21 @@ const versions = {
   ],
 };
 
+const substitutions = {
+  '|phpversion|': { value: '8.5', format: 'bold' },
+  '|minphpversion|': { value: '8.2', format: 'italic' },
+  '|cakeversion|': '5.4.0',
+  '|cakefullversion|': 'CakePHP 5.next',
+};
+
 // This file contains overrides for .vitepress/config.js
 export default {
+  extends: baseConfig,
+  markdown: {
+    config(md) {
+      md.use(substitutionsReplacer, { substitutions });
+    }
+  },
   base: "/5.next/",
   rewrites: {
     "en/:slug*": ":slug*",
@@ -47,12 +62,6 @@ export default {
       linkText: 'Go to latest docs.'
     }
   },
-  substitutions: {
-    '|phpversion|': { value: '8.5', format: 'bold' },
-    '|minphpversion|': { value: '8.2', format: 'italic' },
-    '|cakeversion|': '5.4.0',
-    '|cakefullversion|': 'CakePHP 5.next',
-  },
   locales: {
     root: {
       label: "English",

.gitignore

@@ -0,0 +1 @@
+export { default } from '@cakephp/docs-skeleton'