Clément Delafargue

Rédiger un document en français avec Sphinx

divarvel — Fri, 16 Sep 2011 12:58:28 +0200

Je suis en train de finir la rédaction de mon rapport de stage. J'ai utilisé sphinx, l'outil de documentation de python, ce qui me permet de rédiger le rapport en ReST, puis de l'exporter dans un des formats disponibles (LaTeX, HTML, ePub…).

Le fichier de configuration permet de spécifier la langue du document, mais il y a d'autres options à changer pour que l'export LaTeX se passe bien.

language = 'fr_FR'

latex_elements = {
"fncychap": "\\usepackage[Sonny]{fncychap}"
"babel": "\\usepackage[francais]{babel}"
}

TypeSafe URLs in Lift

divarvel — Wed, 03 Aug 2011 16:07:45 +0200

I've been working for a few months with Lift, a really nice web framework. Lift takes ideas and concepts from a few other frameworks. The main difference between Lift and other frameworks is that Lift does not enforce MVC (even though you can do MVC if you want to). Lift's approach is view-first, which means you first create the view, then you tell which part of the code will take care of dynamism.

For more propaganda: Seven Things and Web Framework Manifesto

I'll explain how to build REST-y URLs in a type-safe manner, with the SiteMap. The goal is to access a blog post with this kind of URL: /posts/{id}

I'll illustrate this article with something tremendously original: a Blog, with posts. I'll use mongoDB as a backend, but it's not really important.

The model

It's a simple blog post. Let's just assume the author is stored in plain text.

class BlogPost private() extends MongoRecord with ObjectIdPk[BlogPost] {
def meta = BlogPost
object author extends StringField(this, 32)
object date extends DateField(this)
object content extends TextareaField(this, 500)

val url = … // We'll see that later
}

object BlogPost extends BlogPost with MongoMetaRecord[BlogPost] {
val entry = … // We'll see that later
def calcHref(bp: BlogPost) = … // We'll see that later
}

The template

Nothing special there. Just save it in webapp/posts.html. We have a h1 for the title, a p for some info, and a p for the actual post.

class="lift:surround?with=default;at=content">
class="lift:BlogPostSnippet">
class="title"></h1>
class="info"></p>
class="blogpost"></p>

The snippet

This class will be instantiated with the blog post we want to display. We just inject data in the markup.

class BlogPostSnippet(val blogPost: BlogPost) {
def render = ".title *" #> blogPost.title.is &
".info *" #> ("By " + blogPost.author.is) &
".blogpost *" #> blogPost.content.is
}

The SiteMap

So, back to BlogPost.entry, where the magic happens. We define an entry of the sitemap which is associated with the BlogPost class. The two first arguments are the id and the displayed name of the link. The third argument is a function which takes a String and returns a Box[BlogPost]. This tells Lift how to instantiate BlogPostSnippet with the right blog post. The fourth argument is used to create an url from a given blog post. Finally, we specify the address and tell Lift we don't want this entry to show up in the menus.

The calcHref method is just a shortcut.

class BlogPost … {
/* Snip */
val url = BlogPost.calcHref(this)
}

object BlogPost … {
val entry = Menu.param[BlogPost](
    "blogpost",
S ? "blogpost.view",
    (id: String) => BlogPost.find(id),
    (bp: BlogPost) => bp.id.is
) / "posts" / * >> Hidden

def calcHref(bp: BlogPost) = entry.toLoc.calcHref(bp)
}

Don't forget to add BlogPost.entry to the SiteMap

val entries = /* other entries */ :: BlogPost.entry :: Nil
LiftRules.setSiteMap(SiteMap(entries: _*))

Next time I'll show you how to display comments after the blog post, while keeping the HTML structure of every comment in the template :)

Retour des RMLL

divarvel — Fri, 15 Jul 2011 21:17:22 +0200

Du 9 au 14 juillet avaient lieu les douzièmes Rencontres Mondiales du Logiciel Libre. L'occasion de rencontrer tout un tas de libristes et de contributeurs dans une ambiance sympa et détendue. Des conférences et des keynotes très intéressantes réalisées par (entre autres) Richard M. Stallman et Benjamin Bayart.

Ces RMLL ont été l'occasion de présenter notre retour d'expérience sur différents projets libres menés à l'École Centrale de Nantes. Avec Morgan Magnin, Benjamin Vialle et Nelle Varoquaux, nous avons eu la chance de faire trois conférences autour de MarkUs, l'application de correction de TP, et d'OpenOffice.org.

