The following 175 words could not be found in the dictionary of 615 words (including 615 LocalSpellingWords) and are highlighted below:

above   Add   allow   Allowing   already   alternate   and   appearance   Arial   at   At   attributes   automatically   available   background   based   be   between   body   button   by   can   changes   choices   choose   Choose   class   classic   clicking   Clone   color   common   containing   css   D7   Default   default   departure   dir   E7   edit   effect   elements   empty   erasing   Example   example   existing   family   field   file   files   Finally   following   font   For   for   forget   function   Get   good   green   Help   Helvetica   How   htdocs   if   If   img   import   in   In   including   incorporated   initializes   instruct   into   later   least   like   line   make   Modify   modify   Modifying   modifying   more   most   my   mytheme   name   need   new   newer   no   Note   of   old   On   on   one   only   option   or   order   original   otherwise   Override   packages   personal   plugin   point   practice   Preferences   preferences   probably   produced   python   return   save   Save   screen   Select   select   selected   several   Sheet   sheet   Sheets   sheets   simplify   site   style   Style   subdirs   sure   Test   Text   that   the   their   Theme   theme   themename   themes   then   Then   this   those   to   To   too   top   updates   upgrade   upgrades   Use   use   User   user   Users   users   Using   value   variable   version   way   When   wikiconfig   will   wish   with   wording   you   your  

Clear message

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.

HelpOnConfiguration/CascadingStyleSheets (last modified 2007-04-01 02:20:37)