Refactor version-replacer to substitution replacer and expand with more options

Author: josbeir

.vitepress/config.js

@@ -1,15 +1,18 @@
 import { defineConfig } from 'vitepress'
-import { versionReplacer } from './plugins/version-replacer.js'
+import { substitutionsReplacer } from './plugins/substitutions-replacer.js'
 import { deepMerge, loadConfigOverrides, applyBaseToHeadTags } from './utils.js'
 
 const defaultConfig = {
   srcDir: 'docs',
   title: 'CakePHP',
   description: 'CakePHP Documentation - The rapid development PHP framework',
   ignoreDeadLinks: true,
-  phpVersions: {
-    phpversion: '8.4',
-    minphpversion: '8.1'
+  substitutions: {
+    '|phpversion|': { value: '8.4', format: 'bold' },
+    '|minphpversion|': { value: '8.1', format: 'italic' },
+    // Add more substitutions here as needed
+    // '|cakeversion|': { value: '5.1', format: 'bold' },
+    // '|projectname|': 'CakePHP',  // Simple string without formatting
   },
   head: [
     ['link', { rel: 'icon', type: 'image/png', href: '/favicon/favicon-96x96.png', sizes: '96x96' }],
@@ -59,7 +62,7 @@ const mergedConfig = deepMerge(defaultConfig, overrides)
 
 // Configure markdown plugins after mergedConfig is available
 mergedConfig.markdown.config = (md) => {
-  md.use(versionReplacer, mergedConfig.phpVersions || {})
+  md.use(substitutionsReplacer, { substitutions: mergedConfig.substitutions || {} })
 }
 
 // Apply base path to head tags if base is specified

.vitepress/plugins/version-replacer.js

@@ -77,6 +77,30 @@ export default {
 
 All markdown documentation files should be placed in the `docs/` directory.
 
+### Text Substitutions
+
+You can use placeholders in your markdown files that will be automatically replaced with configured values. This is useful for version numbers or other values that need to be updated across multiple files.
+
+**Configuration** (`config.js`):
+
+```javascript
+export default {
+  substitutions: {
+    '|phpversion|': { value: '8.4', format: 'bold' },
+    '|minphpversion|': { value: '8.1', format: 'italic' },
+    '|myversion|': '1.0.0'  // Simple string without formatting
+  }
+}
+```
+
+**Usage in Markdown**:
+
+```markdown
+This plugin requires PHP |phpversion| or higher (minimum |minphpversion|).
+```
+
+**Result**: This plugin requires PHP **8.4** or higher (minimum *8.1*).
+
 ## Project Structure
 
 ```