Adam, Ruth, Ethan and Ori’s Wiki

Wiki Styles allow authors to modify the color and other styling attributes of the contents of a page. A Wiki Style? is written using percent-signs, as in %red% or %bgcolor=lightblue%.

Wiki Style? attributes

The style attributes recognized within a Wiki Style? specification are:

bgcolor
background-color
border1
color
display
float
clear
font-size
font-family
font-weight
font-style

heightfn
list-style
margin1
padding1
text-align
text-decoration
white-space
widthfn 

accesskey 
align
class
hspace 
id 
target 
rel 
vspace 
value
reversed

Special: define, apply

The attributes in the first two columns correspond to the cascading style sheet (CSS) properties of the same name. The attributes in the last column apply only to specific items:

• class= and id= assign a CSS class or identifier to an HTML element
• target=name opens links that follow in a browser window called “name”
• rel=name in a link identifies the relationship of a target page
• accesskey=x uses ‘x’ as a shortcut key for the link that follows
• value=9 sets the number of the current ordered list item
  • The width and height attributes have asterisks because they are handled specially for <img …/> tags. If used by themselves (i.e., without anything providing an “apply=“ parameter to the Wiki Style?), then they set the ‘width=‘ and ‘height=‘ attributes of any <img … /> tags that follow. Otherwise, they set the ‘width:’ and ‘height:’ properties of the element being styled.
  1. margin, padding, and border can be suffixed by -left, -right, -top, and -bottom

Wiki Styles versus CSS styles

Wiki Styles, as written in the wiki page, are not exactly CSS styles or CSS classes. Wiki Styles allow authors to use both pre-defined by the administrator CSS classes, and to define new combinations of styles, without any need to edit/update local CSS files on the server.

Note that PmWiki allows advanced authors to use of class= and style= in tables and division blocks, but these are raw HTML attributes, and not Wiki Styles; knowledge of CSS is required to use them.

Text color and font

The most basic use of Wiki Styles is to change text attributes such as color, background color, and font. PmWiki defines several Wiki Styles for changing the text color to %black%, %white%, %red%, %yellow%, %blue%, %gray% (%grey%), %silver%, %maroon%, %green%, %navy%, %fuchsia%, %olive%, %lime%, %teal%, %aqua%, %orange% and %purple%.

The basket contains %red% apples, %blue% blueberries, %purple% eggplant, %green% limes, %% and more.

