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.

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.

The snippet

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

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.

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

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 :)

Les noms de variables, fonctions, méthodes

Déjà, j'utilise l'anglais pour nommer mes variables. Pour la capitalisation, tout dépend de si je code Objet ou pas. Si je ne code pas objet, je fais ça à la PHP c'est à dire des mots séparés par des underscore _. Quand je code Objet, j'utilise une CamelCase bidouillée, je mets des majuscules au début de tous les mots, sauf des verbes, ce qui revient très souvent à du lowerCamelCase.

Indentation

Indentation de 4, j'indente tout le bloc. Pour le xHTML (je sais, ce n'est pas de la programmation), j'indente le contenu des balises de type bloc (sauf h[1-6]), et je vais à la ligne. Je vais à la ligne après un <br />, sauf s'il y en a plusieurs à la suite (mais c'est plutôt rare que ça arrive)

Accolades

Accolade ouvrante à la fin de la ligne de définition de la boucle. Accolade fermante sur une nouvelle ligne, au même niveau que la définition de la boucle.
Pas d'accolades pour un bloc mono-ligne. (par exemple un if suivi d'une seule instruction).

Espaces

Pour les virgules et les point-virgules : pas d'espace avant, un espace après.
Pas d'espace entre les noms de fonction et la parenthèse ouvrante. Idem pour les boucles.
Pas d'espace entre la parenthèse fermante et l'accolade ouvrante dans les boucles.
Pas d'espace entre le else et le if dans les else if.
Un espace de part et d'autre des opérateurs de modification (=, +=, *=, ...).
Un espace de part et d'autre pour les opérateurs de comparaison (==, <=, >=) et pour les opérateurs de modification dans les boucles (for, while, if), sauf pour les longues expressions.

Guillemets

En php, j'utilise uniquement les guillemets simples (apostrophe), sauf pour afficher des caractères spéciaux (\r, \n ...).
En JS, ça dépend du contenu de la chaîne. Si c'est du texte tout bête, des guillemets doubles, si ça contient du HTML, je mets des guillemets simples
Dans les autres langages, des guillemets doubles.

Commentaires

Dans les fichiers lambda, des commentaires pour expliquer la fonction d'un bloc, en particulier si c'est tricky
Dans les fichiers qui définissent les classes, quelques lignes au début, puis un bloc de commentaire avant chaque méthode : utilité, variables attendues (rôle, type, valeur par défaut), valeur de retour, puis éventuellement des commentaires monolignes pour expliquer la fonction de tel ou tel bloc. Les commentaires monolignes pour les blocs sont mis après l'accolade ouvrante, précédés d'un espace.

Je fais suivre la chaîne à Xipoons, puis à ceux qui sont motivés :p

S'il est bien une chose difficilement dissociable de l'Internet, c'est le Web. La proximité entre web et Internet conduit à la confusion fréquente entre ces deux concepts. Il est difficile, voire impossible d'imaginer l'un sans l'autre. Sans l'Internet, le web ne pourrait techniquement pas exister, et c'est l'essor du Web qui a popularisé l'usage de l'Internet. Le succès du Web est tel que l'on tente de tout faire transiter par ce biais, ce qui n'est pas forcément une bonne chose, dans la mesure où l'on détourne le Web de son usage premier. D'après la philosophie UNIX, un outil ne doit faire qu'une chose, et la faire bien. L'évolution actuelle du web est totalement contraire à cette philosophie.

Le principe du Web

Le Web est un système hypertexte : une ressource peut mener à une autre via un hyperlien. Le Web a été inventé par Tim Berners-Lee, chercheur au CERN, pour permettre aux chercheurs de partager leurs données (et non pas pour acheter Robert Caillau $12000 sur Friends on Sale). Le "Web 1.0" fonctionnait de manière statique : une page fournit des infos, le visiteur les lit, point barre. Depuis quelques années, a émergé le "Web 2.0", où l'utilisateur agit sur le contenu, et communique avec les autres utilisateurs.

Pour les sites tels que Wikipedia, c'est génial, par contre pour les sites de partage de vidéos, ou les réseaux sociaux, je ne pense pas que le Web soit le moyen le plus pertinent. Le terminal dédié à la vidéo, c'est la TV. De plus en plus de TV sont reliées à l'Internet (via les freeboîtes, par exemple). Quand aux réseaux sociaux, je verrais plus ça dans le téléphone, ou dans un gestionnaire de cartes de visites (en fait mon plus grand fantasme technologique, c'est le bondage avec des câbles RJ 45 les implants neuroniques) donc un carnet d'adresses. Les réseaux sociaux ça sert juste à garder une liste de ses connaissances, à les classer leurs fiches par catégories, pour les contacter plus simplement, c'est pour ça que je regrette toutes les fioritures inutiles de FaceBook (applications alakon, groupes, etc). Par contre les réseaux sociaux peuvent être une bonne base pour remplacer l'email (surtout si on peut implémenter l'UUID dont je parle ici (système de nommage) )

J'espère donc que l'usage du Web se restreindra à ce qu'il devrait être : un partage d'informations, au sens strict du terme.