33. insertCharByName

Parameter syntax:

[ '[DocBookIfNone]'|'[DocBook]' ]? [ S entity_name ]?

Inserts at caret position a character specified using its entity name. If the entity name is not specified, this command displays a dialog box (supporting auto-completion) which allows to choose it interactively.

Important

This command does not insert a reference to a character entity, it inserts a character. It must be considered as an alternative to using the Characters tool of XMLmind XML Editor.

Unless the [DocBookIfNone] option or the [DocBook] option is specified, this command cannot be executed if the document being edited has no DTD defining character entities.

If the [DocBookIfNone] option is specified, the dialog box lists the names of the character entities defined in the DocBook 4.2 DTD, but only if the DTD/schema of the document being edited does not define its own character entities.

If the [DocBook] option is specified, the dialog box lists the names of the character entities defined in the DocBook 4.2 DTD, whatever is the DTD/schema of the document being edited.

Examples:

insertCharByName
insertCharByName Beta
insertCharByName [DocBookIfNone]
insertCharByName [DocBookIfNone] mdash
insertCharByName [DocBook]
insertCharByName [DocBook] lambda