!!!An administrator can turn extensions on and off
[[Wikipublisher]] works best when all MarkupExtensions are turned on. This is the [[install]]ation default. However, all extensions are optional, controlled through the $MarkupExtensionsFmt array. This is set to:
[=
SDV($MarkupExtensionsFmt,
array("inote abbr `A `. `- `s `: `f -d ... aquo mac '/ '@ '; [^",
"q&a A; {|} =| {= revisions ^!! fig :: para lazyweb spaced squo links"));
=]
To enable a selected subset of these markups, copy the above 3 lines into local/config.php ''before'' including the [[Wikipublisher]] library and remove the markups you don't want.
To disable just a few markups, add one or more lines like the following ''before'' including the library:
[=$MarkupExtensions['extension'] = false;=]
For example, [=$MarkupExtensions['q&a'] = false;=] will disable the variant of Q: and A: markup, restoring PmWiki's default behaviour.
!!!Available extensions
All extensions "do the right thing" when a page is composed for printing.
||border=1 cellspacing=0 bordercolor=gray
||!List of extensions!||
||!Extension ||!Markup ||!Function ||
||inote ||[@(:inote PageName:)@] ||inserts the contents of `PageName formatted as a sticky note ||
||abbr ||n/a ||prevents wikiwords with only one lower case letter, like PhD or CIOs ||
||[=`A=] ||[@Wiki`Word@] ||another way to prevent wikiwords, like Ph`D ||
||[=`.=] ||[@`.@] ||invisible stop; removed on output, tells markups such as para to "stop" ||
||[=`-=] ||[@`-@] ||backtick-hyphen makes an en dash – (meaning "to" as in A–B) ||
||[=`s=] ||[@` @] ||backtick-space makes a non-breaking space ||
||[=`:=] ||[@`:@] ||backtick-colon makes a mid-dot · ||
||[=`f=] ||[@`1/4 `1/2 `3/4@] ||makes a fraction ¼ ½ ¾ ||
||-d ||[@-- d-d +- -d@] ||make em dash —, digit en dash digit, plus or minus ±, and minus digit ||
||[=...=] ||[@...@] ||ellipsis … ||
||aquo ||[@<- -> <<...>> <...| |...>@] ||left and right arrows ← → and angle quotes « ... » ‹ ... | and | ... › ||
||mac ||{vowel} ||macronised vowels Ā, ā, Ē, ē, etc ||
||'/ ||[@'/text/'@] ||<cite>text</cite> (often rendered in italics) ||
||'@ ||[@'@text@'@] ||<kbd>text</kbd> (often rendered in monospace) ||
||'; ||[@';text;'@] ||small caps text (if the browser supports this font variant) ||
||[^ ||[@[^footnote text^]@] and [@[^#^]@] ||swallow footnote text and list the footnotes, with links both ways ||
||copy ||[@(tm) (r) (c)@] ||™ ® © symbols ||
||q&a ||Q: and A: ||render Q: and A: markups with drop-caps ||
||A; ||D;rop caps; markup ||Drop cap followed by small caps (looks stunning in pdf) ||
||[={|}=] ||[@{abbr|abbreviation}@] and [@{:term:definition}@] ||<abbr title='...'> and <dfn title='...'> tags (with print equivalents) ||
||=| ||[@=<text, =|text and =>text@] ||left, centred and right aligned text (left and right aligned omitted in print) ||
||{= ||[@{=sticky note|colour=}@] ||a sticky note, colour (optional) is yellow, green, blue, purple, pink, grey ||
||revisions ||(:`.revisions:) ||toggle between show and hide revision markups {+insert+} and {-delete-} ||
||^!! ||[@!run-in head!text@] ||run-in headings (if the browser supports this -- looks stunning in pdf) ||
||fig ||=figure image caption ||display an image and its caption (superseded by image | caption) ||
||:: ||:term:definition::more definition ||multiple <dd> tags per <dt> tag (also tidy :: used for indenting) and * item::more text for paragraphs in lists ||
||para ||T[*#:] Name#id and [@(:para Name#id action:)@] ||teaser markup and paragraph include markup (action = more, edit) ||
||lazyweb ||[@www.affinity.co.nz@] ||lazy web links -- omit the [=http://=] ||
||spaced ||n/a ||tidy wikiword spacing and display wikiwords like `TheReturnOfTheKing as The Return of the King ||
||squo ||n/a ||automatic smart quotes -- highly recommended for pdf ||
||links ||n/a ||automatic tool tips on wiki links, if the page starts with a heading or definition; also disables links to the page you're on, and highlights them ||