The specific actions for DITA topic documents are:
Bold - Surrounds the
selected text with a b tag.
Italic - Surrounds the
selected text with an i tag.
Underline - Surrounds
the selected text with a u tag. Bold, Italic, and Underline are toggle actions.
For all of the above actions, if there is no selection in the document, then a new specific tag is inserted. These actions are available in any document context.
Insert a cross reference in a DITA document
You can also reference elements at sub-topic level by pressing the Sub-topic button and choosing the target.
Insert Section /
Step - Inserts a new section / step in the document, depending on
the current context. A new section will be inserted in either one of the following contexts:A new step will be inserted in either one of the following contexts:
Insert
Paragraph - Inserts a new paragraph depending on the current
context. If current context is a paragraph context (the value of
class attribute of the current element or one of its ancestors
contains topic/p) then a new paragraph will be inserted after this
paragraph. Otherwise a new paragraph is inserted at caret position.
Insert
Concept - Inserts a new concept. Concepts provide background
information that users must know before they can successfully work with a product or
interface. This action is available in one of the following contexts:
Insert Task -
Inserts a new task. Tasks are the main building blocks for task-oriented user
assistance. They generally provide step-by-step instructions that will enable a user
to perform a task. This action is available in one of the following contexts:
Insert Reference
- Inserts a new reference in the document. A reference is a top-level container for
a reference topic. This action is available in one of the following contexts:
Insert Image
Reference - Inserts a graphic object at the caret position.
Depending on the current context, an image-type DITA element is inserted. The
following graphical formats are supported: GIF, JPG, JPEG, BMP, PNG, SVG. Also you
can use this action to refer MathML files.
Insert Content
Reference - Inserts a content reference at the caret
position.
The DITA conref attribute provides a mechanism for reuse of content fragments. The conref attribute stores a reference to another element and is processed to replace the referencing element with the referenced element. The element containing the content reference acts as a placeholder for the referenced element. The identifier for the referenced element must be either absolute or resolvable in the context of the referencing element. See here for more details.
Oxygen XML Editor plugin will display the referred content of a DITA conref if it can resolve it to a valid resource. If you have URI's instead of local paths in the XML documents and your DITA OT transformation needs an XML catalog to map the URI's to local paths you have add the catalog to Oxygen XML Editor plugin . If the URI's can be resolved the referred content will be displayed in Author mode and in the transformation output.
A content reference is inserted with the action Insert a DITA Content Reference available on the toolbar Author custom actions and on the menu .
Insert Content Reference Dialog
In the URL chooser you set the URL of the file from which you want to reuse content. Depending on the Target type filter you will see a tree of elements which can be referred (which have ID's). For each element the XML content is shown in the preview area. The Conref value is computed automatically for the selected tree element. After pressing OK an element with the same name as the target element and having the attribute conref with the value specified in the Conref value field will be inserted at caret position.
According to the DITA 1.2 specification the conrefend attribute can be used to specify content reference ranges. This is a very useful feature when referencing multiple consecutive steps or list items. If you use multiple contiguous sibling selection the conrefend value will also be set to the value of the last selected ID path. Oxygen XML Editor plugin will present the entire referenced range as read-only content.
Insert Content Key
Reference - Inserts a content key reference at the caret
position.As stated in the DITA 1.2 specification the conkeyref attribute provides a mechanism for reuse of content fragments similar with the conref mechanism. Keys are defined at map level which can be referenced using conkeyref. The conkeyref attribute contains a key reference to another element and is processed to replace the referencing element with the referenced element. The element containing the content key reference acts as a placeholder for the referenced element. The identifier for the referenced element must be either absolute or resolvable in the context of the referencing element.
Oxygen XML Editor plugin will display the key referred content of a DITA conkeyref if it can resolve it to a valid resource in the context of the current opened DITA map.
A content key reference is inserted with the action Insert a DITA Content Key Reference available on the toolbar Author custom actions and on the menu .
Insert Content Key Reference Dialog
To reference target elements at sub-topic level just press the Sub-topic button and choose the target.
Paste as Content
Reference - Pastes the content of the clipboard as a content
reference. Note that the copied element must have the id attribute
set.
Paste as Link -
Pastes the content of the clipboard as a link. Note that the copied element must
have the id attribute set.
Insert Ordered
List - Inserts an ordered list with one list item.
Insert Unordered
List - Inserts an unordered list with one list item.
Insert List
Item - Inserts a new list item for in any of the above two list
types.
Insert Table -
Opens a dialog that allows you to configure the table to be inserted. The dialog
allows the user to configure:
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 will be inserted at caret's
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. Note that 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. Note that 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. Note that this action works only if the current
cell spans over more than one column. The column span of the source cell will be
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. Note that this action works only if
the current cell spans over more than one column. The column span of the source cell
will be decreased with one.
Split Cell
Above - Splits the cell from current caret position in two,
inserting a new empty table cell above. Note that this action works only if the
current cell spans over more than one row. The row span of the source cell will be
decreased with one.
Split Cell Below
- splits the cell from current caret position in two, inserting a new empty
table cell below. Note that this action works only if the current cell spans
over more than one row. The row span of the source cell will be decreased with
one.
All actions described above are available in the contextual menu, the DITA submenu of the main menu or in the Author custom actions toolbar.
A drag and drop with a file from the Project view or from the DITA Maps Manager view to a DITA topic document that is edited in Author mode will create a link to the dragged file (the xref DITA element with the href attribute) at the drop location. A drag and drop with an image file from the default file system application (Windows Explorer on Windows, Finder on Mac OS X, etc) will insert an image element (the image DITA element with the href attribute) with the location of the dragged file at the drop location, like the Insert Graphic toolbar action.