MentalWealth readme

Licensed under the GPL for free use. Do not remove credit or claim it as your own. Your continuing comments and bug reports are welcome.

Description

This is an updated version of my MentalHealth theme, but with the sidebar on the left. After due consideration I believe this affords greater usability. If you are reading this in your web browser you are viewing a screen that simulates how the theme will look while running in MoinMoin. Actions are disabled because they have no meaning in this context. Of course they will work correctly in a real wiki!

Installation

Install in the usual way, depending on what type of MoinMoin application you have. Basically:

move mentalwealth.py to where your other theme programmes are
move the mentalwealth folder under your htdocs folder

If you require more help, see the MoinMoin docs, particularly HelpOnThemes.

Skinning The Theme

I have re-introduced the four skins that came with MentalHealth. Take a look in htdocs/mentalwealth/css/ and locate the screen.css file. This now consists of only stylesheet imports. First is a required import for base.css which, as its name would suggest, contains all the basic styles that MentalWealth sets.

Next, there are imports for several skin stylesheets. All should be commented out except the one you wish to use. (Actually, you can leave them all in, but change the order to suit yourself, as only the last will take precedence.) The files skin-*.css contain only colour styles. Use the one you wish, or create your own.

Custom Smilies

Unfortunately there is no good way to customise the icon set that comes with MoinMoin. I have developed a set of bug tracking icons, but in order to use them you must hack the code in config.py to add the following to the end of the smilies dictionary:

# robin addition: bug icons
"|b":  (18, 18, 0, "bugblack.png"),
"|a":  (18, 18, 0, "bugamber.png"),
"|r":  (18, 18, 0, "bugred.png"),
"|g":  (18, 18, 0, "buggrey.png"),
"|z":  (18, 18, 0, "bugzap.png")

To see all the smilies that are available to you, use the [[ShowSmileys]] macro on one of your pages.

More Actions

There are now six panels in the sidebar: Search, Navigation, Recent, This Page, More Actions and User. At the top of the file mentalwealth.py there is a constant MOREACTIONS which defaults to True. Change this to False if you don't want the new More Actions panel.

Further Customisation

People email me asking if I would change things like spaces between sections and other display minutae. Unless these cause real display problems, the answer is likely to be "no". That's because you can easily customise base.css yourself by learning a little about CSS. There are many good CSS tutorials available on the web. If you wish more extensive design work (HTML, CSS, graphics, SEO, etc.) you may contract my services.

Issues

There is one known problem with this theme which is illustrated on the demo page. If there are really wide links in the sidebar, they will extend over the available space. In FireFox this is not too bad, since only the text itself extends. However, in IE6 the entire box extends into the page space, playing havoc with the layout. If you know of a fix, please let me know.

Inspiration

"Oh we're in love with beauty
We're in love with wealth
We're in love with mental health."
-- Julian Cope

Version History

version 0.96 (22 February 2009)

compatible with moin 1.7.1

version 0.95 (16 May 2006)

Support for additional actions in new side panel. Add bug tracking icons.

BuildLinks(): new class to aid in building list of links
editbar(): factor out code now in BuildLinks()
editbarmore(): build side panel for "More Actions"
header(): move list of possible actions to here
header(): call editbarmore()

version 0.94 (28 April 2006)

additional support for MoinMoin 1.5
stylesheet simplifications
delegation of colours to specific skin stylesheets

screen.css: factor code to base.css and skin-*.css
skin-*.css: re-introduce four different palettes
base.css: clean up main typography
base.css: use only placeholder colours
base.css: change "logo" font-size to em specification & reduce in size to same as h1
base.css: tweak styles for "pre"
base.css: add good default styles for tables
base.css: reduce overall font size (customise by changing setting in initial "html" block)
base.css: change "sidebar" margins to match other panels
base.css: change "html" background colour to white, so it matches
base.css: bold headings h5 and h6
base.css: no bottom margin on h6
common.css: TableOfContents macro support
common.css: .strike support
common.css: move classes to here for: message, dialog, diffs

version 0.93 (21 April 2006)

special first anniversary release
compatibility with MoinMoin 1.5

header(): remove self.title(d) from end of parts list
readme.html: vastly updated
common.css: pointless tweaks :-)
screen.css: header layer background colour made compatible with set
screen.css: tweak header sizes and margins
screen.css: increase teletype size
screen.css: #header styled as other floating panels

version 0.92 (19 October 2005)

initial release born from MentalHealth

remove skinned stylesheets
header(): add in missing logo
editbar(): some few optimisations
screen.css: clearer header definitions
screen.css: new h4 following pattern
print.css: make grey-scale
print.css: suppress navigation elements
print.css: omit fancy formatting

version 0.91 (25 April 2005)

style tweaks

common.css: remove heading styles from here since we will customise them
screen.css: redefine "div.codearea pre" for smaller font
screen.css: fix for IE6 in "#editor-textarea, #editor-comment"
screen.css: smaller heading fonts
screen.css: bottom border retained on h2 but not other headings
screen.css: left border style on h3
screen02.css: fixed tints (two shades were reversed)

version 0.90 (20 April 2005)

initial release born from "rightsidebar" theme

got rid of ugly action pulldown menu
search form integrated with panel look
improved alignment, sizes etc.
nice colours to soothe the soul
smaller type so more fits