Travailler avec le contenu

Utilisez l’admin EmDash pour mener une entrée de son premier brouillon à une page publiée. L’éditeur garde les modifications du brouillon séparées de la version que les visiteurs peuvent voir ; enregistrer et publier sont donc deux actions distinctes.

Ouvrir une collection

Ouvrez /_emdash/admin sur votre site et connectez-vous. Sélectionnez une collection, comme Posts ou Pages, dans la barre latérale.

La page de la collection liste ses entrées. Depuis cette page, vous pouvez :

• sélectionner Add New pour créer une entrée ;
• rechercher par titre d’entrée, slug et champs marqués comme pouvant faire l’objet d’une recherche ;
• filtrer par état de publication, auteur, signature, date et locale ;
• sélectionner des entrées pour les publier en lot, les remettre en brouillon ou les déplacer vers la corbeille ; et
• ouvrir Trash pour restaurer ou supprimer définitivement une entrée.

Les champs et les fonctionnalités de publication disponibles dans l’éditeur dépendent du modèle de contenu de la collection. Par exemple, une collection peut prendre en charge les révisions, les aperçus, les taxonomies ou la recherche.

Créer et publier une entrée

L’entrée a un ID de contenu stable et un slug distinct. L’ID continue d’identifier la même entrée si son slug change. Les modèles utilisent normalement l’identifiant tourné vers l’URL renvoyé par getEmDashCollection() ; le guide d’interrogation du contenu explique les deux valeurs.

Rédiger du texte enrichi

Les champs Portable Text fournissent un éditeur de blocs pour les titres, paragraphes, citations, listes, liens, images, galeries, blocs de code, tableaux, blocs HTML et sections réutilisables. Les plugins installés peuvent ajouter d’autres blocs.

Utilisez la barre d’outils pour mettre en forme le texte sélectionné. Pour insérer un bloc, sélectionnez le contrôle d’ajout de bloc à côté d’un paragraphe ou saisissez / et recherchez un bloc par son nom. Les blocs d’image et de galerie ouvrent le même sélecteur de médias que celui utilisé par les champs d’image.

Vous pouvez aussi faire glisser des fichiers image dans l’éditeur ou coller une image copiée ou une capture d’écran. Chaque image est téléversée dans la médiathèque et apparaît entre les blocs environnants une fois le téléversement terminé. Si un téléversement échoue, la raison apparaît à l’endroit où l’image aurait dû se trouver.

Lorsque vous sélectionnez un bloc d’image, une barre d’outils apparaît au-dessus. Utilisez-la pour remplacer l’image, modifier son texte alternatif, l’aligner, ajouter un lien ou supprimer le bloc. Le bouton Alt text est mis en évidence dès que l’image a une description, et le survoler affiche la description. Un texte alternatif qui n’est que le nom de fichier d’une image de la médiathèque ne compte pas. Saisissez une légende dans le champ sous l’image et appuyez sur Entrée pour continuer à écrire en dessous. À partir d’une image sélectionnée, Tab passe à la légende puis à la barre d’outils.

Image settings dans la barre d’outils ouvre tous les réglages de cet usage de l’image, y compris sa taille d’affichage et une infobulle facultative. Edit asset y ouvre l’élément sous-jacent de la médiathèque, où modifier ou remplacer la ressource peut affecter d’autres entrées qui l’utilisent. Voir Médiathèque pour cette distinction.

Ajouter du HTML, du CSS et du JavaScript

Un bloc HTML contient du code que les autres blocs ne peuvent pas exprimer, comme un contenu intégré, un formulaire d’inscription ou un petit widget. Ses onglets sont HTML, CSS, JS et Preview. Chaque onglet de code est un éditeur de code où la touche Tab indente ; appuyez sur Échap pour revenir au texte environnant. Les onglets CSS et JS sont facultatifs : vous pouvez aussi coller un extrait complet, avec ses éléments <style> et <script>, dans l’onglet HTML.

Preview affiche le bloc tel que votre site le rend. Lorsque vous ouvrez une entrée, un bloc qui exécute du JavaScript attend que vous sélectionniez Run preview, afin qu’un script défectueux ne puisse pas figer l’éditeur.

