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

package/zh/guides/topic-detail/generator/codesmith/structure.md

@@ -0,0 +1,86 @@
+---
+sidebar_position: 2
+---
+
+# 微生成器的组成
+
+一个微生成器项目为一个模块项目或者一个 Npm 包，包中包含几个基本部分：
+
+## package.json
+
+npm 包描述信息，包含 name、version、main 等字段。
+
+## 入口文件
+
+上述 main 字段对应的 js 文件。文件为默认导出一个生成器函数，函数格式如下：
+
+```typescript
+export default async (context: GeneratorContext, generator: GeneratorCore) => {
+
+};
+```
+
+该函数参数为 context 和 generator：
+
+### context
+
+context 提供 codesmith 运行时维护的上下文信息。其类型定义为：
+
+```typescript
+interface GeneratorContext {
+  materials: Record<string, FsMaterial>; // 资源
+  config: Record<string, any>; // 用户 config 配置
+  data?: Record<string, any>; // 用户 data 配置
+  current: { material: FsMaterial; } | null; //  当前生成器运行可获取的文件资源
+  [key: string]: any; // 其他补充字段
+}
+```
+
+materials 是 codesmith 的抽象文件系统，维护这生成器名称和可操作文件的映射关系。
+
+materials 中还维护这一个 default 的映射关系，用于维护当前生成器执行目录的资源信息，通过该字段可以对目标项目资源进行操作。
+
+例如当需要修改当前项目的 `package.json` 中的字段:
+
+```typescript
+const resource = context.materials.default.get(path.join(appDir, 'package.json'))
+```
+
+将获取到的 resource 传递给 codesmith 提供的 JSON API 即可实现 json 操作。
+
+GeneratorContext 的 current 字段上维护这当前运行的生成器文件资源，可以通过 `current.material` 获取到当前的 `FsMaterial`.
+
+FsMaterial 中提供了 get 方法用于获取资源文件并将资源文件传给生成器支持的 API 即可对模板文件进行处理。
+
+例如：
+
+```typescript
+const resourceMap = await material.find('templates/**/*');
+```
+
+通过上述方式可以获取到生成器中符合 `templates/**/*` 规则的所有模板文件，遍历该对象即可对资源文件进行操作。
+
+### generator
+
+generator 提供 codesmith 运行时的函数方法。其类型定义为：
+
+```typescript
+interface GeneratorCore {
+    logger: Logger; // log 函数，支持 info、warning、debug、error、verbose、stream
+    outputPath: string; // 输出文件路径
+    output: {
+        fs: (file: string | number, data: any, options?: string | fs.WriteFileOptions | undefined) => Promise<void>
+    }; // 写文件方法
+    runSubGenerator: (subGenerator: string, relativePwdPath?: string | undefined, config?: Record<string, any> | undefined): Promise<void> // 运行子生成器
+}
+```
+
+其中 outputPath 和 context 中的 `materials.default` 指向相同的目录，outputPath 用于直接计算目标路径并操作，`materials.default` 用于获取资源文件。
+
+runSubGenerator 提供了在一个微生成器中去运行其他微生成器的方法，该方法将自动更新和维护新的 context 上下文信息。
+
+## Template 文件
+
+生成器模板文件。
+
+推荐在项目根目录创建一个 templates 目录，用于维护该微生成器的模板文件，微生成器执行过程中只能使用自身的模板文件，对于需要共用的模板文件，建议通过共用子生成器实现。

package/zh/guides/topic-detail/generator/config/mwa.md

@@ -32,7 +32,7 @@ New 命令的操作类型(actionType)，类型支持两种：
 
 - 创建应用入口(entry)
 
-- 新建 Server 自定义源码目(server)
+- 新建自定义 Web Serve 源码目录(server)
 
 这两个选项还需要配置具体的配合使用，介绍如下：
 
@@ -40,11 +40,9 @@ New 命令的操作类型(actionType)，类型支持两种：
 
 入口名称(name), 字符串类型。
 
-创建入口除了`name`之外，还需要 `needModifyMWAConfig`、`clientRoute` 字段。
-
 #### framework
 
-自定义 Server 运行时框架(framework)，支持两个选项：
+自定义 Web Serve 运行时框架(framework)，支持两个选项：
 
 - Express(express)
 
