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 Author
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 Author
.
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 Author
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 Author
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.
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 for IDs at sub-topic level the
conrefend value will
also be set to the value of the last selected ID path.
Oxygen XML Author
will present
the entire referenced range as read-only content.
Important: All keys
which are presented in the dialog are gathered from the current opened DITA
map. Elements which have the conkeyref attribute set are
displayed by default with the target content expanded. The current opened
DITA map is also used to resolve references when navigating
conkeyref links in the Author mode.