Le menu du bloc définit la manière dont votre site le rend :

• Isolated frame exécute le HTML, le CSS et le JavaScript du bloc dans un cadre en bac à sable (sandbox) qui s’agrandit avec son contenu. Le cadre ne peut lire ni les cookies, ni le stockage, ni les pages de votre site, et les styles de votre site ne l’atteignent pas. Les liens relatifs sont résolus à partir de la racine de votre site. Une fois qu’un visiteur a cliqué dans le cadre, celui-ci peut ouvrir d’autres pages dans l’onglet du visiteur ou dans un nouvel onglet. Les nouveaux blocs HTML utilisent ce mode, contrairement aux blocs collés depuis un autre site web ou un autre onglet du navigateur. Ne dimensionnez pas le contenu d’après la fenêtre d’affichage (viewport) du cadre, par exemple avec height: 100vh : le cadre s’agrandit pour l’accueillir, ce qui rend le contenu à nouveau plus haut, jusqu’à ce que le cadre atteigne 20 000 pixels.
• Inline place le HTML dans la page, où il utilise les styles de votre site. Votre site conserve la mise en forme du texte, les liens, les listes, les tableaux, les images et les iframes, et supprime les autres balises, telles que les scripts, les éléments <style>, les attributs style, les médias et les contrôles de formulaire. Les iframes provenant de sites autres que YouTube et Vimeo sont vidées. Un bloc inline n’a pas d’onglet CSS ni JS.

Les moteurs de recherche peuvent ne pas considérer le texte d’un cadre isolé comme faisant partie de la page. Placez le texte important pour le référencement dans des paragraphes ou dans un bloc inline.

Intégrer une page d’un autre site

Un bloc iframe affiche une page d’un autre site, comme une vidéo, une carte ou un formulaire. Saisissez /iframe, puis collez le code d’intégration du site ou un lien dans l’onglet Code. Les liens YouTube et Vimeo deviennent leurs lecteurs, et tout autre lien https est intégré tel quel. Preview affiche la page intégrée. Lorsque vous ouvrez une entrée, un bloc enregistré attend que vous sélectionniez Load preview, afin que l’admin ne charge pas les pages d’autres sites avant que vous ne le demandiez. Les blocs iframe collés depuis un autre site web ou un autre onglet du navigateur arrivent vides.

Seules les pages https peuvent être intégrées, et le bloc ne conserve que les parties d’un code d’intégration dont il a besoin : l’adresse, le titre, la taille, la prise en charge du plein écran et les autorisations qu’utilisent les lecteurs. Certains sites refusent d’apparaître dans la page d’un autre site ; leur aperçu reste vide ou affiche une erreur provenant de ce site.

Un code d’intégration qui exécute un script plutôt qu’une iframe, comme certaines publications de réseaux sociaux, doit être placé dans un bloc HTML.

Enregistrer les modifications du brouillon

Après le premier enregistrement, l’éditeur enregistre automatiquement les modifications deux secondes après l’arrêt de la saisie. Le bouton Save passe par Saving… puis Saved, ce qui vous permet de confirmer que le serveur a accepté le brouillon. L’enregistrement automatique remplace la révision d’enregistrement automatique courante au lieu de remplir l’historique des révisions avec un point de contrôle à chaque pause.

Sélectionnez Save lorsque vous voulez qu’un point de la séquence d’édition reste dans l’historique des révisions. Si un enregistrement échoue, l’éditeur conserve les champs non enregistrés en place et affiche l’erreur. Ne quittez pas la page tant que le bouton n’est pas revenu à Saved ou que vous n’avez pas copié ailleurs le travail non enregistré.

Pour une entrée publiée, l’enregistrement des modifications ne met à jour que son brouillon. Les visiteurs continuent de recevoir la révision en ligne précédente. Utilisez Preview draft pour vérifier la version en attente, Live View pour vérifier la version publique et Publish changes lorsque le brouillon est prêt à la remplacer.

Modifier le slug d’une entrée publiée suit le même flux de brouillon. L’URL publique change lorsque vous publiez le brouillon, et non lorsque l’enregistrement automatique s’exécute.

