✎ precise-creer-unity-lens [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

====== Créer une loupe Unity ======
<note>Cette page est un début de traduction de l'article [[http://developer.ubuntu.com/2012/04/how-to-create-a-wikipedia-unity-lens-for-ubuntu/|How to create a Wikipedia Unity lens for Ubuntu]] du site officiel d'Ubuntu App Developper.

N'hésitez pas à la compléter si vous en avez le temps ;)</note>

<note tip>Il est recommandé d'avoir des connaissances en Python pour suivre ce tutoriel.\\
Vous pouvez suivre [[http://www.siteduzero.com/tutoriel-3-223267-apprendre-python.html|ce tutoriel sur le Site du Zéro]].</note>
Le Dash Unity propose une manière simple et conviviale de visionner du contenu intéressant. À l'aide des Loupes, il est désormais possible de rechercher une information en local et sur le Web. Dans cet article, nous apprendrons à construire facilement une loupe permettant de chercher confortablement un article de Wikipédia, directement depuis votre Bureau.

===== Prérequis =====
Pour suivre ce tutoriel, vous aurez besoin de :
  * [[precise|Ubuntu 12.04 LTS (« The Precise Pangolin »)]]
  * [[quickly|Quickly]]
  * [[quickly-unity-lens-template|Quickly Unity Lens Template]]

Vous pouvez installer ces deux derniers en un clic **[[apt>quickly,quickly-unity-lens-template|ici]]**.

===== Créer la loupe Wikipédia =====
La création d'une loupe commence par une étape très simple. Ouvrez un terminal et invoquez les commandes suivantes :
<code>quickly create unity-lens wikipedia
cd wikipedia
quickly edit</code>
La dernière ligne de code ouvre Gedit avec trois fichiers. Nous ne nous occuperons que de ''<nowiki>__init__</nowiki>.py'', fermez les deux autres.
==== __init__.py ====
La première chose que nous verrons est la classe Meta. Elle définit le comportement de la loupe :
<code=python>
class Meta:
    name = 'Wikipedia'
    description = 'Wikipedia Lens'
    search_hint = 'Search Wikipedia'
    icon = 'wikipedia.svg'
    search_on_blank=True
</code>
La plupart du temps, lorsque vous créez une loupe simple, il n'est pas nécessaire d'y changer quoi que ce soit. C'est le cas ici.

Une loupe doit faire partie d'une ou plusieurs catégories, qui sera utilisée ensuite pour séparer les différents résultats. Dans le cas de Wikipédia, nous aurons besoin d'une seule catégorie. Appelons-la "Articles".

En-dessous de la classe Meta, vous pouvez voir ceci :
<code=python>
example_category = ListViewCategory("Examples", 'help')
</code>
Modifions-la pour qu'elle corresponde à nos besoins.
  - Renommez la variable en ''articles_category'', pour plus de clarté dans le code
  - Nous devons choisir entre ''ListView'' et ''IconView'', qui sont deux manières différente de présenter les résultats. La première est une vue en liste, la deuxième une vue en icône. Nous garderons la vue par défaut : ''ListView''.
  - Nous devons donner à notre catégorie un nom d'affichage. Ce sera ''Articles''.
  - Pour finir, il faudra une icône pour l'en-tête, nous allons utiliser une icône déjà existante sur votre system : ''dialog-information-symbolic''

<code=python>
articles_category = ListViewCategory("Articles", "dialog-information-symbolic")
</code>

Maintenant que l'architecture de la loupe est prête, nous allons ajouter la fonction qu'elle est supposée remplir : la recherche. Le code par défaut illustre comment faire cela...
<code=python>
def search(self, search, results):
    # TODO: Add your search results
    results.append('https://wiki.ubuntu.com/Unity/Lenses/Singlet',
                'ubuntu-logo',
                self.example_category,
                "text/html",
                'Learn More',
                'Find out how to write your Unity Lens',
                'https://wiki.ubuntu.com/Unity/Lenses/Singlet')
    pass
</code>
...sauf que nous, on veut des résultats provenant de Wikipédia !

===== Chercher sur Wikipédia =====
Créons une nouvelle fonction permettant la recherche Wikipédia, que nous incorporerons ensuite dans le code.

Nous la nomerons ''wikipedia_query'', ce qui semble approprié dans notre cas. Elle prendra en argument la chaîne tapée par l'utilisateur dans la barre de recherche du Dash. Nous aurons également besoin de modules Python pour la recherche : ''urllib2'' pour la requête HTTP et ''simplejson'' pour parser les données renvoyées par Wikipédia.

Au début du fichier, ajoutez ceci :
<code=python>
import urllib2
import simplejson
</code>
Ensuite, dans la classe ''WikipediaLens(SingleScopeLens)'', créez une variable ''wiki'', qui permettra de simplifier le code :
<code=python>
wiki = "http://en.wikipedia.org"
</code>
Puis créez la fonction :
<code=python>
def wikipedia_query(self, search):
</code>
L'argument ''search'' est la chaîne tapée par l'utilisateur dans la barre de recherche du Dash. Nous aurons besoin de la changer un peu avant de l'envoyer à Wikipédia, en remplaçant les espaces par le caractère ''|'' (barre verticale, en **''Alt Gr + 6''** sur un AZERTY et en **''Alt Gr + B''** sur un BÉPO), afin que Wikipédia comprenne la requête.
<code=python>
search = search.replace(" ", "|")
</code>
Créons maintenant la requête en utilisant l'API Opensearch de Wikipédia :
<code=python>
url = ("%s/w/api.php?action=opensearch&limit=25&format=json&search=%s" % (self.wiki, search))
</code>
Et stockons les résultats renvoyés dans une variable ''results''. Ces résultats sont envoyés en JSON, nous utiliserons doncle module simplejson pour le transformer en liste.
<code=python>
results = simplejson.loads(urllib2.urlopen(url).read())
</code>
Insérons une ligne de debug. Il s'agit d'un texte qui sera lisible si le script est ouvert dans une console.
<code=python>
print "Recherche de %s sur Wikipédia..." % (search)
</code>
Nous finissons la fonction en lui faisant retourner quelque chose :
<code=python>return results[1]</code>

Notre fonction ''wikipedia_query'' devrait ressembler au code ci-dessous. On a ici ajouté un ''try'' et un ''except'' afin de prendre en compte des éventuelles erreurs qui pourraient survenir (erreur de réseau, erreur de transmission des résultats, etc.). S'il y a une erreur, un message s'affichera dans la console et une liste de résultats vide sera renvoyée.

**Dès lors, tout ce que nous aurons à faire est de « brancher » cette nouvelle fonction à la fonction ''search'' définie plus haut.**
<code=python>
def search(self, search, results):
    for article in self.wikipedia_query(search):
        results.append("%s/wiki/%s" % (self.wiki, article),
                    "http://upload.wikimedia.org/wikipedia/commons/6/63/Wikipedia-logo.png",
                    self.articles_category,
                    "text/html",
                    article,
                    "Articles Wikipédia",
                    "%s/wiki/%s" % (self.wiki, article))
    pass
</code>
On pourrait traduire ce code par : « À chaque résultat renvoyé renvoyé par la fonction ''wikipedia_query'', ajouter un article à la loupe ».
Ce qui se passe dans ''results.append'' est très important pour comprende ce que nous pourront afficher dans une loupe. Voici ce dont nous avons besoin pour passer les résultats à Unity (**ne copiez pas ce code, il ne fonctionnera pas !**) :
<code=python>
results.append (url,
            icon,
            category,
            mime-type,
            text,
            comment,
            drag and drop url)
</code>
C'est tout, votre loupe est prête !

===== Utiliser votre loupe =====
/FIXME À suivre...

Merci de recopier le code ci-contre pour prouver que vous êtes humain : M Q S J W Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported