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

above   abstract   accept   actions   add   added   adhering   all   All   an   and   applied   archive   area   argument   arguments   around   at   avoid   bar   Base   based   be   below   body   build   by   call   callables   called   can   changed   changes   changing   classes   classic   clone   Collection   colors   colours   compatible   Components   components   config   Configuration   Contents   course   created   credits   css   current   customize   default   define   described   dict   dictionary   differ   different   don   due   easy   edit   Edit   editbar   editing   element   elements   encoding   etc   existing   faster   favorite   file   following   fonts   footer   footer1   footer2   for   forget   forms   fragments   from   functions   future   generate   geometry   get   goal   head   header   header1   header2   heavily   Help   how   htdocs   icon   iconbar   if   If   image   images   Images   img   in   indicated   install   Installation   instead   interface   into   items   keyword   left   leftsibebar2   leftsidebar2   less   level   license   like   list   loaded   logo   look   made   make   makes   Market   maybe   menu   might   modify   module   more   moving   msg   must   mywiki   names   navi   navigation   necessary   need   needed   needs   new   nice   no   None   note   now   object   Of   of   ok   On   on   Once   Only   only   onto   option   or   order   others   output   override   own   package   page   pages   parts   Please   plugin   png   possible   Preferences   primitive   put   putting   Python   reach   referring   relying   rendering   request   resulting   reuse   saved   search   searchform   see   sequence   set   Setting   settings   share   Sharing   should   single   small   So   so   some   stable   standards   stored   string   stuff   Stylesheets   stylesheets   sub   subdirectories   subset   system   Table   Text   that   The   the   their   them   theme   Theme   themes   then   there   these   this   title   to   To   too   top   totally   touched   touching   trail   try   under   unless   unpack   up   update   upgrade   use   User   user   username   uses   using   usr   usually   version   want   we   what   When   when   which   while   wikiconfig   will   with   without   work   writing   yet   You   you   Your   your  

Clear message

MoinMoin has a theme plugin system that makes it easy to change the look and feel without touching the core code. You can customize colors by editing the stylesheets, or create a totally new user interface by writing a new theme plugin in Python. When you upgrade MoinMoin, your theme is not touched - it will work with the new version, or needs only small changes due to theme API changes.

The Components

A theme "THEMENAME" is made of these components:

Stylesheets

All current themes are heavily based on CSS. So for easy changes (like changing colours or fonts, moving around stuff), you maybe only need to change the CSS.

Images

When you do a new theme, copy all images from classic to your img directory and then modify as needed. If you modify an image, do not forget to update the icon dict in the theme code - the image geometry is stored there for faster rendering.

Python module

The theme code is called by moinmoin with (more or less) abstract data in a dictionary usually called d. The code then uses items in that dictionary to generate HTML (also heavily relying on CSS). The new theme system in 1.3 avoid using the data dictionary when possible, and instead call different moin parts to get the needed data.

When you do a new theme, first clone your favorite theme, then try to edit the stylesheets to get what you want. Only if you can't reach your goal using CSS only, override some functions in your theme code.

All themes are sub classes of MoinMoin.theme.ThemeBase which define the primitive user interface elements, like logo, username, title, searchform, editbar, actions menu etc. You should reuse these parts unless you need to change their content or create new element that you can not build from existing parts. The theme API is not stable yet, and might change in the future.

Installation of a new theme

To install a theme, unpack the archive and copy the resulting top-level directory (e.g., leftsibebar2) to the wikis htdocs directory, e.g. /usr/share/moin/mywiki/htdocs. You should end up with the following subdirectories: css/, img/.

After you do this, copy the file THEMENAME.py (e.g., leftsidebar2.py) to the data/plugin/theme directory of your wiki.

Setting the default theme

Once you have created all the necessary theme components and saved them as indicated above, the theme can be applied to your wiki by using the theme_default option in wikiconfig.py (see HelpOnConfiguration).

Sharing your theme

If you made a nice theme (of course adhering to HTML and CSS standards), package it like described below and put it onto ThemeMarket. Please put it under GPL license, if possible.

# <THEMENAME>-<VERSION>.tar.gz (or .zip), containing:
<THEMENAME>/<THEMENAME>.py
<THEMENAME>/img/*.png
<THEMENAME>/css/*.css

When you don't have to make a theme

  1. head
    • config.html_head is added into the <head> element for all pages, while

  2. body
    • you can use some html fragments to customize moin's output (we are referring to classic theme, others could differ) - here is the sequence how stuff is output:

    • header:
      • config.page_header1
      • config.logo_string - use this to modify the logo (usually at top left)
      • username, title
      • iconbar
      • config.navi_bar - is a list of page names that are added to the title area, if None, add no navigation bar.
      • trail
      • config.page_header2
      • msg
    • wiki page
    • footer:
      • config.page_credits
      • config.page_footer1
      • EditText, search forms, actions

      • config.page_footer2
  3. as a wiki user, you can override theme CSS settings by putting your own user CSS URL into UserPreferences - this CSS is loaded after the theme CSS, so you can override all you want changed. Your CSS file must be in UTF-8 encoding (and as ASCII is a subset of that, it is ok, too).

page_header1, page_header2, page_footer1 and page_footer2 can now be callables and will be called with the "request" object as a single argument (note that you should accept any keyword arguments in order to be compatible to future changes).

HelpOnThemes (last modified 2007-04-01 02:20:37)