<insert> |

`<insert>` is defined in the Main RXML parser module. 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, cookies, encode, define, file, fromword``, nocache, variable,

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 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

source code

    This is a foo

    "=> >

result | This is a foo