FilterPlugin
This plugin allows to substitute and extract information from content by
using regular expressions.
Syntax Rules
SUBST
Syntax:
%SUBST{topic="..." ...}%
insert a topic by processing its content.
-
topic="..."
: name of the topic text to be processed
-
pattern="..."
: pattern to be extracted or substituted
-
format="..."
: format expression or pattern substitute
-
hits="<n>"
number of occurences to extract or substitute counted from the start of the text (defaults to 0
aka all hits)
-
expand="on,off"
: toggle expansion of TWiki markup before filtering (defaults to on
)
STARTSUBST, STOPSUBST
Syntax:
%STARTSUBST{...}%
...
%STOPSUBST%
substitute text given inline. see
SUBST.
EXTRACT
Syntax:=%EXTRACT{topic="..." ...}%=
extract text from a topic. see
SUBST.
STARTEXTRACT, STOPEXTRACT
Syntax:
%STARTEXTRACT{...}%
...
%STOPEXTRACT%
extract content given inline. see
SUBST.
FORMATLIST
Syntax: =%FORMATLIST{"<list>" ...}%
formats a list of items. The <list> argument is separated into items by using
a split expression; each item is matched agains a pattern and then formatted
using a format string while being separated by a separator string; the result is
prepended with a header and appended with a footer in case the list is not empty.
- <list>: the list
- split="...": the split expression (default ",")
- pattern="...": pattern applied to each item (default "\s(.*)\s")
- format="...": the format string for each item (default "$1")
- header="...": header string
- footer="...": footer string
- separator="...": string to be inserted between list items
- limit="...": max number of items to be taken out of the list (default "-1")
- sort="on,off,alpha,num" order of the formatted items (default "off")
- reverse="on,off": reverse the sortion of the list
- unique="on,off": remove dupplicates from the list
- exclude="...": remove list items that match this regular expression
The pattern string shall group matching substrings in the list item to which you can refer to by
using $1, $2, ... in the format string. Any format string (
format
,
header
,
footer
) may
contain variables
$percnt$
,
$nop
,
$dollar
and
$n
. The variable
$index
referse to the position number within the list being formatted; using
$count
in the
footer or header argument refers to the total number of list elements.
Examples
Secure Html
<a href="javascript:window.alert('Pop me up');">Pop me up</a>
Format Comments
Plugin Installation Instructions
- Download the ZIP file
- Unzip it in your twiki installation directory. Content:
File: | Description: |
data/TWiki/FilterPlugin.txt | Plugin topic |
lib/TWiki/Plugins/FilterPlugin.pm | Plugin Perl module |
- (Dakar) Visit
configure
in your TWiki installation, and enable the plugin in the {Plugins} section.
Plugin Info
--
TWiki:Main.MichaelDaum - 13 Oct 2006