Topicref element attributes group

Darwin Information Typing Architecture (DITA) Version 1.3 Part 1: Base Edition

Darwin Information Typing Architecture (DITA) Version 1.3 Part 1: Base Edition
OASIS DITA Technical Committee

The topicref element attributes group includes attributes that are defined for the topicref element, and are reused on most or all specializations of the topicref element.

Use the copy-to attribute on the topicref element to provide a different resource name for a particular instance of a resource referenced by the topicref (for example, to separate out the different versions of the topic, rather than combining them on output). If applicable, the copy-to value can include path information. The links and navigation associated with that instance will point to a copy of the topic with the file name you specified. Applications MAY support copy-to for references to local non-DITA resources. The copy-to attribute is not supported for references to resources where the effective value for scope is "peer" or "external".

Use the linktext and shortdesc in the topicref's topicmeta to provide a unique name and short description for the new copy.

Specifies the title of the topic as it will appear in the navigation or tables of contents that are generated from the map. Beginning with DITA 1.2, the preferred way to specify the navigation title in a map is with the navtitle element, available inside the topicmeta element.
This attribute is deprecated. It might be removed in the future.