如何生成Java API文档(A Letter to Mariana Alupului)

Hi malupulu,

 This is a letter from China.

I read your paper about JavaTOC doclet on ibm.com, and I got some question to ask you.

Now what I saw Java API documents are all .html format , can I get a .chm one? And where I can get this?

 If  I can’t get one, can I make a .chm one myself ? And can I publish it on internet? Thank u very much.

I’m a fresh man on Java develop, and with great interesting in  java and eclipse, thank you for your answer.

Best wishes.

Lawrence.

*****************************************************************************************************

Hello reader from China,

To create a .chm file you need the .hhc and hhp files (XML files) and of course the Java API HTML files. You can use Microsoft HTML Help to compile them in a .chm format. You need to be familiar with how to manually create the .hhc and .hhp files from TOC.xml file (generated with JavaTOC tool).

 My suggestion is to use the DITA Java API specialization that generates automatically the .chm, pdf  Eclipse XHTML format files. You can use the public DITAOTI  that includes the Java DITA API specialization http://sourceforge.net/project/showfiles.php?group_id=132728 . Also, look on devWorks for my future articles that will describe new ideas and tools about to use DITA Java API solution to generate different formats (.chm, pdf with or without access to the Java source code).

Cheers,

Mariana Alupului

Information Development

 IBM Software Group

 Rational Software

[email protected]

 "Logic will get you from A to B. Imagination will take you everywhere" - Albert Einstein