DocBook: The Definitive Guide

docbook: the definitive guide
By Norman Walsh & Leonard Muellner
1st Edition October 1999
1-56592-580-7, Order Number: 5807
652 pages, $36.95 , Includes CD-ROM

DocBook: The Definitive Guide
PrevNext

Name

Subject -- One of a group of terms describing the subject matter of a document

Synopsis

Content Model

Subject ::= (SubjectTerm+)

Attributes

Common attributes

Name

Type

Default

WeightNUMBERNone

Tag Minimization

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

Description

A "subject" categorizes or describes the topic of a document, or section of a document. In DocBook, a Subject is defined by the SubjectTerms that it contains.

Subject terms should be drawn from a controlled vocabulary, such as the Library of Congress Subject Headings. If an outside vocabulary is not appropriate, a local or institutional subject set should be created.

The advantage of a controlled vocabulary is that it places the document into a known subject space. Searching the subject space with a particular subject term will find all of the documents that claim to have that subject. There's no need to worry about terms that are synonymous with the search item, or homophones of the search term.

All of the SubjectTerms in a Subject should describe the same subject, and be from the same controlled vocabulary.

Processing expectations

May be formatted inline or as a displayed block, depending on context. Subjects are rarely displayed to a reader. Usually, they are reserved for searching and retrieval purposes.

Unlike Keywords, which may be chosen freely, subject terms should come from a controlled vocabulary.

In order to assure that typographic or other errors are not introduced into the subject terms, they should be compared against the controlled vocabulary by an external process.

Parents

These elements contain Subject: SubjectSet.

Children

The following elements occur in Subject: SubjectTerm.

In some contexts, the following elements are allowed anywhere: BeginPage, IndexTerm.

Attributes

Weight

Weight specifies a ranking for this Subject relative to other subjects in the same set.

See Also

Keyword, KeywordSet, SubjectSet, SubjectTerm

Examples

For examples, see SubjectSet.


PrevHomeNext
StructNameUpSubjectSet

Back to: DocBook: The Definitive Guide


O'Reilly Home | O'Reilly Bookstores | How to Order | O'Reilly Contacts
International | About O'Reilly | Affiliated Companies

© 1999, O'Reilly & Associates, Inc.



DocBook. The Definitive Guide
DocBook 5: The Definitive Guide
ISBN: 0596805020
EAN: 2147483647
Year: 1999
Pages: 412
Authors: Walsh Norman, Richard L. Hamilton
BUY ON AMAZON

Similar book on Amazon
DocBook XSL: The Complete Guide (4th Edition)
DocBook XSL: The Complete Guide (4th Edition)
XSLT, 2nd Edition
XSLT, 2nd Edition
XSLT Cookbook: Solutions and Examples for XML and XSLT Developers, 2nd Edition
XSLT Cookbook: Solutions and Examples for XML and XSLT Developers, 2nd Edition
XML: Visual QuickStart Guide (2nd Edition)
XML: Visual QuickStart Guide (2nd Edition)

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net