@modern-js/main-doc 2.0.3-alpha.0 → 2.1.0

package/zh/configure/app/output/dist-path.md

@@ -4,9 +4,9 @@ sidebar_label: distPath
 ---
 
 :::info BUILDER
-该配置为 Modern.js Builder 配置，详细信息可参考 [output.distPath](https://modernjs.dev/builder/zh/api/config-output.html#output-distpath)。
+该配置为 Modern.js Builder 配置，详细信息可参考 [output.distPath](https://modernjs.dev/builder/api/config-output.html#output-distpath)。
 :::
 
-import Main from '@modern-js/builder-doc/zh/config/output/distPath.md'
+import Main from '@modern-js/builder-doc/docs/zh/config/output/distPath.md'
 
 <Main />

package/zh/configure/app/output/enable-asset-fallback.md

@@ -4,9 +4,9 @@ sidebar_label: enableAssetFallback
 ---
 
 :::info BUILDER
-该配置为 Modern.js Builder 配置，详细信息可参考 [output.enableAssetFallback](https://modernjs.dev/builder/zh/api/config-output.html#output-enableassetfallback)。
+该配置为 Modern.js Builder 配置，详细信息可参考 [output.enableAssetFallback](https://modernjs.dev/builder/api/config-output.html#output-enableassetfallback)。
 :::
 
-import Main from '@modern-js/builder-doc/zh/config/output/enableAssetFallback.md'
+import Main from '@modern-js/builder-doc/docs/zh/config/output/enableAssetFallback.md'
 
 <Main />

package/zh/configure/app/output/enable-asset-manifest.md

@@ -4,9 +4,9 @@ sidebar_label: enableAssetManifest
 ---
 
 :::info BUILDER
-该配置为 Modern.js Builder 配置，详细信息可参考 [output.enableAssetManifest](https://modernjs.dev/builder/zh/api/config-output.html#output-enableassetmanifest)。
+该配置为 Modern.js Builder 配置，详细信息可参考 [output.enableAssetManifest](https://modernjs.dev/builder/api/config-output.html#output-enableassetmanifest)。
 :::
 
-import Main from '@modern-js/builder-doc/zh/config/output/enableAssetManifest.md'
+import Main from '@modern-js/builder-doc/docs/zh/config/output/enableAssetManifest.md'
 
 <Main />

package/zh/configure/app/output/enable-css-module-tsdeclaration.md

@@ -4,9 +4,9 @@ sidebar_label: enableCssModuleTSDeclaration
 ---
 
 :::info BUILDER
-该配置为 Modern.js Builder 配置，详细信息可参考 [output.enableCssModuleTSDeclaration](https://modernjs.dev/builder/zh/api/config-output.html#output-enablecssmoduletsdeclaration)。
+该配置为 Modern.js Builder 配置，详细信息可参考 [output.enableCssModuleTSDeclaration](https://modernjs.dev/builder/api/config-output.html#output-enablecssmoduletsdeclaration)。
 :::
 
-import Main from '@modern-js/builder-doc/zh/config/output/enableCssModuleTSDeclaration.md'
+import Main from '@modern-js/builder-doc/docs/zh/config/output/enableCssModuleTSDeclaration.md'
 
 <Main />

package/zh/configure/app/output/enable-inline-scripts.md

@@ -4,9 +4,9 @@ sidebar_label: enableInlineScripts
 ---
 
 :::info BUILDER
-该配置为 Modern.js Builder 配置，详细信息可参考 [output.enableInlineScripts](https://modernjs.dev/builder/zh/api/config-output.html#output-enableinlinescripts)。
+该配置为 Modern.js Builder 配置，详细信息可参考 [output.enableInlineScripts](https://modernjs.dev/builder/api/config-output.html#output-enableinlinescripts)。
 :::
 
-import Main from '@modern-js/builder-doc/zh/config/output/enableInlineScripts.md'
+import Main from '@modern-js/builder-doc/docs/zh/config/output/enableInlineScripts.md'
 
 <Main />

package/zh/configure/app/output/enable-inline-styles.md

@@ -4,9 +4,9 @@ sidebar_label: enableInlineStyles
 ---
 
 :::info BUILDER
-该配置为 Modern.js Builder 配置，详细信息可参考 [output.enableInlineStyles](https://modernjs.dev/builder/zh/api/config-output.html#output-enableinlinestyles)。
+该配置为 Modern.js Builder 配置，详细信息可参考 [output.enableInlineStyles](https://modernjs.dev/builder/api/config-output.html#output-enableinlinestyles)。
 :::
 
-import Main from '@modern-js/builder-doc/zh/config/output/enableInlineStyles.md'
+import Main from '@modern-js/builder-doc/docs/zh/config/output/enableInlineStyles.md'
 
 <Main />

package/zh/configure/app/output/enable-latest-decorators.md

@@ -4,9 +4,9 @@ sidebar_label: enableLatestDecorators
 ---
 
 :::info BUILDER
-该配置为 Modern.js Builder 配置，详细信息可参考 [output.enableLatestDecorators](https://modernjs.dev/builder/zh/api/config-output.html#output-enablelatestdecorators)。
+该配置为 Modern.js Builder 配置，详细信息可参考 [output.enableLatestDecorators](https://modernjs.dev/builder/api/config-output.html#output-enablelatestdecorators)。
 :::
 
-import Main from '@modern-js/builder-doc/zh/config/output/enableLatestDecorators.md'
+import Main from '@modern-js/builder-doc/docs/zh/config/output/enableLatestDecorators.md'
 
 <Main />

package/zh/configure/app/output/externals.md

@@ -4,9 +4,9 @@ sidebar_label: externals
 ---
 
 :::info BUILDER
-该配置为 Modern.js Builder 配置，详细信息可参考 [output.externals](https://modernjs.dev/builder/zh/api/config-output.html#output-externals)。
+该配置为 Modern.js Builder 配置，详细信息可参考 [output.externals](https://modernjs.dev/builder/api/config-output.html#output-externals)。
 :::
 
-import Main from '@modern-js/builder-doc/zh/config/output/externals.md'
+import Main from '@modern-js/builder-doc/docs/zh/config/output/externals.md'
 
 <Main />

package/zh/configure/app/output/filename.md

@@ -4,9 +4,9 @@ sidebar_label: filename
 ---
 
 :::info BUILDER
-该配置为 Modern.js Builder 配置，详细信息可参考 [output.filename](https://modernjs.dev/builder/zh/api/config-output.html#output-filename)。
+该配置为 Modern.js Builder 配置，详细信息可参考 [output.filename](https://modernjs.dev/builder/api/config-output.html#output-filename)。
 :::
 
-import Main from '@modern-js/builder-doc/zh/config/output/filename.md'
+import Main from '@modern-js/builder-doc/docs/zh/config/output/filename.md'
 
 <Main />

package/zh/configure/app/output/legal-comments.md

@@ -4,9 +4,9 @@ sidebar_label: legalComments
 ---
 
 :::info BUILDER
-该配置为 Modern.js Builder 配置，详细信息可参考 [output.legalComments](https://modernjs.dev/builder/zh/api/config-output.html#output-legalcomments)。
+该配置为 Modern.js Builder 配置，详细信息可参考 [output.legalComments](https://modernjs.dev/builder/api/config-output.html#output-legalcomments)。
 :::
 
-import Main from '@modern-js/builder-doc/zh/config/output/legalComments.md'
+import Main from '@modern-js/builder-doc/docs/zh/config/output/legalComments.md'
 
 <Main />

package/zh/configure/app/output/override-browserslist.md

@@ -4,9 +4,9 @@ sidebar_label: overrideBrowserslist
 ---
 
 :::info BUILDER
-该配置为 Modern.js Builder 配置，详细信息可参考 [output.overrideBrowserslist](https://modernjs.dev/builder/zh/api/config-output.html#output-overridebrowserslist)。
+该配置为 Modern.js Builder 配置，详细信息可参考 [output.overrideBrowserslist](https://modernjs.dev/builder/api/config-output.html#output-overridebrowserslist)。
 :::
 
-import Main from '@modern-js/builder-doc/zh/config/output/overrideBrowserslist.md'
+import Main from '@modern-js/builder-doc/docs/zh/config/output/overrideBrowserslist.md'
 
 <Main />

package/zh/configure/app/output/polyfill.md

@@ -4,9 +4,9 @@ sidebar_label: polyfill
 ---
 
 :::info BUILDER
-该配置为 Modern.js Builder 配置，详细信息可参考 [output.polyfill](https://modernjs.dev/builder/zh/api/config-output.html#output-polyfill)。
+该配置为 Modern.js Builder 配置，详细信息可参考 [output.polyfill](https://modernjs.dev/builder/api/config-output.html#output-polyfill)。
 :::
 
-import Main from '@modern-js/builder-doc/zh/config/output/polyfill.md'
+import Main from '@modern-js/builder-doc/docs/zh/config/output/polyfill.md'
 
 <Main />

package/zh/configure/app/output/ssg.md

@@ -1,10 +1,11 @@
 ---
 sidebar_label: ssg
 ---
+
 # output.ssg
 
-* 类型： `boolean` | `object` | `function`
-* 默认值： `undefined`
+- 类型： `boolean` | `object` | `function`
+- 默认值： `undefined`
 
 开启**自控式路由**或**约定式路由** SSG 功能的配置。
 

package/zh/configure/app/output/svg-default-export.md

@@ -4,9 +4,9 @@ sidebar_label: svgDefaultExport
 ---
 
 :::info BUILDER
-该配置为 Modern.js Builder 配置，详细信息可参考 [output.svgDefaultExport](https://modernjs.dev/builder/zh/api/config-output.html#output-svgdefaultexport)。
+该配置为 Modern.js Builder 配置，详细信息可参考 [output.svgDefaultExport](https://modernjs.dev/builder/api/config-output.html#output-svgdefaultexport)。
 :::
 
-import Main from '@modern-js/builder-doc/zh/config/output/svgDefaultExport.md'
+import Main from '@modern-js/builder-doc/docs/zh/config/output/svgDefaultExport.md'
 
 <Main />

package/zh/configure/app/performance/build-cache.md

@@ -4,9 +4,9 @@ sidebar_label: buildCache
 ---
 
 :::info BUILDER
-该配置为 Modern.js Builder 配置，详细信息可参考 [performance.buildCache](https://modernjs.dev/builder/zh/api/config-performance.html#performance-buildcache)。
+该配置为 Modern.js Builder 配置，详细信息可参考 [performance.buildCache](https://modernjs.dev/builder/api/config-performance.html#performance-buildcache)。
 :::
 
-import Main from '@modern-js/builder-doc/zh/config/performance/buildCache.md'
+import Main from '@modern-js/builder-doc/docs/zh/config/performance/buildCache.md'
 
 <Main />

package/zh/configure/app/performance/bundle-analyze.md

@@ -4,9 +4,9 @@ sidebar_label: bundleAnalyze
 ---
 
 :::info BUILDER
-该配置为 Modern.js Builder 配置，详细信息可参考 [performance.bundleAnalyze](https://modernjs.dev/builder/zh/api/config-performance.html#performance-bundleanalyze)。
+该配置为 Modern.js Builder 配置，详细信息可参考 [performance.bundleAnalyze](https://modernjs.dev/builder/api/config-performance.html#performance-bundleanalyze)。
 :::
 
-import Main from '@modern-js/builder-doc/zh/config/performance/bundleAnalyze.md'
+import Main from '@modern-js/builder-doc/docs/zh/config/performance/bundleAnalyze.md'
 
 <Main />

package/zh/configure/app/performance/chunk-split.md

@@ -4,9 +4,9 @@ sidebar_label: chunkSplit
 ---
 
 :::info BUILDER
-该配置为 Modern.js Builder 配置，详细信息可参考 [performance.chunkSplit](https://modernjs.dev/builder/zh/api/config-performance.html#performance-chunksplit)。
+该配置为 Modern.js Builder 配置，详细信息可参考 [performance.chunkSplit](https://modernjs.dev/builder/api/config-performance.html#performance-chunksplit)。
 :::
 
-import Main from '@modern-js/builder-doc/zh/config/performance/chunkSplit.md'
+import Main from '@modern-js/builder-doc/docs/zh/config/performance/chunkSplit.md'
 
 <Main />

package/zh/configure/app/performance/print-file-size.md

@@ -4,9 +4,9 @@ sidebar_label: printFileSize
 ---
 
 :::info BUILDER
-该配置为 Modern.js Builder 配置，详细信息可参考 [performance.printFileSize](https://modernjs.dev/builder/zh/api/config-performance.html#performance-printfilesize)。
+该配置为 Modern.js Builder 配置，详细信息可参考 [performance.printFileSize](https://modernjs.dev/builder/api/config-performance.html#performance-printfilesize)。
 :::
 
-import Main from '@modern-js/builder-doc/zh/config/performance/printFileSize.md'
+import Main from '@modern-js/builder-doc/docs/zh/config/performance/printFileSize.md'
 
 <Main />

package/zh/configure/app/performance/profile.md

@@ -4,9 +4,9 @@ sidebar_label: profile
 ---
 
 :::info BUILDER
-该配置为 Modern.js Builder 配置，详细信息可参考 [performance.profile](https://modernjs.dev/builder/zh/api/config-performance.html#performance-profile)。
+该配置为 Modern.js Builder 配置，详细信息可参考 [performance.profile](https://modernjs.dev/builder/api/config-performance.html#performance-profile)。
 :::
 
-import Main from '@modern-js/builder-doc/zh/config/performance/profile.md'
+import Main from '@modern-js/builder-doc/docs/zh/config/performance/profile.md'
 
 <Main />

package/zh/configure/app/performance/remove-console.md

@@ -4,9 +4,9 @@ sidebar_label: removeConsole
 ---
 
 :::info BUILDER
-该配置为 Modern.js Builder 配置，详细信息可参考 [performance.removeConsole](https://modernjs.dev/builder/zh/api/config-performance.html#performance-removeconsole)。
+该配置为 Modern.js Builder 配置，详细信息可参考 [performance.removeConsole](https://modernjs.dev/builder/api/config-performance.html#performance-removeconsole)。
 :::
 
-import Main from '@modern-js/builder-doc/zh/config/performance/removeConsole.md'
+import Main from '@modern-js/builder-doc/docs/zh/config/performance/removeConsole.md'
 
 <Main />

package/zh/configure/app/performance/remove-moment-locale.md

@@ -4,9 +4,9 @@ sidebar_label: removeMomentLocale
 ---
 
 :::info BUILDER
-该配置为 Modern.js Builder 配置，详细信息可参考 [performance.removeMomentLocale](https://modernjs.dev/builder/zh/api/config-performance.html#performance-removemomentlocale)。
+该配置为 Modern.js Builder 配置，详细信息可参考 [performance.removeMomentLocale](https://modernjs.dev/builder/api/config-performance.html#performance-removemomentlocale)。
 :::
 
-import Main from '@modern-js/builder-doc/zh/config/performance/removeMomentLocale.md'
+import Main from '@modern-js/builder-doc/docs/zh/config/performance/removeMomentLocale.md'
 
 <Main />

package/zh/configure/app/plugins.md

@@ -43,10 +43,10 @@ Modern.js 中内置了三种不同的框架插件：
 使用 npm 上的插件，需要通过包管理器安装插件，并通过 import 引入。
 
 ```ts title="modern.config.ts"
-import MyPlugin from 'my-plugin';
+import myPlugin from 'my-plugin';
 
 export default defineConfig({
-  plugins: [MyPlugin()],
+  plugins: [myPlugin()],
 });
 ```
 
@@ -55,10 +55,10 @@ export default defineConfig({
 使用本地代码仓库中的插件，直接通过相对路径 import 引入即可。
 
 ```ts title="modern.config.ts"
-import MyPlugin from './config/plugin/MyPlugin';
+import myPlugin from './config/plugin/myPlugin';
 
 export default defineConfig({
-  plugins: [MyPlugin()],
+  plugins: [myPlugin()],
 });
 ```
 
@@ -67,11 +67,11 @@ export default defineConfig({
 如果插件提供了一些自定义的配置项，可以通过插件函数的参数传入配置。
 
 ```ts title="modern.config.ts"
-import MyPlugin from 'my-plugin';
+import myPlugin from 'my-plugin';
 
 export default defineConfig({
   plugins: [
-    MyPlugin({
+    myPlugin({
       foo: 1,
       bar: 2,
     }),

package/zh/configure/app/runtime/intro.md

@@ -11,7 +11,7 @@ sidebar_position: 1
 
 ### runtime
 
-* 类型：`Object`
+- 类型：`Object`
 
 runtime 配置方式如下：
 
@@ -25,8 +25,8 @@ import { defineConfig } from '@modern-js/app-tools';
 export default defineConfig({
   runtime: {
     state: true,
-    router: true
-  }
+    router: true,
+  },
 });
 ```
 
@@ -69,9 +69,9 @@ const App = () => {
 
 defineConfig(App, {
   router: {
-    supportHtml5History: false
-  }
-})
+    supportHtml5History: false,
+  },
+});
 
 export default App;
 ```
@@ -93,8 +93,8 @@ defineConfig 中只能定义 Runtime 插件的具体配置内容，确认是否
 
 ### runtimeByEntries
 
-* 类型： `Object`
-* 默认值：无
+- 类型： `Object`
+- 默认值：无
 
 #### 说明
 
@@ -109,10 +109,11 @@ export default defineConfig({
   },
   runtimeByEntries: {
     entry1: {
-       state: true, // { state: true }
+      state: true, // { state: true }
     },
-    entry2: { // { state: false, router: true }
-       router: true,
+    entry2: {
+      // { state: false, router: true }
+      router: true,
     },
   },
 });

package/zh/configure/app/runtime/master-app.md

@@ -4,7 +4,7 @@ sidebar_label: masterApp
 
 # runtime.masterApp
 
-* 类型： `Object`
+- 类型： `Object`
 
 :::info
 需要先通过 `pnpm run new` 启用「微前端」 功能。
@@ -18,7 +18,6 @@ import MasterManifestAppConfig from '@site-docs/components/micro-master-manifest
 <EnableMicroFrontend />
 <MasterManifestAppConfig />
 
-
 ### apps
 
 当 `apps` 为对象类型的时候，表示子应用模块的信息 `Array<AppInfo>`

package/zh/configure/app/runtime/router.md

@@ -8,25 +8,24 @@ import RouterLegacyTip from '@site-docs/components/router-legacy-tip.md'
 
 # runtime.router
 
-* 类型： `boolean | Object`
-* 默认值： `false`。
+- 类型： `boolean | Object`
+- 默认值： `false`
 
 开启 `router` 之后，支持使用 Modern.js 默认提供的约定式路由进行路由管理。Modern.js 的路由模块基于 [React Router 6](https://reactrouter.com/) 实现。
 
 具体配置如下：
 
-
 ## basename
 
-* 类型： `string`
-* 默认值： ``
+- 类型： `string`
+- 默认值： ``
 
 设置客户端路由的 `basename`，通常用于应用需要部署在域名非根路径下的场景。
 
 ## supportHtml5History
 
-* 类型： `boolean`
-* 默认值： `true`
+- 类型： `boolean`
+- 默认值： `true`
 
 值为 `true`，使用 `BrowserRouter`；否则使用 `HashRouter`。推荐使用 `BrowserRouter`。
 

package/zh/configure/app/runtime/state.md

@@ -4,52 +4,51 @@ sidebar_label: state
 
 # runtime.state
 
-* 类型：`boolean | object`
-* 默认值：`false`
+- 类型：`boolean | object`
+- 默认值：`false`
 
 开启 `state` 后就可以使用 [Model](/docs/guides/topic-detail/model/quick-start) 来做状态管理。
 
-
 具体配置项如下：
 
 ## models
 
-* 类型：`Array<Model>`
-* 默认值：`[]`
+- 类型：`Array<Model>`
+- 默认值：`[]`
 
 注册提前挂载的 model 对象，这些 model 会在 Reduck store 创建完成后立即执行挂载。一般使用无需提前挂载。
 
 ## initialState
-* 类型: `Object`
-* 默认值：`{}`
+
+- 类型: `Object`
+- 默认值：`{}`
 
 用于设置全局 store 的初始状态。一般用于 SSR 在 hydration 阶段初始化数据。
 
 ## immer
 
-* 类型：`boolean`
-* 默认值：`true`
+- 类型：`boolean`
+- 默认值：`true`
 
 是否启用以 mutable 更新 state 的方式，默认启用，若想禁用则设置为 `false`。
 
 ## effects
 
-* 类型：`boolean`
-* 默认值：`true`
+- 类型：`boolean`
+- 默认值：`true`
 
 是否启用副作用管理特性，默认启用，若想禁用则设置为 `false`。
 
 ## autoActions
 
-* 类型：`boolean`
-* 默认值：`true`
+- 类型：`boolean`
+- 默认值：`true`
 
 是否启用自动生成 actions 特性，默认启用，若想禁用则设置为 `false`。
 
-
 ## devtools
 
-* 类型：`boolean | EnhancerOptions`
-* 默认值：`true`
+- 类型：`boolean | EnhancerOptions`
+- 默认值：`true`
 
 是否启用 devtools，默认启用，同时支持 [redux-devtools-extension](https://github.com/zalmoxisus/redux-devtools-extension/blob/master/docs/API/Arguments.md) 的所有参数，若想禁用则设置为 `false`。

package/zh/configure/app/security/sri.md

@@ -4,9 +4,9 @@ sidebar_label: sri
 ---
 
 :::info BUILDER
-该配置为 Modern.js Builder 配置，详细信息可参考 [security.sri](https://modernjs.dev/builder/zh/api/config-security.html#security-sri)。
+该配置为 Modern.js Builder 配置，详细信息可参考 [security.sri](https://modernjs.dev/builder/api/config-security.html#security-sri)。
 :::
 
-import Main from '@modern-js/builder-doc/zh/config/security/sri.md'
+import Main from '@modern-js/builder-doc/docs/zh/config/security/sri.md'
 
 <Main />

package/zh/configure/app/server/base-url.md

@@ -4,15 +4,12 @@ sidebar_label: baseUrl
 
 # server.baseUrl
 
-
-
-* 类型： `string | string[]`
-* 默认值： `undefined`
-
+- 类型： `string | string[]`
+- 默认值： `undefined`
 
 统一设置服务端路由前缀（常用于共享域名的情况，区分流量)。
 
-```typescript title="modern.config.ts"
+```ts title="modern.config.ts"
 export default defineConfig({
   server: {
     // 所有生成的路由前面都会自动加上前缀 `/base`

package/zh/configure/app/server/enable-framework-ext.md

@@ -1,20 +1,21 @@
 ---
 sidebar_label: enableFrameworkExt
 ---
+
 # server.enableFrameworkExt
 
-* 类型： `Boolean`
-* 默认值： `false`
+- 类型： `boolean`
+- 默认值： `false`
 
 默认情况下，开启[自定义 Web Server 功能](/docs/guides/advanced-features/web-server)后，Middleware 会使用 Modern.js 本身的语法。
 
 开启 `server.enableFrameworkExt` 可以使用其他框架扩展的语法。
 
-```typescript title="modern.config.ts"
+```ts title="modern.config.ts"
 export default defineConfig({
   server: {
     enableFrameworkExt: true,
-  }
+  },
 });
 ```
 

package/zh/configure/app/server/port.md

@@ -4,17 +4,35 @@ sidebar_label: port
 
 # server.port
 
+- 类型： `number`
+- 默认值： `8080`
 
+Modern.js 在执行 `dev`, `start` 和 `serve` 命令时，会以 `8080` 为默认端口启动，并会在端口被占用时自动递增端口号。你可以通过该配置来修改 Server 启动的端口号：
 
-* 类型： `Number`
-* 默认值： `8080`
+```ts title="modern.config.ts"
+export default defineConfig({
+  server: {
+    port: 3000,
+  },
+});
+```
 
-Modern.js 在 `dev` 和  `start` 时会以 `8080` 为默认端口启动，通过该配置可以修改 Server 启动的端口号：
+### 与 dev.port 的区别
 
-```typescript title="modern.config.ts"
+大多数情况下，我们推荐使用 `server.port` 而不是 `dev.port` 来设置端口号，他们之间的区别如下：
+
+- `dev.port` 仅在开发环境下生效，`server.port` 在开发环境和生产环境下均能生效。
+- 在开发环境下，`dev.port` 的优先级高于 `server.port`。
+
+当你同时设置 `dev.port` 和 `server.port` 时，`dev.port` 会在开发环境下生效，`server.port` 会在生产环境下生效。比如以下例子，在开发环境下监听的端口号为 `3001`，在生产环境下监听的端口号为 `3002`。
+
+```ts title="modern.config.ts"
 export default defineConfig({
+  dev: {
+    port: 3001,
+  },
   server: {
-    port: 3000,
-  }
+    port: 3002,
+  },
 });
 ```

package/zh/configure/app/server/public-routes.md

@@ -4,16 +4,14 @@ sidebar_label: publicRoutes
 
 # server.publicRoutes
 
-
-
-* 类型： `Object`
-* 默认值： 根据文件约定自动生成的服务端路由规则：应用的每个文件生成一条路由规则。
+- 类型： `Object`
+- 默认值： 根据文件约定自动生成的服务端路由规则：应用的每个文件生成一条路由规则。
 
 该配置选项只作用于服务端路由，可以自定义 `config/public/` 下资源的访问路由。
 
 对象的 `key` 为当前应用的相对文件路径（不使用 `./`）, 值可以是 `string`。
 
-```typescript title="modern.config.ts"
+```ts title="modern.config.ts"
 export default defineConfig({
   server: {
     publicRoutes: {
@@ -21,8 +19,8 @@ export default defineConfig({
       'index.json': '/user-config/card-info/extra/help.json',
 
       // 设置一个不带后缀的路由
-      'robot.txt': '/app/authentication'
-    }
-  }
+      'robot.txt': '/app/authentication',
+    },
+  },
 });
 ```