Gérer un blog avec tiddlywiki

Lorsque j’ai commencé à bloguer, écrire des billets sur internet, je ne pensais pas que ça aurait duré aussi longtemps. Aujourd’hui j’y suis encore, avec comme il se doit des hauts et des bas.

Après un temps il m’a fallu historiser cette activité, en compiler des références pour de futurs billets, et pour les replacer dans leur contexte. Un autre besoin, une nécessité est de classer repérer les billets parus, les brouillons, les publiables, les planifiés.

Si au départ un simple fichier texte suffisait, il m’a bien fallu un jour passer à la vitesse supérieure. Un wiki classique eût bien fait l’affaire, mais l’idée de me trimbaler (j’ai tendance à écrire un peu partout) avec une base de données, un serveur web, une application php et tout le bazar ne m’enchante pas le moins du monde.

Revenons donc aux basiques:

• un wiki,
• une mise en oeuvre simple,
• une utilisabilité de tous les instants…
• … vous voyez maintenant où je veux en venir…

J’utilise un document tiddlywiki, simplement enrichi de la macro siteMap.

Pour rappel, la macro siteMap permet d’afficher une carte du wiki sous la forme d’une arborescence de tiddlers, la hiérarchie étant définie par les tags.

Le premier tiddler visible à l’ouverture de ce tiddlywiki contient plusieurs appels à cette macro sitemap.

Pour les gens pressées, ça se trouve à la fin de ce billet.

Pour les autres, voici d’abord quelques explications, en tentant de rester compréhensible.

Les billets avant parution

Avant parution chaque billet passe par trois tags successifs:

1. Brouillon (draft)
2. A relire
3. A paraitre

J’ai donc un tiddler contenant le code suivant, qui me permet de voir ce qui reste en stock (prêt à publier) ou en cours de rédaction :

<<siteMap 10_draft>>
<<siteMap 20_aRelire>>
<<siteMap 30_aParaitre>>

Publication d’un billet

Quand je publie un billet, je renomme son tiddler en lui ajoutant la date (format aaaammjj) et remplace ce tag d’état par

• un tag pour chaque catégorie du billet
• et un tag Maaaamm (aaaa = année, mm = mois) indiquant le mois de parution

Si le document tiddlywiki prenait de l’embonpoint, il serait (presque) envisageable de supprimer le texte des plus anciens (une hérésie à mon sens) en n’en conservant que les titres.

Historisation des billets
Chaque billet porte un tag de la forme Maaaamm correspondant au mois de sa parution.

Pour chacun de ces tags, je crée un tiddler ayant un tag Yaaaa correspondant à l’année.

De même pour chaque Yaaaa, je crée un tiddler portant le tag « timeline », et ce tag est utilisé par un appel à la macro siteMap :

<<siteMap timeline>>

L’historique du blog apparait maintenant trié par années et par mois.

Classement par catégories

Pour chaque catégorie du blog je crée un tiddler dont le nom commence par un caractère « _ » et ayant pour tag la catégorie mère, ou le tag « categories » si c’est une catégorie de base.

L’ajout d’un nouvel appel à la macro siteMap donne le classement des billets par catégories:

<<siteMap categories>>

Au final

L’état du blog apparaît dans un tiddler affiché par défaut et contenant le texte suivant :

|<<siteMap 10_draft>> <<siteMap 20_aRelire>>|<<siteMap 30_aParaitre>>|
|<<siteMap categories>>|<<siteMap timeline>>|

Utilisation des rappels dans Tiddlywiki/mGSD

J’utilise Tiddlywiki et un de ses dérivés, mGsd au quotidien pour suivre l’avancement de mes chantiers en cours.

Le suivi par listes de tâches et par contextes ne suffit pas toujours, car certains événements arrivent à date planifiée, par exemple les mises en production, opérations de services, etc.

Par ailleurs certaines actions sont récurrentes, avec répétition quotidienne, hebdomadaire, mensuelle, etc.

mGsd fournit un outil fort pratique: les rappels, ou ticklers. Je ne me suis décidé à m’y intéresser que récemment. Pourtant leur utilisation est des plus simple:

