Premiers pas avec TiddlyWiki : un tutoriel pour débutant

Si vous recherchez une alternative open source à Roam Research, TiddlyWiki est votre meilleur pari. Parce qu’il est auto-hébergé, ce qui signifie que vous gardez vos données privées, il peut sembler un peu plus intimidant de commencer. Voici donc un guide qui vous fera passer de débutant complet à complètement amoureux de TiddlyWiki en trois étapes. Comme pour tous mes guides, attendez-vous à des explications détaillées. Je ne supposerai jamais que quelque chose est évident. Bon, commençons.

If you have any questions during this tutorial, please post it here. I’ll do my best to come back to you as soon as possible, but other members of the TiddlyWiki community may be able to jump in before I do.

0. Qu’est-ce que TiddlyWiki ?

TiddlyWiki est un outil de prise de notes non linéaire. Il existe depuis environ 15 ans ! La magie de TiddlyWiki réside dans la métaprogrammation. Une nouvelle note peut modifier le comportement de TiddlyWiki lui-même. Par exemple, si je me retrouve à répéter une action assez souvent, je peux créer une note dynamique TiddlkyWiki (appelée « tiddlers ») pour ajouter un bouton à l’interface TiddlyWiki afin que je puisse cliquer dessus et effectuer cette action facilement.

Parce qu’il est si modulaire, il n’y a pas de limite mais votre imagination à ce que vous pouvez faire avec TiddlyWiki. Il s’agit d’une alternative gratuite, open source et auto-hébergée à de nombreux outils de prise de notes payants et propriétaires que vous utilisez peut-être actuellement.

Cela nécessite un peu plus de bricolage et il manque certaines fonctionnalités prêtes à l’emploi, donc si vous voulez quelque chose qui fait juste le travail et vit déjà dans le cloud, ce n’est peut-être pas pour vous. Dans tous les cas, si vous êtes curieux, ce tutoriel ne devrait pas vous prendre plus de 30 minutes et vous en donnera un bon aperçu.

1. Installez TiddlyWiki

Voyons d’abord ce qu’est TiddlyWiki. Cliquez ici pour aller sur le site officiel de TiddlyWiki, et cliquez sur le gros bouton vert « Télécharger vide » pour vous procurer une nouvelle copie de TiddlyWiki.

Si vous vous attendiez à une archive massive à décompresser et à de nombreux fichiers à installer, je suis désolé. Ce que ce bouton vert téléchargera n’est qu’un seul fichier HTML appelé vide.html. Renommez-le monwiki.html. Cliquez sur ce fichier pour l’ouvrir dans votre navigateur. Vous serez accueilli par la page de démarrage de TiddlyWiki.

Donnez-lui un nom (« Notes de Jack » ou « Pensées de Rachel ») et n’hésitez pas à laisser le sous-titre vide. Pas besoin de changer les tiddlers par défaut qui s’affichent au démarrage. Vous pouvez toujours changer tout cela plus tard et nous ne faisons que fouiller à ce stade, alors ne vous inquiétez pas pour l’instant.

Maintenant, cliquez sur le signe « + » dans le côté droit, juste en dessous du nom de votre wiki.

Cela ouvrira ce que TiddlyWiki appelle un nouveau « tiddler » – qui est en fait une note.

Tapez « Métamodernisme » comme titre. Allez ensuite sur Google « métamodernisme », et ouvrez la page Wikipédia correspondante. Collez le premier paragraphe de la page Wikipedia dans la zone de texte de TiddlyWiki. Tapez maintenant « philosophie » comme balise. Vous devriez vous retrouver avec quelque chose qui ressemble à ceci :

Cliquez sur la coche dans le coin supérieur droit de la note (ou « tiddler ») pour l’enregistrer. Vous remarquerez que deux choses changent dans le menu de droite. Tout d’abord, votre note est maintenant répertoriée dans la liste des tiddlers ouverts. Deuxièmement, il y a une icône rouge à côté de l’icône des paramètres. Cela vous permet de savoir qu’il y a des modifications non enregistrées.

Cliquez sur cette icône rouge et deux autres choses se produiront. Tout d’abord, il téléchargera une nouvelle version du monwiki.html fichier, généralement appelé monwiki(1).html. Deuxièmement, l’icône redeviendra gris clair, indiquant que vous avez maintenant enregistré vos modifications.

C’est plutôt cool, mais enregistrer un nouveau fichier HTML avec un nouveau nom chaque fois que nous prenons de nouvelles notes peut être assez ennuyeux et les choses peuvent devenir désordonnées dans notre dossier Téléchargements.

Voici quelques-unes des solutions que j’ai explorées :

