property_name]'|'[DocBookIfNone]' ]? [ S
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.
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.
The character entities listed in the dialog box displayed by this command are determined as follows:
[DocBook] parameter has been specified, use the character entities defined in the DocBook 4.4+ DTD and this, whatever the schema the document being edited is conforming to.
[$ parameter has been specified, use the character entities defined in the Java™ properties file which is the value of Java™ property
Use the character entities defined in the DTD to which the document being edited is conforming to.
Use the character entities defined in the Java™ properties file which is the value of Java™ property
configuration_name is the name of the configuration associated to the document being edited.
[DocBookIfNone] parameter has been specified, use the character entities defined in the DocBook 4.4+ DTD.
The above steps are tried in order until a step succeeds. If all steps fail, this command cannot be executed and therefore, displays no dialog box at all.
insertCharByName insertCharByName Beta insertCharByName [DocBook] insertCharByName [DocBook] lambda insertCharByName [$my_favorite_chars] insertCharByName [DocBookIfNone]
Example 6.4. MathML example
Let's suppose that the MathML configuration is based on
mathml2.xsd and not on
mathml2.dtd. Even without a DTD, you want to be able to insert math characters specified using their entity names (
it, etc). Here's how to do that:
Create a Java™ properties file defining all the character entities you need (
... CircleDot=\u2299 CircleMinus=\u2296 CirclePlus=\u2295 CircleTimes=\u2297 ...
Add this property configuration element to the
mathml.xxe configuration file:
<property name="MathML.characterEntities" url="true">mathml_chars.properties</property>
When editing a MathML document, use command
insertCharByName without any special option. Examples:
insertCharByName insertCharByName InvisibleTimes insertCharByName af