錨點

我們可以將錨點設想成相當於使用者輔助文件的延伸點。 如同元件利用延伸點,讓其他元件延伸它們的功能,在相同方式之下,文件也可以利用錨點,讓其他文件延伸它們的使用者輔助內容。

假設 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 檔。 請遵循下一節的鏈結來學習如何在所用的文件類型中執行這個動作:

哪裡可以使用錨點?

請參閱下文,以取得能夠使用併入的文件類型清單。 併入的 path 元素格式會隨著併入的來源文件類型而不同。 如您上述範例中所見,XHTML 說明文件的格式是 "<plugin_id>/<path_to_file>/<element_id>"。 請參閱下面的鏈結,以瞭解文件類型的格式。