1. Installez une extension de navigateur. L’extension savetiddlers pour Chrome et Firefox vous permet d’enregistrer votre wiki dans un dossier spécifique à l’intérieur du dossier Téléchargements.
2. Utilisez un module complémentaire Google Drive. TiddlyDrive est un module complémentaire pour Google Drive qui permet d’ouvrir et d’enregistrer directement les fichiers TiddlyWiki qui y sont stockés.

Jusqu’à ce que je découvre Note Self de Danielo Rodríguez. Rappelez-vous comment je vous ai dit que TiddlyWiki était extrêmement modulaire ? Note Self est une version modifiée de TiddlyWiki qui fait quelques choses vraiment sympas, mais pour l’instant, nous serons juste reconnaissants de pouvoir enregistrer automatiquement sans rien installer d’autre.

Allez sur le site Web de Note Self, cliquez sur télécharger, renommer noteself.html à monnouveauwiki.html et déplacez-le dans le dossier où vous voulez que votre wiki vive, par exemple Documents/wiki/monnouveauwiki.html.

Maintenant, ouvrez-le et changez le nom et la description de votre wiki comme nous l’avons fait auparavant. Vous pouvez ignorer les éléments de la base de données. Pour faciliter l’utilisation de votre wiki, je vous recommande également de le mettre en signet dans votre navigateur.

Note Self uses your browser's cache to save your notes as you type them, so please make sure to periodically back up your data. Click on the same "save" button and it will export your wiki and its database.

Vous pouvez supprimer en toute sécurité les autres copies de la version vanille de TiddlyWiki que nous avons téléchargées auparavant (celles nommées monwiki.html et monwiki(1).html).

2. Mettre à jour TiddlyWiki

Prenons notre wiki d’une Skoda à une Lamborghini. Parce qu’il est open source et qu’il a une grande communauté de contributeurs, vous pourrez ajouter de nombreuses fonctionnalités intéressantes à votre wiki en quelques glisser-déposer.

• Ajoutez TiddlyBlink. Selon les mots de son créateur Dave Gifford, TiddlyBlink est « TiddlyWiki avec des liens bidirectionnels » – cela ressemble exactement à ce dont nous avons besoin. Cliquez ici et faites glisser la pilule jaune « tb » dans votre propre TiddlyWiki. La façon la plus simple de le faire est de les ouvrir côte à côte. Voir le gif ci-dessus pour une démo. C’est probablement la fonctionnalité la plus puissante de TiddlyWiki : vous pouvez ajouter de nouvelles fonctionnalités à votre système de gestion des connaissances simplement en créant de nouvelles notes dynamiques ou en faisant glisser les notes dynamiques de quelqu’un d’autre dans votre bloc-notes. Alors, faites-le glisser dans votre propre TiddlyWiki, cliquez sur importer, enregistrer et actualiser la page. Félicitations, vous avez maintenant des liens bidirectionnels et des liens à saisie semi-automatique dans votre wiki.
• Utilisez TiddlyBlink. Nous aurons un aperçu plus détaillé plus tard, mais jetons un coup d’œil rapide maintenant. Désormais, lorsque vous créez un nouveau tiddler, vous pouvez utiliser [[ ]] pour rechercher des pages existantes ou pour créer de nouvelles pages. Vous pouvez également surligner des mots existants dans votre tiddler et cliquer sur le [[*]] bouton pour ajouter des crochets doubles autour d’eux. TiddlyBlink inclut un renommeur automatique, donc si vous changez le titre d’une note, cela changera automatiquement le nom de tous les liens vers cette note trouvés dans d’autres notes. Vous pouvez cliquer sur la petite icône en forme d’horloge pour créer des notes quotidiennes avec la date et l’heure actuelles (très pratique pour des pensées rapides à la volée où vous ne voulez pas penser à un titre). TiddlyBlink est un outil très puissant qui reproduit de nombreuses fonctionnalités de Roam.
• Ajoutez la prise en charge de la démarque. Si comme moi vous avez l’habitude de taper vos notes en démarque, vous pouvez installer ce petit plugin. Dites bonjour au formatage facile, y compris les tableaux, les images intégrées, les cases à cocher et le code en ligne avec des backticks.
• (facultatif) Ajoutez TiddlyMap. Une fonctionnalité que beaucoup de gens adorent dans Roam est le graphe de connaissances. Si vous voulez une carte en direct de vos nœuds, vous pouvez installer TiddlyMap. Accédez aux instructions d’installation, puis faites glisser les liens spécifiés dans le guide dans votre installation de TiddlyWiki, dans le bon ordre. C’est le même processus que nous avons utilisé pour faire glisser la pilule « td » pour installer TiddlyBlink. Faites glisser, cliquez sur importer, enregistrer, actualiser. Cliquez sur « live view » et vous devriez maintenant voir une carte de vos notes.

