Włączenia służą do umieszczania fragmentów innych dokumentów w dokumencie użytkownika. Za pomocą języka znaczników określa się dokument i element, który ma zostać włączony. Przed wyświetleniem dokumentu element włączenia jest zastępowany elementem, do którego się odwołuje.
Przykładem mogą być informacje o prawach autorskich umieszczane na końcu każdego udostępnianego dokumentu pomocy. Można je skopiować i wkleić do każdego dokumentu, ale jeśli ulegną zmianie (np. w przypadku zmiany roku ustanowienia praw autorskich), konieczne będzie zmodyfikowanie wszystkich dokumentów.
Zamiast tego informację o prawach autorskich można umieścić w osobnym pliku XHTML pod nazwą copyright.xhtml
, przypisując mu unikalny identyfikator w sposób przedstawiony poniżej.
<p id="copyright"> Copyright 2006 Moja Firma. Wszelkie prawa zastrzeżone. </p>
Następnie w każdym dokumencie umieszcza się następujący akapit dotyczący praw autorskich:
<p> Tekst dokumentu, na końcu którego powinny znaleźć się informacje o prawach autorskich... </p> <include path="identyfikator_wtyczki/ścieżka/copyright.xhtml/copyright"/>
Przed wysłaniem dokumentu do przeglądarki w celu wyświetlenia element include
jest zastępowany akapitem dotyczącym praw autorskich.
Poniżej znajduje się wykaz typów dokumentów, w których można korzystać z zakotwiczeń. Format elementu path
zakotwiczenia zależy od typu dokumentu, z którego pobierana jest treść. Jak widać na powyższym przykładzie, w przypadku dokumentów pomocy XHTML stosowany jest format "<identyfikator_wtyczki>/<ścieżka_do_pliku>/<identyfikator_elementu>"
.
Poniżej znajdują się odsyłacze do informacji dotyczących poszczególnych typów dokumentów.