moinsetup

Description

The moinsetup script is a utility separate from MoinMoin which attempts to assist in the configuration and deployment of MoinMoin and extensions. It can automate the installation of MoinMoin according to recommended practices, create and initialise new Wiki instances, install extensions, themes and related resources, and perform certain configuration changes.

Download & Release Notes

Usage

Running moinsetup as follows will provide a list of methods available:

python moinsetup.py

Before any work can be done by the program, a configuration file needs to be created. See the supplied moinsetup.cfg file for an example file which can be modified and used for this purpose.

Examples

# Set up MoinMoin and a Wiki instance:
python moinsetup.py -m setup

# Install an extension package which provides a setup.py script:
python moinsetup.py -m install_extension_package /path/to/EventAggregator

# Install a theme from a directory containing the theme module and static resource directories:
python moinsetup.py -m install_theme /path/to/MercurialWikiTheme/themes/mercurialwiki

# Change the default theme in a Wiki:
python moinsetup.py -m reconfigure_moin theme_default mercurialwiki

Dependencies

• CMDsyntax 0.91

Copyright

Copyright (C) 2010, 2011, 2012, 2013 Paul Boddie <paul AT boddie DOT org DOT uk>

License

GNU General Public License version 3 or later

Important Notices

Release 0.3 of moinsetup changes the Wiki instance directory hierarchy so that the top-level directory, instead of containing the conf and wikidata directories, contains the Wiki configuration file (unless located elsewhere - see the site_config setting) plus data, underlay and htdocs directories. See the migration section in the documentation for details.

Release 0.3 also changes the moinsetup command syntax to require -m (or --method=) before method names. This fixes a critical ambiguity issue with option processing.

Discussion