Les pages Bienvenue sont utilisées pour familiariser l'utilisateur avec un certain aspect du plan de travail.
Chaque fonction peut contribuer à une page Bienvenue. Il suffit d'inclure un attribut welcomePage dans le fichier about.ini, dans le sous-répertoire du plug-in de la fonction.
welcomePage = $nl$/welcome.xml
La valeur de l'attribut welcomePage est un fichier au
format XML qui définit la page d'accueil.
Le fichier a le format suivant :
marque <welcomePage> avec :
La marque format peut avoir la valeur "wrap" ou "nowrap". Si l'attribut de format est "wrap", le texte contenu dans l'éditeur de bienvenue (Welcome Editor) sera renvoyé à la ligne de façon à s'adapter à la taille de sa fenêtre. Notez que les sauts de ligne présents dans le texte seront conservés lors du processus de renvoi à la ligne à moins que des marques de paragraphe (<p>) ne soient utilisées. Si l'attribut de format n'est pas spécifié, la valeur par défaut "nowrap" sera utilisée.
Les marques intro et item peuvent contenir les éléments suivants :
Le texte compris entre les marques <p> sera traité comme une ligne continue (c'est-à-dire que les sauts de ligne du texte <p> seront "virtuels"). La marque <p> ne s'applique que lorsque l'attribut de format a pour valeur "wrap". Si le format = "nowrap", les marques de paragraphe sont ignorées.
pluginId (l'ID du plug-in contenant l'action),
class (le nom qualifié de la classe d'action à instancier et à exécuter).
id (l'ID de l'ensemble d'informations à afficher dans l'afficheur d'aide),
href (Facultatif. URL de rubrique d'aide valide, contenue dans l'ensemble d'in formations spécifié et ayant le format suivant :
/pluginID/path_to_document)
Notez que le texte compris entre les balises de début et de fin destiné aux actions et aux rubriques d'aide apparaît sous forme de lien mis en évidence.
Voici un exemple de page de bienvenue. Le texte du deuxième élément contiendra des renvois à la ligne.
<?xml version="1.0" encoding="UTF-8" ?> <welcomePage title="Plateforme Eclipse" format = "wrap"> <intro>Cette page permet de se familiariser avec le plan de travail d'Eclipse. Pour commencer, lisez les sections ci-après et cliquez sur les liens connexes. </intro> <item><b>Fonctions installées</b> Pour en savoir plus sur les fonctions installées dans votre plan de travail, choisissez <action pluginId="org.eclipse.ui" class="org.eclipse.ui.internal.QuickStartAction">Aide > Bienvenue...</action> et sélectionnez la fonction qui vous intéresse.</item> <item><b>Perspectives, vues et éditeurs </b> <p>Une fenêtre contient une ou plusieurs perspectives. Une perspective est composée de vues (par exemple, Navigateur) et d'éditeurs permettant de travailler avec les ressources. La barre de raccourcis, à l'extrême gauche de la fenêtre, permet d'ouvrir de nouvelles perspectives et de se déplacer entre les perspectives déjà ouvertes. La perspective utilisée s'inscrit dans la barre de titre de la fenêtre et son icône est activée dans la barre de raccourcis.</p></item> <item><b>Configuration de perspectives</b> Vous pouvez déplacer les vues et les éditeurs dans le plan de travail en faisant glisser leur barre de titre. Vous pouvez également ajouter des vues supplémentaires dans votre perspective actuelle à l'aide de l'option Fenêtre > Afficher la vue. Pour réinitialiser la vue, choisissez <action pluginId="org.eclipse.ui" class="org.eclipse.ui.internal.ResetPerspectiveAction">Fenêtre > Réinitialiser la perspective</action>. Une fois que vous avez organisé votre perspective, vous pouvez la sauvegarder à l'aide de l'option Fenêtre > Sauvegarde de la perspective sous... Vous pouvez personnaliser les vues, les perspectives et les nouvelles opérations de menu affichées pour votre perspective. Pour cela, choisissez <action pluginId="org.eclipse.ui" class="org.eclipse.ui.internal.EditActionSetsAction">Fenêtre > Personnaliser la perspective...</action>. Une vue peut également être convertie en Vue rapide en la faisant glisser dans la barre de raccourcis (à l'extrémité gauche de la fenêtre). </item> <item><b>Pour en savoir plus </b> Pour en savoir plus, vous pouvez consulter le document <topic id="/org.eclipse.platform.doc.user/toc.xml">Plan de travail - Guide de l'utilisateur</topic>.</item> </welcomePage>