### 23.4 Configuring links for generic XML

There is no standard way to represent links in XML. Configure links whatever way your DTD or schema says; anything “well formed” is valid. See W3C XML Pointer, XML Base and XML Linking for more information:

http://www.w3.org/XML/Linking

To configure links for DocBook XML, see §26.3.2 Configuring links for DocBook XML. To configure links for DITA XML, see §24.9 Configuring cross references and links for DITA.

To manage links and cross references in generic XML:

    [HTMLOptions]
    ; These are mainly intended for making links for Generic XML use:
    ; RemoveANames = No (default) or Yes (eliminate <a name=...> tags)
    ; RemoveATags = No (default) or Yes (eliminate <a href=...> tags)
    ; RemoveAHrefAttrs = No (default)
    ;  or Yes (remove href attrs, keep tags)
    ; XMLLinkAttrs = No (default)
    ;  or Yes to add attrs to <a href=...> tags:
    ;  xml:link="simple" show="replace" actuate="user" class="url"
    XMLLinkAttrs=No
    ; ATagElement = tag to use for all link elements, default is "a"
    ;  except for DITA, where it is "xref"
    ATagElement=a
    ; HrefAttribute = name to use for link source attr, default href
    HrefAttribute=href
    ; UseHash = Yes (default, start local hrefs with #) or No
    UseHash=Yes
    ; UseUlink = No (default, use ATagName for URLs) or Yes (use
    ;  ulink for URLs, and url as the HrefAttribute within them)
    UseUlink=No
    ; RemoveXrefHotspots = No (default) or Yes (remove hotspot text for
    ;  xrefs and hyperlinks to Frame files, retain it for external URLs)
    RemoveXrefHotspots=No
    ; 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=No

See also:

§24.9 Configuring cross references and links for DITA

§26.3.2 Configuring links for DocBook XML

§28.2.6 Forcing link text to lowercase

Previous Topic: 23.3.3 Including or excluding autonumbers

Next Topic: 24. Converting to DITA XML

Parent Topic: 23. Converting to generic XML

Sibling Topics:

23.1 Setting up a generic XML project

23.2 Specifying generic XML output settings

23.3 Providing XML tags and structure