Inserting External Entity from File

You can insert a reference to an external entity which is not yet declared in the current document.

Do the following:

  1. Place the cursor in the position for insertion.

    Place the cursor in the Editing Window or in the ContentMap in the position where you want to insert the external entity reference.

  2. Call up the Insert External Entity Dialog.

    To call up the Insert External Entity Dialog, do one of the following:

    • Choose Entity > Insert External Entity .

    • Press Ctrl-6.

    The Insert External Entity Dialog will appear. It shows external entities declared in the document and allows you to browse for a file to declare a new entity and insert the entity reference.

    Figure 1. Insert External Entity Dialog.



  3. Select an external entity not yet declared in the document.

    Do the following:

    1. Select the Insert From File radio button.
    2. Specify the name of the entity.

      In the Entity Name field, enter the name of the external entity.

      Note:

      The name of the entity must be unique within the internal DTD subset.

    3. Specify the filename of the entity.

      In the File Name field, enter the filename of the external entity. You can use the Browse button to browse for the file.

    Figure 2. Not declared external entity selected for insertion from a file.



  4. Insert the external entity reference.

    To insert the reference to the specified external entity, click OK.

    The external entity will be declared in the document and the external entity reference will be inserted.

    Figure 3. External entity reference inserted in the document.



    You can also convert the document portion from the external entity into a regular content, change the external entity declaration or remove the external entity declaration.

Related tasks
Inserting Declared External Entity
Related information
Insert External Entity Dialog