@modern-js/module-tools-docs 2.0.1 → 2.0.2

package/docs/zh/api/config/build-config.md

@@ -4,7 +4,7 @@ sidebar_position: 1
 
 # BuildConfig
 
-本章节描述了 Module tools 关于构建的所有配置
+本章节描述了 Module Tools 关于构建的所有配置
 
 ## alias
 
@@ -12,7 +12,7 @@ sidebar_position: 1
 - 默认值：`{'@': 'src',}`
 
 :::tip
-对于 TypeScript 项目，只需要在 `tsconfig.json` 中配置 [compilerOptions.paths](https://www.typescriptlang.org/tsconfig#paths), Module tools 会自动识别 `tsconfig.json` 里的别名，因此不需要额外配置 `alias` 字段。
+对于 TypeScript 项目，只需要在 `tsconfig.json` 中配置 [compilerOptions.paths](https://www.typescriptlang.org/tsconfig#paths), Module Tools 会自动识别 `tsconfig.json` 里的别名，因此不需要额外配置 `alias` 字段。
 :::
 
 ```js modern.config.ts
@@ -63,7 +63,7 @@ export default defineConfig({
 
 ### path
 
-静态资源输出路径，会基于 [outDir](/zh/api/build-config/#outDir) 进行输出。
+静态资源输出路径，会基于 [outDir](/api/config/build-config#outDir) 进行输出。
 
 - 类型： `string`
 - 默认值： `assets`
@@ -103,6 +103,17 @@ export default defineConfig({
 - 类型： `boolean | Object`
 - 默认值： `false`
 
+:::tip
+开启svgr后，仍然使用default export导出svg，所以你只能导入默认值。
+```js index.ts
+// true
+import logo from './logo.svg';
+
+// false
+import { ReactComponent } from './logo.svg';
+```
+:::
+
 #### include
 
 设定匹配的 svg 文件
@@ -236,7 +247,7 @@ TypeScript 配置文件的路径。
 
 ### distPath
 
-类型文件的输出路径，基于 [outDir](/zh/api/build-config/#outDir) 进行输出。
+类型文件的输出路径，基于 [outDir](/api/config/build-config#outDir) 进行输出。
 
 - 类型: `string`
 - 默认值: `./types`
@@ -580,7 +591,7 @@ const tailwind = {
 
 值为 `Function` 类型时，函数返回的对象与默认配置通过 `Object.assign` 合并。
 
-不允许出现 `theme` 属性，否则会构建失败, 使用 [`designSystem`](/zh/api/design-system) 作为 `Tailwind CSS Theme` 配置。
+不允许出现 `theme` 属性，否则会构建失败, 使用 [`designSystem`](/api/config/design-system) 作为 `Tailwind CSS Theme` 配置。
 
 其他的使用方式和 Tailwind CSS 一致: [快速传送门](https://tailwindcss.com/docs/configuration)。
 

package/docs/zh/api/config/plugins.md

@@ -15,4 +15,4 @@ export default defineConfig({
 });
 ```
 
-关于如何编写插件，可以查看[【插件编写指南】](/zh/plugins/guide/getting-started)。
+关于如何编写插件，可以查看[【插件编写指南】](/plugins/guide/getting-started)。

package/docs/zh/api/index.md

@@ -1,6 +1,7 @@
 ---
 overview: true
 sidebar_label: 概览
+sidebar_position: 1
 ---
 
 # index

package/docs/zh/api/plugin-api/_category_.json

@@ -1,4 +1,4 @@
 {
   "label": "Plugin API",
-  "sidebar_position": 2
+  "sidebar_position": 3
 }

package/docs/zh/api/plugin-api/plugin-hooks.md

@@ -4,24 +4,24 @@
 
 目前主要包含两类生命周期钩子：
 
-* 构建钩子：仅在执行 `build` 命令构建源码产物时触发。
-* `buildPlatform` 钩子：仅在执行 `build --platform` 命令生成其他构建产物时触发。
-* 调试钩子：运行 `dev` 命令时会触发的钩子。
+- 构建钩子：仅在执行 `build` 命令构建源码产物时触发。
+- `buildPlatform` 钩子：仅在执行 `build --platform` 命令生成其他构建产物时触发。
+- 调试钩子：运行 `dev` 命令时会触发的钩子。
 
 ## 构建钩子
 
 在执行 `build` 命令的时候，会按照顺序触发以下 Hooks：
 
-* `beforeBuild`
-* `beforeBuildTask`
-* `afterBuildTask`
-* `afterBuild`
+- `beforeBuild`
+- `beforeBuildTask`
+- `afterBuildTask`
+- `afterBuild`
 
 ### `beforeBuild`
 
 执行整体构建流程之前触发。
 
-``` ts
+```ts
 export default (): CliPlugin<ModuleTools> => ({
   name: 'my-plugin',
 
@@ -29,16 +29,18 @@ export default (): CliPlugin<ModuleTools> => ({
     return {
       beforeBuild(options: Options): Return {
         return options.config;
-      }
-    }
+      },
+    };
   },
 });
 ```
 
 参数和返回值类型：
 
-``` ts
-type Options = { options: { config: BuildConfig; cliOptions: BuildCommandOptions } };
+```ts
+type Options = {
+  options: { config: BuildConfig; cliOptions: BuildCommandOptions };
+};
 
 export interface BuildCommandOptions {
   config: string;
@@ -52,13 +54,13 @@ export interface BuildCommandOptions {
 type Return = BuildConfig;
 ```
 
-> `BuildConfig` 类型参考 [API 配置](zh/api/)
+> `BuildConfig` 类型参考 [API 配置](/api/)
 
 ### `beforeBuildTask`
 
-根据构建配置，module tools 会将整体构建分成多个子构建任务。该 Hook 将会在每一个构建子任务之前触发。
+根据构建配置，Module Tools 会将整体构建分成多个子构建任务。该 Hook 将会在每一个构建子任务之前触发。
 
-``` ts
+```ts
 export default (): CliPlugin<ModuleTools> => ({
   name: 'my-plugin',
 
@@ -66,21 +68,21 @@ export default (): CliPlugin<ModuleTools> => ({
     return {
       beforeBuildTask(config: BaseBuildConfig): BaseBuildConfig {
         return config;
-      }
-    }
+      },
+    };
   },
 });
 ```
 
 参数和返回值类型：
 
-`BaseBuildConfig` 类型参考 [API 配置](zh/api/)。
+`BaseBuildConfig` 类型参考 [API 配置](/api/)。
 
 ### `afterBuildTask`
 
 每一个构建子任务结束之后触发。
 
-``` ts
+```ts
 export default (): CliPlugin<ModuleTools> => ({
   name: 'my-plugin',
 
@@ -88,15 +90,15 @@ export default (): CliPlugin<ModuleTools> => ({
     return {
       afterBuildTask(options: BuildTaskResult): void {
         // ...
-      }
-    }
+      },
+    };
   },
 });
 ```
 
 参数和返回值类型：
 
