administrators (intermediate)
This page describes the predefined
WikiStyles and how a
Wiki Administrator can define additional
WikiStyles as a local customization for all pages (in local/config.php) or specific groups (in local/$Group.php).
All predefined
WikiStyles are setup in the global array
$WikiStyle.
To define your own
WikiStyles, add the setting of the correspondent WikiStyle within the array.
Predefined WikiStyles
The following array-values are set by
scripts/wikistyles.php using the
SDV()-function (so you can overwrite them by setting them prior in config.php or farmconfig.php):
| markup: | definition: | |
text colors:
(equiv. to %color=xxxx define=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 WikiStyles
- 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, bgcolor, 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>
Notes
To be done:
<< Custom markup | Documentation Index | Available actions >>