Vous pouvez d’abord l’essayer sur le site Web de TiddlyMap.

Excellent travail, vous avez maintenant votre propre outil de prise de notes non linéaire auto-hébergé ! Dans la section suivante, nous couvrirons certaines des bases de l’utilisation de TiddlyWiki pour prendre des notes en réseau et créer votre propre base de données de connaissances.

3. Apprenez les bases

Si vous êtes intime avec Roam, de nombreuses fonctionnalités de cette installation vous sembleront familières. Passons en revue les plus importants.

• Lien vers des notes nouvelles ou existantes. Utilisation [[*]]pour rechercher des pages existantes. Si la page n’existe pas, elle sera créée à la volée grâce à TiddlyBlink. Vous pouvez utiliser [[in-text way of referring to a note|Actual title of the note]] afin que vos notes soient plus fluides.
• Transclure le contenu d’autres notes. Cette installation prend en charge la transclusion. Utilisez {{*}} pour inclure une autre note. Veuillez noter que dans la philosophie de TiddlyWiki, le tiddler est le bit d’information atomique, vous n’aurez donc pas accès aux données au niveau du « bloc » comme vous le feriez dans Roam. Cela donne une approche légèrement différente de la prise de notes. Si vous êtes un gros utilisateur de la fonction de blocage dans Roam, cela aura un impact significatif sur votre flux de travail.
• Prenez des notes rapides. Dans Roam, vous disposez d’une fonctionnalité de note « quotidienne » qui a automatiquement la date d’aujourd’hui comme titre. Dans TiddlyWiki, vous pourriez prendre de telles notes à chaque minute ! Cliquez sur la petite icône d’horloge pour créer une note avec l’horodatage actuel. Grâce à Note Self, vous avez également accès aux révisions passées en cliquant sur le coin supérieur droit de n’importe quelle note.
• Taguez vos notes. C’est une fonctionnalité intéressante de TiddlyWiki. Personnellement, j’ai des notes pour les « personnes », les « livres », les « articles » et les « concepts ». Vous pouvez même aller plus loin et, par exemple, étiqueter les gens comme « amis », « famille » ou « collègues ». Si vous comptez beaucoup sur le balisage et la création de concepts particuliers pour lier vos notes, vous voudrez peut-être jeter un coup d’œil à Idea Stew pour TiddlyWiki, qui le rend plus facile et plus rapide à faire.
• Naviguez dans vos notes. Grâce à TiddlyBlink, chaque note aura une liste de backlinks (« Références ») en bas de la page. Vous pouvez également utiliser le panneau de droite pour consulter les notes récentes, les notes ouvertes ou effectuer une recherche par balises. Si vous cliquez sur l’icône en forme d’œil, vous pouvez décider comment ces références seront affichées.
• Recherchez vos notes. La barre latérale a une boîte de recherche qui est super facile à utiliser. En cliquant sur l’icône de la loupe, vous aurez accès à des fonctionnalités de recherche avancées avec de nombreux opérateurs de filtrage.
• Organisez vos notes. Il existe plusieurs façons d’organiser vos notes. Par exemple, vous pouvez créer des pages dédiées et utiliser certains filtres, par exemple <> pour lister tout le contenu lié aux livres de philosophie.
• Partagez vos notes avec d’autres. Vous voudrez peut-être partager une note particulière ou tout votre wiki. TiddlyWiki rend les deux très faciles. Tout d’abord, parce que votre wiki n’est qu’un fichier, vous pouvez simplement envoyer le fichier HTML entier par e-mail à quelqu’un. Ils n’auraient qu’à l’ouvrir dans leur navigateur pour interagir avec. Mais, de manière réaliste, vous ne voudrez probablement partager qu’une seule note. Voici différentes façons de le faire, y compris au format texte simple.

Vous êtes maintenant prêt à partir ! Il existe de nombreuses options de sauvegarde et de sauvegarde dans lesquelles je ne vais pas entrer dans ce didacticiel pour débutant. Le plus simple est probablement de télécharger votre fichier HTML sur Dropbox ou Google Drive, mais vous pouvez l’automatiser et même connecter TiddlyWiki à une base de données dans le cloud. Si vous avez du mal, il y a une communauté incroyablement solidaire ici.

Et si vous voulez monter d’un cran, vous pouvez même commencer à utiliser TiddlyWiki comme générateur de site Web statique. C’est ce que j’utilise pour mon jardin numérique. S’amuser!