Ankre

Ankre kan betragtes som ligestillet med et udvidelsespunkt for dokumenter til brugerassistance. På samme måde som komponenter bruger udvidelsespunkter til at til at tillade andre komponenter at udvide deres funktionalitet, kan dokumenter bruge ankre til at tillade andre komponenter at udvide indholdet af brugerassistance.

Antag, at komponent A's dokumentation stiller en liste over filformater til rådighed, som komponenten understøtter. Hvis komponent B udvider A's understøttelse til flere formater, kan du placere et anker i A's liste og udvide listen fra B. Eksempel:

   <p>Følgende liste viser de understøttede formater:</p>
   <ul>
      <li>Portable Network Graphics (.png)</li>
      <li>Joint Photographic Experts Group (.jpeg)</li>
      <li>Graphical Interchange Format (.gif)</li>
      
      <!-- Ekstra formater indsættes her -->
      <anchor id="image_format_list"/>
</ul>
        

Komponent B kan derved bidrage til ankeret og tilføje flere formater til listen.

Indholdsbidrag til et anker

Indholdsbidrag afhænger af dokumenttypen. Generelt definerer du et udvidelsespunkt, der peger på en XML-fil, der indeholder det indhold, der skal tilføjes. Følg linkene i afsnittet nedenfor for at få at vide, hvordan du gør det i den dokumenttype, du anvender.

Anvendelse af ankre

Nedenfor er en liste over de dokumenttyper, hvor inkluderinger kan anvendes. Formatet for elementet sti for en inkludering afhænger af den type dokument, du inkluderer fra. Som vist i eksemplet neden er formatet for XHTML-hjælpedokumenter "<plugin_id>/<path_to_file>/<element_id>". Brug linkene nedenfor til at finde formatet for din dokumenttype.