UserPreferences

Aiuto Per Gli Sviluppatori


/!\ THIS IS WORK IN PROGRESS /!\


Related Topics

Contents

  1. Contributions
  2. Extension guidelines
  3. CVS structure
  4. Tour of the most important modules
  5. Creating a release

TODO

Contributions

The distribution contains a "contributions" directory for 3rd party extensions that are not made part of the official distribution. This directory contains extensions contributed by Moin Moin users and that are considered either too exotic or need too much work to be integrated into the core sources. Another reason of not adding them is that modules in the core have to be maintained when structural changes happen, which is a constant burden.

Thus, these sources are here for you to try them out and take advantage of a feature someone found useful enough to write code for, but you cannot expect that they always work with the current distribution. Contributors are encouraged to send updates...

Extension guidelines

These are the rules that govern Moin Moin development:

CVS structure

For historical reasons, the virtual CVS module "moin" combines the "dist" and the "MoinMoin" module; "moin" is the only module you should check out.

Tour of the most important modules

wikiaction.py

Help On Actions lists all the querystrings that are handled by this module.

Creating a release

This describes how to create a release tarball for Moin Moin. It's of minor interest to anyone except [MoinMoin]JürgenHermann. :)

  1. Commit any pending code changes.

  2. Commit the current status of the Moin Moin wiki (especially the help pages).

  3. make install-docs

  4. Validate the CHANGES file (insert current date and new version number).

  5. Tag the repository:

    cvs tag rel-MAJOR-MINOR

  6. Create an export directory:

    cvs -z3 -d :pserver:[email protected]:/cvsroot/moin export -r HEAD moin
    cd moin
    python setup.py sdist
    

  7. Upload the tarball (or zip):

    • [WWW]SourceForge / Project Admin / Release Files

    • Follow the forms

    • See also [WWW]Making File Releases

  8. Download from [MoinMoin]SourceForge and give it a test run.