可以将锚点想象成等同于用户辅助文档的扩展点。与组件使用扩展点来允许其他组件扩展其功能相同,文档可以使用锚点来允许其他组件扩展它们的用户辅助内容。
假定组件 A 的文档提供了它所支持的文件格式列表。如果组件 B 将 A 的支持扩展为支持另外几种格式,则可在 A 的列表中放置锚点并从 B 扩展列表。例如:
<p>The following list shows the supported formats:</p>
<ul>
<li>Portable Network Graphics (.png)</li>
<li>Joint Photographic Experts Group (.jpeg)</li>
<li>Graphical Interchange Format (.gif)</li>
<!-- Extra formats go here -->
<anchor id="image_format_list"/>
</ul>
于是,组件 B 就可以对该锚点添加内容以将更多格式添加到列表中。
这取决于文档的类型。通常,您定义一个扩展以指向要添加的内容所作的 XML 文件。请遵循下一节中的链接以了解如何在所使用的文档类型中完成此任务:
请参阅以下内容以获取允许使用 include 的文档类型列表。include 的
path 元素格式取决于所包括的文档的类型。正如您在以上示例中看到的那样,XHTML
帮助文档的格式是“<plugin_id>/<path_to_file>/<element_id>”。请参阅下列链接以了解您使用的文档类型的格式。