|
| 1 | +# Micro APP - VuePress |
| 2 | + |
| 3 | +[CLI] adapter vuepress. |
| 4 | + |
| 5 | +[![Github Actions Coveralls][Github-Actions-Coveralls]][Github-Actions-Coveralls-url] |
| 6 | +[![Coverage Status][Coverage-img]][Coverage-url] |
| 7 | +[![NPM Version][npm-img]][npm-url] |
| 8 | +[![NPM Download][download-img]][download-url] |
| 9 | + |
| 10 | +[Github-Actions-Coveralls]: https://github.com/MicroAppJS/vuepress/workflows/Coveralls/badge.svg |
| 11 | +[Github-Actions-Coveralls-url]: https://github.com/MicroAppJS/vuepress |
| 12 | +[Coverage-img]: https://coveralls.io/repos/github/MicroAppJS/vuepress/badge.svg?branch=master |
| 13 | +[Coverage-url]: https://coveralls.io/github/MicroAppJS/vuepress?branch=master |
| 14 | +[npm-img]: https://img.shields.io/npm/v/@micro-app/vuepress.svg?style=flat-square |
| 15 | +[npm-url]: https://npmjs.org/package/@micro-app/vuepress |
| 16 | +[download-img]: https://img.shields.io/npm/dm/@micro-app/vuepress.svg?style=flat-square |
| 17 | +[download-url]: https://npmjs.org/package/@micro-app/vuepress |
| 18 | + |
| 19 | +## Install |
| 20 | + |
| 21 | +```sh |
| 22 | +yarn add @micro-app/vuepress |
| 23 | +``` |
| 24 | + |
| 25 | +or |
| 26 | + |
| 27 | +```sh |
| 28 | +npm install -D @micro-app/vuepress |
| 29 | +``` |
| 30 | + |
| 31 | +## Usage |
| 32 | + |
| 33 | +### 在项目 `根目录` 的 `micro-app.config.js` 文件中配置 |
| 34 | + |
| 35 | +> 请确保你的 Node.js 版本 >= 8.6。 |
| 36 | +
|
| 37 | +```bash |
| 38 | +# 安装 vuepress plugin |
| 39 | +yarn add -D @micro-app/vuepress # 或者:npm install -D @micro-app/vuepress |
| 40 | + |
| 41 | +# 新建一个 docs 文件夹 |
| 42 | +mkdir docs |
| 43 | + |
| 44 | +# 新建一个 markdown 文件 |
| 45 | +echo '# Hello MicroApp VuePress!' > docs/README.md |
| 46 | + |
| 47 | +# 开始写作 |
| 48 | +npx micro-app-vuepress dev docs |
| 49 | +``` |
| 50 | + |
| 51 | +### 创建 `micro-app.vuepress.config.js` 文件, 并如下配置 |
| 52 | + |
| 53 | +```js |
| 54 | +{ // temp demo |
| 55 | + title: 'Micro App', |
| 56 | + sourceDir: 'docs', |
| 57 | + sidebar: { |
| 58 | + ... |
| 59 | + }, |
| 60 | + nav: [], |
| 61 | + locales: { |
| 62 | + '/': { |
| 63 | + lang: 'zh-CN', |
| 64 | + description: '🔌 多模块可插拔插件的微应用框架', |
| 65 | + label: '简体中文', |
| 66 | + selectText: '选择语言', |
| 67 | + lastUpdated: '上次编辑时间', |
| 68 | + repoLabel: '查看源码', |
| 69 | + editLinkText: '在 GitHub 上编辑此页', |
| 70 | + }, |
| 71 | + '/en/': { |
| 72 | + lang: 'en-US', |
| 73 | + description: '🔌 Pluggable Micro Application Framework', |
| 74 | + label: 'English', |
| 75 | + selectText: 'Languages', |
| 76 | + lastUpdated: 'Last Updated', |
| 77 | + repoLabel: 'View Code', |
| 78 | + editLinkText: 'Edit this page on GitHub', |
| 79 | + }, |
| 80 | + }, |
| 81 | + // 假定是 GitHub. 同时也可以是一个完整的 GitLab URL |
| 82 | + repo: 'MicroAppJS/MicroApp-Core', |
| 83 | + // 自定义仓库链接文字。默认从 `themeConfig.repo` 中自动推断为 |
| 84 | + // "GitHub"/"GitLab"/"Bitbucket" 其中之一,或是 "Source"。 |
| 85 | + // repoLabel: '查看源码', |
| 86 | + // 假如你的文档仓库和项目本身不在一个仓库: |
| 87 | + // docsRepo: 'MicroAppJS/MicroApp-Core', |
| 88 | + // 假如文档不是放在仓库的根目录下: |
| 89 | + docsDir: 'docs', |
| 90 | + // 假如文档放在一个特定的分支下: |
| 91 | + docsBranch: 'master', |
| 92 | + // 默认是 false, 设置为 true 来启用 |
| 93 | + editLinks: true, |
| 94 | + // 默认为 "Edit this page" |
| 95 | + // editLinkText: '帮助我们改善此页面!', |
| 96 | + sidebarDepth: 3, |
| 97 | + // algolia: { |
| 98 | + // indexName: "cli_vuejs", |
| 99 | + // apiKey: "f6df220f7d246aff64a56300b7f19f21" |
| 100 | + // }, |
| 101 | + // search: false, |
| 102 | + // searchMaxSuggestions: 10, |
| 103 | + // displayAllHeaders: true // 默认值:false |
| 104 | +} |
| 105 | +``` |
0 commit comments