You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
I am on the verge of using Asciidoclet on a relatively large codebase, that has a lot of old-ish Javadoc written with html. I'd like to progressively enhance the docs, but I can't realistically go and convert all of the existing doc.
Is there any way to make Asciidoclet more lenient ? Perhaps something along the lines of "if there is html in the doc, let it be processed by the default doclet" ?
I am not familiar with how doclets work (i.e what input they get from the Javadoc tool), so this is perhaps more trouble than it's worth. I'd give it a shot though, if one of the devs of Asciidoc would indicate this is something they'd agree is useful. (although this might be quite tricky, since one might want html in their asciidoc, e.g code samples)
Alternatively, perhaps there are tools to help converting existing Javadoc ?
The text was updated successfully, but these errors were encountered:
gjoseph
changed the title
Any for Asciidoclet to be lenient towards html ?
Any way for Asciidoclet to be lenient towards html ?
Mar 16, 2015
Is there a way to specify which files are processed with which doclet? If so, then you could just specify the files that are processed with Asciidoclet as you convert them.
You could also escape all the files that you need to convert using the ++++ directive (http://asciidoctor.org/docs/user-manual/#built-in-blocks-summary). An easy way to do this is to perform a global replace with something like /** -> /**\n *++++ and *\n*/ -> *++++\n*/
It would be difficult to detect if HTML was used or not, I'd rather not complicate things if we can.
I am on the verge of using Asciidoclet on a relatively large codebase, that has a lot of old-ish Javadoc written with html. I'd like to progressively enhance the docs, but I can't realistically go and convert all of the existing doc.
Is there any way to make Asciidoclet more lenient ? Perhaps something along the lines of "if there is html in the doc, let it be processed by the default doclet" ?
I am not familiar with how doclets work (i.e what input they get from the Javadoc tool), so this is perhaps more trouble than it's worth. I'd give it a shot though, if one of the devs of Asciidoc would indicate this is something they'd agree is useful. (although this might be quite tricky, since one might want html in their asciidoc, e.g code samples)
Alternatively, perhaps there are tools to help converting existing Javadoc ?
The text was updated successfully, but these errors were encountered: