Wiki Styles allow an author to modify the color and other attributes of text that follow. A style specification such as %red% will cause the following text to be displayed as red until the end of the line or the next pair of percent signs. For example:

   %red% This text is red and %blue% this text is blue %% but 
   this text is normal.

gives

The set of predefined Wiki Styles is customizable by the Wiki Administrator. Most Pm Wiki systems define %newwin% to cause links to open in a new window (example), and standard text colors such as %black%, %white%, %red%, %green%, %blue%, etc.

Creating new styles

Placing color, bgcolor, or target specifications inside of a pair of percent signs will change the style of the following text to use those colors up to the end of a line or until the next pair of percent-signs. For example:

    %color=red% This text is red and %color=blue% this text 
    is blue %% but this text is normal. 

renders as

One can also change the background color using the bgcolor attribute:

    %color=white bgcolor=green% This text is white on green %color=green% and
    this is green on white. 

One can specify that links should open in a new window via the target attribute:

    %target=_blank% Any links on this line like http://www.pmichaud.com 
    will open in a new window. 

which gives

Finally, Wiki Styles can control the width and height of Images In Wiki Pages, thus the markup

    %height=50% http://www.example.com/some.gif

will display some.gif scaled to a height of 50 pixels.

Style definitions

Wiki authors can also make their own WikiStyle definitions within a document using the define attribute. For example, the statement

    %define=hotpink color=#ff69b4%

will cause the markup %hotpink% to be a shortcut for %color=#ff69b4% (like this). One can specify multiple items in a definition, as in

    %define=reverse color=white bgcolor=black%

which allows %reverse% to cause reverse video, and %reverse hotpink% to be the combination of both shortcuts.

It's often a good idea to put common style definitions into Group Headers so that they can be shared among multiple pages in a group. Or, the Wiki Administrator can predefine styles as a LocalCustomization -- see Wiki Styles Admin.

Predefined styles

The style %comment%comment
.%% can be used to embed comments that are not shown. For a multiline comment, write something like this:

  %comment% [=
    This is a longer block
    of text that has been commented out
    by the %comment% markup. =]

Colors

For some examples of colors, see Wiki Style Colors

<< Text Formatting Rules | PmWiki.Documentation Index | Uploads >>