Using Help
Chapter 3, Writing HTML documents

Chapter 3

Chapter 3<P> Writing HTML documents Writing HTML documents

SCOhelp displays documents coded in HTML (Hyper Text Markup Language). HTML is defined as an application of ISO Standard 8879:1986: Standard Generalized Markup Language (SGML).

HTML documents can be written using plain ASCII text and can be created using any ASCII text editor (such as emacs or vi ). In addition, SCOhelp provides full support for the ISO 8859-1 Latin Alphabet No. 1 character set. However, not all text editors and word processors produce character codes for Latin Alphabet No. 1.

In addition to the characters that you can type in to a file directly with a text editor or word-processor, you may also include the standard set of HTML special characters as well as a SCOhelp extended special character set.

You can preview any document you write using HTML by selecting Open File from the File menu.

Here is a simple HTML document: 

   <HTML>
   <HEAD>
   <TITLE>A simple HTML example</TITLE>
   

<BODY> <H1>This is a level one heading</H1> <P> Welcome to the world of HTML. This is one paragraph. <P> And this is a second paragraph.

In HTML, tags are used to markup the text, and the browser decides how to format the text based on the HTML tags. Tag names in HTML are not case sensitive, so any combination of upper and lowercase text will usually work (exceptions to this rule are noted below).

HTML start tags typically begin with a left angle bracket (<), followed by the tag name, and ended with a right angle bracket (>). The end tag is the same as the start tag except a slash (/) follows the left angle bracket.

Most HTML tags are paired. The above example uses <TITLE> to begin a document title and a corresponding end title tag (</TITLE>) to specify end of the title of the document. Similarly, the <H1> and </H1> start and end a level 1 heading.

Some HTML tags do not require an end tag. This is a feature of the HTML language which allows writers to reduce the amount of typing that is required to produce valid HTML documents. For example, the <P> tag begins a paragraph but does not require an end tag. While it is not necessary to use end tags on paragraphs, it is permissible and encouraged in the HTML specification. Other tags which do not require a paired end tag are: <HEAD>, <BODY>, <LI>, <DT>, and <DD>. 

HTML titles

Every HTML document should have a title. A title is typically displayed near the top of the window, separately from the document, and is used primarily for document identification (for example, when displaying the results of a full text search). Title tags use the following syntax:

   <TITLE>Text of title</TITLE>


Headings

HTML provides six levels of headings (numbered 1 through 6), with 1 being the most prominent. Headings are typically displayed in larger and/or bolder fonts than the normal body text. Although you can use them in any order you wish, the first level heading in each document should be tagged <H1>, with the second level tagged <H2>, and so on. Headings use the following syntax:

   <Hx><text of heading</Hx>
In this example, x signifies a heading level between 1 and 6.

In simple documents, the first heading is usually the same as the title. 

Paragraphs

You must begin each paragraph with <P>. Without the <P> tags, the document might become one large paragraph. That is because HTML was designed to be used on a wide variety of computer screens, using browsers with scalable windows. As a result, traditional line endings used in word processors are not meaningful in HTML. Lines are adjusted to fit the window, words may be wrapped to the next line at any point, and consecutive spaces or tabs are collapsed into a single space. 

Hypertext links to other documents

HTML enables you to to create hypertext links from parts of one file (text and/or images) into another document (or image) using ``anchors''. When text is used for an anchor it is typically distinguished by a color change, an underline, or both when displayed on the screen.

The tag for an anchor is <A>, but its syntax is a bit different than other tags because it uses ``attributes'' to convey additional information. The full syntax for the <A> is quite detailed, but the basic syntax needed to create an anchor to another document is:

   <A HREF="URL"> "Another document" </A>
As usual, the start tag begins with <A, which is followed by a space and HREF="URL">. In this case, HREF is an attribute name and URL (Uniform Resource Locator) may be a pointer to a file on your local system, a topic in the online documentation installed on the help server in your organization, or even a file or node somewhere on the Internet. The anchor text which follows may be the title of another document or a keyword or phrase that requires further explanation; in any case, it will typically be highlighted in the browser. Finally, the usual end tag appears at the end of the anchor.

The following is an example of an anchor which is a hypertext link to a file named Glossary.html. In the example, the anchor uses the word ``Glossary'' as the anchor text linking the current document to the file named Glossary.html.

   <P>
   For definition of terms used here, please refer to the 
   <A HREF="Glossary.html">Glossary</A>.

Other kinds of links

