当前位置: 首页 > 网站建设 > 使用Wikitten搭建自己的Wiki知识库

使用Wikitten搭建自己的Wiki知识库

发布于:2017-12-16 网站建设 12条评论 22,369 views
本站提供Linux服务器运维,自动化脚本编写等服务,如有需要请联系博主微信:xiaozme

Wikitten是一款开源Wiki知识管理系统,使用PHP开发,支持Markdown语法,无需数据库,自动生成树形目录,适合用来做个人Wiki知识库。

环境要求

  • PHP >= 5.3
  • 需要Fileinfo组建支持

安装

访问master.zip下载源码,放到站点根目录并解压。将config.php.example重命名为config.php,根据实际情况修改或注释里面内容,配置文件说明如下:

#设置站点标题
define('APP_NAME', 'My Wiki');
#选择首页文件,必须位于library文件夹下(一般不需要修改)
define('DEFAULT_FILE', 'index.md');
#设置文档目录(一般不需要修改)
define('LIBRARY', '/path/to/wiki/library');
#启用任何文件的页内编辑(不知道用来干嘛的,保持默认就行)
define('ENABLE_EDITING', true);
#启用JSON Front Matter(元数据),可对文档设置title/keywords等
define('USE_PAGE_METADATA', true); 
#使用黑色主题
define('USE_DARK_THEME', true);
#是否显示左下角LOGO
define('USE_WIKITTEN_LOGO', false);

Wikitten需要伪静态支持,如果是Apache一般不需要修改,站点根目录已经内置.htaccess伪静态规则。如果是Nginx,请添加下面的配置到server段内,并重载Nginx

location ~* ^/static/(css|js|img|fonts)/.+.(jpg|jpeg|gif|css|png|js|ico|html|xml|txt|swf|pdf|txt|bmp|eot|svg|ttf|woff|woff2)$ {
    access_log off;
    expires max;
}
location / {
    rewrite ^(.*)$ /index.php last;
}

最后访问您的域名进行测试,如果看到如下截图说明安装成功,如果报错,请根据提示进行排查。

使用说明

Wikitten支持Markdown语法(程序员最爱),直接将写好的Markdown文件存放到library目录会自动生成树形结构,然后会看到下图的样子。

如果您本地还未找到合适的Markdown工具,可以看看

Windows Mrakdown编辑器之MarkdownPad
免费Markdown编辑器Haroopad
VNote一个适合程序员的Markdown笔记

Wikitten模板文件位于views目录,您可以适当修改,添加网站统计代码以及评论和一些个性化设置。

Wikitten没有数据库也没有管理后台,每次修改文档再上传是不是很不方便?别担心,您可以使用类似Resilio Sync 之类的同步工具,将本地的文档自动同步到library目录,这样就可以自动更新了,如下图的样子。

Wikitten支持文件/文件夹搜索,可惜不支持文件内容搜索,期待后期作者继续完善优化。

总结

Wikitten支持Markdown语法非常方便,但不支持团队协作,仅适合个人用来做Wiki系统。同时发现Wikitten在Windows环境下中文会出现乱码,在Linux服务器下则没有该问题。

Demo:https://wiki.xiaoz.me/
项目地址:https://github.com/victorstanciu/Wikitten
作者网站:wikitten.vizuina.com

发表回复

您的电子邮箱地址不会被公开。 必填项已用 * 标注


已有12条评论


  1. define(‘USE_PAGE_METADATA’, true);
    使用

    “title”: “Wiki site”,
    “tags”: [“tag1”, “tag2”, “tag3”],
    “author”: “xxx”

    出错,能请问下是怎么回事吗?

        1. 提供什么信息呢?其实我现在不太推荐这个知识库,建议你试试showdoc:https://www.showdoc.com.cn/help/13732

          1. 就是在文章中调用文件头中的title、time、tag等信息显示出来。
            使用这个的原因是Wikitten是基于文档的,把MD文件上传就完事,维护备份简单一点。