3

I want to automatically generate documentation for a java project, but I'd like to have my own custom styling for it.

As an example, take the stackoverflow api (method description page), can that be done by an automated tool? Can it "take me close" to that?
I wouldn't mind having to manually change a few things to achieve the result I want (ie: it doesn't have to be 100% automated)

3
  • NaturalDocs and Doxygen are pretty configurable. I admit I never really stray past the default formatting because it's usually good enough, but it's probably possible. Commented Jul 8, 2011 at 19:44
  • Doxygen seems pretty good, have you used that one? Did you have any problems?
    – juan
    Commented Jul 8, 2011 at 20:02
  • I used it a long time ago for C++ (not Java). It was good, but I didn't try any customization, just ran it "out-of-the-box" and it was good enough. I haven't looked, but maybe you can even customize the output of javadoc, might be as simple as an XSL or CSS file... EDIT: here ya go! download.oracle.com/javase/1.4.2/docs/tooldocs/javadoc/… Commented Jul 8, 2011 at 20:04

2 Answers 2

3

Doxygen and NaturalDocs are both customizable alternatives to Javadoc. Javadoc can also be customized, as is described here: http://download.oracle.com/javase/1.4.2/docs/tooldocs/javadoc/overview.html

...though be warned, I have never attempted this myself, I only found it via web search for "javadoc customize output".

1

As Frustrated notes, a Doclet allows you to customize the the existing Javadoc mechanisms. Doing "Javadoc with a twist" probably has some benefits in terms of IDE integration too.

In particular, given the use of markdown on stackexchange sites, you may want ot see this one that handles markdown, which may be some useful code to look at even if it isn't the formatting rules you want.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.