A unique feature of SCOhelp is the navigation aids on the help toolbar. Among these are buttons to access the table of contents and index of the book that you are reading, and to move to the previous and next topics in that book. The mechanism used to do this is the <LINK> tag. The <LINK> tag works like the <A> tag, with a few differences:

For example, the <LINK> tags for this document are:

   <LINK HREF=/XHelp/CONTENTS.html REL=contents>
   <LINK HREF=/XHelp/INDEX.html REL=index>
   <LINK HREF=/XHelp/xhelpC.glossary.html REL=next>
   <LINK HREF=/XHelp/helpD.authtools.html REL=previous>


Using URLs (Uniform Resource Locators)

SCOhelp uses URLs (Uniform Resource Locators) to specify the location of other documents, or even a specific location within a document. The Uniform Resource Locator is an addressing method used by a variety of software packages that work over networks.

The syntax for a URL depends on the type of network access that is being specified, the ``scheme''. A URL defines the type of access (in most cases http or file) and the path to the file. Use the http (HyperText Transfer Protocol) scheme for addressing files from an HTTP server. Use the file scheme for addressing files on your local machine's filesystems. The syntax for each of these two schemes is:

http://host.domain[:port]/path/filename
file:/path/filename

The //host.domain signifies the network address of the machine (host) within a specific network topology (domain). The port signifies the network port; by default, the help server uses port 457.

The syntax of typical URLs used in online documentation or context-sensitive help looks like these:

   http://localhost:457/dochome.html
   http:/XHelp/CONTENTS.html
   http:/NetAdminG/helpD.docserver.html
   http:INDEX.html
   

file:/etc/hosts

Which format, or how specific your URL is, depends on a number of factors. Factors you must consider when specifying a URL are:


NOTE: The default document root directory on help servers is /usr/lib/scohelp. For more information on server pathnames and the document root directory, see scohttp(ADM) and scohelp(XC).

If you want to insert a link from your document to this help file, assuming the default stand-alone help server configuration, you could use the following, fully-qualified URL:

   <A HREF="http://localhost:457/XHelp/helpD.html>
   Writing HTML documents</A>
The text Writing HTML documents would be highlighted in the text of your document and it would provide a hypertext link leading to the top of this document.

For example (assuming the default scohttp configuration), if you want to refer to a file named /usr/lib/scohelp/XHelp/helpD.html on your local machine and you are editing a file named /usr/lib/scohelp/Personnel/vacation.html, you could use either the partial HREF:

   HREF=../XHelp/helpD.html
or, the fully qualified HREF:
   http://localhost:457/XHelp/helpD.html


NOTE: When using either HTTP address, the help server searches for the specified file, XHelp/helpD.html, in its DocumentRoot directory. By default, DocumentRoot is /usr/lib/scohelp, but that can be configured to any directory you wish. See Chapter 22, ``Making documents available to the network'' in the Networking Guide and scohttp(ADM) for more information on server configuration.

URLs are also used on the World Wide Web to create hypertext links to other World Wide Web servers. If you need more information on URLs see RFC 1630. For more information on obtaining RFCs see, ``Obtaining RFCs from the Internet'' in the Networking Guide. If you are connected to the Internet, a URL for RFC 1630 is:

   http://www.w3.org/hypertext/WWW/Addressing/URL/uri-spec.html
If you need more information, see also A Beginner's Guide to URLs in the Web Resources section of the NCSA Mosaic for the X Window System User's Guide. The URL is:
   http://www.ncsa.uiuc.edu/demoweb/url-primer.html


Making lists

HTML supports unnumbered, numbered, and description lists. 

Unnumbered Lists are marked lists. Different HTML viewers display unnumbered lists differently. They might appear as bullets, filled circles, or dashes to indicate the items. SCOhelp displays an unnumbered list with a bullet.

To make an unnumbered list,

  1. Open the list with the unnumbered list (<UL>) tag.

  2. Enter the list item tag (<LI>) followed by the individual item. (No closing </LI> tag is needed.)

  3. Repeat step 2 until you have completed the list.

  4. End with a unnumbered list closing tag (</UL>).
For example, the following HTML code:
   <UL>
   <LI> apples
   <LI> bananas
   </UL>
produces a result like this:

As you can see from the example, it is not necessary to use a <P> tag immediately after a <LI> tag, but it is understood to be there. If you do add an extra <P>, you will likely see an extra paragraph space in SCOhelp. List items can contain more than one paragraph if you separate them with the paragraph tag (<P>).

