官方的帮助文档才是最好的。
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=""/>