(:Summary: Predefined PmWiki styles & adding custom wiki styles:)
(:Audience: administrators (intermediate) :)
This page describes the predefined [[Wiki Styles]] and how a [[Wiki Administrator]] can define additional [[Wiki Styles]] as a local customization for all pages (in local/config.php) or specific groups (in local/$Group.php).

All predefined [[Wiki Styles]] are setup in the global array $WikiStyle.
To define your own [[Wiki Styles]], add the setting of the correspondent `WikiStyle within the array.

[[#predef]]
!! Predefined Wiki Styles

The following array-values are set by [@scripts/wikistyles.php@] using the [[Cookbook:Functions#SDV |SDV()-function]] (so you can overwrite them by setting them prior in config.php or farmconfig.php):

||width=70% border=1 cellpadding=3 cellspacing=0
||'''markup:''' ||'''definition:''' ||
||[[<<]]'''text colors:''' [[<<]] (equiv. to [@%define=xxxx color=xxxx%@] ||||
|| [@%black%@] ||[@$WikiStyle['black']['color'] = 'black';@] ||
|| [@%white%@] ||[@$WikiStyle['white']['color'] = 'white';@] ||
|| [@%red%@] ||[@$WikiStyle['red']['color'] = 'red';@] ||
|| [@%yellow%@] ||[@$WikiStyle['yellow']['color'] = 'yellow';@] ||
|| [@%blue%@] ||[@$WikiStyle['blue']['color'] = 'blue';@] ||
|| [@%gray%@] ||[@$WikiStyle['gray']['color'] = 'gray';@] ||
|| [@%silver%@] ||[@$WikiStyle['silver']['color'] = 'silver';@] ||
|| [@%maroon%@] ||[@$WikiStyle['maroon']['color'] = 'maroon';@] ||
|| [@%green%@] ||[@$WikiStyle['green']['color'] = 'green';@] ||
|| [@%navy%@] ||[@$WikiStyle['navy']['color'] = 'navy';@] ||
|| [@%purple%@] ||[@$WikiStyle['purple']['color'] = 'purple';@] ||
||[[<<]]'''list-styles:''' ||||
|| [@%decimal%@] ||[@$WikiStyle['decimal']['apply'] = 'list';@][[<<]][@$WikiStyle['decimal']['list-style'] = 'decimal';@] ||
|| [@%roman%@] ||[@$WikiStyle['roman']['apply'] = 'list';@][[<<]][@$WikiStyle['roman']['list-style'] = 'lower-roman';@] ||
|| [@%ROMAN%@] ||[@$WikiStyle['ROMAN']['apply'] = 'list';@][[<<]][@$WikiStyle['ROMAN']['list-style'] = 'upper-roman';@] ||
|| [@%alpha%@] ||[@$WikiStyle['alpha']['apply'] = 'list';@][[<<]][@$WikiStyle['alpha']['list-style'] = 'lower-alpha';@] ||
|| [@%ALPHA%@] ||[@$WikiStyle['ALPHA']['apply'] = 'list';@][[<<]][@$WikiStyle['ALPHA']['list-style'] = 'upper-alpha';@] ||
||[[<<]]'''special:''' ||||
||open links in a new browser-window: ||||
|| [@%newwin%@] ||[@$WikiStyle['newwin']['target'] = '_blank';@] ||
||Turns markup into a comment via display:none CSS ||||
|| [@%comment%@] ||[@$WikiStyle['comment']['display'] = 'none';@] ||

!!Author-Defined Wiki Styles

# The first index of the array defines the style name (e.g. mynewstyle, projectentry etc)
# the second index defines the attribute name (e.g. color, background-color, etc.)
# the value set defines the attribute value (e.g. red, bold, #00ffcc, etc.)

'''Sample:''' If you want to define a (site-wide) style the same as the page style
->[@%define=projectentry color:red%@]
use
->[@$WikiStyle['projectentry']['color'] = 'red';@]


The [@$WikiStyle['projectentry']['apply']@] variable may be defined if the wikistyle concerns a particular tag. It may be @@'item' (for li|dt), 'list' (for ul|ol|dl), 'div', 'pre', 'img', 'p'@@ or the combining @@'block' (for p|div|ul|ol|dl|li|dt|pre|h[1-6])@@. Example:

[@$WikiStyle['top']['apply'] = 'item';@]
[@$WikiStyle['top']['class'] = 'top';@]

then a markup
[@* %top% An important list-item@]
will output
[@<li class="top">An important list-item</li>@]

!! Printer-Friendly Styles

If your custom-styles (in local/config.php) are getting very colorful it might be useful to disable them in print-view. This can be done easily by putting them into a condition.

[@if($action!="print") {
// your custom-styles
}@]

!!Notes

!!!To be done:

!!Questions:
'''I tried this but background didn't work, thou border and float worked?''' /Vincent 2008-04-08
[@
$WikiStyle['vMenu']['background']='#ffffcc' ;
$WikiStyle['vMenu']['float']='left' ;
$WikiStyle['vMenu']['border']='1px dotted red' ;
@]
->Try using [@$WikiStyle['vMenu']['background-color']='#ffffcc';@] -- unlike @@background@@, @@background-color@@ is defined in the $WikiStyleCSS array, which is checked for valid properties.

Life is short, and this article saved vaulbale time on this Earth.

Thanks for sharing. Always good to find a real exerpt.

Thanks for wrtiing such an easy-to-understand article on this topic.

That’s more than senilsbe! That’s a great post!

I ralely appreciate free, succinct, reliable data like this.

You’re on top of the game. Thanks for shanrig.

If my problem was a Death Star, this article is a pohotn torpedo.

I'll try to put this to good use imemdatiely.

To think, I was cnoufsed a minute ago.

aacE9h , [url=http://kwqfyklhhfcb.com/]kwqfyklhhfcb[/url], [link=http://pefuxdmosxeo.com/]pefuxdmosxeo[/link], http://xnrrvhddolsi.com/

XNKE9a <a href="http://mujfpegeqazg.com/">mujfpegeqazg</a>

Thanks for the inshigt. It brings light into the dark!