Specific actions for DocBook documents are:
Bold emphasized text -
Emphasizes the selected text by surrounding it with <emphasis
role="bold"/> tag.
Italic emphasized text -
Emphasizes the selected text by surrounding it with <emphasis
role="italic"/> tag.
Underline emphasized
text - Emphasizes the selected text by surrounding it with
<emphasis role="italic"/> tag. Note:
Bold, Italic, and
Underline are toggle actions.
For all of the above actions, if there is no selection, then a new
emphasis tag with specific role is inserted. These
actions are available in any document context and are grouped under the
Emphasize toolbar actions group.
- Browse reference manual - Opens in your
web browser of choice a reference to the documentation of the XML element closest to the
caret position.
- link - Inserts a hypertext link.
- ulink - Inserts a link that addresses its target with an URL
(Universal Resource Locator).
- olink - Inserts a link that
addresses its target indirectly, using the targetdoc and
targetptr values which are present in a
Targetset
file.
Insert OLink Dialog
After you choose the Targetset URL, the structure of
the target documents is presented. For each target document
(targetdoc), the content is displayed allowing for easy
identification of the targetptr for the olink
element which will be inserted. You can use the search fields to quickly
identify a target. If you already know the values for the
targetdoc and targetptr, you can insert
them directly in the corresponding fields. You also have the possibility to edit
an olink using the action Edit OLink
available on the contextual menu. The last used Targetset
URL will be used to identify the edited target.
- URI - Inserts an URI element. The URI identifies a Uniform
Resource Identifier (URI) in content.
- xref - Inserts a cross reference to another part of the
document.
Note: These actions are grouped under the Link
toolbar actions group.
Insert Section -
Inserts a new section / subsection in the document, depending on the current
context. For example if the current context is sect1 then a
sect2 is inserted, and so on.
Insert
Paragraph - Inserts a new paragraph depending on the current
context. If current context is a paragraph context (one of the ancestors of the
element at caret position is para) then a new paragraph will be
inserted after the paragraph at caret. Otherwise a new paragraph is inserted at
caret position.
Insert Graphic -
Inserts a graphic object at the caret position. This is done by inserting either
<figure> or <inlinegraphic>
element depending on the current context. The following graphical formats are
supported: GIF, JPG, JPEG, BMP, PNG, SVG.
Insert List
Item - Inserts a new list item in any of the above three list
types.
Insert Ordered
List - Inserts an ordered list. A child list item is also inserted
automatically by default.
Insert Itemized
List - Inserts an itemized list. A child list item is also inserted
automatically by default.
Insert Variable
List - Inserts a DocBook variable list. A child list item is also
inserted automatically by default.
Insert Procedure -
Inserts a DocBook procedure element. A step child
item is also inserted automatically.
Insert Table -
Opens a dialog that allows you to configure the table to be inserted. The dialog
allows the user to configure the number of rows and columns of the table, if the
header and footer will be generated and how the table will be framed.
CALS or HTML table model can be
selected.Note: If the Title checkbox is unchecked, an
informaltable element is inserted.
Insert Row
- Inserts a new table row with empty cells. The action is available when the caret
position is inside a table.
Insert
Column - Inserts a new table column with empty cells after the
current column. The action is available when the caret position is inside a
table.
Insert
Cell - Inserts a new empty cell depending on the current context. If
the caret is positioned between two cells, a new one is inserted at caret position.
If the caret is inside a cell, then the new one will be created after the current
cell.
Delete
Column - Deletes the table column where the caret is located.
Delete Row -
Deletes the table row where the caret is located.
Join Row
Cells - Joins the content of the selected cells. The operation is
available if the selected cells are from the same row and they have the same row
span. The action is also available when the selection is missing, but the caret is
positioned between two cells.
Join Cell Above
- Joins the content of cell from current caret position with that of the cell above
it. This action works only if both cells have the same column span.
Join Cell Below
- Joins the content of cell from current caret position with that of the cell below
it. This action works only if both cells have the same column span.
Split Cell To The
Left - Splits the cell from current caret position in two, inserting
a new empty table cell to the left. This action works only if the current cell spans
over more than one column. The column span of the source cell is decreased with
one.
Split Cell To The
Right - Splits the cell from current caret position in two,
inserting a new empty table cell to the right. This action works only if the current
cell spans over more than one column. The column span of the source cell is
decreased with one.
Split Cell
Above - Splits the cell from current caret position in two,
inserting a new empty table cell above it. This action works only if the current
cell spans over more than one row. The row span of the source cell is decreased with
one.
Split Cell
Below - Splits the cell from current caret position in two,
inserting a new empty table cell below it. This action works only if the current
cell spans over more than one row. The row span of the source cell is decreased with
one.
Note: DocBook 4 supports only CALS table model. HTML table model is supported only in
DocBook 5.
CAUTION:
Column specifications are required for table actions to work
properly.
-
Generate IDs - Available in the
contextual menu only, this action allows you to generate an unique ID for the
element at caret position. If the element already has an id set, it is
preserved. Further options are offered in the ID Options dialog,
available in the DocBook4 main menu. Here you can specify
the elements for which
Oxygen XML Author
generates an ID
if the Auto generate ID's for elements is enabled. If you
want to keep already set element id's when copying content in the same document,
make sure the Remove ID's when copying content in the same
document option is not checked.
All actions described above are available in the contextual menu, the
DocBook4 submenu of the main menu or in the Author custom
actions toolbar.
Dragging a file from the
Project view or from the DITA
Maps Manager view and dropping it into a DocBook 4 document
that is edited in Author mode creates a link to the dragged file (the
ulink DocBook element) at the drop location. Dragging an image file
from the default file system application (Windows Explorer on Windows or Finder on Mac
OS X, for example) and dropping it into a DocBook 4 document inserts an image element
(the inlinegraphic DocBook element with the fileref
attribute) with the location of the dragged file at the drop location (similar with the
Insert Graphic toolbar action).