因为我们已经具有样本内容文件,所以可以创建主题文件了。主题文件通过将主题标识和标号映射至其中一个 HTML 文件中的引用来将键输入点定义到 HTML 内容文件中。主题文件充当一组 HTML 内容的目录。
迁移到平台的应用程序可以通过使用主题文件来将输入点定义到该文档中来重复使用现有文档。
插件可以具有一个或多个主题文件。主题文件有时也称为导航文件,因为它们描述如何浏览 HTML 内容。我们的示例文档分成三个主要类别:概念、任务和引用。如何生成表示此结构的主题文件:
可以生成一个大型主题文件,也可以为每种主要类别的内容创建单独的主题文件。应当根据文档小组在一起工作的方式来作出决定。如果每个类别由不同的作者所有,则为每个类别保存不同的主题文件可能回更好一些。它不是由平台体系结构来控制的。
在此示例中,将为每个主要的内容类别创建主题文件。对于这样的少量文件,可能不需要让每个类别保存不同的主题文件。在此示例中,将假设我们具有许多文件或者具有拥有每个内容类别的不同作者。
我们的文件为如下所示;
<topics id="conceptsAll">
<topic label="Concept1" href="doc/concepts/concept1.html">
<topic label="Concept1_1" href="doc/concepts/concept1_1.html"/>
<topic label="Concept1_2" href="doc/concepts/concept1_2.html"/>
</topic>
</topics>
<topics id="tasksAll">
<topic id="plainTasks" label="Plain Stuff">
<topic label="Task1" href="doc/tasks/task1.html"/>
<topic label="Task2" href="doc/tasks/task2.html"/>
</topic> <topic id="funTasks" label="Fun Stuff" >
<topic label="Task3_1" href="doc/tasks/task3_1.html"/>
<topic label="Task3_2" href="doc/tasks/task3_2.html"/>
</topic>
</topics>
<topics id="refAll">
<topic label="Ref1" href="doc/ref/ref1.html"/>
<topic label="Ref2" href="doc/ref/ref2.html"/>
</topics>
主题是作为主题容器元素的一部分来添加的。主题可以与内容进行简单链接。例如,“Task1” 提供标号和链接至内容的 href。主题也可以是没有它自己的内容的副主题的分层分组。例如,“Fun Stuff”只有标号和副主题,而没有 href。主题也可以两者都有。“Concept1”具有 href 和副主题。
当用作链接时,假定 href 中的自变量是相对于当前插件的。
当我们开始将这些主题安排到整个文档 Web 中时,将根据它们的标识来引用它们。只能处理具有标识的主题。要安排特定主题的所有副主题,我们可以安排父主题。例如,安排“Concept1”还将安排“Concept1_1”和“Concept1_2”。
稍后,我们将修改 plugin.xml,以向这些文件添加实际的添加点。