Numbered or ordered lists use syntax similar to unnumbered lists. The beginning and ending tags change. To create an ordered list:

  1. Open the list with the ordered list (<OL>) tag.

  2. Enter the list item tag (<LI>) followed by the individual item. No closing </LI> tag is needed.

  3. Repeat step 2 until you have completed the list

  4. End with a closing ordered list </OL> tag.
The following HTML code:
   <OL>
   <LI> apples
   <LI> bananas
   </OL>
produces a result like this:

  1. apples

  2. bananas

As you can see from the example, it is not necessary to use a <P> tag immediately after a <LI> tag, but it is understood to be there. If you do add an extra <P>, you will likely see an extra paragraph space in SCOhelp. List items can contain more than one paragraph if you separate them with the paragraph tag (<P>).

Definition lists are used to mark up glossary-style or hanging-item lists. Unlike other lists, the body of definition lists consist of definition terms (<DT>) and definition descriptions (<DD>). These are usually used in pairs, but it is also permissible to use multiple definition terms and/or multiple definition descriptions.

To make a definition list:

  1. Open the list with the definition list (<DL>) tag.

  2. Enter a definition term tag (<DT>) followed by the text of the definition term. Repeat as needed. (No closing </DT> tag is needed.)

  3. Enter a definition description tag (<DD>) followed by the text of the definition description. Repeat as needed. (No closing </DD> tag is needed.)

  4. Continue with steps 2 and 3 until you have completed the list.

  5. End with a closing definition list </DL> tag.
For example the following code:
   <DL>
   <DT> Cable type
   <DD> Select the connector type on your 
   EISA configuration screen.
   Acceptable types are shielded IBM Token-Ring Network PC
   Adapter Cable (or equivalent) or unshielded
   (twisted pair).
   <DT> Interrupt type/number
   <DD> The default interrupt type and number is edge-triggered 15. 
   <DT> Speed 
   <DD>You must set the speed of the Compaq card to match
   the speed of the network (either 4 or 16 Mbps).
   </DL>
produces output resembling the following:

Cable type

Select the connector type on your
EISA configuration screen.
Acceptable types are shielded (IBM Token-Ring Network PC
Adapter Cable or equivalent) or unshielded
(twisted pair).

Interrupt type/number

The default interrupt type and number is edge-triggered 15.

Speed

You must set the speed of the Compaq card to match
the speed of the network (either 4 or 16 Mbps).

As you can see from the example, it is not necessary to use a <P> tag immediately after a <DD> tag, but it is understood to be there. If you do add an extra <P>, you will likely see an extra paragraph space in SCOhelp. Definition descriptions, like list items, can contain more than one paragraph if you separate them with the paragraph tag (<P>). 

Nesting lists

All of the list types can be nested. However, if you are nesting unnumbered lists you may find that SCOhelp will not vary the indents used for the list items. 

Using preformatted text

Preformatted text is text that you want to retain the look and format of what you enter in the HTML code. Use the <PRE> (preformatted) tag to include fixed width font text (for example Courier) and to cause spaces, new lines, and tabs to be significant. This is especially useful for programming code. For example, the following code:

   <PRE>
   #!/bin/sh
   #
   #       xd.1
   #
   #       extract modes and driver information from grafinfo files
   #
   for Fname in $*
   do
   sed -e "s/
   BEGIN {
           vendor = 1
           P0 = ""
           P1 = ""
           P2 = ""
           P3 = ""
           P4 = ""
           M0 = ""
           M1 = ""
           M3 = ""
           M4 = ""
   }
   </PRE>
would look like this when displayed:
   #!/bin/sh
   #
   #       xd.1
   #
   #       extract modes and driver information from grafinfo files
   #
   for Fname in $*
   do
   sed -e "s/
   BEGIN {
           vendor = 1
           P0 = ""
           P1 = ""
           P2 = ""
           P3 = ""
           P4 = ""
           M0 = ""
           M1 = ""
           M3 = ""
           M4 = ""
   }
While you can insert anchors (<A>) in <PRE> sections, you should not use other HTML tags. 

Character formatting

Individual words or sentences can be put in various formats. HTML divides these into two general types:

Semantic tags identify the information type of words or phrases. Character formatting tags specify the specific appearance of marked text. For example, you could tag all filenames with a semantic ``citation'' style. You could then set all semantically tagged book citations to print in an italic font.

