临文乍了了,彻卷兀若无。这篇文章主要讲述搭建组件库最小原型(支线)相关的知识,希望能为你提供帮助。
写作背景:
上一篇最终因为版本依赖的不一致导致组件文档站点没能编译通过,当时选择了 vuepress@next,这次重新选择了 vuepress@1.x 的版本,但还是存在 webpack 的版本依赖问题,所以还是写一下处理的过程和搭建组件库文档站点的过程。
解决方案:【搭建组件库最小原型(支线)】最终的处理很简单,将对应的包指定版本安装到项目中,去覆盖掉通过依赖树导入的包,最终变更的依赖如下:
文章图片
搭建组件库站点:
- 安装 vuepress 依赖:
yarn add -D vuepress
; - 创建说明文档:
mkdir docs & & echo # Hello VuePress & gt; docs/README.md
; - 配置命令:
"scripts": "docs:dev": "vuepress dev docs", "docs:build": "vuepress build docs"
- 启动服务:
yarn docs:dev
;
docs/.vuepress/dist
配置到忽略的文件列表。增加侧边栏:
- 包含快速启动;
- 包含 Card 组件介绍;
**docs/.vuepress/config.js**
:module.exports =
themeConfig:
sidebar: ["/", "/components/card"],
,
;
- /components/card 是card 组件的介绍页面,文件类型 md,文件位置
docs/components/card.md
; 在 Markdown 中使用Card 组件:
- 新建放置 Card 组件的目录:
docs/.vuepress/components
,默认解析.vue 文件自动注册为全局异步组件; - 将开发完成的 Card 组件连带样式放置到
components
目录,并将样式文件导入到组件中,组件文件名按组件 name 字段调整。 - 组件文档最少包含三项:样式示例、代码示例、属性说明;
- 编写 markdown 需要注意制表符会导致组件渲染失效,需要用空格对代码进行缩进。
其他的配置:
- 编写 markdown 需要注意制表符会导致组件渲染失效,需要用空格对代码进行缩进。
其他的配置:
- 移植组件库的说明文档到站点中,替换一开始创建的 markdown 文件来充当快速入门;
- 为我们的站点添加一个标题到
docs/.vuepress/config.js
。
发布到 Github page: - 调整站点配置的 base 为对应项目:
base:"/it200-ui/"
; - 新建
deploy.sh
发布脚本; - 调整 git push 的命令到 it200-ui 项目下的gh-pages分支;
- 运行
sh deploy.sh
开始打包发布站点;- 推送 github 提示git@github.com: Permission denied (publickey);
- 生成秘钥:
ssh-keygen -t rsa -C zxin088@gmail.com
; - 打开公钥文件并拷贝内容弄;
- 添加公钥到 github的
SSH keys
; 写在最后: deploy.sh 执行完成后我们的站点就已经发布到 github page 上了,我们可以通过IT200-UI 站点来访问看一下效果,至此我们组件库开发的主线和支线任务就圆满完成了,期间有一些内容有省略,参考源码任无法完成的,欢迎留言。
推荐阅读
- vue2.x版本中computed和watch的使用入门详解-watch篇
- Redis lua环境
- [ 链表OJ题--C语言实现 ] 复制带随机指针的链表(带视频讲解哦)
- kettle庖丁解牛第32篇之本地和上游数据量比较后再抽取
- 路由基础之OSPFRouterID及DR和BDR的选举
- NAT网络地址转换
- 基础网络配置
- Docker下的Spring Cloud三部曲之二(细说Spring Cloud开发)
- Flutter 专题109 图解自定义 ACERadio 单选框 #yyds干货盘点#