Named Entities Manager

An HTML entity is a construct that allows you to display special characters or symbols. For example, a copyright symbol can be represented with entity "©" which renders as "©". Entities can be represented by name or by number. The numeric form of the copyright entity is "©". Obviously, named entities are easier to remember than numeric entities.

Unfortunately, ePub books consist of XHTML documents rather than HTML, and XHTML does not support most named entities, but it does have full support for numeric entities. Also unfortunately, ePub book content often contains named entities even though they are not strictly valid. By default, ePub Reader will replace named entities with a space character to prevent the rendering from failing.

eLibrary Manager maintains a set of named entity to numeric entity mappings, using those to allow ePub Reader to render them as intended by substituting the named version of any entities it encounters with the numeric form.

To ensure that you always have easy access to managing named entity definitions, eLibrary Manager provides a Named Entities Manager view where you can manage those definitions.

eLibrary Manager bundles a set of pre-defined named entity definitions that are available for use out of the box. You can add more mappings by adding new definitions, or override bundled definitions by simply adding new entries with the same names, or by disabling those entries.

The location and name of the named entity definition file, if you have the full version of eLibrary Manager, is

/Android/data/kpw.ebook/files/entity/entity.txt

And if you have the free version of eLibrary Manager, it is

/Android/data/kpw.ebook0/files/entity/entity.txt

Bundled pre-configured named entity mappings include:

•  =  [ ]
•  =  [ ]
•  =  [ ]
•  =  [ ]
• ©=© [©]
• ®=® [®]
• ™=™ [™]
• –=– [–]
• —=— [—]
• ‘=‘ [‘]
• ’=’ [’]
• “=“ [“]
• ”=” [”]
• …=… […]

Add

The "Add" action on the action bar and floating action button allows you to add a custom named entity definition. This action launches a dialog where you can set the name and value for a named entity entry. If an entry already exists with that name, the new one will replace it. This is true when overriding bundled pre-defined entries as well.

Disable

Bundled pre-defined named entity entries have a toggle to allow you to disable the entry, or re-enable it if it was previously disabled.

Actions

Invoke a context menu of action options by long-pressing a list item. The actions that are available are

• Edit – Edit a custom named entity definition to change its name or value. If you update the name to one that already exists, the new definition will replace the old one. If the old definition was overriding a bundled entry, the bundled definition will become visible once again.
• Delete – Delete a custom named entity definition. If the entry being deleted was overriding a bundled pre-defined entity entry, the bundled entry will become visible once again.