Création d’un rappel

1. Cliquer sur le lien « + tickler » en haut du mGsd, ou dans le projet concerné
2. Sélectionner une date
3. Dans le dialogue qui apparait, saisir le libellé du rappel et valider
4. Le nouveau rappel apparaît

Description d’un rappel

Chaque rappel possède les attributs suivants :

• Période :
  • one time – une fois
  • daily – quotidien
  • weekly – hebdomadaire
  • fortnightly – tous les quinze jours (j’adore les dialectes anglais et étasuniens!)
  • monthly – mensuel
  • yearly – annuel
• Date du rappel
  • Cliquer sur la date pour la modifier dans le calendrier qui apparaît alors.
  • Cette date peut être modifiée par des raccourcis y ajoutant un jour (+d), une semaine (+w), un mois (+m) ou un an (+y)
• Projet
• Domaine (Area)
• Contacts associés (Associated contact)

Suivi des rappels

mGsd fournit plusieurs outils de suivi des rappels :

• Dans des tableaux de bord
  • Tickler DashBoard : tous les rappels par échéances : aujourd’hui, dans la semaine, pour la suite
  • Tickler DashBoard by Contact : tous les rappels
• Dans chaque projet

Par ailleurs un de mes tiddlers par défaut affiche les rappels du jour, en incluant le code suivant (recopié d’un des tableaux de bord officiels) :

<<mgtdList
	title:'Ticklers Requiring Action'
	startTag:Tickler
	tags:'!Actioned'
	view:Tickler
	mode:global
	newButtonTags:'Tickler Enabled Once'
	where:'tiddler.ticklerIsActive()'
	sort:'tickleDate'
	dontShowEmpty:yes
	ignoreRealm:{{config.mGTD.getOptChk('AlertsIgnoreRealm')?'yes':''}}
>>

Utilisation des rappels

Lorsque la date d’un rappel est atteinte, un lien ‘*ticklers*’ clignote sur le bandeau en haut du document mGsd.

Cliquer sur ce lien ouvre un tiddler contenant la liste des rappels du jour.

Plusieurs actions sont possibles pour chacun d’eux suivant sa périodicité :

• fermer le rappel one time en le cochant
• activer le rappel pour la prochaine date d’activation en cliquant le lien ‘+d’, ‘+w’, ‘+f’, ‘+m’, ‘+y’
• ouvrir le rappel pour ensuite le supprimer en cliquant le lien ‘delete’
• ouvrir le rappel pour en modifier les propriétés

Suppression d’un rappel

Un rappel n’est qu’un tiddler spécialisé. Sa suppression se fait en l’ouvrant dans le document mGsd, puis en cliquant le lien ‘delete’.

Un menu personnalisé pour MonkeyGtd/mGSD

Il y a quelques tiddlers auxquels je veux pouvoir accéder souvent et rapidement dans mes documents MonkeyGtd, par exemple le plan du site ou le nuage de tags.

Le moyen le plus simple est d’ajouter un menu déroulant dans la barre de menu du document (DashBoard, Project, etc) .

Vous avez surement découvert le menu déroulant ‘more’ dans la barre de menu du document (DashBoard, Project, etc) en haut de votre document MonkeyGtd.

Ce menu ‘more’ est en fait défini dans le tiddler appelé MainMenu :

 {{tag{<<tag more|GTDComponent>>}}}

Cette ligne indique simplement que tous les tiddlers portant le tag ‘GTDComponent‘ seront disponibles dans le menu déroulant ‘more’. Simple et efficace

J’ai donc ajouté la ligne qui suit pour ajouter un menu ‘tools’.

 {{tag{<<tag tools|QuickAccess>>}}}

Ce menu tools contiendra des liens vers les tiddlers portant le tag ‘QuickAccess‘, par exemple:

Pour alimenter ce menu j’ai donc ajouté le tag ‘QuickAccess‘ à quelques tiddlers utiles, entre autres GtdStats, RelatedUrls, SiteMap, et TagCloud

