dumi主题包开发
通常用于研发完整的主题包,便于共享给其他项目使用
所以创建
@group/dumi-theme-
或dumi-theme-
开头的 npm 包 ,必须以
dumi-theme-
开头 不然dumi 将不会自动挂载该主题
补充主题目录参考dumi-theme-default
本地开发调试
对于独立的主题 npm 包而言,需要将其写入
devDependencies
例如:package.json中引入依赖,
这里我们的主题项目名称为“dumi-theme-cld” 与当前文档项目“dumi-docs”在同一层级
{
"dependencies": {
"dumi-theme-cld": "../dumi-theme-cld"
}
}
dumi-theme-cld 中的 package.json中 name 要与包名一致
{
"name": "dumi-theme-cld",
"version": "0.0.1",
"description": "The official default theme of cld",
}
并且将该 npm 包 link 到项目下,dumi 将会自动挂载该主题,
在”dumi-theme-cld“ 根目录中执行 npm link
初始化“dumi-docs”文档项目
$ npx @umijs/create-dumi-app
# or
$ yarn create @umijs/dumi-app
得到dumi 的静态站点文档项目
在"dumi-docs" 根目录中执行 npm link dumi-theme-cld 关联上主题包
启动项目 npm run start
"scripts": {
"start": "dumi dev",
},
然后开始针对自己的项目更改主题文档
学习链接主题 API - dumi