Flagging Content
In DITA, you can mark certain content to flag it or draw attention to it. This is done by defining a flag in a DITAVAL file.
You can attach the DITAVAL file to the DITA map using the <ditavalref>
element in the map, or by specifying it in the args.filter transformation
parameter.
In the following example, all the elements that have the attribute @product
set to YourProd is flagged to have a purple background:
<val> ... <prop action="flag" att="product" val="YourProd" backcolor="purple"/> ... </val>
How to Flag Content Using Change Bars
As an example, to add a change bar (revision mark) for particular content, you
can use the following in the DITAVAL
file:
<val> <revprop action="flag" changebar="color:blue;style:solid;width:2pt;offset:1.25mm;placement:start" val="new"/> </val>
This would result in any content that is marked with @rev="new" having a blue
change bar.
How to Flag Content Using Images
You can mark the elements that match a specific profiling condition using images (one for the start, one for the end). The image references are relative to the DITAVAL file.
<val> <prop action="flag" att="product" val="MyProd" backcolor="blue" color="yellow" > <startflag imageref="startflag.jpg"> <alt-text>This is the start of my product info</alt-text> </startflag> <endflag imageref="endflag.jpg"> <alt-text>This is the end of my product info</alt-text> </endflag> </prop> </val>