查看“MoinMoin安装设置”的源代码

声明：由于本文是多人协同合作写成，如果你有不懂或者更好的建议，请自由编辑本文。前提在于你出于友好的目的。

== 安装MoinWiki ==
Apache配合mod_wsgi：在Apache上安装MoinMoin时推荐的部署，快速并且容易安装。
请使用包安装工具安装libapache2-mod-wsgi包，并且已经配置好apache。

=== 解压缩安装包 ===
将下载的压缩档解包，查看解压的文件：
其中只有2个目录是我们用得到的。
 - moin-1.9.0
    + MoinMoin - MoinMoin程序的源文件。
    + wiki - 模板文件。
我们将wiki目录称作''模板''是因为你通常不需要在该目录使用这些文件，只要将它们复制到你需要的地方。因此，你可以顺利建立多个wiki，并轻松将它们升级到新的MoinMoin版本。

=== 创建工作目录 ===
你需要创建至少两个目录：
* 源码目录
* wiki实例目录

我们这里分别在家目录里创建moinsource和mywiki两个相应目录。
 cd ~yourname/
 mkdir moinsource mywiki

复制相应的文件到这两个目录：
 cp -r moin-1.9.0/MoinMoin moinsource
 cp -r moin-1.9.0/wiki/config moinsource
 cp -r moin-1.9.0/wiki/server moinsource
 cp -r moin-1.9.0/wiki/data mywiki
 cp -r moin-1.9.0/wiki/underlay mywiki

实例目录必须设置如下权限：
 sudo chown -R www-data:www-data mywiki
 sudo chmod -R ug+rwX mywiki
 sudo chmod -R o-rwx mywiki

=== 修改配置文件 ===
==== 单个wiki配置 ====
moinmoin 的配置文件位于 moinsource/config/目录下面
如果是安装一个wiki则只要修改该目录下的wikiconfig.py文件：

请使用编辑器打开wikiconfig.py文件，修改以下变量的值，没有该变量请自行创建。（路径使用绝对路径）
必需设置的变量有：
* data_dir：指向你的wiki实例的data目录 /home/yourname/mywiki/data
* data_underlay_dir：!MoinMoin包含预制的系统和帮助页面，这些文件都在underlay目录下。它指向你的wiki实例的underlay目录 /home/yourname/mywiki/underlay
* interwikiname：这是你的wiki的一个简短具有描述性的标识符。它必须是唯一的并且以后不>能改变
* sitename：你的wiki网站的名字

==== 多个wiki配置 ====
如果你需要启用多个wiki，请创建多个与mywiki目录一样的目录，名字需改其他。
多个wiki的配置目录位于moinsource/config/目录的wikifarm目录下：

复制配置文件：
 cp mywiki.py wiki_1.py
 cp mywiki.py wiki_2.py
按照单个wiki配置的描述配置wiki_1和wiki_2。

配置wiki农场提示：
* 每个wiki需要不同的data_dir和data_underlay_dir
* 如果你想让两个wiki共享一些设置，把它们放到farmconfig.py中 - 两个wiki会从中继承这些设置
* 两个wiki中写入与farmconfig.py不同的设置
* 参考mywiki的设置

 wikis = [
 
     # wikiname, url regular expression
     # ---------------------------------------------------------------
     ("mywiki", r".*"),   # this is ok for a single wiki
 
     # for multiple wikis, do something like this:
     #("wiki1", r"^http://wiki1\.example\.org/.*$"),
     #("wiki2", r"^http://wiki2\.example\.org/.*$"),
 ]

将其改为：
 wikis = [
 
     # wikiname, url regular expression
     # ---------------------------------------------------------------
     #("mywiki", r".*"),   # this is ok for a single wiki
 
     # for multiple wikis, do something like this:
     ("wiki_1", r"^http://wiki1\.example\.org/.*$"),
     ("wiki_2", r"^http://wiki2\.example\.org/.*$"),
 ]

wiki_1对应的是Moin配置文件wiki_1.py，wiki_2同理，后面是域名匹配设置。

==== 启动文件配置 ====
使用编辑器打开 moinsource/server/moin.wsgi，找到：
 #sys.path.insert(0, 'PREFIX/lib/python2.3/site-packages')
将其改为：
 sys.path.insert(0, '/home/yourname/moinsource')

找到：
 #sys.path.insert(0, '/path/to/wikiconfigdir')
 #sys.path.insert(0, '/path/to/farmconfigdir')
根据需要改为：
单个wiki请改为：
 sys.path.insert(0, '/home/yourname/moinsource/config')
 #sys.path.insert(0, '/path/to/farmconfigdir')
多个wiki请改为：
 #sys.path.insert(0, '/path/to/wikiconfigdir')
 sys.path.insert(0, '/home/yourname/moinsource/config/wikifarm‘)

=== 路径设置 ===

==== 位于根路径的设置 ====
为了使web服务器找到MoinWiki的启动文件，你需要在Apache中配置文件中指定这些路径：
* Apache需要知道!MoinMoin的启动文件的路径，在我们的示例中为/home/yourname/moinsource/server/moin.wsgi。
* Apache需要知道wiki script根路径
为了做到这些，需要编辑Apache的虚拟主机配置文件，它们通常位于/etc/apache2/sites-available/目录下。

编辑与wiki对应的虚拟主机配置文件，在它的VirtualHost定义中加入：
 WSGIScriptAlias / /home/yourname/moinsource/server/moin.wsgi
即可。

==== 位于其他路径的设置 ====
如果wiki安装在网站/mywiki目录下(这意味着，你拥有/var/www/mywiki目录，如果没有请创建，该目录必须是空目录)，将其改为：
 WSGIScriptAlias /mywiki /home/yourname/moinsource/server/moin.wsgi
同时你还需要在配置文件中加入：
     url_prefix_static = '/mywiki/moin_static190'

=== 启动wiki ===
 sudo apache2ctl restart