发现mdwiki——简单地自建wiki

乐正乐湛

2023-12-01

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