docs: 如何将 father 2 中内置的 docz 切换为 dumi 做组件库研发？ #241
Description
前言
dumi 是基于 Umi 的 React 组件库研发工具，能够提供开箱即用、顺滑流畅的组件研发体验，可和 father-build 一起搭配使用。
下个版本的 father 将会使用 dumi 作为内置文档工具。
迁移步骤
1. 更新依赖
移除无用的 father 依赖，改为 father-build 和 dumi：
{
"devDependencies": {
- "father": "^2.29.6",
+ "father-build": "^1.18.2",
+ "dumi": "^1.0.34"
}
}2. 更新启动脚本
{
"scripts": {
- "dev": "father doc dev",
+ "dev": "dumi dev",
- "build": "father build",
+ "build": "father-build"
}
}3. 移除 .fatherrc 中的无用配置
export default {
- doc: { /* 文档配置 */ },
}4. 替换文档写法
修改 .mdx 为 .md，并将 Playground 或者 JSX 替换为代码块：
- import Foo from './';
- import Playground from 'docz';
# Foo
- <Playground><Foo>Hi father!</Foo></Playgrond>
+ ```jsx
+ import React from 'react';
+ import { Foo } from 'my-library'; // package.name 的配置值
+
+ export default () => Hi father!;
+ ```5. 替换文档配置
检查 .md 文档中顶部的 frontmatter 配置项，替换为 dumi 的配置项，例如：
- menu: A
+ group:
+ title: A以上，大功告成，执行 npm run dev 开始全新的组件库研发体验。
如果遇到问题请直接在下方反馈。