Docbook refentry conversion

Post here questions and problems related to editing and publishing DITA content.
mike004
Posts: 18
Joined: Fri Feb 18, 2011 2:29 pm

Docbook refentry conversion

Post by 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
Site Admin
Posts: 120
Joined: Wed Dec 12, 2018 5:33 pm

Re: Docbook refentry conversion

Post by 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
Cosmin Duna
<oXygen/> XML Editor
http://www.oxygenxml.com
mike004
Posts: 18
Joined: Fri Feb 18, 2011 2:29 pm

Re: Docbook refentry conversion

Post by 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
Site Admin
Posts: 120
Joined: Wed Dec 12, 2018 5:33 pm

Re: Docbook refentry conversion

Post by 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
Cosmin Duna
<oXygen/> XML Editor
http://www.oxygenxml.com
mike004
Posts: 18
Joined: Fri Feb 18, 2011 2:29 pm

Re: Docbook refentry conversion

Post by 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
Site Admin
Posts: 120
Joined: Wed Dec 12, 2018 5:33 pm

Re: Docbook refentry conversion

Post by 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
Cosmin Duna
<oXygen/> XML Editor
http://www.oxygenxml.com
Post Reply