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 -protent or -nope switch is specified in the digui.cfg file, or if the di.pl command is issued with the -protent or -nope switch.
  • List each entity to be expanded on a separate line.

Example:

FileContents of the file
Contents of the di_except.ent
XY 
AboutXy
PriXy
Contents of the di_except.ent
<document>
<heading>&Xy;</heading>
<para>&aboutXy;</para>
<para>&privXy; </para>
<para>&copyright; </para>
</document>
Entity declarations in the DTD or in the entity declaration file
<!ENTITY Xy “Xyvision Enterprise Solutions, Inc.”>
<!ENTITY aboutXy SYSTEM 
“http://www.SDL.com/about.asp”>
<!ENTITY privXy SYSTEM
“http://www.SDL.com/privacy.asp”>
<!ENTITY copyright “Copyright by SDL”>

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 of Xy.
  • 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.