A tartalmazások más dokumentumok részeinek adott dokumentumba felvételére használhatók. A kód megadja a felvenni kívánt dokumentumot és elemet, és mielőtt a dokumentum megjelenítésre kerülne a felhasználó számára, a tartalmazás elem helyettesítve lesz azzal elemmel, amelyre hivatkozott.
Elképzelhető például, hogy szerzői jogi részt kíván megjeleníteni minden biztosított dokumentum alján. Átmásolhatja és beillesztheti ezt minden dokumentumba, de ha a szerzői jog módosul (például az éve), akkor a dokumentumok mindegyikét módosítani kell.
Ehelyett a szerzői jogi szöveget megadhatja egy külön
copyright.xhtml nevű XHTML fájlban és egy egyedi azonosítót rendelhet hozzá, például:
<p id="copyright">
Copyright 2006 Saját cég. Minden jog fenntartva.
</p>
Ezután minden dokumentumba egyszerűen szúrja be a szerőzi jog bekezdést:
<p>
Ez az én dokumentumom. Ennek a végén szerzői jogi szövegnek kell szerepelnie.
</p>
<include path="my.plugin.id/path/copyright.xhtml/copyright"/>
Mielőtt a dokumentum elküldésre kerülne a böngészőnek megjelenítésre, az
include elemet a rendszer a szerzői jogi bekezdéssel
helyettesíti.
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.