Les supports de ces présentations, ainsi que de plus amples explications sont disponibles dans la suite de l'article.

Ma conf vim

divarvel — Thu, 02 Sep 2010 23:40:43 +0200

Durant mon stage, j'ai eu l'occasion de peaufiner ma conf vim.

D'abord le remappage bépo

Grosso modo, je me suis borné à remapper les touches de façon à avoir les touches de déplacement sur ctsr. J'ai mis la conf dans un fichier à part, que je source à la fin du .vimrc
J'ai bricolé ça grâce au Wiki de vim.fr : Page consacrée à vim
Il y a plusieus niveaux de remappage, du plus léger au plus extrème. J'ai opté pour un remappage assez léger, de manière à ne pas être trop perdu sur un vim normal

Ensuite les plugins

L'ajout de plugins est capital pour bien utiliser vim. Voici ceux que me suis installés :

Ceux dont je ne pourrais pas me passer, c'est snipMate (Texmate-like snippets) et template (templates pour les nouveaux fichiers). phpComplete et JavaComplete permettent d'avoir l'omnicomplétion pour Java et PHP, ce qui est pas mal aussi. Project peut être sympa pour les gros projets.

ftplugin

Ftplugin permet d'associer à chaque type de fichier ouvert une configuration particulière. Par exemple, pour des règles spécifiques à python, il suffit de mettre ces règles dans ~/.vim/ftplugin/python.vim

" Active l'auto-complétion pour python
 set omnifunc=pythoncomplete#Complete
 " Indentation à 4 espaces
 setlocal tabstop=4
 setlocal shiftwidth=4
 setlocal expandtab
 setlocal softtabstop=4

Je m'en sers aussi (entre autres) pour mettre le correcteur orthographique pour les mails et les documents LaTeX et ReST

Le .vimrc, pour finir

Mon .vimrc complet (et mes autres fichiers de conf) est dispo sur github. Mais en gros ce que j'y ai mis, c'est

la coloration syntaxique
une petite fonction pour avoir une autocomplétion intelligente mappée sur Ctrl-Space
un mapping de certaines extensions à un type de fichier (quand ce n'est pas fait automatiquement)

Mes sources

Un bon fichier de conf se construit par tatonnements, et surtout grâce à l'inspiration fournies par les autres. Voici une liste (non exaustive hélas) de ce qui m'a inspiré.

Tab Candy: They're (poorly) reinventing the Wheel

divarvel — Thu, 29 Jul 2010 08:09:16 +0200

It's a fact, more and more applications are web-based, and the tabbed browsing shows its limits. Tabs are now like real applications and need to be managed more precisely and with less hassle. That's why the firefox folks created Tab Candy.

This is stupid. There are tons of good window managers out there. Why do anybody need to spend time on reinventing one, which won't be as good as existing ones, in addition to create a strong separation between web apps and the regular ones ?

If you want to have several groups of tabs, use several windows. If you want to have a quick access to a web app, give it its own window (with uzbl or jumanji for instance). This way, all your applications (web or regular) behave consistently, and you can use the full power of your WM instead of beeing forced to use a stoneage WM inside your browser.

Problem solved.

Environnement de développement Android - Sans Eclipse

divarvel — Mon, 31 May 2010 19:59:17 +0200

Je viens de faire l'acquisisition d'un Nexus One (j'étais lassé des restrictions à la Apple), et bien évidemment la première envie que j'ai c'est de développer des applis Android pour faire un peu joujou avec la bête.

J'ai trouvé pas mal de ressources pour débuter, mais toute ont pour point commun l'installation d'un CPU / Memory Hog : le tristement célèbre Eclipse.

Voici donc une petite compilation de ce que j'ai pu trouver pour déployer et utiliser un environnement de développement Android sous Ubuntu (#Insert troll here#), qui ne fasse pas appel à Eclipse.

Partager sa musique

divarvel — Thu, 20 May 2010 05:10:47 +0200

Je viens d'avoir une idée toute bête, un moyen de partager sa musique et de socialiser.

Socialiser dans la vraie vie, en plus. (IRL pour les pros)

Énormément de monde se balade avec des écouteurs sur les oreilles. Pourquoi ne pas de temps en temps, prendre deux minutes et échanger les écouteurs, pour découvrir ce que les autres écoutent, et faire découvrir ce qu'on écoute ?

Il suffirait d'avoir un petit signe distinctif (Par exemple un morceau d'adhésif rouge autour du câble) sur ses écouteurs pour signaler qu'on est prêt à s'arrêter deux minutes pour partager sa musique. Ça pourrait être cool de s'arrêter deux minutes et de discuter musique avec d'autres gens, non ?

Vous en pensez quoi ?

Crédit Photo : Grégory Thonon (CC-BY-SA 2.0 Deed)

Cowon S9

divarvel — Wed, 12 May 2010 03:35:10 +0200

J'ai reçu hier un Cowon S9, en remplacement de la solution mixte Archos 604 (batterie explosée) / iPhone (j'en peux plus de cette bouse)

