Thanks Hardy, I'll try it tomorrow and let you know hot it worked out. The pandoc method yields an exception for docbook -> asciidoc and the html -> asciidoc requires too much manual intervention.
Keep in touch, Vlad On Wed, Dec 2, 2015 at 6:20 PM, Hardy Ferentschik <ha...@hibernate.org> wrote: > Hi, > > On Wed, Dec 02, 2015 at 01:28:59PM +0200, Vlad Mihalcea wrote: > > > I started migrating the 5.0 docbook documentation to asciidoctor, and, > > because there wasn't any converter for such a task, I wrote a small shell > > script which uses pandoc. > > There is a converter - https://github.com/bleathem/docbook2asciidoc > That's the converter we used for the initial conversion of the Hibernate > Search > and Validator docbook sources to asciidoc. > > It works quite well. The output is directly usable. The actual generated > asciidoc > can need some cleanup which we did in a once off effort. > > AFAIR, there were a couple of caveats which we only discovered after the > migration > and after some manual changes. One of them was that we used in Search and > Validator > a custom docbook class to mark classes (maybe also method, not sure). The > XLST in these > scripts does not take care of this, even though it could with some minor > tweaking. > The result was that class names which used the 'classname' marker did not > get special > treatment in asciidoc. We ended up adding it manually. > > --Hardy > > _______________________________________________ hibernate-dev mailing list hibernate-dev@lists.jboss.org https://lists.jboss.org/mailman/listinfo/hibernate-dev