-``` ts
+```ts
 export interface BuildTaskResult {
   status: 'success' | 'fail';
   message?: string;
@@ -108,7 +110,7 @@ export interface BuildTaskResult {
 
 整体构建流程结束之后触发。
 
-``` ts
+```ts
 export default (): CliPlugin<ModuleTools> => ({
   name: 'my-plugin',
 
@@ -116,15 +118,15 @@ export default (): CliPlugin<ModuleTools> => ({
     return {
       afterBuild(options: BuildResult): void {
         // ...
-      }
-    }
+      },
+    };
   },
 });
 ```
 
 参数和返回值类型：
 
-``` ts
+```ts
 export interface BuildResult {
   status: 'success' | 'fail';
   message?: string;
@@ -142,16 +144,16 @@ module-tools 还提供了 `build --platform` 命令来执行特定的构建任
 
 在执行 `build --platform` 后会按照以下顺序触发 Hooks：
 
-* `registerBuildPlatform`
-* `beforeBuildPlatform`
-* `buildPlatform`
-* `afterBuildPlatform`
+- `registerBuildPlatform`
+- `beforeBuildPlatform`
+- `buildPlatform`
+- `afterBuildPlatform`
 
 ### `registerBuildPlatform`
 
 获取在执行 `build --platform` 命令时候需要运行的任务信息。
 
-``` ts
+```ts
 export default (): CliPlugin<ModuleTools> => ({
   name: 'my-plugin',
 
@@ -173,7 +175,7 @@ export default (): CliPlugin<ModuleTools> => ({
 
 入参和返回的参数类型：
 
-``` ts
+```ts
 export interface RegisterBuildPlatformResult {
   platform: string | string[];
   build: (
@@ -187,7 +189,7 @@ export interface RegisterBuildPlatformResult {
 
 当执行 `build --platform` 命令的时候，会触发所有已注册的构建任务。`beforeBuildPlatform` 会在执行整体的构建任务之前触发。
 
-``` ts
+```ts
 export default (): CliPlugin<ModuleTools> => ({
   name: 'my-plugin',
 
@@ -203,7 +205,7 @@ export default (): CliPlugin<ModuleTools> => ({
 
 入参和返回的参数类型：
 
-``` ts
+```ts
 export interface RegisterBuildPlatformResult {
   platform: string | string[];
   build: (
@@ -217,7 +219,7 @@ export interface RegisterBuildPlatformResult {
 
 当执行 `build --platform` 命令的时候，会触发所有已注册的构建任务。`buildPlatform` 会在每个构建任务执行之前触发。
 
-``` ts
+```ts
 export default (): CliPlugin<ModuleTools> => ({
   name: 'my-plugin',
 
@@ -233,7 +235,7 @@ export default (): CliPlugin<ModuleTools> => ({
 
 入参和返回的参数类型：
 
-``` ts
+```ts
 export interface Options {
   platform: string;
 }
@@ -243,7 +245,7 @@ export interface Options {
 
 当执行 `build --platform` 命令的时候，会触发所有已注册的构建任务。`afterBuildPlatform` 会在整体 platform 构建任务结束后触发。
 
-``` ts
+```ts
 export default (): CliPlugin<ModuleTools> => ({
   name: 'my-plugin',
 
@@ -270,7 +272,6 @@ export interface BuildPlatformResult {
 }
 ```
 
-
 ## 调试钩子
 
 在执行 `dev` 命令的时候，会按照顺序触发以下 Hooks：
@@ -286,13 +287,13 @@ export interface BuildPlatformResult {
 
 注册调试工具相关的数据。主要包含：
 
-* 调试工具的名称
-* 显示在菜单列表中的项目名称以及对应的值。
-* `dev` 子命令的定义。
-* 是否在运行调试任务之前执行源码构建
-* 执行调试任务的函数。
+- 调试工具的名称
+- 显示在菜单列表中的项目名称以及对应的值。
+- `dev` 子命令的定义。
+- 是否在运行调试任务之前执行源码构建
+- 执行调试任务的函数。
 
-``` ts
+```ts
 export default (): CliPlugin<ModuleTools> => ({
   name: 'my-plugin',
 
@@ -321,7 +322,7 @@ export default (): CliPlugin<ModuleTools> => ({
 
 入参和返回的参数类型：
 
-``` ts
+```ts
 export interface DevToolData {
   name: string;
   subCommands?: string[];
@@ -348,7 +349,7 @@ export interface DevToolData {
 
 在收集完所有调试工具元数据后，执行 dev 任务之前触发。
 
-``` ts
+```ts
 export default (): CliPlugin<ModuleTools> => ({
   name: 'my-plugin',
 
@@ -364,7 +365,7 @@ export default (): CliPlugin<ModuleTools> => ({
 
 入参和返回的参数类型：
 
-``` ts
+```ts
 export interface DevToolData {
   name: string;
   subCommands?: string[];
@@ -385,7 +386,7 @@ export interface DevToolData {
 
 `beforeDevMenu` 在出现调试列表/菜单之前触发。接收 [inquirer question](https://github.com/SBoudrias/Inquirer.js#question) 作为参数。默认值为：
 
-``` ts
+```ts
 const question = [
   {
     name: 'choiceDevTool',
@@ -399,7 +400,7 @@ const question = [
 
 `afterDevMenu` 选择调试列表/菜单选项后触发。
 
-``` ts
+```ts
 export default (): CliPlugin<ModuleTools> => ({
   name: 'my-plugin',
 
@@ -411,7 +412,7 @@ export default (): CliPlugin<ModuleTools> => ({
       },
       afterDevMenu(options: Options) {
         console.info(`choise ${options.result.choiceDevTool} dev tools`);
-      }
+      },
     };
   },
 });
@@ -419,7 +420,7 @@ export default (): CliPlugin<ModuleTools> => ({
 
 入参和返回的参数类型：
 
-``` ts
+```ts
 export type { QuestionCollection } from 'inquirer';
 
 export interface Options {
@@ -427,7 +428,7 @@ export interface Options {
   devTools: DevToolData[];
 }
 
-export type PromptResult = { choiceDevTool: string }
+export type PromptResult = { choiceDevTool: string };
 export interface DevToolData {
   name: string;
   subCommands?: string[];
@@ -448,7 +449,7 @@ export interface DevToolData {
 
 执行调试任务之前触发。
 
-``` ts
+```ts
 export default (): CliPlugin<ModuleTools> => ({
   name: 'my-plugin',
 
@@ -464,7 +465,7 @@ export default (): CliPlugin<ModuleTools> => ({
 
 入参和返回的参数类型：
 
-``` ts
+```ts
 export interface DevToolData {
   name: string;
   subCommands?: string[];
@@ -485,7 +486,7 @@ export interface DevToolData {
 
 在中断调试任务进程时触发。
 
-``` ts
+```ts
 export default (): CliPlugin<ModuleTools> => ({
   name: 'my-plugin',
 

package/docs/zh/guide/advance/asset.mdx

@@ -4,7 +4,7 @@ sidebar_position: 7
 
 # 处理静态资源文件
 
-模块工程会对代码中使用的静态资源进行处理。如果需要配置，则可以使用 [`buildConfig.asset`](/zh/api/build-config#asset) API。
+模块工程会对代码中使用的静态资源进行处理。如果需要配置，则可以使用 [`buildConfig.asset`](/api/config/build-config#asset) API。
 
 ## 默认行为
 

package/docs/zh/guide/advance/build-umd.mdx

@@ -22,7 +22,7 @@ export default defineConfig({
 
 ## umd 产物的第三方依赖处理
 
-在 [【如何处理第三方依赖】](/zh/guide/advance/external-dependency) 章节中，我们知道可以通过 [`autoExternals`](/zh/api/build-config#autoexternal) 和 [`externals`](/zh/api/build-config#externals) API 来控制项目是否对第三方依赖打包。
+在 [【如何处理第三方依赖】](/guide/advance/external-dependency) 章节中，我们知道可以通过 [`autoExternals`](/api/config/build-config#autoexternal) 和 [`externals`](/api/config/build-config#externals) API 来控制项目是否对第三方依赖打包。
 因此在构建 umd 产物的过程中，我们也可以这样使用：
 
 <CH.Spotlight>
@@ -110,7 +110,7 @@ console.info(React);
 - 在 Node.js 环境下，可以通过 `require('react')` 获取 react 依赖。
 - 在 浏览器环境下，可以通过 `global.react` 获取 react 依赖。
 
-然而在浏览器环境下，获取第三方依赖的时候，**全局变量名称不一定与依赖名称完全相同**，此时就要使用 [`buildConfig.umdGlobals`](/zh/api/build-config#umdglobals) API。
+然而在浏览器环境下，获取第三方依赖的时候，**全局变量名称不一定与依赖名称完全相同**，此时就要使用 [`buildConfig.umdGlobals`](/api/config/build-config#umdglobals) API。
 
 还是使用之前的例子，当 `react` 依赖以 `windows.React` 或者 `global.React` 全局变量的形式存在于浏览器环境下，那么此时：
 
@@ -218,7 +218,7 @@ export default () => {
 });
 ```
 
-如果需要修改它，则需要使用 [`buildConfig.umdModuleName`](/zh/api/build-config#umdmodulename) API。
+如果需要修改它，则需要使用 [`buildConfig.umdModuleName`](/api/config/build-config#umdmodulename) API。
 
 当使用该 API 后：
 

package/docs/zh/guide/advance/copy.md

@@ -8,10 +8,10 @@ sidebar_position: 3
 
 ## 了解 Copy API
 
-我们可以通过 [`buildConfig.copy`](/zh/api/build-config#copy) API 来使用 Copy 工具，它包含以下两个主要配置：
+我们可以通过 [`buildConfig.copy`](/api/config/build-config#copy) API 来使用 Copy 工具，它包含以下两个主要配置：
 
-- [`patterns`](/zh/api/build-config#copypatterns)
-- [`options`](/zh/api/build-config#copyoptions)
+- [`patterns`](/api/config/build-config#copypatterns)
+- [`options`](/api/config/build-config#copyoptions)
 
 在开始学习之前可以先花一些时间了解它们。
 
@@ -34,7 +34,7 @@ export default defineConfig({
 });
 ```
 
-`patterns.context` 一般和 `patterns.from` 配合使用，默认情况下它的值与 [`buildConfig.sourceDir`](/zh/api/build-config#sourcedir) 相同，因此我们可以按照如下方式指定 `src/data.json` 文件为要复制的文件：
+`patterns.context` 一般和 `patterns.from` 配合使用，默认情况下它的值与 [`buildConfig.sourceDir`](/api/config/build-config#sourcedir) 相同，因此我们可以按照如下方式指定 `src/data.json` 文件为要复制的文件：
 
 > 默认情况下，`buildConfig.sourceDir` 为 `src`
 
@@ -70,7 +70,7 @@ export default defineConfig({
 });
 ```
 
-`patterns.to` 用于指定复制文件的输出路径，默认情况下它的值为 [`buildConfig.outDir`](zh/api/build-config#outDir)对应的值。因此我们按照如下方式将 `src/index.html` 复制到 `dist` 目录下：
+`patterns.to` 用于指定复制文件的输出路径，默认情况下它的值为 [`buildConfig.outDir`](/api/config/build-config#outDir)对应的值。因此我们按照如下方式将 `src/index.html` 复制到 `dist` 目录下：
 
 ```ts
 export default defineConfig({

package/docs/zh/guide/advance/external-dependency.mdx

@@ -15,7 +15,7 @@ sidebar_position: 4
 
 而 `"dependencies"` 下的依赖通常来说是和项目代码以及构建相关的，如果这些第三方依赖声明在 `"devDependencies"` 下，那么在生产环境下就会出现缺失依赖的问题。
 
-除了 `"dependencies"` 以外，[`"peerDependencies"`](/zh/guide/basic/before-getting-started#peerdependencies) 也可以声明在生产环境下需要的依赖，不过它更强调项目在运行环境下存在 `"peerDependencies"` 声明的这些依赖，这类似于插件这样的机制。
+除了 `"dependencies"` 以外，[`"peerDependencies"`](/guide/basic/before-getting-started#peerdependencies) 也可以声明在生产环境下需要的依赖，不过它更强调项目在运行环境下存在 `"peerDependencies"` 声明的这些依赖，这类似于插件这样的机制。
 
 ## 第三方依赖的默认处理
 
@@ -81,8 +81,8 @@ console.info(React);
 
 在构建配置中提供了以下 API 来处理第三方依赖：
 
-- [`buildConfig.autoExternal`](/zh/api/build-config#autoexternal)
-- [`buildConfig.externals`](/zh/api/build-config#externals)
+- [`buildConfig.autoExternal`](/api/config/build-config#autoexternal)
+- [`buildConfig.externals`](/api/config/build-config#externals)
 
 ### 关闭默认行为
 

package/docs/zh/guide/advance/in-depth-about-build.md

@@ -9,7 +9,7 @@ sidebar_position: 1
 :::tip{title=注意}
 如果你还不清楚 `buildConfig` 是什么，建议花一些时间通过下面的链接了解一下：
 
-- 【[修改输出产物](/zh/guide/modify-output-product)】
+- 【[修改输出产物](/guide/basic/modify-output-product)】
   :::
 
 而在本章里我们将要深入理解某些构建配置的使用以及了解执行 `modern build` 命令的时候发生了什么。
@@ -24,11 +24,11 @@ sidebar_position: 1
 
 而 Bundleless 则是指对每个源文件单独进行编译构建，但是并不将它们打包在一起。每一个产物文件都可以找到与之相对应的源码文件。**Bundleless 构建的过程，也可以理解为仅对源文件进行代码转换的过程**。
 
-在 `buildConfig` 中可以通过 [`buildConfig.buildType`](/zh/api/build-config#buildtype) 来指定当前构建任务是 Bundle 还是 Bundleless。
+在 `buildConfig` 中可以通过 [`buildConfig.buildType`](/api/config/build-config#buildtype) 来指定当前构建任务是 Bundle 还是 Bundleless。
 
 ### `input` 与 `sourceDir` 的关系
 
-[`buildConfig.input`](/zh/api/build-config#input) 用于指定读取源码的文件路径或者目录路径，其默认值在 Bundle 和 Bundleless 构建过程中有所不同：
+[`buildConfig.input`](/api/config/build-config#input) 用于指定读取源码的文件路径或者目录路径，其默认值在 Bundle 和 Bundleless 构建过程中有所不同：
 
 - 当 `buildType: 'bundle'` 的时候，`input` 默认值为 `['src/index.ts']`
 - 当 `buildType: 'bundleless'` 的时候，`input` 默认值为 `['src']`
@@ -61,7 +61,7 @@ export default defineConfig({
 
 #### `sourceDir`
 
-[`sourceDir`](/zh/api/build-config#sourcedir) 用于指定源码目录，它主要与以下两个内容有关系：
+[`sourceDir`](/api/config/build-config#sourcedir) 用于指定源码目录，它主要与以下两个内容有关系：
 
 - 类型文件生成
 - 指定构建过程中的 [`outbase`](https://esbuild.github.io/api/#outbase)
@@ -73,7 +73,7 @@ export default defineConfig({
 
 ### 类型文件
 
-[`buildConfig.dts`](/zh/api/build-config#dts) 配置主要用于类型文件的生成。
+[`buildConfig.dts`](/api/config/build-config#dts) 配置主要用于类型文件的生成。
 
 #### 关闭类型生成
 
@@ -99,7 +99,7 @@ export default defineConfig({
 
 **模块工程解决方案同时还支持对类型文件进行打包**，不过使用该功能的时候需要注意：
 
-- 一些第三方依赖存在错误的语法会导致打包过程失败。因此对于这种情况，需要手动通过 [`buildConfig.externals`](/zh/api/build-config#externals) 将这类第三方包排除。
+- 一些第三方依赖存在错误的语法会导致打包过程失败。因此对于这种情况，需要手动通过 [`buildConfig.externals`](/api/config/build-config#externals) 将这类第三方包排除。
 - 对于第三方依赖的类型文件指向的是一个 `.ts` 文件的情况，目前无法处理。比如第三方依赖的 `package.json` 中存在这样的内容： `{"types": "./src/index.ts"}`。
 
 #### 别名转换
@@ -165,7 +165,7 @@ export default defineConfig({
 
 ### `buildConfig.define` 不同场景的使用方式
 
-[`buildConfig.define`](/zh/api/build-config#define) 功能有些类似 [`webpack.DefinePlugin`](https://webpack.js.org/plugins/define-plugin/)。这里介绍几个使用场景：
+[`buildConfig.define`](/api/config/build-config#define) 功能有些类似 [`webpack.DefinePlugin`](https://webpack.js.org/plugins/define-plugin/)。这里介绍几个使用场景：
 
 #### 环境变量替换
 

package/docs/zh/guide/advance/in-depth-about-dev-command.md

@@ -9,7 +9,7 @@ sidebar_position: 2
 :::tip{title=注意}
 如果你还不清楚 `buildConfig` 是什么，建议花一些时间通过下面的链接了解一下：
 
-- 【[修改输出产物](/zh/guide/modify-output-product)】
+- 【[修改输出产物](/guide/basic/modify-output-product)】
   :::
 
 而在本章里我们将要深入理解某些构建配置的使用以及了解执行 `modern build` 命令的时候发生了什么。

package/docs/zh/guide/advance/theme-config.mdx

@@ -4,7 +4,7 @@ sidebar_position: 6
 
 # 主题配置
 
-模块工程通过 [`designSystem`](/zh/api/design-system) API，提供了配置主题的能力。
+模块工程通过 [`designSystem`](/api/config/design-system) API，提供了配置主题的能力。
 
 ## 动机和原理
 
@@ -17,7 +17,7 @@ sidebar_position: 6
   - 在 css/less/sass 下通过 `@apply` 自定义指令使用与 tailwindcss 支持的 HTML 类名同名的字符串。
 - css/less/scss: 通过 `designSystem` 生成全局的样式变量。
 
-`designSystem` API 的数据结构借鉴了 `tailwindcss` 配置对象中的 [theme API](https://tailwindcss.com/docs/theme)，因此存在默认的一套 `designToken`。关于默认值，可以查看 [`designSystem` API](/zh/api/design-system)。
+`designSystem` API 的数据结构借鉴了 `tailwindcss` 配置对象中的 [theme API](https://tailwindcss.com/docs/theme)，因此存在默认的一套 `designToken`。关于默认值，可以查看 [`designSystem` API](/api/config/design-system)。
 
 :::info
 目前暂时还未支持 css/less/sass 全局变量。

package/docs/zh/guide/basic/before-getting-started.md

@@ -14,7 +14,7 @@ sidebar_position: 1
 
 npm 是 NodeJS 的标准软件包管理器。它一开始的用途是用于下载和管理 NodeJS 包的依赖关系，但后来它逐渐变成为一个用于前端 JavaScript 的工具。
 
-**如果你已经对 npm 和 npm 包的使用方式有所了解，那么可以直接跳到[【npm 包管理器】](/zh/guide/before-getting-started#npm-包管理器)部分。**
+**如果你已经对 npm 和 npm 包的使用方式有所了解，那么可以直接跳到[【npm 包管理器】](/guide/basic/before-getting-started#npm-包管理器)部分。**
 
 ## npm 包类型项目
 

package/docs/zh/guide/basic/command-preview.md

@@ -26,7 +26,7 @@ Options:
 当想要启动项目构建的时候，可以执行 `modern build` 命令。在使用这个命令的时候，我们可以：
 
 - 当想要以观察模式启动构建时，使用 `--watch` 选项。
-- 当想要指定项目编译读取的 TypeScript 配置文件的路径时，使用 `build --tsconfig ./path/config.json` 选项。使用该选项后，会覆盖所有 [`buildConfig`](/zh/api/build-config) 里 [`dts.tsconfigPath`](/zh/api/build-config) 配置。
+- 当想要指定项目编译读取的 TypeScript 配置文件的路径时，使用 `build --tsconfig ./path/config.json` 选项。使用该选项后，会覆盖所有 [`buildConfig`](/api/config/build-config) 里 [`dts.tsconfigPath`](/api/config/build-config) 配置。
 - 当需要关闭项目的 DTS 类型文件生成和类型检查行为时，可以使用 `--no-dts` 选项。**注意：类型文件的生成依赖类型检查的结果。如果关闭了类型检查，那么类型文件也不会生成**。
 - 当需要关闭自动清除产物输出目录的行为时，可以使用 `--no-clear` 选项。
 
@@ -59,7 +59,7 @@ Options:
 - Tailwind CSS 支持
 - Modern.js Runtime API
 
-关于这些功能，可以通过[【使用微生成器】](/zh/guide/use-micro-generator) 章节了解更多。
+关于这些功能，可以通过[【使用微生成器】](/guide/basic/use-micro-generator) 章节了解更多。
 
 ## `modern dev`