集中化Eclipse中的帮助功能 - 编程入门网

图 1. 从通用项目库创建新插件项目

集中化Eclipse中的帮助功能(2)

向导的下一步允许您指定项目的详细信息，如名称和目录结构。此对话框如图 2 所示。

图 2. 指定项目的物理属性

在这种情况下，您只能创建“帮助”插件扩展点。但是，PDE 自带了多种预置的扩展点，其中包括一个用于“帮助”扩展的扩展点。要查看扩展点列表，请在图 2 的 Project Settings 中选中“Create a Java Project”，否则在随后的向导对话框中不会出现示例扩展点。在这种情况下，您将最终创建 Java 代码，因此将选择该选项。如果您只需要创建一个“帮助”扩展，并且要使用预定义的扩展点，那么请保持选中此选项。

下一个向导页面允许您指定关于插件的元信息；如图 3 所示。

图 3. 关于插件的元信息页面

集中化Eclipse中的帮助功能(3)

为了使构建插件变得更方便，PDE 自带了多种模板，其中包括预定义类型的插件。您可以利用这些模板围绕“帮助”插件创建基础结构。图 4 显示了一个向导页面，该页面允许选择模板。

图 4. 插件模板

自定义插件向导提供了多种扩展点，其中有一个是“帮助”扩展，如图 5 所示。

图 5. “帮助”扩展插件模板

集中化Eclipse中的帮助功能(4)

最后，您要选择“帮助”插件将要提供的内容类型，它显示在最后一个向导页面上，如图 6 所示。

图 6. 内容类别的选择表

通过 PDE 向导这一过程的最后结果是形成一个文件集，其中包括 XML、Java 源和构建基础结构。

TOC 的内部

PDE 向导（图 6 所示）的最后一个页面会创建一个 TOC.XML 文件，它是将包含在插件中的那些“帮助”文件的内容表（TOC）。这个 TOC 格式用于 Eclipse 的内部帮助和插件；它始终是一致的。默认情况下生成的 TOC 文件如清单 1 所示。

清单 1. 默认情况下生成的 TOC 文件

<?xml　version="1.0"　encoding="UTF-8"?> <?NLS　TYPE="org.eclipse.help.toc"?> <toc　label="Repository　Table　of　Contents"　topic="html/toc.html"> 　　 <topic　label="Getting　Started"> 　　　 <anchor　id="gettingstarted"/> 　　 </topic> 　　 <topic　label="Concepts"> 　　　 <anchor　id="concepts"/> 　　 </topic> 　　 <topic　label="Tasks"> 　　　 <anchor　id="tasks"/> 　　 </topic> </toc>

注意：在图 6 中创建的标题显示在 <toc> 标记的顶部，它指向 html/toc.html 的主题。 这个 TOC 条目位于帮助集的帮助目录结构中的最高一层。也就是说，实际的帮助 HTML 文件将出现在根目录下指定的目录结构中。通常情况下，为了节省空间，这些 HTML 文件以 zip 文件形式出现（传统上称为 doc.zip）。如果对 Eclipse 插件目录进行搜索，将会看到大量的 doc.zip 文件，其中的每一个文件都包含一个将其合并到 Eclipse 的主帮助中的帮助（无论

凌众科技专业提供服务器租用、服务器托管、企业邮局、虚拟主机等服务，公司网站：http://www.lingzhong.cn 为了给广大客户了解更多的技术信息，本技术文章收集来源于网络,凌众科技尊重文章作者的版权，如果有涉及你的版权有必要删除你的文章，请和我们联系。以上信息与文章正文是不可分割的一部分,如果您要转载本文章,请保留以上信息，谢谢!