Syntax diagrams in SVG

Graham Hannington
Posts: 44
Joined: Mon Jun 13, 2016 11:23 am

Syntax diagrams in SVG

Post by Graham Hannington » Tue Aug 11, 2020 5:00 am

Dear Oxygen developers,

I spend much of my time developing IBM-brand documentation. In that doc ecosystem, syntax diagrams in DITA now get formatted to SVG.

However, I've recently started working on a non-IBM-brand product, outside the IBM doc ecosystem.

I've just tried formatting a DITA topic with a syntax diagram using the DITA OT HTML5 transformation scenario in Oxygen XML Author 22.1. The diagram is output as "brackets'n'braces" text.

Have you considered integrating "syntax diagrams in SVG" with the Oxygen distribution?

Radu
Posts: 7154
Joined: Fri Jul 09, 2004 5:18 pm

Re: Syntax diagrams in SVG

Post by Radu » Tue Aug 11, 2020 6:50 am

Hi Graham,

Right, Robert Anderson presented this project at one of our DITA OT Day meetups about 3 years ago:

https://www.youtube.com/watch?v=Q-Bc2nu7mcM

I considered adding these plugins to Oxygen's DITA OT "plugins" folder but it's not been something asked for by our users, you are probably the first one to ask for this. There are lots of DITA OT plugins and we try to include the ones which seem to be useful for a significant number of clients.
Of course, you can install the plugins yourself in the DITA OT bundled with Oxygen, or copy Oxygen's DITA OT separately and install them in that separate DITA OT folder:

https://www.oxygenxml.com/doc/versions/ ... lugin.html

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com

Graham Hannington
Posts: 44
Joined: Mon Jun 13, 2016 11:23 am

Re: Syntax diagrams in SVG

Post by Graham Hannington » Wed Sep 30, 2020 8:29 am

I was going to reply by attaching an example SVG file (with file extension .svg) generated by a DITA-OT instance to which I'd added that plugin, and then, hopefully, refer to the URL of that attachment (if I could figure it out) in an img tag in the reply, but I hit a snag: attempting to attach the .svg file resulted in the following error from this forum website:
Invalid file extension: txc_syntax_summary_detail_auxiliary.svg
Nits, really. Still, for what it's worth:
  • I'd like to be able to attach a .svg file to a forum post
  • I'd like to be able to present that .svg in a forum post via an img tag

Radu
Posts: 7154
Joined: Fri Jul 09, 2004 5:18 pm

Re: Syntax diagrams in SVG

Post by Radu » Wed Sep 30, 2020 8:50 am

Hi Graham,

Thanks for the request, I added an internal issue for our web site devs.

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com

Post Reply