/usr/share/moin/data目录存放WiKi Pages,Users,etc。只能被MoinMoin访问。

/usr/share/moin/underlay目录存放默认的WiKi Pages，有多种语言版本的帮助文档、默认页面文档等。只能被MoinMoin访问。

/usr/share/moin/htdocs目录存放网页元素，如图片、主题风格等。可被Web Server访问

/usr/share/moin/server目录存放服务器启动脚本示例。

/usr/share/moin/config目录存放配置文件示例。

首先，我们要安装好twisted，安装命令如下：

debian:~# apt-get install python2.4-twisted python2.4-twisted-bin

安装完Twisted后，就可以开始配置了。TwistedWeb的MoinMoin配置文件是mointwisted.py，执行文件是mointwisted，这两个文件我们可从模板目录拷贝到实例目录。如：

debian:~# cp /usr/share/moin/server/mointwisted mointwisted.py ~/mywiki

用vim等文本编辑器打开mointwisted.py配置文件，需修改两个地方，以指向正确的配置文件路径，修改后的内容如下：

"""
    twisted.web based wiki server

    Run this server with mointwisted script on Linux or Mac OS X, or
    mointwisted.cmd on Windows.
    
    @copyright: 2004-2005 Thomas Waldmann, Oliver Graf, Nir Soffer
    @license: GNU GPL, see COPYING for details.
"""

# System path configuration

import sys

# Path of the directory where wikiconfig.py is located.
# YOU NEED TO CHANGE THIS TO MATCH YOUR SETUP.
#sys.path.insert(0, '/etc/moin')
sys.path.insert(0,'/root/mywiki')     #修改1：指向你的wikiconfig.py文件所在的目录
# Path to MoinMoin package, needed if you installed with --prefix=PREFIX
# or if you did not use setup.py

# Path to the directory where farmconfig is located (if different).
#sys.path.insert(0, '/etc/moin')      #修改2：注释掉该行内容，从1.5版开始已默认注释该行

# Debug mode - show detailed error reports
## import os
## os.environ['MOIN_DEBUG'] = '1'

from MoinMoin.server.twistedmoin import TwistedConfig, makeApp
    
    
class Config(TwistedConfig):
    
    # Server name
    # Used to create .log, .pid and .prof files
    name = 'mointwisted'
    
    # Path to moin shared files (default '/usr/share/moin/wiki/htdocs')
    docs = '/usr/share/moin/htdocs'

    # The server will run with as this user and group (default 'www-data')
    user = 'www-data'                   
    group = 'www-data'

    # Port (default 8080)
    # To serve privileged port under 1024 you will have to run as root
    port = 8080                         

    # Interfaces (default [''])
    # The interfaces the server will listen to. 
    # [''] - listen to all interfaces defined on the server
    # ['red.wikicolors.org', 'blue.wikicolors.org'] - listen to some
    # If '' is in the list, other ignored.
    interfaces = ['']

    # How many threads to use (default 10, max 20)
    # The more threads you use, the more memory moin uses. All thread
    # use one CPU, and will not run faster, but might be more responsive
    # on a very busy server.
    threads = 10

    # Set logfile name (default commented)
    # This is the *Apache compatible* log file, not the twisted-style logfile.
    # Leaving this as None will have no Apache compatible log file. Apache
    # compatible logfiles are useful because there are quite a few programs
    # which analyze them and display statistics.
    ## logPath = 'mointwisted.log'

    # Memory profile (default commented)
    # Useful only if you are a developer or interested in moin memory usage
    ## from MoinMoin.util.profile import TwistedProfiler
    ## memoryProfile = TwistedProfiler('mointwisted',
    ##                            requestsPerSample=100,
    ##                            collect=0)

    # Hotshot profile (default commented)
    # Not compatible with threads.
    ## hotshotProfile = name + '.prof'


# Create the application
application = makeApp(Config)

配置MoinMoin Wiki系统

Single Wiki的配置文件是wikiconfig.py，位于实例目录下，它默认已可很好工作。它的内容如下：

# -*- coding: utf-8 -*-                 #为了在MoinMoin中使用中文，请用utf-8编码
# IMPORTANT! This encoding (charset) setting MUST be correct! If you live in a
# western country and you don't know that you use utf-8, you probably want to
# use iso-8859-1 (or some other iso charset). If you use utf-8 (a Unicode
# encoding) you MUST use: coding: utf-8
# That setting must match the encoding your editor uses when you modify the
# settings below. If it does not, special non-ASCII chars will be wrong.
    
""" 
    MoinMoin - Configuration for a single wiki
    
    If you run a single wiki only, you can omit the farmconfig.py config
    file and just use wikiconfig.py - it will be used for every request
    we get in that case.
    
    Note that there are more config options than you'll find in
    the version of this file that is installed by default; see
    the module MoinMoin.multiconfig for a full list of names and their
    default values.
    
    Also, the URL http://moinmoin.wikiwikiweb.de/HelpOnConfiguration has
    a list of config options.
    
    @copyright: 2000-2005 by Juergen Hermann <jh@web.de>
    @license: GNU GPL, see COPYING for details.
""" 
    
