1 | # 快速开始
|
2 |
|
3 | YDoc 是一个优雅的文档站构建工具,能够基于 markdown 轻松生成完整静态站点,让你专注于文档写作。YDoc 拥有灵活而强大的插件/主题机制,开发者可以轻松定制属于自己的文档站点。
|
4 |
|
5 | ## 安装依赖
|
6 |
|
7 | YDoc 依赖 Node.js , 请安装不低于 7.6 版本的 Node.js
|
8 |
|
9 | ### 安装 Node.js
|
10 |
|
11 | 方案一: 从 [Node.js](https://nodejs.org/en/) 官网下载安装包
|
12 |
|
13 | 方案二: 使用 [Node Version Manager(NVM)](https://github.com/creationix/nvm) 安装 Node.js,你可以通过以下命令安装 NVM :
|
14 |
|
15 | cURL:
|
16 | ``` bash
|
17 | $ curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.2/install.sh | bash
|
18 | ```
|
19 |
|
20 | Wget:
|
21 | ``` bash
|
22 | $ wget -qO- https://raw.githubusercontent.com/creationix/nvm/v0.33.2/install.sh | bash
|
23 | ```
|
24 |
|
25 | NVM 安装好以后,重启终端并运行以下命令来安装 Node.js :
|
26 |
|
27 | ``` bash
|
28 | nvm install stable
|
29 | ```
|
30 |
|
31 | ### 使用 NPM 安装 YDoc
|
32 |
|
33 | ```
|
34 | npm install ydoc [-g]
|
35 | ```
|
36 |
|
37 | ### 使用 NPM 安装 rc 版本(发布候选版本)
|
38 |
|
39 | ```
|
40 | npm install ydoc@rc [-g]
|
41 | ```
|
42 |
|
43 | ## 创建你的站点
|
44 |
|
45 | ```
|
46 | mkdir project && cd project
|
47 | ydoc init
|
48 | ydoc build
|
49 | ```
|
50 |
|
51 | `ydoc init` 执行初始化操作,这将会在当前目录生成一个 `'docs'` 目录,用于存放文档(markdown)文件。
|
52 |
|
53 | `ydoc build` 执行构建操作,这将会使用 `'docs'` 目录中的文件进行文档站的构建,构建成功后会在当前目录生成一个 `'_site'` 目录,打开 `'_site'` 目录中的 `index.html` 文件即可访问构建的文档站首页 🎉🎉
|
54 |
|
55 | -------------------
|
56 |
|
57 | ## 下一步我可以做什么
|
58 |
|
59 | 简单学习即可轻松使用下面的基本功能,这不会花费你很长时间:
|
60 |
|
61 | - [目录](structure.md): 了解 YDoc 的目录结构
|
62 | - [导航](nav.md): 页面顶部的链接
|
63 | - [页面](pages-index.md): 编写首页、文档页目录和内容 |
\ | No newline at end of file |