Faire évoluer ce menu est très simple puisqu’il suffit d’ajouter ou retirer le tag ‘QuickAccess‘ aux tiddlers que l’on veut voir figurer dans le menu.

Mon tiddler « MainMenu » modifié:

[[Dashboard]]
 [[Project]]
/%
 <<tag Realm>>
 {{new{''<<newTiddler label:'+'  title:'New Action'  tag: Action Next GTD>>''}}}
 {{tag{<<tag Action>>}}}
 {{new{''<<newTiddler label:'+' title:'New Project' tag: Project GTD>>''}}}
 {{tag{<<tag Project>>}}}
 {{new{''<<newTiddler label:'+' title:'New Tickler' tag: Tickler GTD>>''}}}
 {{tag{<<tag Tickler>>}}}
 {{new{''<<newTiddler label:'+' title:'New Context' tag: Context GTD>>''}}}
 {{tag{<<tag Context>>}}}
 {{new{''<<newTiddler label:'+' title:'New Area' tag: Area GTD>>''}}}
 {{tag{<<tag Area>>}}}
%/
@@padding-left:1em;font-size:70%;
 [[starred|Starred]] &nbsp;&nbsp;
 {{tag{<<tag inbox|InboxTiddlers>>}}}
 {{tag{<<tag updt|UpgradeTools>>}}}
 {{tag{<<tag more|GTDComponent>>}}}
 {{tag{<<tag tools|QuickAccess>>}}}

@@
 @@padding-left:1em;color:[[ColorPalette::PrimaryLight]];<<tiddler MonkeyGTDVersion>>@@

Add a custom menu to MonkeyGtd/mGSD

In my monkeyGtd documents I want to keep a quick access to a few tiddlers, for example the tag cloud, the site map and the projects statistics.

The quickest mean to achieve this is to add a custom drop down menu to the main menu.

You already know the ‘more’ menu. It is defined in the ‘MainMenu’ tiddler :

 {{tag{<<tag more|GTDComponent>>}}}

This single line simply tells that any tidller tagged as ‘GTDComponent’  will appear in the ‘more’ dropdown menu. Quick, easy, efficient.

So I have added this line to add a ‘tools’ menu:

 {{tag{<<tag tools|QuickAccess>>}}}

This menu will contain links to eacha and every tiddler tagged as  ‘QuickAccess‘, for example :

To feed this menu I have simply tagged as  ‘QuickAccess’  the GtdStats, RelatedUrls, SiteMap, and TagCloud tiddlers

This menu can be quickly modified by tagging/untagging tiddlers as ‘QuickAccess’.

My Modified ‘MainMenu’ tiddler:

[[Dashboard]]
 [[Project]]
/%
 <<tag Realm>>
 {{new{''<<newTiddler label:'+'  title:'New Action'  tag: Action Next GTD>>''}}}
 {{tag{<<tag Action>>}}}
 {{new{''<<newTiddler label:'+' title:'New Project' tag: Project GTD>>''}}}
 {{tag{<<tag Project>>}}}
 {{new{''<<newTiddler label:'+' title:'New Tickler' tag: Tickler GTD>>''}}}
 {{tag{<<tag Tickler>>}}}
 {{new{''<<newTiddler label:'+' title:'New Context' tag: Context GTD>>''}}}
 {{tag{<<tag Context>>}}}
 {{new{''<<newTiddler label:'+' title:'New Area' tag: Area GTD>>''}}}
 {{tag{<<tag Area>>}}}
%/
@@padding-left:1em;font-size:70%;
 [[starred|Starred]] &nbsp;&nbsp;
 {{tag{<<tag inbox|InboxTiddlers>>}}}
 {{tag{<<tag updt|UpgradeTools>>}}}
 {{tag{<<tag more|GTDComponent>>}}}
 {{tag{<<tag tools|QuickAccess>>}}}

@@
 @@padding-left:1em;color:[[ColorPalette::PrimaryLight]];<<tiddler MonkeyGTDVersion>>@@

Quelques macros pour tiddlywiki et MonkeyGtd