from MoinMoin.multiconfig import DefaultConfig

    
class Config(DefaultConfig):
    
    # Wiki identity ----------------------------------------------------
    
    # Site name, used by default for wiki name-logo [Unicode]
    sitename = u'Untitled Wiki'      #你的WiKi网站的名称
    
    # Wiki logo. You can use an image, text or both. [Unicode]
    # Example: u'<img src="/wiki/mywiki.png" alt="My Wiki">My Wiki'
    # For no logo or text, use ''
    logo_string = sitename           #WiKi的logo
    
    # The interwiki name used in interwiki links
    interwikiname = None
    
    
    # Critical setup  ---------------------------------------------------

    # Misconfiguration here will render your wiki unusable. Check that
    # all directories are accessible by the web server or moin server.
    
    # If you encounter problems, try to set data_dir and data_underlay_dir
    # to absolute paths.
    
    # Where your mutable wiki pages are. You want to make regular
    # backups of this directory.
    data_dir = './data/'
    
    # Where read-only system and help page are. You might want to share
    # this directory between several wikis. When you update MoinMoin,
    # you can safely replace the underlay directory with a new one. This
    # directory is part of MoinMoin distribution, you don't have to
    # backup it.
    data_underlay_dir = './underlay/'

    # This must be '/wiki' for twisted and standalone. For CGI, it should
    # match your Apache Alias setting.
    url_prefix = '/wiki'
    
    
    # Security ----------------------------------------------------------
    
    # Security critical actions (disabled by default)
    # Uncomment to enable options you like.
    allowed_actions = ['DeletePage', 'AttachFile', 'RenamePage']  #允许删除、上传和改名操作，操作受ACL约束。

    # Enable acl (0 to disable)
    acl_enabled = 1                            #开启ACL（访问控制列表）功能

    # IMPORTANT: grant yourself admin rights! replace YourName with
    # your user name. See HelpOnAccessControlLists for more help.
    # All acl_rights_xxx options must use unicode [Unicode]
    acl_rights_before = u"YourName:read,write,delete,revert,admin"   #替换YourName,该用户具有管理员权限。

    # Link spam protection for public wikis (Uncomment to enable)
    # Needs a reliable internet connection.
    #from MoinMoin.util.antispam import SecurityPolicy


    # Mail --------------------------------------------------------------

    # Configure to enable subscribing to pages (disabled by default)
    # or sending forgotten passwords.

    # SMTP server, e.g. "mail.provider.com" (empty or None to disable mail)
    mail_smarthost = ""

    # The return address, e.g "My Wiki <noreply@mywiki.org>"
    mail_from = ""

    # "user pwd" if you need to use SMTP AUTH
    mail_login = ""


    # User interface ----------------------------------------------------

    # Add your wikis important pages at the end. It is not recommended to
    # remove the default links.  Leave room for user links - don't use
    # more than 6 short items.
    # You MUST use Unicode strings here, but you need not use localized
    # page names for system and help pages, those will be used automatically
    # according to the user selected language. [Unicode]
    navi_bar = [                                         #FrontPage中的导航栏，可根据自已需求增减。
        # Will use page_front_page, (default FrontPage)
        u'%(page_front_page)s',
        u'RecentChanges',
        u'FindPage',
        u'HelpContents',
    ]

    # The default theme anonymous or new users get
    theme_default = 'modern'                             #默认的页面风格

    # Language options --------------------------------------------------

    # See http://moinmoin.wikiwikiweb.de/ConfigMarket for configuration in 
    # YOUR language that other people contributed.

    # The main wiki language, set the direction of the wiki pages
    default_lang = 'zh'                                  #默认语言

    # You must use Unicode strings here [Unicode]        #页面默认正则式，
    page_category_regex = u'^Category[A-Z]'              #以Category字符串开头的页面是分类页面
    page_dict_regex = u'[a-z]Dict$'                      #以Dict字符串结束的页面是字典页面
    page_form_regex = u'[a-z]Form$'                      #以Form字符串结尾的页同是表单页面
    page_group_regex = u'[a-z]Group$'                    #以Group字符串结尾的页面是组页面
    page_template_regex = u'[a-z]Template$'              #以Template字符串结尾的页同是模板页面

    # Content options ---------------------------------------------------

    # Show users hostnames in RecentChanges
    show_hosts = 1

    # Enumerate headlines?
    show_section_numbers = 0

    # Charts size, require gdchart (Set to None to disable).
    chart_options = {'width': 600, 'height': 300}

