@modern-js/main-doc 2.0.0-beta.2 → 2.0.0-beta.4

package/en/docusaurus-plugin-content-docs/current.json

@@ -4,7 +4,7 @@
     "description": "The label for version current"
   },
   "sidebar.tutorialsSidebar.category.基础": {
-    "message": "基础",
+    "message": "Basic",
     "description": "The label for category 基础 in sidebar tutorialsSidebar"
   },
   "sidebar.tutorialsSidebar.category.创建第一个应用": {
@@ -56,23 +56,23 @@
     "description": "The label for category 11: 添加容器组件 in sidebar tutorialsSidebar"
   },
   "sidebar.guidesSidebar.category.开始": {
-    "message": "开始",
+    "message": "Start",
     "description": "The label for category 开始 in sidebar guidesSidebar"
   },
   "sidebar.guidesSidebar.category.核心概念": {
-    "message": "核心概念",
+    "message": "Core Concept",
     "description": "The label for category 核心概念 in sidebar guidesSidebar"
   },
   "sidebar.guidesSidebar.category.基础功能": {
-    "message": "基础功能",
+    "message": "Basic Features",
     "description": "The label for category 基础功能 in sidebar guidesSidebar"
   },
   "sidebar.guidesSidebar.category.CSS 开发方案": {
-    "message": "CSS 开发方案",
+    "message": "CSS Development",
     "description": "The label for category CSS 开发方案 in sidebar guidesSidebar"
   },
   "sidebar.guidesSidebar.category.进阶功能": {
-    "message": "进阶功能",
+    "message": "Advanced Features",
     "description": "The label for category 进阶功能 in sidebar guidesSidebar"
   },
   "sidebar.guidesSidebar.category.BFF": {
@@ -80,15 +80,15 @@
     "description": "The label for category BFF in sidebar guidesSidebar"
   },
   "sidebar.guidesSidebar.category.专题详解": {
-    "message": "专题详解",
+    "message": "Topic Detail",
     "description": "The label for category 专题详解 in sidebar guidesSidebar"
   },
   "sidebar.guidesSidebar.category.Reduck 状态管理": {
-    "message": "Reduck 状态管理",
+    "message": "Reduck State Manager",
     "description": "The label for category Reduck 状态管理 in sidebar guidesSidebar"
   },
   "sidebar.guidesSidebar.category.微前端": {
-    "message": "微前端",
+    "message": "Micro-frontend",
     "description": "The label for category 微前端 in sidebar guidesSidebar"
   },
   "sidebar.guidesSidebar.category.Monorepo": {
@@ -96,11 +96,11 @@
     "description": "The label for category Monorepo in sidebar guidesSidebar"
   },
   "sidebar.guidesSidebar.category.包版本管理": {
-    "message": "包版本管理",
+    "message": "Package Version Manager",
     "description": "The label for category 包版本管理 in sidebar guidesSidebar"
   },
   "sidebar.guidesSidebar.category.自定义插件": {
-    "message": "自定义插件",
+    "message": "Customized plugins",
     "description": "The label for category 自定义插件 in sidebar guidesSidebar"
   },
   "sidebar.guidesSidebar.category.项目生成器": {
@@ -179,44 +179,44 @@
     "message": "Runtime",
     "description": "The label for category runtime in sidebar apisAppSidebar"
   },
