Menu

Français,

EmDash

EmDash 1.5.0 : ce que la version change pour un thème

Dix-sept sites montés d'EmDash 1.4.0 à 1.5.0 les 13 et 14 novembre 2026 : ce que fait la migration, ce qu'un thème doit adapter, comment revenir en arrière.

La vallée de Kalalau sur la côte de Na Pali, à Kauai, qui descend vers l'océan.

Aloha Pixel7 min de lecture

EmDash 1.5.0 est sortie sur npm le 11 novembre 2026. Les 13 et 14 novembre, nous avons monté dix-sept sites de la 1.4.0 à la 1.5.0, tous construits sur le même socle, démos des thèmes comprises. Aucun n’a demandé de retour arrière. Voici ce que la montée a fait aux bases, ce qu’il a fallu changer dans le code des thèmes, et l’ordre que nous reprendrions.

Ce qui concerne EmDash vient de l’entrée 1.5.0 du changelog du cœur et du guide de mise à jour. Tout ce qui porte un chiffre a été mesuré sur nos sites.

Ce que la 1.5.0 apporte

L’essentiel, vu depuis un thème :

  • Paramètres > Barres latérales. Chaque utilisateur masque et range les entrées du rail et les sections de la colonne de l’éditeur. Les poignées de déplacement des sections de l’éditeur ont disparu.
  • La co-édition, éteinte par défaut. Elle s’allume par coEditing: true ; sur Cloudflare, un site existant doit en plus déclarer une liaison Durable Object et exporter les classes de salle depuis l’entrée du Worker.
  • Un contrôle de types des options d’emdash(). Une valeur du mauvais type arrête désormais astro dev, astro build et astro sync.
  • Un mode préproduction, qui tient un site tout juste installé hors des moteurs de recherche jusqu’à ce qu’un administrateur le mette en ligne. Les sites existants ne sont pas touchés.
  • Un fournisseur SMTP intégré.
  • Une prop formats sur le composant Image, pour rendre un <picture> avec repli.
  • no-scheduling dans les supports d’une collection. L’ancienne valeur scheduling n’a plus d’effet.
  • $media.file dans les fichiers de graine, pour importer une image locale posée à côté de la graine.

Rien de tout cela n’est imposé à un site existant. Nous avons laissé la co-édition, le SMTP et la préproduction éteints partout.

Monter les versions ensemble

L’adaptateur Cloudflare déclare maintenant emdash en dépendance de pair, à la version exacte. Les deux paquets montent ensemble, sinon l’installation proteste. Nos thèmes fixent les trois paquets d’EmDash, sans accent circonflexe :

"@emdash-cms/admin": "1.5.0",
"@emdash-cms/cloudflare": "1.5.0",
"emdash": "1.5.0"

Nous fixons aussi @cloudflare/kumo à 2.15.0 : les écrans que nous ajoutons au back office emploient la même bibliothèque de composants que l’admin 1.5.0.

Ce que la migration fait à la base

Dans le mode auto, celui par défaut, un site déployé joue les migrations du cœur à sa première requête. La migration ne tourne donc pas au déploiement : elle tourne quand quelqu’un demande la première page.

Mesuré sur nos sites :

  • La première requête après le déploiement a pris 8 à 21 secondes, selon le site. C’est elle qui porte la migration. Les suivantes sont normales.
  • La table des migrations passe de 90 à 96 entrées. Six migrations du cœur, de 092 à 097, la dernière nommée 097_room_storage.
  • Le nombre de lignes des menus, des réglages et du stockage des plugins est resté identique avant et après. Nous les avons comptées des deux côtés.
  • La table revisions gagne deux colonnes, avec les mêmes lignes. C’est ce que dit le changelog : kind et edited_by sont ajoutées, et les versions existantes ne sont pas complétées.
  • Deux tables vides apparaissent pour les salles de co-édition.

Une conséquence lue dans le changelog mérite une ligne dans votre procédure : une fois la migration des révisions jouée, une version antérieure d’EmDash ne peut plus exporter ce site ni y importer par transfert de site.

Prendre un vrai point de reprise

Nous comptions exporter la base avant chaque montée. Cela ne marche pas : wrangler d1 export échoue sur une base EmDash, parce que la recherche d’EmDash s’appuie sur des tables FTS5. Cloudflare documente la limite : l’export ne prend pas en charge les tables virtuelles, et les tables FTS5 en sont.

Ce qui marche, c’est Time Travel de D1. Avant chaque déploiement, nous avons noté deux choses :

npx wrangler d1 time-travel info <base>
npx wrangler deployments list --name <worker>

La première commande affiche le signet courant de la base, la seconde l’identifiant de la version du Worker en service. Time Travel garde 30 jours d’historique sur l’offre payante, 7 sur l’offre gratuite, et une restauration écrase la base en place. Nous gardons aussi une copie JSON des tables, mais elle sert à lire, pas à restaurer.

