DocBook: The Definitive GuideBy Norman Walsh & Leonard Muellner1st Edition October 1999 1-56592-580-7, Order Number: 5807 652 pages, $36.95 , Includes CD-ROM |
Emphasis
Synopsis
Mixed Content Model
Emphasis ::= ((#PCDATA|FootnoteRef|XRef|Abbrev|Acronym|Citation|CiteRefEntry| CiteTitle|Emphasis|FirstTerm|ForeignPhrase|GlossTerm|Footnote| Phrase|Quote|Trademark|WordAsWord|Link|OLink|ULink|Action| Application|ClassName|Command|ComputerOutput|Database|Email| EnVar|ErrorCode|ErrorName|ErrorType|Filename|Function|GUIButton| GUIIcon|GUILabel|GUIMenu|GUIMenuItem|GUISubmenu|Hardware| Interface|InterfaceDefinition|KeyCap|KeyCode|KeyCombo|KeySym| Literal|Constant|Markup|MediaLabel|MenuChoice|MouseButton| MsgText|Option|Optional|Parameter|Prompt|Property|Replaceable| ReturnValue|SGMLTag|StructField|StructName|Symbol|SystemItem| Token|Type|UserInput|VarName|Anchor|Author|AuthorInitials| CorpAuthor|ModeSpec|OtherCredit|ProductName|ProductNumber| RevHistory|Comment|Subscript|Superscript|InlineGraphic| InlineMediaObject|InlineEquation|Synopsis|CmdSynopsis| FuncSynopsis|IndexTerm)+)Attributes
Tag Minimization
Both the start- and end-tags are required for this element.
Parameter Entities
%docinfo.char.mix; %gen.char.class; %ndxterm.char.mix; %para.char.mix; %programlisting.content; %refinline.char.mix; %screen.content; %tbl.entry.mdl; %title.char.mix; %word.char.mix; Description
Emphasis provides a method for indicating that certain text should be stressed in some way.
Processing expectations
Formatted inline. Emphasized text is traditionally presented in italics or boldface. A Role attribute of bold or strong is often used to generate boldface, if italics is the default presentation.
Emphasis is often used wherever its typographic presentation is desired, even when other markup might theoretically be more appropriate.
Future Changes
The InterfaceDefinition element will be discarded in DocBook V4.0. It will no longer be available in the content model of this element.
Parents
These elements contain Emphasis: Abbrev, Ackno, Acronym, Application, ArtPageNums, Attribution, AuthorInitials, BiblioMisc, BridgeHead, Citation, CiteTitle, City, CollabName, Comment, ConfDates, ConfNum, ConfSponsor, ConfTitle, ContractNum, ContractSponsor, Contrib, CorpAuthor, CorpName, Country, Date, Edition, Email, Emphasis, entry, Fax, FirstName, FirstTerm, ForeignPhrase, GlossSee, GlossSeeAlso, GlossTerm, Holder, Honorific, InvPartNumber, ISBN, ISSN, IssueNum, JobTitle, Label, Lineage, LineAnnotation, Link, LiteralLayout, LoTentry, ManVolNum, Member, ModeSpec, MsgAud, OLink, OrgDiv, OrgName, OtherAddr, OtherName, PageNums, Para, Phone, Phrase, POB, Postcode, Primary, PrimaryIE, ProductName, ProductNumber, ProgramListing, PubDate, PublisherName, PubsNumber, Quote, RefEntryTitle, RefMiscInfo, RefPurpose, ReleaseInfo, RevNumber, RevRemark, Screen, ScreenInfo, Secondary, SecondaryIE, See, SeeAlso, SeeAlsoIE, SeeIE, Seg, SegTitle, SeriesVolNums, ShortAffil, SimPara, State, Street, Subscript, Subtitle, Superscript, Surname, Synopsis, Term, Tertiary, TertiaryIE, Title, TitleAbbrev, ToCback, ToCentry, ToCfront, Trademark, ULink, VolumeNum, WordAsWord, Year.
Children
The following elements occur in Emphasis: Abbrev, Acronym, Action, Anchor, Application, Author, AuthorInitials, Citation, CiteRefEntry, CiteTitle, ClassName, CmdSynopsis, Command, Comment, ComputerOutput, Constant, CorpAuthor, Database, Email, Emphasis, EnVar, ErrorCode, ErrorName, ErrorType, Filename, FirstTerm, Footnote, FootnoteRef, ForeignPhrase, FuncSynopsis, Function, GlossTerm, GUIButton, GUIIcon, GUILabel, GUIMenu, GUIMenuItem, GUISubmenu, Hardware, IndexTerm, InlineEquation, InlineGraphic, InlineMediaObject, Interface, InterfaceDefinition, KeyCap, KeyCode, KeyCombo, KeySym, Link, Literal, Markup, MediaLabel, MenuChoice, ModeSpec, MouseButton, MsgText, OLink, Option, Optional, OtherCredit, Parameter, Phrase, ProductName, ProductNumber, Prompt, Property, Quote, Replaceable, ReturnValue, RevHistory, SGMLTag, StructField, StructName, Subscript, Superscript, Symbol, Synopsis, SystemItem, Token, Trademark, Type, ULink, UserInput, VarName, WordAsWord, XRef.
In some contexts, the following elements are allowed anywhere: BeginPage, IndexTerm.
In some contexts, the following elements are excluded: Acronym, Footnote, IndexTerm.
Examples
<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook V3.1//EN"> <para> The <emphasis>most</emphasis> important example of this phenomenon occurs in A. Nonymous's book <citetitle>Power Snacking</citetitle>. </para>The most important example of this phenomenon occurs in A. Nonymous's book Power Snacking.
For additional examples, see also Index, ProgramListingCO, Type.
Back to: DocBook: The Definitive Guide
© 2001, O'Reilly & Associates, Inc.