-  "sidebar.apisAppSidebar.category.核心 API": {
-    "message": "Core API",
+  "sidebar.apisAppSidebar.category.核心": {
+    "message": "Core",
     "description": "The label for category Core API in sidebar apisAppSidebar"
   },
-  "sidebar.apisAppSidebar.category.App API": {
-    "message": "App API",
+  "sidebar.apisAppSidebar.category.App": {
+    "message": "App",
     "description": "The label for category App API in sidebar apisAppSidebar"
   },
-  "sidebar.apisAppSidebar.category.BFF Server API": {
-    "message": "BFF Server API",
+  "sidebar.apisAppSidebar.category.BFF Server": {
+    "message": "BFF Server",
     "description": "The label for category BFF Server API in sidebar apisAppSidebar"
   },
-  "sidebar.apisAppSidebar.category.Model API": {
-    "message": "Model API",
+  "sidebar.apisAppSidebar.category.Model": {
+    "message": "Model",
     "description": "The label for category Model API in sidebar apisAppSidebar"
   },
-  "sidebar.apisAppSidebar.category.Container API": {
-    "message": "Container API",
+  "sidebar.apisAppSidebar.category.Container": {
+    "message": "Container",
     "description": "The label for category Container API in sidebar apisAppSidebar"
   },
-  "sidebar.apisAppSidebar.category.Testing API": {
-    "message": "Testing API",
+  "sidebar.apisAppSidebar.category.Testing": {
+    "message": "Testing",
     "description": "The label for category Testing API in sidebar apisAppSidebar"
   },
-  "sidebar.apisAppSidebar.category.Web Server API": {
-    "message": "Web Server API",
+  "sidebar.apisAppSidebar.category.Web Server": {
+    "message": "Web Server",
     "description": "The label for category Web Server API in sidebar apisAppSidebar"
   },
-  "sidebar.apisAppSidebar.category.Utility API": {
-    "message": "Utility API",
+  "sidebar.apisAppSidebar.category.Utility": {
+    "message": "Utility",
     "description": "The label for category Utility API in sidebar apisAppSidebar"
   },
   "sidebar.apisAppSidebar.category.loadable": {
     "message": "loadable",
     "description": "The label for category loadable in sidebar apisAppSidebar"
   },
-  "sidebar.apisAppSidebar.category.插件 API": {
-    "message": "插件 API",
+  "sidebar.apisAppSidebar.category.插件": {
+    "message": "插件",
     "description": "The label for category 插件 API in sidebar apisAppSidebar"
   },
   "sidebar.apisMonorepoSidebar.category.文件约定": {

package/package.json

@@ -11,20 +11,20 @@
     "modern",
     "modern.js"
   ],
-  "version": "2.0.0-beta.2",
+  "version": "2.0.0-beta.4",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
   "peerDependencies": {
-    "@modern-js/builder-doc": "2.0.0-beta.2"
+    "@modern-js/builder-doc": "2.0.0-beta.4"
   },
   "devDependencies": {
     "ts-node": "^10",
     "fs-extra": "^10",
     "@types/node": "^16",
     "@types/fs-extra": "^9",
-    "@modern-js/builder-doc": "2.0.0-beta.2"
+    "@modern-js/builder-doc": "2.0.0-beta.4"
   },
   "scripts": {
     "build": "npx ts-node ./scripts/sync.ts"

package/scripts/config.ts

@@ -2,8 +2,8 @@ import path from 'path';
 import fs from 'fs-extra';
 
 const tip: Record<string, string> = {
-  zh: '该配置为 Modern.js Builder 配置，可能存在无法跳转的链接。详细信息可参考',
-  en: 'This configuration is Modern.js Builder configuration, there may be links that cannot be redirected. for details, please refer to',
+  zh: '该配置为 Modern.js Builder 配置，详细信息可参考',
+  en: 'This configuration is Modern.js Builder configuration, more detail can see',
 };
 
 export type Summary = {

package/zh/apis/app/commands/inspect.md

@@ -33,7 +33,3 @@ modern inspect --env production
 ### SSR 配置
 
 如果项目开启了 SSR 能力，则在 `dist` 目录会另外生成一份 `webpack.ssr.inspect.js` 文件，对应 SSR 构建时的 webpack 配置。
-
-### Modern 配置
-
-如果项目开启了 [enableModernMode](/docs/configure/app/output/enable-modern-mode) 选项，则在 `dist` 目录会另外生成一份 `webpack.modern.inspect.js` 文件，对应现代浏览器的 webpack 配置。

package/zh/apis/app/commands/new.md

@@ -34,7 +34,7 @@ $ npx modern new
 ? 请填写入口名称 entry
 ```
 
-### 启用启用可选功能
+### 启用可选功能
 
 在应用工程中，执行 `new` 命令启用可选能力如下：
 
@@ -43,8 +43,6 @@ $ npx modern new
 ? 请选择你想要的操作 启用可选功能
 ? 启用可选功能 (Use arrow keys)
 ❯ 启用 Tailwind CSS 支持
-  启用 Less 支持
-  启用 Sass 支持
   启用「BFF」功能
   启用「微前端」模式
   启用「单元测试 / 集成测试」功能

package/zh/apis/app/hooks/src/index_.md

@@ -12,11 +12,12 @@ sidebar_position: 3
 只需要 `src/index.[tj]s` 默认导出函数:
 
 ```js title=src/index.js
-import { bootstrap } from '@modern-js/runtime';
+import ReactDOM from 'react-dom/client';
+import { bootstrap } from '@edenx/runtime';
 
-export default App => {
+export default (App: React.ComponentType) => {
   // do something before bootstrap...
-  bootstrap(App, 'root');
+  bootstrap(App, 'root', undefined, ReactDOM);
 };
 ```
 
@@ -28,8 +29,8 @@ export default App => {
 
 ```js title=src/index.jsx
 import React from 'react';
-import ReactDOM from 'react-dom';
+import ReactDOM from 'react-dom/client';
 import App from './App';
 
-ReactDOM.render(<App />, document.getElementById('root'));
+ReactDOM.createRoot(document.getElementById('root')!).render(<App />);
 ```

package/zh/apis/app/runtime/app/_category_.json

@@ -1,4 +1,4 @@
 {
-  "label": "APP API",
+  "label": "APP",
   "position": 4
 }

package/zh/apis/app/runtime/bff/_category_.json

@@ -1,4 +1,4 @@
 {
-  "label": "BFF API",
+  "label": "BFF",
   "position": 8
 }

package/zh/apis/app/runtime/core/_category_.json

@@ -1,4 +1,4 @@
 {
-  "label": "核心 API",
+  "label": "核心",
   "position": 3
 }

package/zh/apis/app/runtime/core/bootstrap.md

@@ -7,25 +7,39 @@ title: bootstrap
 ## 使用姿势
 
 ```ts
+import ReactDOM from 'react-dom/client'
 import { bootstrap } from '@modern-js/runtime';
 
-bootstrap(App, 'root');
+bootstrap(App, 'root', undefined, ReactDOM);
 ```
 
 ## 函数签名
 
 ```ts
-function bootstrap(AppComponent: React.ComponentType<any>, rootId: string): React.ComponentType<any> | void
+type BootStrap<T = unknown> = (
+  App: React.ComponentType,
+  id: string | HTMLElement | RuntimeContext,
+  root?: any,
+  ReactDOM?: {
+    render?: Renderer;
+    hydrate?: Renderer;
+    createRoot?: typeof createRoot;
+    hydrateRoot?: typeof hydrateRoot;
+  },
+) => Promise<T>;
 ```
 
 ### 参数
 
 - `AppComponent`：通过 [`createApp`](./create-app) 创建的 ReactElement 实例。
 - `rootId`：要挂载的 DOM 根元素 id，如 `"root"`。
+- `root`: ReactDOM.createRoot 的返回值，用于 bootstrap 函数外需要 root 销毁组件的场景。
+- `ReactDOM`: ReactDOM 对象，用于区分 React 18 和 React 17 API。
 
 ## 示例
 
 ```tsx
+import ReactDOM from 'react-dom/client'
 import { createApp, bootstrap } from '@modern-js/runtime';
 import { router, state } from '@modern-js/runtime/plugins';
 
@@ -38,7 +52,7 @@ const WrappedApp = createApp({
   plugins: [router({}), state({})],
 })(App);
 
-bootstrap(WrappedApp, 'root');
+bootstrap(WrappedApp, 'root', undefined, ReactDOM);
 
 ```
 

package/zh/apis/app/runtime/model/_category_.json

@@ -1,4 +1,4 @@
 {
-  "label": "Model API",
+  "label": "Model",
   "position": 6
 }

package/zh/apis/app/runtime/model/create-app.md

@@ -29,7 +29,7 @@ function createApp(config: AppConfig): object;
 - config：`Record<string, any>`
   - StoreConfig：同 [`createStore`](./create-store.md) 的参数。
   - devTools：默认值为true。是否开启 Redux DevTools，当为对象类型时，支持配置 Redux DevTools 的 [Options](https://github.com/reduxjs/redux-devtools/blob/main/extension/docs/API/Arguments.md)。
-  - autoActins：默认值为true。是否[自动生成 Actions](./auto-actions.md)。
+  - autoActions：默认值为true。是否[自动生成 Actions](./auto-actions.md)。
 
 ### 返回值
 

package/zh/apis/app/runtime/model/use-store.md

@@ -20,29 +20,7 @@ function useStore(): ReduckStore;
 
 - ReduckStore：Reduck Store，类型参考 [createStore](./create-store.md) 返回值。
 
-## 示例
-
-```ts
-// 保证 getStore 在组件树挂载完成后执行
-setTimeout(() => {
-  const store = getStore();
-  const [, actions] = store.use(countModel);
-  setInterval(() => {
-    actions.add();
-  }, 1000);
-}, 1000);
-
-function Counter() {
-  const [state] = useModel(countModel);
-
-  return (
-    <div>
-      <div>counter: {state.value}</div>
-    </div>
-  );
-}
-```
 
 :::info 更多参考
-[使用 Model](/docs/guides/topic-detail/model/use-model)
+[使用 Model](/docs/guides/topic-detail/model/use-model#在组件外使用)
 :::

package/zh/apis/app/runtime/router/_category_.json

@@ -1,4 +1,4 @@
 {
-  "label": "Router API",
+  "label": "Router",
   "position": 5
 }

package/zh/apis/app/runtime/ssr/_category_.json

@@ -1,4 +1,4 @@
 {
-  "label": "SSR API",
+  "label": "SSR",
   "position": 7
 }

package/zh/apis/app/runtime/testing/_category_.json

@@ -1,4 +1,4 @@
 {
-  "label": "Testing API",
+  "label": "Testing",
   "position": 11
 }

package/zh/apis/app/runtime/utility/_category_.json

@@ -1,4 +1,4 @@
 {
-  "label": "Utility API",
+  "label": "Utility",
   "position": 10
 }

package/zh/apis/app/runtime/web-server/_category_.json

@@ -1,4 +1,4 @@
 {
-  "label": "Web Server API",
+  "label": "Web Server",
   "position": 9
 }

package/zh/components/debug-app.md

@@ -0,0 +1,18 @@
+在项目中执行 `pnpm run dev` 即可启动项目：
+
+```bash
+$ pnpm run dev
+
+> modern dev
+
+info    Starting dev server...
+info    App running at:
+
+  > Local:    http://localhost:8080/
+  > Network:  http://10.94.58.87:8080/
+  > Network:  http://10.254.68.105:8080/
+
+ Client ✔ done in 76.10ms
+```
+
+在浏览器中打开 `http://localhost:8000/`，可以看到页面内容。

package/zh/components/global-proxy.md

@@ -0,0 +1,28 @@
+
+Modern.js 提供了开箱即用的全局代理插件 `@modern-js/plugin-proxy`，该插件底层基于 [whistle](https://github.com/avwo/whistle)，可用来查看、修改 HTTP/HTTPS 的请求和响应，也可作为 HTTP 代理服务器使用。
+
+### 设置代理规则
+
+引入代理插件并填写规则后，执行 `pnpm run dev`，Modern.js 会在开发服务器启动之后，自动启用代理服务器。
+
+具体代理规则，可通过 [`dev.proxy`](/docs/configure/app/dev/proxy) 选项或 `config/proxy.js` 文件进行设置。
+
+### 代理服务器 UI 界面
+
+安装代理插件并配置代理规则后， 执行 `pnpm run dev` 命令：
+
+```bash
+  App running at:
+
+  Local:    http://localhost:8080/
+  Network:  http://192.168.0.1:8080/
+
+ℹ  info      Starting the proxy server.....
+✔  success   Proxy Server start on localhost:8899
+```
+
+在控制台中可以看到代理服务器成功启动。
+
+访问 `http://localhost:8899`，显示下图所示的 UI 界面后，即可通过界面设置规则。
+
+![debug-proxy-ui](https://lf3-static.bytednsdoc.com/obj/eden-cn/aphqeh7uhohpquloj/modern-js/debug/debug-proxy-ui.png)

package/zh/components/init-app.md

@@ -0,0 +1,44 @@
+
+Modern.js 生成器会提供一个可交互的问答界面，根据结果初始化项目，按照默认的选择进行初始化：
+
+```bash
+? 请选择你想创建的工程类型 应用
+? 请选择开发语言 TS
+? 请选择包管理工具 pnpm
+```
+
+在生成项目后，Modern.js 会自动安装依赖、创建 git 仓库。
+
+```bash
+[INFO] 依赖自动安装成功
+[INFO] git 仓库初始化成功
+[INFO] 创建成功！
+可在新项目的目录下运行以下命令：
+pnpm run dev          # 按开发环境的要求，运行和调试项目
+pnpm run build        # 按产品环境的要求，构建项目
+pnpm run start        # 按产品环境的要求，运行项目
+pnpm run lint         # 检查和修复所有代码
+pnpm run new          # 继续创建更多项目要素，比如应用入口
+```
+
+:::note
+Modern.js 生成器除了在项目初始化时工作外，也能在后续研发中生成项目各种粒度的模块，并非一用即抛开。
+:::
+
+现在，项目结构如下：
+
+```
+.
+├── node_modules
+├── src
+│   ├── modern-app-env.d.ts
+│   └── routes
+│       ├── index.css
+│       ├── layout.tsx
+│       └── page.tsx
+├── modern.config.ts
+├── package.json
+├── pnpm-lock.yaml
+├── README.md
+└── tsconfig.json
+```

package/zh/components/prerequisites.md

@@ -0,0 +1,19 @@
+### Node.js
+
+需要 [Node.js LTS](https://github.com/nodejs/Release)，并确保 Node 版本大于等于 16.18.1
+
+Modern.js 推荐在开发环境里先安装 [nvm](https://github.com/nvm-sh/nvm#install--update-script)，在 shell 里集成[自动切换 node 版本的脚本](https://github.com/nvm-sh/nvm#deeper-shell-integration)。
+
+然后只要仓库根目录下有内容为 `lts/fermium` 或 `lts/gallium` 的 `.nvmrc` 文件，进入这个仓库时就会自动安装或切换到正确的 Node.js 版本。
+
+### pnpm
+
+推荐使用 [pnpm](https://pnpm.io/installation) 来管理依赖：
+
+```bash
+npm install -g pnpm
+```
+
+:::note
+Modern.js 同样支持使用 `yarn`、`npm` 进行依赖管理。
+:::

package/zh/components/reduck-migration.md

@@ -0,0 +1 @@
+

package/zh/configure/app/dev/asset-prefix.md

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

package/zh/configure/app/dev/hmr.md

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

package/zh/configure/app/dev/https.md

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

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

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

package/zh/configure/app/dev/progress-bar.md

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

package/zh/configure/app/dev/start-url.md

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

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

@@ -0,0 +1,4 @@
+{
+  "label": "experiments (实验性)",
+  "position": 15
+}

package/zh/configure/app/experiments/lazy-compilation.md

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

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

@@ -0,0 +1,4 @@
+{
+  "label": "html (模板)",
+  "position": 2
+}

package/zh/configure/app/html/app-icon.md

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

package/zh/configure/app/html/crossorigin.md

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

package/zh/configure/app/html/disable-html-folder.md

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

package/zh/configure/app/html/favicon-by-entries.md

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

package/zh/configure/app/html/favicon.md

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

package/zh/configure/app/html/inject-by-entries.md

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