= Desktop MoinMoin =

== Official Setup Instructions ==

Setting up and running your own local copy of !MoinMoin is fairly simple.  This is supported "out-of-box" by the !MoinMoin distribution.

http://moinmo.in/DesktopEdition


== WebWorks Setup Instructions ==

 1. Download the latest release (currently 1.8.0).

    http://moinmo.in/MoinMoinDownload

 2. Unzip it.

 3. Update configuration to support XML-RPC.

    Edit "wikiconfig.py"

    {{{#!python
class LocalConfig(DefaultConfig):
    # vvv DON'T TOUCH THIS EXCEPT IF YOU KNOW WHAT YOU DO vvv
    moinmoin_dir = os.path.abspath(os.path.normpath(os.path.dirname(sys.argv[0])))
    data_dir = os.path.join(moinmoin_dir, 'wiki', 'data')
    data_underlay_dir = os.path.join(moinmoin_dir, 'wiki', 'underlay')

    DesktopEdition = True # give all local users full powers
    acl_rights_default = u"All:read,write,delete,revert,admin"
    surge_action_limits = None # no surge protection
    sitename = u'MoinMoin DesktopEdition'
    logo_string = u'<img src="/moin_static180/common/moinmoin.png" alt="MoinMoin Logo">'
    page_front_page = u'FrontPage' # change to some better value
    # ^^^ DON'T TOUCH THIS EXCEPT IF YOU KNOW WHAT YOU DO ^^^

    # Add your configuration items here.
    secrets = 'This string is NOT a secret, please make up your own, long, random secret string!'


# DEVELOPERS! Do not add your configuration items there,
# you could accidentally commit them! Instead, create a
# wikiconfig_local.py file containing this:
}}}

    and add "actions_excluded = []":

    {{{#!python
class LocalConfig(DefaultConfig):
    # vvv DON'T TOUCH THIS EXCEPT IF YOU KNOW WHAT YOU DO vvv
    moinmoin_dir = os.path.abspath(os.path.normpath(os.path.dirname(sys.argv[0])))
    data_dir = os.path.join(moinmoin_dir, 'wiki', 'data')
    data_underlay_dir = os.path.join(moinmoin_dir, 'wiki', 'underlay')

    DesktopEdition = True # give all local users full powers
    acl_rights_default = u"All:read,write,delete,revert,admin"
    surge_action_limits = None # no surge protection
    sitename = u'MoinMoin DesktopEdition'
    logo_string = u'<img src="/moin_static180/common/moinmoin.png" alt="MoinMoin Logo">'
    page_front_page = u'FrontPage' # change to some better value
    # ^^^ DON'T TOUCH THIS EXCEPT IF YOU KNOW WHAT YOU DO ^^^

    # Add your configuration items here.
    secrets = 'This string is NOT a secret, please make up your own, long, random secret string!'

    # Enable xmlrpc
    actions_excluded = []


# DEVELOPERS! Do not add your configuration items there,
# you could accidentally commit them! Instead, create a
# wikiconfig_local.py file containing this:
}}}

    NOTE: Whitespace is significant in Python, so put 4 spaces before "actions_excluded = []".

 4. Run with python.  Python can be downloaded at http://python.org/download/.  Currently recommending [[http://python.org/download/releases/2.5.2/|version 2.5.2]].

    {{{
python wikiserver.py
}}}

 5. Access from you browser with http://localhost:8080/.