local.js: Move man paths out of local config file

Author: slusarz

.vitepress/local.js.dist

@@ -13,14 +13,6 @@ export const data_paths = {
 	// doveadm: '../data/doveadm.js',
 }
 
-// A listing of paths containing man files.
-// Paths are relative to project base.
-//
-// Supports fast-glob: https://github.com/mrmlnc/fast-glob#pattern-syntax
-//
-// Default: [ 'docs/core/man/*.[[:digit:]].md' ]
-export const man_paths = []
-
 // A listing of paths containing plugin files.
 // Paths are relative to project base.
 //

README.md

@@ -163,6 +163,18 @@ should need to know basically no JavaScript to be able to edit the files.
 Various paths used for VitePress static generation can be overridden using
 the `dovecot` object in the `themeConfig` VitePress configuration setting.
 
+#### man_includes
+
+A list of additional paths (other than the `include/` directory of the man
+folder) where include files can live.
+
+#### man_paths
+
+A listing of paths containing man files.
+Paths are relative to project base.
+
+Supports fast-glob: https://github.com/mrmlnc/fast-glob#pattern-syntax
+
 #### watch_paths
 
 An array of file patterns to watch to refresh data loaders in dev mode.

lib/markdown.js

@@ -17,12 +17,6 @@ export async function initDovecotMd(base) {
 			doveadm: (await loadData('doveadm')).doveadm,
 			events: (await loadData('events')).events,
 			linkoverrides: (await loadData('links_overrides')).links_overrides,
-			man: (await manFiles()).flatMap((x) => {
-				return fg.sync(x).map((y) => {
-					const str = path.basename(y)
-					return str.substring(0, str.indexOf('.'))
-				})
-			}),
 			plugins: (await pluginFiles()).flatMap((x) =>
 				fg.sync(x).map((y) => path.basename(y, '.md'))
 			),
@@ -219,6 +213,8 @@ function dovecot_markdown(md, opts) {
 			hash = parts[2] ? parts[2] : false;
 			env.args = parts[3] ? parts[3] : 1;
 
+			initManFiles()
+
 			if (!opts.man.includes(env.inner)) {
 				handle_error('man link missing: ' + env.inner)
 				return '<a><code>'
@@ -426,6 +422,17 @@ function dovecot_markdown(md, opts) {
 		opts.dovecotlinks = { ...links, ...opts.linkoverrides }
 	}
 
+	function initManFiles() {
+		if (!opts.man) {
+			opts.man = manFiles().flatMap((x) => {
+				return fg.sync(x).map((y) => {
+					const str = path.basename(y)
+					return str.substring(0, str.indexOf('.'))
+				})
+			})
+		}
+	}
+
 	md.inline.ruler.after('emphasis', 'dovecot_brackets', process_brackets)
 	md.renderer.rules.dovecot_open = dovecot_open
 	md.renderer.rules.dovecot_body = dovecot_body

lib/utility.js

@@ -75,18 +75,14 @@ export function addWatchPaths(obj) {
 	}
 }
 
-export async function manFiles() {
-	/* Check for config override file. */
-	const lconf = await loadLocalConf()
-
-	return lconf?.man_paths ??
-		[ 'docs/core/man/*.[[:digit:]].md' ]
+export function manFiles() {
+	return globalThis.VITEPRESS_CONFIG.userConfig.themeConfig.dovecot?.man_paths
+		?? [ 'docs/core/man/*.[[:digit:]].md' ]
 }
 
-export async function manIncludes() {
-	const lconf = await loadLocalConf()
-	return lconf?.man_includes ??
-		[ 'docs/core/man/include/*.inc' ]
+export function manIncludes() {
+	return globalThis.VITEPRESS_CONFIG.userConfig.themeConfig.dovecot?.man_includes
+		?? [ 'docs/core/man/include/*.inc' ]
 }
 
 export async function pluginFiles() {

util/generate_man.js

@@ -126,8 +126,8 @@ const main = async (component, outPath) => {
 	}
 
 	/* Generate list of man files. */
-	const files = (await manFiles()).flatMap((x) => fg.sync(x))
-	const includes = (await manIncludes()).flatMap((x) => fg.sync(x))
+	const files = manFiles().flatMap((x) => fg.sync(x))
+	const includes = manIncludes().flatMap((x) => fg.sync(x))
 
 	/* Get hash of last git commit. */
 	const gitHash = gitCommitInfo().shortHash