Cette page de formulaire vous permet d'identifier et de documenter un schéma de point d'extension. Elle vous permet également d'inclure et d'utiliser les grammaires définies par les autres schémas de point d'extension partagés.
Cette page se compose des sections suivantes :
Cette section identifie de manière unique le schéma de point d'extension édité. Le format d'un ID de schéma de point d'extension est le même que l'ID complet de son point d'extension correspondant : <plugin-id>.<point-id>
Editez la zone ID de plug-in pour spécifier la partie du qualificateur de l'ID du schéma de point d'extension unique. La valeur de cette zone doit correspondre à l'ID du plug in dans lequel le point d'extension de schéma correspondant est défini.
Editez la zone ID de point pour spécifier la partie ID de l'ID du schéma de point d'extension unique. La valeur de cette zone doit correspondre à l'ID utilisé pour définir le point d'extension de schéma correspondant.
Editez la zone Nom du point pour spécifier un nom lisible pour le schéma du point d'extension. La valeur de cette zone doit correspondre au nom utilisé pour définir le point d'extension de schéma correspondant.
Elle vous permet également d'inclure et d'utiliser la grammaire définie à partir des autres schémas de point d'extension partagés.
La zone de l'afficheur dresse la liste des schémas de point d'extension partagé dont la grammaire est incluse et utilisée par le schéma de point d'extension édité.
Les schémas de point d'extension partagé situés dans le même plug-in que le schéma de point d'extension édité peuvent être inclus. Ces schémas sont représentés dans l'afficheur par un chemin relatif à leur nom de fichier: <relative-path>/<schema-file-name>
Les schémas de point d'extension partagé situés dans un autre plug-in d'espace de travail que le schéma de point d'extension édité peuvent être inclus. Ces schémas sont représentés dans l'afficheur par un chemin absolu spécial jusqu'à leur nom de fichier: schema://<defining-plugin-id>/<path>/<schema-file-name>
Cliquez sur le bouton Ajouter..., pour ouvrir la boîte de dialogue Sélection de fichier afin d'inclure et d'utiliser la grammaire d'un autre schéma de point d'extension partagé existant dans le schéma édité. La boîte de dialogue présente une vue hiérarchique filtrée de tous les schémas de point d'extension de l'espace de travail. Si un schéma de point d'extension, contenu dans un plug-in différent du schéma édité, est sélectionné, alors un chemin absolu spécial sera construit et saisi dans la zone de l'afficheur. Si un schéma de point d'extension, contenu dans le même plug-in que le schéma édité, est sélectionné, alors un chemin relatif du schéma édité jusqu'au schéma sélectionné sera construit et saisi dans la zone de l'afficheur.
Cliquez sur le bouton Supprimer, pour supprimer la grammaire du schéma de point d'extension partagé sélectionné provenant de l'inclusion et utilisez par le schéma de point d'extension édité. Cette action n'est disponible que lorsqu'un schéma est sélectionné dans la zone de l'afficheur.
Double cliquez sur un schéma de point d'extension de l'afficheur pour ouvrir ce schéma dans un nouvel Editeur de schéma de point d'extension.
Cette section vous permet de documenter le schéma de point d'extension existant. Son contenu sera utilisé pour composer le document de référence du schéma de point d'extension édité. Par conséquent, le marquage HTML valide peut être utilisé dans l'une quelconque des zones de la section.
Cette section contient les onglets suivants :
Editez la zone de l'onglet Description pour spécifier une description détaillée de la définition de point d'extension pour ce schéma édité. En règle générale, cette zone est utilisée pour décrire l'objet du point d'extension, son utilité et les concepts associés.
Editez la zone de l'onglet Depuis pour spécifier la version d'Eclipse à laquelle ce schéma édité a été ajouté pour la première fois. Par exemple, si ce schéma édité a été ajouté pour la première fois à Eclipse 3.0, la valeur de la zone est de 3.0. L'hypothèse de base est que la grammaire du schéma édité est l'API qui persiste version après version une fois qu'elle est introduite et est conservée pour la compatibilité amont. Cette zone est analogue à la balise Javadoc @since de Java.
Editez la zone de l'onglet Exemples pour spécifier un fragment XML valide de l'extension qui est conforme à cette grammaire du schéma édité. Essayez d'utiliser un exemple qui illustre un cas d'utilisation typique de l'extension.
Editez la zone de l'onglet Informations de l'API pour décrire la structure, le contenu et la sémantique des éléments et attributs du point d'extension.
Editez la zone de l'onglet Implémentation fournie pour spécifier si le plug-in qui définir le point d'extension pour ce schéma édité ajoute également les extensions pour lui. Cette zone pointe l'utilisateur vers une implémentation de l'extension réelle qu'il peut utiliser comme modèle ou référence pour définir ses propres extensions.
Editez la zone de l'onglet Copyright pour décrire les droits légaux exclusifs de reproduction, publication, vente ou distribution du schéma édité.