Definér introduktionstemaer

Temaet definerer det generelle udseende af introduktionen. Det er simpelthen en måde at gruppere alle præsentationsfiler (typografier og billeder) på ét sted, der peges på eller skiftes til.

Definition

For at definere temaet skal du udvide introduktionskonfigurationen vha. org.eclipse.ui.intro.configExtension og bruge elementet tema som vist i eksemplet nedenfor:

   <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>

Se detaljer om alle tilgængelige attributter i forhold til temaer i skemadokumentation.

Hvert tema har en entydig id, et navn, der kan konverteres, et billede til fremvisning og en sti til rodtemafolderen. Introduktionsplugin'en stiller ikke en UI til rådighed for temamanipulation. Den eneste måde at vælge et tema på er via indstillingen org.eclipse.ui.intro/INTRO_THEME i plugin_customization.ini.

Aktivér temaer

Temaunderstøttelsen selv gør ikke introduktionsimplementeringer temaaktiverede. Konkrete introimplementeringer kan vælge et eksponere temaer på mere end én substantiel måde, og faktisk gør Universal Welcome-implementeringen netop dette med indstillingssiden Generelt > Velkommen.

Temaaktiverede introduktionsimplementeringer skal udfærdige alle referencer til typografi og præsentationsressourcer vha. substitutionsvariablen $theme$. Absolutte stier til billeder, sider, typografier osv. skal behandles ved at opløse substitutionsvariablen vha. stien til det aktuelt aktive tema.