[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格式的文件格式提交后，在線編輯的時候將無法支持實時預覽功能。