Esittelyn teemojen määritys

Teema määrittää esittelyn yleisen ulkoasun. Se on yksinkertaisesti keino ryhmittää kaikki esitystiedostot (kuvat ja tyylit) yhteen paikkaan, johon voi viitata ja jota voi muuttaa kerralla.

Määritys

Voit määrittää teeman laajentamalla esittelykokoonpanoa kohteen org.eclipse.ui.intro.configExtension avulla ja käyttämällätheme-elementtiä, kuten seuraavassa esimerkissä kuvataan:

   <extension
         point="org.eclipse.ui.intro.configExtension">
<theme
            default="true"
            id="org.eclipse.ui.intro.universal.circles"
            name="%theme.name.circles"
            path="$nl$/themes/circles"
            previewImage="themes/circles/preview.png">
<property
               name="launchbarBackground"
               value="#a1c2cb"/>
<property
               name="launchbarOverviewIcon"
               value="$theme$graphics/launchbar/overview16.png"/>
<property
               name="launchbarFirststepsIcon"
               value="$theme$graphics/launchbar/firststeps16.png"/>
<property
               name="launchbarTutorialsIcon"
               value="$theme$graphics/launchbar/tutorials16.png"/>
<property
               name="launchbarSamplesIcon"
               value="$theme$graphics/launchbar/samples16.png"/>
<property
               name="launchbarWhatsnewIcon"
               value="$theme$graphics/launchbar/whatsnew16.png"/>
<property
               name="launchbarMigrateIcon"
               value="$theme$graphics/launchbar/migrate16.png"/>
<property
               name="launchbarWebresourcesIcon"
               value="$theme$graphics/launchbar/webresources16.png"/>
      </theme>
	</extension>

Lisätietoja teemoihin liittyvistä määritteistä on skeemaohjeissa.

Kullakin teemalla on yksilöllinen tunnus, käännettävä nimi, esikatselukuva ja polku teeman juurikansioon. Esittelyn lisäosa ei toimita käyttöliittymää teeman käsittelyyn. Ainoa keino valita teema on käyttää oletusasetusta org.eclipse.ui.intro/INTRO_THEME tiedostossa plugin_customization.ini.

Teemojen käyttöönotto

Teeman tuki itsessään ei tarkoita, että teema olisi käytössä esittelyn toteutuksessa. Konkreettiset esittelyn toteutukset voivat käyttää teemoja olennaisemmalla tavalla (yleisen esittelyn toteutus tekee juuri näin oletusasetussivulla Yleiset > Esittely.

Teemaa käyttävän esittelyn toteutuksen on tehtävä kaikki viittaukset tyyleihin ja esityslähteisiin $theme$-korvausmuuttujan avulla. Kuvien, sivujen, tyylien ja muiden kohteiden tarkat polut selvitetään tulkitsemalla korvausmuuttuja käytössä olevan teeman polkua käyttäen.