Horgonyok

A horgonyok olyan kiterjesztési pontok, amelyek minden felhasználósegéd-dokumentum esetén egyeznek. Ugyanúgy, ahogy az összetevők kiterjesztési pontokat használnak annak lehetővé tételéhez, hogy más összetevők kiterjeszthessék a funkcionalitásukat, a dokumentumok horgonyokat használhatnak annak lehetővé tételéhez, hogy más összetevők kiterjesszék a felhasználósegéd-tartalmat.

Tegyük fel, hogy az 'A' összetevő dokumentációja az általa támogatott fájlformátumok listáját tartalmazza. Ha a 'B' összetevő kiterjeszti az 'A' támogatását több formátumra, akkor egy horgonyt helyezhet az 'A' listájába és kiterjesztheti a listát a 'B' által. Például:

   <p>A következő lista a támogatott formátumokat jeleníti meg:</p>
   <ul>
      <li>Portable Network Graphics (.png)</li>
      <li>Joint Photographic Experts Group (.jpeg)</li>
      <li>Graphical Interchange Format (.gif)</li>
      
      <!-- Ide az extra formátumok kerülnek -->
      <anchor id="image_format_list"/>
   </ul>

A B összetevő kiegészítheti a horgonyt, hogy több formátumot adjon a listához.

Hogyan adható tartalom egy horgonyhoz?

Ez a dokumentum típusától függ. Megad egy kiterjesztést, amely a hozzáadni kívánt tartalmat tartalmazó XML fájlra mutat. Kövesse a részben lévő hivatkozásokat annak megismeréséhez, hogy a használt dokumentumtípusban ez hogyan hajtható végre:

Hol használhatók horgonyok?

Az alábbi lista azon dokumentumtípusokat tartalmazza, amelyekben tartalmazások használhatók. A tartalmazás path elemének formátuma azon dokumentum típusától függ, amelyből a tartalmazott elem származik. Ahogy a fenti példában látható, az XHTML súgódokumentumok formátuma: "<bedolgozó_azonosító>/<fájl_elérési_út>/<elem_azonosító>". A dokumentumtípus formátumáért tekintse meg az alábbi hivatkozásokat.