2. The DocBook tool bar

Toggle emphasisToggle emphasis[bold]Toggle literalToggle internal linkToggle external linkInsert cross-referenceConvert to plain textAdd paraDecrease nesting levelIncrease nesting levelChange list typeAdd listAdd list itemAdd programlistingAdd tableTable editorAdd imageAdd MathML equationAdd section

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.

Figure 1. Toggles found at the beginning of the DocBook tool bar

Toggles found at the beginning of the DocBook tool bar

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 emphasis

“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 emphasis[bold]

“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 literal

“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].

Toggle link (DocBook 4), Toggle link[linkend] (DocBook 5)

“Toggle” element link having a linkend attribute. Such element allows to specify an internal link.

Toggle ulink (DocBook 4), Toggle link[href] (DocBook 5)

“Toggle” element ulink having an url attribute (DocBook 4) or element link having an xlink:href attribute (DocBook 5). Such element allows to specify an external link.

Important

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.

Insert cross-reference

Displays a popup menu allowing to insert xref or olink elements at caret position. In the case of the olink menu item, if there is a selection, then this selection is converted to an olink element.

Convert to plain text

Convert implicit or explicit selection to plain text.

Add para

Add a para element after node selection or after caret at a location where it is valid to do so.

Decrease nesting level

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 "Increase nesting level". More Information below.

Increase nesting level

Convert 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 "Increase nesting level" 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 to be implicitly selected. In order to implicitly select a list item, suffice to click anywhere inside it.

Change list type

Displays a popup menu allowing to change the type of the current list.

The list must be explicitly or implicitly selected. In order to implicitly select a list, suffice to click anywhere inside it.

Add list

Displays a menu allowing 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 list item

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.

Add programlisting

Displays a menu which allows to add several styles of elements containing preformatted text after node selection or after caret at a location where it is valid to do so.

Add table

Displays a menu which allows to add several styles of tables after node selection or after caret at a location where it is valid to do so.

Table editor

See Section 2.1, “Table editor”.

Add image

Displays a menu which allows to 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.

mediaobject(callout)

Add an image map containing internal links typically pointing to the calloutlist element found at the end of the inserted imageobjectco element. See also command "Link callouts".

mediaobject(imagemap) (DocBook V5+ only)

Add an image map containing external links typically pointing to Web pages.

Once any of the above menu items has been used, right-click anywhere inside the newly inserted imageobjectco element and select "Edit Image Map" from the contextual popup menu to display an image map editor. This image map editor allows to add “hot areas” to your image. More information in Section 18, “The "Edit Image Map" dialog box” in XMLmind XML Editor - Online Help.

Add media object

This toolbar button is present only when a DocBook v5.1+ document is opened. Displays a menu containing the following items:

inlinemediaobject(audio)

Inserts an inlinemediaobject containing an audioobject at caret position.

inlinemediaobject(video)

Inserts an inlinemediaobject containing an videobject at caret position.

mediaobject(audio)

Adds a mediaobject containing an audioobject after node selection or after caret at a location where it is valid to do so.

mediaobject(video)

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 17, “The media player dialog box” in XMLmind XML Editor - Online Help.

Do not forget to select the DocBook XSL stylesheets generating XHTML 5 rather than plain HTML

If your document contains audio and video elements, do not forget to select the DocBook XSL stylesheets generating XHTML 5 prior to using DocBookConvert DocumentConvert to HTML. This setting is done once for all using OptionsCustomize ConfigurationCustomize Document Conversion Stylesheets in XMLmind XML Editor - Online Help.

Add section

Displays a menu which allows to add chapter or section elements after node selection or after caret at a location where it is valid to do so.

2.1. Table editor

The following table editing commands fully support CALS tables as well as HTML tables. Most table editing commands can be repeated by using EditRepeat (Ctrl+A).

Note that using this table editor, or simply saving a document, or checking a document for validity, guarantees that the cols attribute of a tgroup is up to date. That is, you may forget about the cols attribute, XMLmind XML Editor will always compute it for you.

ButtonMenu itemDescription

Table column

For a command in this menu to work, click anywhere inside a cell (or explicitly select a cell or an element having a cell ancestor).

Insert BeforeInsert a column before column containing specified cell.
Insert AfterInsert a column after column containing specified cell.
CutCut to the clipboard the column containing specified cell.
CopyCopy to the clipboard the column containing specified cell.
Paste BeforePaste copied or cut column before column containing specified cell.
Paste AfterPaste copied or cut column after column containing specified cell.
DeleteDelete the column containing specified cell.
Sort Rows

Sort all the rows of the table according to the string values of the cells of the “selected column”. (The “selected column” is the column containing specified cell.)

A dialog box is displayed allowing to specify the following sort options:

Order

Dictionary is the language-specific alphabetical order. Example: (Charles, best, Albert) is sorted as (Albert, best, Charles).

Numeric. The string value of a cell is expected to start with a number. Example: (+15.0%, 1.50%, -20%) is sorted as (-20%, 1.50%, +15.0%).

Lexicographic is the order of Unicode characters. Example: (Charles, best, Albert) is sorted as (Albert, Charles, best).

Dictionary and Numeric orders will cause this menu item to fail, unless the language of the table can be determined (i.e. lookup for the lang attribute).

Direction

Ascending means: A to Z, low to high. Descending means: Z to A, high to low.

Note that:

  • Header/footer rows (i.e. thead) are never sorted.

  • The contents of row groups (i.e. tbody) are sorted separately.

Table row

For a command in this menu to work, click anywhere inside a cell (or explicitly select a cell or an element having a cell ancestor) or explicitly select a row.

Insert BeforeFor

Insert a row before row containing specified cell.

Note

Note that row editing commands are enabled, not only by implicitly or explicitly selecting a table cell or any of its descendants, but also by explicitly selecting a table row.

Insert AfterInsert a row before row containing specified cell.
CutCut to the clipboard the row containing specified cell.
CopyCopy to the clipboard the row containing specified cell.
Paste BeforePaste copied or cut row before row containing specified cell.
Paste AfterPaste copied or cut row after row containing specified cell.
DeleteDelete the row containing specified cell.

Table cell

For a command in this menu to work, click anywhere inside a cell (or explicitly select a cell or an element having a cell ancestor).

Increment Column SpanIncrement the number of columns spanned by specified cell.
Decrement Column SpanDecrement the number of columns spanned by specified cell.
Increment Row SpanIncrement the number of rows spanned by specified cell.
Decrement Row SpanDecrement the number of rows spanned by specified cell.
Set Color

Displays a dialog box allowing to give a background color to specified cell.

Unlike the other entries of this menu, this entry allows to give a background color, not only to specified cell, but also to one or more of any of the following explicitly selected elements: row, entry, tr, td, th.