J’ai écrit quelques macros pour Tiddlywiki et son dérivé  MonkeyGtd (maintenant appelé mGTD), mais le temps manque un peu pour toutes les présenter ici. Peut-être plus tard…

Je les ai incluses dans ce fichier (click droit puis « Enregistrer vers… » pour le télécharger). Toutes mes macros et adaptations sont tagguées aced « MadeByJbu », histoire de les retrouver facilement pour un export/import par exemple. Le menu principal a été quelque-peu modifié.

Il y a une démo/tutoriel expliquant leur fonctionnement.

J’ai nettoyé intensivement ce fichier mais si le travail d’un autre s’y trouvait et que cela posait problème, laissez-moi un commentaire et je ferai le nécessaire.

Je publie le tout sous la même licence que Tiddlywiki.

A few tools for tiddlywiki

I have written a few macros for Tiddlywiki and its derivate MonkeyGtd (now known as mGSD) , but time lacks a bit to present them all here.

So this file (right click and then « Save to… » to download it) will bring them all to you. All my macros and modifications are tagged with « MadeByJbu » for me to find them easily. The main menu has been modified quite a bit.

Yes, there is a demo included.

I have cleaned this file intensively but if somebody else’s work was present and I hadn’t found it out please leave a comment and I will fix it.

I publish them under the same licence as TiddlyWiki.

Tiddlywiki linking within a directory

In my everyday use of tiddlywiki and myMonkeyGtd I have found some limits and lacking  functionnalities.

I have already written two macros to  fulfill a few of theses lacks with : ‘UntaggedTiddlers’, gives a list of all untagged tiddlers, whereas ‘gtdStats’ gives a few metrics about the projects progression.

A few more a being written with many working javascript code pieces.

There must be some limit about the maximum size of a tiddlywiki document, after which performances are decreasing dramatically.

My main MyMonkeyGtd document must have met this limit, and I have had to cut it into several domains:

• professionnal projects and matters
• private projects and matters
• more or less organized notes, glued together with a few imported macros (tag cloud, sitemap, etc)
• a template for other futures needs

This split seems to be optimal for me in terms of document size and speed, but I happen to need the possibility to quicky jumps between my 4 or five documents.

These tiddlywiki s are all in the same directory so their urls are alike, and I have given them names stating in ‘gtd_’ appended wiht the domain : notes, tsks, etc.

So I have written this little  ‘relatedUrls’ macro which will be called with a list of domains to list.When displayed this tiddler will show a list of links, each of which giving way to the corresponding document.

Example:

Related documents:
<<RelatedUrls Notes Tsks Work>>

Displayed result:

Related documents:
* Notes
* Tsks
* Work

Notes:

• The link to the target document is not displayed
• The target document file name will be « gtd » concatenated with  the domain name and then ‘.html’. In the example seen a little earlier the ‘Work’ link will bring you to the file:///my_dir/gtdTsks.html document.

The ‘gtd’ prefix can be changed at will by editing the macro source code.

