Le fichier wiki-acronyms.txt

Avant toute chose il faut savoir comment rédiger des acronymes en mode wiki. Je l'ai découvert aujourd'hui aux détours d'une promenade en mer, promenade en mer et je vous le livre d'ors et déjà de but en blanc ci-après.

La syntaxte wiki pour les acronymes est la suivante : ??acronyme|description??.

Lourdeur d'Occident et porcelaine de Limoges s'il faut à tout coup retaper les descriptions d'acronymes qui ont déjà été utilisés des millions de fois sur votre blog. En effet vous répondrais-je, mais ce serait sans compter sur ce fichier de votre répertoire share qui s'apprête à vous révéler sa magie.

Dans le fichier wiki-acronyms.txt se trouvent déjà toute une série d'acronymes placés là par défaut que vous pouvez modifier selon votre gré et au fil du temps.

Pour en ajouter un, c'est très simple : il suffit de mettre l'acronyme en majuscule suivit des trois tabulations, du caractère "deux points", d'un espace et de la description pour terminer. Si tout ça n'est pas clair, et c'est un risque, copiez simplement une ligne et modifiez-la.

Très bien tout ça mais comment utiliser ces nouveaux acronymes dans vos billets ? Simplement en utilisant la syntaxe ci-dessus mais sans le paramètre de description. En effet, le monde est bien fait et DoClear reconnaîtra lui-même si l'acronyme est déjà présent dans la liste.

Bref, c'est gai.

Le fichier wiki-urls.txt

Qu'en est-il de ce fichier alors ? En fait, il contient des urls abrégées pour permettre leurs saisies de façon plus aisée et joyeuse. Vous pouvez désormais rire en écrivant vos billets, c'est trop fou.

Mise en situation : vous êtes désireux de montrer à vos fidèles lecteurs la description wikipédesque du canard et vous n'avez guère l'envie de taper l'url complète parce que vous êtes sur l'ordinateur depuis le matin et que votre clavier fatigue, classique. Ne luttez plus, voilà pour vous un fichier qui est là pour vous aider et pour faciliter votre quotidien.

Le fichier wiki-urls comporte à chaque ligne une expression régulière suivie de l'url cible. Si on regarde de plus près, on voit directement que c'est super entreprenant :

#^wikipedia://(.*)$#

Les # sont des délimiteurs, le symbôle ^ siginifie que c'est le début de la chaîne, ensuite vient le raccourci, puis le $ signifiant la fin de la chaîne. Dans la structure des expressions régulières, les éléments entre paranthèses peuvent être récupérés directement sous forme de variables. La belle affaire me direz-vous.

Vous pouvez voir entre les paranthèses le caractère point qui signifie "n'importe quel caractère" et l'astérisque (et périls) veut quant à elle dire "en n'importe quelle quantité".

L'url quant à elle est terminée par ladite variable :

http://fr.wikipedia.org/wiki/$1

Dans ce cas-ci, c'est $1 puisqu'il n'y avait qu'un seul jeu de paranthèses dans l'expression régulière. On récupère donc ce qui à été tapé et on le place au bout de l'url.

On peut dès lors faire : wikipedia://canard et le tour est joué.

Vous pouvez mettre n'importe quelle url en remplaçant simplement le paramètre voulu par le $. Pour l'utilisation dans les billets, la syntaxe est exactement la même que pour les urls "classiques" : [le canard wikipédesque|wikipedia://canard].

Y en a un peu plus, je vous le met ?

J'ai découvert d'autres raccourcis wiki dans ma folle épopée, je vous les montre donc. La liste n'est pas exhaustive mais c'est le principal.

~ancre~ : <a name="ancre"></a>

{{citation blabla ipsum}} : <q>citation blabla ipsum</q>

@@du code tout plein@@ : <code>du code tout plein</code>

--élément barré-- : <del>élément barré</del>

Et à ceux qui diront que tout cela coulait de source, je répondrai ceci : c'est bien possible oui, je vous l'accorde en toute quiétude.