如何在 Eclipse 帮助中创建 Java API 参考文档

构建易用且可供搜索的 Java API 文档

本文介绍了生成易用且可供搜索的 Java 应用程序编程接口（Java application programming interfaces，API）的参考文档的不同方法。所介绍的方法是用我开发的 JavaTOC doclet 生成的 Javadoc 标准解决方案和 Eclipse Plug-in Help System。JavaTOC doclet 生成内容表格（table-of-contents，TOC），使 Javadoc API 参考文档帮助用户很容易地在 API 参考文档中搜索具体类、接口，或方法。

Javadoc API 参考文档需要即是可浏览的，又是可供搜索的。标准的 Javadoc 没有完全提供此能力。充分编制文档的 API 可以满足许多目的，但是最重要的原因是令用户充分了解并搜索他们可用的 API 方法。如果没有适当的编制，或不可供搜索，那么即使是原始的作者可能也不理解源代码了。该解决方案就是要养成编制源代码文档的习惯，并且为 Java API 参考生成可供搜索的结构（TOC 导航）。JavaTOC doclet 通过为参考生成可供搜索的结构来解决此问题。

搜索和浏览假定信息是由特定查询的相关性拣选出来的，生成了许多特定的序列作为结果。举例来说，在标准的 Javadoc 中，对具体方法的描述的 API 信息的搜索返回整个类的描述。

本文转自： IBM developerWorks 中国

请点击此处查看全文http://ibm.youkuaiyun.com/ISN_J.aspx?action=JMP&pointid=2448