Octave 的安装
为 MoinMoin 添加 gnuplot 扩展

MoinMoin 安装简明指南

lyanry posted @ 2007年7月29日 02:38 in 我爱用Gentoo with tags python wiki moinmoin , 120178 阅读

修改声明：由于 MoinMoin 版本已由原来的 1.5.8 更新为 1.6.0，是故以对本文所讲述的 MoinMoin 1.5.8 版的安装过程作出了适应性修改。

简介

MoinMoin是用 Python 语言写的一个开源 WiKi 引擎，由德国人开发，基于GNU GPL协议发布。MoinMoin 的软件架构很灵活，通过 Python 能很容易进行功能扩展，现在已开发出大量的 Plugins。MoinMoin 不使用后台数据库存放数据，而是以文本的形式存放在服务器目录中。Moin是德国北部方言"好"、"早上好"的意思，MoinMoin是"很好"的意思。

许多知名网站使用了 MoinMoin，比如 Fedora 项目 Wiki、Ubuntu 社区 Wiki、Gnome Live 等。可以看一看 MoinMoin 的ScreenShots ，然后再决定是否要装一个来玩。

注意：如果打算安装 MoinMoin，首先要确认系统有没有安装 python 与 apache2。

下载

目前，MoinMoin 最新版本是 1.6.0，下载地址：
http://static.moinmo.in/files/moin-1.6.0.tar.gz

为了下文叙述方便，假定 MoinMoin 包下载后解压缩至 /opt/moinmoin-1.6.0 目录。

安装MoinMoin 引擎

在终端进入 /opt/moinmoin-1.6.0 后，执行 MoinMoin 安装脚本 setup.py：

  1. # python -v setup.py --quiet install --record=install.log

安装完后，如未发现出错信息，可以在当前目录下看一看安装时输出的日志文件，可以看到 MoinMoin Wiki 引擎默认被安装在 /usr/lib/python2.x/site-packages/MoinMoin 目录下，MoinMoin Wiki 模板文件被安装在 /usr/share/moin 目录下。

/usr/share/moin 目录下有这样一些重要目录：

  • /usr/share/moin/data：存放WiKi Pages,Users,etc。只能被MoinMoin访问。
  • /usr/share/moin/underlay：存放默认的WiKi Pages，有多种语言版本的帮助文档、默认页面文档等。只能被MoinMoin访问。
  • /usr/share/moin/htdocs：存放网页元素，如图片、主题风格等。可被Web Server（Apache、IIS等）访问。
  • /usr/share/moin/server：存放服务器启动脚本示例。
  • /usr/share/moin/config：存放配置文件示例。

通过拷贝模板文件，就可生成不同的 Wiki 实例（即多个 Wiki 站点，Wiki Farm）。另外，MoinMoin 的软件升级也很简单，只需用新版本的模板文件覆盖旧的就可以了。

安装 MoinMoin Wiki 实例

这里只讲述一个 Wiki 实例的安装，多个 Wiki 实例的安装与此是同样的道理。关于多个 Wiki 实例的安装与配置请参考 Wiki Farming 文档，我曾经尝试过，但是很不幸，没有成功。后来用了一种好像很笨的方法才可以。

首先选定 Wiki 实例的安装位置，本文假定是安装在 /usr/local/var/wikis 目录下。

然后将 MoinMoin Wiki 模板目录中的 data、underlay、wikiconfig.py 复制到Wiki 实例目录：

  1. # cp -rf /usr/share/moin/data    /usr/local/var/wikis
  2. # cp -rf /usr/share/moin/underlay   /usr/local/var/moin
  3. # cp /usr/share/moin/config/wikiconfig.py  /usr/local/var/moin

下一步是设置 Wiki 实例目录权限，以便 Web 服务器有权限访问页面，gentoo 下 apache 默认用户组与用户均为 apache（在 Debian、Ubuntu 系统中，apache 默认用户组与用户是 www-data），Wiki 实例目录权限设置如下：

  1. # chown -R apache.apache    /usr/local/var/wiki
  2. # chmod -R ug+rw     /usr/local/var/wiki
  3. # chmod -R o-rwx     /usr/local/var/wiki

配置 apache + mod_python 环境

此举是让 apache2 配合 python 生成 MoinMoin Wiki 页面，但是 apache2 与 python 的配合需要由apache 模块 mod_python 的支持才能实现。

首先要安装 mod_python，Gentoo Linux 下可以使用 emerge 安装，其他 Linux 发行版的软件仓库中通常也有 mod_python，请按照相应的安装方法进行。

  1. # emerge -avt  mod_python

