The entity exception list file
Use the di_except.ent file to specify an entity exception list; the entities listed in the file are not protected from expansion. Note that no expansion is the default. That is, when processed by DI, the entities listed in the di_except.ent file are expanded and imported as data into the Contenta object(s) according to the map file.
- The di_except.ent file is not delivered with the standard Contenta software.
- If you want to specify a list of entities to be expanded when a document is processed by Dynamic Import, create a di_except.ent file in the ..\di\entities directory.
- File entities that are not expanded into the main document for parsing are not imported.
- Do not create (use) the file if the
-protentor-nopeswitch is specified in the digui.cfg file, or if the di.pl command is issued with the-protentor-nopeswitch. - List each entity to be expanded on a separate line.
Example:
| File | Contents of the file |
|---|---|
| Contents of the di_except.ent | |
| Contents of the di_except.ent | |
| Entity declarations in the DTD or in the entity declaration file | |
When the XML file is imported, the three entities in the di_except.ent file are expanded:
- the text,
Xyvision Enterprise Solutions, Inc.is imported in place ofXy. - the data from http://www.SDL.com/about.asp is imported in place of
aboutXt. - the data from http://www.SDL.com/privacy.asp is imported in place of
privXy.
The fourth entity, copyright is not expanded and is imported as copyright.
The di_except.ent file is the default entity exception list file. It is used by the DI split program when the -pentexcept argument is specified for the di.pl program.
You can create an alternate entity exception list file with a user-defined filename and specify use of the alternate file using the -exceptfile argument with the -pentexcept argument.