@@ -66,13 +64,11 @@ New 命令的操作类型(actionType)，类型支持两种：
 
 - Storybook(mwa_storybook)
 
-- 部署(deploy)
-
 - 启用「基于 UA 的 Polyfill」功能(polyfill)
 
 - 启用「全局代理」(proxy)
 
-`bff` 和 `deploy` 和还需要配置具体的配合使用，介绍如下：
+`bff` 和还需要配置具体的配合使用，介绍如下：
 
 #### BFF 相关参数
 
@@ -86,7 +82,7 @@ BFF 类型(bffType)，支持两个选项：
 
 ##### framework
 
-扩展 Web Server 运行时框架(framework)，支持两个选项：
+BFF 运行时框架(framework)，支持两个选项：
 
 - Express(express)
 

package/zh/guides/topic-detail/generator/plugin/api/file/addFile.md

@@ -8,7 +8,7 @@ sidebar_position: 4
 
 该方法可用于任何文件类型，对于二进制以外的文件类型，添加文件时会进行 Handlebars 渲染。
 
-该方法可在 onForged 生命周期的 api 参数上获取。
+该方法可在 `onForged` 生命周期的 api 参数上获取。
 
 其类型定义为：
 

package/zh/guides/topic-detail/generator/plugin/api/file/addHelper.md