在 Gentoo Linux 下可以修改 /etc/conf.d/apache2 文件启用 apache 的 Python 选项（其他 Linux 发行版，请参阅相应的 apache 配置文档），即在 “APACHE2 OPTS” 项中添加 “-D PYTHON”：

  1. APACHE2_OPTS="-D DEFAULT_VHOST -D INFO -D LANGUAGE -D SSL -D SSL_DEFAULT_VHOST -D SUEXEC -D PYTHON"

最后还需要让 apache 能够找到 Wiki 实例所在位置，可在 apache2 配置文件 (通常是 /etc/apache2/httpd.conf) 底部中添加以下信息：

  1. Alias /moin_static160 "/usr/share/moin/htdocs"
  2. <Directory /usr/share/moin/htdocs>   ### 开放目录权限
  3.         Order allow,deny
  4.         Allow from all
  5. </Directory>
  6.  
  7. <Location /moin>
  8.         SetHandler python-program
  9.         PythonPath "['/usr/local/var/wiki/'] + sys.path"
  10.         PythonHandler MoinMoin.request::RequestModPy.run
  11. </Location>

上述 apache2 配置文件的修改，在使用 Alias 指令指定 MoinMoin Wiki 系统模板的别名后，应当开放其访问权限，这一点很重要，如果不这样设定，那么 MoinMoin 安装完毕后，可能无法访问 Wiki 主题样式。

修改完后，重启 apache2：

  1. # /etc/init.d/apache2 restart

配置 MoinMoin 环境

这是最后一步，对 Wiki 实例目录下的 wikiconfig.py 文件进行一些修改。由于这个文件默认是 iso-8859-1 编码的，若在该文件中输入中文，保存时会出现乱码，所以在修改之前，自己想办法把文件转换为 utf-8 编码的，可以使用 iconv 进行编码转换。

对该文件几处必要的修改处如下：

  1. # -*- coding: utf-8 -*-                         #使用UTF-8编码
  2. from MoinMoin.multiconfig import DefaultConfig
  3. class Config(DefaultConfig):
  4.  
  5.     # 要用绝对路径!
  6.     data_dir = '/usr/local/var/wiki/data/'
  7.     data_underlay_dir = '/usr/local/var/wiki/underlay/'
  8.  
  9.     url_prefix = '/moin_static160'
  10.  
  11.     # 在此预先设定管理员账户名，待 MoinMoin Wiki 配置完成后，
  12.     # 再注册该账户，该即成为管理员
  13.     superuser = [u"silence", ]
  14.  
  15.     navi_bar = [
  16.         u'%(page_front_page)s',
  17.         u'RecentChanges',
  18.         u'FindPage',
  19.         u'HelpContents',
  20.     ]
  21.    
  22.     #设定页面主题，也就是页面样式或者皮肤
  23.     theme_default = 'modern'
  24.    
  25.     # 设置默认语言环境为中文
  26.     language_default = 'zh'
  27.  
  28.     page_category_regex = u'^Category[A-Z]'
  29.     page_dict_regex = u'[a-z]Dict$'
  30.     page_form_regex = u'[a-z]Form$'
  31.     page_group_regex = u'[a-z]Group$'
  32.     page_template_regex = u'[a-z]Template$'
  33.  
  34.     show_hosts = 1   

ok，配置工作基本完成了，现在如果不放心，再重新启动一次 apache2，然后就可以访问你的 MoinMoin wiki 了。

访问 MoinMoin Wiki

在 IE 地址栏里键入“http://localhost/wiki” ，看看是否可以正常显示 Wiki 页面。如果你按照以上步骤，结果 MoinMoin Wiki 无法正常启用，可在下面给我发送评论。

MoinMoin Wiki 安装完后，还是要配置一些东西，但这只是美化页面的事情，待日后慢慢讲来。

 

参考文献

Small_feed 评论 (4)
1
[回复]
Avatar_small
hello 说:
2009年8月12日 07:19

你好。当我配置好httpd.conf。重启apache，出现错误：
Invalid command 'PythonPath', perhaps misspelled or defined by a module not included in the server configuration

2
[回复]
Avatar_small
aestik 说:
2010年7月06日 19:03

您好，我访问时出现这个提示
This is the root URL of moin's static files. You need to go to the script URL to use the wiki.

3
[回复]
Avatar_small
alswl 说:
2011年12月13日 23:06

正在配置nginx的FastCGI，头疼了

4
[回复]
Avatar_small
net worth 说:
2021年11月03日 22:52

Checking out the information of any celebrity on idol net worth to know how much their name and fame worth and their family members.


登录 *


loading captcha image...
(输入验证码)
or Ctrl+Enter