Creating an HTML Document

HTML documents are plain ASCII text with tags inserted to create the different effects. HTML documents can be created using any editor like Notepad or wordprocessor. If a wordprocessor is used, you must remember to save the text as an ASCII file or use an HTML Filter program like Internet Assistant. There are also several excellent HTML editors (HTML Assistant, HoTMetal, Easy HTML) that simplify the task of creating a homepage.

You can start with a page you created using HPC (HomePage Creator), an online home page builder, someone else's page, or from scratch. In all cases, each HTML page should have the following format:

<HTML>
<HEAD>
<TITLE>Your document heading goes here</TITLE>
</HEAD>
<BODY>
<H1> the page heading goes here </H1>
The body of your HTML page goes here
</BODY>
</HTML>

All of the tags in a HTML document are bracketed by left and right angle brackets, e.g. <HEAD>. Many of these tags appear as pairs which enclose the affected parts of the program. The closing tag is the same as the starting tag with a slash / appended to the word. Some of the tags may include additional information with the tag, .e.g <IMG SRC="mountain.gif" ALIGN=MIDDLE> which causes an image to be displayed and the text to be aligned in the middle of the image.

The title enclosed by <TITLE> and </TITLE> is displayed at the top bar of the browser. The body of the document should contain a page heading at the top and will contain all of the text and images that you want to display on the page as well as hyperlinks to other pages.

Table 1 displays many of the more common tags used in HTML pages.

Images are usually imbedded with the tag: <IMG SRC="path/file.ext"> where the path is the directory path to the file and the extension for the file is usually gif. Some browsers will recognize jpg files also, while other browsers like lynx will not display any images. The word IMAGE will be displayed whereever an image is to be displayed.

Hypertext links are enclosed within the <A> and </A> tags, e.g.

<A HREF="http://csc.ColumbusState.edu/summers/notes/note.ch1"> My Chapter 1 Notes </A>

The Universal Resource Locator (URL) follows HREF= and is part of the <A> tag. The text between the <A> and </A> will be displayed by the web browser in a different color to emphasis that it is a hypertext link.

TAGDescription
<HTML>...</HTML>Blocks an entire HTML document
<HEAD>...</HEAD>Blocks the document's head
<BODY>...</BODY>Blocks the document's body
<BODY BACKGROUND="bk-pc.gif" TEXTCOLOR="#FFFFFF">...</BODY> adds a background image and makes the text color black
<TITLE>...</TITLE>Supplies title for body of document
<H1>...</H1>First-level heading
<H6>...</H6>Sixth-level heading
<BR>Forces a line break
<HR>Draws a horizontal line
<P> ... </P>Breaks up text into spaced regions (paragraphs) [</P> is optional]
<B>...</B>Produces bolded text
<I>...</I>Produces italicized text
<BLINK>...</BLINK>text inside tags will blink [use sparingly]
<A HREF="…">...</A> Provides a hyperlink address
<IMG SRC="…">Inserts an in-line image
<OL>...</OL>Creates a numbered (ordered) list
<UL>...</UL>Creates a bulleted (unordered) list
<LI>…</LI>marks a member of a list [</LI> is optional]
<CENTER>…</CENTER>Centers the text vertically on a line
<BLOCKQUOTE>…</BLOCKQUOTE> can be used for indentation
<BASEFONT=n>specifies a basefont size of n
<FONT SIZE=n COLOR="RRGGBB" FACE="Arial">…</FONT> specifies font size, color and typeface
(size can be relative)
<TABLE>…</TABLE>container tag pair for an HTML table
<TH>…</TH>table header
<TR>…</TR>table row designator
<TD>…</TD>table data cell
<PRE>...</PRE>Preformatted style (best way to include tabs)
<!-----......---->Comment for the user/reader
Table 1 - HTML tags

Designing a Good HTML Document

  1. Before you use any HTML editor to create your document, do a preliminary design:
  2. Pick a good title for your homepage.
  3. Be careful about your spelling and grammar. Remember that your homepage is the first impression many will have of you.
  4. Sign your work. Include your name, e-mail address and any other pertinent information.
  5. Date your pages so that the reader will be able to identify whether it is out of date.
  6. Remember the audience for whom you are writing. When you make a reference, qualify it with a clue to allow some people to skip it. For example, "If you really want to know how it works inside, see the Internals guide", or "A step­by­step introduction is in the tutorial".
  7. Choose an appropriate size for your document. Long documents will take longer to transfer and are difficult for a reader to scroll through. If your home page includes menus giving access to other things, it should be small enough to fit on 24 lines (1 screen). Textual documents should be limited to about 5-10 screens.
  8. Be careful about introducing too much graphic material into the home page. Graphics look nice but... Larger graphics tend to slow down significantly the time for a page to load. If you have a lot of large graphics, it is advisable to link them to your home page and give a warning that the site they are about to link to will take some time to load. Use the postage sized .GIF files on the home page if you want to give a preview of the images.
  9. If you link to large graphics and/or sound files, give the viewer an indication of the size of the file.
  10. If you decide to use a different body background for your pages, make sure the background does not distract from the text and graphics found on the pages. The background could also hide the text and make it difficult to read. The background pattern should be low key and subtle, but at the same time attractive and pleasing to the eye.
  11. Color should also be a factor. Unless you are trying to grab people with bright colors, it is preferable to stick with pastel colors. If you do use dark colored backgrounds, be sure that the lettering is contrast to the background so it can be easily read.
  12. Limit the use of different font styles and sizes. It is easy to get carried away and use 6 or more font sizes on the page. There should be no more than three different font sizes on any one page.
  13. When you are setting up a page which refer to information which is available elsewhere, be very careful before taking a copy.
  14. Use navigational icons. It is very effective to have the same consistent icon throughout the work linked back to the top page. This gives consistency to the work, so readers know when they are in it and when they are outside it, and it also gives them a quick way of getting back to the top of it.
  15. Don't put extra spaces or blank lines into your text to pad it out, except in preformatted (PRE) sections.
  16. Don't refer in your text to features available with particular browsers. Asking someone to "click here" won't make sense without a mouse, just as asking someone to "select a link by number" will betray the fact that you were using the line mode browser. Just leave a link. The instructions get boring as the user will normally know how to select a link.
  17. Test your document. In a way your hypertext is like a book, which you should have proof­read. In a way, it is like a program which you should have tested. At least get someone from the target group for which you wrote the document to read it and give you some feedback.
  18. Make it clear whether your will accept criticism or suggestions from your readers, and how they should send it.

Click here to return to Wayne's World's homepage: return to Wayne's World


written by Wayne Summers summers_wayne@ColumbusState.edu