 User Manual: For epcEdit Release 1.2.1 | ||
|---|---|---|
| Prev | Chapter 15. Menu structure | Next |
The command provides access to the list of defined entities.
This menu item displays a sub-menu for selecting the a subset of entities to choose from. The partitioning of the entity set depends on the number of entities that have been defined by the DTD of your document. The top-level entry displays a list of all defined entities.
The list of the available entities is displayed in a dialog together with additional information about each entity:
The Entity column in the entity list contains the names of the available entities.
The Display column shows a replacement character for this entity if one is defined.
If the entity has been bound to a key, the Key column contains the keyboard symbol for this key. It contains the string n/a if no key binding exists.
The Type column displays the entity type of each entity. For SGML documents, the entity type can be one of the values CDATA, SDATA, NDATA,TEXT,PI, and SUBDOC to distinguish between the different types of entities. In XML documents, the entity type CDATA is used to distinguish the built-in XML entities from user-defined TEXT entities. This distinction does not affect the content of an XML document; is it merely a convention used by epcEdit to differentiate between built-in and user-defined entities.
The column labeled Expand contains the value Yes if epcEdit will expand the entity (i.e. show the entity content between text entity tags) when the entity is inserted. This column will contain the value No if the entity will not be expanded and only an entity reference will be inserted.
You can insert a reference for an entity at the location of the insertion cursor by pressing the button.
If epcEdit can modify the prolog of your document, you can define a new entity by clicking on the button. This applies to SGML and valid XML documents. No additional entities can be defined in well-formed XML documents.
The Properties button opens a new dialog that contains detailed information about the selected entity (Figure 15-29)
This dialog contains additional information about the entity. In addition, it is possible to define a replacement string for the entity reference and to add a key binding for the entity.
If the entity in question is a text entity, is is possible to modify the entity expansion by selecting the appropriate value for the Expand this entity option.
The command toggles the state of epcEdit's auto-insertion facility for entities. If this option is checked, epcEdit will automatically replace some of the characters that you type with entity references.
If a character is replaced by an entity reference depends on the definition of a replacement character for this entity. Please refer to Entities for more details on automatic entity insertion.
The command allows you to edit the content of a text entity if possible.
When a reference to text entity occurs in your document, epcEdit will display a reference to this text entity in your document (either as a single entity reference or as an expanded text entity reference containing all of the content of the text entity, depending on the Expand Text Entities settings). Normally, epcEdit will not allow you to alter the content of an expanded text entity reference.
The command will allow you to edit the content of a text entity if this is possible. A text entity can be edited if it is an external text entity or if it is declared in the prolog of your document. If these requirements are met, epcEdit unlocks the text entity for editing.
External NDATA entities can have an associated notation that specifies the type of the external entity. Some notations specify that an external NDATA entity contains image data. The command is used to tell epcEdit which notations are used to specify images. If epcEdit encounters a reference to an external entity with an image notation, it will try to display the entity reference as an embedded image.
The command opens a dialog with a list of all notations that have been defined in the DTD of your document.
The Edit Notations dialog contains a list of all notations that have been defined in the DTD. The small icon to the left of each notation describes how epcEdit will handle a reference to an external entity with this notation. If a check mark occurs to the left of the notation name, epcEdit will assume that external entities with this notation contain image data. If a cross-out symbol occurs to the left of the notation name, epcEdit will not treat external entities with this notation as images.
To change the notation status, click on the small icon to the left of the notation name. Clicking on the status icon of the notation will toggle the image status of the notation from checked to unchecked and back.
The command lets you insert a numerical character reference into your document. Invoking this command opens a dialog box where you can enter the number of the character:
You can enter the the character code as a decimal number (like in the example above) or as a hexadecimal number by prefixing the number with the character 'x'. Hexadecimal character references are only supported in XML documents and in SGML documents that enable the WebSGML extensions (so that the HCRO delimiter is defined).
The display of character references depends on the setting of the Entity Names parameter. If entity names are shown, character references are displayed as numerical character references. When entity replacements are shown, character references are displayed like ordinary characters.
The command allows you to define new entities if your document permits this.
New entities can be defined if your document is a valid XML or SGML document. It is not possible to define new entities in well-formed XML documents.
The entity wizard is described in detail in Entities.
