DITA flagging

Summary

Please add support for DITA flagging.

Detailed Description

DITA has a @rev property that is used to track changes. They call it flagging. The changes are formatted according to a <revprop> element in the ditaval file.

For example: The XML content would contain the following: <p rev="new">This is a new paragraph.</p>

And the ditaval file would contain the following: <revprop action="flag" val="new" color="green" changebar="style:dotted;width:3pt;offset:5pt" />

This will format the text green and add a change bar.

Use Cases

DITA flagging is used to do change tracking, for example, adding change bars or changing the color of the text. This allows the reader of the text to more easily review only those sections of the text that have changed since the previous version.

LiefErickson

+1.

I want to use 'startflag' to add text to the beginning of some paragraphs as described in http://docs.oasis-open.org/dita/v1.2/os/spec/langref/ditaval-startflag.html#ditaval-startflag

I had also filed a Support case about this and was told it was not supported at this time. Case# 16624.

2012-12-14 09:07:45

NadineMurray

Judi, Ben created an override for me for a similar challenge. I've attached it to this discussion if you want to have a look at it (go to the comment "Mark Ben's change to allow highlighting of platform attribute with specified value". You might be able to adapt this override to your specific needs.

I only used this override with PDF XSL FO output. I'm not sure if it works with other types of output.

WARNING: I don't remember when I last upgraded this file. It might have been 1202.1 or before. Make sure you compare it to your current version of ePublisher for any code changes.

2012-12-17 12:42:35

LiefErickson

For something that works (but no change bars), see http://wiki.webworks.com/DevCenter/Projects/DITA%20-%20DITAVAL%20Flagging

2013-06-17 13:05:54

MarkPeters

+1.

Our company has moved its products to the cloud, with monthly updates planned for each product line. Rather than create a separate set of help content for each update, we want to maintain a single help system and indicate which changes were introduced in each monthly update.

We output from DITA to MediaWiki using ePublisher 2013.1.

I implemented Leif Erickson's flagging code (thanks for contributing that!), but it doesn't appear to work for MediaWiki output.

Thanks for your consideration.

2013-08-12 09:24:23