While you could get the same italic font by specifying it directly, semantic tags have other advantages. The format of semantic or logical tags can be altered by each user if they desire by specifying different fonts in a resource file. Character tags are linked to a given look (for example, <B> for bold text). So, text within character tags has to be recoded if you want to change their appearance. The advantage of this approach (similar in concept to a word processor style sheet) is that it gives your reader greater control over how some textual elements will appear on the screen.

Use semantic and character format tags in pairs, placing content between the start tag and end tag. The following example includes a variety of semantic and character format tags within a paragraph:

   <P>
   The two types of text-level tags 
   are <EM>semantic</EM> and 
   <EM>character format</EM> tags.
   Use semantic tags to identify information types 
   such as citations to a book, 
   as in <CITE>The Chicago Manual of Style</CITE>.
   Use character format tags to specify a font,
   such as <I>italic</I> or <B>bold</B>
   or <TT>monospaced</TT> fonts.

The following are lists of the available semantic and character format tags:



Inline images

SCOhelp can display X Bitmap (XBM) or GIF format images within documents. Each image takes time to process and slows down the initial display of the document. Using a particular image multiple times in a document causes very little performance degradation compared to using the image only once.

To include an inline image in your document, use the syntax:

<IMG SRC=image_URL>

In this example, image_URL is the URL of the image file. The URL syntax for <IMG> tags is identical to that used in anchors. If the image file is a GIF file, then the filename part of image_URL must end with .gif. Similarly, filenames of X Bitmap images must end with .xbm. For example, if you want to include the image newex.gif, enter the following:

   <IMG SRC=newex.gif>
This produces the following when formatted:

Other tags

There is a lot more to HTML than what is discussed here. Some other tags deserve special attention.

<ADDRESS>
Use the <ADDRESS> tag to specify an address, whether it is a full postal address or an e-mail address. The contents are typically rendered in an italic font. Like a <P> tag, it causes a line break and space before and after. Unlike a <P> tag, you must end it with an </ADDRESS> end tag.

<BR>
The <BR> tag simply forces a line break. Unlike the <P> tag, it does not cause a space. It is often used within an <ADDRESS>, as you can see in the example below. No end tag is required.

<HR>
The <HR> tag produces a horizontal line the width of the help window, as you can see in the example below. No end tag is required.

Thus, one use for the hard line break is something like an address. For example, the following code:

   <HR>
   <ADDRESS>
   The Santa Cruz Operation, Inc<BR>
   400 Encinal Street<BR>
   P.O. Box 1900 <BR>
   Santa Cruz, CA 95061<BR>
   </ADDRESS>
   <HR>
produces a result resembling the following:

The Santa Cruz Operation, Inc
400 Encinal Street
P.O. Box 1900
Santa Cruz, CA 95061



Special characters

<, >, ", and & have special meaning in HTML. If you need to use them in a document, you must use special entity references. They are:

<
Use &lt; for left brackets

>
Use &gt; for right brackets

&
Use &amp; for ampersand

"
Use &dq; for quotes in a tag attribute
Many international characters are available using this technique. For a complete list of available characters, see ``List of SCO extended HTML special characters'' ``List of HTML numerical character references'' For more information, see the Web Resources section of the NCSA Mosaic for the X Window System User's Guide.


NOTE: Entity references (unlike HTML tags) are case-sensitive. For example, you cannot use &LT instead of &lt.



SCOHelp extensions to the HTML special character set

For mathematical and technical documentation, SCO has added an extended symbol font to HTML. To use a special character, find it in the ``Symbol'' column in the following table, and use the HTML code listed on the same line. The ISO name is the character name designated for the character in the appendix of the SGML standard (ISO 8879:1986). 

List of SCO extended HTML special characters

