From 97f4d117c23694311c757d349992775d58c678af Mon Sep 17 00:00:00 2001 From: RochDLY Date: Fri, 22 Dec 2023 13:26:42 +0100 Subject: publication du billet sur Stylo et du billet sur les snippets --- .../posts/2023-12-06-les-aventures-dans-stylo.html | 64 +++++++++++++++++++ .../2023-12-22-les-snippets-dans-lazyvim.html | 74 ++++++++++++++++++++++ 2 files changed, 138 insertions(+) create mode 100644 docs/posts/2023-12-06-les-aventures-dans-stylo.html create mode 100644 docs/posts/2023-12-22-les-snippets-dans-lazyvim.html (limited to 'docs/posts') diff --git a/docs/posts/2023-12-06-les-aventures-dans-stylo.html b/docs/posts/2023-12-06-les-aventures-dans-stylo.html new file mode 100644 index 0000000..1aa237d --- /dev/null +++ b/docs/posts/2023-12-06-les-aventures-dans-stylo.html @@ -0,0 +1,64 @@ + + + + + + + + Roch Delannay | Les aventures dans Stylo + + + + + + + + + + + + +
+
+
+

Les aventures dans Stylo

+ + + +
+
+

Cet automne a été particulièrement dense. Lorsque j’écris ces lignes je suis à quelques jours de quitter une nouvelle fois Montréal pour repartir à Paris. Ce séjour n’aura pas été de tout repos, bien au contraire. L’ambiance ressentie (que ce soit chez les collègues français ou québécois) traduit clairement un épuisement général auquel je n’échappe pas.

+

Lors de mon séjour à la CRCEN ces derniers mois, j’ai principalement consacré mon temps au projet de recherche Stylo, à ses développements, à sa maintenance, aux expérimentations menées avec les partenaires du projet (revue Humanité Numériques et Métopes), aux échanges avec les différents acteurs qui participent de manière plus ou moins proche à ses développements (Antoine, Marcello, David, Guillaume, Maïtanné, Louis-Olivier, Servanne, Nicolas, Yves (x2), Camille), à dispenser des formations ou encore à m’occuper de la hotline par courriel, en présence ou en visioconférence, réviser la documentation (sur laquelle il faut encore revenir), etc.

+

Pour une recherche (plus globale que Stylo) qui devrait être menée en contexte numérique, je n’aurais jamais autant écrit le mot Stylo sur une temporalité aussi courte (on ne dirait pas comme ça mais 4 mois passent bien trop rapidement !).

+

Au milieu de ce parcours est apparue une embûche : une demande de financement refusée … Plusieurs semaines de travail tombent à l’eau et le calendrier des développements doit être repensé. Ça mine un peu le moral. Ce projet, appelé Péristyles par ses membres, que j’affuble du petit nom de Stylopes, tombe à l’eau pour une raison incompréhensible : “on” ne sait pas si les auteurs sauront s’approprier l’outil. Allez dire cela à notre petit bassin d’utilisateur.trice.s (environ 4500 personnes) !

+

Le gros chantier de ce trimestre a été la version 3.0 de Stylo : on a mis à jour la documentation, fait des tests en pagaille sur toutes les instances de préproduction pour vérifier que tout fonctionnait correctement, préparé un peu de communication sur le sujet (on a quand même été présent pendant 5 jours sur les réseaux sociaux et sur quelques listes de diffusion DH) et, miracle, tout se passe comme sur des roulettes.

+

Stylo est maintenant doté de nouvelles fonctionnalités (et boutons) :

+
    +
  • un mode d’écriture collaborative synchrone stable (on peut même kicker des personnes qui travaillent sur un article #troll)
    • +
  • un nouvel export en XML TEI compatible avec le schéma COMMONS (du coup on peut aller faire un coucou à Métopes et OpenEdition)
    • +
  • une interface (presque) bilingue
    • +
  • une refonte du comportement des versions des documents
    • +
  • une nouvelle fonctionnalité de partage stable nommée « espace de travail »
    • +
+

La date de release était fixée au 20 novembre 2023 et les journées / semaines qui ont suivies ont été dédiées à traquer et à chasser les bugs qui pouvaient traîner.

+

Un autre chantier de Stylo est l’expérimentation avec la revue Humanités Numériques (publiée par le diffuseur OpenEdition). L’idée est simple : accompagner la revue dans un changement de workflow et remplacer MSWord par Stylo. Pour réaliser ce projet nous avons mis en place une expérience pour tester la chaîne Stylo > Métopes > Lodel à partir d’un article (qui est très long et à travers lequel on a rencontré tous les problèmes possibles !).

+

D’ailleurs l’article a vu le jour sur le site de la revue ! On peut le retrouver ici et l’équipe de la revue parle de nous dans son édito !

+

Ce qui ressort de ces quelques mois est la nécessité d’intégrer une vérification de la syntaxe Markdown dans les articles de Stylo : la plupart des erreurs rencontrées par les usagers sont de cet ordre-là. Certes il y a la documentation en ligne mais personne (ou peu de personnes) ne va la consulter. En conséquence, la hotline se retrouve submergée pour des problèmes relativement simple à résoudre, alors qu’un bon linter Markdown pourrait au moins en dégrossir la plupart. C’est un truc auquel on pense depuis un moment mais c’est une fonctionnalité reportée à plus tard faute de financement !

+
+
+ + \ No newline at end of file diff --git a/docs/posts/2023-12-22-les-snippets-dans-lazyvim.html b/docs/posts/2023-12-22-les-snippets-dans-lazyvim.html new file mode 100644 index 0000000..c98d351 --- /dev/null +++ b/docs/posts/2023-12-22-les-snippets-dans-lazyvim.html @@ -0,0 +1,74 @@ + + + + + + + + Roch Delannay | Les snippets dans LazyVim + + + + + + + + + + + + +
+
+
+

Les snippets dans LazyVim

+ + + +
+
+

Aujourd’hui je viens de tester l’utilisation des snippets dans LazyVim (il y aura un prochain billet sur la configuration de mon environnement d’écriture.).

+

Pour faire des snippets rien de plus simple ! Il suffit de charger le plugin LuaSnip (merci au fil de discussion) :

+
  {
+    "L3MON4D3/LuaSnip",
+    config = function()
+      require("luasnip.loaders.from_lua").load({ paths = "~/.config/nvim/snippets" })
+    end,
+  },
+

puis d’ajouter les snippets en LUA dans le dossier donné dans le chemin ci-dessus.

+

Pour mon premier snippet, j’ai créé un noeud texte pour générer le YAML des posts de ce blog.

+
local ls = require("luasnip")
+local s = ls.snippet
+local t = ls.text_node
+
+return {
+  -- Example of a multiline text node
+  s({trig = "@post", dscr = "return yaml for posts on my blog."},
+    {
+      t({"---", "title: ''", "date:", "---"})
+    }
+  ),
+  }
+

C’est aussi simple que ça ! Il me suffit d’appeler le déclencheur @post pour voir apparaître mes 3 lignes de YAML :-)

+
+Un petit exemple + +
+
+
+ + \ No newline at end of file -- cgit v1.2.3