[TOC] ## 离线模式 在线编辑内容的时候,如果网络断了,系统会自动切换到离线编辑模式,并在网络连接的时候自动同步更新当前内容。 >[danger] 在离线编辑的时候,不支持目录切换和图片上传。 编辑页面的左下角会显示当前的联网状态 ![](https://box.kancloud.cn/1a1670e533cbcde78b5bc3c165495261) 当断网的时候,会显示 ![](https://box.kancloud.cn/a45fcd4f36acd38ad0b24b164f52aa01) 如果这个时候切换其它目录编辑的话,系统会提示 ![](https://box.kancloud.cn/7560f2b6aaeac9daf48198c883c7ae53) 一旦网络连接成功,系统会自动同步当前编辑内容。如果你不小心关闭了浏览器窗口,下次打开的时候系统会提示你进行数据恢复操作。 ## 版本库 每个文档都有自己的`GIT版本库`地址,一般是: ~~~ https://www.kancloud.cn/{用户名}/{文档标识}.git ~~~ 或者SSH地址 ~~~ git@git.kancloud.cn:{用户名}/{文档标识}.git ~~~ 如果不清楚的话,可以在文档设置页面查看到具体的版本库地址,如图: ![](https://box.kancloud.cn/f320c0284a8df009aa3910cb5c010f5f_809x521.png) >[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格式的文件格式提交后,在线编辑的时候将无法支持实时预览功能。