The characters listed in the following table are available for use in addition to those listed in ``List of HTML numerical character references''. 

 ------------------------------------------------------------------------
          HTML                        ISO
 Symbol   code                        Name     Description
 ------------------------------------------------------------------------
         <scosym>&bull;</scosym>     bull     Bullet, round
         <scosym>&loz;</scosym>      loz      Diamond
 (TM)        <scosym>&trade;</scosym>    trade    Trademark sign
 ------------------------------------------------------------------------
 &Agr;        <scosym>&Agr;</scosym>      Agr      Capital Greek Alpha
 &Bgr;        <scosym>&Bgr;</scosym>      Bgr      Capital Greek Beta
 Γ        <scosym>&Gamma;</scosym>    Ggr      Capital Greek Gamma
 Δ        <scosym>&Delta;</scosym>    Dgr      Capital Greek Delta
 &Egr;        <scosym>&Egr;</scosym>      Egr      Capital Greek Epsilon
 &Zgr;        <scosym>&Zgr;</scosym>      Zgr      Capital Greek Zeta
 &EEgr;        <scosym>&EEgr;</scosym>     EEgr     Capital Greek Eta
 Θ        <scosym>&Theta;</scosym>    THgr     Capital Greek Theta
 &Igr;        <scosym>&Igr;</scosym>      Igr      Capital Greek Iota
 &Kgr;        <scosym>&Kgr;</scosym>      Kgr      Capital Greek Kappa
 Λ        <scosym>&Lambda;</scosym>   Lgr      Capital Greek Lambda
 &Mgr;        <scosym>&Mgr;</scosym>      Mgr      Capital Greek Mu
 &Ngr;        <scosym>&Ngr;</scosym>      Ngr      Capital Greek Nu
 Ξ        <scosym>&Xi;</scosym>       Xgr      Capital Greek Xi
 &Ogr;        <scosym>&Ogr;</scosym>      Ogr      Capital Greek Omicron
 Π        <scosym>&Pi;</scosym>       Pgr      Capital Greek Pi
 &Rgr;        <scosym>&Rgr;</scosym>      Rgr      Capital Greek Rho
 Σ        <scosym>&Sigma;</scosym>    Sgr      Capital Greek Sigma
 &Tgr;        <scosym>&Tgr;</scosym>      Tgr      Capital Greek Tau
 ϒ        <scosym>&Upsi;</scosym>     Ugr      Capital Greek Upsilon
 &PHgr;        <scosym>&PHgr;</scosym>     PHgr     Capital Greek Phi
 &KHgr;        <scosym>&KHgr;</scosym>     KHgr     Capital Greek Chi
 Ψ        <scosym>&Psi;</scosym>      PSgr     Capital Greek Psi
 Ω        <scosym>&Omega;</scosym>    OHgr     Capital Greek Omega
 α        <scosym>&alpha;</scosym>]   agr      Small Greek alpha
 β        <scosym>&beta;</scosym>     bgr      Small Greek beta
 γ        <scosym>&gamma;</scosym>    ggr      Small Greek gamma
 δ        <scosym>&delta;</scosym>    dgr      Small Greek delta
 ε        <scosym>&epsi;</scosym>     egr      Small Greek epsilon
 ζ        <scosym>&zeta;</scosym>     zgr      Small Greek zeta
 η        <scosym>&eta;</scosym>      eegr     Small Greek eta
 &thetas;        <scosym>&thetas;</scosym>   thgr     Small Greek theta
 ι        <scosym>&iota;</scosym>     igr      Small Greek iota
 κ        <scosym>&kappa;</scosym>    kgr      Small Greek kappa
 λ        <scosym>&lambda;</scosym>   lgr      Small Greek lambda
 μ        <scosym>&mu;</scosym>       mgr      Small Greek mu
 ν        <scosym>&nu;</scosym>       ngr      Small Greek nu
 ξ        <scosym>&xi;</scosym>       xgr      Small Greek xi
 &ogr;        <scosym>&ogr;</scosym>      ogr      Small Greek omicron
 π        <scosym>&pi;</scosym>       pgr      Small Greek pi
 ρ        <scosym>&rho;</scosym>      rgr      Small Greek rho
 σ        <scosym>&sigma;</scosym>    sgr      Small Greek sigma
 &sfgr;        <scosym>&sfgr;</scosym>     sfgr     Small Greek terminal sigma
 τ        <scosym>&tau;</scosym>      tgr      Small Greek tau
 υ        <scosym>&upsi;</scosym>     ugr      Small Greek upsilon
 &phis;        <scosym>&phis;</scosym>     phgr     Small Greek phi
 χ        <scosym>&chi;</scosym>      khgr     Small Greek chi
 ψ        <scosym>&psi;</scosym>      psgr     Small Greek psi
 ω        <scosym>&omega;</scosym>    ohgr     Small Greek omega
 ------------------------------------------------------------------------
         <scosym>&clubs;</scosym>    clubs    Clubs
         <scosym>&diams;</scosym>    diams    Diamonds
         <scosym>&hearts;</scosym>   hearts   Hearts
         <scosym>&spades;</scosym>   spades   Spades
 ------------------------------------------------------------------------
 <-       <scosym>&larr;</scosym>     larr     Left arrow
 <:       <scosym>&lArr;</scosym>              Left double arrow
 >        <scosym>&rarr;</scosym>     rarr     Right arrow
 >        <scosym>&rArr;</scosym>              Right double arrow
 <>       <scosym>&harr;</scosym>     harr     Both arrow
         <scosym>&hArr;</scosym>              Double both arrow
         <scosym>&darr;</scosym>     darr     Down arrow
         <scosym>&dArr;</scosym>     dArr     Down double arrow
         <scosym>&uArr;</scosym>     uArr     Up double arrow
         <scosym>&uarr;</scosym>     uarr     Up arrow
 ------------------------------------------------------------------------
         <scosym>&ang;</scosym>               Angle sign
         <scosym>&Prime;</scosym>    Prime    Double prime, seconds
         <scosym>&oplus;</scosym>             Circle plus
         <scosym>&otimes;</scosym>   otimes   Circle multiply
         <scosym>&nabla;</scosym>    nabla    Gradient
         <scosym>&infin;</scosym>    infin    Infinity
         <scosym>&int;</scosym>      int      Integral sign
 <        <scosym>&lang;</scosym>     lang     Left angle bracket
         <scosym>&lowast;</scosym>   lowast   Math asterisk
         <scosym>&minus;</scosym>    minus    Minus
         <scosym>&perp;</scosym>     perp     Perpendicular
 &vprime;        <scosym>&vprime;</scosym>   vprime   Prime, minutes, foot mark
         <scosym>&radic;</scosym>    radic    Radical, root
 >        <scosym>&rang;</scosym>     rang     Right angle bracket
 ------------------------------------------------------------------------
         <scosym>&and;</scosym>      and      Logical AND
         <scosym>&or;</scosym>       lo       Logical OR
 ------------------------------------------------------------------------
         <scosym>&lfloor;</scosym>   lfloor   Left bottom brace
         <scosym>&lceil;</scosym>    lceil    Left ceiling
         <scosym>&lfloor;</scosym>   lfloor   Left floor
         <scosym>&lceil;</scosym>    lceil    Left top brace
         <scosym>&rfloor;</scosym>   rfloor   Right bottom brace
         <scosym>&rceil;</scosym>    rceil    Right ceiling
         <scosym>&rfloor;</scosym>   rfloor   Right floor
         <scosym>&rceil;</scosym>    rceil    Right top brace
 ------------------------------------------------------------------------
         <scosym>&sim;</scosym>      sim      Approximates
         <scosym>&ap;</scosym>                Approximately equal
         <scosym>&cap;</scosym>      cap      Cap, intersection
         <scosym>&cup;</scosym>      cup      Cup, union
         <scosym>&empty;</scosym>    empty    Empty set
         <scosym>&exist;</scosym>    exist    Exists
         <scosym>&forall;</scosym>   forall   For all
 >=       <scosym>&ge;</scosym>       ge       Greater than or equal to
         <scosym>&equiv;</scosym>    equiv    Identical with
 <=       <scosym>&le;</scosym>       le       Less than or equal to
         <scosym>&ne;</scosym>       ne       Not equal
         <scosym>&notin;</scosym>    notin    Not member of
         <scosym>&nsub;</scosym>     nsub     Not subset of
         <scosym>&prop;</scosym>     prop     Proportional to
         <scosym>&hArr;</scosym>              Reversible reaction
         <scosym>&hArr;</scosym>              Reversible reaction
         <scosym>&isin;</scosym>     isin     Set membership
         <scosym>&sub;</scosym>      sub      Subset
         <scosym>&sup;</scosym>      sup      Superset
         <scosym>&sube;</scosym>     sube     Subset, equals
         <scosym>&supe;</scosym>     supe     Superset, equals
         <scosym>&ni;</scosym>       ni       Such that
         <scosym>&there4;</scosym>   there4   Therefore
 ------------------------------------------------------------------------
         <scosym>&aleph;</scosym>    aleph    Aleph
         <scosym>&image;</scosym>             Ifraktur
         <scosym>&real;</scosym>              Rfraktur


