帮助-安装/基本安装

如何在你的系统上实现MoinMoin的基本安装

目录

目录

  1. 检查Python是否正常工作
  2. 下载MoinMoin
  3. 安装 MoinMoin
    1. 安装到系统默认位置
    2. 安装到home目录或者其他指定位置
  4. 安装测试
  5. 安装了什么

在你把MoinMoin整合到网络环境之前，必须使用Python标准的distutils机制(setup.py')安装MoinMoin源代码和数据文件。本页面向你解释其一般实现步骤。对于distutils安装的详细过程，请参考你的Python文档 Installing Python Modules。

在Windows下和Linux下的安装过程是类似的，简单起见，我们在此文档中以"Linux"为例。

(!) 我们使用类似> command arguments这样的文字来表示你应该在命令行（或者shell, 终端等）下输入的命令。 在我们的例子中，> 是提示符，你不需要输入它，需要输入的是跟在它后面的文字。不是以> 开头的那些行表示输入命令后得到的结果。请仔细阅读。

检查Python是否正常工作

MoinMoin需要Python才能运行，所以第一步就是要检查是否安装了可以使用的Python版本以及安装是否正确。如果有问题，你必须先修复它。

在MoinMoin归档中的"CHANGES"文件中给出了需要的Python版本。Python2.3是MoinMoin 1.5所需要的最低版本，但是我们建议你使用最新的Python版本。

你可以在 http://www.python.org/download/下载Python。

如果你非常肯定已经安装了可接受的Python版本，但是下面的命令却不能正常工作，那么可能是因为你的Python文件不在搜索路径中。关于正确设置所索路径，已经超出了本文档的范围了；请在你喜欢的Python，Linux，或者Window讨论区提问。

如果你可以使用shell，检查Python的状态就非常简单了。只要输入下面的命令，然后看看结果就可以： 

> python -V
Python 2.3.4

如果你不能使用shell，可以使者使用下面这个pythontest.cgi脚本（假设你使用的是Linux类型的网络服务器）。将此脚本上载到你的cgi-bin目录，使用chmod a+rx pythontest.cgi（或者在你的FTP程序中类似的命令）将此脚本变为可执行文件，然后使用网络浏览器调用它。 

echo Content-Type: text/plain
echo
echo "Your web server is running as:"
id
echo "CGI scripts work"
echo "Now we try to invoke Python interpreters and get their versions:"
python -V 2>&1
python2.3 -V 2>&1
python2.4 -V 2>&1
echo "Finished."

如果没有显示"CGI scripts work"，那么CGI脚本没有正常工作。如果没有显示一个或者多个Python版本号，那么Python没有正确安装。这两种情况下，你必须与服务器的系统管理员联系以便修正这些问题。

在你已经完成了这里说明的../BasicInstallation，请一定要读一读 ../ApacheOnLinuxFtp。

下载MoinMoin

要下载发行包，请到 下载区 获得最近的归档。

下一步是解压发行包（如果你现在读的这些文字在硬盘上，说明你已经上完成了此项工作）。如果你在网络上读到这些文字，发行包是一个 带有版本号的.tar.gz压缩包，你可以按照下面的方法来解压。

发行包通常会解压到一个名字为moin-<verion>的目录下，比如moin-1.5。

这个例子演示你如何（使用GNU tar）解压发行包，并进入MoinMoin文件所在的目录： 

> tar xzf moin-1.5.0.tar.gz
> cd moin-1.5.0

安装 MoinMoin

你可以将MoinMoin安装到以下任意一个目录：

安装到系统目录比较容易，所以尽量选择这种方式。

/!\ 如果你安装了多个版本的Python，请使用相同版本的Python来安装和运行wiki。通常，最新版的Python会有最好的结果。

如果你在安装中使用setup.py有问题，请试一下这个命令： 

> python -v setup.py --quiet install --record=install.log

附加的-v标志会给你提供安装过程中每一步的详细信息。

/!\ 在Linux上，如果得到类似Invalid Python installation: cannot find /usr/lib/Python2.x/config/Makefile的错误，可能是因为没有安装Python模块distutils，它通常是Python开发库 (python-dev)的一部分。一些Linux发行版可能缺省状态下没有安装它。例如，在Mandrake上，你要安装python-devel 包, 在Debian上它的名字是python-dev.

1. 安装到系统默认位置

> python setup.py --quiet install --record=install.log

这个命令把MoinMoin安装系统默认位置（一般是Python目录，例如在Linux下，在/usr/lib和/usr/share里）。在install.log文件里可以看到安装的你容以及安装位置。

它把共享文件安装到'/usr/local/share/moin'，取代不方便的系统目录。

2. 安装到home目录或者其他指定位置

Linux例子，安装到home目录： 

> python setup.py --quiet install --prefix=$HOME --record=install.log

Windows例子，安装到C:\moin目录： 

> python setup.py --quiet install --prefix="C:\moin" --record=install.log

所有的MoinMoin文件将被安装到这些目录中，install.log记录着那些文件被安装以及它们的安装位置。

注意： 你可能会看到下面的警告：

警告中给出了信息，你需要把你的安装目录增加到Python的搜索路径中，否则它没法找到MoinMoin代码。

比如，如果你使用网络服务器和标准CGI，那么编辑moin.cgi，把你的安装目录增加到Python路径中，就像这样： 

import sys
sys.path.insert(0, 'C:/moin')

安装测试

最后一步，如果你能使用shell或者命令行，可以检查安装是否正确可以运行。运行Python并输入import MoinMoin。对此命令应该没有任何东西显示。例如： 

> python
Python 2.3.4 (#1, May 29 2004, 17:05:23)
[GCC 3.3.3] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> import MoinMoin
>>>

如果你得到这样的结果： 

>>> import MoinMoin
Traceback (most recent call last):
  File "<stdin>", line 1, in ?
ImportError: No module named MoinMoin
>>>

那么你不得不调整你的安装了。试着像上面所说的那样修改sys.path。

安装了什么

现在，你有一个随时可以运行的MoinMoin了。祝贺你！在继续配置它之前，看一看已经被安装的文件以及它们所在的目录。

/!\ 这一步很重要，你应该了解MoinMoin安装中使用的不同目录，所以请仔细阅读。

在下面的描述中，PREFIX是随setup.py一起使用的选项，或者如果你没有使用--prefix选项时的默认位置。（一般Linux上的默认位置 是/usr and /usr/local）X.Y是Python的版本。一般是2.3或者2.4。

看一看install.log，找到下面这些重要的位置：

在share目录我们谈到模板， 因为你通常不会使用那些目录下的文件，而是当需要时把它们拷贝到其他地方。这样，你可以建立多个wiki，而且容易升级到新MoinMoin版本。

此页的英文版本：HelpOnInstalling/BasicInstallation