Inserts values from files, cookies, defines or variables. If used to insert cookies or variables <insert> will quote before inserting, to make it impossible to insert dangerous RXML tags.

Attributes

cookie=cookie

Inserts the value of the cookie.

cookies=full

Inserts the value of all cookies. With the optional argument full, the insertion will be more verbose.

encode=none html

Determines what quoting method should be when inserting cookies or variables. Default is html, which means that <, > and & will be quoted, to make sure you can't insert RXML tags. If you choose none nothing will be quoted. It will be possible to insert dangerous RXML tags so you must be of what your variables contain.

define=name

Inserts this define, which must have been defined by the <define> tag before it is used. The define can be done in another file, if you have inserted the file.

file=path

Inserts the file. This file will then be fetched just as if someone had tried to fetch it through an HTTP request. This makes it possible to include things like the result of Pike or CGI scripts.

If path does not begin with /, it is assumed to be a URL relative to the directory containing the page with the <insert> tag. Note that included files will be parsed if they are named with an extension the main RXML parser handles. This might cause unexpected behavior. For example, it will not be possible to share any macros defined by the <define> tags.

If you want to have a file with often used macros you should name it with an extension that won't be parsed. For example, .txt.

fromword=toword

Replaces fromword with toword in the macro or file, before insering it. Note that only lower case character sequences can be replaced.

nocache

Don't cache results when inserting files, but always fetch the file.

variable=variable

Insert the variable.

Example

<define name=foo>This is a foo</define>

<insert name=foo>
<br><insert name=foo foo=cat>
<br><insert name=foo a=some foo=cats " is"=" are" his=here>