Introduction
  Publishing web pages
  RXML
  Information tags
  String tags
  Variable tags
    <set>
    <unset>
    <cset>
    <append>
    <define>
    <undefine>
    <insert>
    <use>
    <formoutput>
  URL tags
  If tags
  Graphics tags
  Database tags
  LDAP
  Programming tags
  SSI tags
  Image maps
  IntraSeek
  LogView
  Templates
  Navigation
  SiteBuilder tags
  Supports system
  Security
  Appendix
 
<insert> Main RXML parser

 

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>

This is a foo
This is a cat
There are some cats