[TOC] ## 离线模式 在线编辑内容的时候，如果网络断了，系统会自动切换到离线编辑模式，并在网络连接的时候自动同步更新当前内容。 >[danger] 在离线编辑的时候，不支持目录切换和图片上传。 编辑页面的左下角会显示当前的联网状态  当断网的时候，会显示  如果这个时候切换其它目录编辑的话，系统会提示  一旦网络连接成功，系统会自动同步当前编辑内容。如果你不小心关闭了浏览器窗口，下次打开的时候系统会提示你进行数据恢复操作。 ## 版本库 每个文档都有自己的`GIT版本库`地址，一般是： ~~~ https://git.kancloud.cn/{用户名}/{文档标识}.git ~~~ 或者SSH地址 ~~~ git@git.kancloud.cn:{用户名}/{文档标识}.git ~~~ 如果不清楚的话，可以在文档设置页面查看到具体的版本库地址，如图：  >[info] 版本库的获取和推送都需要用户认证，只有具有该文档编辑以上权限的用户才能进行版本库获取和推送，认证的账号密码就是你的看云账号密码。 首先需要本地安装GIT版本库支持（请自行百度）后，把当前文档的版本库克隆到本地，即可开始利用其他的MD编辑器进行离线写作，写作完成后，远程提交或者合并到文档的版本库地址即可。 >[success] 你也可以和其他的版本库地址进行同步。 ## 目录文件 看云目录文件的规范命名是`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`。 >[danger] 看云会陆续支持其他格式的文档解析，不过需要注意的是，采用非md格式的文件格式提交后，在线编辑的时候将无法支持实时预览功能。