List of HTML numerical character references

In addition to the characters in ``List of SCO extended HTML special characters'', you may also use a technique known as ``numerical character references'' to include the characters listed in the following table. The ISO names are included for future reference only and may not currently be used as entity names in HTML.

 --------------------------------------------------------------
          HTML     ISO
 Symbol   code     Name     Description
 --------------------------------------------------------------
 ¡        &#161;   iexcl    Inverted exclamation
 ¢        &#162;   cent     Cent sign
 £        &#163;   pound    Pound sterling
 ¤        &#164;   curren   General currency sign
 ¥        &#165;   yen      Yen sign
 |        &#166;   vbar     Broken vertical bar
 §        &#167;   sect     Section sign
 ¨        &#168;   die      Umlaut (dieresis)
 ©        &#169;   copy     Copyright
 ª        &#170;   ordf     Feminine ordinal
 <<       &#171;   laquo    Left angle quote, guillemotleft
 ¬        &#172;   not      Not sign
 -        &#173;   shy      Soft hyphen
 ®        &#174;   reg      Registered trademark
          &#175;            Macron accent
 °        &#176;   degree   Degree sign
 ±        &#177;   plusmn   Plus or minus
 2        &#178;            Superscript two
 3        &#179;            Superscript three
 ´        &#180;   acute    Acute accent
          &#181;            Micro sign
 ¶        &#182;   para     Paragraph sign
 ·        &#183;   middot   Middle dot
 ¸        &#184;            Cedilla
 1        &#185;            Superscript one
 º        &#186;   ordm     Masculine ordinal
 >>       &#187;   raquo    Right angle quote, guillemotright
 ¼        &#188;   frac14   Fraction one-fourth
 ½        &#189;   frac12   Fraction one-half
 ¾        &#190;   frac34   Fraction three-fourths
 ¿        &#191;   iquest   Inverted question mark
 --------------------------------------------------------------
 Á        &#192;   Aacute   Capital A, acute accent
 À        &#193;   Agrave   Capital A, grave accent
 Â        &#194;   Acirc    Capital A, circumflex accent
 Ã        &#195;   Atilde   Capital A, tilde
 Å        &#196;   Aring    Capital A, ring
 Ä        &#197;   Auml     Capital A, dieresis or umlaut mark
 Æ        &#198;   AElig    Capital AE dipthong (ligature)
 Ç        &#199;   Ccedil   Capital C, cedilla
 É        &#200;   Eacute   Capital E, acute accent
 È        &#201;   Egrave   Capital E, grave accent
 Ê        &#202;   Ecirc    Capital E, circumflex accent
 Ë        &#203;   Euml     Capital E, dieresis or umlaut mark
 Í        &#204;   Iacute   Capital I, acute accent
 Ì        &#205;   Igrave   Capital I, grave accent
 Î        &#206;   Icirc    Capital I, circumflex accent
 Ï        &#207;   Iuml     Capital I, dieresis or umlaut mark
 Ð        &#208;   ETH      Capital Eth, Icelandic
 Ñ        &#209;   Ntilde   Capital N, tilde
 Ó        &#210;   Oacute   Capital O, acute accent
 Ò        &#211;   Ograve   Capital O, grave accent
 Ô        &#212;   Ocirc    Capital O, circumflex accent
 Õ        &#213;   Otilde   Capital O, tilde
 Ö        &#214;   Ouml     Capital O, dieresis or umlaut mark
 --------------------------------------------------------------
 ×        &#215;   times    Multiply sign
 --------------------------------------------------------------
 Ø        &#216;   Oslash   Capital O, slash
 Ú        &#217;   Uacute   Capital U, acute accent
 Ù        &#218;   Ugrave   Capital U, grave accent
 Û        &#219;   Ucirc    Capital U, circumflex accent
 Ü        &#220;   Uuml     Capital U, dieresis or umlaut mark
          &#221;   Yacute   Capital Y, acute accent
 --------------------------------------------------------------
 Þ        &#222;   THORN    Capital THORN, Icelandic
 ß        &#223;   szlig    Small sharp s, German (sz ligature)
 --------------------------------------------------------------
 á        &#224;   aacute   Small a, acute accent
 à        &#225;   agrave   Small a, grave accent
 â        &#226;   acirc    Small a, circumflex accent
 ã        &#227;   atilde   Small a, tilde
 ä        &#228;   auml     Small a, dieresis or umlaut mark
 å        &#229;   aring    Small a, ring
 æ        &#230;   aelig    Small ae dipthong (ligature)
 ç        &#231;   ccedil   Small c, cedilla
 é        &#232;   eacute   Small e, acute accent
 è        &#233;   egrave   Small e, grave accent
 ê        &#234;   ecirc    Small e, circumflex accent
 ë        &#235;   euml     Small e, dieresis or umlaut mark
 í        &#236;   iacute   Small i, acute accent
 ì        &#237;   igrave   Small i, grave accent
 î        &#238;   icirc    Small i, circumflex accent
 ï        &#239;   iuml     Small i, dieresis or umlaut mark
          &#240;   eth      Small eth, Icelandic
 ñ        &#241;   ntilde   Small n, tilde
 ó        &#242;   oacute   Small o, acute accent
 ò        &#243;   ograve   Small o, grave accent
 ô        &#244;   ocirc    Small o, circumflex accent
 õ        &#245;   otilde   Small o, tilde
 ö        &#246;   ouml     Small o, dieresis or umlaut mark
 --------------------------------------------------------------
 ÷        &#247;   divide   Division sign
 --------------------------------------------------------------
 ø        &#248;   oslash   Small o, slash
 ú        &#249;   uacute   Small u, acute accent
 ù        &#250;   ugrave   Small u, grave accent
 û        &#251;   ucirc    Small u, circumflex accent
 ü        &#252;   uuml     Small u, dieresis or umlaut mark
          &#255;   yacute   Small y, acute accent
 þ        &#254;   thorn    Small thorn, Icelandic
 ÿ        &#255;   yuml     Small y, dieresis or umlaut mark


