Modifying the MoinMoin Default Style Sheets

If you wish to modify the default MoinMoin style sheet, it is a good practice to create a new theme first. Copy one of the existing themes to a new name (and also do not forget to copy the themename.py file, too). Use the @import function to import the original CSS file. Override only those attributes you wish to change. Then, if you later upgrade to a newer version of MoinMoin, any changes to the original CSS file will be incorporated automatically.

Example:

@import url("/wiki/classic/css/screen.css");

body {
    background-color: #FAEBD7;  
    font-family: Arial,Helvetica;  
}

Allowing Users to Choose a Style Sheet

To allow you users to choose between alternate style sheets, you first need to create several choices. Using the example above, change the background-color to #E7FFE7 and save the file as green.css in htdocs/mytheme/css/.

Test this option by modifying your user preferences to select a CSS URL of /wiki/mytheme/css/green.css.

Finally, you will probably need to edit HelpOnUserPreferences and change the wording for CSS URL to instruct your users on the choices available, including the new option for a green background.

Note: When a user initializes or updates their UserPreferences, the default value for CSS URL will be empty. Any user can return to the default value by erasing the CSS URL field value and clicking the Save button.

How can I use my old .css style option with the new "theme based" moinmoin?

1. Select the theme you like the most, or is more like your old one.

2. Clone the selected theme into the wiki plugin directory. For example, if the classic theme is your departure point to create mytheme, then:

   1. Copy your htdocs/classic dir (containing the css and img subdirs) to htdocs/mytheme

   2. Copy python/site-packages/MoinMoin/theme/classic.py to data/plugin/theme/mytheme.py

   3. Add the following line to your wikiconfig.py:

      theme_default = 'mytheme'

3. Modify the mytheme CSS files (common.css, screen.css and print.css) to change the style and the mytheme.py to change order or appearance of elements in the produced html. At least, make sure that you change the value of the variable name to 'mytheme' (at the top of class Theme), otherwise your changes to the mytheme CSS files may have no effect.

In this way, you will already have your personal theme available to simplify new upgrades.