完整的配置选项可在MoinMoin/multiconfig.py文件找到，wikiconfig.py中的配置就是继承它的。multiconfig.py文件里的选项是默认配置，不要去修改它。如果我们要修改这些默认配置，可在wikiconfig.py中重新设置它即可。

multiconfig.py中默认权限配置选项说明

启动MoinMoin WiKi服务器

debian:~/mywiki# ./mointwisted start

在当前目录会生成一个叫twistd.log的日志文件。如果成功启动，日志文件的内容为：

2005/12/13 11:48 CST [-] Log opened.
2005/12/13 11:48 CST [-] twistd 2.0.1 (/usr/bin/python2.4 2.4.2) starting up
2005/12/13 11:48 CST [-] reactor class: twisted.internet.selectreactor.SelectReactor
2005/12/13 11:48 CST [-] Loading mointwisted.py...
2005/12/13 11:48 CST [-] Enabling Multithreading.
2005/12/13 11:48 CST [-] Loaded.
2005/12/13 11:48 CST [-] MoinMoin.server.twistedmoin.MoinSite starting on 8080
2005/12/13 11:48 CST [-] Starting factory <MoinMoin.server.twistedmoin.MoinSite instance at 0xb76004cc>
2005/12/13 11:48 CST [-] set uid/gid 33/33

MoinMoin成功启动后，在浏览器上打开http://server_name:8080网址即可访问。停止服务器用stop参数即可。用不带参数的mointwisted命令可以查看命令参数，如：

debian:~/mywiki# ./mointwisted 
error: nothing to do

mointwisted - MoinMoin daemon

usage: mointwisted command

commands:
  start     start the server
  stop      stop the server
  restart   stop then start the server
  kill      kill the server

@copyright: 2004-2005 Thomas Waldmann, Nir Soffer
@license: GNU GPL, see COPYING for details.

第一步要先安装Mod_Python模块，要求使用mod_python 3.1.3或以上版本的Mod_Python模块。安装命令如下：

debian:~# apt-get install libapache2-mod-python2.3

下载完软件包后Debian系统会自动进行软件包的配置，回答"Yes"启用Mod_Python模块。这样在/etc/apache2/mods-enabled目录下会创建一个链接到/etc/apache2/mods-available/mod_python.load文件。该文件配置了装载mod_python模块的语句，如：

LoadModule python_module /usr/lib/apache2/modules/mod_python.so

第二步是创建WiKi实例，步骤同上。

第三步是配置wikiconfig.py，内容如下：

# -*- coding: utf-8 -*-                         #使用UTF-8编码
# IMPORTANT! This encoding (charset) setting MUST be correct! If you live in a
# western country and you don't know that you use utf-8, you probably want to
# use iso-8859-1 (or some other iso charset). If you use utf-8 (a Unicode
# encoding) you MUST use: coding: utf-8
# That setting must match the encoding your editor uses when you modify the
# settings below. If it does not, special non-ASCII chars will be wrong.

"""
    MoinMoin - Configuration for a single wiki

    If you run a single wiki only, you can omit the farmconfig.py config
    file and just use wikiconfig.py - it will be used for every request
    we get in that case.

    Note that there are more config options than you'll find in
    the version of this file that is installed by default; see
    the module MoinMoin.multiconfig for a full list of names and their
    default values.

    Also, the URL http://moinmoin.wikiwikiweb.de/HelpOnConfiguration has
    a list of config options.

    ** Please do not use this file for a wiki farm. Use the sample file
    from the wikifarm directory instead! **

    @copyright: 2000-2005 by Juergen Hermann <jh@web.de>
    @license: GNU GPL, see COPYING for details.
"""

from MoinMoin.multiconfig import DefaultConfig


