帮助服务器和文件位置

平台利用它自己的文档服务器来为插件文档提供实际的 Web 页面。定制服务器允许平台以独立于浏览器的方式来处理 HTML 内容和提供插件所需的支持。对于作为插件开发者的您来说,主要的区别就是您在构造文件和指定链接的方式上将具有更大的灵活性。

可以用压缩文件来交付文档,避免提供大量文件时可能导致的问题。在示例插件中,创建了一个称为 html 的子目录。或者,我们可能已经将 HTML 文件放入称为 doc.zip 的压缩文件中。此压缩文件必须模拟插件目录下面的文件结构。在我们的示例中,它必须包含 html 子目录以及 html 下面的所有内容。

解析文件名时,帮助服务器会在插件目录本身中查找文档之前在 doc.zip 文件中查找这些文档。当用作链接时,假定 href 中的自变量是相对于当前插件的。考虑以下链接:

   <topic label="Ref1" href="html/ref/ref1.html"/>

帮助插件将如下查找此文件:

可以使用全限定链接来引用 Web 上的任何内容。 

   <topic label="Ref1" href="http://www.example.com/myReference.html"/>

本地语言和已转换文档

平台帮助系统使用与其余平台查找已转换文件相同的本地语言目录查找方案。(参见语言环境特定文件,以获得目录结构的解释。)若您使用 doc.zip 文件,则应为每个语言环境生成 doc.zip 文件,并将其置于正确的语言环境目录中。(您不应在压缩文件中复制 nl 语言环境目录结构。)

交叉插件引用

href 自变量还可引用另一个插件的内容。这是通过使用特殊的交叉插件引用表示法来完成的,该方法由帮助服务器解析:

   <topic label="Ref1" href="../"another_plugin_id"/ref/ref1.html"/>

例如,您可以使用以下主题链接本章程序员指南:

   <topic label="Help Chapter in Platform Doc" href="../org.eclipse.platform.doc.isv/guide/help.html"/>

注:当引用另一个插件的内容时,确保使用插件的标识(如在其 plugin.xml 文件中所声明的),而不是目录名。由于实际情况下它们通常是相同的,因此检查您在使用标识而不是目录名很重要。

 

Copyright IBM Corporation and others 2000, 2003.