# HTML 模板
## 修改默认模板
新建 `src/pages/document.ejs`，umi 约定如果这个文件存在，会作为默认模板，内容上需要保证有 ``，比如：
```html
Your App
```
## 配置模板
模板里可通过 `context` 来获取到 umi 提供的变量，context 包含：
* `route`，路由对象，包含 path、component 等
* `config`，用户配置信息
* `publicPath`，webpack 的 `output.publicPath` 配置
* `env`，环境变量，值为 development 或 production
* 其他在路由上通过 context 扩展的配置信息
模板基于 ejs 渲染，可以参考 [https://github.com/mde/ejs](https://github.com/mde/ejs) 查看具体使用。
比如输出变量，
```html
```
比如条件判断，
```html
<% if(context.env === 'production') { %>
生产环境
<% } else {%>
开发环境
<% } %>
```
## 针对特定页面指定模板
::: warning
此功能需开启 `exportStatic` 配置，否则只会输出一个 html 文件。
:::
::: tip
优先级是：路由的 document 属性 > src/pages/document.ejs > umi 内置模板
:::
配置路由的 document 属性。
比如约定式路由可通过注释扩展 `document` 属性，路径从项目根目录开始找，
```js
/**
* document: ./src/documents/404.ejs
*/
```
然后这个路由就会以 `./src/documents/404.ejs` 为模板输出 HTML。