帮助目录 > 帮助-系统管理 > 帮助-安装

如何安装 MoinMoin 维基

本页面讲解MoinMoin的安装过程. 在下一节中有将有具体环境中的安装简介,那会帮助你理解怎样把这些指令应用到各个不同的环境中去。假如你已经有了一个正在运行的Wiki想升级,请看帮助-升级.

MoinMoin的安装过程可以分为以下几个基本的步骤:

  • /基本安装 详细解释"setup.py"的安装步骤. 它将MoinMoin代码和维基模版安装你的系统上. 这部分适用于所有情况, 在安装之前你应该通读一遍.

  • /创建维基例程 解释如何创建一个新的维基例程(数据和设置). 这部分也适用于所有情况.

  • 设置网络服务器
    • 确定使用哪一个种解决方案(看下面).
    • 让web服务器提供以/wiki为前缀的URL下的静态资料的访问服务,像主题CSS和图片等等。对于可以使用的各种web服务器来说,这一部分可能会有些许的不同,参考下面详细部分。

    • 当访问维基网页的时候,让web服务器来执行moin代码。这可以通过公共网关接口(CGI),FastCGI,mod_python或者Twisted或者内部集成的独立服务器来实现-对于可以使用的各种web服务器来说,这一部分可能会有些许的不同,参考下面详细部分。
  • 安装成功后, 你可以阅读有关维基管理员所能进行的设置以及其他选项的文档. 帮助-系统管理包含相关主题的页面链接. 特别是帮助-系统设置帮助-升级页面提供了关于维基安装和维护的更多信息.

  • /问题解答帮助你解决任意常见问题, 其适用任何安装平台.

使用发行版

你可以使用发行包 (比如Linux发行版中自带的版本),而无需下载。但通常它们不是最新版的。安装方法没有太大区别,你也需要自己创建维基例程。有一些发行包已经预先做好了配置文件,你只需 /创建维基例程,因为共享内容已经放置好了。

安装环境

以下部分向你演示具体的安装过程,包括使用的命令及其作用。在进行实际安装之前,你必须阅读上面关于安装的一般信息。

个人维基

个人或者小型工作组使用的维基. 除了Python和MoinMoin之外不需要其他任何东西.

  • /独立服务

    • 注意: 目前独立服务比Twisted快, 但不支持多界面/端口.

使用CGI的公共维基

CGI经过良好测试,设置简单但是运行速度慢.

独立模式

速度很快,可以运行在Apache的mod_proxy模式下.

高性能公共维基

速度比CGI快得多, 但是相对难以安装和设置.

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

维基农场

一份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