文檔版本

說明

一份嚴謹的技術文檔，經常需要限制版本。為了滿足這一需求，wangan 的文檔系統支持簡單的多版本功能。

接下來講解下如何為文檔「創建父文檔」和「新增版本」。

情況一：創建父文檔

這是只有一個文檔情況。假如您新建了一個文檔，后面發現需要為其新增版本，不論你的文檔里是否有內容，都可以使用以下方法創建父文檔。

我們來從頭操作一遍，如果你已經有存在的文檔，可以跳過第一步。

第一步：先創建父文檔，內容照常填寫：

第二步：創建成功后，點擊「設置」進入文檔編輯頁面：

第三步：文檔設置頁面的右上角，可以進入創建版本頁面：

第四步：填寫要創建的版本號并提交：

現在你的文檔可以支持多版本了：

情況二：新增版本

這是已經創建了父文檔的情況，已支持多版本，接下來要創建新一個版本。

第一步：選擇你要克隆的文檔，進入其設置頁面：

第二步：進入「添加新版本」頁面

第三步：設置 版本號

這次發現有一個「是否克隆所有章節」的選項，默認為否。打鉤的話將會克隆本文檔下的所有章節和文章。這里我們拿 5.9 來試下「否」的情況：

提交

接下來重新編輯 5.8 版本，并進入「添加新版本」頁面，拿「6.0」來試下「是否克隆所有章節」選項打鉤的情況：

可以看到章節都已被復制。

默認版本

在多版本的文檔中，父版本下會有一個默認版本。當用戶訪問文檔 Slug ，不指定版本信息的話，會自動跳轉到默認版本。這為分享文檔提供了便利，你只需要提供鏈接例如：www.6brc.com/docs/writing-docs ，用戶訪問后會自動跳轉到最新版本 www.6brc.com/docs/writing-docs

需要注意的是，在上面「情況二」里創建的新版本，不會被設置為默認版本。這是因為我們假設新建版本還未「準備好」。