openSUSE
Provide mechanism to convert from docbook to asciidoc
As the number of individuals creating content grows inside SUSE, it is necessary to enable that community of users to be able to easily maintain and leverage existing work. to be able to convert from a finished work back to asciidoc in order to keep style changes and other edits that may not have made it into the original asciidoc would provide a huge advantage and a significant process improvement for those in the doc team that work with individuals outside the team.
There seems to be some early work on such a tool here: https://github.com/openSUSE/docbookrx but it makes more sense for this to be part of daps in my mind as the conversion dictionary should really only have to be specified in one place.
There seems to be some early work on such a tool here: https://github.com/openSUSE/docbookrx but it makes more sense for this to be part of daps in my mind as the conversion dictionary should really only have to be specified in one place.
Nice find and agree it would be a valuable addition to daps (even if only a side build and then maybe a suggested dependency package). Haven't yet tried this tool, but also hoping one could just grab a section of the main xml doc to convert, since as you know I really want to head towards a more modular approach vs. creating multiple "sources" that instantly diverge. Perhaps that is another feature request for daps, that if includes are utilized in the asciidoc, that the xml/docbook should honor/retain that structuring via xi:include.
Totally agree here. This would help greatly as most of the docs i need to work on are currently written in DocBook, Very supportive of this addition!!
Sorry for the late reply...
Unfortunately it is not that easy - a 1:1 back to back conversion between asciidoc and DocBook that always produces the same results is not possible. Currently, if you would convert DocBook to ASCIIDoc and then back to DocBook teh result would be two DocBook files with significant differences. Also, based on our expereince, docbookrx generated sources require some manual post processing to make them work.
So, as of now, I do not see any possibility to realize this request, but I will keep the ticket open, in the hope the conversion tools will improve in the future...