Troubleshooting HTML code

While tag nesting is okay, try to avoid overlapping tags. Consider the following example:

   <B>This is an example of <SAMP>overlapping HTML</B> tags.</SAMP>
The sample text tag (<SAMP>) tag should print in a fixed-width, Courier font, and <B> signifies bold-face type. Because this creates overlapping formatting instructions, the results of this code are unpredictable. Most of the time the words `overlapping HTML'' display in a Courier font with the word ``tags'' placed in bold.

This is because the words ``overlapping HTML'' are contained within both the <B> and <SAMP> tags. If you want the words ``overlapping HTML tags'' to appear in Courier and the rest to be in bold, the sample should be coded:

   <B>This is an example of</B> <SAMP>overlapping HTML tags.</SAMP>
Similarly, if you wanted to print the whole sentence in bold except the word ``overlapping'', you can ``nest'' the format as follows:

Here while the sample tag is embedded or nested inside the bold
text, they do not overlap.

Nest (or embed) anchors and character formats, but avoid embedding anything else. It is acceptable to nest or embed anchors within other elements. For example,

   <H1><A HREF="Destination.html">My heading</A></H1>
Do not embed a heading or other element within an anchor. For example,
   <H1> <A HREF="Destination.html"> My heading </A> </H1>

While character style tags can be used to modify the appearance of other tags, avoid embedding other types of element tags. Although it is tempting to embed a heading within a list, in order to make the font size larger, the results can be unpredictable.

Sample HTML document

Here is an example of an HTML document: 

Example 3-1 A long HTML sample document

<TITLE>A Longer Example</TITLE>
<H1>A Longer Example</H1>
<P>
This is a simple document. This is the first
paragraph.
<P>
This is the second paragraph, which shows special effects.  This is a 
word in <I>italics</I>.  This is a word in <B>bold</B>.
Here is an inlined GIF image: <IMG SRC="newex.gif">. 
<P>
This is the third paragraph, which demonstrates links.
Here is a hypertext link from 
the word <A HREF=/XHelp/CONTENTS.html>Contents</A>
to the table of contents of the online help book.
<P> 
<H2>A second-level header</H2>
Here is a section of text that should display as a 
fixed-width font: 
<P>
<PRE>
    Should the wide world roll away,
    Leaving black terror,
    Limitless night,
    Nor God, nor man, nor place to stand
    Would be to me essential,
    If thou and thy white arms were there,
    And the fall to doom a long way.
    
    Stephen Crane 1871-1900
</PRE>
This is a unnumbered list with two items: <P>
<UL>
<LI> cranberries
<LI> blueberries
</UL>
This is the end of my example document. <P>
When formatted, the above document looks like this::

A Longer Example

This is a simple document. This is the first paragraph.

This is the second paragraph, which shows special effects. This is a word in italics. This is a word in bold. Here is an inlined GIF image:

This is the third paragraph, which demonstrates links. Here is a hypertext link from the word Contents to the table of contents of the online help book.

A lower level header

Here is a section of text that should display as a fixed-width font

       Should the wide world roll away,
       Leaving black terror,
       Limitless night,
       Nor God, nor man, nor place to stand
       Would be to me essential,
       If thou and thy white arms were there,
       And the fall to doom a long way.
   

Stephen Crane 1871-1900

This is a unnumbered list with two items: This is the end of my example document.

See also: