If you run a single wiki, you should not copy the file farmconfig.py into your configuration directory (remove it and the .pyc file, if it is there). Without farmconfig, moin uses the default wikiconfig.py
wikiconfig.py usually is located besides your moin.cgi driver script. If you need to make a custom install, it can be located anywhere, but you must add the path to the directory where it is located to your Python system path in your server script. See the "System Path Configuration" section in your server script.
General notes on wiki/farmconfig.py structure:
# -*- coding: iso-8859-1 -*-
from MoinMoin.config.multiconfig import DefaultConfig
class Config(DefaultConfig):
sitename = u'MyWiki' # u means that it will be converted to Unicode
interwikiname = 'MyWiki'
data_dir = '/where/ever/mywiki/data/'
underlay_dir = '/where/ever/mywiki/underlay/'
# More settings follow...First, you must define the coding of the config file. The default setting is suited for Latin ("western") languages only, for international setup, read section #intsetup. If you don't define the coding, you can't use non-ascii characters.
- Next we import moin's internal default configuration. The default configuration includes values for all options, so we don't have to define all values, just what we want to customize.
- Then we define a new configuration class called "Config" and inherit all settings from the default configuration we imported. Note that the class name must be "Config".
- Next lines are the configuration options for the Config class. Note that each line must be indented by 4 spaces, tabs are not allowed. Moin will not run if you use wrong indentation.
A common configuration item is sitename - in most cases you don't want your wiki to have the default "Untitled Wiki" name. You can define any name you like in any language, but before you do that, read section #character-set.
If you followed the install instructions, the wiki will run without any other change, but you might want to change some values, like data_dir, data_underlay_dir acl_rights_before and more. For most cases, setting all the values in the supplied wikiconfig.py file is enough.
Anything we do not define simply stays at moin's internal defaults which we inherited from DefaultConfig.