Travailler avec un autre éditeur

L’ouverture d’une entrée prend un verrou d’édition pour cette entrée et cette locale. Si une autre personne l’a déjà ouverte, EmDash identifie le détenteur du verrou et propose deux choix :

• Open read-only affiche l’entrée sans accepter de modifications, afin que vous ne saisissiez pas un travail qui serait perdu.
• Take over vous donne le verrou. L’autre personne conserve ce qu’elle a saisi, mais dans un délai de deux minutes son éditeur signale que vous détenez l’entrée. Son prochain enregistrement est refusé.

Le verrou est renouvelé tant que l’entrée est ouverte et libéré lorsque vous quittez l’éditeur ou fermez l’onglet. Si le navigateur ou l’ordinateur se ferme sans le libérer, le verrou expire sept minutes après son dernier renouvellement.

Les verrous sont indépendants pour chaque locale ; deux personnes peuvent donc modifier des traductions différentes de la même entrée. Un script, un client d’API ou un client MCP est également refusé tant qu’un autre éditeur détient le verrou, sauf s’il utilise le contournement documenté. Voir Verrou d’édition d’entrée pour le comportement complet de l’API et Cycle de vie du contenu et signatures pour les outils MCP.

Un administrateur peut désactiver le verrouillage pour une collection sous Content Types, puis la collection, puis Edit locking.

Publier ou planifier des modifications

La publication et la planification utilisent des commandes distinctes :

• Publish now met en ligne un nouveau brouillon après confirmation.
• Publish changes met en ligne les modifications en attente d’une entrée publiée après confirmation.
• Schedule définit le moment où une nouvelle entrée ou des modifications en attente sont mises en ligne.
• Change schedule met à jour une planification existante.
• Remove schedule annule une planification existante.
• Unpublish retire la révision en ligne des requêtes publiques, annule toute planification et conserve un brouillon modifiable.

Pour planifier une entrée, enregistrez-la d’abord, sélectionnez Schedule sous le résumé de publication et choisissez une date et une heure futures. L’éditeur affiche le fuseau horaire utilisé pour la planification. Jusqu’à ce moment, la révision en ligne actuelle reste publique ; pour une nouvelle entrée, rien n’est encore public.

Les déploiements Node.js exécutent automatiquement le balayage de publication planifiée. Cloudflare Workers nécessite un Cron Trigger. Les modèles de démarrage Cloudflare l’incluent ; les déploiements existants peuvent suivre Publication planifiée pour vérifier le déclencheur.

Consulter le calendrier de publication

Le calendrier montre ce qui a été publié et ce qui est planifié dans l’ensemble de vos collections. Les Contributors et les rôles supérieurs peuvent ouvrir Calendar depuis la barre latérale ou la palette de commandes. Lorsque quelque chose est planifié, le compteur Scheduled du tableau de bord y renvoie aussi.

Le calendrier propose deux vues :

• Month affiche une grille de jours. Les entrées publiées apparaissent sous forme de lignes simples et les entrées planifiées sous forme de cartes. Survolez ou mettez le focus sur une entrée pour voir son titre complet, son état, son heure et sa collection. Lorsqu’un jour compte plus d’entrées qu’il n’en tient, sélectionnez +N more pour toutes les lister.
• Agenda liste le mois par jour, avec l’heure de chaque entrée. Dans le mois en cours, les jours avant aujourd’hui sont repliés sauf si l’un d’eux a une entrée en retard, et une ligne rouge marque le moment présent.

Sur un téléphone ou un autre écran étroit, le calendrier s’ouvre en Agenda, et Month affiche un sélecteur de date avec des points sur les jours qui ont des entrées. Sélectionnez un jour pour lister ses entrées.

Sélectionnez une entrée pour ouvrir ses détails dans un panneau latéral, ou cliquez en maintenant Ctrl (Cmd sur macOS) pour l’ouvrir dans l’éditeur dans un nouvel onglet. Le panneau affiche l’état, l’heure, la collection, la locale et les traductions de l’entrée, ses signatures et la date de sa dernière modification. Depuis le panneau, vous pouvez ouvrir l’entrée dans l’éditeur, prévisualiser les modifications planifiées ou afficher une entrée publiée sur le site. Si vous pouvez publier l’ entrée (les Authors pour leurs propres entrées, et les Editors et rôles supérieurs pour toute entrée), vous pouvez aussi la replanifier, supprimer sa planification ou publier immédiatement une entrée en retard. Sur un téléphone, le panneau s’ouvre sous forme de feuille en bas de l’écran.

