為什麼不使用github的wiki而是使用mkdocs做文件管理？

目前 KSFramework 是使用mkdocs來做線上文件 而非使用github的wiki，這是為什麼呢？

在windows下搭建wiki本地預覽不成熟

gollum：https://github.com/gollum/gollum

A simple, Git-powered wiki with a sweet API and local frontend.

（一個簡單的支援git wiki，提供本地預覽）

在gollum的說明文件中提到，在windows下使用目前並不成熟，不建議在正式環境中使用

Warning

: Windows support is still in the works! Many things do not work right now, and many of the tests are currently failing. Proceed at your own risk!

github wiki相關資料

安裝本地預覽工具：https://blog.csdn.net/zangxueyuan88/article/details/81115652

編輯指南：https://lpd-ios.github.io/2017/07/11/GitHub-Wiki-Introduction/

mkdocs不相容github的wiki

因為mkdocs是完全靜態的html，而wiki是動態在server上利用markdown渲染出html的，所以無法相容wiki。

可檢視這個討論：Mkdocs-compatible wiki? #976