paul@27 | 1 | Introduction
|
paul@27 | 2 | ------------
|
paul@27 | 3 |
|
paul@27 | 4 | The moinsetup script is a utility separate from MoinMoin which attempts to
|
paul@27 | 5 | assist in the configuration and deployment of MoinMoin and extensions. It can
|
paul@27 | 6 | automate the installation of MoinMoin according to recommended practices,
|
paul@27 | 7 | create and initialise new Wiki instances, install extensions, themes and
|
paul@27 | 8 | related resources, and perform certain configuration changes.
|
paul@27 | 9 |
|
paul@27 | 10 | Usage
|
paul@27 | 11 | -----
|
paul@27 | 12 |
|
paul@27 | 13 | Running moinsetup as follows will provide a list of methods available:
|
paul@27 | 14 |
|
paul@27 | 15 | python moinsetup.py
|
paul@27 | 16 |
|
paul@27 | 17 | Before any work can be done by the program, a configuration file needs to be
|
paul@27 | 18 | created. See the supplied moinsetup.cfg file for an example file which can
|
paul@27 | 19 | be modified and used for this purpose.
|
paul@27 | 20 |
|
paul@27 | 21 | Configuration
|
paul@27 | 22 | -------------
|
paul@27 | 23 |
|
paul@27 | 24 | The configuration file has two sections: installation and site. A brief
|
paul@27 | 25 | description of the settings is given below.
|
paul@27 | 26 |
|
paul@27 | 27 | Installation settings influence the configuration, installation and
|
paul@27 | 28 | customisation of a Wiki and are generally not optional:
|
paul@27 | 29 |
|
paul@27 | 30 | moin_distribution A path to a MoinMoin distribution directory, which can
|
paul@27 | 31 | also be a clone of a MoinMoin repository.
|
paul@27 | 32 |
|
paul@27 | 33 | prefix The directory prefix containing lib, bin and share
|
paul@27 | 34 | directories where MoinMoin is (or will be) installed.
|
paul@27 | 35 | Although this follows the layout of the /usr directory (on
|
paul@27 | 36 | Unix-based systems), it is likely that MoinMoin may be
|
paul@27 | 37 | installed elsewhere
|
paul@27 | 38 |
|
paul@27 | 39 | web_app_dir A directory where the moin.cgi program is (or will be)
|
paul@27 | 40 | installed.
|
paul@27 | 41 |
|
paul@27 | 42 | web_site_dir The directory where sites available to the Apache Web
|
paul@27 | 43 | server are defined. This directory may just be a place
|
paul@27 | 44 | where initial site definitions are written, and after
|
paul@27 | 45 | manual editing, such definitions may be copied to the
|
paul@27 | 46 | appropriate location.
|
paul@27 | 47 |
|
paul@27 | 48 | common_dir The directory in which the Wiki instance being configured
|
paul@27 | 49 | or managed resides (or will reside).
|
paul@27 | 50 |
|
paul@27 | 51 | Site settings are generally only relevant when configuring and installing a
|
paul@27 | 52 | Wiki:
|
paul@27 | 53 |
|
paul@27 | 54 | url_path The URL path (after the host details) of the Wiki.
|
paul@27 | 55 | superuser The superuser of the Wiki.
|
paul@27 | 56 | site_name The name of the Wiki.
|
paul@27 | 57 | front_page_name The name of the Wiki's front page.
|
paul@27 | 58 | theme_default The default theme of the Wiki.
|
paul@27 | 59 |
|
paul@27 | 60 | Examples
|
paul@27 | 61 | --------
|
paul@27 | 62 |
|
paul@27 | 63 | Some of the more useful invocation methods are described below using examples.
|
paul@27 | 64 |
|
paul@27 | 65 | To set up MoinMoin and a Wiki instance:
|
paul@27 | 66 |
|
paul@27 | 67 | python moinsetup.py setup
|
paul@27 | 68 |
|
paul@27 | 69 | To only set up a Wiki instance using a different configuration file:
|
paul@27 | 70 |
|
paul@27 | 71 | python moinsetup.py -f new_wiki.cfg setup_wiki
|
paul@27 | 72 |
|
paul@27 | 73 | To change a configuration setting (for example, the default theme):
|
paul@27 | 74 |
|
paul@27 | 75 | python moinsetup.py reconfigure_moin theme_default mercurialwiki
|
paul@27 | 76 |
|
paul@27 | 77 | To install a theme from a directory containing a theme module, css and img
|
paul@27 | 78 | directories (for example, MercurialWikiTheme):
|
paul@27 | 79 |
|
paul@27 | 80 | python moinsetup.py install_theme /path/to/MercurialWikiTheme/themes/mercurialwiki
|
paul@27 | 81 |
|
paul@27 | 82 | To install an extension package from a directory containing a setup.py script
|
paul@27 | 83 | (for example, EventAggregator):
|
paul@27 | 84 |
|
paul@27 | 85 | python moinsetup.py install_extension_package /path/to/EventAggregator
|
paul@27 | 86 |
|
paul@27 | 87 | To install actions from a directory containing action modules:
|
paul@27 | 88 |
|
paul@27 | 89 | python moinsetup.py install_actions /path/to/EventAggregator/actions
|
paul@27 | 90 |
|
paul@27 | 91 | To install macros from a directory containing macro modules:
|
paul@27 | 92 |
|
paul@27 | 93 | python moinsetup.py install_macros /path/to/EventAggregator/macros
|
paul@27 | 94 |
|
paul@27 | 95 | To install theme-related resources for an extension from a directory
|
paul@27 | 96 | containing css and img directories:
|
paul@27 | 97 |
|
paul@27 | 98 | python moinsetup.py install_theme_resources /path/to/EventAggregator
|
paul@27 | 99 |
|
paul@27 | 100 | To add theme-related resources to existing stylesheets (for example, adding
|
paul@27 | 101 | the event-aggregator.css resource to the screen.css stylesheet for all
|
paul@27 | 102 | installed themes):
|
paul@27 | 103 |
|
paul@27 | 104 | python moinsetup.py edit_theme_stylesheet screen.css event-aggregator.css
|
paul@27 | 105 |
|
paul@27 | 106 | To make a page package containing pages to be added to a Wiki:
|
paul@27 | 107 |
|
paul@27 | 108 | python moinsetup.py make_page_package pages_dir pages.zip
|
paul@27 | 109 |
|
paul@27 | 110 | To install a page package in a Wiki:
|
paul@27 | 111 |
|
paul@27 | 112 | python moinsetup.py install_page_package pages.zip
|
paul@27 | 113 |
|
paul@27 | 114 | Contact, Copyright and Licence Information
|
paul@27 | 115 | ------------------------------------------
|
paul@27 | 116 |
|
paul@27 | 117 | See the following Web page for more information about this work:
|
paul@27 | 118 |
|
paul@27 | 119 | http://moinmo.in/ScriptMarket/moinsetup
|
paul@27 | 120 |
|
paul@27 | 121 | The author can be contacted at the following e-mail address:
|
paul@27 | 122 |
|
paul@27 | 123 | paul@boddie.org.uk
|
paul@27 | 124 |
|
paul@27 | 125 | Copyright and licence information can be found in the docs directory - see
|
paul@29 | 126 | docs/COPYING.txt and docs/gpl-3.0.txt for more information.
|
paul@27 | 127 |
|
paul@27 | 128 | Dependencies
|
paul@27 | 129 | ------------
|
paul@27 | 130 |
|
paul@27 | 131 | moinsetup has the following basic dependencies:
|
paul@27 | 132 |
|
paul@27 | 133 | Packages Release Information
|
paul@27 | 134 | -------- -------------------
|
paul@27 | 135 |
|
paul@27 | 136 | CMDsyntax Tested with 0.91
|
paul@27 | 137 | Source: http://www.boddie.org.uk/david/Projects/Python/CMDSyntax/index.html
|
paul@27 | 138 |
|
paul@35 | 139 | New in moinsetup 0.2 (Changes since moinsetup 0.1)
|
paul@35 | 140 | --------------------------------------------------
|
paul@35 | 141 |
|
paul@35 | 142 | * Improved OpenID configuration, supporting MoinMoin 1.9, and added support
|
paul@35 | 143 | for other authentication methods.
|
paul@35 | 144 | * Added support for ACL-capable filesystems when setting Wiki permissions.
|
paul@35 | 145 | It can be more convenient to retain read/write access to the installed
|
paul@35 | 146 | files while also granting the Web server user (who need not be in a common
|
paul@35 | 147 | group) access to read and modify the files.
|
paul@35 | 148 | * Added support for configurations employing a separate static resources
|
paul@35 | 149 | directory (such as a typical "htdocs" directory).
|
paul@35 | 150 | * Added a parser installation action.
|
paul@35 | 151 | * Added support for page attachments in the page-packaging action.
|
paul@35 | 152 |
|
paul@27 | 153 | Release Procedures
|
paul@27 | 154 | ------------------
|
paul@27 | 155 |
|
paul@27 | 156 | Update the moinsetup.py __version__ attribute.
|
paul@27 | 157 | Change the version number and package filename/directory in the documentation.
|
paul@27 | 158 | Update the release notes (see above).
|
paul@27 | 159 | Tag, export.
|
paul@27 | 160 | Archive, upload.
|
paul@27 | 161 | Update the ScriptMarket (see above for the URL).
|