MoinMoin......

这些天在做一个Research，就是接下来的一个项目的技术选型，最终这些东西都汇总到一个openoffice的文档中。但是我越来越不喜欢这种写文档的方式，首先这些office的文档都是二进制的，对搜索引擎不友好，更重要的是，我觉得写文档和软件开发一定程度上是由共性的，就是说是一个迭代和增量的过程，需要不断的反馈，需要集体的协作。我想要的写文档的方式应该是多个人一起完成初稿，然后所有的相关人员都可以来浏览，来编辑，来提意见，就是wikipedia的方式，当然一个专职的文档维护人员（或者一个维护委员会）是必须的，由他来最终确定哪些修改是好的，哪些意见是应该被抛弃的。最后，文档应该是公开的，易于查看，相关文档应该彼此链接，不应该藏在svn的某个深深的角落。
WikiWiki可以解决这个问题，我觉得可以一个主要编写人员首先列出提纲，然后每个部分都有专业的人员来编写，而这个文档随时任何相关人员都可以查看，可以提意见，最终依靠集体的力量完成文档。传统的方式都是一个人完成文档，然后组织大家一起来讨论，然后继续修改，继续讨论。这种方式的效率不高，这要求审核人员必须在特定的时间段里去阅读文档，进行讨论，而审核人员到底付出多大的精力去阅读这篇文档很重要。就目前的经历来看，审核人员通常都不会在这件事情上花多少力气，所以审核的质量非常低。通过wiki的方式，大家可以更深刻的参与到文档的编写工作中来，每个人都随时可以查看文档的进度，可以添加注释，可以直接修改。
下面就说说wiki系统的安装，因为我决心要学习python，所以专门找了一个python的wiki系统，MoinMoin，很多大型网站都采用了这个wiki系统，尤其开源网站，它们更有动力采用wiki来促进社区的交流。

操作系统：Ubuntu 7.10 Desktop, linux kernel 2.6.22-14-generic
Python : 2.5.1
WebServer: lighttpd 1.4.18 (ssl)
MoinMoin: 1.6.3

::安装过程可以查看MoinMoin发布包中自带的Install.html
1. 确认python和lighttpd都已经安装成功。 一般来说ubuntu系统已经自带了python，而安装lighttpd也非常简单，执行'sudo apt-get install lighttpd'就可以了。

• 在控制台执行'python', 出现python提示符'>>>'就表示python已经安装成功了。
• 执行'lighttpd -D -f /etc/lighttpd/lighttpd.conf'， 然后在浏览器中访问'http://localhost'，看到html页面就表示lighttpd安装成功了。

2.下载MoinMoin, 解压缩发布包之后，进入安装文件目录，在控制太执行安装命令：
>>>python setup.py install --prefix='/usr/local' --record=install.log
其中， --prefix表示安装目标目录，如果不指定，那么会安装到默认目录，通常是/usr/lib/python2.5/site-pakcage/moin和/usr/share/moin; --record表示安装日志，可以从中看出哪些文件被copy到哪个目录了。
NOTE:更多信息可以参考moinmoin的install.html
3. ....关于moin的配置请参考moinmon的install.html
4. 配置FasgCGI。如果CGI方式，那么每个请求相应的cgi文件都会被重新load，这样会极大的影响的性能， 而FastCGI方式只需要在第一次请求的时候load脚本，然后这些脚本就会被缓存下来，这样可以大大提高性能，此外，FasgCGI是一个单独运行的网关进程，就算webserver崩溃也不会影响到它。在多核的环境下，FastCGI是个不错的选择。mod_python是运行在webserver中的一个线程，在超线程的环境下可能表现更好。lighttpd不支持mod_python。
lighttpd是一个高性能的，轻型的（相较与apache），高度模块化的webserver，它需要在配置文件lighttpd.conf中指定装载fcgi模块，并且配置fcgi相应的参数。
note: 可以参考install.html中的'deploying in lighttpd'

• 设定装入fcgi模块:

  server.modules              = (
                              "mod_access",
                              "mod_rewrite",      # <--- IMPORTANT!                                "mod_status",                                "mod_fastcgi",      # <--- IMPORTANT!                                "mod_accesslog",                                "mod_redirect",                                "mod_auth",                                "mod_expire", )

• 配置fasgcgi模块，
  

  $HTTP["host"] =~ "^127.0.0.1" {
  url.rewrite-once = (
      "^/robots.txt" => "/robots.txt",
      "^/favicon.ico" => "/favicon.ico",
      "^/moin_static163/(.*)" => "/$1",  #所有的media文件url都是以moin_static163开头的
      "^/(.*)" => "/wiki-engine/$1" #除了media文件和robots，favicon外的请求都送到fastcgi server
  )
  server.document-root        = "/usr/share/moin/htdocs/"
  #url以wiki-engine开始的都送到fastcgi。 url会被rewrite模块重写，可以看前面的定义url.rewrite-once
  $HTTP["url"] =~ "^/wiki-engine/" {
    fastcgi.server = ( "/wiki-engine" =>
      (( "docroot"   => "/",
         "min-procs" => 10,
         "max-procs" => 10,
         "max-load-per-proc" => 2,
         # allocate successive port numbers for each process, starting with "port"
         "bin-path"  => "/opt/mylib/moin-1.6.3/moin.fcg", #如果由lighttpd来启动fastcgi，那么需要指定这个值
         "host"      => "127.0.0.1",
         "port"      => 3060,
         "check-local" => "disable",
      ))
    )
  }
  }

一般来说，由于指定了bin-path参数，所以lighttpd会自动启动一个fastcgi进程，不需要额外的在外面手动启动一个fastcgi进程。 如果没有指定，那么需要手动在外面启动fastcgi进程，同时保证指定的host，port与fastcgi server的定义是一致的。 lighttpd和fastcgi server之间通过tcp socket通信，也可以直接通过unix-domain socket（IPC socket，进程间通信）通信，这个需要指定fastcgi.server的socket参数，host+port和socket只能采用一种。
5.这里反过来再提一下MoinMoin的配置。我的MoinMoin是安装到默认目录，即/usr/lib/python2.5/site-package/moin和/usr/share/moin，前面一个目录放置的是moinmoin的python源代码， /usr/share/moin放置的是模板代码（html，img，css等）和数据文件（保存用户数据，比如page， comments，user等）。然后我又把/usr/share/moin中的data， underlay，wikiconfig.py, moin.fcg复制到/opt/mylib/moin目录，这个目录叫做MoinMoin的一个实例。就是说你可以同时运行多个实例，它们分别有自己的名称空间，彼此不会影响，但是共用htdocs。
此外，需要注意的是权限问题，由于lighttpd是以www-data的用户运行，而fastcgi程也是它启动的，即fastcgi server也是以www-data的用户运行的，那么www-data必须具有/opt/mylib/moin目录读写执行权限。 总之要注意权限问题。但是如果fastcgi是通过手动单独在外面启动的，那么启动这个进程的用户必须具有读写执行/opt/mylib/moin的权限，这样的话，它是独立与lighttpd的权限系统之外的，可以另外设置权限规则。