Docbook refentry conversion
Post here questions and problems related to editing and publishing DITA content.
Docbook refentry conversion
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?
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?
-
- 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:
Do you have any other examples when this didn't work well?
Best regards,
Cosmin
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:
What DITA element did you expect to obtain from "cmdsynopsis"?The syntax diagram represents the syntax of a statement from a computer language or a command, function call, or programming language statement.
Do you have any other examples when this didn't work well?
Best regards,
Cosmin
Cosmin Duna
<oXygen/> XML Editor
http://www.oxygenxml.com
<oXygen/> XML Editor
http://www.oxygenxml.com
-
- 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
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
<oXygen/> XML Editor
http://www.oxygenxml.com
Re: Docbook refentry conversion
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.
And the troff DITA-OT transformation does not support syntaxdiagram, unfortunately.
-
- 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
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
<oXygen/> XML Editor
http://www.oxygenxml.com
Return to “DITA (Editing and Publishing DITA Content)”
Jump to
- Oxygen XML Editor/Author/Developer
- ↳ Feature Request
- ↳ Common Problems
- ↳ DITA (Editing and Publishing DITA Content)
- ↳ SDK-API, Frameworks - Document Types
- ↳ DocBook
- ↳ TEI
- ↳ XHTML
- ↳ Other Issues
- Oxygen XML Web Author
- ↳ Feature Request
- ↳ Common Problems
- Oxygen Content Fusion
- ↳ Feature Request
- ↳ Common Problems
- Oxygen JSON Editor
- ↳ Feature Request
- ↳ Common Problems
- Oxygen PDF Chemistry
- ↳ Feature Request
- ↳ Common Problems
- Oxygen Feedback
- ↳ Feature Request
- ↳ Common Problems
- Oxygen XML WebHelp
- ↳ Feature Request
- ↳ Common Problems
- XML
- ↳ General XML Questions
- ↳ XSLT and FOP
- ↳ XML Schemas
- ↳ XQuery
- NVDL
- ↳ General NVDL Issues
- ↳ oNVDL Related Issues
- XML Services Market
- ↳ Offer a Service