@modern-js/main-doc 0.0.0-next-20221116121040

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

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

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

@@ -0,0 +1,92 @@
+---
+sidebar_label: routes
+sidebar_position: 4
+---
+
+# server.routes
+
+* 类型： `Object`
+* 默认值： 根据文件约定自动生成的服务端路由规则：应用的每个入口生成一条路由规则，入口名称等于路由名称。
+
+该配置选项只作用于服务端路由，可以自定义应用入口的服务访问配置。
+
+## 自定义访问路由
+
+对象的 `key` 为当前应用的入口名, 值可以是 `string | Array<string>`。
+
+当值类型为 `string` 时，当前值即表示访问该入口的路由名称。
+
+```js title="modern.config.js"
+export default defineConfig({
+  server: {
+    routes: {
+      // 默认路由为 /entryName1，自定义后为 /p/test1
+      entryName1: '/p/test1'
+      // 支持动态服务端路由配置
+      entryName2: '/detail/:id'
+    }
+  }
+});
+```
+
+也可以通过 `Array<string>` 为入口设置多个访问路由:
+
+```js title="modern.config.js"
+export default defineConfig({
+  server: {
+    routes: {
+      'page-a': [`/a`, '/b'],
+    },
+  },
+});
+```
+
+此时，通过 `/a`、`/b` 两个路由都可以访问到 `page-a` 入口。
+
+执行 `dev` 命令后，可以在 `dist/route.json` 中查看入口 `page-a` 存在两条路由记录:
+
+```json
+{
+  "routes": [
+    {
+      "urlPath": "/a",
+      "entryName": "page-a",
+      "entryPath": "html/page-a/index.html",
+      "isSPA": true,
+      "isSSR": false,
+      "enableModernMode": false
+    },
+    {
+      "urlPath": "/b",
+      "entryName": "page-a",
+      "entryPath": "html/page-a/index.html",
+      "isSPA": true,
+      "isSSR": false,
+      "enableModernMode": false
+    },
+  ]
+}
+```
+
+## 自定义响应头
+
+可以通过配置入口的 resHeaders 设置响应头：
+
+```js title="modern.config.js"
+export default defineConfig({
+  server: {
+    routes: {
+      'page-a': {
+        route: ['/a', '/b'],
+        resHeaders: {
+          'x-modern-test': '1',
+        },
+      },
+    },
+  },
+});
+```
+
+:::note
+这一配置在生产环境与开发环境都生效，可以根据 NODE_ENV 区分环境设置不同的响应头。但如果你只需要在开发环境设置响应头，推荐使用 tools.devServer.headers。
+:::

package/zh/configure/app/server/ssr-by-entries.md

@@ -0,0 +1,32 @@
+---
+sidebar_label: ssrByEntries
+sidebar_position: 2
+---
+
+# server.ssrByEntries
+
+
+
+* 类型： `Object`
+* 默认值： `undefined`
+
+按入口设置 ssr 选项，选项内的属性同 [ssr](./ssr.md)，指定值会和 ssr 属性内容做替换合并操作，例如：
+
+:::info 注
+「 入口名 」默认为目录名，少数情况下通过 `source.entries` 自定义入口时，入口名为 `source.entries` 对象的 `key`。
+:::
+
+```js title="modern.config.js"
+export default defineConfig({
+  server: {
+    ssr: true,
+    ssrByEntries: {
+      // entry1 不启用 ssr
+      'page-a': false,
+    }
+  }
+});
+```
+
+如上配置，项目整体启用了 ssr, 但是针对入口 `page-a` 关闭了 ssr 渲染能力。
+

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

@@ -0,0 +1,24 @@
+---
+sidebar_label: ssr
+sidebar_position: 1
+---
+
+# server.ssr
+
+
+
+* 类型： `boolean`
+* 默认值： `false`
+
+SSR 开关以及相关设置。
+
+当值类型为 `boolean` 时，表示是否开启 SSR 部署模式，默认 `false` 不开启。
+
+```js title="modern.config.js"
+export default defineConfig({
+  server: {
+    ssr: true,
+  }
+});
+```
+

package/zh/configure/app/source/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "source (源文件)",
+  "position": 1
+}

package/zh/configure/app/source/alias.md

@@ -0,0 +1,13 @@
+---
+title: source.alias
+sidebar_label: alias
+sidebar_position: 1
+---
+
+:::info BUILDER
+该配置为 Modern.js Builder 配置，可能存在无法跳转的链接。详细信息可参考 [source.alias](https://modernjs.dev/builder/zh/api/config-source.html#source-alias)。
+:::
+
+import Main from '@modern-js/builder-doc/zh/config/source/alias.md'
+
+<Main />

package/zh/configure/app/source/compile-js-data-uri.md

@@ -0,0 +1,13 @@
+---
+title: source.compileJsDataURI
+sidebar_label: compileJsDataURI
+sidebar_position: 1
+---
+
+:::info BUILDER
+该配置为 Modern.js Builder 配置，可能存在无法跳转的链接。详细信息可参考 [source.compileJsDataURI](https://modernjs.dev/builder/zh/api/config-source.html#source-compilejsdatauri)。
+:::
+
+import Main from '@modern-js/builder-doc/zh/config/source/compileJsDataURI.md'
+
+<Main />

package/zh/configure/app/source/config-dir.md

@@ -0,0 +1,15 @@
+---
+title: source.configDir
+sidebar_label: configDir
+---
+
+
+
+* 类型： `string`
+* 默认值： `./config`
+
+Modern.js 支持在 `./config` 文件夹下放置一些文件自定义 HTML 模板、图标、静态资源等。
+
+通过该选项可以自定义配置文件的目录。
+
+<!-- TODO: 文件约定 config/html 和 config/public -->

package/zh/configure/app/source/define.md

@@ -0,0 +1,13 @@
+---
+title: source.define
+sidebar_label: define
+sidebar_position: 1
+---
+
+:::info BUILDER
+该配置为 Modern.js Builder 配置，可能存在无法跳转的链接。详细信息可参考 [source.define](https://modernjs.dev/builder/zh/api/config-source.html#source-define)。
+:::
+
+import Main from '@modern-js/builder-doc/zh/config/source/define.md'
+
+<Main />