* [離線模式](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版本庫`地址，一般是：
~~~
http://www.hmoore.net/{用戶名}/{文檔標識}.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格式的文件格式提交后，在線編輯的時候將無法支持實時預覽功能。
