Archive

Posts Tagged ‘tiddlywiki’

Gérer un blog avec tiddlywiki

novembre 13, 2012 1 commentaire

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

Creative Commons License

Catégories :tiddlywiki, vie du blog Étiquettes : ,

Utilisation des rappels dans Tiddlywiki/mGSD

septembre 18, 2012 2 commentaires

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’.

Creative Commons License

Catégories :tiddlywiki Étiquettes :

Un menu personnalisé pour MonkeyGtd/mGSD

août 12, 2010 2 commentaires

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>>@@

Creative Commons License

Catégories :tiddlywiki Étiquettes :

Add a custom menu to MonkeyGtd/mGSD

août 12, 2010 Laisser un commentaire

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>>@@

Creative Commons License

Catégories :english, tiddlywiki Étiquettes : ,

Quelques macros pour tiddlywiki et MonkeyGtd

juillet 28, 2010 Laisser un commentaire

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.

Creative Commons License

Catégories :tiddlywiki Étiquettes :

A few tools for tiddlywiki

juillet 22, 2010 Laisser un commentaire

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.

Creative Commons License

Catégories :english, tiddlywiki Étiquettes : ,

Tiddlywiki linking within a directory

juillet 12, 2010 1 commentaire

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);
}

//}}}

Creative Commons License

Catégories :english, tiddlywiki Étiquettes : ,
%d blogueurs aiment cette page :