类似gitbook的wiki选择

一直以来，都使用xwiki作为团队内部的文档管理工具，但一直想换一个比较轻量级的系统。团队成员普遍对gitbook风格有好感，于是先后试用了mdwiki、dokuwiki、hexo、mindoc、wikitten。

mdwiki：纯粹用AJAX写的，部署最简单，但是目录只能两级；

dokuwiki：PHP写的，没有数据库，有不少插件。一直在这个和wikitten中犹豫，最后还是选择了wikitten，主要还是界面风格，wikitten比较简洁；

hexo：采用node.js开发的，也是因为这个才知道wikitten。因为服务器上已经有PHP的环境了，不想再增加node.js，所以放弃了，否则是很好的选择；

mindoc：golang开发的，这个其实也不错，但我只要一本书，他却提供了一个书柜；

wikitten：PHP写的，没有数据库，没有插件，文档也少。但界面一眼看中了，就这样了。

到github下载，解压。网上说PHP需要fileinfo组件，其实还需要json组件，这个需要注意了。由于我使用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 /wiki/ {
    rewrite ^(.*)$ /wiki/index.php last;
}

主要是location /wiki/ 这段，如果没有，页面解析正常，但左侧tree的链接不正常，因为伪静态的原因，可以理解。但如果加上这一段，则页面解析不正常了，主要是static这个目录访问不到了。对PHP不怎么熟悉，并且还可以用php -S 0.0.0.0:8000 route.php执行，在nginx里配置一个proxy_pass就好，所以也就懒得折腾了，用这种方式来做吧。

补记：

经过调试比对apache下的配置，发现问题出在apache有这么一句：

RewriteCond %{THE_REQUEST} !^GET\ /.*?static/(css|js|img)

经过在https://segmentfault.com/q/1010000014633581讨教，终于知道了原因：

!^GET\ /.*?static/(css|js|img)表示排除/static/(css|js|img)这些路径的请求
nginx没有对应的排除的方法
可以用变通的方法
先给location /一个try_files，然后优先匹配/static/(css|js|img)，匹配到的不配置try_files

location / {
    try_files $uri $uri/ /index.php;
}

location ~* ^/.*static/(css|js|img)/ {
    expires 1d;
}

参考以上的内容修改

 location / {
            root   /usr/local/www/nginx;
            index  index.html index.htm index.php;
            # Wikitten
            try_files $uri $uri/ /wiki/index.php;
        }


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

完美的解决了问题。

其它注意要点：

如果APP_NAME要用中文，那么config.php一定要转成UTF8保存，否则没法正常显示。

<?php
// Example configuration file for Wikitten. To use it,
// first rename it to `config.php`.

// Custom name for your wiki:
define('APP_NAME', '这里用中文');

// Set the filename of the automatic homepage here
define('DEFAULT_FILE', 'index.md');

// Custom path to your wiki's library:
// define('LIBRARY', '/path/to/wiki/library');

// Enable editing files through the interface?
// NOTE: There's currently no authentication built into Wikitten, controlling
// who does what is your responsibility.
// define('ENABLE_EDITING', true);

// Enable JSON page data?
// define('USE_PAGE_METADATA', true);

// Enable the dark theme here
// define('USE_DARK_THEME', true);

// Disable the Wikitten logo here
define('USE_WIKITTEN_LOGO', false);

// Enable PasteBin plugin ?
// define('ENABLE_PASTEBIN', true);
// define('PASTEBIN_API_KEY', '');