Utilisez Filter pour restreindre les deux vues par collection et par état, et par locale sur les sites multilingues. Les filtres, la vue, le mois et l’entrée ouverte sont conservés dans l’URL de la page, ce qui vous permet de l’enregistrer en favori ou de la partager.

Les entrées sont placées sur les jours dans le fuseau horaire du site, que le calendrier nomme à côté du mois. Si votre navigateur utilise un autre fuseau horaire, le calendrier le signale, et les heures des entrées apparaissent aussi dans votre propre fuseau horaire.

Le calendrier affiche :

• les entrées publiées à la date de leur publication ;
• les entrées planifiées à leur date planifiée ; et
• les modifications planifiées d’une entrée publiée à leur date planifiée, marquées Update. Une fois les modifications mises en ligne, l’entrée n’apparaît plus qu’à sa date de publication d’origine.

Une planification dont l’heure est dépassée de plus de deux minutes est marquée Overdue. Cela signifie généralement que le balayage de publication planifiée ne s’exécute pas ; voir Publier ou planifier des modifications.

Le calendrier omet les brouillons sans planification, les entrées de la corbeille et les collections masquées dans la barre latérale. Le compteur Scheduled du tableau de bord couvre tous les mois et inclut les collections masquées ; il peut donc être supérieur à ce que le calendrier affiche pour un mois.

Le calendrier charge au plus 1 000 entrées pour un mois, y compris les jours des mois voisins que la grille affiche. S’il y en a davantage, il indique à quel jour les entrées chargées s’arrêtent et marque les jours suivants comme non chargés.

Restaurer une révision

Les collections qui prennent en charge les révisions affichent Revisions dans le panneau des paramètres. Développez-le pour voir les versions enregistrées et les champs qui ont changé entre elles. Sélectionnez une révision pour inspecter son contenu, puis sélectionnez Restore si vous voulez réutiliser cette version.

La restauration crée une nouvelle révision contenant le contenu sélectionné. Elle n’efface pas les révisions qui l’ont précédée ; vous pouvez donc toujours inspecter la séquence complète par la suite.

Traduire une entrée

Lorsque l’internationalisation est activée, le panneau Translations affiche les locales configurées pour l’entrée en cours.

Chaque traduction a son propre slug, son propre état de publication, sa propre planification et son propre historique de révisions. Utilisez le sélecteur de locale de la page de la collection pour afficher une langue à la fois.

Déplacer du contenu vers la corbeille

Ouvrez les actions d’une entrée ou sélectionnez une ou plusieurs lignes sur la page de la collection, puis choisissez Move to Trash. Les entrées mises à la corbeille n’apparaissent plus dans les requêtes de contenu ordinaires mais restent disponibles dans l’onglet Trash de la collection.

Depuis Trash, sélectionnez Restore pour remettre une entrée dans la collection. Une entrée restaurée revient en brouillon, sans planification. Publiez-la pour la rendre publique.

Automatiser le travail sur le contenu

L’API REST et la CLI EmDash prennent en charge le même flux de brouillon et de publication. Les champs de la collection se placent dans l’objet data de la requête. Une mise à jour enregistre une révision de brouillon ; la publication est une action distincte. Transmettez la dernière valeur _rev lors d’une mise à jour ou d’une publication afin que le serveur rejette une écriture obsolète au lieu de remplacer un travail plus récent.

Utilisez la référence du cycle de vie du contenu pour les transitions d’état, les permissions, les conflits et les hooks. La référence de l’API REST définit les corps de requête et de réponse, et la référence de la CLI couvre les commandes de terminal équivalentes.

Poursuivez avec Interroger le contenu pour afficher les entrées publiées dans un site Astro, ou avec la Médiathèque pour ajouter et gérer des fichiers réutilisables.