MoinMoin Wiki 在Linux Apache下的安装

    最近将http://wiki.cwowaddon.com/迁移到了Dreamhost的主机上, 由于本人不熟悉Linux和Apache其中遇到了不少问题Google查阅了一些文档并不尽如人意, 磕磕绊绊终归是搞定了, 做个总结以供参考. 一些细节问题请先查看我的上一篇Blog MoinMoin Wiki 在IIS下的安装与升级.

• 准备工作

下载Python和最新版的MoinMoin Wiki, 本文示例中的环境:

主目录: /home/simonw

Web目录: /home/simonw /wiki.cwowaddon.com

Python版本2.5

Wiki版本为1.5.7

Wiki解压安装文件目录: /home/simonw /moin-1.5.7

Wiki安装目录: /home/simonw /MoinMoin

Wiki实例目录: /home/simonw /MoinMoin/simonwwiki

再废话几句, Dreamhost上默认安装了Python2.3, 在wiki安装时会有几个警告, 所以我自己安装了Python2.5, 可以参考在DreamHost上安装python 2.5, 过程很简单.   

• 安装Wiki

tar xzf moin-1.5.7.tar.gz
cd moin-1.5.7
python setup.py --quiet install --prefix=/home/simonw/MoinMoin --record=install.log

少许安装完毕后会在/home/simonw /MoinMoin目录下生成这几个子目录lib(主运行程序), share(Wiki实例的模板), bin三个子目录. 

• 创建Wiki实例

    将wiki实例置于/home/simonw /MoinMoin/simonwwiki而非Web目录下可以使数据更加安全, 也不用在设置其他的权限. 创建过程主要就是从share目录中拷贝data, underlay目录, 配置文件wikiconfig.py, moin.fcg(入口调用文件, 此处使用了FastCGI模式, 所以用了这个文件) 到wiki实例目录中. 同样可以依据此方式创建多个wiki实例.

    将/home/simonw /MoinMoin/share/moin/htdocs目录映射到web目录, 这不是必须的, 你完全可以拷贝到web目录, 但这里存放的是css等skin文件因此共享比较合适.

cd /home/simonw/wiki.cwowaddon.com
mdir wiki
ln -s /home/simonw/MoinMoin/share/moin/htdocs wiki

    打开moin.fcg在顶部添加下面的引用路径, 以便代码能够找到.

#!/home/simonw/bin/python/bin/python
# -*- coding: iso-8859-1 -*-
import sys
sys.path.insert(0, '/home/simonw/lib/lib/python2.5')
sys.path.insert(0, '/home/simonw/MoinMoin/lib/python2.5/site-packages')
sys.path.insert(0, '/home/simonw/MoinMoin/simonwwiki')

    配置wikiconfig.py

data_dir = '/home/simonw/MoinMoin/simonwwiki/data/'
data_underlay_dir = '/home/simonw/MoinMoin/simonwwiki/underlay/'
url_prefix = '/wiki/htdocs'

 

• 配置Apache

打开站点的FastCGI模式, 将比CGI方式快出5倍以上, 把moin.fcg拷贝到/home/simonw/wiki.cwowaddon.com, 并设置为可执行.

chmod +x moin.fcg

建立.htaccess文件, 配置web目录.

options +FollowSymLinks
options -Indexes
DirectoryIndex moin.fcg
ReWriteEngine on
RewriteRule ^img/ - [L]
RewriteRule ^wiki/htdocs/ - [L]
RewriteBase /
RewriteRule ^moin\.fcg - [L]
RewriteRule ^(.*)$ moin.fcg/$1 [L]

上面Url rewrite很关键, Url会变得更加友好http://wiki.cwowaddon.com/simonw 而不是http://wiki.cwowaddon.com/moin.fcg/simonw  还需要最后一步使得页面输出的Url也成为这样. 打开moin.fcg修改代码

def handle_request(req, env, form):
    request = RequestFastCGI(req, env, form, properties = {'script_name': '/'})
    request.run()

 

    本文参考了MoinMoinWiki本身的安装帮助文档, 和http://wiki.dreamhost.com/index.php/MoinMoin, 其中都有一些毛病, 最终修正后, 结果较为完美.