17.3.3 Configuring links for DocBook XML

DocBook requires linking mark-up that is slightly different from mark-up for generic XML. The following settings require other than the default value:

[HTMLOptions]

; HrefAttribute = name to use for link source attr, default href; use

;  linkend for DocBook

HrefAttribute = linkend

; UseHash = Yes (default, start local hrefs with #)

;  or No; the # is not valid in DocBook

UseHash = No

; UseUlink = No (default, use ATagName for URLs) or Yes (use

; ulink for URLs, and url as the HrefAttribute within them)

UseUlink = Yes

; RemoveXrefHotspots = No (default) or Yes (remove hotspot text for

; xrefs and hyperlinks to Frame files, retain it for external URLs)

RemoveXrefHotspots = Yes

; UseListedXrefFilesOnly = No (default) or Yes (consider any xref

; target files not listed in [XrefFiles] to refer to the current

;  file.) This suppresses filenames for DocBook where files are in the

;  same DocBook book; files not in the book must be listed in

;  [XrefFiles].

UseListedXrefFilesOnly = Yes

See also:

§14.6 Configuring links for generic XML

---

> 17 Converting to DocBook XML > 17.3 Specifying general options for DocBook > 17.3.3 Configuring links for DocBook XML