Docbook refentry conversion

[mike004]

Looking to convert refentry content from DocBook XML to DITA.
The default DocBook to DITA transform does not work well. For example, it converts cmdsynopsis => syntaxdiagram
And syntaxdiagram is for flowcharts, I think.
Any suggestions?

[Cosmin Duna]

Hi,
Thank you for contacting us.
I checked the DITA documentation for the "syntaxdiagram" element (https://www.oxygenxml.com/dita/1.3/spec ... agram.html) and it describes this element like this:

The syntax diagram represents the syntax of a statement from a computer language or a command, function call, or programming language statement.

What DITA element did you expect to obtain from "cmdsynopsis"?
Do you have any other examples when this didn't work well?

Best regards,
Cosmin

[mike004]

I was expecting some kind of textual list output. Search the web for "syntax diagram" and you get a flow chart.
By the way, we are using DITA 1.2.

[Cosmin Duna]

Hi,
The specification is the same for this element on DITA 1.2: https://docs.oasis-open.org/dita/v1.2/o ... agram.html.
Maybe you can create a custom refactoring operation based on XSLT that changes the "syntaxdiagram" elements from the DITA output with these lists:
https://www.oxygenxml.com/doc/versions/ ... tions.html

Best regards,
Cosmin

[mike004]

Another reason that syntaxdiagram is a problem is that we are also looking to transform some topics from DITA -> troff.
And the troff DITA-OT transformation does not support syntaxdiagram, unfortunately.

[Cosmin Duna]

Hi,
I registered an issue on the DITA-OT plugin that adds this transformation: https://github.com/dita-ot/org.dita.troff/issues/8

Best regards,
Cosmin