Reference. Reference for the DocBook DTD

[Prev] [Next]


KeywordSet

Name

KeywordSet--- Set of terms describing the content of a document

Synopsis

Content Model
  Keyword+

Attributes

This element has common and Role attributes.

Tag Minimization

Both the start- and end-tags are required for this element.

Description

KeywordSet is a set of Keywords, which are terms that describe the content of a document. KeywordSet may appear only in metadata containers, such as BookInfo and Sect1Info; the Keywords apply to the corresponding document (Book and Sect1, in this example).

Unlike SubjectTerms, which should be drawn from a controlled vocabulary, Keywords may be freely chosen by author, editor, publisher, and so on; they should be useful for searching by users without use of a controlled vocabulary.

More than one KeywordSet can be supplied in a metadata container, although no element-specific facility is supplied for differentiating sibling KeywordSets. But KeywordSet has common attributes, and their values may serve as differentiators.

No default is specified for the relationship of KeywordSets in parts of a document to KeywordSets in larger and enclosing parts of a document.

Parents

These elements contain KeywordSet: BookInfo, DocInfo, RefSect1Info, RefSect2Info, RefSect3Info, RefSynopsisDivInfo, Sect1Info, Sect2Info, Sect3Info, Sect4Info, Sect5Info, and SetInfo.

Children

KeywordSet contains Keyword.

In some contexts, some of these elements may be invalid due to exclusions in parent elements.

Examples

<DOCINFO>
<TITLE>Prolegomenon to Any Future GML</TITLE>
<SUBTITLE>An Inquiry into Tag Abuse
</SUBTITLE>
<SUBJECTSET SCHEME=LCSH>
<SUBJECT WEIGHT=5>
<SUBJECTTERM>Electronic publishing
</SUBJECTTERM>
<SUBJECTTERM>Computer program languages
</SUBJECTTERM>
</SUBJECT>
<SUBJECT WEIGHT=8>
<SUBJECTTERM>SGML
</SUBJECTTERM>
</SUBJECT>
</SUBJECTSET>
<SUBJECTSET SCHEME=LOCAL>
<SUBJECT WEIGHT=4>
<SUBJECTTERM>GML
</SUBJECTTERM>
</SUBJECT>
<SUBJECT WEIGHT=9>
<SUBJECTTERM>Tag Abuse
</SUBJECTTERM>
</SUBJECT>
<SUBJECT WEIGHT=3>
<SUBJECTTERM>Standards Revision
</SUBJECTTERM>
<SUBJECTTERM>Biting Critique
</SUBJECTTERM>
</SUBJECT>
</SUBJECTSET>

<KEYWORDSET LANG=EN>
<KEYWORD>SGML
</KEYWORD>
<KEYWORD>revision
</KEYWORD>
</KEYWORDSET>
<KEYWORDSET LANG=Klingon>
<KEYWORD>$*#@!
</KEYWORD>
<KEYWORD>MMMMMM!
</KEYWORD>
</KEYWORDSET>
<AUTHORGROUP>
<AUTHOR>
<HONORIFIC>Dr.
</HONORIFIC>
<FIRSTNAME>John
</FIRSTNAME>
<OTHERNAME>&ldquo;Jack&rdquo;
</OTHERNAME>
<SURNAME>Farquhar
</SURNAME>
<LINEAGE>Jr.
</LINEAGE>
<AUTHORBLURB>
<PARA>Jack is always the first to abuse a tag.</PARA>
</AUTHORBLURB>
<AFFILIATION>
<SHORTAFFIL>Prof
</SHORTAFFIL>
<JOBTITLE>Abject Professor of Markup
</JOBTITLE>
<ORGNAME>Technical University of Michigan
</ORGNAME>
<ORGDIV>School of Deadwood
</ORGDIV>
</AFFILIATION>
</AUTHOR>
</AUTHORGROUP>
<AUTHORGROUP>
<EDITOR>
<FIRSTNAME>Earl
</FIRSTNAME>
<OTHERNAME>Lee
</OTHERNAME>
<SURNAME>Reiser
</SURNAME>
</EDITOR>
</AUTHORGROUP>
<AUTHORGROUP>
<OTHERCREDIT>
<FIRSTNAME>A
</FIRSTNAME>
<SURNAME>Goodlistener
</SURNAME>
<CONTRIB>as told to
</CONTRIB>
</OTHERCREDIT>
</AUTHORGROUP>
<ABSTRACT>
<PARA>Rips the veil from the face of SGML's dirtiest secret:
the tags don't always mean what they're supposed to!
</PARA>
</ABSTRACT>
<REVHISTORY>
<REVISION>
<REVNUMBER>1.1
</REVNUMBER>
<DATE>3.4.1996
</DATE>
<AUTHORINITIALS>F.B.
</AUTHORINITIALS>
<REVREMARK>Cleaned up a few typos.
</REVREMARK>
</REVISION>
</REVHISTORY>
<LEGALNOTICE>
<PARA>All words are property of the English language.
</PARA>
</LEGALNOTICE>
</DOCINFO>


[Prev] KeySym
[Next] Keyword
[Reference Home] [Davenport Group Home]