Nanoblogger

Britney Gopherspace, 17 mai 2009, illovæ — Je nanobloggue, tu nanobloggues, il nanobloggue, nous nanoblogguons, vous nanoblogguez ?

Depuis le boom du blog de particuliers d'il y a quelques années, nous avons vu apparaître plusieurs moteurs (ou propulseurs selon les termes) de blog libre. Nous connaissons tous wordpress ou dotclear qui sont à base de PHP. Mais il en existe dans d'autres languages comme byteflow blog engine écrit en python et utilisant Django. Ces moteurs génèrent des pages dynamiques, id est que le serveur génère des pages en live en fonction des demandes des clients. Il en existe bien d'autres comme wadomblog toujours en python ; mais aussi et cette fois-ci en ruby, mephisto ou encore rog ; ces trois derniers générant des pages statiques, id est que le moteur génère une ou des pages HTML uniques que le serveur délivre à tout le monde (pour plus d'informations sur le statique/dynamique vous pouvez vous référer à cette page). Comme le sous-entend le titre de l'article, je ne vais pas ici faire le détail des moteurs de blogs suscités et vous en donner mon avis, mais l'idée est plutôt de vous présenter un autre propulseur écrit en bash par Kevin 'n1xt3rnanoblogger.

Comme le précise la page officielle du projet, Nanoblogger est un petit moteur de blog écrit en bash et disponible depuis la ligne de commande (la CLI cay bon mangez-en). Il utilise les outils UNIX très répandus que sont cat, sed et grep et est diffusé sous GNU Public General License. Il est donc de ce fait tout à fait utilisable sous GNU/Linux bien sûr, mais, et cela bien qu'écrit avec les outils GNU, aussi sous *BSD. Il est dit qu'il fonctionne très bien sous Solaris et sous Mac, mais je n'ai jamais testé.

Communauté

n1xt3r a réussi à réunir autour de son projet une petite communauté très active et fidèle, et notamment une communauté francophone menée par Denis 'deber' Bernard qui héberge chez lui le site non-officiel de Nanoblogger en langue française et qui s'occupe aussi de la traduction en français du moteur. Vous pourrez retrouver sur ce dernier des news ainsi que les blogs de la communauté francophone sous Nanoblogger, sans oublier le wiki (hébergé par Olivier 'Blanko' Dossmann). À noter qu'il existe aussi un canal IRC #nanoblogger-fr@irc.oftc.net:6667, certes peu fréquenté mais où vous trouverez toujours une personne ou deux à votre écoute. La communauté s'occupe aussi du maintien de la page sur wikipedia francophone et qui explique notamment que :

L'interface utilisateur est minimale et se fait en ligne de commande depuis une console en local, telnet ou SSH. Nanoblogger permet d'avoir, sans modifier ou ajouter une seule ligne de code, un blog prêt à l'emploi. Le moteur génère uniquement des pages statiques. Ça a l'avantage de pouvoir créer ses pages depuis un ordinateur quelconque et de les transférer (via ftp par exemple, ndla) sur un serveur Web, comme l'espace offert pour les pages personnelles de son fournisseur d'accès Internet. Mais on peut tout aussi bien agir directement sur le serveur Web si l'on en dispose un.

Avantages et inconvénients

L'intérêt de Nanoblogger est donc pluriel : son accessibilité au travers de la ligne de commande, sa légèreté et sa simplicité mais aussi le fait de pouvoir l'utiliser au travers de différentes voies. Il n'est pas nécessaire de connaître la programmation bash ou de savoir éditer de l'HTML pour l'utiliser. Il est fonctionnel et prêt à l'emploi des l'installation et est livré avec plusieurs thèmes graphiques (CSS) ainsi que plusieurs plugins.

Nanoblogger a aussi l'avantage d'être très configurable et extensible. En effet, le fichier de configuration laisse énormément de liberté et de plus, si une fonction vous manque, Nanoblogger contient un système de plugin très simple (beaucoup sont livrés avec le moteur en lui-même, de plus si vous codez en bash, l'ajout de plugin est un jeu d'enfant ; pour les apprentis, c'est aussi une bonne façon de bidouiller du code, et d'avoir des résultats concrets rapidement). Son utilisation en CLI est très intuitive, l'édition/l'ajout/le retrait d'articles et de billets se font très facilement. Il a un système d'archive très poussé, l'édition des templates se fait aussi aisément, ce qui vous permet d'avoir rapidement le résultat qui vous convient (avec l'aide de CSS si vous le souhaitez comme dit). Il génère aussi bien sur des flux Atom 1.0, RSS 1.0 et 2.0. Sachez que Nanoblogger est aussi conçu pour pouvoir gérer plusieurs blogs en même temps. Si vous avez un serveur qui gère plusieurs utilisateurs, il est très aisé pour eux d'avoir leur propre blog chacun. Enfin notez que Nanoblogger permet d'écrire des billets et des articles. La distinction se fait en ce sens que les billets s'affichent sur la page principale, sont datés, se retrouve dans les archives, etc (comme n'importe quel blog) alors que les articles sont figés hors du temps, et ont leur place particulière avec un sous-menu à eux. La liste des possibilités de Nanoblogger est encore longue, mais je pense qu'on a le principal ici.

Mais, il ne faut pas l'élaguer, Nanoblogger a aussi quelques défauts. Je ne lui en reconnaît que deux (un et demi en fait) personnellement :

• sa lenteur comparé à d'autres ;
• l'impossibilité out of the box d'avoir des commentaires.

Il faut cependant relativisé un peu. Question lenteur, avec la dernière version 3.4RC2, les choses se sont grandement améliorées même quand on a un blog comportant énormément d'entrée. Sans aller dans des détails techniques, l'ajout d'un billet prend environ 10 secondes. En effet, il faut générer la page du billet en elle-même, le flux RSS ainsi que l'index.html de la page principale notamment. De plus si vous utilisez tidy, il faut prendre en compte le check w3c des pages. Mais bon, 10 secondes personnellement je trouve ça tout à fait raisonnable.

En ce qui concerne les commentaires, en effet comme tout est statique, il faut utiliser des outils extérieurs. Vous pouvez parfaitement utiliser un code cgi ou php pourquoi pas, ou comme beaucoup de nanobloggueur le font, passer par des sites dédiés, tel que haloscan qui en ajoutant simplement deux lignes la où il faut vous permet d'avoir non seulement des commentaires dynamiques mais aussi un système de notation des billets pour vos lecteurs si vous voulez (pour avoir un exemple concret du résultat, référez vous au site du projet qui utilise cette méthode ; et attention haloscan ça bosse avec du javascript, plutôt sale donc). Enfin d'autres ont fait le choix de rester totalement en statique et de gérer eux-mêmes les commentaires via mail, voir même pour certains pas de commentaires du tout.

Installation et configuration : à l'aventure, tout de suite

Comme évoqué précédemment, la version disponible en ce moment est la 3.4RC2 que vous pouvez donc récupérer à cet endroit. Certaines distributions offrent aussi dans leur dépôt un paquet pour installer Nanoblogger. Cependant, je vous déconseille cette méthode. Tout d'abord, parce qu'il est plus intéressant d'avoir la dernière version de Nanoblogger qui apporte tout de même de bonne mise à jour, ainsi qu'une nouvelle méthode de gestion des billets au sein de son code. En sus lors d'une mise à jour vers une version supérieure, il est toujours conseille de le faire a la main dans ce cas présent histoire de maîtriser les tenants et les aboutissants.

Décompressez où vous voulez l'archive. Pensez à rajouter le path de votre dossier Nanoblogger à la variable PATH de votre shell si vous voulez pouvoir utiliser la commande du blog depuis n'importe où (regardez les premières lignes de votre fichier ~/.bashrc, ~/.zshrc ou autre si vous ne voyez pas trop comment faire ça). Ceci fait, vous pouvez des à présent créer votre blog :

$ nb -b /path/du/blog add weblog
creating weblog directory '/path/du/blog' ...
copying default weblog files ...
would you like to configure the new weblog now? [Y/n]
> Y

Le fait de répondre 'Y' va ouvrir le fichier /path/du/blog/blog.conf avec votre $EDITOR par défaut et vous pourrez commencer à régler le blog selon votre bon vouloir. Le fichier est plutôt bien commenté, je ne vais donc pas rentrer dans les détails ici. Une fois fait, vous n'avez plus qu'à enregistrer et quitter. N'ayez pas peur de faire des erreurs, même après création du blog, ce fichier peut être modifié et on peut régénérer totalement le blog sans perdre ni articles ni billets bien sûr.

generating weblog files ...
selected tag id(s): 1 ...
adding new entry ...
updating main database ...
updating all weblog files! this may take a while ...
initializing main database ...
generating weblog calendar for May 2009 ...
generating recent entries links ...
generating rss 2.0 feed ...
/path/de/votre/choix/rss.xml
generating weblog links ...
generating weblog status ...
generating articles: /path/du/blog/articles ...
/path/du/blog/articles/example/index.html
generating archive index page ...
/path/du/blog/archives/index.html
generating archives ...
/path/du/blog/archives/nanoblogger-help/index.html
generating year archives ...
/path/du/blog/archives/2009/index.html
generating weblog calendar for May 2009 ...
/path/du/blog/archives/2009/05/index.html
/path/du/blog/archives/2009/05/14/welcome_to_nanoblogger_3_4/index.html
generating main index page(s) ...
/path/du/blog/index.html
expiring cache data ...

Et vous voilà déjà avec votre blog prêt à l'emploi et qui vous a publié un petit message d'accueil dans la catégorie 'nanoblogger-help'. Les commandes de Nanoblogger sont simples, en voici un aperçu (que vous pouvez retrouver dans le billet de bienvenue de votre nouveau blog) :

• créer un nouveau weblog (dossier) ... nb -b <blog_dir> add weblog
• créer un nouvel article ... nb add article
• créer un nouveau billet (sans tag) ... nb add entry
• créer un nouveau tag ... nb add tag
• créer une nouvelle entrée avec un tag ... nb --tag [tag_id] add entry
• lister les différentes entrées ... nb list <query>
• lister les différents tags ... nb list tags
• lister les entrées par tags ... nb list tag [tag_id]
• editer une entrée ... nb edit entry [entry_id]
• tager une entrée déjà existante ... nb --tag [tag_id] tag-entry [entry_id]
• enlever un tag a une entrée ... nb --tag [tag_id] delete entry [entry_id]
• effacer un tag ... nb delete tag [tag_id]
• effacer une entrée ... nb delete entry [entry_id]
• créer un squelette d'entrée ou d'articles ... nb draft [draft_file]
• importer un fichier en tant que billet ... nb import entry [draft_file]
• importer un fichier en tant qu'article ... nb import article [draft_file]
• mettre à jour le blog ... nb update <all|DATE|main|max|articles|feeds>

Rien de très compliqué donc comme vous pouvez le voir. Remarquez que l'option -b vous permet de définir où se trouve votre blog. Il est impératif de mettre cette option à chaque fois, sans quoi Nanoblogger ne saura pas où est votre blog. Ceci dit, on peut s'en passer si on édite le fichier ../nanoblogger-3.4-rc2/nb.conf à la variable BLOG_DIR ; et la plus besoin d'option -b. Notez aussi que créer un billet ou un article l'ajoutera à votre blog dès que vous quitterez votre éditeur de texte. Si vous voulez prendre le temps d'écrire un billet ou un article et y revenir plus tard, il vous suffit de créez un squelette que vous éditez, et enregistrerez où bon vous semble (c'est un simple fichier .txt). Vous pourrez ainsi le garder dans un coin, le rééditer, le modifier, etc. Quand l'heure de la publication aura sonnée, il vous suffira simplement d'importer ce fichier .txt pour l'ajouter à votre blog.

En ce qui concerne l'édition des billets en eux-mêmes. Par défaut le format est raw ce qui signifie que vous devez écrire le billet avec une mise en forme HTML. Cependant il existe deux autres formats disponibles. Le premier est autobr : dans ce mode vous écrivez simplement votre billet et Nanoblogger se chargera d'ajouter du code HTML dans les lignes vides histoire de faire un peu de mise en forme rudimentaire. L'avantage est que vous ne vous prenez pas du tout la tête, par contre l'inconvénient est clairement que vous ne mettez pas du tout en forme votre billet (pas de gras, d'italique, de balise code, etc), sans compter que cela peut vous causer des soucis si vous mettez un point d'honneur à passer la validation w3c... La seconde méthode est baucoup plus sexy et utilise le format très connu markdown. C'est un outil perl qui permet de convertir du texte vers de l'HTML comme cela se fait avec l'édition des pages type wiki (vous savez à grand coup de ==== Titre h2 ==== par exemple pour faire des titres, etc). Le format que Nanoblogger doit avoir par défaut se configure dans le fichier blog.conf de votre blog.

Je ne vais pas m'étendre plus que cela sur l'utilisation de Nanoblogger, il existe un manuel de l'utilisateur bien écrit et conséquent qui devrait répondre à vos principales questions. Pensez aussi au wiki évidemment, et à sa section astuces. Vous pouvez enfin aussi, comme présenté en introduction, rejoindre le canal IRC bien sûr si vous n'arrivez pas à vous en sortir ;)

Voilà donc pour la présentation de ce moteur de blog très apprécié par ses utilisateurs. Sa prise en main est très simple et rapide, mais Nanoblogger vous permet de faire vraiment beaucoup de chose, et se plis à vos envies. Sans compter qu'il est très léger et ne nécessite pas d'avoir un mastodonte de serveur. Le moindre petit httpd fait l'affaire. J'apprécie personnellement le côté modelage de ce moteur de blog, on peut dire qu'avec lui, on gère vraiment notre blog à notre façon tant dans la forme (templates, CSS) que dans le fond (script bash). Il a souvent été appelé moteur de blog pour geek et c'est peut-être un peu vrai. Mais j'aurai plutôt tendance à dire qu'il s'adresse tout à fait à l'utilisateur lambda qui ne veut pas se prendre la tête avec un serveur PHP+module ou autre et qui veut simplement "publier des billets" ; idéal pour répondre à la dictature du Ça en somme. Nanoblogger, out of the box, est parfaitement utilisable tel quel, sans rien modifié du tout, d'ailleurs beaucoup d'utilisateurs ne prennent même pas la peine d'éditer le CSS par défaut, et s'en retrouve très bien. Mais il sera aussi très apprécié du hacker (au sens premier du terme et non au sens hadopien) car il permet aisément d'arriver à ses fins tout en laissant une vaste marge de bidouillage.