The DocBook tool bar starts with a number of “text style” toggles. These toggles emulate the behavior of the Bold, Italic, Underline, etc, toggles found in the tool bars of almost all word-processors. More information about text style toggles in About “text style” toggles in XMLmind XML Editor - Online Help.
In the above screenshot, the caret is inside an emphasis
element and the user clicked the arrow button next to a “italic text style” toggle.
“Toggle” element emphasis
. Next to this toggle is found an arrow button displaying a menu containing additional checkboxes for the following elements: firstterm
, citetitle
, replaceable
, trademark
, trademark[registered]
.
“Toggle” element emphasis[bold]
. Next to this toggle is found an arrow button displaying a menu containing additional checkboxes for the following elements: abbrev
, guilabel
, guibutton
, guimenuitem
, guisubmenu
, guimenu
, keycap
, keysym
.
“Toggle” element literal
. Next to this toggle is found an arrow button displaying a menu containing additional checkboxes for the following elements: filename
, sgmltag[element]
, sgmltag[attribute]
, sgmltag[attvalue]
.
Displays a menu letting the user change the character case of selected text. If a single node is selected, this converts the character case of all the text contained in this node. If there is no selection of any kind, this converts the character case from caret position to end of word, then it moves the caret to the next word.
All characters are converted to lowercase characters. Keyboard shortcut: Esc+l.
All characters are converted to uppercase characters. Keyboard shortcut: Esc+u.
First character of a word is converted to an uppercase character. The other characters are converted to lowercase characters. Keyboard shortcut: Esc+c.
Convert implicit or explicit selection to plain text.
Displays menu letting the user add a link to your document.
Converts the selection, if any, to an “internal link”; simply inserts an empty “internal link” at caret position otherwise. An internal link is a link
element having a linkend
attribute.
Converts the selection, if any, to an “external link”; simply inserts an empty “external link” at caret position otherwise. An external link is a link
element having an xlink:href
attribute (DocBook 4: an ulink
element having an url
attribute).
In the context of a modular document (e.g. a book comprising chapters, each chapter being contained in its own file), do not create external links between modules (e.g. chapters). Instead create internal links between modules. |
Inserts an xref
element at caret position.
Converts the selection, if any, to an olink
element (that is, a link between different DocBook documents); simply inserts an empty olink
element at caret position otherwise.
This button displays a menu having 2 entries:
and .The
menu entry displays a dialog box letting the user search and select anchors (that is, any element having an ID) and links. Its button copies selected ID or link target to the clipboard.Convert a paragraph to a list item and a list item to a paragraph, the new element having a lesser nesting level than the original one. This button automatically splits lists when needed to.
This is the inverse command of "below.
". More InformationConvert a paragraph to a list item and a list item to a paragraph, the new element having a greater nesting level than the original one. This button automatically creates lists or merges adjacent lists when needed to.
Note that the two above buttons strictly alternate between paragraphs and list items. This means that you'll often have to click a button twice in a row. For example, in order to create a nested list, first click anywhere inside a list item and then click " " twice. First click converts the list item to a plain paragraph contained in the preceding list item. Second click converts this paragraph to the first item of a new nested list.
For the two above buttons to function, any of the following conditions should be met:
A sequence of list items must be explicitly selected.
A list must be explicitly selected. This is equivalent to selecting all its items.
A sequence of blocks starting with a paragraph must be explicitly selected.
A paragraph must be implicitly selected. In order to implicitly select a paragraph, suffice to click anywhere inside it. However if this paragraph is the first child of a list item, then it's the list item which is implicitly selected.
A list item must be implicitly selected. In order to implicitly select a list item, suffice to click anywhere inside it.
When a paragraph is to be converted to a new list using this " " button, there is a quick and simple way to specify the kind of list to be created:
These “prefixes” are used to create respectively: , , , , , , , as if the " " menu below was automatically used. |
Displays a menu allowing the user to change the type of the current list.
Additional menu entry "continuation
attribute of an ordered list to continues
when this attribute is absent and removes this attribute otherwise. Additional menu entry " ", which is rendered as a checkbox, sets the inheritnum
attribute of an ordered list to inherit
when this attribute is absent and removes this attribute otherwise.
The list must be explicitly or implicitly selected. In order to implicitly select a list, suffice to click anywhere inside it.
Known problems | |
---|---|
Except for the simplest cases, "not correctly rendered in the styled view of the document. For example, " " has no visual effect on The reason of this limitation is that the implementation of "CSS counters. However, when you'll convert your document to other formats such as HTML, PDF, DOCX, etc, there are no such limitations and " " should give you the expected results. " leverages standard |
Displays a menu allowing the user to select a type of list (itemizedlist
, orderedlist
, variablelist
). The chosen list is added after node selection or after caret at a location where it is valid to do so.
Add a para
element after node selection or after caret at a location where it is valid to do so.
Add a listitem
or varlistitem
element after current list item. For this command to work, suffice to click anywhere inside an itemizedlist
, orderedlist
or variablelist
element.
Displays a menu allowing the user to insert a footnote or a reference to a footnote (footnoteref
) at caret position.
If a reference to a footnote is already selected, the
menu entry lets the user choose the ID of the footnote to be referenced.Displays a menu allowing the user to add different kinds of admonitions after node selection or after caret at a location where it is valid to do so.
Displays a menu allowing the user to add different kinds of elements containing preformatted text after node selection or after caret at a location where it is valid to do so.
Menu entry "
" normalizes whitespace in implicitly or explicitly selected program listing. Normalizing whitespace means: expanding tab characters to a number of space characters and removing the space characters which are common to the beginning of all text lines (that is, removing the superfluous “indentation” in the program listing, if any).Displays a menu letting the user add different kinds of images and figures after node selection or after caret at a location where it is valid to do so.
Adding an image map to your document | |
---|---|
The following menu items allow to add the equivalent of an HTML image map to your DocBook documents.
Once any of the above menu items has been used, right-click anywhere inside the newly inserted |
Displays a menu letting the user add various kinds of MathML equations after node selection or after caret at a location where it is valid to do so.
This toolbar button is present only when a DocBook 5.1+ document is opened. Displays a menu containing the following items:
Inserts an inlinemediaobject
containing an audioobject
at caret position.
Inserts an inlinemediaobject
containing an videobject
at caret position.
Adds a mediaobject
containing an audioobject
after node selection or after caret at a location where it is valid to do so.
Adds a mediaobject
containing an videoobject
after node selection or after caret at a location where it is valid to do so.
More information in Section 16, “The media player dialog box” in XMLmind XML Editor - Online Help.
Displays a menu allowing the user to add chapter or section elements after node selection or after caret at a location where it is valid to do so.
Displays a menu allowing the user to add different kinds of tables after node selection or after caret at a location where it is valid to do so.