Producing HTML Documents with Scribe

8. Character Conversions and Raw HTML

The characters &, <, >, and " are all special to HTML, and are represented by the words &amp;, &lt;, &gt;, and &quot;. When any of these special characters are encountered in a Scribe document, they are converted to the corresponding words.

This makes it difficult to produce raw HTML, for example, when setting headers and footers. So, we provide Scribe commands that produce the commonly-used HTML constructs:

HTML construct  Scribe command        Example           HTML result
<tag>           @htag(tag)            @tag(ISINDEX)     <ISINDEX>
"string"        @quot(string)         @quot(filename)   "filename"
&entity;        @entity(entity)       @entity(quot)     &quot;
<BR>            @br                   @br               <BR>
<HR>            @bar()                @bar()

To construct an HTML anchor, you could use:

@htag(A
HREF=@quot(http://www.digital.com/archive/pub/DEC/DECinfo/html/home.html))
Digital's home page@htag(/A)
 

Digital's home page

The preferred method is be to use the @URLref command described in Section 6.