如何安装 MoinMoin 维基
本页面讲解MoinMoin的安装过程. 在下一节中有将有具体环境中的安装简介,那会帮助你理解怎样把这些指令应用到各个不同的环境中去。假如你已经有了一个正在运行的Wiki想升级,请看帮助-升级.
MoinMoin的安装过程可以分为以下几个基本的步骤:
/基本安装 详细解释"setup.py"的安装步骤. 它将MoinMoin代码和维基模版安装你的系统上. 这部分适用于所有情况, 在安装之前你应该通读一遍.
/创建维基例程 解释如何创建一个新的维基例程(数据和设置). 这部分也适用于所有情况.
- 设置网络服务器
- 确定使用哪一个种解决方案(看下面).
让web服务器提供以/wiki为前缀的URL下的静态资料的访问服务,像主题CSS和图片等等。对于可以使用的各种web服务器来说,这一部分可能会有些许的不同,参考下面详细部分。
- 当访问维基网页的时候,让web服务器来执行moin代码。这可以通过公共网关接口(CGI),FastCGI,mod_python或者Twisted或者内部集成的独立服务器来实现-对于可以使用的各种web服务器来说,这一部分可能会有些许的不同,参考下面详细部分。
安装成功后, 你可以阅读有关维基管理员所能进行的设置以及其他选项的文档. 帮助-系统管理包含相关主题的页面链接. 特别是帮助-系统设置和帮助-升级页面提供了关于维基安装和维护的更多信息.
/问题解答帮助你解决任意常见问题, 其适用任何安装平台.
使用发行版
你可以使用发行包 (比如Linux发行版中自带的版本),而无需下载。但通常它们不是最新版的。安装方法没有太大区别,你也需要自己创建维基例程。有一些发行包已经预先做好了配置文件,你只需 /创建维基例程,因为共享内容已经放置好了。
安装环境
以下部分向你演示具体的安装过程,包括使用的命令及其作用。在进行实际安装之前,你必须阅读上面关于安装的一般信息。
1. 个人维基
个人或者小型工作组使用的维基. 除了Python和MoinMoin之外不需要其他任何东西.
注意: 目前独立服务比Twisted快, 但不支持多界面/端口.
2. 使用CGI的公共维基
CGI经过良好测试,设置简单但是运行速度慢.
- 如果你有FTP权限, 可以选择这种方式.
3. 独立模式
速度很快,可以运行在Apache的mod_proxy模式下.
4. 高性能公共维基
速度比CGI快得多, 但是相对难以安装和设置.
5. A minimalistic wiki
Sometimes you want to install a wiki that is only made of the minimal components. How you set this up and how you add additional components is decribed in /MinimalWiki
6. 维基农场
一份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