@modern-js/main-doc 2.1.0 → 2.2.0

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

@@ -1,89 +0,0 @@
----
-sidebar_label: routes
----
-
-# server.routes
-
-- 类型： `Object`
-- 默认值： 根据文件约定自动生成的服务端路由规则：应用的每个入口生成一条路由规则，入口名称等于路由名称。
-
-该配置选项只作用于服务端路由，可以自定义应用入口的服务访问配置。
-
-## 自定义访问路由
-
-对象的 `key` 为当前应用的入口名, 值可以是 `string | Array<string>`。
-
-当值类型为 `string` 时，当前值即表示访问该入口的路由名称。
-
-```ts title="modern.config.ts"
-export default defineConfig({
-  server: {
-    routes: {
-      // 默认路由为 /entryName1，自定义后为 /p/test1
-      entryName1: '/p/test1'
-      // 支持动态服务端路由配置
-      entryName2: '/detail/:id'
-    }
-  }
-});
-```
-
-也可以通过 `Array<string>` 为入口设置多个访问路由:
-
-```ts title="modern.config.ts"
-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
-    },
-    {
-      "urlPath": "/b",
-      "entryName": "page-a",
-      "entryPath": "html/page-a/index.html",
-      "isSPA": true,
-      "isSSR": false
-    }
-  ]
-}
-```
-
-## 自定义响应头
-
-可以通过配置入口的 resHeaders 设置响应头：
-
-```ts title="modern.config.ts"
-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

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

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

@@ -1,23 +0,0 @@
----
-title: source.configDir
-sidebar_label: configDir
----
-
-- 类型： `string`
-- 默认值： `./config`
-
-Modern.js 支持在 `./config` 文件夹下放置一些文件自定义 HTML 模板、图标、静态资源等，具体可参考[文件约定](/docs/apis/app/hooks/config/html)。
-
-通过该选项可以自定义配置文件的目录。
-
-例如，将资源文件目录调整为 `resources` 目录：
-
-```js title="modern.config.ts"
-import { defineConfig } from '@modern-js/app-tools';
-
-export default defineConfig({
-  source: {
-    configDir: './resources',
-  },
-});
-```