集中化 Eclipse 中的帮助功能
2009-12-13 00:00:00 来源:WEB开发网注意:在图 6 中创建的标题显示在 <toc> 标记的顶部,它指向 html/toc.html 的主题。 这个 TOC 条目位于帮助集的帮助目录结构中的最高一层。也就是说,实际的帮助 HTML 文件将出现在根目录下指定的目录结构中。通常情况下,为了节省空间,这些 HTML 文件以 zip 文件形式出现(传统上称为 doc.zip)。如果对 Eclipse 插件目录进行搜索,将会看到大量的 doc.zip 文件,其中的每一个文件都包含一个将其合并到 Eclipse 的主帮助中的帮助(无论何时调用该帮助)。
TOC 文件中的其他条目指向与第一个 TOC 同时生成的其他的 TOC。其中有“gettingstarted”、“concepts”和“tasks”。这些二级 TOC 条目中的每一个在项目中都有对应的 XML 文件目录。另外在该项目中,PDE 还为 HTML 文件内容创建了适当的目录结构。在图 7 中,从 Package explorer 截取的片断明显地表现出了这种情况。
图 7. PDE 构建 XML 配置文件和目录结构。
由于有了这个结构,您可以用适当的结构创建满足您需要的多个帮助文件,并将他们放入 zip 文件中,这样就可以通过 Eclipse 中的帮助系统浏览器将他们完美地合并成一个文件。
构建外部存储库
知道了 Eclipse 中帮助文件的结构方式之后,您会检查如何将它外部化到独立的服务器中。Eclipse 通过提供一个称为 Infocenter(与 Eclipse 一起安装)的工具简化了这一过程。您可能已猜到,Eclipse 中的帮助系统实际上是由嵌入 Web 服务器/servlet 引擎驱动的。事实上,它将拆分式版的 Apache Tomcat 用作帮助应用服务器。Eclipse 附带的一个插件是 org.eclipse.help.appserver_3.0.0,它可以封装 Web 服务器。Infocenter 使应用服务器外部化,这样您可以在 Eclipse 环境之外对其进行操作。
更多精彩
赞助商链接