Revision Bars

[victorjs]

It seems like this has been a hot topic for a while now (most recently it seems here: http://www.oxygenxml.com/forum/topic5927.html) but I'm having a problem implementing revision bars (or any kind of revision indicator at all) for an updated version of my book. I'm using Oxygen 13.2 and my book is authored in DITA. There is the rev= attribute, which I should be able to assign a tag, then use that tag during run-time and set it to either flag, show or not show. However, it doesn't seem to work like that, although I can see the rev= attribute on just about every main tag I insert.

Wondering if there's been any updates on this and if it's easily possible now. From my reading it seems like you have to edit the stylesheet and create your own? Even with that knowledge, I'm not sure what Oxygen file to update and how to do it. A template or code snippet would be great.

Thanks for any help you can provide.
Victor

[Radu]

Hi Victor,

There was an older DITA Open Toolkit version in which flagging indeed was not rendered in the PDF, but recent versions of the DITA OT overcame this limitation.

Flagging in PDF seemed to work for me using Oxygen 13.2 and the bundled DITA Open Toolkit.

So there are several stages:

1) In your DITA content on the desired paragraphs, elements, etc you set the @rev attribute with certain values.

In the small sample I created I had a paragraph like:

Code: Select all

 <p rev="test">With just a little bit of care and preparation...</p>

2) You create a DITAVAL filter file (we have new file templates for this) which specifies how to flag each value.
I used something like:

Code: Select all

<val>

    <prop action="flag" att="rev" val="test" style="underline" color="red" backcolor="yellow"/>

</val>

3) Edit the transformation scenario you are using for PDF generation and in the Filters tab use the DITAVAL file created above.

Some useful links for the specification:

http://docs.oasis-open.org/dita/v1.2/os ... ml#ditaval
http://docs.oasis-open.org/dita/v1.2/os ... -prop.html

Regards,
Radu

[victorjs]

Ah, great -- thanks very much! This is how I would expect it to work since I've used this method on other authoring packages. I just couldn't find any trace of it in the support forum or in the User's Guide.

Thanks again.