Skip to content

Commit

Permalink
add EN translation for how-umi-works (umijs#4051)
Browse files Browse the repository at this point in the history
  • Loading branch information
kristianmandrup authored Mar 3, 2020
1 parent edb2e78 commit fde6074
Showing 1 changed file with 16 additions and 17 deletions.
33 changes: 16 additions & 17 deletions docs/docs/how-umi-works.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,39 +4,38 @@ translateHelp: true

# How Umi Works

The thoughts and important concepts behind Umi.

写写 Umi 背后的思考和重要概念。

## 技术收敛
## Technology convergence

<img src="https://img.alicdn.com/tfs/TB1hE8ywrr1gK0jSZFDXXb9yVXa-1227-620.png" width="600">

这张图是给内部框架 Bigfish 画的,套到 Umi 上同样合适。他把大家常用的技术栈进行整理,收敛到一起,让大家只用 Umi 就可以完整 80% 的日常工作。
This picture is for Bigfish, the internal frame, and it is also suitable for Umi. He sorted out the technology stacks that everyone commonly uses, and converged them together, so that everyone can use Umi to complete 80% of their daily work.

## 插件和插件集
## Plugins and plugin sets

<img src="https://img.alicdn.com/tfs/TB1mrhuwqL7gK0jSZFBXXXZZpXa-956-728.png" width="400">

Umi 支持插件和插件集,通过这张图应该很好理解到他们的关系,通过插件集我们把插件收敛依赖然后支持不同的业务类型。
Umi supports plug-ins and plug-in sets. The relationship between them should be well understood through this picture. Through plug-in sets, we rely on plug-in convergence and support different business types.

## 配置式路由和约定式路由
## Configurational routing and contractual routing

Umi 的路由既支持配置式,又支持约定式。配置式是对于现实的低头,也是大部分用户在用的,因为他功能强大;约定式是我们希望走去的方向,因为他简洁优雅。
Umi's routing supports both configuration and convention. The configuration style is a bow to reality, which is also used by most users because it is powerful; the convention style is the direction we want to go because it is simple and elegant.

## .umi 临时文件
## .umi

.umi 临时目录是整个 Umi 项目的发动机,你的入口文件、路由等等都在这里,这些是由 umi 内部插件及三方插件生成的。
The `.umi` temporary directory is the engine of the entire Umi project. Your entry files, routes, etc. are all here. These are generated by umi's internal plug-ins and third-party plug-ins.

你通常会在 .umi 下看到以下目录,
You usually see the following directories under `.umi`

```bash
+ .umi
+ core # 内部插件生成
+ pluginA # 外部插件生成
+ presetB # 外部插件生成
+ umi.ts # 入口文件
+ core # umi core
+ pluginA # plugin A
+ presetB # preset B
+ umi.ts # main umi file
```

临时文件是 Umi 框架中非常重要的一部分,框架或插件会根据你的代码生成临时文件,这些原来需要放在项目里的脏乱差的部分都被藏在了这里。
Temporary files are a very important part of the Umi framework. The framework or plugin will generate temporary files according to your code. These dirty and messy parts that need to be placed in the project are hidden here.

你可以在这里调试代码,但不要在 .git 仓库里提交他,因为他的临时性,每次启动 umi 时都会被删除并重新生成。
You can debug the code here, but don't commit him in the `.git` repository, because it is temporary, it will be deleted and regenerated every time you start umi.

0 comments on commit fde6074

Please sign in to comment.