Changing the Target of External Xref to Another External Target in an Existing Document

You can change the target of an external xref to another external target choosing the new target from existing documents.

Do the following:

  1. Place the cursor in the xref.
  2. Call up the Change External Xref Dialog.

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

    The Change External Xref Dialog will appear.

    Figure 1. Change External Xref Dialog.



  3. Specify the target file.

    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.



  4. Specify the target.

    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.



  5. Specify Attributes if needed:
    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

  6. Click the Change button to change the xref.
  7. Click the Close button to close the dialog.
    Note:

    You can also check the Close on Change checkbox, and then click the Change button.

Related tasks
Changing the Target of External Xref to Another External Target in a Newly-Created Document