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: 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.
- 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 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 List Item -
Inserts a new list item in any of the above three list types.
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 - Allows generating ID for the current selection or
for the element at caret position if the element appears in ID
Generation dialog.
In this dialog, you can specify the elements for which
Oxygen generates an ID. You can
choose to automatically generate an ID for these elements by selecting Auto
generate ID's for elements. You can choose a pattern for the generated ID
using the field ID Pattern. If the element already has an ID, this
ID is preserved.
All actions described above are available in the contextual menu, the
DocBook4 submenu of the main menu and 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).