From 03b708870bcef45c19f8eaa4ad5283f8b910e17e Mon Sep 17 00:00:00 2001 From: Pan <panfree23@gmail.com> Date: Mon, 25 Jun 2018 14:54:02 +0800 Subject: [PATCH] update doc --- README.md | 106 ++++++++++++++--------- README.zh-CN.md | 99 +++++++++++++-------- src/router/index.js | 2 +- src/views/components-demo/tinymce.vue | 2 +- src/views/documentation/index.vue | 2 +- src/views/errorLog/index.vue | 2 +- src/views/example/components/Warning.vue | 2 +- src/views/svg-icons/index.vue | 2 +- src/views/theme/index.vue | 2 +- 9 files changed, 133 insertions(+), 86 deletions(-) diff --git a/README.md b/README.md index 5a931f37..72d36536 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ <img src="https://img.shields.io/badge/vue-2.5.10-brightgreen.svg" alt="vue"> </a> <a href="https://github.com/ElemeFE/element"> - <img src="https://img.shields.io/badge/element--ui-2.3.0-brightgreen.svg" alt="element-ui"> + <img src="https://img.shields.io/badge/element--ui-2.3.2-brightgreen.svg" alt="element-ui"> </a> <a href="https://travis-ci.org/PanJiaChen/vue-element-admin" rel="nofollow"> <img src="https://travis-ci.org/PanJiaChen/vue-element-admin.svg?branch=master" alt="Build Status"> @@ -24,33 +24,34 @@ English | [简体ä¸æ–‡](./README.zh-CN.md) ## Introduction -`vue-element-admin` is a production-ready solution for admin interfaces. Based on [Vue.js](https://github.com/vuejs/vue) and use the UI Toolkit -- [element](https://github.com/ElemeFE/element). `vue-element-admin` is a magical vue admin, it based on the newest development stack of vue, built-in i18n solution, typical templates for enterprise applications, lots of awesome features. It helps you build a large complex Single-Page Applications. I believe whatever your needs are, this project will help you. +[vue-element-admin](http://panjiachen.github.io/vue-element-admin) is a front-end management background integration solution based on [vue](https://github.com/vuejs/vue) and use the UI Toolkit -- [element](https://github.com/ElemeFE/element). + +It is a magical vue admin. It based on the newest development stack of vue, built-in i18n solution, typical templates for enterprise applications, lots of awesome features. It helps you build a large complex Single-Page Applications. I believe whatever your needs are, this project will help you. - [Preview](http://panjiachen.github.io/vue-element-admin) -- [Documentation](https://panjiachen.github.io/vue-element-admin-site/#/) +- [Documentation](https://panjiachen.github.io/vue-element-admin-site/) - [Gitter](https://gitter.im/vue-element-admin/discuss) - [Wiki](https://github.com/PanJiaChen/vue-element-admin/wiki) -- [Donate](https://panjiachen.github.io/vue-element-admin-site/#/donate) +- [Donate](https://panjiachen.github.io/vue-element-admin-site/donate/) -**vue-element-admin is an admin interfaces integration solution, which is not suitable for secondary development as a base template.** +**This project is positioned as a background integration solution and is not suitable for secondary development as a basic template.** - Base template recommends using: [vueAdmin-template](https://github.com/PanJiaChen/vueAdmin-template)  - Desktop: [electron-vue-admin](https://github.com/PanJiaChen/electron-vue-admin) -**Note: This project uses element-ui@2.3.0+ version, so the minimum compatible vue@2.5.0+** - ## Preparation -You need to install [node](http://nodejs.org/) and [git](https://git-scm.com/) locally. The project is based on [ES2015+](http://es6.ruanyifeng.com/), [vue](https://cn.vuejs.org/index.html), [vuex](https://vuex.vuejs.org/zh-cn/), [vue-router](https://router.vuejs.org/zh-cn/) and [element-ui](https://github.com/ElemeFE/element). All data requests for this project are simulated using [Mock.js](https://github.com/nuysoft/Mock). It would be helpful if you have pre-existing knowledge on those. - - **This project is not a scaffolding and is more of an integrated solution.** +You need to install [node](http://nodejs.org/) and [git](https://git-scm.com/) locally. The project is based on [ES2015+](http://es6.ruanyifeng.com/), [vue](https://cn.vuejs.org/index.html), [vuex](https://vuex.vuejs.org/zh-cn/), [vue-router](https://router.vuejs.org/zh-cn/), [axios](https://github.com/axios/axios) and [element-ui](https://github.com/ElemeFE/element), all request data is simulated using [Mock.js](https://github.com/nuysoft/Mock). + Understanding and learning this knowledge in advance will greatly help the use of this project. **This project does not support low version browsers (e.g. IE). Please add polyfill yourself if you need them.** + **Note: This project uses element-ui@2.3.0+ version, so the minimum compatible vue@2.5.0+** + <p align="center"> <img width="900" src="https://wpimg.wallstcn.com/a5894c1b-f6af-456e-82df-1151da0839bf.png"> </p> @@ -58,41 +59,64 @@ You need to install [node](http://nodejs.org/) and [git](https://git-scm.com/) l ## Features ``` - Login / Logout -- Permission authentication + +- Permission Authentication + - Page permission + - Directive permission + - Two-step login + - Multi-environment build -- Dynamic sidebar (supports multi-level routing) -- Dynamic breadcrumb -- I18n -- Customizable theme -- Tags-view(Tab page Support right-click operation) -- Rich text editor -- Markdown editor -- JSON editor -- Screenfull -- Drag and drop list -- Svg Sprite + - dev sit stage prod + +- Global Features + - I18n + - Multiple dynamic themes + - Dynamic sidebar (supports multi-level routing) + - Dynamic breadcrumb + - Tags-view(Tab page Support right-click operation) + - Svg Sprite + - Mock data + - Screenfull + - Responsive Sidebar + +- Editor + - Rich Text Editor + - Markdown Editor + - JSON Editor + +- Excel + - Export Excel + - Export zip + - Upload Excel + - Visualization Excel + +- Table + - Dynamic Table + - Drag And Drop Table + - Tree Table + - Inline Edit Table + +- Error Page + - 401 + - 404 + +- Components + - Avatar Upload + - Back To Top + - Drag Dialog + - Drag Kanban + - Drag List + - SplitPane + - Dropzone + - Sticky + - CountTo + +- Advanced Example +- Error Log - Dashboard - Guide Page -- Mock data - Echarts - Clipboard -- 401/404 error page -- Error log -- Export excel -- Export zip -- Front-end visualization excel -- Tree Table -- Table example -- Dynamictable example -- Drag and drop table example -- Inline edit table example -- Form example -- Two-step login -- SplitPane -- Drag Dialog -- Dropzone -- Sticky -- CountTo - Markdown to html ``` @@ -135,7 +159,7 @@ npm run lint npm run lint -- --fix ``` -Refer to [Documentation](https://panjiachen.github.io/vue-element-admin-site/#/deploy) for more information +Refer to [Documentation](https://panjiachen.github.io/vue-element-admin-site/guide/essentials/deploy.html) for more information ## Changelog Detailed changes for each release are documented in the [release notes](https://github.com/PanJiaChen/vue-element-admin/releases). diff --git a/README.zh-CN.md b/README.zh-CN.md index de8f7c70..b98a3af0 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -7,7 +7,7 @@ <img src="https://img.shields.io/badge/vue-2.5.10-brightgreen.svg" alt="vue"> </a> <a href="https://github.com/ElemeFE/element"> - <img src="https://img.shields.io/badge/element--ui-2.3.0-brightgreen.svg" alt="element-ui"> + <img src="https://img.shields.io/badge/element--ui-2.3.2-brightgreen.svg" alt="element-ui"> </a> <a href="https://travis-ci.org/PanJiaChen/vue-element-admin" rel="nofollow"> <img src="https://travis-ci.org/PanJiaChen/vue-element-admin.svg?branch=master" alt="Build Status"> @@ -24,27 +24,25 @@ ## 简介 -`vue-element-admin` 是一个åŽå°é›†æˆè§£å†³æ–¹æ¡ˆï¼Œå®ƒåŸºäºŽ [Vue.js](https://github.com/vuejs/vue) å’Œ [element](https://github.com/ElemeFE/element)。它使用了最新的å‰ç«¯æŠ€æœ¯æ ˆï¼Œå†…置了i18国际化解决方案,动æ€è·¯ç”±ï¼Œæƒé™éªŒè¯ç‰å¾ˆå¤šåŠŸèƒ½ç‰¹æ€§ï¼Œç›¸ä¿¡ä¸ç®¡ä½ çš„éœ€æ±‚æ˜¯ä»€ä¹ˆï¼Œæœ¬é¡¹ç›®éƒ½èƒ½å¸®åŠ©åˆ°ä½ ã€‚ +[vue-element-admin](http://panjiachen.github.io/vue-element-admin) 是一个åŽå°é›†æˆè§£å†³æ–¹æ¡ˆï¼Œå®ƒåŸºäºŽ [vue](https://github.com/vuejs/vue) å’Œ [element](https://github.com/ElemeFE/element)。它使用了最新的å‰ç«¯æŠ€æœ¯æ ˆï¼Œå†…置了i18国际化解决方案,动æ€è·¯ç”±ï¼Œæƒé™éªŒè¯ï¼Œæ炼了典型的业务模型,æ供了丰富的功能组件,它å¯ä»¥å¸®åŠ©ä½ 快速æ建ä¼ä¸šçº§ä¸åŽå°äº§å“原型。相信ä¸ç®¡ä½ çš„éœ€æ±‚æ˜¯ä»€ä¹ˆï¼Œæœ¬é¡¹ç›®éƒ½èƒ½å¸®åŠ©åˆ°ä½ ã€‚ - [在线访问](http://panjiachen.github.io/vue-element-admin) -- [使用文档](https://panjiachen.github.io/vue-element-admin-site/#/zh-cn/) +- [使用文档](https://panjiachen.github.io/vue-element-admin-site/zh/) - [Gitter讨论组](https://gitter.im/vue-element-admin/discuss) - [Wiki](https://github.com/PanJiaChen/vue-element-admin/wiki) -- [Donate](https://panjiachen.github.io/vue-element-admin-site/#/zh-cn/donate) +- [Donate](https://panjiachen.github.io/vue-element-admin-site/zh/donate/) **本项目的定ä½æ˜¯åŽå°é›†æˆæ–¹æ¡ˆï¼Œä¸é€‚åˆå½“基础模æ¿æ¥å¼€å‘。** - 模æ¿å»ºè®®ä½¿ç”¨: [vueAdmin-template](https://github.com/PanJiaChen/vueAdmin-template)  - æ¡Œé¢ç«¯: [electron-vue-admin](https://github.com/PanJiaChen/electron-vue-admin) -**注æ„:该项目使用 element-ui@2.3.0+ 版本,所以最低兼容 vue@2.5.0+** - ## å‰åºå‡†å¤‡ -ä½ çš„æœ¬åœ°çŽ¯å¢ƒéœ€è¦å®‰è£… [node](http://nodejs.org/) å’Œ [git](https://git-scm.com/)ã€‚æˆ‘ä»¬çš„æŠ€æœ¯æ ˆåŸºäºŽ [ES2015+](http://es6.ruanyifeng.com/)ã€[vue](https://cn.vuejs.org/index.html)ã€[vuex](https://vuex.vuejs.org/zh-cn/)ã€[vue-router](https://router.vuejs.org/zh-cn/) and [element-ui](https://github.com/ElemeFE/element),所有的请求数æ®éƒ½ä½¿ç”¨[Mock.js](https://github.com/nuysoft/Mock)模拟,æå‰äº†è§£å’Œå¦ä¹ 这些知识会对使用本项目有很大的帮助。 +ä½ éœ€è¦åœ¨æœ¬åœ°å®‰è£… [node](http://nodejs.org/) å’Œ [git](https://git-scm.com/)ã€‚æœ¬é¡¹ç›®æŠ€æœ¯æ ˆåŸºäºŽ [ES2015+](http://es6.ruanyifeng.com/)ã€[vue](https://cn.vuejs.org/index.html)ã€[vuex](https://vuex.vuejs.org/zh-cn/)ã€[vue-router](https://router.vuejs.org/zh-cn/) ã€[axios](https://github.com/axios/axios) å’Œ [element-ui](https://github.com/ElemeFE/element),所有的请求数æ®éƒ½ä½¿ç”¨[Mock.js](https://github.com/nuysoft/Mock)模拟,æå‰äº†è§£å’Œå¦ä¹ 这些知识会对使用本项目有很大的帮助。 åŒæ—¶é…å¥—ä¸€ä¸ªç³»åˆ—çš„æ•™ç¨‹æ–‡ç« ï¼Œå¦‚ä½•ä»Žé›¶æž„å»ºåŽä¸€ä¸ªå®Œæ•´çš„åŽå°é¡¹ç›®ï¼Œå»ºè®®å¤§å®¶å…ˆçœ‹å®Œè¿™äº›æ–‡ç« å†æ¥å®žè·µæœ¬é¡¹ç›® - [æ‰‹æ‘¸æ‰‹ï¼Œå¸¦ä½ ç”¨ vue æ’¸åŽå° 系列一(基础篇)](https://juejin.im/post/59097cd7a22b9d0065fb61d2) @@ -61,6 +59,8 @@ **本项目并ä¸æ˜¯ä¸€ä¸ªè„šæ‰‹æž¶ï¼Œæ›´å€¾å‘于是一个集æˆè§£å†³æ–¹æ¡ˆ** + **注æ„:该项目使用 element-ui@2.3.0+ 版本,所以最低兼容 vue@2.5.0+** + **该项目ä¸æ”¯æŒä½Žç‰ˆæœ¬æµè§ˆå™¨(如ie)ï¼Œæœ‰éœ€æ±‚è¯·è‡ªè¡Œæ·»åŠ polyfill [详情](https://github.com/PanJiaChen/vue-element-admin/wiki#babel-polyfill)** <p align="center"> @@ -69,42 +69,65 @@ ## 功能 ``` -- 登录/注销 +- 登录 / 注销 + - æƒé™éªŒè¯ + - 页é¢æƒé™ + - 指令æƒé™ + - 二æ¥ç™»å½• + - 多环境å‘布 -- 动æ€ä¾§è¾¹æ (支æŒå¤šçº§è·¯ç”±ï¼‰ -- 动æ€é¢åŒ…屑 -- 国际化多è¯è¨€ -- 多ç§åŠ¨æ€æ¢è‚¤ -- å¿«æ·å¯¼èˆª(æ ‡ç¾é¡µ) -- 富文本编辑器 -- Markdown编辑器 -- JSON编辑器 -- Screenfullå…¨å± -- 列表拖拽 -- Svg Sprite å›¾æ ‡ + - dev sit stage prod + +- 全局功能 + - 国际化多è¯è¨€ + - 多ç§åŠ¨æ€æ¢è‚¤ + - 动æ€ä¾§è¾¹æ (支æŒå¤šçº§è·¯ç”±åµŒå¥—) + - 动æ€é¢åŒ…屑 + - å¿«æ·å¯¼èˆª(æ ‡ç¾é¡µ) + - Svg Sprite å›¾æ ‡ + - 本地mockæ•°æ® + - Screenfullå…¨å± + - 自适应收缩侧边æ + +- 编辑器 + - 富文本 + - Markdown + - JSON ç‰å¤šæ ¼å¼ + +- Excel + - 导出excel + - 导出zip + - 导入excel + - å‰ç«¯å¯è§†åŒ–excel + +- è¡¨æ ¼ + - 动æ€è¡¨æ ¼ + - æ‹–æ‹½è¡¨æ ¼ + - æ ‘å½¢è¡¨æ ¼ + - 内è”编辑 + +- é”™è¯¯é¡µé¢ + - 401 + - 404 + +- 組件 + - 头åƒä¸Šä¼ + - 返回顶部 + - 拖拽Dialog + - æ‹–æ‹½çœ‹æ¿ + - 列表拖拽 + - SplitPane + - Dropzone + - Sticky + - CountTo + +- 综åˆå®žä¾‹ +- 错误日志 - Dashboard - 引导页 -- 本地mockæ•°æ® - Echarts 图表 - Clipboard(剪贴å¤åˆ¶) -- 401/404é”™è¯¯é¡µé¢ -- 错误日志 -- 导出excel -- 导出zip -- å‰ç«¯å¯è§†åŒ–excel -- æ ‘å½¢table -- Table example -- 动æ€table example -- 拖拽table example -- 内è”编辑table example -- Form example -- 二æ¥ç™»å½• -- SplitPane -- 拖拽 Dialog -- Dropzone -- Sticky -- CountTo - Markdown2html ``` @@ -148,7 +171,7 @@ npm run lint npm run lint -- --fix ``` -更多信æ¯è¯·å‚考 [使用文档](https://panjiachen.github.io/vue-element-admin-site/#/zh-cn/deploy) +更多信æ¯è¯·å‚考 [使用文档](https://panjiachen.github.io/vue-element-admin-site/zh/) ## Changelog Detailed changes for each release are documented in the [release notes](https://github.com/PanJiaChen/vue-element-admin/releases). diff --git a/src/router/index.js b/src/router/index.js index 2c9dbcbd..aaaccd8d 100644 --- a/src/router/index.js +++ b/src/router/index.js @@ -7,7 +7,7 @@ Vue.use(Router) import Layout from '@/views/layout/Layout' /** note: submenu only apppear when children.length>=1 -* detail see https://panjiachen.github.io/vue-element-admin-site/#/router-and-nav?id=sidebar +* detail see https://panjiachen.github.io/vue-element-admin-site/guide/essentials/router-and-nav.html **/ /** diff --git a/src/views/components-demo/tinymce.vue b/src/views/components-demo/tinymce.vue index 89323a4c..10760f65 100644 --- a/src/views/components-demo/tinymce.vue +++ b/src/views/components-demo/tinymce.vue @@ -2,7 +2,7 @@ <div class="components-container"> <code> {{$t('components.tinymceTips')}} - <a target="_blank" class="link-type" href="https://panjiachen.github.io/vue-element-admin-site/#/rich-editor"> {{$t('components.documentation')}}</a> + <a target="_blank" class="link-type" href="https://panjiachen.github.io/vue-element-admin-site/component/rich-editor.html"> {{$t('components.documentation')}}</a> </code> <div> <tinymce :height="300" v-model="content"></tinymce> diff --git a/src/views/documentation/index.vue b/src/views/documentation/index.vue index 8d3482d1..d9f8b9e8 100644 --- a/src/views/documentation/index.vue +++ b/src/views/documentation/index.vue @@ -1,6 +1,6 @@ <template> <div class="app-container documentation-container"> - <a class="document-btn" target='_blank' href="https://panjiachen.github.io/vue-element-admin-site/#/">{{$t('documentation.documentation')}}</a> + <a class="document-btn" target='_blank' href="https://panjiachen.github.io/vue-element-admin-site/">{{$t('documentation.documentation')}}</a> <a class="document-btn" target='_blank' href="https://github.com/PanJiaChen/vue-element-admin/">{{$t('documentation.github')}}</a> <dropdown-menu style="float:left;margin-left:50px;" title='ç³»åˆ—æ–‡ç« ' :items='articleList'></dropdown-menu> </div> diff --git a/src/views/errorLog/index.vue b/src/views/errorLog/index.vue index f94b2282..aac5e402 100644 --- a/src/views/errorLog/index.vue +++ b/src/views/errorLog/index.vue @@ -6,7 +6,7 @@ <h3>{{$t('errorLog.tips')}}</h3> <code> {{$t('errorLog.description')}} - <a target="_blank" class="link-type" href="https://panjiachen.github.io/vue-element-admin-site/#/error?id=%e4%bb%a3%e7%a0%81"> + <a target="_blank" class="link-type" href="https://panjiachen.github.io/vue-element-admin-site/guide/advanced/error.html"> {{$t('errorLog.documentation')}} </a> </code> diff --git a/src/views/example/components/Warning.vue b/src/views/example/components/Warning.vue index a0012ede..95842613 100644 --- a/src/views/example/components/Warning.vue +++ b/src/views/example/components/Warning.vue @@ -2,7 +2,7 @@ <p class="warn-content"> 创建和编辑页é¢æ˜¯ä¸èƒ½è¢«keep-alive 缓å˜çš„ï¼Œå› ä¸ºkeep-alive çš„include ç›®å‰ä¸æ”¯æŒæ ¹æ®è·¯ç”±æ¥ç¼“å˜ï¼Œæ‰€ä»¥ç›®å‰éƒ½æ˜¯åŸºäºŽcomponent name æ¥ç¼“å˜çš„ï¼Œå¦‚æžœä½ æƒ³è¦å®žçŽ°ç¼“å˜çš„效果,å¯ä»¥ä½¿ç”¨localstorage ç‰æ¸¸è§ˆå™¨ç¼“å˜æ–¹æ¡ˆã€‚或者ä¸è¦ä½¿ç”¨keep-alive çš„include,直接缓å˜æ‰€æœ‰é¡µé¢ã€‚è¯¦æƒ…è§ - <a href="https://panjiachen.github.io/vue-element-admin-site/#/zh-cn/tags-view?id=%E7%BC%93%E5%AD%98%E4%B8%8D%E9%80%82%E5%90%88%E5%9C%BA%E6%99%AF" + <a href="https://panjiachen.github.io/vue-element-admin-site/guide/essentials/tags-view.html" target="_blank">文档</a> </p> </template> diff --git a/src/views/svg-icons/index.vue b/src/views/svg-icons/index.vue index 0b95a87f..d371cc9a 100644 --- a/src/views/svg-icons/index.vue +++ b/src/views/svg-icons/index.vue @@ -1,7 +1,7 @@ <template> <div class="icons-container"> <p class="warn-content"> - <a href="https://panjiachen.github.io/vue-element-admin-site/#/icon" target="_blank">Add and use + <a href="https://panjiachen.github.io/vue-element-admin-site/guide/advanced/icon.html" target="_blank">Add and use </a> </p> <div class="icons-wrapper"> diff --git a/src/views/theme/index.vue b/src/views/theme/index.vue index ca6e1e5f..d9830b82 100644 --- a/src/views/theme/index.vue +++ b/src/views/theme/index.vue @@ -2,7 +2,7 @@ <div class="app-container"> <el-card class="box-card"> <div slot="header"> - <a class='link-type link-title' target="_blank" href='https://panjiachen.github.io/vue-element-admin-site/#/theme'> + <a class='link-type link-title' target="_blank" href='https://panjiachen.github.io/vue-element-admin-site/guide/advanced/theme.html'> {{$t('theme.documentation')}} </a> </div> -- GitLab