1. 程式人生 > >手把手教你搭建基於 MarkDown 的 Wiki 系統

手把手教你搭建基於 MarkDown 的 Wiki 系統

1 準備資源

  • http 伺服器(應用伺服器也可以,之所以需要應用伺服器,因為 mdwiki 必須放在 http 伺服器下執行。 )

以上資源,請先自行下載好 O(∩_∩)O~。

2 建立中文環境

mdwiki 基礎包結構:

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 外掛

外掛安裝成功後,就能實現享受 markdown 語法高亮與所見即所得的雙屏介面嘍:

Markdown 外掛安裝成功

設計好後的頁面檔案,可以直接放入 zh_CN 資料夾中。

注意:檔案字尾必須是 md 哦O(∩_∩)O~

4 執行

mdwiki 首頁

如果你看到這個頁面,那麼恭喜你,你的基於 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~