Inserting External Xref to a Newly-Created Document

You can insert an external xref pointing to a newly-created target document.

Do the following:

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

The Insert External Xref Dialog will appear.

Figure 1. Insert External Xref Dialog.
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.
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.
The target is selected automatically.
In the Insert 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.
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
Click the Insert button to insert the external xref.
Click the Close button to close the dialog.
Note:
You can also check the Close on Insert checkbox, and then click the Insert button.