發現mdwiki——簡單地自建wiki

官方的幫助文檔纔是最好的。
http://dynalon.github.io/mdwiki

1. 簡單介紹

就是一個靜態的Js網頁解析及呈現同目錄下的markdown文檔。
感覺比其它Dokuwiki什麼的輕量易用些。

2. 筆記

其它中文介紹也很多，不多提了。列幾點注意事項（摘自上面的鏈接）。

2.1 支持file://方式的瀏覽器

• Firefox都支持
• IE都支持
• Chome需要加--allow-file-access-from-files作爲啓動參數
• Safari，不支持。

2.2 改變主題和導航

創建navigation.md文件

導航橫幅

# Brand name

[Menu Item 1]()

  * # SubMenu Heading 1
  * [SubMenu Item 1](subitem1.md)
  * [SubMenu Item 2](subitem2.md)
  - - - -
  * # SubMenu Heading 2
  * [SubMenu Item 3](subitem3.md)
  - - - -
  * # SubMenu Heading 3
  * [SubMenu Item 3](subitem3.md)

[Menu Item 2](item2.md)
- - - -
[Menu Item 3](item3.md)

用戶切換主題入口

在文件中添加[gimmick:themechooser](Choose theme)

默認主題

在文件中添加[gimmick:theme](flatly)
反色[gimmick:theme (inverse: true)](flatly)

2.3 側邊目錄及其它配置

創建config.json

{
    "useSideMenu": true,
    "lineBreaks": "gfm",
    "additionalFooterText": "All content and images © by John Doe",
    "anchorCharacter": "#"
}

2.4 Tomcat的工作目錄

創了個符號鏈接
mklink /D "C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps\mdwiki" ..\mdwiki

2.5 省略Tomcat的URL地址中的8080

安裝時使用80作爲Tomcat端口，或把tomcat下conf文件夾下的server.xml中下代碼中的8080改成80。

<Connector port="8080" protocol="HTTP/1.1"

也可以在＜Host>標籤下增加當前項目名的＜context>，如下所示：

<Host name="localhost"  appBase="webapps"  
            unpackWARs="true" autoDeploy="true"  
            xmlValidation="false" xmlNamespaceAware="false">  
    <Context docBase="項目名" path=""/>