diff --git a/docs/.vuepress/config.js b/docs/.vuepress/config.js index e69f8c86..4709f560 100644 --- a/docs/.vuepress/config.js +++ b/docs/.vuepress/config.js @@ -44,6 +44,7 @@ module.exports = { { text: '指南', link: '/zh/guide/' }, { text: '插件', link: '/zh/plugins/' }, { text: '组件', link: '/zh/components/' }, + { text: '文章', link: '/zh/article/' }, { text: '其它', link: '/zh/others/' }, { text: '预览', link: 'https://fairyever.gitee.io/d2-admin-preview/#/index' } ], @@ -51,6 +52,7 @@ module.exports = { '/zh/guide/': sideBarGuide('指南'), '/zh/plugins/': sideBarPlugins('插件'), '/zh/components/': sideBarComponents('组件'), + '/zh/article/': sideBarArticle('文章'), '/zh/others/': sideBarOthers('其它') } } @@ -104,6 +106,20 @@ function sideBarComponents (title) { ] } +function sideBarArticle (title) { + return [ + { + title, + collapsable: false, + children: [ + '', + 'update/1.1.4', + 'update/0.0.0' + ] + } + ] +} + function sideBarOthers (title) { return [ { diff --git a/docs/zh/article/README.md b/docs/zh/article/README.md new file mode 100644 index 00000000..bc1a7c42 --- /dev/null +++ b/docs/zh/article/README.md @@ -0,0 +1,3 @@ +# 文章 + +这个章节下收录关于 D2Admin 的一些介绍，用法，以及每次发布新版本时的推广文章，也是每篇新文章的首发地址。 \ No newline at end of file diff --git a/docs/zh/article/update/0.0.0.md b/docs/zh/article/update/0.0.0.md new file mode 100644 index 00000000..40a0747b --- /dev/null +++ b/docs/zh/article/update/0.0.0.md @@ -0,0 +1,123 @@ +# 公布项目 + +![github-banner](http://fairyever.qiniudn.com/github-banner.png) + +# 介绍 + +D2Admin 是一个开源的管理系统前端集成方案 + +[Github仓库](https://github.com/d2-projects/d2-admin) - [预览地址](https://fairyever.gitee.io/d2-admin-preview/#/index) - [中文文档](https://fairyever.gitee.io/d2-admin-doc/zh/) + +D2Admin 是完全开源免费的管理系统集成方案，由 [FairyEver](https://github.com/FairyEver) 在工作之余完全由兴趣驱动完成，如果你也一样喜欢前端开发，欢迎加入我们的讨论/学习群，群内可以`提问答疑`，`分享学习资料`或者随便扯淡 + +**QQ群** + +群号 806395827 欢迎大家 + +**微信群** + +作者微信 liyang1711467488 + +> 微信群需要先加群主才可以拉进群 + +## 功能 + +* 首屏加载等待动画 避免首次加载白屏尴尬 +* 简约主题 +* 每个插件和组件都配有介绍文档 +* 图片资源 sketch 源文件（ 可以在这个文件内重新生成所有图片资源 ） +* 登陆和注销 +* 根据路由自动生成菜单 +* 可折叠侧边栏 +* 方便的菜单设置 +* 多国语言支持 +* 富文本编辑器 +* Markdown 编辑器 +* 全屏功能 +* Fontawesome 图标库 +* 图标选择器（组件） +* 自动引入下载的 SVG 图标 +* 前端假数据支持（ mock ） +* 集成蚂蚁金服出品的 G2 图表 +* 图表自适应可拖拽大小的卡片容器（示例） +* 简化剪贴板操作 +* 简化Cookie操作 +* 时间日期计算工具 +* 导入 Excel （ xlsx 格式 + csv 格式 ） +* 数据导出 Excel （ xlsx 格式 + csv 格式 ） +* 数据导出文本 +* 数字动画 +* 可拖拽调整大小的切分布局 +* 可拖拽调整大小和位置的网格布局 +* 提供三种方便的页面容器组件（正常卡片，隐形容器，填满页面） +* 代码高亮显示 +* 加载并解析（或者直接指定资源） markdown 文件 +* GitHub 样式的 markdown 显示组件 +* markdown 内代码高亮 +* 为 markdown 扩展了百度云链接解析和优化显示 +* 右键菜单组件 +* 自定义滚动条和滚动控制 +* 内置4种主题 +* 公用样式抽离，方便的主题定制 +* 支持百万级数据量的表格组件 +* 打包后随意目录部署（已经做好兼容设置） + +## TODO + +D2Admin 仍然处于开发中，这里有一些计划： + +* 分离出简化版本 +* 推出基于 [ice](https://alibaba.github.io/ice) 平台的版本 +* 增加右上角通知中心 +* 增加一些实例页面以提供业务页面布局建议 +* 更换图表库 +* 多 tab 页结构 +* 面包屑导航 +* 树型表格组件 +* `1.1.0 完成` 抽离项目里的文档，集中存放在文档站点 +* `1.1.0 完成` 对主界面进行一次完善，调整整体布局和颜色 +* `1.1.0 完成` 切换主题功能 + +欢迎你为 D2Admin 的开发作出贡献（代码编写/文档翻译）。 + +## 目录结构 + +``` +├─ build +├─ config +├─ docs // 文档 +├─ src +│ ├─ assets // 资源 +│ │ ├─ icons +│ │ ├─ image +│ │ ├─ library +│ │ └─ style +│ ├─ components // 组件 +│ │ ├─ charts +│ │ ├─ core +│ │ └─ demo +│ ├─ i18n // 多国语 +│ ├─ menu // 菜单 +│ ├─ mock // 模拟数据 +│ ├─ pages // 页面 +│ ├─ plugin // 插件 +│ ├─ router // 路由 +│ ├─ store // vuex +│ ├─ utils +│ ├─ App.vue +│ └─ main.js +├─ static // 静态资源 +├─ .babelrc +├─ .editorconfig +├─ .eslintignore +├─ .eslintrc.js +├─ .gitattributes +├─ .gitignore +├─ .postcssrc.js +├─ LICENSE +├─ README.md +├─ deploy.sh +├─ design.sketch // 设计文件 +├─ index.html +└─ package.json +``` \ No newline at end of file diff --git a/docs/zh/article/update/1.1.4.md b/docs/zh/article/update/1.1.4.md new file mode 100644 index 00000000..2a902894 --- /dev/null +++ b/docs/zh/article/update/1.1.4.md @@ -0,0 +1,208 @@ +# 版本发布 1.1.4 + +![github-banner](http://fairyever.qiniudn.com/github-banner.png) + +D2Admin 是一个 **注重外观表现** 的管理系统 **PC端** 集成方案，现在正在紧张开发维护。 + +## 前言 + +距离 D2Admin 正式和大家见面(开源)，已经过去一个多月了。 + +![Snip20180703_4](http://fairyever.qiniudn.com/Snip20180703_4.png) + +现在想想这一个月真是很忙碌，几乎所有的业余时间都用在了开源项目上，公司没事的时候在写，晚上回家每天都要写到一点左右，回家火车上都在忙着改代码... + +![Snip20180703_5-squashed](http://fairyever.qiniudn.com/Snip20180703_5-squashed.jpg) + +上图：好友不幸骨折，守着他编码...（希望他早点康复） + +有天我和朋友说，感觉真是开源个项目，把自己整个人都开源了，一个人又要设计又要写代码又要写文档还要回答问题，除了上班吃睡就都是它了！ + +但是就我个人而言，我感觉倒也是一种不错的体验。 + +通过这个开源产品，认识了很多朋友，有了自己的小交流群，平日没事了大家一起讨论讨论问题也挺不错。当然也新认识了一些大佬（膜拜），通过交流也有不小的收获。 + +## 介绍 + +废话不多说了，一介码农也没有什么文采，今天也是趁着发版的机会小发表一些想法，下面就介绍一下这一个月来究竟升级了什么吧，先放几张截图吧： + +### 预览 + +经典主题: +![Snip20180703_6-squashed](http://fairyever.qiniudn.com/Snip20180703_6-squashed.png) + +集成组件和插件: +![Snip20180703_7-squashed](http://fairyever.qiniudn.com/Snip20180703_7-squashed.png) + +图标选择器: +![Snip20180703_8-squashed](http://fairyever.qiniudn.com/Snip20180703_8-squashed.png) + +版本检查: +![Snip20180703_10-squashed](http://fairyever.qiniudn.com/Snip20180703_10-squashed.png) + +灰度模式: +![Snip20180703_11-squashed](http://fairyever.qiniudn.com/Snip20180703_11-squashed.png) +![Snip20180704_9](http://fairyever.qiniudn.com/Snip20180704_9.png) +![Snip20180705_1](http://fairyever.qiniudn.com/Snip20180705_1.png) + +数据持久化: +![Snip20180703_12-squashed](http://fairyever.qiniudn.com/Snip20180703_12-squashed.png) + +图表: +![Snip20180703_13-squashed](http://fairyever.qiniudn.com/Snip20180703_13-squashed.png) + +主题: +![Snip20180703_14-squashed](http://fairyever.qiniudn.com/Snip20180703_14-squashed.png) + +响应大家需求，这次最大的升级：多标签页: +![Snip20180703_15](http://fairyever.qiniudn.com/Snip20180703_15.png) + +上面是我随便截了几张图片 如果你感兴趣的话可以去体验地址一趟 -> [体验地址](https://fairyever.gitee.io/d2-admin-preview/#/index) <-。 + +项目现在集成了不少的库和插件，第一次加载确实有些慢，以后有空了优化一下。 + +另外大家实际使用的时候建议使用 [简化版模板](https://github.com/d2-projects/d2-admin-start-kit)。 + +### 完整功能列表 + +* 首屏加载等待动画 避免首次加载白屏尴尬 +* 简约主题 +* 每个插件和组件都配有介绍文档 +* 图片资源 sketch 源文件（ 可以在这个文件内重新生成所有图片资源 ） +* 登陆和注销 +* 根据路由自动生成菜单 +* 可折叠侧边栏 +* 方便的菜单设置 +* 多国语言支持 +* 富文本编辑器 +* Markdown 编辑器 +* 全屏功能 +* Fontawesome 图标库 +* 图标选择器（组件） +* 自动引入下载的 SVG 图标 +* 前端假数据支持（ mock ） +* 集成蚂蚁金服出品的 G2 图表 +* 图表自适应可拖拽大小的卡片容器（示例） +* 简化剪贴板操作 +* 简化Cookie操作 +* 时间日期计算工具 +* 导入 Excel （ xlsx 格式 + csv 格式 ） +* 数据导出 Excel （ xlsx 格式 + csv 格式 ） +* 数据导出文本 +* 数字动画 +* 可拖拽调整大小的切分布局 +* 可拖拽调整大小和位置的网格布局 +* 提供三种方便的页面容器组件（正常卡片，隐形容器，填满页面） +* 代码高亮显示 +* 加载并解析（或者直接指定资源） markdown 文件 +* GitHub 样式的 markdown 显示组件 +* markdown 内代码高亮 +* 为 markdown 扩展了百度云链接解析和优化显示 +* 右键菜单组件 +* 自定义滚动条和滚动控制 +* 内置5种主题 +* 公用样式抽离，方便的主题定制 +* 支持百万级数据量的表格组件 +* 打包后随意目录部署（已经做好兼容设置） +* 支持临时菜单配置 +* 提供“试验台”功能 方便展示系统功能调用方法 `1.1.4 +` +* 多标签页模式 `1.1.4 +` +* 美化滚动条 `1.1.4 +` +* 持久化存储 `1.1.4 +` + +### 更新列表 + +这个列表在这里也可以查看 -> [中文文档 | 更新日志](https://fairyever.gitee.io/d2-admin-doc/zh/guide/change-log.html#v1-1-0) + +#### 1.1.4 + +* [ 修改 ] 全局状态管理设计优化 +* [ 修改 ] 主题调优 +* [ 新增 ] playground 模块，方便测试和展示一些功能实现方式/调用方法 +* [ 新增 ] 灰度模式 +* [ 新增 ] 多页模式 +* [ 新增 ] 多页模式缓存 +* [ 新增 ] 多页模式快速关闭（关闭左侧 右侧 全部 其它） +* [ 修改 ] 侧边栏滚动优化 +* [ 新增 ] `d2-container` 填充模式自定义滚动条 +* [ 新增 ] `d2-container` 组件卡片和隐形模式自定义滚动条 +* [ 新增 ] 现在页面标题可以根据路由做出对应变化了 +* [ 新增 ] 版本检查机制 +* [ 新增 ] `d2-container` 隐形模式支持 header 插槽 +* [ 新增 ] 版本检查可以设置为不显示提示框 +* [ 新增 ] 集成 json 查看组件 +* [ 新增 ] 添加了所有图表种类的演示页面 +* [ 修改 ] 修改布局方式，解决了在 Firefox 上 better-scroll 初始化拿不到正确高度的 bug +* [ 新增 ] 右上角显示用户名，用户名持久存储 + +#### 1.1.3 + +* [ 修复 ] 侧边栏在折叠时不显示的 bug +* [ 新增 ] v-charts 插件 +* [ 新增 ] 一些演示图表（后续打算把 v-charts 文档上有示例性的演示都展示一下） +* [ 修改 ] D2Admin 经典主题颜色调整 +* [ 新增 ] violet 主题 +* [ 新增 ] 菜单图标 +* [ 修改 ] 新制作了 Fork me 图片 + +#### 1.1.2 + +* [ 修改 ] 删除了 G2 相关的依赖 + +#### 1.1.1 + +* [ 修改 ] 删除了 G2 相关的代码（移除图表库） +* [ 优化 ] 侧边栏取值逻辑 + +#### 1.1.0 + +* [ 修改 ] 顶栏和侧边栏菜单新的结构生成方式，新的方案使用 数据 + 递归组件 实现无限制多级菜单 +* [ 修改 ] 路由注册回归最简单的写法 +* [ 修复 ] 首次加载 loading 样式类名和程序内类名冲突，新的加载类名使用 d2-app-loading 前缀 +* [ 修改 ] 所有类似 dd- 的样式前缀(包括自动注册图标的id前缀)统一改为 d2- +* [ 修复 ] 修复 d2-highlight 组件和 d2-markdown 组件的样式冲突 +* [ 修改 ] 内置组件名称统一改为 d2- 前缀，统一使用横线连接 (kebab-case) 风格 +* [ 修改 ] 顶栏 logo 阴影删除 +* [ 新增 ] 主题系统 +* [ 新增 ] 三个主题，分别为 d2admin 经典，简约线条，流星 +* [ 修改 ] d2-markdown 组件 md 参数改名为 source +* [ 修改 ] 删除了 d2-markdown 组件中图片的白色背景 +* [ 修改 ] 删除 timeago 插件，更换为更强大的 dayjs +* [ 新增 ] Tomorrow Night Blue 主题 +* [ 修改 ] src/assets/style/public-class.scss 写法优化 +* [ 新增 ] [vue-bigdata-table](https://github.com/lison16/vue-bigdata-table)组件 +* [ 修复 ] 侧边栏内容超过一屏后显示错误 +* [ 新增 ] 自定义滚动条演示页面 +* [ 新增 ] 流星主题新增背景图片上层的半透明遮罩 +* [ 修复 ] 主题设置失效bug +* [ 修复 ] router守卫验证登陆部分代码修改 +* [ 修复 ] d2-container 组件改为同步注册（之前的异步注册会有 mounted 生命周期问题，即 slot 内的页面在 mounted 生命周期内拿不到 dom） +* [ 修复 ] d2-container 组件重构 flex 布局 +* [ 新增 ] 404 page +* [ 新增 ] 顶栏联系方式 +* [ 新增 ] 右键菜单组件 +* [ 新增 ] 菜单配置支持空菜单（项目开发的时候有可能需要先把菜单做好查看效果） +* [ 优化 ] 页面左侧菜单滚动条优化 +* [ 修复 ] CSS 边距工具类都加上了 `!important` 来保证在覆盖样式时生效 +* [ 修复 ] IE11 兼容性修复 + +写这篇文章的时候心情竟然出奇地平静，终于发新版了，总算松了一口气... + +### 下阶段的计划： + +* ice 版本 +* bug 修复 + +## 项目地址 + +| 地址 | 描述 | +| --- | --- | +| [团队主页](https://github.com/d2-projects) | D2Admin 所属的团队主页 | +| [中文文档](http://d2admin.fairyever.com/zh/) | 中文文档 | +| [预览地址](https://fairyever.gitee.io/d2-admin-preview/#/index) | 预览地址 | +| [github](https://github.com/d2-projects/d2-admin) | Github 仓库 | +| [码云](https://gitee.com/fairyever/d2-admin) | 码云镜像仓库 | +| [简化版 github](https://github.com/d2-projects/d2-admin-start-kit) | 简化版 Github 仓库 | +| [简化版 码云](https://gitee.com/fairyever/d2-admin-start-kit) | 简化版码云镜像仓库 | + +在最后，如果你看完了，并且觉得不错，希望可以到 [项目主页](https://github.com/d2-projects/d2-admin) 上点一个 **star** 作为你对这个项目的认可与支持，谢谢。 \ No newline at end of file