Créer un dépôt d'extensions pour QGIS

Une fois le plus dur fait (la création d'une extension QGIS en Pyhton), pourquoi ne pas en faire profiter la terre entière ?

Il y a plusieurs manières de le faire, à commencer par proposer le code de l'extension en téléchargement sur un forum, un blog, une page perso, etc. C'est bien mais il est possible de faire beaucoup mieux !

QGIS dispose d'un système de récupération d'extensions qui permet de scanner une série de dépôts, de récupérer les extensions qui y sont stockées et de les installer ou de les mettre à jour. Ce système permet donc aux développeurs de diffuser automatiquement aux utilisateurs ses extensions et leurs mises à jour.

Les dépôts QGIS

Il y a plusieurs types de dépôt :

• le dépôt officiel, "QGIS Official Repository" (http://pyqgis.org/repo/official) : il ne contient aujourd'hui que deux extensions dont l'indispensable "Plugin Installer"

• le dépôt d'extensions dédié aux contributeurs, QGIS Contributed Repository (http://pyqgis.org/repo/contributed) : il contient une liste bien fournie d'extensions dont "Table manager" par exemple.

Ces deux dépôts sont déjà référencés dans QGIS au moment de l'installation mais le dépôt des contributeurs n'est pas activé par défaut.

Au delà de ces deux types de dépôt, il est possible d'en ajouter d'autre en fournissant une URL. Cette URL doit pointer sur un fichier XML qui liste les extensions du dépôt ainsi que quelques informations sur chaque extension.

Le dépôt : un fichier XML

Le fichier XML d'un dépôt doit respecter une structure bien précise. Voici un exemple de dépôt contenant une extension, la structure minimale conseillée que le fichier XML correspondant doit avoir est la suivante :

<?xml version = '1.0' encoding = 'ISO-8859-1'?>
<plugins>
     <pyqgis_plugin version="1.0" name="Mon extension" >
         <description>Un texte court décrivant l'extension</description>
         <homepage>http://www.monsite.fr</homepage>
         <file_name>monextension.zip</file_name>
         <author_name>Mon Nom</author_name>
         <download_url>http://www.monsite.fr/qgis/plugins/monextension.zip</download_url>
         <qgis_minimum_version>1.0.0</qgis_minimum_version>
         <experimental>true</experimental>
      </pyqgis_plugin>
</plugins>

Pour chaque extension référencée dans le fichier XML, il faut donc indiquer :

• le nom de l'extension, le même que celui donné dans le fichier __ini__.py,

• le numéro de version de l'extension,

• une courte description de l'extension,

• le lien vers la page du projet (cette balise n'est pas indispensable),

• le nom du fichier zip contenant le code de l'extension (cette balise n'est pas indispensable),

• le ou les auteurs,

• le lien vers le fichier zip qui contient le code de l'extension,

• le numéro de version minimale de QGIS qu'il faut avoir pour faire fonctionner l'extension,

• si le plugin est expérimental ou non ("true" ou "false").

En réalité, en plus du nom et de la version de l'extension, seules les balises "download_url" et "qgis_minimum_version" sont obligatoires.

Le fichier zip doit contenir l'ensemble des fichiers de code et tous les autres fichiers nécessaires au bon fonctionnement de l'extension (fichiers d'aide, images, etc.). Il faut retirer les fichiers python compilés (.pyc).

Dans cet exemple, une seule extension est présente dans le dépôt, elle est définie par les balises <pyqgis_plugin version="1.0" name="Mon extension" > et </pyqgis_plugin > ainsi que toutes celles comprises entre. Pour ajouter des extensions au dépôt il suffit donc d'ajouter ces ensembles de balises à l'intérieur de <plugins> </plugins> en respectant la même hiérarchie et de ne pas oublier d'ajouter les fichiers zip de chaque extension.

Ajouter le dépôt à QGIS

Le fichier XML ainsi que le ou les fichiers zip doivent être accessibles via internet. Il n'y a plus qu'à indiquer à QGIS l'adresse du fichier XML pour ajouter le dépôt et ses extensions. Cela ce fait dans le menu "Extension / Récupération des extensions en Python" puis onglet "Dépôt" bouton "Ajouter...". La fenêtre demande un nom du dépôt ainsi que l'URL qui pointe sur le fichier XML. La case "Activé" doit rester cochée. Ces informations pourront être éditées par la suite (bouton "Éditer...") et seront gardées en mémoire par QGIS pour les prochaines sessions.

Fenêtre permettant d'ajouter un dépôt d'extensions à QGIS

Si vous avez des extensions expérimentales, n'oubliez pas de cocher l'option  "Afficher toutes les extensions, même celles encore expérimentales" dans l'onglet "Options" pour qu'elles apparaissent dans la liste des extensions.

Fenêtre d'options de l'installateur d’extensions QGIS

Le dépôt est donc maintenant créé et ajouté à QGIS.

Mettre en forme la page du dépôt

Il est possible d'aller plus loin et de créer une véritable page internet à partir du fichier XML, ce qui permettra de présenter le dépôt de manière plus esthétique qu'un simple fichier texte ou de l'intégrer à un site internet existant. Il s'agit ici d'utiliser le fichier XSL dont le lien est à rajouter en entête du fichier XML :

<?xml version = '1.0' encoding = 'ISO-8859-1'?>
<?xml-stylesheet type="text/xsl" href="http://www.monsite.fr/qgis/plugins/depot.xsl" ?>

Ce fichier se présente comme un fichier html avec ses balises header, body etc. et il va permettre d'extraire les informations voulues du fichier XML et de les mettre en forme.

<?xml version="1.0" encoding="ISO-8859-1"?>
 
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
 
<xsl:template match="/plugins">
 
 
<html>
 
<head>
 
<title>Le titre de ma page internet</title>
 
</head>
 
<body>
 
<xsl:for-each select="/plugins/pyqgis_plugin">
 
<div class="plugin">
 
<div class="head">
 
<xsl:value-of select="@name" /> : <xsl:value-of select="@version" />
 
</div>
 
<div class="description">
 
<xsl:value-of select="description" />
 
</div>
 
<div class="download">
 
Download:
 
<xsl:element name="a">
 
<xsl:attribute name="href">
 
<xsl:value-of select="download_url" />
 
</xsl:attribute>
 
<xsl:value-of select="file_name" />
 
</xsl:element>
 
</div>
 
<div class="author">
 
Author: <xsl:value-of select="author_name" />
 
</div>
 
<div class="QGISversion">
 
QGIS minimum version needed: <xsl:value-of select="qgis_minimum_version" />
 
</div>
 
<div class="experimental">
 
Experimental: <xsl:value-of select="experimental" />
 
</div>
 
</div>
 
</xsl:for-each>
 
</body>
 
</html>
 
 
</xsl:template>
 
</xsl:stylesheet>

Il reste à préciser le style de la page. Pour cela, le plus simple est de créer un fichier css qui contiendra les éléments de style (couleurs, polices, marges, etc.) et d'ajouter le lien vers ce fichier dans la balise "head" du fichier XSL :

<head>

  <title>Le titre de ma page internet</title>

  <link rel="stylesheet" href="xsl.css" type="text/css" />

</head>

Voici un exemple de fichier css simple :

body {
 
font-family:Verdana, Arial, Helvetica, sans-serif;
 
width: 50em;
 
}
 
div.plugin {
 
background-color:#FFFFDF;
 
clear:both;
 
display:block;
 
padding:0 0 0.5em;
 
margin:1em;
 
}
 
 
div.head {
 
background-color:#426b81;
 
border-bottom-width:0;
 
color:#FFF;
 
display:block;
 
font-size:110%;
 
font-weight:bold;
 
margin:0;
 
padding:0.3em 1em;
 
}
 
 
div.description{
 
display: block;
 
float:none;
 
margin:0;
 
text-align: left;
 
padding:0.2em 0.5em 0.4em;
 
color: black;
 
font-size:100%;
 
font-weight:normal;
 
}
 
 
div.download, div.author, div.experimental, div.QGISversion{
 
font-size: 80%;
 
padding: 0em 0em 0em 1em;
 
}

Pour étoffer la présentation des extensions de ce dépôt, il est possible de rajouter des informations au fichier XML en suivant la même logique que pour les autres éléments. Ces éléments d'informations supplémentaires ne seront pas utilisés dans QGIS mais pourront s'afficher sur la page internet du dépôt.