在Seafile 7.0中俗冻,用戶可以將一個(gè)資料庫作為公共資料庫來對外發(fā)布梨水。如果你有對外的手冊乏矾、指南等文檔需要發(fā)布,就可以使用這一功能润匙。 比如我們 Seafile 的服務(wù)器手冊就是發(fā)布為一個(gè)公開的資料庫诗眨。
公開資料庫中的 Markdown 格式的文件會直接在公開資料庫界面中展現(xiàn)。公開資料庫中也可以包含任意格式的文件孕讳,這些文件點(diǎn)擊后會在單獨(dú)的外鏈頁面中打開匠楚,訪問者可以在線查看或者下載這些文件。
現(xiàn)在很多開源軟件作者都會將文檔作為代碼托管在 github 上厂财,然后將 Markdown 文件編譯成 html 再對外發(fā)布芋簿。通過直接將文檔的原始 Markdown 文件保存在 Seafile 中,即可以所見即所得的方式來編輯維護(hù)文檔璃饱,同時(shí)對外發(fā)布与斤,大大簡化了流程。后續(xù)我們會專門寫一篇文章來介紹如何將現(xiàn)有的文檔從 Github, Gitbook 等平臺遷移到 Seafile。
發(fā)布一個(gè)資料庫為公開資料庫
如下圖所示撩穿,在Seafile網(wǎng)頁端左側(cè)工具欄選擇“已發(fā)布的資料庫”磷支,再點(diǎn)擊正上方的“發(fā)布資料庫”按鈕,選擇并提交需要發(fā)布的資料庫即可食寡。已發(fā)布的資料庫將顯示在下方列表中雾狈,任何人都可以通過該資料庫的url來訪問其中的文件。
公開資料庫中的導(dǎo)航
你可以用兩種方式為公開資料庫提供導(dǎo)航:
- 直接顯示目錄樹
- 使用 index.md 文件
直接顯示目錄樹
對簡單的文檔抵皱,你可以不用自定義導(dǎo)航善榛,資料庫左邊欄會直接顯示出目錄樹。訪問者可以在目錄樹中快速訪問某個(gè)文件叨叙。
使用 index.md 文件
當(dāng)我們需要發(fā)布手冊這種文檔時(shí)锭弊,導(dǎo)航條目應(yīng)該是按照方便大家閱讀的順序來編排,而目錄樹只能以資料庫固有的目錄順序來提供導(dǎo)航擂错,也不支持調(diào)整導(dǎo)航條目的順序。為了解決這個(gè)問題樱蛤,在Seafile專業(yè)版7.0.4或者社區(qū)版7.0.3版本之后钮呀,我們可以在資料庫中手動創(chuàng)建 index.md 文件,并通過插入列表來自定義導(dǎo)航條目的名稱和順序昨凡。
如下圖所示爽醋,創(chuàng)建 index.md 文件之后,你可以插入列表并為每個(gè)列表項(xiàng)添加一個(gè)文檔的鏈接便脊,方便在導(dǎo)航中跳轉(zhuǎn)蚂四。列表項(xiàng)的名稱可以修改,每個(gè)列表項(xiàng)都會轉(zhuǎn)化為導(dǎo)航中一個(gè)同名的條目哪痰,條目的順序和自定義列表項(xiàng)的順序是一致的遂赠。
如下圖所示,在index.md文件中插入自定義列表之后晌杰,當(dāng)用戶訪問公開資料庫時(shí)跷睦,左邊的導(dǎo)航欄顯示的不再是目錄樹,而是一個(gè)和列表每一項(xiàng)的名稱肋演、順序完全一致的導(dǎo)航抑诸。點(diǎn)擊左側(cè)導(dǎo)航中任意一個(gè)條目,界面右側(cè)都會立刻呈現(xiàn)出對應(yīng)的文檔內(nèi)容爹殊。
Seafile 7.0 版本現(xiàn)在已經(jīng)發(fā)布到了 Seafile 的官網(wǎng)(https://www.seafile.com/download/)蜕乡,感興趣的用戶可以去下載使用,歡迎大家反饋意見梗夸!