Pages Bienvenue

Les pages Bienvenue sont utilisées pour familiariser l'utilisateur avec un certain aspect du plan de travail.

Page Bienvenue par défaut

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 :

  1. un attribut de titre facultatif,
  2. un attribut de format facultatif,
  3. une marque facultative <intro>,
  4. 0 ou plusieurs marques <item>.

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 :

  1. du texte (avec sauts de ligne conservés),
  2. des marques de paragraphe (<p>) pour indiquer le texte devant contenir des renvois à la ligne.

    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.

  3. des marques de mise en gras (<b>),
  4. des marques d'action (<action>) contenant les attributs suivants :

    pluginId (l'ID du plug-in contenant l'action),

    class (le nom qualifié de la classe d'action à instancier et à exécuter).

  5. des marques de rubrique d'aide (<topic>) contenant les attributs suivants :

    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>

Copyright IBM Corp. et autres 2000, 2002.