Page 1 of 1

troubleshooting revision bars in PDFs

Posted: Fri Mar 21, 2025 11:19 pm
by kate_lopresti
My team uses change bars in PDFs to call out new topics in a document.
When applied to subheadings (H2,H3), the revision bars tend to push section numbers into their titles (see image).
dita-ot.org states that the offset, placement and width attributes are not currently configurable. Is there another option we can use to fix this spacing?
changebar_example.png
Thanks,
Kate

Re: troubleshooting revision bars in PDFs

Posted: Mon Mar 24, 2025 10:03 am
by julien_lacour
Hello,

Could you indicate which version of Oxygen you are using and which transformation scenario you are running? (DITA Map PDF - based on HTML5 & CSS or DITA Map PDF - based on XSL-FO)
Is it possible for you to copy the original DITA fragment containing the change tracking markers for analysis?

Regards,
Julien

Re: troubleshooting revision bars in PDFs

Posted: Tue Mar 25, 2025 3:42 am
by kate_lopresti
We're generating DITA Map PDF - based on XSL-FO and using Oxygen XML Author 27.0.

Code: Select all

 <title rev="release-number">Random Number Generation</title>
changebar_toc_example.png

Re: troubleshooting revision bars in PDFs

Posted: Tue Mar 25, 2025 11:56 am
by julien_lacour
Hello,

Unfortunately DITA Map PDF - based on XSL-FO change bars support is quite limited, you can do more using the DITA Map PDF - based on HTML5 & CSS scenario using attributes similar to this one in the ditaval:

Code: Select all

changebar="color:blue;style:solid;width:2pt;offset:1.25mm;placement:start"
For more information you can check our user guide.

Regards,
Julien

Re: troubleshooting revision bars in PDFs

Posted: Tue Mar 25, 2025 8:21 pm
by kate_lopresti
Thanks, Julien. We can give it a try.