Le Cowon S9 est un petit PMP de fabrication Coréenne.

J'ai choisi ce modèle principalement pour ses qualités audio et pour son support du format OGG, mais la bête a d'autres caractéristiques sympa.

Lire la suite...

Journée Mondiale contre les DRM

divarvel — Tue, 04 May 2010 05:14:22 +0200

Aujourd'hui, c'est la Journée Mondiale contre les DRM.
L'opération, initiée par la FSF, est relayée en France par l'April.
C'est l'occasion de sensibiliser les gens autour de vous aux menaces que font peser les DRM sur les utilisateurs, et sur les développeurs de logiciels libres.

Même si en apparence, les DRM ont battu en retraite du domaine de la musique (démontrant par là même la vacuité des lois type DADVSI, réclamées par l'industrie pour être jetées aux orties deux ans plus tard), elles n'en sont pas moins présentes dans le domaine des eBooks. (J'ai reçu un Cahier des Charges pour un reader sur iPhone, c'était vraiment dingue : interdiction du copier/coller, décryptage à la volée, impossibilité d'imprimer...) et dans le domaine des applications mobiles. Je pense bien évidemment à l'Apple Store, parmi autres.

En ce jour international de Star Wars, il est important d'essayer de sensibiliser ses proches aux dangers que représentent les DRM, et d'agir au maximum pour obtenir leur abandon.

Un peu de lecture :

MPD + Quelques tweaks sous Ubuntu

divarvel — Thu, 29 Apr 2010 06:03:09 +0200

MPD est, comme son nom s'indique, un daemon qui lit de la musique. L'intérêt, est que la partie qui lit la musique est découplée de l'IHM qui permet de gérer ça.

Cette structure apporte plusieurs avantages :

Légèreté (pas besoin d'occuper des ressources en permanence pour l'interface)

Choix du nombre d'interfaces (il y en a vraiment pour tous les goûts, du plus simple au plus sophistiqué, en passant par le sobre et efficace)

Possibilité de commander par le réseau
Interfaçage rapide avec tout et n'importe quoi (conky, par exemple)

J'ai donc installé et configuré MPD. (À l'aide de la doc d'ubuntu-fr).

J'ai eu ensuite à faire quelques petits tweaks pour intégrer ça correctement à mon système.

Touches multimédia

Comme MPD tourne en tâche de fond, si aucune interface n'est lancée, les touches multimédia ne seront pas gérées.
Le plus simple est d'utiliser mpc, qui permet d'envoyer des commandes à MPD.
J'ai ainsi associé la commande mpc toggle à la touche XF86Play, mpc stop à la touche XF86Stop, et ainsi de suite.

Pour le fun, j'ai fait un petit script qui permet d'afficher les informations sur le morceau en cours à l'aide de libnotify.

#!/bin/sh
DISPLAY=:0
notify-send "`mpc --format "%title%"|head -n1`" "`mpc --format "%artist% - %album%"| head -n1`"

Rien de bien méchant, mais ça peut être utile quand on veut savoir le nom du morceau en cours sans perdre trop de temps.

Scrobbling

Les clients MPD sophistiqués gèrent le scrobbling, mais, comme je l'ai dit, on n'a pas besoin d'avoir une interface en permanence.

J'ai trouvé scrobd, un petit script python qui permet de scrobbler sur libre.fm. (Saymieux que last.fm, et on a moins de risques de voir son nom refilé à la RIAA)

Étant donné que tous les clients communiquent avec MPD par une interface TCP, il n'y a pas de difficultés particulières pour que la musique soit jouée sur un ordinateur distant, avec autant de facilité que si c'était sur son propre PC.

Pour plus d'informations :

Et merci à @Keruspe et @Efyx pour m'avoir aidé à faire mes premiers pas avec MPD