htp on-line reference : WHILE

syntax

<use macroname [parameters ...] [noexpand]>
<... $macroname ...>
<... ${macroname} ...>

r.domain.org/" path="/var/www/other.domain/">

  For this line: <img src="logo.gif">
  the local filename "logo.gif" will be used to determine image dimensions
  (no URL replacement).

  For this line: <img src="http://my.domain.org/logo.gif">
  the local filename "/var/www/my.domain/logo.gif" will be used.

  But for this line: <img src="http://other.domain.org/logo.gif">
  the local file cannot be found (no prefix match), so the image dimensions
  will not be added.

  Order is important; last IMAGEURL tag takes precedence:
  <imageurl url="/" path="/var/www/htdocs/">
  <imageurl url="/test/" path="/var/www/test/">

  <img src="/image.gif"> and <img src="/test/image.gif"> are mapped to
  /var/www/htdocs/image.gif and /var/www/test/image.gif, resp.
  If the order of the imageurl lines would be swapped, the second
  image would be mapped to /var/www/htdocs/test/image.gif.


synopsis

"Conditional" is either a "compare" or "is defined" operation. A compare operator is a test of the value of a macro against a literal string. If the NOT tag is present in the WHILE markup, the evaluation of the conditional is reversed:

Just as with IF you can also check for a macro's existance:

  <set sect-ctr="0">
  <blockdef name="section">
    <inc sect-ctr>
    <block name="sect-${sect-ctr}" expand global>
      <use block noexpand>
    </block>
  </blockdef>


If the condition is true, the block is evaluated and afterwards the WHILE tag is evaluated again. If the '$'-operator is used in the WHILE tag it is also reevaluated on each iteration.

A loop block must be closed with the /WHILE tag.