手把手教你搭建基於 MarkDown 的 Wiki 系統
阿新 • • 發佈:2018-12-26
1 準備資源
- http 伺服器(應用伺服器也可以,之所以需要應用伺服器,因為 mdwiki 必須放在 http 伺服器下執行。 )
以上資源,請先自行下載好 O(∩_∩)O~。
2 建立中文環境
mdwiki 基礎包結構:
- 把專案資料夾改名為 *-wiki(當然也可以取你自己喜歡的名字嘍 O(∩_∩)O )。
- ll_CC 為模板目錄,不要直接使用,這樣便於以後 mdwiki 更新與升級。因此我們把 ll_CC 目錄完整拷貝一份,然後把資料夾改為 zh_CN。這樣我們就建立了一箇中文目錄環境。如果你想讓你的 wiki 支援多種語言,建議參考國際語言程式碼表,然後複製多份 ll_CC,放置在根目錄下。
3 放入 http 伺服器
這裡演示的環境是:
* tomcat 伺服器
* idea 編輯器
* git (用於頁面託管)
具體搭建伺服器的過程,就不在此累述咯,大家可以在網上多查查相關資料。O(∩_∩)O~
有一點需要注意,為了讓 Intellij IDEA 能夠支援 markdown 語法,我們必須安裝一個外掛。
外掛安裝成功後,就能實現享受 markdown 語法高亮與所見即所得的雙屏介面嘍:
設計好後的頁面檔案,可以直接放入 zh_CN 資料夾中。
注意:檔案字尾必須是 md 哦O(∩_∩)O~
4 執行
如果你看到這個頁面,那麼恭喜你,你的基於 MarkDown 的 Wiki 系統已經搭建成功啦 O(∩_∩)O
如果出現白屏,有可能是因為專案所依賴的 jQuery 檔案被遮蔽啦,開啟 zh_CN/index.html 檔案,修改 jquery 路徑:
<script type="text/javascript" src="//code.jquery.com/jquery-1.12.4.min.js"></script>
然後再重新開啟,就可以正常使用啦O(∩_∩)O~