Changing the Target of Xref from Local to External in an Existing Document

To call up the Change Local Xref Dialog, choose DITA > Insert Local Xref or click the Insert Local Xref button on the toolbar.

The Change Local Xref Dialog will appear.

Figure 1. Change Local Xref Dialog.

To change the target of the xref from local to external, click the External Xref tab.

In the Change External Xref Dialog, specify the target file one of these ways:

1. Select an existing file.

   From the Files list, select a file.

   
   
   
   
   
   Note:

   To filter the files by type, select a type from the File type drop-down list.

2. Enter the path to an existing file or URL manually.

   1. In the Path field, type the path to the target file or URL .

      
      
      
      
      
      Note:

      URLs must start with " http://", e.g. http://www.syntext.com.

      Note:

      It is also possible to type the reference to anything within a topic, using the following format: filename.xml#topicid/elementid.

   2. Press Enter to apply the typed path.

      
      
      
      
      

From the Targets list, select the target.

Note:

You can see the list of available targets in the current document.

To filter the targets by type, select a type from the Show types drop-down list.

1. Select a format.
   From the Format drop-down list, select one of the following:

   • dita

   • html

   • pdf

   • ditamap

   Note:

   If you've typed a URL , e.g. http://www.syntext.com, and pressed Enter, the format attribute automatically gets the value html.

2. Select a scope.
   From the Scope drop-down list, select one of the following:

   • local

   • peer

   • external