Edit Properties Dialog Box

Target Tab

Edit Properties Dialog Box - Target Tab

The Target tab of the Edit Properties dialog box displays information about the target node on which the action was invoked and allows you to change the target. It includes the following sections and fields:

Choose a file location section

You can browse for and select the source target file by using the Look in drop-down list, browsing tools, or file window in this section. You can use the Files of type drop-down menu to narrow the list of possible file types that will be displayed.

URL

Displays the path to the target and allows you to select or change it by using the combo box or browsing tools.

ID

The drop-down list displays all of the target elements that are available for the selected target URL.

Href

The selected target automatically modifies this value to point to the corresponding href attribute of the target element.

Note

If the Reference type is a Navigation Reference, the Href field is changed to Mapref, since a navref element requires a mapref attribute instead.

Keys Tab

Edit Properties Dialog Box - Keys Tab

Define keys

Use this text field to define the keys attribute for the target.

Key scopes [This option is only available if the Built-in DITA-OT 2.x (with DITA 1.3 support) option is enabled in the DITA preferences page]

Use this text field to define or edit the value of a keyscope attribute. Key scopes allow you to specify different sets of key definitions for different map branches.

Key reference

Use this combo box (or the Choose key reference button) to select a key that is already defined in the root map.

Attributes Tab

Edit Properties Dialog Box - Attributes Tab

The Attributes tab of the Edit Properties dialog box allows you to insert and edit attribute values for the target node for which the action was invoked.

If the target is a root map, the tab displays the title of the map. You can change it in the Title text field and assign it to an Attribute, Element, or All.

Attributes Tab for a Root Map

For other types of targets, the tab includes the following sections and fields that can be used to edit the attributes of the target:

Navigation title

This text field allows you to specify a custom navigation title for the target reference. If you want this attribute to always be populated with a detected value (based on the specifications for the target file), enable the Navigation title checkbox for the Always fill values for attributes option in the DITA preferences page. You can enforce the use of the specified title by enabling the Lock checkbox.

Tip

You can also enable the Prefer navigation title for topicref rendering option in the DITA preferences page to always enforce the use of the navtitle value rather than enabling this Lock option on individual topics.

Collection type

This drop-down list allows you to select the collection-type attribute to create hierarchical linking between topics in a DITA map (for example, unordered, sequence, choice, family, -dita-use-conref-target).

Type

Allows you to select a type attribute (such as topic, task, concept, etc.) for the target element. If you want this attribute to always be populated with a detected value (based on the specifications for the target file), enable the Type checkbox for the Always fill values for attributes option in the DITA preferences page.

Scope

This property corresponds to the scope attribute of the target element. It is populated automatically, based on the selected file type, unless its value for the selected target file is the same as the default attribute value. If you want this attribute to always be populated with a detected value based on the specifications (regardless of the default value), enable the Scope checkbox for the Always fill values for attributes option in the DITA preferences page.

Format

This property corresponds to the format attribute of the target element. It is populated automatically, based on the selected file type, unless its value for the selected target file is the same as the default attribute value. If you want this attribute to always be populated with a detected value based on the specifications (regardless of the default value), enable the Format checkbox for the Always fill values for attributes option in the DITA preferences page.

Processing Role

This drop-down list allows you to set the processing-role attribute to one of the allowed values for DITA reference elements (for example, resource-only, normal, -dita-use-conref-target).

Other attributes table

This table contains the attributes that are available for the selected reference. You can use this table to insert or edit the values of any of the listed attributes. Clicking a cell in the Value column allows you to use the combo box to enter, edit, or select attribute values.

Metadata Tab

Edit Properties Dialog Box - Metadata Tab

The Metadata tab allows you to add metadata elements to the target node. Use the buttons on the right side of the tab to insert specific metadata elements (you can add the following metadata elements: navtitle, linktext, shortdesc, keyword, indexterm). The metadata elements are inserted inside a topicmeta element. The editing window allows you to easily insert and modify the content of the metadata that will be inserted.

Profiling Tab

Edit Properties Dialog Box - Profiling Tab

The Profiling tab allows you to select or change profiling attributes for the selected target nodes. This tab displays profiling attributes and their values as determined by the following:

• If your root DITA map references a DITA subject scheme map that defines values for the profiling attributes, those values are used.
• If your project defines project-level configuration values for the profiling attributes, those values are used.
• If Oxygen XML Editor defines global-level configuration values for the profiling attributes, they are used.
• Otherwise, a basic default set of profiling attributes and values are used.

If you have a large list of profiling attributes, you can use the text filter field to search for attributes or values, and you can expand or collapse attributes by using the Expand All/Collapse All buttons to the right of the text filter or the arrow button to the left of the profiling attribute name..

When you modify a selection of values in this tab, the change will also automatically be reflected in the Attributes tab. For more information, see DITA Profiling / Conditional Text.

Note

If you invoke the Edit properties action on a selection of multiple nodes that have different values for the same profiling attribute, a conflict panel will be displayed in the Profiling tab and you can choose between the following actions for resolving it:

• Keep - Preserves the current attribute values.
• Change Now - Allows you to edit the selection of values in this Profiling tab and the changes will be applied to all the selected nodes.

Profiling Conflict Panel

Finalizing Your Modifications

Once you click OK, all your changes are applied to the target node.