1. 如何安装你自己的MoinMoin维基
本页面讲解MoinMoin的安装过程. 在下一节中有一系列真实的Installation Scenarios 帮助你理解如何在不同环境下应用这些建议. 如果你想升级一个已经在运行中的维基, 请看帮助-升级.
MoinMoin的安装只需一些基本步骤:
/基本安装 详细解释"setup.py"的安装步骤. 它将MoinMoin代码和维基模版安装你的系统上. 这部分适用于所有情况, 在安装之前你应该通读一遍.
/创建维基例程 解释如何创建一个新的维基例程(数据和设置). 这部分也适用于所有情况.
- 设置网络服务器
- 确定使用哪一个种解决方案(看下面).
让web服务器提供以/wiki为前缀的URL下的静态资料的访问服务,像主题CSS和图片等等。对于可以使用的各种web服务器来说,这一部分可能会有些许的不同,参考下面详细部分。
- 当访问维基网页的时候,让web服务器来执行moin代码。这可以通过公共网关接口(CGI),FastCGI,mod_python或者Twisted或者内部集成的独立服务器来实现-对于可以使用的各种web服务器来说,这一部分可能会有些许的不同,参考下面详细部分。
安装成功后, 你可以阅读有关维基管理员所能进行的设置以及其他选项的文档. 帮助-系统管理包含相关主题的页面链接. 特别是帮助-系统设置和帮助-升级页面提供了关于维基安装和维护的更多信息.
/问题解答帮助你解决任意常见问题, 其适用任何安装平台.
2. 安装场景
以下部分将会向你展示安装期间的具体实例,展示将会使用得到的命令以及这些命令将会做些什么。在执行下面连接的网页描述的安装步骤之前,你必须首先阅读上面所提到的通用安装信息:
2.1. 个人维基
个人或者小型工作组使用的维基. 除了Python和MoinMoin之外不需要其他任何东西.
注意: 目前独立服务比Twisted快, 但不支持多界面/端口.
2.2. 使用CGI的公共维基
CGI经过良好测试,设置简单但是运行速度慢.
- 如果你有FTP权限, 可以选择这种方式.
2.3. 独立模式
速度很快,可以运行在Apache的mod_proxy模式下.
2.4. 高性能公共维基
速度比CGI快得多, 但是相对难以安装和设置.
2.5. 维基农场
一份moinmoin源代码拷贝可以用于运行多个维基. 为你的维基创建一个目录, 然后在它下面, 按照[/创建维基例程]的指示创建两个data树. 在配置目录下(默认值是/usr/share/moin/config), 你会看到一个farmconfig.py的示例文件. 把它拷贝到农场目录, 然后编辑moin的启动脚本 (独立模式对应moin.py, cgi模式对应moin.cgi, 等等.) 把目录指向它.
farmconfig.py为每个维基"树"声明了正则表达式 - 几个树构成一个树农场. 它同时设置wikiconfig的默认选项(请看帮助-系统设置).
当URL匹配时, 其关键词将用于获得一个附加的(但可选的)配置文件. 这个例子描述了moin主站点和它的文档开发树(moinmoin and moinmaster). 所以, 当你访问 http://moinmoin.wikiwikiweb.de 时, URL匹配moinmoin, moinmoin.py是其所寻找的文件(而且与farmconfig.py在同一个目录下). 在moinmoin.py中, 其选项覆盖了farmconfig选项, wikiconfig处理停止, 然后moinmoin data树服务于访问者.
注意, 不匹配正则表达式的URLs不会被moin服务器处理. 如果你在独立模式下, 会出现一个错误页面. 也要注意, 只有关键词中包括wikiconfig时wikiconfig.py才会被读取; 农场有优先权。
此页的英文版本:HelpOnInstalling