{ "url": "https://11d.im/journal/2026/20260820144915-zen-ecriture-fichiers-markdown-texte/", "published": "Thu Aug 20 2026 16:49:15 GMT+0200 (Central European Summer Time)", "updated": "Thu Aug 20 2026 16:49:15 GMT+0200 (Central European Summer Time)", "author": { "name": "tk", "url": "https://11d.im" }, "content": "
\n

Ce site est statique.\nLe contenu est stock\u00e9 sous forme de fichiers au format Markdown, pratique pour les humains,\nqui sont transform\u00e9s en fichiers html, parce que c'est la base du web,\npar un g\u00e9n\u00e9rateur de site statique (ou static site generator en anglais), eleventy en l'occurrence,\nqui sont enfin stock\u00e9s sur un serveur\nqui ne fait plus rien d'autre que de fournir ces fichiers aux navigateurs et les quelques robots aspirateurs du web qui se seraient perdus en chemin.\nCe dispositif se diff\u00e9rencie de la configuration classique avec un logiciel de publication accol\u00e9 \u00e0 une base de donn\u00e9es qui g\u00e9n\u00e8re, plus ou moins, les pages \u00e0 la demande et donc avec parfois plus d'actualit\u00e9.\nOn parle alors de pages dynamiques.\nCe \"on\" est tr\u00e8s g\u00e9n\u00e9rationnel. Je ne sais pas si c'est encore d'actualit\u00e9 de faire la diff\u00e9rence entre pages statiques et pages dynamiques. Le javascript partout a bien brouill\u00e9 cette fronti\u00e8re.\nC'est ce que fait le classique Wordpress qui fait tourner une bonne partie des blogs et des sites pas si petits et pas toujours perso.\nLe probl\u00e8me de ce genre de syst\u00e8me, c'est qu'il requiert une maintenance et une attention permanente.\nUne faille de s\u00e9curit\u00e9 ou un bug doivent \u00eatre rem\u00e9dier imm\u00e9diatement.\nSans cela, on se retrouve avec un serveur pirat\u00e9 un 31 d\u00e9cembre \u00e0 18:00.\nC'\u00e9tait en 2010, je m'en souviens encore, \u00e7a m'a traumatis\u00e9 et l'efficacit\u00e9 vaccinale est encore \u00e0 95 %.

\n

Pour publier une nouvelle page, la premi\u00e8re \u00e9tape jusque-l\u00e0 \u00e9tait donc de produire un fichier Markdown que j'ins\u00e9rais dans l'historique d'un d\u00e9p\u00f4t git.\nPour \u00e9diter du Markdown, il y en a pour tous les go\u00fbts du minimalisme avant-gardiste d'IA Writer dont Apostrophe, l'\u00e9mule pour gnome est tr\u00e8s solide, \u00e0 l'\u00e9rudit Zettlr.\nEn vrai n'importe quel \u00e9diteur de fichier texte, et donc de code, fait l'affaire, m\u00eame notepad.

\n

Pour ma part, j'utilise neovim dans une configuration minimale parce que j'ai pris go\u00fbt \u00e0 la navigation au clavier et \u00e0 son interface modale.\nJ'y retrouve l'intentionnalit\u00e9 lente et minutieuse de git.\nChaque op\u00e9ration est nomm\u00e9e et elles se combinent dans une grammaire laissant de la place \u00e0 la cr\u00e9ativit\u00e9 et l'expressivit\u00e9.\nQuand j'y repense, c'est peut-\u00eatre parce que j'ai grandi en parlant \u00e0 une tortue.

\n

Pour que tout se passe bien et que cela ne soit pas trop le bazar, il faut que le fichier soit au bon endroit avec le bon nom.\nTout d'abord, en fonction du type de contenu (article, page, lien, etc.), il faut que cela soit dans le bon r\u00e9pertoire, puis, comme j'aime le chaos ordonn\u00e9, dans le bon sous-dossier, mes fichiers \u00e9tant aussi organis\u00e9s par ann\u00e9e.\nCela me donne commencer une nouvelle ann\u00e9e en repartant de z\u00e9ro.\nPour le nom du fichier, j'aime bien que ce soit ind\u00e9pendant du contenu, mais aussi facile \u00e0 identifier quand je regarde la liste des fichiers d'un r\u00e9pertoire.\nPour cela, je combine la date de cr\u00e9ation de mon texte et parfois le slug, quelques mots qui synth\u00e9tiseront le contenu.\nCe dernier \u00e9l\u00e9ment a \u00e9galement pour raison de rendre les liens plus lisibles et plus humains, surtout quand le texte m'a demand\u00e9 de l'attention.

\n

Dans mon quotidien, j'ai automatis\u00e9 la premi\u00e8re t\u00e2che en utilisant ce genre de commande :

\n
$ vim content/journal/$(date +%Y)/$(date +%Y%m%d%H%M%S).md\n
\n

Je me d\u00e9cide pour le slug seulement quand j'ai le contenu enti\u00e8rement r\u00e9dig\u00e9 et un titre.\nCela m'oblige donc souvent \u00e0 renommer le fichier.\nS'ensuit enfin un petit pas de danse avec git, un commit puis un push quand je ne passe pas par une branche et qui est une tout autre chor\u00e9graphie en soi.\nLazygit m'offre un bon compromis entre automatisation/interface graphique et op\u00e9rations.\nJe ne tape plus des commandes, j'utilise des raccourcis clavier et je n'ai qu'\u00e0 r\u00e9diger le message qui me permettra de garder un historique lisible.

\n

Chaque geste a son importance et j'appr\u00e9cie le niveau de contr\u00f4le que cela peut me fournir.\nC'est tr\u00e8s zen, mais, des fois, j'ai juste envie d'une boisson chaude en faisant autre chose sans avoir \u00e0 me lancer dans une c\u00e9r\u00e9monie du th\u00e9.\nC'est \u00e9galement \u00e0 chaque fois des petites doses d'attention qui me fatiguent par avance ou en cours de route.

\n
", "content-plain": "Ce site est statique. Le contenu est stock\u00e9 sous forme de fichiers au format Markdown, pratique pour les humains, qui sont transform\u00e9s en fichiers html, parce que c'est la base du web, par un g\u00e9n\u00e9rateur de site statique (ou static site generator en anglais), eleventy en l'occurrence, qui sont enfin stock\u00e9s sur un serveur qui ne fait plus rien d'autre que de fournir ces fichiers aux navigateurs et les quelques robots aspirateurs du web qui se seraient perdus en chemin. Ce dispositif se diff\u00e9rencie de la configuration classique avec un logiciel de publication accol\u00e9 \u00e0 une base de donn\u00e9es qui g\u00e9n\u00e8re, plus ou moins, les pages \u00e0 la demande et donc avec parfois plus d'actualit\u00e9. On parle alors de pages dynamiques. Ce \"on\" est tr\u00e8s g\u00e9n\u00e9rationnel. Je ne sais pas si c'est encore d'actualit\u00e9 de faire la diff\u00e9rence entre pages statiques et pages dynamiques. Le javascript partout a bien brouill\u00e9 cette fronti\u00e8re. C'est ce que fait le classique Wordpress qui fait tourner une bonne partie des blogs et des sites pas si petits et pas toujours perso. Le probl\u00e8me de ce genre de syst\u00e8me, c'est qu'il requiert une maintenance et une attention permanente. Une faille de s\u00e9curit\u00e9 ou un bug doivent \u00eatre rem\u00e9dier imm\u00e9diatement. Sans cela, on se retrouve avec un serveur pirat\u00e9 un 31 d\u00e9cembre \u00e0 18:00. C'\u00e9tait en 2010, je m'en souviens encore, \u00e7a m'a traumatis\u00e9 et l'efficacit\u00e9 vaccinale est encore \u00e0 95 %.\n\nPour publier une nouvelle page, la premi\u00e8re \u00e9tape jusque-l\u00e0 \u00e9tait donc de produire un fichier Markdown que j'ins\u00e9rais dans l'historique d'un d\u00e9p\u00f4t git. Pour \u00e9diter du Markdown, il y en a pour tous les go\u00fbts du minimalisme avant-gardiste d'IA Writer dont Apostrophe, l'\u00e9mule pour gnome est tr\u00e8s solide, \u00e0 l'\u00e9rudit Zettlr. En vrai n'importe quel \u00e9diteur de fichier texte, et donc de code, fait l'affaire, m\u00eame notepad.\n\nPour ma part, j'utilise neovim dans une configuration minimale parce que j'ai pris go\u00fbt \u00e0 la navigation au clavier et \u00e0 son interface modale. J'y retrouve l'intentionnalit\u00e9 lente et minutieuse de git. Chaque op\u00e9ration est nomm\u00e9e et elles se combinent dans une grammaire laissant de la place \u00e0 la cr\u00e9ativit\u00e9 et l'expressivit\u00e9. Quand j'y repense, c'est peut-\u00eatre parce que j'ai grandi en parlant \u00e0 une tortue.\n\nPour que tout se passe bien et que cela ne soit pas trop le bazar, il faut que le fichier soit au bon endroit avec le bon nom. Tout d'abord, en fonction du type de contenu (article, page, lien, etc.), il faut que cela soit dans le bon r\u00e9pertoire, puis, comme j'aime le chaos ordonn\u00e9, dans le bon sous-dossier, mes fichiers \u00e9tant aussi organis\u00e9s par ann\u00e9e. Cela me donne commencer une nouvelle ann\u00e9e en repartant de z\u00e9ro. Pour le nom du fichier, j'aime bien que ce soit ind\u00e9pendant du contenu, mais aussi facile \u00e0 identifier quand je regarde la liste des fichiers d'un r\u00e9pertoire. Pour cela, je combine la date de cr\u00e9ation de mon texte et parfois le slug, quelques mots qui synth\u00e9tiseront le contenu. Ce dernier \u00e9l\u00e9ment a \u00e9galement pour raison de rendre les liens plus lisibles et plus humains, surtout quand le texte m'a demand\u00e9 de l'attention.\n\nDans mon quotidien, j'ai automatis\u00e9 la premi\u00e8re t\u00e2che en utilisant ce genre de commande :\n$ vim content/journal/$(date +%Y)/$(date +%Y%m%d%H%M%S).md\n\nJe me d\u00e9cide pour le slug seulement quand j'ai le contenu enti\u00e8rement r\u00e9dig\u00e9 et un titre. Cela m'oblige donc souvent \u00e0 renommer le fichier. S'ensuit enfin un petit pas de danse avec git, un commit puis un push quand je ne passe pas par une branche et qui est une tout autre chor\u00e9graphie en soi. Lazygit m'offre un bon compromis entre automatisation/interface graphique et op\u00e9rations. Je ne tape plus des commandes, j'utilise des raccourcis clavier et je n'ai qu'\u00e0 r\u00e9diger le message qui me permettra de garder un historique lisible.\n\nChaque geste a son importance et j'appr\u00e9cie le niveau de contr\u00f4le que cela peut me fournir. C'est tr\u00e8s zen, mais, des fois, j'ai juste envie d'une boisson chaude en faisant autre chose sans avoir \u00e0 me lancer dans une c\u00e9r\u00e9monie du th\u00e9. C'est \u00e9galement \u00e0 chaque fois des petites doses d'attention qui me fatiguent par avance ou en cours de route.", "syndication": [], "type": "entry", "name": "Le zen dans l'art de publier des fichiers texte" }