使用Wikitten搭建个人Wiki，支持Markdown

内容纲要

wikitten官网

https://wikitten.vizuina.com/

wikitten下载地址

github.com/victorstanciu/Wikitten/archive/master.zip

环境要求

PHP >= 5.3
需要Fileinfo组建支持

安装步骤

搭建好Web环境，建议使用宝塔面板
给PHP安装Fileinfo插件。如果Fileinfo拓展安装失败，就是内存太小，我们可以添加swap，不适用于ovz
接下来解析并添加域名
然后下载源码：Wikitten.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

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;
}

错误处理

官方下载的源码文件在运作的时候会有如下的错误提示。

Fatal error: Uncaught Exception: Page 'index.md' was not found in D:\phpstudy_pro\WWW\wiki.php:52 Stack trace: #0 D:\phpstudy_pro\WWW\wiki.php(133): Wiki->{closure}() #1 D:\phpstudy_pro\WWW\wiki.php(401): Wiki->_render('index.md') #2 D:\phpstudy_pro\WWW\wiki.php(339): Wiki->indexAction() #3 D:\phpstudy_pro\WWW\index.php(34): Wiki->dispatch() #4 {main} thrown in D:\phpstudy_pro\WWW\wiki.php on line 52

经过测试需要注释掉根目录的wiki.php 文件第52行的代码，之后就可以正常安装。

原代码
throw new Exception("Page '$page' was not found");

注释后
// throw new Exception("Page '$page' was not found");

使用说明

Wikitten支持Markdown语法，直接将写好的Markdown文件存放到网站根目录library文件夹会自动生成树形结构

参考地址

Post Views: 1,686