DITA Best Practices : Applying Profiling Attributes

Created by Todd Stupnik on Dec 12, 2014

Profiling attributes are applied on element nodes.

You can apply profiling attributes on a text fragment, on a single element, or on multiple elements in the same time. To profile a fragment from your document, select the fragment in the Author mode and follow these steps.
Note: If there is no selection in your document, the profiling attributes are applied on the element at caret position.
  1. Invoke the Edit Profiling Attributes... action from the contextual menu.

    The displayed dialog shows all profiling attributes and their values, as defined on the document type of the edited content. The checkboxes corresponding with the values already set in the profiled fragment are enabled.

  2. In the Edit Profiling Attributes dialog, enable the checkboxes corresponding to the attribute values you want to apply on the document fragment. The profiling attributes having different values set in the elements of the profiled fragment are marked with a gray background and they are disabled by default. You can change the values of these attributes by choosing the Change Now option associated with all attributes.
  3. Click OK to finish the profiling configuration.

    The attributes and attributes values selected in the Edit Profiling Attributes dialog are set on the elements contained in the profiled fragment.

    If you select only a fragment of an element's content, this fragment is wrapped in phrase-type elements on which the profiling attributes are set. Oxygen XML Editor comes with predefined support for DITA and Docbook. For more developer-level customization options, see the Customize Profiling Conditions topic.

    If Show Profiling Attributes option (available in the Profiling / Conditional Text toolbar menu) is set, a light green border is painted around profiled text, in the Author mode. Also, all profiling attributes set on the current element are listed at the end of the highlighted block and in its tooltip message. To edit the attributes of a profiled fragment, click one of the listed attributes. A form control pops up and allows you to add or remove attributes using their checkboxes.