Chapter 6. Commands written in the Java™ programming language

the explicitly selected single node;
OR the node (text, comment, processing-instruction or element) containing the caret, if there is no explicit node selection and if the [implicitNode] option is used in the parameter of the command;
OR the element containing the textual node (text, comment, processing-instruction) containing the caret, if there is no explicit node selection and if the [implicitElement] option is used in the parameter of the command.

selected nodes

means

the explicitly selected single node or node range;
OR the node (text, comment, processing-instruction or element) containing the caret, if there is no explicit node selection and if the [implicitNode] option is used in the parameter of the command;
OR the element containing the textual node (text, comment, processing-instruction) containing the caret, if there is no explicit node selection and if the [implicitElement] option is used in the parameter of the command.

argument node

means

an empty text node, if the parameter of the command ends with #text;
OR an automatically generated empty element (see configuration element newElementContent in Section 20, “newElementContent” in XMLmind XML Editor - Configuration and Deployment), if the parameter of the command ends with an element name;
OR a copy of an element template (see configuration element elementTemplate in Section 12, “elementTemplate” in XMLmind XML Editor - Configuration and Deployment), if the parameter of the command ends with an element template name.

If the argument node is not explicitly specified in the parameter of a command, a dialog box is displayed and the user will have to interactively specify it.

Notation used in the synopsis of a command parameter:

In the synopsis of a command parameter, S means space.

These non-terminals are sometimes used in the synopsis of a command parameter:

implicit_selection -> '[implicitNode]' | '[implicitElement]'

argument_node -> '#text' | 
                 element_name | 
                 '#template(' element_name ',' template_name ')'

element_name -> Name | '{' namespace_URI '}' NCName

namespace_uri -> anyURI

Common pitfalls to be avoided

	Common pitfalls to be avoided
A command parameter isnotnamespace-aware Namespace prefixes cannot be used inside a command parameter. Notation {`namespace_URI`}`local_name` —the so-called James Clark's notation— must be used instead. Example 1: `{http://www.w3.org/1999/xhtml}p` means `p` in the `http://www.w3.org/1999/xhtml` namespace. Example 2: `p` means `p` with no namespace. Whitespace is significant in a command parameter Most notably, whitespace is not allowed inside the `#template()` construct. Let's use command insert as an example. The following command parameters cannot work: after after [implicitElement] before[ implicitElement ] after #template( figure , image ) before[implicitElement] #template (figure,image) While the following command parameters should be OK: after after[implicitElement] before[implicitElement] after #template(figure,image) before[implicitElement] #template(figure,image)

A command parameter isnotnamespace-aware
Namespace prefixes cannot be used inside a command parameter. Notation {namespace_URI}local_name —the so-called James Clark's notation— must be used instead.
Example 1: {http://www.w3.org/1999/xhtml}p means p in the http://www.w3.org/1999/xhtml namespace.
Example 2: p means p with no namespace.

Whitespace is significant in a command parameter

Most notably, whitespace is not allowed inside the #template() construct.

Let's use command insert as an example. The following command parameters cannot work:

   after
after   [implicitElement]
before[   implicitElement   ]
after   #template(  figure   ,   image   )
before[implicitElement]   #template   (figure,image)

While the following command parameters should be OK:

after
after[implicitElement]
before[implicitElement]
after   #template(figure,image)
before[implicitElement]   #template(figure,image)


2.3. Convert ImageDemo document to HTML		1. alert