Wikitten WiKi 系统试用

Wikitten 是一个小型的 WiKi 系统，使用 PHP 开发，适合存储个人笔记、代码片段及一些 idea。

Github项目地址：

https://github.com/devaneando/Wikitten

这是 Github 项目主页的 README 介绍，项目最后一次更新还是五年前，已经有很久没有更新了。并且 README 中的介绍链接也失效了，使用说明及更多细节已无法探知。幸好有制作好的 docker 镜像可供使用，不用重头搭建 PHP 环境。

使用 docker 命令启动一个 wikitten 容器：

$ mkdir -p /wiki$ docker run -d --name wikitten  -p 80:80  -v /wiki:/data  -e USER=admin1  -e PASSWD=yourPassword  leonyff/wikitten:latest

首次登录会弹出一个“简洁”的登录框：

登录系统后会显示一个欢迎页面：

提示没有创建 /data/index.md 文件，因为数据卷挂载在 /wiki 目录，所以我们在 /wiki 目录创建 index.md 文件。

➜  pwd/wiki➜  tree /wiki/wiki└── index.md0 directories, 1 file➜  cat /wiki/index.mdhello

此时在 WiKi 页面可以看到主页内容：

搜索框中出现了新增的 markdown 文件，主页显示了我们刚创建的 index.md 。但无法在 WiKi 页面前台创建页面，只能在后台创建文件。也没有多用户管理功能，在 Web 页面只能看到渲染后的 Markdown 页面。

为了查看其 Markdown 的渲染能力，我重新上传了一个内容更丰富一点的 markdown 文本。

从效果上来看，可以显示文件目录，能识别图片文件、python 代码。

但更复杂一点的 markdown 解析直接报错了：

同样的 markdown 素材在 MarkText 编辑器中可以正常打开，说明其容错性还是差了一点：

总结

该款工具是一款文档索引工具，可以渲染 markdown 文本，python 源代码文件，提供了基本的文件名搜索功能。但叫 wiki 有点名不符实，因为无法在页面创建 wiki word，也无法实现前端创建页面。

总的来说，适合单用户简单项目页面的展示。文件名搜索功能还是不错的，能快速找到相应文件：

虽然没有实现完整的 wiki 功能，但作为一款 markdown 渲染引擎还是不错的。我试着将内部的《重点专科》项目资料上传至 /wiki 目录，查看一下显示效果：

如果用过 gitbook 会发现这款工具与 gitbook 很像，都是将 markdown 文件渲染成 html 格式。如果仅仅将其作为一个简单的项目主页介绍还是不错的，虽然无法在前台编辑，但可以通过定时 git 同步数据目录的方式更新内容。

首次访问会提示输入用户名和密码，但没有退出登录的功能。换一台电脑访问会再次提示输入用户名和密码。是个单用户系统，可以起到简单的内容保护的作用。

如果希望使用正规的WiKi系统，还是推荐 DocuWiki 之类的，至少支持多用户登录、WiKi word 词条、空词条新建页面等基础WiKi功能。

参考：

https://mp.weixin.qq.com/s/8Mg4lbYue9XXhpG-KlW3VQ

全文完。

如果转发本文，文末务必注明：“转自微信公众号：生有可恋”。