Files
mes-ui-d2/docs/zh/guide/README.md
liyang f6e8a3f7f1 Revert "no message"
This reverts commit 123cd5f6c0 [formerly d03a448e1f9fb1201b5cc4162563cbbf434df69c] [formerly 6b0e7ed206e447cf08f8037fed9db5d75b18b43b] [formerly 79f6352eef50b6973b3601e7bc4646ae8c3f7988] [formerly b67c0e35714ad01da86220600238510ee158fdf1] [formerly c2df41dcf3f7be74ae0a847e78c6a4f8760a6fc6] [formerly 2777229531a1b25647bb248e96028760e0c69c8d [formerly 5a9b7a3a7a4e84f79c435c07c99a04ca1161f29c]] [formerly 133c88b24d350206f1a483996a1818e12fc51277] [formerly c8af98adf641fcfb364f1b663e144409e834bc22] [formerly fff6e296313b0d0654de618d9e0b700614ede8cd [formerly fff6e296313b0d0654de618d9e0b700614ede8cd [formerly fff6e296313b0d0654de618d9e0b700614ede8cd [formerly fff6e296313b0d0654de618d9e0b700614ede8cd [formerly db3e8fafcd4bc05820107d71258f09f24de8bd99 [formerly 116bdade3d45a91ec4ef9d0797f1b71e0724b811]]]]]].


Former-commit-id: 936a5bbd167e9a8ee0c56622218ba4a86465b4f4 [formerly f14913ff9c6f3e06b7fa2c20a444848efc67cc81] [formerly 936a5bbd167e9a8ee0c56622218ba4a86465b4f4 [formerly f14913ff9c6f3e06b7fa2c20a444848efc67cc81] [formerly 936a5bbd167e9a8ee0c56622218ba4a86465b4f4 [formerly f14913ff9c6f3e06b7fa2c20a444848efc67cc81] [formerly f14913ff9c6f3e06b7fa2c20a444848efc67cc81 [formerly a886e9ec72c4cd6a808b521946db6a6d4bab9ea0 [formerly a96ce1faa6a0b7dd1ad5473030df2d55a894b15b]]]]]
Former-commit-id: 4c5413c7668920c4f1ed9c4517588bcbb9f31c06
Former-commit-id: cec224589e719fe1d9aaef3c9fa6635baa0a47cb
Former-commit-id: 70eba02320f5775173a5d21d26fdbbf4fc6e97ae [formerly fd24a97eba8ab50a75b01ec4d68393679ba057d5]
Former-commit-id: 77eb4932df386c653df199ebc8f83e3481def194
Former-commit-id: 4e13be4b73525af1f900cec3c517158160c09c7a
Former-commit-id: 41167e8c4cf5f09eaa8386d59b6bfc49d9c036a6
Former-commit-id: c1b8158c56c53bfe09210130786b8786edef2d51
Former-commit-id: 8f6a3479c14495520ff3f211cd60cff2fd4a0e71
2018-06-21 23:54:42 +08:00

167 lines
5.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 介绍
D2Admin 是一个开源的管理系统前端集成方案
[Github仓库](https://github.com/FairyEver/d2-admin) - [预览地址](http://d2admin.fairyever.com/)
<div>
<iframe src="//ghbtns.com/github-btn.html?user=FairyEver&repo=d2-admin&type=star&count=true" allowtransparency="true" frameborder="0" scrolling="0" width="100" height="20"></iframe>
<iframe src="//ghbtns.com/github-btn.html?user=FairyEver&repo=d2-admin&type=fork&count=true" allowtransparency="true" frameborder="0" scrolling="0" width="100" height="20"></iframe>
</div>
::: tip
因为现在集成了很多的插件和组件,首次加载会占用很多的时间,虽然已经做了首屏加载动画,但还是建议您在发布之前一定要删除没有用到的代码,比如项目没有用到图表、示例、插件组件。
:::
D2Admin 是完全开源免费的管理系统集成方案,由 [FairyEver](https://github.com/FairyEver) 在工作之余完全由兴趣驱动完成,如果你也一样喜欢前端开发,欢迎加入我们的讨论/学习群,群内可以`提问答疑``分享学习资料`或者随便扯淡
**QQ群号 806395827 | 微信 liyang1711467488**
::: tip Thanks
D2Admin 创建于2018年1月14日零点51分在2018年5月26日正式发布中间断断续续做了四个多月发布一个月内收获将近 700star在此对支持我的朋友表示感谢D2Admin 将会保持更新,如果你有想法、建议、或者问题欢迎加群讨论
—— 2018年6月20日
:::
## 功能
* 首屏加载等待动画 避免首次加载白屏尴尬
* 简约主题
* 每个插件和组件都配有介绍文档
* 图片资源 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
```
## 使用
首先下载模板 [d2-admin/releases](https://github.com/FairyEver/d2-admin/releases)
::: tip
不要直接克隆本项目,请选择上面已经发行的版本,如果克隆仓库,你将会得到不完全的代码。尤其不要使用 dev 分支
:::
```
// 安装依赖
npm i
// 运行
npm run dev
// 打包
npm run build
```
> 如果上述步骤出现错误,建议您升级 node 版本 > 8如果有其它疑问请参考[常见问题](/zh/guide/question.html)
## 书写文档
这里目前还有一个小遗憾d2admin 使用的 webpack 版本不能符合 vuepress 的要求,所以如果你想在本地启动文档站点的服务,需要按下述步骤
首先将 vuepress 安装到全局
```
npm i -g vuepress
```
启动服务
```
npm run doc:dev
```
::: tip
你可能会发现项目目录中有一个 deploy.sh 文件,这个文件是为了方便发布文档用的,通常你并不需要使用它
:::