前言

大家好，本次项目将通过仿照dumi来学习umi插件开发，dumi是基于umi实现的组件开发及组件文档生成框架。大家熟悉的ant-design就是基于dumi来生成文档站点。

本次学习将围绕dumi静态站点生成功能插件，通过从0开始构建项目，自己实现一个简易的文档生成框架。在学习过程中即可以探究dumi的实现原理，也能学习到umi插件的具体实用场景。

基础环境搭建

本次项目项目名称就叫domi，先找个地方创建一个目录

mkdir domi && cd domi

使用pnpm创建umi项目（如果喜欢用npm/yarn可以根据umi官网 - 快速上手提示来创建项目）

pnpm dlx create-umi@latest

接下来选择项目模板，我这边使用如下配置：

等待安装完成，运行即可启动umi项目

pnpm dev

.umirc.ts是umi项目的配置文件，加载插件将在这里配置。

运行项目后可在浏览器看到上图界面，默认的页面分为两大部分，layout布局和page页面。

umi是通过约定的形式自动生成路由，因此我们项目代码可以免去配置路由信息，通过按约定规则直接写代码文件，即可自动生成路由和页面，默认页面对应的项目代码结构如下所示：

我们开发文档生成框架主要是用markdown来写文档说明，但是直接把markdown文件放在pages目录下是不会被解析成路由的。因此我们将在此基础上，通过开发插件来扩展umi的功能特性，使其能加载markdown并自动生成路由和页面。

目前需要了解的umi知识就这些，如果有兴趣可以在UmiJS - 插件化的企业级前端应用框架来学习umi的其他知识。