HTML The Definitive Guide (27 page)

Chapter 3

Anatomy of an HTML

Document

3.8 Editorial Markup

HTML 4.0 introduces two new tags that can help groups of authors collaborate in the development of documents and maintain some semblance of editorial and version control. The new insert () and delete () tags let you designate portions of your document's body as either new/added content, or old stuff that should be replaced, respectively. And with special attributes, you may indicated when you made the change (datetime) and a reference to a document that may explain the change (cite).

3.8.1 The and Tags
The new and tags let HTML 4.0 authors set off portions of body contents they intend to add to or delete from the current version of their HTML document. HTML 4.0-compliant browsers display the contents of the or tags in some special way so that readers can quickly scan the document for the changes.

and

Function:

Defines inserted and deleted document content Attributes:

CITE ONKEYPRESS

CLASS ONKEYUP

DATETIME ONMOUSEDOWN

DIR ONMOUSEMOVE

ID ONMOUSEOUT

LANG ONMOUSEOVER

ONCLICK ONMOUSEUP

ONDBLCLICK STYLE

ONKEYDOWN TITLE

End tag:

and ; never omitted Contains:

body_content

Used in:

body_content

We can't tell you how browsers will display these editorially marked sections, since the standard does not dictate how, nor are there any browsers yet available that implement the tags. Indeed, today's popular browsers ignore the and tags and blithely render the enclosed content as a regular part of the document.

3.8.1.1 The cite attribute

The cite attribute lets you document the reasons for the insertion or deletion. Its value must be a URL that points to some other document that explains the inserted text.

3.8.1.2 The datetime attribute

Although the reason for the change is important, knowing when a change was made is often more important. The datetime attribute for the and tags takes a single value: a specially encoded date and time stamp.

The rigorous format for the datetime value is YYYY-MM-DDThh:mm:ssTZD. The components are: ● YYYY is the year, such as 1998 or 2001.

MM

●

is the month; 01 for January through 12 for December.

DD

●

is the day; 01 through 31.

T

● is a required character designating the beginning of the time segment of the stamp.

hh

●

is the hour in 24-hour format; 00 (midnight) through 23 (11 P.M.). (Add a following colon if you include the minutes.)

mm

●

are the minutes on the hour; 00 through 59. (Add a following colon if you include the seconds.)

ss

●

are the seconds; 00 through 59.

TZD

●

is the time zone designator. It can be one of three values: Z, indicating Greenwich Mean Time,[
3
] or the hours, minutes, and seconds before (-) or after (+) Coordinated Universal Time (UTC) where time is relative to the time in Greenwich, England.

[3] Greenwich Mean Time is also known as `Zulu,' thus the value of `Z.'

For example:

1998-02-22T14:26Z

decodes to February 22, 1998 at 2:26 P.M. To specify Eastern Standard Time, the code for the same time and date is:

1998-02-22T19:26-05:00

Notice that the local time zone may change depending on where the document gets edited, whereas the universal time will stay the same.

3.8.1.3 The class, dir, event, id, lang, style, title, and events attributes
There are several nearly universal attributes for the many HTML tags. These attributes give you a common way to identify (title) and label (id) a tag's contents for later reference or automated treatment; to change the contents' display characteristics (class, style); and to reference the language used (lang) and related direction the text should flow (dir). There are also input events that may happen in and around the tagged contents that you may react to via an on-event attribute and
some programming. [The dir attribute, 3.5.1.1] [The lang attribute, 3.5.1.2]
[The id attribute, 4.1.1.4]

[The title attribute, 4.1.1.5]
[Inline Styles: The style Attribute, 9.1.1]
[Style Classes, 9.2.4]
[JavaScript

Event Handlers, 13.3.3]

3.8.2 Using Editorial Markup

The uses of and are obvious to anyone who has used a "boilerplate" document or form, or who has collaborated with others in the preparation of a document.

For example, law firms typically have a collection of online legal documents that are specially completed for each client. Law clerks usually do the "fill in," and the final document gets reviewed by a lawyer. To highlight where the clerk made changes in the document so that they are readily evident to the reviewer, use the tag to indicate the clerk's added text and the tag to mark the text that was replaced. Optionally use the cite and datetime attributes to indicate when and why the changes were made.

For example, the clerk might fill in a boilerplate document with the law firm's and representative's names, indicating the time and source for the change: The party of the first part, as represented by

cite="http://www.mull+dull.com/tom_duller.html"> Thomas Muller of Muller and Duller

[insert representation here] The editorial markup tags could also be used by HTML editing tools to denote how documents were modified as authors make changes over a period of time. With the correct use of the cite and datetime attributes, it would be possible to recreate a version of a document from a specific point in time.

3.7 The Document Body

3.9 The Tag