olink
olink — A link that addresses its target indirectly.
Synopsis
olink ::= ![[-]](figs/web/nav/down.gif)
![[+]](figs/web/nav/right.gif)
- Zero or more of:
- text
- Bibliography inlines
- Graphic inlines
- Indexing inlines
- Linking inlines
- Markup inlines
- Math inlines
- Product inlines
- Publishing inlines
abbrevacronymcorefdateemphasis(db.emphasis)firstterm(db._firstterm)firstterm(db.firstterm)footnotefootnoterefforeignphrase(db.foreignphrase)glossterm(db._glossterm)glossterm(db.glossterm)phrase(db.phrase)quote(db.quote)subscriptsuperscriptwordasword
- Technical inlines
- Ubiquitous inlines
abbrevacronymaltanchorbibliorefcorefdateemphasis(db._emphasis)firstterm(db._firstterm)footnotefootnoterefforeignphrase(db._foreignphrase)glossterm(db._glossterm)indexterm(db.indexterm.endofrange)indexterm(db.indexterm.singular)indexterm(db.indexterm.startofrange)inlinemediaobjectlinkolinkphrase(db._phrase)quote(db._quote)remarksubscriptsuperscripttrademarkwordaswordxref
Attributes
Description
Unlike link, the semantics of
olink are application specific. The
olink element provides a mechanism for establishing
links across documents, where ID/IDREF linking is not possible and
URI-based linking may be inappropriate.
In general terms, the strategy employed by
olink is to point to the target document by URI, and
point into that document in some application-specific way.
Other elements can also behave like olink by
using the common linking attributes xlink:href and xlink:role. When an element has an
xlink:role="http://docbook.org/xlink/role/olink"
attribute, then its xlink:href
attribute is interpreted using olink semantics. That
is, the part of xlink:href before
the fragment identifier (#) is interpreted as equivalent to an
olink targetdoc
attribute value instead of a URI, and the part after the fragment
identifier as an olink targetptr attribute value.
Processing expectations
Formatted inline.
An olink points to its target primarily with
the targetdoc attribute. The
targetdoc is a URI that
identifies a target document.
The semantics of the link are controlled by three other
attributes: targetptr, localinfo, and type.
The targetptr attribute
(possibly in conjunction with localinfo) points into the document in
some fashion. The type may
provide some additional, application-specific information about the
link. DocBook does not provide any semantics for the values of these
attributes.
Note
The targetptr and
localinfo attributes were
developed somewhat independently and arguably have somewhat
overlapping semantics. While almost all applications can certainly
get by with one or the other, the Technical Committee has decided
that removing localinfo simply
for semantic cleanliness isn’t worth the effort.
Linking elements must not be nested within other linking elements (including themselves). The processing of nested linking elements is undefined.
Attributes
- localinfo
Holds additional information that may be used by the application when resolving the link
- targetdoc
Specifies the URI of the document in which the link target appears
- targetptr
Specifies the location of the link target in the document
- type
Identifies application-specific customization of the link behavior
- xrefstyle
Specifies a keyword or keywords identifying additional style information
Parents
These elements contain olink: abbrev, acronym, address, artpagenums, attribution, authorinitials, bibliocoverage, biblioid, bibliomisc, bibliomixed, bibliomset, bibliorelation, bibliosource, bridgehead, citation, citebiblioid, citetitle, city, confdates, confnum, confsponsor, conftitle, contractnum, contractsponsor, contrib, country, edition, email, emphasis (db._emphasis), emphasis (db.emphasis), entry, fax, firstname, firstterm (db._firstterm), firstterm (db.firstterm), foreignphrase (db._foreignphrase), foreignphrase (db.foreignphrase), givenname, glosssee, glossseealso, glossterm (db._glossterm), glossterm (db.glossterm), holder, honorific, issuenum, jobtitle, label, line, lineage, link, literal, literallayout, mathphrase, member, olink, optional, orgdiv, orgname, otheraddr, othername, pagenums, para, personname, phone, phrase (db._phrase), phrase (db.phrase), pob, postcode, primary, productname, productnumber, publishername, quote (db._quote), quote (db.quote), releaseinfo, remark, revnumber, revremark, secondary, see, seealso, seriesvolnums, shortaffil, simpara, state, street, subscript, subtitle, superscript, surname, term, termdef, tertiary, title, titleabbrev, trademark, uri, volumenum, wordasword, year.
Children
The following elements occur in olink: text, abbrev, acronym, alt, anchor, author, biblioref, citation, citebiblioid, citetitle, coref, date, editor, email, emphasis (db._emphasis), emphasis (db.emphasis), firstterm (db._firstterm), firstterm (db.firstterm), footnote, footnoteref, foreignphrase (db._foreignphrase), foreignphrase (db.foreignphrase), glossterm (db._glossterm), glossterm (db.glossterm), indexterm (db.indexterm.endofrange), indexterm (db.indexterm.singular), indexterm (db.indexterm.startofrange), inlineequation, inlinemediaobject, jobtitle, link, literal, olink, optional, org, orgname, person, personname, phrase (db._phrase), phrase (db.phrase), productname, productnumber, quote (db._quote), quote (db.quote), remark, subscript, superscript, termdef, trademark, uri, wordasword, xref.