开发者

Stackoverflow markup for javadoc

开发者 https://www.devze.com 2023-03-07 13:37 出处:网络
After a while, I\'m back writing JavaDoc. At the same time I grew fond of SO\'s markup, which is way more readable in plaintext than HTML. (Even the back tick which I never used before, ever).

After a while, I'm back writing JavaDoc. At the same time I grew fond of SO's markup, which is way more readable in plaintext than HTML. (Even the back tick which I never used before, ever).

/**
 * I'm talking about things like <code>Clas开发者_Go百科sName</code> here.
 * <p>
 * And of course the well-known <code>&lt;p&gt;</code>.<br>
 * Should I go on?
 */

Has anyone written some filter thingy which translates SO markup to HTML in the JavaDoc tool chain?

Alternatively as comments any pointers would be welcome how to write extensions to JavaDoc with such functionality (I'm mainly interested in the interface if there is any available).


There appears to be a Markdown Doclet for Javadoc, which should do what you want.

It's made by StackOverflow-user Richard Nichols. He has written a blog post on it, which includes a screenshot, of some example input/output.


MarkdownDoclet is a bit outdated.

For Java 7, use https://github.com/Abnaxos/pegdown-doclet

0

精彩评论

暂无评论...
验证码 换一张
取 消