MoinMoin Wiki 在IIS下的安装与升级

    MoinMoin Wiki的安装和升级是比较简单的, 但仍然有一些细节的地方需要注意. 本文针对的Wiki版本为1.5以上, CGI方式的单Wiki安装, 操作系统为Windows 2003. 其他配置方面的详细信息请参照官方主页或Wiki自带文档. 

1. 准备工作

首先需要在http://www.python.org/download/ 下载最新的Python for Windows的安装版本. 安装Python的过程不再赘述, 一路Next即可. 然后在http://moinmoin.wikiwikiweb.de/ 下载MoinMoin Wiki的最新安装包.

本文示例中的环境:

主机名: simonw-server
Python版本为2.5,
Python安装路径为 c:\python25,
Wiki版本为1.5.7,
Wiki解压安装文件目录为 c:\moininstall,
Wiki安装目录为 c:\moin

以上环境请根据你自己的实际情况酌情变更.  

1. 安装Wiki

执行安装命令来生成Wiki所需的文件. 在CMD命令行模式下执行:

C: 
Cd C:\MoinInstall\moin-1.5.7 
C:\python25\python.exe setup.py --quiet install --prefix="c:\moin" --record=install.log

执行完毕后将在c:\moin下生成Lib(主运行程序), Share(Wiki实例的模板), Scripts三个子目录. 
 

1. 创建Wiki实例

• 在c:\moin目录下建立一个Wiki实例的目录, 我这里暂叫simonwwiki, 需要将Share目录下的一些模板拷贝到c:\moin\simonwwiki中.

  在CMD命令行模式下执行:

  Cd c:\moin
  md simonwwiki
  md simonwwiki\data
  md simonwwiki\underlay
  xcopy share\moin\data simonwwiki\data /E
  xcopy share\moin\underlay simonwwiki\underlay /E
  copy share\moin\server\moin.cgi simonwwiki\
  copy share\moin\config\wikiconfig.py simonwwiki\
  copy share\moin\htdocs\index.html simonwwiki\default.htm

  主要就是拷贝了data(Wiki用户数据页面目录), underlay(Wiki系统文档页面目录)文件夹和moin.cgi(主调用程序), wikiconfig.py(Wiki配置文件), default.htm(过渡转接页面)文件.  

• 打开moin.cgi文件, 加入以下2项配置
  
  指明Wiki程序位置
  sys.path.insert(0, ' c:/moin /lib/site-packages')

  指明wikiconfig.py配置文件的位置
  sys.path.insert(0, ' c:/moin/simonwwiki')  

• 中文化配置, 打开wikiconfig.py
  将顶上的编码改为 # -*- coding: utf-8 -*- 以便处理中文字符
  添加或修改已有配置代码为:
  
  

  language_default = 'zh'
  page_category_regex = u'^Category[A-Z]|类$'
  page_dict_regex = u'[a-z]Dict$|字典$'
  page_form_regex = u'[a-z]Form$|表$'
  page_group_regex = u'[a-z]Group$|组$'
  page_template_regex = u'[a-z]Template$|模板$'

  其实这些都可以自定义不过用默认的兼容性会更好些也方便日后升级.  

 

1. 配置IIS

• 建立一个站点, 设置其主目录为c:/moin/simonwwiki
  a. 创建为应用程序.
  b. IIS权限为读取, 执行权限为纯脚本.
  c. 去掉其子目录data和underlay目录的IIS读取权限.
  d. 配置应用程序扩展, 添加一个.cgi的扩展.   

  可执行文件为 "c:\Python25\python.exe" -u "%s" "%s"
  扩展名  .cgi
  动作: 全部动作
  脚步引擎打勾, 确认文件是否存在去掉勾.

  e. 自定义错误处将404错误设置为默认值, 否则无法创建新Wiki页面.  

• 将c:\moin\share\moin\htdocs设置为此站点下名称是wiki的虚拟目录,使用默认设置. 这里主要是一些web需要的静态文件, 站点皮肤, css, 图片等文件.  

• 设置IIS的Web服务扩展, 添加 c:\Python25\python.exe -u "%s" "%s" 允许.  
  
• 子目录data和underlay的文件权限, 在资源管理器里或IIS里右键单击权限处, 赋予IUSR_ simonw-server用户这两个目录的写入修改权限, 这样程序方可创建Wiki页面. 
   
• 应用程序池使用默认Network Service账户即可, 特殊情况下可以使用本地账户, 建议为Wiki使用单独应用程序池. 
   
• 主页上http://localhost/moin.cgi/SystemPagesSetup 安装中文语言包. 

 

1. 升级

    所有用户数据在c:\moin\simonwwiki中, 如果你有自定义皮肤, 则会在c:\moin\share\moin\htdocs中, 所以备份好这2个目录即可. 升级过程很简单. 备份后, 删除除了c:\moin\simonwwiki, c:\moin中的所有东西, 执行步骤2的安装Wiki步骤, 重建名为Wiki的虚拟目录. 整个过程无需停止或重启IIS.

    另外如果系统文档有更新你需要重新拷贝Share中的underlay到c:\moin\simonwwiki中替换已有目录, 之后你需要重新在主页上安装中文语言包.