Le retour arrière, répété avant

Nous avons joué le retour arrière sur une copie de la base d’une démo avant de toucher à la production. Le Worker est revenu à sa version précédente en 5 secondes, la base a été restaurée à son signet en 6 secondes.

L’ordre compte :

npx wrangler rollback <identifiant> --name <worker> -y
# attendre que /_emdash/api/health réponde "version":"1.4.0"
npx wrangler d1 time-travel restore <base> --bookmark=<signet>

Le Worker d’abord, la base ensuite. Si la base est restaurée pendant que le Worker 1.5.0 sert encore, sa requête suivante la migre de nouveau. Tout ce qui a été écrit après le signet est perdu : nous avons donc choisi un moment sans rédaction en cours et demandé aux éditeurs d’enregistrer leurs fiches ouvertes.

Ce qu’un thème doit adapter

Un thème qui se contente de lire le contenu n’avait rien à changer. Les nôtres vont plus loin : ils ajoutent des écrans au back office et retouchent quelques écrans natifs. Le travail était là.

  • L’interface en français. Nous tenons un catalogue français du back office. Après la montée, 387 messages étaient repassés en anglais : les barres latérales, le SMTP, la préproduction, la co-édition, la validation des formulaires. 295 étaient des chaînes simples, 81 des messages composés, 11 sont identiques dans les deux langues. Un self-check fait échouer le build s’il reste une chaîne anglaise.
  • Tout ce qui s’accroche à l’admin compilé. Notre filtre de la liste des produits retouche treize passages exacts du paquet de l’admin. Douze n’avaient pas bougé en 1.5.0, un avait changé. Le build s’arrête et nomme le passage manquant quand la version de l’admin n’est pas celle attendue : nous l’avons vu avant de déployer, pas après.
  • Les vignettes des listes. En 1.5.0, la cellule du titre porte aussi un rappel du statut et de la date pour les écrans étroits. Notre feuille visait toute la cellule et affichait ce rappel en double sur grand écran. Elle ne vise plus que le lien.
  • L’entrée active du rail. La 1.5 allume la racine d’un plugin sur chacune de ses sous-pages. Notre propre marque s’y ajoutait : deux entrées allumées. Une règle a suffi.
  • Les icônes des menus. La bibliothèque de composants espace maintenant elle-même l’icône d’un élément de menu déroulant. Nous avons retiré une marge posée à la main, à 27 endroits.

Et trois points vérifiés qui n’ont rien demandé : le contrôle de types des options d’emdash() n’a levé aucune erreur sur nos configurations, aucun site n’employait la valeur scheduling, et aucun de nos plugins ne déclare d’index unique, donc la migration qui les modifie n’avait rien à réparer. Si l’un de vos plugins déclare des uniqueIndexes, lisez la partie du guide de mise à jour sur la fenêtre de maintenance avant de déployer : cette migration n’est pas faite pour un déploiement progressif.

Ce qui change pour les éditeurs

Deux choses que vos clients verront :

  • Sur nos sites, le rôle Éditeur n’ouvre plus les pages Général, Liens sociaux et SEO des paramètres. Elles sont réservées aux administrateurs. Si un éditeur changeait le titre du site ou un lien social, faites-le pour lui ou changez son rôle. C’est un constat sur les sites montés ; nous ne l’avons pas trouvé décrit dans les notes de version.
  • Regardez l’écran Menus. Le changelog explique que supprimer un élément de menu laissait jusque-là ses éléments imbriqués en place sur SQLite et D1. Après la montée, nous avons relu chaque menu et retiré ce qui traînait.

L’ordre que nous reprendrions

  1. Dans le site : fixer les quatre versions, installer, puis contrôle de types, tests et build du moteur. Les trois au vert avant de toucher à la production.
  2. Noter le signet Time Travel et l’identifiant de la version du Worker.
  3. Vérifier qu’aucun index du stockage des plugins n’est unique.
  4. Choisir un moment sans rédaction en cours.
  5. Déployer, puis interroger /_emdash/api/health jusqu’à lire 1.5.0, et ouvrir le back office. Une des premières réponses est lente : c’est la migration.
  6. Contrôler : la table des migrations finit par 097_room_storage ; ouvrir l’accueil, une page de contenu, une fiche produit ; dans le back office, la page Plugins, un écran de réglages de plugin, une liste de contenu et Menus.
  7. Si un contrôle échoue : retour du Worker, puis restauration de la base.

Nos thèmes sont sortis en 6.5.0 avec EmDash 1.5.0 fixée, et les templates actuels fixent toujours la 1.5.0, dernière version d’EmDash. La liste est sur la page des templates et chaque version est consignée dans les nouveautés.

À lire aussi

Tous les articles