@@ -6,7 +6,7 @@ sidebar_position: 2
 
 针对于文本类型文件，增加 Handlebars 的自定义 Help 函数，具体可查看文档[Custom Helpers](https://handlebarsjs.com/guide/#custom-helpers)。
 
-该方法可在 onForged 生命周期的 api 参数上获取。
+该方法可在 `onForged` 生命周期的 api 参数上获取。
 
 其类型定义为：
 

package/zh/guides/topic-detail/generator/plugin/api/file/addPartial.md

@@ -6,7 +6,7 @@ sidebar_position: 3
 
 针对于文本类型文件，增加 Handlebars 的自定义 Partial 片段，具体可查看文档[Partials](https://handlebarsjs.com/guide/#partials)。
 
-该方法可在 onForged 生命周期的 api 参数上获取。
+该方法可在 `onForged` 生命周期的 api 参数上获取。
 
 其类型定义为：
 
@@ -19,7 +19,7 @@ export type ForgedAPI = {
 
 ## name
 
-partial名称。
+partial 名称。
 
 ## str
 

package/zh/guides/topic-detail/generator/plugin/api/file/introduce.md

@@ -4,7 +4,7 @@ sidebar_position: 1
 
 # 介绍
 
-文件操作 API 可在 onForged 生命周期函数中使用，可对当前项目文件进行增、删、改的操作。
+文件操作 API 可在 `onForged` 生命周期函数中使用，可对当前项目文件进行增、删、改的操作。
 
 文件操作 API 相关路径填写项目相对路径即可，生成器插件会自动添加当前项目路径前缀。
 

package/zh/guides/topic-detail/generator/plugin/api/file/rmDir.md

@@ -8,7 +8,7 @@ sidebar_position: 10
 
 该方法可用于任何文件类型。
 
-该方法可在 onForged 生命周期的 api 参数上获取。
+该方法可在 `onForged` 生命周期的 api 参数上获取。
 
 其类型定义为：
 

package/zh/guides/topic-detail/generator/plugin/api/file/rmFile.md

@@ -8,7 +8,7 @@ sidebar_position: 9
 
 该方法可用于任何文件类型。
 
-该方法可在 onForged 生命周期的 api 参数上获取。
+该方法可在 `onForged` 生命周期的 api 参数上获取。
 
 其类型定义为：
 

package/zh/guides/topic-detail/generator/plugin/api/file/updateJSONFile.md

@@ -8,7 +8,7 @@ sidebar_position: 6
 
 该方法适用于 JSON 文件类型，可批量更新 JSON 文件中字段值。
 
-该方法可在 onForged 生命周期的 api 参数上获取。
+该方法可在 `onForged` 生命周期的 api 参数上获取。
 
 其类型定义为：
 
@@ -29,7 +29,8 @@ JSON 文件的文件名或者文件路径。
 ## updateInfo
 
 字段更新信息。
-该信息使用 Record 形式表示。
+
+该信息使用 `Record` 形式表示。
 
 例如需要更新 name 字段：
 

package/zh/guides/topic-detail/generator/plugin/api/file/updateModernConfig.md

@@ -6,7 +6,7 @@ sidebar_position: 8
 
 更新 `package.json` 中 `modernConfig` 字段。
 
-该方法可在 onForged 生命周期的 api 参数上获取。
+该方法可在 `onForged` 生命周期的 api 参数上获取。
 
 其类型定义为：
 
@@ -22,5 +22,5 @@ export type ForgedAPI = {
 字段更新信息。
 
 :::info
-该函数为 updateJSONFile 的封装，将自动更新 `package.json` 的 `modernConfig` 字段 updateInfo 中只需填写相对于 `modernConfig` 的更新信息即可。
+该函数为 updateJSONFile 的封装，将自动更新 `package.json` 的 `modernConfig` 字段 `updateInfo` 中只需填写相对于 `modernConfig` 的更新信息即可。
 :::

package/zh/guides/topic-detail/generator/plugin/api/file/updateTextRawFile.md

@@ -8,7 +8,7 @@ sidebar_position: 7
 
 该方法适用与文本列表文件类型。
 
-该方法可在 onForged 生命周期的 api 参数上获取。
+该方法可在 `onForged` 生命周期的 api 参数上获取。
 
 其类型定义为：
 

package/zh/guides/topic-detail/generator/plugin/api/hook/afterForged.md

@@ -4,7 +4,7 @@ sidebar_position: 2
 
 # AfterForged
 
-afterForged 函数为生成器插件生命周期函数，其通常用于定义安装依赖、Git 等操作，专业些操作将会在 onForged 函数执行完成后进行。
+`afterForged` 函数为生成器插件生命周期函数，其通常用于定义安装依赖、Git 等操作，这些操作将会在 `onForged` 函数执行完成后进行。
 
 该方法可直接在 context 上获取。
 
@@ -24,11 +24,11 @@ export interface IPluginContext {
 
 ## func
 
-afterForged 参数是一个回调函数，函数参数为 api 和 inputData。
+`afterForged` 参数是一个回调函数，函数参数为 `api` 和 `inputData。`
 
 ### api
 
-在 afterForged 生命周期中支持的函数列表，具体可查看 [Git API](/docs/guides/topic-detail/generator/plugin/api/git/isInGitRepo) 和 [NPM API](/docs/guides/topic-detail/generator/plugin/api/npm/install)。
+在 `afterForged` 生命周期中支持的函数列表，具体可查看 [Git API](/docs/guides/topic-detail/generator/plugin/api/git/isInGitRepo) 和 [NPM API](/docs/guides/topic-detail/generator/plugin/api/npm/install)。
 
 ### inputData
 

package/zh/guides/topic-detail/generator/plugin/api/hook/onForged.md

@@ -4,7 +4,7 @@ sidebar_position: 1
 
 # OnForged
 
-onForged 函数为生成器插件生命周期函数，其通常用于定义文件类型操作，这些操作将在 base 的工程方案文件操作完成后进行。
+`onForged` 函数为生成器插件生命周期函数，其通常用于定义文件类型操作，这些操作将在 base 的工程方案文件操作完成后进行。
 
 该方法可直接在 context 上获取。
 
@@ -24,11 +24,11 @@ export interface IPluginContext {
 
 ## func
 
-onForged 参数是一个回调函数，函数参数为 api 和 inputData。
+`onForged` 参数是一个回调函数，函数参数为 api 和 inputData。
 
 ### api
 
-在 onForged 生命周期中支持的函数列表，具体可查看[文件操作 API](/docs/guides/topic-detail/generator/plugin/api/file/introduce) 和[启用功能 API](/docs/guides/topic-detail/generator/plugin/api/new/introduce)。
+在 `onForged` 生命周期中支持的函数列表，具体可查看[文件操作 API](/docs/guides/topic-detail/generator/plugin/api/file/introduce) 和[启用功能 API](/docs/guides/topic-detail/generator/plugin/api/new/introduce)。
 
 ### inputData
 

package/zh/guides/topic-detail/generator/plugin/api/input/addInputAfter.md

@@ -35,7 +35,7 @@ context.addInputAfter('packageManager', {
   properties: {
     language: {
       type: 'string',
-      title: i18n.t(localeKeys.plugin_type.self),
+      title: '开发语言',
       enum: [
         { label: 'TS', value: 'ts' },
         { label: 'ES6+', value: 'js' },

package/zh/guides/topic-detail/generator/plugin/api/input/addInputBefore.md

@@ -35,7 +35,7 @@ context.addInputBefore('packageManager', {
   properties: {
     language: {
       type: 'string',
-      title: i18n.t(localeKeys.plugin_type.self),
+      title: '开发语言',
       enum: [
         { label: 'TS', value: 'ts' },
         { label: 'ES6+', value: 'js' },

package/zh/guides/topic-detail/generator/plugin/api/input/type.md

@@ -54,7 +54,7 @@ const schema = {
   properties: {
     language: {
       type: 'string',
-      title: i18n.t(localeKeys.plugin_type.self),
+      title: '开发语言',
       enum: [
         { label: 'TS', value: 'ts' },
         { label: 'ES6+', value: 'js' },

package/zh/guides/topic-detail/generator/plugin/api/new/createElement.md

@@ -6,7 +6,7 @@ sidebar_position: 2
 
 创建工程元素，只支持应用工程方案。
 
-该方法可在 onForged 生命周期的 api 参数上获取。
+该方法可在 `onForged` 生命周期的 api 参数上获取。
 
 其类型定义为：
 

package/zh/guides/topic-detail/generator/plugin/api/new/createSubProject.md

@@ -6,7 +6,7 @@ sidebar_position: 4
 
 创建子项目，只支持 Monorepo 工程方案。
 
-该方法可在 onForged 生命周期的 api 参数上获取。
+该方法可在 `onForged` 生命周期的 api 参数上获取。
 
 其类型定义为：
 

package/zh/guides/topic-detail/generator/plugin/api/new/enableFunc.md

@@ -6,7 +6,7 @@ sidebar_position: 3
 
 启用功能，支持应用和模块工程方案。
 
-该方法可在 onForged 生命周期的 api 参数上获取。
+该方法可在 `onForged` 生命周期的 api 参数上获取。
 
 其类型定义为：
 

package/zh/guides/topic-detail/generator/plugin/api/npm/install.md

@@ -6,7 +6,7 @@ sidebar_position: 1
 
 在项目根目录安装依赖。
 
-install 函数中将根据 packageManager 的值使用对应的包管理工具安装依赖。
+install 函数中将根据 `packageManager` 的值使用对应的包管理工具安装依赖。
 
 ```ts
 export type AfterForgedAPI = {

package/zh/guides/topic-detail/generator/plugin/develop.md

@@ -61,11 +61,15 @@ npx @modern-js/create plugin --plugin @modern-js/generator-plugin-plugin
 在默认的输入前添加输入，比如在`选择包管理工具`问题前添加问题，具体 Modern.js 每个问题的配置可查看[工程方案配置](/docs/guides/topic-detail/generator/config/common)。
 
 ```ts
-context.addInputBefore('packageManager', {
-    key: 'test',
-    name: '测试输入',
-    type: 'input'
-})
+context.addInputBefore('input2', {
+  type: 'object',
+  properties: {
+    'input1.2': {
+      type: 'string',
+      title: 'input1.2',
+    },
+  },
+});
 ```
 
 - setInput
@@ -73,8 +77,8 @@ context.addInputBefore('packageManager', {
 设置已经存在问题的属性
 
 ```ts
-context.setInput('test', 'type', 'radio')
-context.setInput('test', 'options', [{ key: 'option1', name: '选项一' }])
+context.setInput('test', 'type', 'number')
+context.setInput('test', 'enum', [{ value: 'option1', label: '选项一' }])
 ```
 
 ### onForged

package/zh/guides/topic-detail/monorepo/sub-project-interface.md

@@ -22,8 +22,6 @@ sidebar_position: 3
 ? 请填写子项目名称 app
 ? 请填写子项目目录名称 app
 ? 请选择开发语言 TS
-? 是否需要支持以下类型应用 不需要
-? 是否需要调整默认配置? 否
 ```
 
 **「模块（内部）」子项目：**

package/zh/tutorials/first-app/c01-getting-started/1.1-prerequisites.md

@@ -10,11 +10,11 @@ title: 环境准备
 
 ## 1. Node.js
 
-需要 [Node.js LTS](https://github.com/nodejs/Release)，并确保 Node 版本大于等于 14.17.6。
+需要 [Node.js LTS](https://github.com/nodejs/Release)，并确保 Node 版本大于等于 14.19.0, 推荐使用 16.x 版本。
 
 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/erbium` 的 `.nvmrc` 文件，进入这个仓库时就会自动安装或切换到正确的 Node.js 版本。
+然后只要仓库根目录下有内容为 `lts/fermium` 或 `lts/gallium` 的 `.nvmrc` 文件，进入这个仓库时就会自动安装或切换到正确的 Node.js 版本。
 
 ## 2. pnpm
 

package/zh/tutorials/first-app/c02-generator-and-studio/2.1-generator.md

@@ -54,14 +54,6 @@ Modern.js 生成器会通过交互式的问题获取一些必要信息，动态
 # 请选择包管理工具
 ❯ pnpm
   Yarn
-
-# 是否需要支持以下类型应用
-❯ 不需要
-  Electron
-
-# 是否需要调整默认配置
-❯ 否
-  是
 ```
 
 项目生成后，在项目根目录执行 `pnpm run dev` 就可以直接进行调试了：

package/zh/tutorials/first-app/c02-generator-and-studio/2.2-boilerplates.md

@@ -6,18 +6,26 @@ title: 样板文件
 
 ```md
 .
-├── .vscode/
-├── src/
-│   ├── .eslintrc.json
-│   ├── App.css
-│   └── App.jsx
-├── .editorconfig
+├── .eslintrc.js
 ├── .gitignore
+├── .husky
+├── .idea
 ├── .npmrc
 ├── .nvmrc
+├── .prettierrc
+├── .vscode
 ├── README.md
+├── modern.config.ts
 ├── package.json
-└── pnpm-lock.yaml
+├── pnpm-lock.yaml
+├── src
+│   ├── .eslintrc.js
+│   ├── modern-app-env.d.ts
+│   └── routes
+│       ├── index.css
+│       ├── layout.tsx
+│       └── page.tsx
+└── tsconfig.json
 ```
 
 和上一章节手动创建出来的项目一样，仍然是零配置、极简和轻量的，但功能更完整，最佳实践开箱即用，比如：

package/zh/tutorials/first-app/c07-app-entry/7.1-intro.md

@@ -47,7 +47,7 @@ hello-modern 项目是一个应用工程，`src/` 目录里是应用工程源代
 一个应用入口适用于：
 
 - 一个中后台应用（SPA）
-- 一个桌面应用（SPA、Electron App）
+- 一个桌面应用（SPA）
 - 一个PWA
 - 一个大型的多页网站（SPA + SSR）
 - 一个落地页、活动页或分享页

package/zh/tutorials/first-app/c07-app-entry/7.2-add-entry-in-cli.md

@@ -13,14 +13,10 @@ Modern.js 支持自动创建新入口，前面的章节中提到过，`pnpm run
 
 # 创建工程元素
 ❯ 新建「应用入口」
-  新建「Server 自定义」源码目录
+  新建「自定义 Web Serve」源码目录
 
 # 请填写入口名称
 - landing-page
-
-# 是否需要调整默认配置
-❯ 否
-  是
 ```
 
 创建完成，项目会变成这样：

package/zh/tutorials/first-app/c08-client-side-routing/8.2-file-based-routing.md

@@ -91,14 +91,6 @@ ni src/landing-page/pages/docs.tsx
 
 #填写入口名称：
 landing-page
-
-# 是否需要调整默认配置?
-❯ 是
-
-# 请选择客户端路由方式
-  自控路由
-❯ 约定式路由
-  不启用
 ```
 
 假设这个 `landing-page` 入口是一个简单的有导航栏的落地页，包含两个子页面：一个首页和一个文档页，我们用客户端路由的方式来区别这两个子页面。

package/en/docusaurus-plugin-content-docs/current/apis/app/runtime/env.md

@@ -1,72 +0,0 @@
----
-sidebar_position: 1
-title: Environment Variables
----
-
-Modern.js has built-in support for environment variables, including built-in environment variables and custom environment variables.
-
-## Built-in Environment Variables
-
-### NODE_ENV
-
-A **read-only** environment variable, whose have different values under different execution commands:
-
-- `production`: default value when executing `modern build`、`modern preview` commands.
-- `test`: default value when executing `modern test` commands.
-- `development`: default value when executing `modern dev` commands, also the default value in all other cases.
-
-### MODERN_ENV
-
-Used to set the current execution environment.In addition to the values corresponding to the above NODE_ENV, custom environment names are supported here, such as `staging`, `boe`.
-
-Modern.js loads the environment variables values set in the `.env.{process.env.MODERN_ENV}` file for that environment variable.
-
-When you need to use different configurations through the environment name, you can define environment variables in the `.env` file of the corresponding environment name.
-
-MODERN_ENV priority is higher than NODE_ENV.
-
-## Custom Environment Variables
-
-Modern.js support custom environment variables, which starting with MODERN_ can be used directly in the code.
-
-If you need to automatically use environment variables with any name, you need to declare them in the ['source.define'](/docs/configure/app/source/define) configuration.
-
-## Define Environment Variables
-
-Environment variables are specified in both `shell` and `.env` files.
-
-### Specify Via Shell
-
-Add custom environment variables before the command:
-
-```shell
-REACT_APP_FOO=123 BAR=456 pnpm run dev
-```
-
-### Specify Via File
-
-Create a `.env` file in the project with custom environment variables:
-
-```env
-REACT_APP_FOO=123
-BAR=456
-```
-
-`.env` files support suffixes NODE_ENV or MODERN_ENV defined environment names, such as `env.development`. Modern.js reads the env file based on the environment name variable value.
-
-## Using Environment Variables
-
-### Use In JS
-
-Get environment variables directly with `process.env.*`.
-
-```js
-console.log(process.env.NODE_ENV);
-// "development"
-```
-
-### Use In HTML
-
-```html title="config/html/head.ejs"
-<meta name="env" content="<%=process.env.NODE_ENV %>" />
-```

package/zh/apis/app/runtime/env.md

@@ -1,70 +0,0 @@
----
-sidebar_position: 1
-title: 环境变量
----
-
-Modern.js 内置了对环境变量的支持，包含内置的环境变量和自定义的环境变量。
-
-## 内置的环境变量
-
-### NODE_ENV
-
-表示当前的执行环境，是**只读的**的环境变量，其值在不同的执行命令下具有不同的值：
-
-- `production`：执行 `modern build`、`modern preview` 命令时的默认值。
-- `test`：执行 `modern test` 命令时的默认值。
-- `development`：执行 `modern dev` 命令时的默认值，同时也是其他所有情况下的默认值。
-
-### MODERN_ENV
-
-用于设置当前的执行环境，除了上述 NODE_ENV 对应的值之外，这里支持自定义环境名称，比如 `staging`、`boe` 等，Modern.js 会根据该环境变量对应的加载 env.{process.env.MODERN_ENV} 文件中设置的环境变量值。
-
-当需要通过环境名称使用不同的配置时，可以把环境变量定义到对应的环境名称的 env 文件中。
-
-MODERN_ENV 的优先级高于 NODE_ENV。
-
-## 自定义环境变量
-
-Modern.js 支持自定义的环境变量，以 `MODERN_` 开头的环境变量可以在代码中直接使用。
-
-如果需要自动以任意名称的环境变量，需要在 [`source.define`](/docs/configure/app/source/define) 配置中声明后使用。
-
-## 定义环境变量
-
-环境变量支持通过 `shell` 和 `.env` 文件两种方式指定。
-
-### 通过 `shell` 指定
-
-在命令前添加自定义环境变量：
-
-```shell
-REACT_APP_FOO=123 BAR=456 pnpm run dev
-```
-
-### 通过 `.env` 文件指定
-
-在项目根目录创建 `.env` 文件，其中添加自定义环境变量：
-
-```env
-REACT_APP_FOO=123
-BAR=456
-```
-
-.env 文件支持后缀名后 NODE_ENV 或 MODERN_ENV 定义的环境名称，如 `.env.development`，可根据项目需求进行定义。Modern.js 会根据环境名称变量值读取对应的 env 文件。
-
-## 使用环境变量
-
-### JS/TS 代码内使用
-
-通过 `process.env.*` 直接获取环境变量。
-
-```js
-console.log(process.env.NODE_ENV);
-// "development"
-```
-
-### HTML 代码片段使用
-
-```html title="config/html/head.ejs"
-<meta name="env" content="<%=process.env.NODE_ENV %>" />
-```