Dinamikus tartalom

Mi a dinamikus tartalom?

Számos felhasználósegéd-összetevő lehetővé teszi dinamikus tartalom biztosítását. Ez azt jelenti, hogy a tartalom a felhasználó környezetétől vagy kontextustól függően változhat. Például azt szeretné, hogy a súgódokumentum vagy üdvözlő oldal csak akkor jelenjen meg, ha a felhasználó számára bizonyos funkció engedélyezett.

Két alapvető lehetőség áll rendelkezésre dinamikus tartalom létrehozására. Az egyik, hogy címkéket és attribútumokat (feljegyzéseket) ad az XML leírónyelvhez annak érdekében, hogy a rendszer kiszűrjön részeket vagy dokumentumokat, felvegyen másik dokumentumokból származó részeket vagy horgonyokat adjon meg, hogy más összetevők kiterjeszthessék a dokumentációt.

A másik módszer saját előállító írása Java kód megadásával, amely az elejétől kezdve megírja a tartalmat vagy feldolgozza a meglévő statikus dokumentumokat menet közben. Vizsgáljuk meg mindkét megközelítést.

XML feljegyzések

A legegyszerűbb módszer a dinamikus tartalom létrehozására az XML leírónyelv feljegyzések használata. Egyszerűen adjon néhány speciális attribútumot és címkét az XML leírónyelvhez és a rendszer feldolgozza az utasításokat. A leírónyelv segítségével:

A leírónyelv szempontjaival kapcsolatos további információkért kövesse a fenti hivatkozásokat vagy keresse meg a témaköröket a tartalomjegyzékben.

Ezt az alábbi XHTML kódrész szemlélteti:


<p>
Ez egy statikus bekezdés.
   </p>

<!-- Ez a címke le lesz cserélve a hivatkozott címkére -->
<include path="my.plugin.id/path/my_other_document.xhtml/element_id"/>

<ul>
   <li>
Ez egy statikus listaelem.
   </li>
   <li filter="os=win32">
Ez csak Windows rendszeren jelenik meg.
   </li>
   <li filter="plugin!=org.eclipse.help">
Ez csak akkor jelenik meg, ha az org.eclipse.help NINCS telepítve.
   </li>
</ul>

<!-- Hely, ahol mások is megadhatnak tartalmat -->
<anchor id="my.anchor.id"/>

Tartalom-előállítók

A tartalom-előállító egy mechanizmus Java kód megadására, hogy a dokumentumtartalmat menet közben állítsa elő. A tartalom-előállítók hatékonyabbak, mint az XML feljegyzések, de használatuk bonyolultabb.

A tartalom-előállítókat a felhasználósegéd következő területei támogatják: