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

You can create a new DITA document and make it the target of an existing external xref.

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. Call up the Create New DITA Document Dialog.

    To call up the Create New DITA Document Dialog, click the Create New DITA Document button .

    The Create New DITA Document Dialog will appear.

    Figure 2. Create New DITA Document Dialog.



  4. Create the new document.

    In the Create New DITA Document Dialog, do the following:

    1. Specify parameters for the new document.
      1. From the Template drop-down list, select a template for the new document.

      2. In the Title field, type the title of the new document.

      3. The Id field gets filled in automatically when you are typing the title.

      4. In the File field, specify the name of the new document.

        Note:

        The new document will be saved in the directory of the current document. To specify another location for saving the new document, use the Browse button.

    2. Click the Create button.

    The new document will be created.

  5. The target is selected automatically.

    In the Change External Xref Dialog, the newly-created document on the Files list and its top-level topic on the Targets list are automatically selected for insertion.



  6. Specify Attributes as needed:
    1. Select a format.
      From the Format drop-down list, select one of the following:
      • dita

      • html

      • pdf

      • ditamap

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

      • peer

      • external

  7. Click the Change button to change the xref.
  8. 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 an Existing Document