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

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

 

  环境要求

PHP >= 5.3

需要Fileinfo组建支持

安装

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

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

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

  1. 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)$ {
  2.     access_log off;
  3.     expires max;
  4. }
  5. location / {
  6.     rewrite ^(.*)$ /index.php last;
  7. }

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

 

  使用说明

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

 

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

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

 

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

 

  总结

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

留下评论

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