GMS NOC Docs   HelpOnConfiguration UserPreferences
 
Help Search Diffs Info Edit Subscribe Print View
 GMS NOC Docs   FrontPage   RecentChanges   TitleIndex   Help 

Configuration of MoinMoin

MoinMoin is configured by changing the moin_config.py file, which normally sits besides your moin.cgi driver script. moin_config.py is imported by the MoinMoin main code early in a request cycle and is found because the current directory (i.e. that of moin.cgi) is part of the Python system path. Consequently, moin_config.py can sit anywhere in your PYTHONPATH.

The following table contains default values and a short description for all configuration variables. Most of these can be left at their defaults, those you need to change with every installation are listed in the sample moin_config.py that comes with the distribution.

Variable name Default Description
LogStore 'text:editlog' Experimental, keep the default
SecurityPolicy None class object hook for implementing security restrictions
allow_extended_names 1 true to enable ["non-stamdard wikiname"] markup
allowed_actions [] allow unsafe actions (list of strings)
attachments None If None, send attachments via CGI; else this has to be a dictionary with the path to attachment storage (key dir) and the equivalent URL prefix to that same dir (key url)
backtick_meta 0 true to enable `inline literal` markup
bang_meta 0 true to enable !NoWikiName markup
changed_time_fmt '  [%H:%M]' Time format used on RecentChanges for page edits within the last 24 hours
charset 'iso-8859-1' The encoding / character set your system uses
check_i18n 0 Set to 1 only in development systems, or on a translator's system
css_url '/wiki-moinmoin/default.css' URL for the default CSS definitions, make this a server-relative URL (start with a slash)
data_dir './data/' Path to the data directory, the default is OK if you place the data directory right besides your moin.cgi
date_fmt '%Y-%m-%d' System date format, used mostly in RecentChanges
datetime_fmt '%Y-%m-%d %H:%M:%S' Default format for dates and times (when the user has no preferences or chose the "default" date format)
edit_rows 30 Default height of the edit box
external_diff 'diff' Name of external diff utility (possibly a full path)
html_head META-Tag with Content-Type Additional <HEAD> tags for all pages
html_head_queries META-Tag with "NOINDEX,NOFOLLOW" for robots Additional <HEAD> tags for edit and action pages
httpd_docs './wiki-moinmoin' directory with public files, when using the stand-alone server
httpd_host 'localhost' hostname of the stand-alone server
httpd_port 8080 port of the stand-alone server
httpd_user 'nobody' user to run the the stand-alone server under (UNIX only)
interwikiname None InterWiki name (prefix, moniker) of the site, or None
logo_string MoinMoin logo URL path to the logo display in the upper-left corner of a page and used in RSS documents
mail_from None From: header used in sent mails
mail_smarthost None IP or domain name of an SMTP-enabled server; note that email features (notification, mailing of login data) works only if this variable is set
max_macro_size 50 Maximum size of some macro pages in KB, especially used to limits the size of RecentChanges; use 0 to disable that feature
navi_bar large HTML fragment Most important links in text form (/!\ this is a deprecated feature that will enventually disappear and be replaced by the bookmarks of [OpenWiki]UserPreferences)
nonexist_qm 0 Default for displaying WantedPages with a question mark, like in the original wiki
page_edit_tips 'HelpOnFormatting' Name of the page with help on editing, displayed as a link in the editor view
page_footer1 Python Powered logo Custom HTML markup sent before the system footer
page_footer2 "" Custom HTML markup sent after the system footer
page_form_ending 'Form' Ending name part of pages containing form definitions
page_front_page 'FrontPage' Name of the front page
page_icons large HTML fragment The top-right icons on each page
page_local_spelling_words 'LocalSpellingWords' Name of the page containing user-provided spellchecker words
page_recent_changes 'RecentChanges' Name of the RecentChanges page
page_template_ending 'Template' Ending name part of pages containing templates for new pages
page_user_prefs 'UserPreferences' Name of the user preferences page
shared_intermap None path to a file containing global InterWiki definitions
shared_metadb None path to a file containing a global InterWiki pagelist
show_hosts 1 true to show hostname in RecentChanges
show_section_numbers 1 true to show section number headings by default
show_timings 0 used for development
show_version 0 show MoinMoin's version at the bottom of each page
sitename 'An Unnamed MoinMoin Wiki' Short description of your wiki site, displayed below the logo on each page, and used in RSS documents as the channel title
trail_size 5 Number of pages in the trail of visited pages
umask 0777 umask used on all open(), mkdir() and similar calls
url_mappings {} lookup table to remap URL prefixes (dict of 'prefix': 'replacement')
url_prefix '/wiki-moinmoin' Used as the base URL for all public documents served by the wiki, especially the image files for the icons
url_schemas [] additional URL schemas you want to have recognized (list of strings)


PythonPowered EditText of this page (last modified 2003-07-16 20:53:34)
FindPage by title search or text search