Flag DITA Content in WebHelp Output
Flagging content in WebHelp output involves defining a set of images that will be used for marking content across your information set.
To flag DITA content, you need to create a filter file that defines properties that will be applied on elements to be flagged. Generally, flagging is supported for block-level elements (such as paragraphs), but not for phrase-level elements within a paragraph. This ensures that the images that will flag the content are easily scanned by the reader, instead of being buried in text.
Follow this procedure:
- Create a DITA filter file in the directory where you want to add the file. Give the
file a descriptive name, such as
audience-flag-build.ditaval. - Define the property of the element you want to be flagged. For example, if you want
to
flag elements that have the
audienceattribute set toprogrammer, the content of the DITAVAL file should look like the following example:<?xml version="1.0" encoding="UTF-8"?> <val> <prop att="audience" val="programmer" action="flag" img="D:\resource\delta.gif" alt="sample alt text"/> </val>
Note that for an element to be flagged, at least one attribute-value pair needs to have a property declared in the DITAVAL file. - Specify the DITAVAL file in the Filters tab of the transformation scenario.
- Run the transformation scenario.