Dynaaminen sisältö

Mitä dynaaminen sisältö on?

Useiden käyttäjätukikomponenttien avulla voi tuottaa dynaamista sisältöä. Tämä merkitsee, että kyseinen sisältö voi vaihdella käyttäjän ympäristön tai käyttötilanteen mukaan. Voi olla hyödyllistä, että esimerkiksi tietty ohjeen osa tai esittelysivu näkyy vain, jos käyttäjällä on tietty toiminto käytössä.

Dynaamista sisältöä voi luoda kahdella perustavalla. Yksi tapa on lisätä XML-merkintöihin tunnisteita ja määritteitä (huomautuksia), jotka käskevät järjestelmää suodattamaan osia tai asiakirjoja, sisällyttämään osia muista asiakirjoista tai määrittämään ankkureita, joiden avulla muut komponentit voivat laajentaa dokumentaatiota.

Toinen tapa on kirjoittaa oma sisällöntuottajasäie liittämällä Java-koodia, joka kirjoittaa sisällön alusta alkaen tai käsittelee aiemmin luotuja staattisia asiakirjoja "lennosta". Seuraavassa käsitellään molempia tapoja.

XML-huomautukset

Yksinkertaisin tapa luoda dynaamista sisältöä on käyttää XML-merkintöjen huomautuksia. Tämä merkitsee yksinkertaisesti tiettyjen erityismerkintöjen ja -tunnisteiden lisäystä XML-merkintöihin, ja järjestelmä käsittelee ohjeet. Kyseisten merkintöjen avulla voi tehdä seuraavaa:

Lisätietoja kyseisistä merkintöjen ominaisuuksista saat seuraamalla edellä olevia linkkejä tai hakemalla ohjeaiheet sisällysluettelosta.

Kyseisten merkintöjen käyttöä esitellään seuraavassa XHTML-fragmentissa:


<p>
This is a static paragraph.
   </p>

<!-- Tämä tunniste korvataan viitatulla tunnisteella -->
<include path="my.plugin.id/path/my_other_document.xhtml/element_id"/>

   <ul>
   <li>
      This is a static list item.
   </li>
   <li filter="os=win32">
      This only shows when running on Windows.
   </li>
   <li filter="plugin!=org.eclipse.help">
      This only shows when plugin org.eclipse.help is NOT installed.
   </li>
   </ul>

<!-- Sijoitus, johon muut voivat lisätä sisältöä -->
<anchor id="my.anchor.id"/>

Sisällöntuottajasäikeet

Sisällöntuottajasäie on mekanismi, jonka avulla voidaan liittää asiakirjan sisällön "lennosta" tuottava Java-koodi. Sisällöntuottajasäikeet ovat tehokkaampia kuin XML-huomautukset, mutta niiden käyttö on monimutkaisempaa.

Seuraavat käyttäjätuen osa-alueet tukevat sisällöntuottajasäikeitä: