Mot-clé - javascript

Fil des billets - Fil des commentaires

mercredi 29 octobre 2014

Ressources pour TiddlyWiki 5 (FR)

EDIT 21/07/2015 : Depuis le 15 juin dernier, après le succès du TWCamp Paris, j’ai ouvert le forum disponible à l’adresse : http://forum.tiddlywiki.fr.

Il y a trois mois, j’écrivais le billet Un wiki sur votre BiblioBox avec TiddlyWiki sur le blog de BiblioBox.net.

Depuis, ce wiki minuscule [1] composé d’un seul fichier html avec du javascript est sorti de son stade bêta. TiddlyWiki en est ainsi à sa version 5.1.4 avec un cycle de développement très rapide.

Le site officiel : http://www.tiddlywiki.com

TiddlyWiki5 is a reboot of TiddlyWiki for the next 25 years. It is a complete interactive wiki in JavaScript that can be run in the browser or on the server under Node.js.

À priori, les ressources en français pour TW5 ne sont pas courantes. À l’époque de la précédente version (renommée TiddliWiki Classic) il y avait le site suivant toujours en ligne : http://www.tiddlywiki.fr/

Dans un cadre professionnel j’ai choisi dernièrement d’utiliser ce moteur de wiki pour rédiger une documentation utilisateur. J’ai passé quelques soirées nuits pour (re)découvrir cet outil qui n’en fini pas de m’impressionner.

Pour citer quelques avantages :

  • c’est un wiki ! Pour moi ça rime avec facilité d’édition
  • c’est dans sa nature : les liens internes. Comme lors de la consultation d’un article Wikipédia et les nombreuses définitions que l’on peut mettre en évidence
  • comme ce n’est qu’un seul fichier html, le moteur de recherche est efficace
  • toujours sur l’aspect simple fichier : pas besoin d’avoir un serveur pour l’installer, en pièce jointe d’un email, sur une clé USB, le bureau et c’est parti.
  • si l’on gère les images dans un répertoire externe, la mise à jour des captures écrans est plus facile, il suffit de remplacer l’image.

La recette d’un TiddlyWiki, c’est le plus petit élément : un tiddler. Celui-ci peut contenir le code du programme, les plugins, du CSS, des images en base64, et surtout le contenu. Associé à une syntaxe wiki, avec un minimum d’entrainement [2], c’est assez efficace de hiérarchiser son contenu avec les titres, sous-titres, paragraphes, listes à puces et les liens internes.

Des inconvénients ? Il en existe probablement, nul outil n’est parfait. L’absence de barre d’édition wiki wysiwyg façon Doctcear peut-être (un plugin existe pour FCKEditor, je n’ai pas encore essayé mais ne me semble pas optimal, trop d’options, et oblige de maintenir un code html à la place d’un code wiki). En attendant, il existe un plugin avec les principaux raccourcis claviers.

La navigation dans les tiddlers peut dérouter au début peut-être aussi. A sinon il n’y a pas forcément de mode collaboratif. A la base c’est plutôt un outil de prise de notes personnelles.

Bref, dans mes expérimentations de plugins divers et variés, et de l’apprentissage des fonctions natives de TiddlyWiki (comme la ToDo liste), j’ai commencé la rédaction d’un.. TiddlyWiki ;)

Vous trouverez en pièce jointe une première version loin d’être finalisée. Si elle peut vous aider à démarrer avec TiddlyWiki, vous n’aurez qu’à me remercier en commentaire.

TiddliWiki5_fr.png

EDIT 26/11/2014 : sortie de la version 5.1.5, avec une fonction d’export !

Notes

[1] tiddly !

[2] comme ici avec la syntaxe wiki de Dotclear

En haut