docs: enhance VitePress configuration

Author: fankes

docs-source/src/.vitepress/config.ts

@@ -2,14 +2,15 @@ import {
     GitChangelog,
     GitChangelogMarkdownSection
 } from '@nolebase/vitepress-plugin-git-changelog/vite';
-import { defineConfig } from 'vitepress';
+import { defineConfig, type DefaultTheme, type UserConfigFn } from 'vitepress';
 import { alignI18nAnchors } from './configs/anchors';
 import { createHomepageAlternates, createRootLocaleRedirect } from './configs/i18n';
 import { configs, pageLinkRefs } from './configs/template';
-import { env, markdown } from './configs/utils';
+import { markdown } from './configs/utils';
 import locales from './locales';
 
-export default defineConfig({
+/** Creates the documentation site configuration for the active VitePress command. */
+const createConfig: UserConfigFn<DefaultTheme.Config> = ({ command }) => defineConfig({
     base: configs.website.base,
     title: configs.website.title,
     description: configs.website.locales.en.description,
@@ -72,7 +73,7 @@ export default defineConfig({
         config: (md) => {
             md.use(alignI18nAnchors);
             markdown.localizeContainerTitles(md);
-            markdown.injectLinks(md, env.dev ? pageLinkRefs.dev : pageLinkRefs.prod, configs.website.base);
+            markdown.injectLinks(md, command === 'serve' ? pageLinkRefs.dev : pageLinkRefs.prod, configs.website.base);
         }
     },
     themeConfig: {
@@ -112,4 +113,6 @@ export default defineConfig({
             copyright: 'Copyright © 2019 HighCapable'
         }
     }
-});
+});
+
+export default createConfig;

docs-source/src/.vitepress/configs/utils.ts

@@ -15,12 +15,6 @@ const containerTitles = {
     }
 };
 
-/** Exposes the active documentation build mode to configuration helpers. */
-export const env = {
-    // VitePress loads its site config before NODE_ENV is reliably set for the dev command.
-    dev: process.argv.includes('dev')
-};
-
 /** Provides Markdown renderer hooks shared by development and production builds. */
 export const markdown = {
     /** Localizes default custom-container titles while preserving titles declared in Markdown. */