References to elements within the same document are saved in the repository in relative form, not as absolute URLs.
Beginning with Astoria 6.6, Astoria saves references to elements within the same document in the form <href="#id/subid">
. For example, if a DITA xref element in a task document points to a step in the same task, the href value would be of the form <xref href="#myId/stepId">
. Previously the href value was an absolute URL. Using relative references works better when copying documents; the copied document will reference itself, not the source. This change is made for both Docbook-based documents and DITA documents.
When a document with such local references is used as an XML template, all local references are preserved and reference the copied document, not the source document. Documents created earlier with such local references are not updated with this change. If your organization is using such documents as XML templates, you may want to adjust the template URLs to be clone-friendly, making them local by removing the part of the href that references Astoria and leaving just the #id/subid part of the reference.