Embperl - building dynamic websites with Perl

Do an linear search instead of a binary search. This is necessary if the tokens can't clearly separated.

Defines the default type for text nodes. Without any specification the type is CDATA, which mean no escaping takes places. With ntypText all special characters are escaped.

Name for a root node to insert always.

All items which does not start with a slash are treated as names. The name of a token is only descriptive and is used in error messages. The item must contain a hashref which describes the token.

Start text

End text

when set to 1 new token starts at next character, when set to -1 new token starts at next character, but only if it is the first token inside another one.

Text that should be outputed when node is stringifyed. Defaults to text. If the first character is a ':' you can specify the sourounding delimiters for this tag with :<start>:<end>:<text>:<endtag>. Example: ':{:}:NAME' . If the nodename starts with a '!' a unique internal id is generated, so two or more nodename of the same text, can have different meaning in different contexts.

Token consists of the following characters. Either start and end or contains could be specified.

NOTE: If a item that only specfifies contains but no text should be compiled, you must specfify a nodname.

If optRawInput isn't set unescape the data of the inside the node

Type of the node

Type of nodes for data (which is not matched by 'inside' definitions) inside this node. Set to zero to not generate any nodes for text inside of this node, other then these that are matched by a 'inside' definition.

Name of the tag that marks the end of a block. This is used by the parser to track correct nesting.

Hashref that specifices one or more tokens that must follow this token.

Hashref that specifices one or more tokens that could occur inside a node that is started with this token.

when the token found, the parser stop searching in the current level and continues with the tokens that are defined in the hash from there the current one was "called" via inside

set to 1 to don't eat the start text, so it will be matched again, by any tokens set under inside. Set 2 to don't the end text. Set to 3 for both.

Processor info. Hashref with information how to process this token.

Code to generate. You can also specify a arrayref of strings. The first string which contains matching attributes are used. The following special strings are replaced:

	%%
	Text of childnode number <N> (starting with zero)
	%><N>%
	Text of sibling node number <N> . 0 gives the current node, > 0 gives the Nth next node, < 0 gives the Nth previous node.
	%&<attr>%
	Value of attribute <attr>.
	%^<stackname>%
	Stringvalue of given stack
	%?<stackname>%
	Set if stackvalue was used
	%$n%
	Source Dom Tree, Index of current node.
	%$t%
	Source Dom Tree
	%$x%
	Index of current node
	%$l%
	Index of last node
	%$c%
	Sets the current node Index, if not already done
	%$q%
	Index of source Dom Tree
	%$p%
	Number of current checkpoint
	%%
	Gives a single %

All of the above special values (expect those start with $) allows the following modifiers:

	%<X>*<N>%
	Attribute/Child etc. must exist.
	%<X>!<N>%
	Attribute/Child etc. must not exist.
	%<X>=<N>:<value1>|<value2>|<value3>%
	Attribute/Child etc. must have the value = <value1> or <value2> etc.
	%<X>~<N>:<value1>|<value2>|<value3>%
	Attribute/Child etc. must contain the substring <value1> or <value2> etc. and a non alphanum character must follow the substring.

writing a minus sign (-) after * ! = or ~ will cause the child/attribute not to be included, but the condition is evaluated. Writing an ' will cause the value to be quoted.

Code to generate at the end of the block.

Code that is executed at compile time. You can also specify a arrayref of string. The first string which contains matching attributes are used. The same special strings are replaced as in perlcode.

$_[0] contains the Embperl request object. The method Code can be used to get or set the perl code that should be generated by this node.

If the code begins with #!- all newlines are removed in the code. This is basically useful to keep all code on the same line, so the line number in error reporting matches the line in the source.

Code that is executed at compile time, but at the end of the tag. The same special strings are replaced as in perlcode.

$_[0] contains the Embperl request object. The method Code can be used to get or set the perl code that should be generated by this node.

If the code begins with #!- all newlines are removed in the code. This is basically useful to keep all code on the same line, so the linenumber in error reporting matches the line in the source.

Remove perlcode if perlcodeend condition is not met.

Remove node after compiling. <removelevel> could be one of the following, values could be added:

	1
	Remove this node only
	2
	Remove next node if it consists of only white spaces and optKeepSpaces isn't set.
	3
	Replace next node with one space if next node consists only of white spaces and optKeepSpaces isn't set.
	4
	Set this node to ignore for output.
	5
	Remove all child nodes
	6
	Set all child nodes to ignore for output.
	7
	Calculate Attributes values of this node also for nodes that are set to ignore for output (makes only sense if 8 is also set).

Remove spaces before or after tag.

	1
	Remove all white spaces before tag
	2
	Remove all white spaces after tag
	3
	Remove spaces and tabs before tag
	4
	Remove spaces and tabs after tag
	5
	Remove all spaces and tabs but one before tag
	6
	Remove all whihe space after text inside of tag
	7
	Remove spaces and tabs after text inside of tag

If set, tells the compiler that this code may jump to another program location. (e.g. if, while, goto etc.). Could also be a condition as described under perlcode.

Compile child nodes. Default: 1

Name of stack for push, stackmatch =item stackname2 => <name>

Name of stack for push2 =item push => <value>

Push value on stack which name is given with stackname. Value could include the same specical values as perlcode

Push value on stack which name is given with stackname2. Value could include the same specical values as perlcode

Check if value on stack which name is given with stackname is the same as the given value. If not give a error message about tag mismatch. Value could include the same specical values as perlcode

1 means put the following code into normal code which is executed every time the page is requested

2 means put the following code put into code which is executed direct after compilation. This is mainly for defining subs, or using modules etc.