Configuration des parties d'introduction

org.eclipse.ui.intro.config

3.0

Ce point d'extension sert à enregistrer une configuration de partie d'introduction. Cette configuration fournit des implémentations de présentation et un contenu pour une contribution d'introduction donnée. Une introduction apparaît lorsque le plan de travail est démarré pour la première fois et comme choix dans le menu Aide. Elle sert généralement à présenter à l'utilisateur un produit intégré à Eclipse.

Les introductions sont organisées en pages reflétant généralement une catégorie spéciale du matériel d'introduction. Par exemple, la page Nouveautés présente de nouveaux concepts ou fonctionnalités par rapport aux versions antérieures. Le contenu défini par une configuration d'introduction peut être référencé et étendu à partir d'autres plug-ins à l'aide du point d'extension org.eclipse.ui.intro.configExtension.

<!ELEMENT extension (config+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT config (presentation)>

<!ATTLIST config

introId CDATA #REQUIRED

id      CDATA #REQUIRED

content CDATA #REQUIRED>

Un élément de configuration peut être utilisé pour configurer une partie d'introduction personnalisable. Il doit alors préciser un ID, un ID d'introduction et un fichier de contenu. Ce fichier XML décrit les pages, les groupes et les liens dans l'introduction.



<!ELEMENT presentation (implementation+)>

<!ATTLIST presentation

home-page-id    CDATA #REQUIRED

standby-page-id CDATA #IMPLIED>

Elément de présentation définissant toutes les implémentations possibles pour la présentation d'une partie d'introduction. Il peut inclure une ou plusieurs implémentations. Seule une sera toutefois choisie au démarrage en fonction des attributs du système d'exploitation/système de fenêtrage des implémentations. Sinon, la première sans attributs définis est choisie.



<!ELEMENT implementation (head?)>

<!ATTLIST implementation

kind  (swt|html)

style CDATA #IMPLIED

os    CDATA #IMPLIED

ws    CDATA #IMPLIED>

La présentation de l'expérience de la plateforme inclut deux implémentations. L'une est basée sur le navigateur SWT, l'autre sur des formulaires au sein de l'interface utilisateur. La partie d'introduction personnalisable peut être configurée pour choisir l'une de ces présentations en fonction du système d'exploitation et du système de fenêtrage. Le type d'implémentation est swt ou html.



L'exemple ci-dessous illustre l'utilisation du point d'extension config.

<extension id=

"intro"

point=

"org.eclipse.ui.intro.config"

>

<config introId=

"com.org.xyz.intro"

id=

"com.org.xyz.introConfig"

content=

"introContent.xml"

>

<presentation home-page-id=

"root"

title=

"%intro.title"

>

<implementation ws=

"win32"

style=

"css/shared.css"

kind=

"html"

os=

"win32"

>

</implementation>

<implementation style=

"css/shared_swt.properties"

kind=

"swt"

>

</implementation>

</presentation>

</config>

</extension>

Pour en savoir plus, voir la spécification pour le package d'API org.eclipse.ui.intro.config.

L'introduction contribuée par le plug-in org.eclipse.platform est la seule implémentation dans Eclipse.