XHTML súgódokumentumok közreadása

Miért érdemes XHTML-t használni?

A súgórendszer lehetővé teszi dinamikus súgótartalom előállítását, ha a XHTML leírónyelvet feljegyezésekkel látja: speciális címkéket ad a szűrőhöz, a tartalmazásokhoz, és horgonyokat ad meg a kiterjesztésekhez. Ezek a szolgáltatások HTML esetén nem állnak rendelkezésre.

XHTML közreadása

Az XHTML súgódokumentumok közreadása hasonlóképp működik, mint HTML esetén néhány fontos különbség kivételével, amelyeknek a dinamikus tartalom és a keresés támogatása érdekében meg kell lennie. A szükséges módosítások az alábbiak:

XHTML tartalmazási formátum

Ha tartalmazásokat kíván használni az XHTML-ben, akkor a path attribútum formátuma a következő: (magyarázata alább látható)

   <bedolgozó_azonosító>/<xhtml_fájl_elérési_útja>/<xhtml_fájlnév>/<elem_azonosító>

A mezők helye:

Ha például my_copyright azonosítóval kíván felvenni egy bekezdést (<p> elem) a my.product.plugin bedolgozó /copyrights/copyright.xhtml fájljából, akkor a következőt kell megadni:

   my.product.plugin/copyrights/copyright.xhtml/my_copyright