class Config(DefaultConfig):

    # Wiki identity ----------------------------------------------------

    # Site name, used by default for wiki name-logo [Unicode]
    sitename = u'Untitled Wiki'                   #你的WiKi网站的名称

    # Wiki logo. You can use an image, text or both. [Unicode]
    # For no logo or text, use '' - the default is to show the sitename.
    # See also url_prefix setting below!
    logo_string = u'<img src="/wiki/common/moinmoin.png" alt="MoinMoin Logo">'    #网站Logo

    # name of entry page / front page [Unicode], choose one of those:

    # a) if most wiki content is in a single language
    #page_front_page = u"MyStartingPage"

    # b) if wiki content is maintained in many languages
    page_front_page = u"FrontPage"                #启用首页

    # The interwiki name used in interwiki links
    #interwikiname = 'UntitledWiki'
    # Show the interwiki name (and link it to page_front_page) in the Theme,
    # nice for farm setups or when your logo does not show the wiki's name.
    #show_interwiki = 1



    # Critical setup  ---------------------------------------------------

    # Misconfiguration here will render your wiki unusable. Check that
    # all directories are accessible by the web server or moin server.

    # If you encounter problems, try to set data_dir and data_underlay_dir
    # to absolute paths.

    # Where your mutable wiki pages are. You want to make regular
    # backups of this directory.
    data_dir = '/root/mywiki/data/'                #设置data目录路径，要用绝对路径

    # Where read-only system and help page are. You might want to share
    # this directory between several wikis. When you update MoinMoin,
    # you can safely replace the underlay directory with a new one. This
    # directory is part of MoinMoin distribution, you don't have to
    # backup it.
    data_underlay_dir = '/root/mywiki/underlay/'   #设置underlay目录路径，要用绝对路径

    # This must be '/wiki' for twisted and standalone. For CGI, it should
    # match your Apache Alias setting.
    url_prefix = '/wiki'                           


    # Security ----------------------------------------------------------

    # This is checked by some rather critical and potentially harmful actions,
    # like despam or PackageInstaller action:
    superuser = [u"moin_admin", ]                  #设置超级用户，1.5版新增选项

    # IMPORTANT: grant yourself admin rights! replace YourName with
    # your user name. See HelpOnAccessControlLists for more help.
    # All acl_rights_xxx options must use unicode [Unicode]
    #acl_rights_before = u"YourName:read,write,delete,revert,admin"   #设置管理权限

    # Link spam protection for public wikis (Uncomment to enable)
    # Needs a reliable internet connection.
    #from MoinMoin.util.antispam import SecurityPolicy


    # Mail --------------------------------------------------------------

    # Configure to enable subscribing to pages (disabled by default)
    # or sending forgotten passwords.

    # SMTP server, e.g. "mail.provider.com" (None to disable mail)
    mail_smarthost = "smtp.21cn.com"             #使用21cn的smtp服务器发送邮件

    # The return address, e.g u"Jürgen Wiki <noreply@mywiki.org>" [Unicode]
    mail_from = u"yjnet<yjnet@21cn.com>"         #发送者

    # "user pwd" if you need to use SMTP AUTH
    mail_login = "yjnet 123456"                #SMTP服务器验证，以"user password"格式填写


    # User interface ----------------------------------------------------

    # Add your wikis important pages at the end. It is not recommended to
    # remove the default links.  Leave room for user links - don't use
    # more than 6 short items.
    # You MUST use Unicode strings here, but you need not use localized
    # page names for system and help pages, those will be used automatically
    # according to the user selected language. [Unicode]
    navi_bar = [                                        #设置导航栏
        # If you want to show your page_front_page here:
        u'%(page_front_page)s',
        u'RecentChanges',
        u'FindPage',
        u'HelpContents',
    ]

    # The default theme anonymous or new users get
    theme_default = 'modern'                            #设置网页主题峁


    # Language options --------------------------------------------------

    # See http://moinmoin.wikiwikiweb.de/ConfigMarket for configuration in
    # YOUR language that other people contributed.

    # The main wiki language, set the direction of the wiki pages
    language_default = 'zh'                             #设置默认语言

    # You must use Unicode strings here [Unicode]
    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$'

    # Content options ---------------------------------------------------

    # Show users hostnames in RecentChanges
    show_hosts = 1

    # Enable graphical charts, requires gdchart.
    #chart_options = {'width': 600, 'height': 300}

第四步是配置在Apache2中配置Mod_Python，在/etc/apache2/conf目录下创建一个moin_mop_python.conf的配置文档，内容如下：

Alias /wiki/ "/usr/share/moin/htdocs/" 

<Location /mywiki>
  SetHandler python-program
# Add the path of your wiki directory
  PythonPath "['/root/mywiki/'] + sys.path"
  PythonHandler MoinMoin.request::RequestModPy.run
</Location>

配置完成后，需重启Apache服务器，查询Apache日志可看到服务器的启动状态，Apache的日志存放在/var/log/apache2目录下。成功启动后，访问http://moinserver/mywiki即可打开进入MoinMoin。

最后，我们还要安装中文语言包。我们先要在MoinMoin中用登录界面创建一个有管理员权限的用户，在该例中就是moin_admin用户。以该用户登录后再访问http://moinserver/mywiki/SystemPagesSetup网页安装中文语言包。如果你没有管理权限，访问该页面时在语言包前面是不会显示"安装"按钮的。

从moin1.5.1升级到moin1.5.3的操作很简单，首先备份好/usr/lib/python2.3/site-packages/MoinMoin目录和/usr/share/moin目录。接着删除这两个目录和实例目录下的underlay目录，安装新版本的moinmoin系统。最后把/usr/share/moin/underlay目录拷贝到实例目录，修改该目录的访问权限。升级完成要重启服务器。注意，如果你修改了/usr/lib/python2.3/site-packages/MoinMoin目录和/usr/share/moin目录下文件的内容，升级完成后要重新修改或用旧文件覆盖。