The french version of this blog post is here (https://leblogdejean.wordpress.com/2010/07/11/relier-des-tiddlywikis-au-sein-dun-repertoire/)

Code source:

/***
|!Plugin Name|Related Urls Macro|
|!Description:|Displays informations about the browser and its host OS|
|!Author|[[Jean Buchet|http://buje.free.fr/index.php]]|
|!Version|1.1.0|
|!Date:|2009/03/17|
|!Usage|<////<RelatedUrls>////>|
|!Source:| |

!History

!Code
***/
//{{{

version.extensions.RelatedUrls= {major: 1, minor: 1 , revision: 0, date: new Date(2009,03, 17)};

config.macros.RelatedUrls= {
prefix : "gtd"
};

config.macros.RelatedUrls.handler = function(place,macroName,params) {

var GtdStatsWrapper = createTiddlyElement(place,"div",null,"GtdStats",null);

var l_href=location.href;
var results="";
var last_slash = l_href.lastIndexOf('/') + 1;

var l_base = l_href.substring(0, last_slash);
var l_url  = l_href.substring(last_slash, l_href.lastIndexOf('.') );

for (var i=0;i<params.length; i++) {
l_f=params[i];
if (config.macros.RelatedUrls.prefix + l_f != l_url) {
results=results + "* [[" + l_f + "|" + l_base + config.macros.RelatedUrls.prefix + l_f + ".html]] \n";
}
}

wikify(results, place);
}

//}}}

Relier des tiddlywikis au sein d’un répertoire

Dans mon utilisation de MyMonkeyGtd, je suis parfois confronté à des limitations, ou à des fonctionnalités manquantes.

J’ai déjà comblé deux de ces manques, en développant les macros ‘UntaggedTiddlers’, qui liste les tiddlers sans tag et ‘gtdStats’ qui indique visuellement la progression des différents projets.

D’autres macros sont toujours en phase de mûrissement, et parfois des bouts de code javascript fonctionnant presque.

Il existe apparemment une limite de taille, au delà de laquelle les performances de l’outil sont nettement en baisse.

Mon exemplaire de MyMonkeyGtd a appremment atteint cette limite, et j’ai dû me résoudre à le découper en plusieurs domaines :

• pour les projets professionnels
• pour les projets personnels
• notes, plus ou moins organisées via les macros siteMap et tagCloud
• un modèle à copier pour d’éventuels nouveaux domaines

Si la séparation par domaines est optimale en termes de taille de fichier et de rapidité, il m’est parfois nécessaire de passer rapidement de l’un à l’autre.

Ces documents se trouvent tous dans le même répertoire; la base de leurs urls sera donc la même. De même, leurs noms commençent tous par ‘gtd’.

Seul le nom du domaine change.

J’ai donc écrit une petite macro ‘relatedUrls’ qui sera incluse directement dans un tiddler en lui fournissant une liste de domaines. A l’affichage du tiddler, une liste de lien sera affichée, et chacun de ces liens permettra d’ouvrir le document correspondant.

Exemple:

Related documents:
<<RelatedUrls Notes Tsks Work>>

Résultat affiché:

Related urls:
* Notes
* Tsks
* Work

Notes:

• Le lien vers le document source n’est pas affiché
• Le nom du document associé à un domaine est « gtd » + nom du domaine cliqué + « .html ». Dans l’exemple vu un peu plus haut le lien ‘Work’ dans le document file:///mon_rep/gtdTsks.html ouvrira le document file://mon_rep/gtdWork.html

Si le préfixe ‘gtd’ n’est pas souhaité, ou si vous souhaitez en changer, il suffit de modifier le contenu de la variable prefix dans le code de la macro.

La version anglaise de ce post est ici.

Code source:

/***
|!Plugin Name|Related Urls Macro|
|!Description:|Displays informations about the browser and its host OS|
|!Author|[[Jean Buchet|http://buje.free.fr/index.php]]|
|!Version|1.1.0|
|!Date:|2009/03/17|
|!Usage|<////<RelatedUrls>////>|
|!Source:| |

!History

!Code
***/
//{{{

version.extensions.RelatedUrls= {major: 1, minor: 1 , revision: 0, date: new Date(2009,03, 17)};

config.macros.RelatedUrls= {
prefix : "gtd"
};

config.macros.RelatedUrls.handler = function(place,macroName,params) {

var GtdStatsWrapper = createTiddlyElement(place,"div",null,"GtdStats",null);

var l_href=location.href;
var results="";
var last_slash = l_href.lastIndexOf('/') + 1;

var l_base = l_href.substring(0, last_slash);
var l_url  = l_href.substring(last_slash, l_href.lastIndexOf('.') );

for (var i=0;i<params.length; i++) {
l_f=params[i];
if (config.macros.RelatedUrls.prefix + l_f != l_url) {
results=results + "* [[" + l_f + "|" + l_base + config.macros.RelatedUrls.prefix + l_f + ".html]] \n";
}
}

wikify(results, place);
}

//}}}

WOAS, TiddlyWiki, MonkeyGtd : Un wiki dans votre poche

Kesako Wiki ?

Les wikis sont un très bon moyen de collecter et retrouver de l’information. Ce sont en général des sites web modifiables par tout un chacun, moyennant éventuellement la création d’un compte utilisateur.

Ils sont très largement répandus, notemment, les sites dédiés aux logiciels libres.

Le plus connu est peut-être Wikipedia.

Leur fonctionnement est très simple, puisqu’il suffit d’accéder à un site web dans un navigateur internet.

Certains wiki prennent la forme d’un logiciel dédié, d’autres sont un simple document html. Vous pouvez donc les emporter sur une clé usb, et y accéder dès que ça devient nécessaire, et que vous avez un ordinateur à portée de main.

Voici une (courte) présentation de trois exemples :

• WOAS aka « Wiki An A Stick »
• TiddlyWiki
• MonkeyGtd

WOAS aka « Wiki An A Stick »

WOAS est un logiciel de type wiki intéressant à plus d’un titre, puisqu’il est contenu dans un unique document html, avec une bonne dose de javascript.

Les modifications effectuées sur un document WOAS peuvent être enregistrées localement sur votre ordinateur, voire sur une clé usb, d’où son nom (Stick = Clé USB).

L’avantage est que vos données restent à disposition pour consultation et/ou enrichissement dès qu’un ordinateur est disponible.

Bien entendu, ce wiki « de poche » pourra être rendu accessible sur votre site internet.

TiddlyWiki

TiddlyWiki est en quelque sorte un descendant de WOAS.

C’est un wiki « portable » lui aussi, puisque son document html peut lui aussi être enregistré localement et/ou sur une clé usb.

Dans un document TiddlyWiki les informations sont stockées dans des « tiddlers ». Chacun d’eux possède un titre, qui pourra servir de lien interne, une liste de tags, et un contenu textuel.

Les deux grosses avancées de TiddlyWiki tiennent en deux mots : tags, et plugins.

Les plugins d’abord, sont très nombreux. Voir par exemple sur le site TiddlyTools, qui en propose plus d’une centaine. Cetains sont des gadgets (jeux, etc) , mais la plupart apportent des fonctionnalités (sitemap, tagcloud, etc).

Ce sont simplement des tiddlers contenant du code javascript, et portant le tag « systemConfig ».

L’installation et le paramétrage de ces plugins est des plus simples.

Les tags ensuite, ont plusieurs buts :

• repérer et activer au chargement du document les plugins, qui portent le tag « systemConfig »
• regrouper les tiddlers par domaines. Par exemple, les tiddlers comportant des listes pourront porter le tag « liste ». Les tags sont utilisés par certains plugins, tels que : * TaddlyTagging : L’affichage d’un tiddler est enrichi de la liste des tiddlers dont il est l’un des tags. Par exemple, l’affichage du tiddler « liste », contiendra la liste des tiddlers portant le tag « liste » * siteMap : permet d’afficher le plan du wiki restreint à une liste de tags ** tagcloud : affichage d’un nuage de tags tel que celui de del.icio.us

MonkeyGtd

MonkeyGtd est une variante de TiddlyWiki, enrichie de fonctionnalités de type « GTD ».

GTD – littéralement « Getting Things Done » est une méthode de travail. Pour l’essentiel, cetet méthode repose sur :

• la collecte des informations et des tâches à effectuer
• le groupement des tâches en projets
• l’examen récurrent des projets et des tâches pour prioriser ces tâches

Ce résumé ne conviendra bien entendu pas aux afficionados de cette méthode mais c’est à mon sens une bonne approche.

MonkeyGtd donc, propose des fonctionnalités de base de suivi de projets, en permettant de créer et faire évoluer dans des tiddlers des projets et les actions (tâches) de ces projets.

Une action peut être dans un des états suivants

• next : il s’agit d’une action exécutable dès que possible
• future : action à effectuer plus tard
• waiting for : un événement que l’on attend
• done : action déjà exécutée et terminée

Quelques tiddlers spécifiques permettent d’afficher les prochaines actions (next) par projet, par domaine (area), par contexte.

Les notions de domaine (area) et de contexte sont détaillés ici et sur le site de David Allen.

MonkeyGtd étant à la base une évolution de TiddlyWiki, de nombreux (sinon la plupart) des plugins de ce dernier sont utilisables dans MonkeyGtd.

Pour conclure

Ces trois produits sont très utiles dans leur domaine. Si WOAS se cantonne à être un wiki transportable, TiddlyWiki et MonkeyGtd possèdent des fonctionnalités assez avancées, et pourront être utilisés comme de vrais sites de type CMS ou Systèmes de Gestion de Contenus.

Pour ma part j’utilise MonkeyGtd enrichi de quelques macros provenant de TiddlyTools, plus deux macros dont GtdStats décrite dans ce billet, et quelques autres astuces et « customisations ».

Liens :

• TiddlyWiki
• TiddlyWiki
• TiddlyTools
• MonkeyGtd
• Suivre l’avancement de vos projets avec MonkeyGtd
• Présentation de monkeyGtd sur le blog de Bigloo
• Getting things Done
• Le site de David Allen

Mise à jour : Suivre l’avancement de vos projets avec MonkeyGtd

Dans le billet Suivre l’avancement de vos projets avec MonkeyGtd j’ai présenté un outil (une macro en fait) permettant de collecter les données indiquant l’avancement de vos projets.

Les données ainsi fournies sont utilisables après un simple copier/coller dans votre tableur, par exemple pour créer une présentation visuelle de l’état de vos différents projets.

Le principal inconvénient de cette macro était justement de nécessiter un tableur.

Je vous propose ici une version autonome de cette macro. Le « graphique » est maintenant affiché directement dans un tiddler :

Réalisation

Pour la réalisation, je me suis appuyé sur le fonctionnement de la macro TagglyTagCloud:

La macro est, comme toujours dans Tiddlywiki et ses dérivés, simplement constituée par du code javascript contenu dans un tiddler portant le tag « systemConfig » (attention à la casse des caractères).

L’affichage s’effectue en faisant un appel à la macro, en incluant le texte « <> » (attention ici encore à la casse) dans un tiddler.

Installation

• Créer un tiddler appelé « GtdStatsMacro » et portant le tag « systemConfig ».
• Copier et coller le code présenté plus bas dans la note de ce tiddler
• Enregistrer le tiddler (bouton « done »)
• Enregistrer le document entier (commande « save changes »)
• Recharger le document dans votre navigateur

Utilisation

L’affichage dans un tiddler s’effectue en y faisant un appel à la macro, qui consiste en le texte « GtdStats » précédé de deux caractères « inférieur » et suivi de deux caractères « supérieur »

Les colonnes affichées sont :

• Nom du projet. Il suffit d’y cliquer pour afficher le projet correspondant.
• Actions : nombre d’actions du projet. Attention : je n’y compte pas les actions du type « Waiting for », vu que ce type d’action est particulier (on attend un événement)
• Mass : représentation visuelle du nombre d’actions.
• Done : nombre d’actions terminées
• Todo : nombre d’actions restant à faire (à l’exclusion du type « Waiting for »
• future : nombre d’action de type « future »
• %done : pourcentage d’actions terminées, ie : done / ( done + todo + future ) * 100
• Completion : représentation visuelle de l’avancement du projet
• W/for : nombre d’événements attendus (actions de type « Waiting for »)
• Adherence : représentation visuelle du nombre d’événements attendus

Suit une version .csv des données de base, par exemple pour exploitation dans un tableur.

Améliorations envisagées

• Nettoyage du code, qui est pour le moment pour le moins illisible
• Affichage des données par projet, par domaine (area), ou par contexte, en fonction de paramètres passés à la macro
• Ajout de l’affichage des données globales

Licence d’utilisation

Ce code est utilisable et diffusable dans le cadre de la licence GPL (V3)

Et maintenant, le code de la macro

Le code de la macro se trouve dans le fichier disponible ici.

Copiez-en le contenu dans un tiddler nommé GtdStatsMacro comme spécifié plus haut.