用MoinMoin搭建个人wiki之安装配置

MoinMoin是用python语言实现的开源wiki引擎，它的最大特点是无数据库，由纯文件系统构成。

用MoinMoin要搭建wiki，还需要如下东东：

1.服务器，如Apache，Nginx

2.python2.5。官方说python2.6没测过，存在安全隐患。

3.mod_wsgi模块，MoinMoin推荐用wsgi的方式运行，则需要在服务器上扩展支持wsgi功能。

 

 

搭建过程开始：

1.编译安装Apache，注意在编译参数中加入--enable-shared --enable-so，因为之后要加入mod_wsgi模块，所以apache必须支持动态库

2.安装python2.5，注意在编译参数中加入--enable-shared，mod_wsgi官方说python必须支持动态库，否则会出现莫名其妙的问题。

3.安装mod_wsgi模块，在编译参数中加入-- with - apxs = /usr/ local / apache 2/ bin / apxs  -- with - python = /usr/ local / bin / python2.5

4.修改Apache的httpd.conf配置文件，加入 LoadModule wsgi_module modules/mod_wsgi.so

5.安装MoinMoin，进入Moin的安装目录，执行如下指令：

python2.5 setup.py install --force --record=install.log --prefix='/usr/local' --install-data=/data/apps/moin

参数说明：

--force：安装时，如果系统中已存在同名的文件，会覆盖系统中的文件

--record：生成一个文本文件，记录安装得文件信息

--prefix：Moin的安装地址。安装Moin之后，其实就是往prefix/bin中加入一个moin可执行文件，往prefix/lib/python2.5/site-packages中加入MoinMoin的python模块，往prefix/share/中加入moin的配置文件。所以强烈建议，安装到/usr/local就可以了

--install-data：详细指出本应该安装到prefix/share的moin配置文件应安装到何处。例如，我设定的参数值为/data/apps/moin，安装时就把share目录之下的所有文件都放到/data/apps/moin下，目录结构是这样/data/apps/moin/share/moin

6.为搭建第一个wiki工程，修改MoinMoin配置。将prefix/share/moin/config/wikifarm目录下的文件拷贝到prefix/share/moin/server目录。prefix/share/moin/config目录中都是配置的示例文件，开发者可以在此基础之上进行配置，而不用重新写一个。prefix/share/moin/server是moin的核心配置目录，在该目录下有如下文件需要修改：

moin.wsgi：官方推荐使用wsgi方式运行，所以我们在使用之前要对此文件做一些配置。要修改的就是几处往系统PATH变量中添加路径：

sys.path.insert(0, '/usr/local/lib/python2.5/site-packages') 添加MoinMoin模块的父目录，能让python找到

sys.path.insert(0, '/data/apps/moin/share/moin/server')     添加放置MoinMoin的配置文件的目录

log.load_config('/data/apps/moin/share/moin/config/logging/logfile')  添加python logging的配置文件，该文件就在prefix/share/moin/config/logging/目录下

mywiki.py：该文件配置了工程目录的路径，我的第一个wiki配置如下：

sitename = u'MyWiki' interwikiname = u'MyWiki' page_front_page = u"FrontPage" data_underlay_dir = '/data/apps/moin/mywiki/underlay/' data_dir = '/data/apps/moin/mywiki/data/'

然后，将prefix/share/moin/data/目录下的所有文件拷贝到data_dir目录下，将/prefix/share/moin/underlay目录下的所有文件拷贝到data_underlay_dir目录下。

7.添加Apache虚拟主机配置。我的配置如下：

<VirtualHost *:80> ServerAdmin zhoulong@kingsoft.com DocumentRoot /data/apps/moin/mywiki ServerName www.mywiki.com ServerAlias wiki.zhoulong.com ErrorLog "logs/error_log" CustomLog "logs/access_log" common WSGIScriptAlias /mywiki /data/apps/moin/share/moin/server/moin.wsgi <Directory /data/apps/moin/mywiki> Order allow,deny Allow from all </Directory> <Directory /data/apps/moin/share/moin/server> Order allow,deny Allow from all </Directory> </VirtualHost>

最后，确定运行apache的用户和用户组对工程目录都有操作的权限。

哈哈，跑起来了。。。