2017-02-12 15:51:26 +08:00
|
|
|
|
|
|
|
推荐安装 `docsify-cli` 工具,可以方便创建及本地预览文档网站。
|
|
|
|
|
|
|
|
```bash
|
|
|
|
npm i docsify-cli -g
|
|
|
|
```
|
|
|
|
|
|
|
|
## 初始化项目
|
|
|
|
|
2017-02-12 20:12:36 +08:00
|
|
|
如果想在项目的 `./docs` 目录里写文档,直接通过 `init` 初始化项目。
|
2017-02-12 15:51:26 +08:00
|
|
|
|
|
|
|
```bash
|
|
|
|
docsify init ./docs
|
|
|
|
```
|
|
|
|
|
|
|
|
## 开始写文档
|
|
|
|
|
|
|
|
初始化成功后,可以看到 `./docs` 目录下创建的几个文件
|
|
|
|
|
|
|
|
- `index.html` 入口文件
|
|
|
|
- `README.md` 会做为主页内容渲染
|
|
|
|
- `.nojekyll` 用于阻止 GitHub Pages 会忽略掉下划线开头的文件
|
|
|
|
|
2017-02-12 20:12:36 +08:00
|
|
|
直接编辑 `docs/README.md` 就能更新网站内容,当然也可以[写多个页面](zh-cn/more-pages)。
|
2017-02-12 15:51:26 +08:00
|
|
|
|
|
|
|
## 本地预览网站
|
|
|
|
|
|
|
|
运行一个本地服务器通过 `docsify serve` 可以方便的预览效果,而且提供 LiveReload 功能,可以让实时的预览。默认访问 http://localhost:3000 。
|
|
|
|
|
|
|
|
```bash
|
|
|
|
docsify serve docs
|
|
|
|
```
|
|
|
|
|
|
|
|
?> 更多命令行工具用法,参考 [docsify-cli 文档](https://github.com/QingWei-Li/docsify-cli)。
|
|
|
|
|
|
|
|
## 手动初始化
|
|
|
|
|
2017-02-13 22:43:58 +08:00
|
|
|
如果不喜欢 npm 或者觉得安装工具太麻烦,我们其实只需要直接创建一个 `index.html` 文件。
|
|
|
|
|
|
|
|
*index.html*
|
2017-02-12 15:51:26 +08:00
|
|
|
|
|
|
|
```html
|
|
|
|
<!DOCTYPE html>
|
|
|
|
<html>
|
|
|
|
<head>
|
|
|
|
<meta charset="UTF-8">
|
|
|
|
<link rel="stylesheet" href="//unpkg.com/docsify/themes/vue.css">
|
|
|
|
</head>
|
|
|
|
<body>
|
|
|
|
<div id="app"></div>
|
|
|
|
</body>
|
|
|
|
<script src="//unpkg.com/docsify"></script>
|
|
|
|
</html>
|
|
|
|
```
|
|
|
|
|
2017-02-12 20:12:36 +08:00
|
|
|
如果系统里安装 Python 的话,也可以很轻易的启动一个静态服务器。
|
2017-02-12 15:51:26 +08:00
|
|
|
|
|
|
|
```bash
|
|
|
|
cd docs && python -m SimpleHTTPServer 3000
|
|
|
|
```
|