signatures:HTML comment

A block HTML comment is created with /// on lines preceding and following the text block.

Also note: any unsigned block of text which begins with <!-- and ends with --> is considered a block HTML comment and passed through the translator unchanged.

Xilize markup browser rendering
xilize.

The xilize statement is used to generate a complete document (e.g. with @<html>@ and @<head>@ elements) when not using _natural_ mode which would so automatically. It is used in this example to create a complete listing of the generated HTML which will contain the HTML comment elements.

Of course you won't see comments in the browser rendering.

///
A block HTML comment.
No translation takes place in this block.
///

<!-- this is also a comment -->

The xilize statement is used to generate a complete document (e.g. with <html> and <head> elements) when not using natural mode which would so automatically. It is used in this example to create a complete listing of the generated HTML which will contain the HTML comment elements.

Of course you won't see comments in the browser rendering.

XHTML generated

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
</head>
<body>

<p>The xilize statement is used to generate a complete document (e.g. with
 <code>&lt;html&gt;</code> and <code>&lt;head&gt;</code>
 elements) when not using <em>natural</em> mode which would so automatically.
  It is used in this example to create a complete listing of the generated <span
 class="caps">HTML</span> which will contain the <span class="caps">HTML</span>
 comment elements.</p>

<p>Of course you won't see comments in the browser rendering.</p>