For colors other than the predefined colors, use the %color=...% Wiki Style?. (Note: RGB colors (#rrggbb) should always be specified with lowercase letters to avoid WikiWord conflicts.)

I'd like to have some %color=#ff7f00% tangerines%%,  too!

To change the background color, use %bgcolor=...% as a Wiki Style?:

This sentence contains %bgcolor=green yellow% yellow text on a green background.

See WikiStyle Colors for more color help.

Text justification

Wiki Styles are used to control the text justification

%center% This text is centered. 

%right% Right justified.

and to create floating text:

%rfloat% This text floats to the right

%rframe% floats to the right with a frame

Lorem ipsum dolor sit amet, consectetuer sadipscing elitr

Scope

Wiki Styles can also specify a scope; with no scope, the style is applied to any text that follows up to the next Wiki Style? specification or the end of the paragraph, whichever comes first. The apply= attribute and its shortcuts allow to change the scope as follows:

Thus, %p color=blue% is the same as %apply=p color=blue%, and %list ROMAN% is the same as %apply=list list-style=upper-roman%.

Some predefined style shortcuts also make use of apply, thus %right% is a shortcut for %text-align=right apply=block%.

%p bgcolor=#ffeeee% The WikiStyle specification at the beginning of this line applies to the entire paragraph, even if there are %blue% other WikiStyle specifications %% in the middle of the paragraph.

Caveat: An applied Wiki Style? will only take effect if it’s on the line that starts the thing it’s supposed to modify. In other words, a Wiki Style? in the third markup line of a paragraph can’t change the attributes of the paragraph:

after the first line of the paragraph,
we try to %apply=p color=blue% change color.
This does't work because the style comes after the first line of the paragraph.

However, this %apply=p color=red% paragraph
''will'' be in red because its block style does
occur in the first line of its text.

* Here's a list item
* %list red% Oops, too late to affect the list!

If you want to break a list in two, you need to have a line not part of the list between, that is a line that has any content other than space and newlines, otherwise PmWiki considers the vertical space part of the previous list item. You can have an non-breaking space, or the escaped null character:

* %list red% first item
* second item
 
* %apply=list bgcolor=lightgreen% second list - first item
* second list - second item
[==]
* %list class=mambo% third list - first item
* third list - second item

Larger blocks

The >>WikiStyle<< block can be used to apply a Wiki Style? to a large block of items. The style is applied until the next >><< is encountered.

>>blue font-style:italic bgcolor=#ffffcc<<
Everything after the above line is styled with blue italic text,

This includes
    preformatted %red%text%%
* lists
-> indented items
>><<

   preformatted text

Note, the (:div style="..." class="...":) directive does not work the same way as >>WikiStyle<<, it can only contain the regular HTML style and class attributes.

HTML “class” and “style” attributes for tables and divisions

Wiki Styles are only the commands between %...% percent signs.

Tables, table directives and (:div:) division blocks allow advanced authors to incorporate the HTML/CSS attributes class= and style=. Note that these attributes are not Wiki Styles, knowledge of CSS is required to use them.

(:table style="font-style:italic; color:green; border:1px solid blue; background-color:#ffffcc":)
(:cellnr:)
Everything after the above line is styled with green italic text,

This includes
    preformatted text
* lists
-> indented items
(:tableend:)

   preformatted text

Note, the (:div style="..." class="...":) directive does not work the same way as >>style<<, as mentioned above, it can only contain the HTML style and class attributes.

Custom style shortcuts

The define= attribute can be used to assign a shorthand name to any Wiki Style? specification. This shorthand name can then be reused in later Wiki Style? specifications.

%define=box block bgcolor=#ddddff border="2px dotted blue"%

%box% [@some sort of text@]

%box font-weight=bold color=green% [@some sort of text@]

Predefined style shortcuts

PmWiki defines a number of style shortcuts.

• Text colors: black, white, red, yellow, blue, gray (grey), silver, maroon, green, navy, purple, fuchsia, olive, lime, teal, aqua, orange (shortcut for %color=...%)
• Justification: %center% and %right%
• Images and boxes
  • Floating left or right: %rfloat% and %lfloat%
  • Framed items: %frame%, %rframe%, and %lframe%
  • Thumbnail sizing: %thumb%
• Open link in new window: %newwin% (shortcut for %target=_blank%)
• Comments: %comment% (shortcut for %display=none%). This is not meant to hide secrets, as the hidden content is still printed into the HTML source of the page — readable to bots (and may appear in web searches) or via “View: Source” and “View: Page Style: None” in the browser.
• Ordered lists: %decimal%, %roman%, %ROMAN%, %alpha%, %ALPHA%, %reversed% (see also Cookbook:OutlineLists)

Enabling the “Syntax Highlight” code beautifier library

Since version 2.2.119, PmWiki makes it relatively easy to enable syntax highlighting for preformatted text blocks. Note, a block is considered a “code block” for highlighting if it is rendered as a preformatted element. see BasicEditing#preformatted for 3 ways to do this.

To enable syntax highlighting, add to config.php:

 $EnableHighlight = 1;
 $HTMLHeaderFmt[‘Highlight’] = ‘
 <link rel=“stylesheet” href=“https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@10.0.0/build/styles/default.min.css” />
 <script src=“https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@10.0.0/build/highlight.min.js”></script>’;

This loads the Highlight.js library from a global CDN, but you can copy these 2 files to your pub directory and link to them instead.

Then, in a wiki page, you can use the %highlight% or %hlt% wikistyles, and the language to mark your code blocks.

Either immediately before the code block:

%hlt php%[@
  function SDVA(&$var,$val)
    { foreach($val as $k=>$v) if (!isset($var[$k])) $var[$k]=$v; }
  function IsEnabled(&$var,$f=0)
    { return (isset($var)) ? $var : $f; }
@]

  function SDVA(&$var,$val)
    { foreach($val as $k=>$v) if (!isset($var[$k])) $var[$k]=$v; }
  function IsEnabled(&$var,$f=0)
    { return (isset($var)) ? $var : $f; }

Or in a wrapping division block:

>>highlight css<<
  /* These adjust the size and spacing of heading elements */
  h1, h2, h3, h4, h5, h6 { margin:1.0em 0 .6em 0; }
  h1, h2, h3, h6 { font-weight:normal; }
  h4, h5 { font-weight:bold; }
>><<

 /* These adjust the size and spacing of heading elements */
 h1, h2, h3, h4, h5, h6 
 h1, h2, h3, h6 
 h4, h5 

If you have the feature correctly enabled you will see the syntax highlighting of the above code.

Enabling Styles

Styles not listed above can be enabled by a PmWiki Administrator by modifying the local/config.php file. For instance to enable the “line-height” style attribute add the following line to the local/config.php file:

Defining scope for other HTML elements

You can add additional HTML elements to $WikiStyleApply to apply Wiki Styles to other HTML elements. For example to allow styling on anchor tags:

 $WikiStyleApply[‘link’] = ‘a’;

Examples

WikiStyle Examples contains a number of examples of ways to use Wiki Styles in pages.

Known Issues

• Percents in style definitions (like: %block width=50% %) require the use of “pct” instead of “%”. PmWiki will convert the “pct” into “%” so that it becomes valid CSS.
• If you specify multiple values for an attribute, like border=“2px solid blue” make sure you place the values in quotes.
• Be sure to use lowercase letters for red-green-blue hex colors, %color=#aa3333% will work, %color=#AA3333% may not.

See Also

• Custom WikiStyles Predefined PmWiki styles & adding custom wiki styles
• PmWiki:List Styles
• WikiStylesPlus