Ankare kan betraktas som motsvarigheten till utökningspunkter för användarhjälpdokument. På samma sätt som komponenter använder utökningspunkter till att göra det möjligt för andra komponenter att utöka funktioner kan dokument använda ankare till att göra det möjligt för andra komponenter att utöka innehållet i användarhjälpen.
Anta att dokumentationen för komponent A innehåller en lista med filformat som kan användas. Om komponent B utökar A:s funktioner så att ett antal format till kan användas kan du placera ett ankare i listan i A och utöka listan från B. Exempel:
<p>I följande lista visas de format som kan användas:</p> <ul> <li>Portable Network Graphics (.png)</li> <li>Joint Photographic Experts Group (.jpeg)</li> <li>Graphical Interchange Format (.gif)</li> <!-- Extra format anges här --> <anchor id="image_format_list"/> </ul>
Komponent B kan lägga till fler format i listan genom att göra ett tillägg till ankaret.
Det beror på typen av dokument. I allmänhet definierar du en utökning som pekar på en XML-fil som innehåller det innehåll som ska läggas till. Följ länkarna i avsnittet nedan om du vill lära dig hur du gör det i den dokumenttyp som du använder:
Nedan finns en lista med de dokumenttyper där include-element kan användas. Formatet för path
-elementet för include-elementet beror på vilken typ av dokument include-elementet hämtas från. Som du kan se i exemplet ovan är formatet för XHTML-hjälpdokument <plugin_id>/<path_to_file>/<element_id>
.
Öppna länkarna nedan om du vill ha information om format för olika dokumenttyper.