SearchWiki
PmWiki.RecentChanges
Edit Page
Page Revisions
Groups available

CSA
Calendar
Main
NoSQL
People
PmWiki
PmWikiIt
PtvDev
RssFeeds
ScriptaVox
ScriptaWeb
ScriptaWiki

Quick links

TextFormattingRules
Edit Menu

Campaigns

WikiStyles 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
This text is red and this text is blue but this text is normal.

The set of predefined WikiStyles is customizable by the WikiAdministrator. Most PmWiki 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

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

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.
This text is white on green and this is green on white.

Finally, 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
Any links on this line like http://www.pmichaud.com will open in a new window.

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 GroupHeaders so that they can be shared among multiple pages in a group. Or, the WikiAdministrator can predefine styles as a LocalCustomization -- see WikiStylesAdmin?.

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 WikiStyleColors

<< TextFormattingRules | PmWiki.DocumentationIndex | InterMap >>

Edit Page - Page Revisions - WikiHelp - SearchWiki - RecentChanges - Printable version
Page last modified on December 30, 2003, at 01:34 (CET)