FR/Documentation/How Tos/Installation/CreerExtension
Contents
Comment créer une extension - Application à une extension pour la Gallery
Étapes à suivre
Une extension permet d'ajouter des fonctionnalités à OOo. Parmi les extensions les plus téléchargées, citons :
- les dictionnaires d'orthographe, de synonymes ou de césure
- l'import ou l'export de fichiers dans d'autres formats : PDF, SVG
- l'ajout de thèmes à la Gallery
Quelle que soit l'extension que l'on veut construire les étapes à suivre sont les mêmes :
- rassemblement des fichiers dans un répertoire
- configuration des fichiers de description
- construction de l'extension
- diffusion de l'extension
Nous allons présenter ici la construction d'une extension pour ajouter des images dans la Gallery.
Préparation des images
Pour diffuser des images que l'on veut utiliser régulièrement dans OOo, la solution la plus simple consiste à construire une extension qui va ajouter un ou plusieurs thèmes à la Gallery contenant ces images. Ces images peuvent être suivant différents formats :
- image par points issue d'un fichier PNG, JPEG, GIF, BMP, TIFF, etc.
- image vectorielle construite avec des objets de dessin de Draw : rectangles, ellipses, segments,...
Il faut donc rassembler les images dans un thème :
- affichez la Gallery par le menu Outils > Gallery
- cliquez sur le bouton Nouveau thème
- renseignez le nom et notez l'emplacement (ce sera nécessaire pour retrouver le fichier)
- validez par OK
Vous avez maintenant un nouveau thème qui est vide. Ajoutez les images que vous souhaitez y mettre. Pour les fichiers images par points, il n'est pas conseillé d'utiliser la méthode d'ajout direct dans le thème :
- clic droit sur le nom du thème > Propriétés, onglet Fichiers,
- bouton Recherche de fichiers pour parcourir le disque
- bouton Ajouter
En effet, par cette méthode, seul un lien est ajouté dans le thème, et cela compliquera l'insertion dans l'extension. Il vaut donc mieux importer le fichier par le menu Insertion > Image > À partir d'un fichier dans un document Draw par exemple, puis d'ajouter l'image dans le thème comme pour une image vectorielle :
- ajustez le zoom et les ascenseurs pour visualiser l'ensemble de l'image à insérer
- cliquez de façon prolongée sans bouger sur l'image. Au bout de quelques secondes, l'image a été mise en mémoire par OOo : une légère modification de la bordure s'est opérée
- sans relâcher, faites glisser dans le thème.
Si cette étape échoue (l'image est déplacée dans le dessin) il faut recommencer l'étape précédente : vous n'avez probablement pas attendu assez longtemps. Pour vérifier que toutes vos images sont bien dans le thème, cliquez sur chacune, et vous devriez voir un nom du type dd2954. Si un chemin apparait, c'est que l'image n'est pas réellement dans le thème, mais qu'il n'y a qu'un lien vers un fichier. Ceci compliquera grandement la construction de l'extension. Dans ce cas, il faut faire glisser l'image à partir du thème vers un document Draw, puis la réinsérer dans le thème comme précédemment.
Lorsque toutes les images souhaitées ont été insérées, vous avez la possibilité de leur donner un nom :
- clic droit sur l'image dans le thème > Titre
Ce titre est purement informatif pour l'utilisateur, il n'a pas besoin d'être unique.
Rendez-vous ensuite à l'emplacement repéré lors de la création du thème et récupérez les 3 fichiers constituant chaque thème : sgxxxx.sdg
, sgxxxx.sdv
et sgxxxx.thm
. xxxx
étant le numéro du thème. Ce numéro a besoin d'être unique dans un même répertoire. Comme l'extension va créer ses propres répertoires, il n'est pas nécessaire que le numéro soit unique pour tous les thèmes d'un utilisateur.
Construction des fichiers de configuration
Une extension est consitué d'un seul fichier d'extension .OXT. Comme tous les fichiers au format OpenDocument, il s'agit d'un fichier compressé. Pour construire une extension, le mieux est de récupérer une extension du même type que celle que l'on veut construire. Par exemple, pour ajouter un thème de gallery, récupérons l'extension d'OxygenOffice depuis le site des extensions http://extensions.services.openoffice.org/ N'installez pas directement l'extension, mais enregistrez le fichier. Dézippez le fichier dans un nouveau répertoire (au besoin changez l'extension du fichier en .ZIP). Dans ce répertoire vous retrouvez tous les fichiers de configuration de l'extension. Il faut repérer ce qui est indispensable au fonctionnement de l'extension et ce qui est ajouté par l'extension.