* [离线模式](http://help.kancloud.cn/62577#_2)
* [版本库](http://help.kancloud.cn/62577#_23)
* [目录文件](http://help.kancloud.cn/62577#_44)
* [文档设置](http://help.kancloud.cn/62577#_68)
* [样式自定义](http://help.kancloud.cn/62577#_80)
* [多格式支持](http://help.kancloud.cn/62577#_96)
## 离线模式
在线编辑内容的时候，如果网络断了，系统会自动切换到离线编辑模式，并在网络连接的时候自动同步更新当前内容。
>[danger] 在离线编辑的时候，不支持目录切换和图片上传。
编辑页面的左下角会显示当前的联网状态
当断网的时候，会显示
如果这个时候切换其它目录编辑的话，系统会提示
一旦网络连接成功，系统会自动同步当前编辑内容。如果你不小心关闭了浏览器窗口，下次打开的时候系统会提示你进行数据恢复操作。
## 版本库
每个文档都有自己的`GIT版本库`地址，一般是：
~~~
https://www.kancloud.cn/{用户名}/{文档标识}.git
~~~
或者SSH地址
~~~
git@git.kancloud.cn:{用户名}/{文档标识}.git
~~~
如果不清楚的话，可以在文档设置页面查看到具体的版本库地址，如图：
>[success] 版本库的获取和推送都需要用户认证，只有具有该文档编辑以上权限的用户才能进行版本库获取和推送，认证的账号密码就是你的看云账号密码。
首先需要本地安装GIT版本库支持（请自行百度）后，把当前文档的版本库克隆到本地，即可开始利用其他的MD编辑器进行离线写作，写作完成后，远程提交或者合并到文档的版本库地址即可。
>[danger] 你也可以和其他的版本库地址进行同步。
## 目录文件
看云目录文件的规范命名是`SUMMARY.md`，本身也是采用markdown格式，格式如下：
~~~
* [前言](Preface.md)
* [第1章 基础知识](content/Chapter1.md)
* [1.1 安装 tmux](content/安装tmux.md)
* [1.2 开始使用 tmux](content/开始使用 tmux.md)
* [1.3 分离和连接会话](content/分离和连接会话.md)
* [第2章 配置 tmux](content/Chapter2.md)
* [第3章 脚本定制 tmux 环境](content/Chapter3.md)
* [第4章 文本和缓冲区](content/Chapter4.md)
* [第5章 使用 tmux 结对编程](content/Chapter5.md)
* [第6章 工作流](content/Chapter6.md)
* [附录 配置文件](content/Appendix.md)
~~~
在目录文件中每个目录都对应一个md文件，该文件的命名可以使用中文，但不能使用下列特殊字符：`\/:*<>|"`。
>[danger] 如果文件名中使用/会作为目录处理。
目录的层次关系采用`TAB`缩进，并且可以支持多级目录。
>[danger] 目录文件一定不能包含空行
## 文档设置
每个文档都可以独立设置相关的参数和扩展，设置文件命名格式为：`book.json`。
例如，我们可以给文档设置代码高亮显示功能，就需要在配置文件中加入插件参数：
~~~
{
"plugins":["highlight"],
}
~~~
## 样式自定义
可以给文档的阅读页面自定义样式，只要增加`style/website.css`文件，然后在里面加上样式代码，例如：
~~~
/* 改变默认的引用段落样式 */
blockquote.default{
border-left: 5px solid #D0E3F0;
margin: 8px 0;
padding: 8px 16px;
background-color: #F0F7FD;
color: #0382AD;
}
~~~
## 多格式支持
你可以给某个章节的内容采用HTML格式编辑，并且确保文件后缀名是`.html`。
> 看云会陆续支持其他格式的文档解析，不过需要注意的是，采用非md格式的文件格式提交后，在线编辑的时候将无法支持实时预览功能。
