Utilisez l’admin EmDash pour faire passer 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, de sorte que l’enregistrement et la publication sont deux actions distinctes.
Ouvrir une collection
Ouvrez /_emdash/admin sur votre site et connectez-vous. Sélectionnez une collection, telle que Posts ou Pages,
dans la barre latérale.
La page de la collection liste ses entrées. À partir d’ici, vous pouvez :
- sélectionner Add New pour créer une entrée ;
- rechercher par le titre de l’entrée, le slug et les champs marqués comme searchable ;
- filtrer par état de publication, auteur, byline, date et locale ;
- sélectionner des entrées pour une publication en masse, un retour en brouillon ou un déplacement vers la corbeille ; et
- ouvrir Trash pour restaurer ou supprimer définitivement une entrée.
Les champs et les fonctions 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
-
Sélectionnez Add New sur la page de la collection.
-
Remplissez les champs obligatoires. Si la collection a un champ de titre, EmDash l’utilise pour suggérer un slug. Vous pouvez modifier le slug avant de publier.
-
Ajoutez le corps et tout champ d’accompagnement, tel qu’un extrait, une image mise en avant, un byline, des catégories ou des tags.
-
Sélectionnez Save. Le premier enregistrement crée l’entrée en tant que brouillon et ouvre son URL d’éditeur permanente.
-
Examinez le brouillon. Si la collection prend en charge les aperçus, sélectionnez Preview pour voir la page rendue avant de publier.
-
Sélectionnez Publish now, puis confirmez. Le brouillon enregistré devient la version live que les requêtes de contenu publiques renvoient.
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 orienté URL renvoyé par
getEmDashCollection() ; le guide Interroger le contenu
explique les deux valeurs.
Écrire 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 formater le texte sélectionné. Pour insérer un bloc, sélectionnez le contrôle d’ajout de bloc à côté
d’un paragraphe ou tapez / et recherchez un bloc par nom. Les blocs image et galerie ouvrent le même sélecteur de
médias utilisé par les champs image.
Lorsque vous sélectionnez un bloc image, ses paramètres permettent de remplacer ou de retirer cet usage de l’image et de définir sa taille d’affichage, son alignement, son texte alt, sa légende et une info-bulle optionnelle. Edit asset ouvre l’élément sous-jacent de la bibliothèque multimédia, où modifier ou remplacer l’asset peut affecter d’autres entrées qui l’utilisent. Voir Bibliothèque multimédia pour cette distinction.
Enregistrer les modifications du brouillon
Après le premier enregistrement, l’éditeur enregistre automatiquement les modifications deux secondes après que vous avez arrêté de taper. Le bouton Save passe par Saving… à Saved pour que vous puissiez confirmer que le serveur a accepté le brouillon. L’enregistrement automatique remplace la révision d’enregistrement automatique actuelle au lieu de remplir l’historique des révisions avec un point de contrôle pour 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 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é le travail non enregistré ailleurs.
Pour une entrée publiée, enregistrer des modifications met à jour uniquement son brouillon. Les visiteurs continuent de recevoir la révision live 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.
Changer le slug d’une entrée publiée suit le même flux de brouillon. L’URL publique change lorsque vous publiez le brouillon, pas lorsque l’enregistrement automatique s’exécute.
Travailler avec un autre éditeur
Ouvrir 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 montre l’entrée sans accepter d’éditions, afin que vous ne puissiez pas taper un travail qui sera écarté.
- Take over vous donne le verrou. L’autre personne conserve ce qu’elle a tapé, mais dans les 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, de sorte que deux personnes peuvent modifier des traductions différentes de la même entrée. Un script ou un client API est aussi refusé tant qu’un autre éditeur détient le verrou, sauf s’il utilise le override documenté. Voir Verrou d’édition d’entrée pour le comportement API complet.
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 contrôles séparés :
- Publish now rend un nouveau brouillon live après confirmation.
- Publish changes rend live les modifications en attente d’une entrée publiée après confirmation.
- Schedule définit quand une nouvelle entrée ou des modifications en attente deviennent live.
- Change schedule met à jour une planification existante.
- Remove schedule annule une planification existante.
- Unpublish retire la révision live 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 live 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écessitent 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.
Restaurer une révision
Les collections avec prise en charge des 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, de sorte que vous pouvez toujours inspecter la séquence complète ensuite.
Traduire une entrée
Lorsque l’internationalisation est activée, le panneau Translations affiche les locales configurées pour l’entrée actuelle.
-
Ouvrez l’entrée source et trouvez Translations dans le panneau des paramètres.
-
Sélectionnez Translate pour une locale qui n’a pas encore d’entrée.
-
Modifiez le titre, le slug, le corps et les autres champs traduisibles copiés.
-
Sélectionnez Save, puis publiez ou planifiez la traduction lorsqu’elle est prête.
Chaque traduction a son propre slug, état de publication, planification et historique de révisions. Utilisez le sélecteur de locale sur la page de la collection pour afficher une langue à la fois.
Déplacer le 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 à la corbeille cessent d’apparaître dans les requêtes de contenu ordinaires mais restent disponibles sur l’onglet Trash de la collection.
Depuis Trash, sélectionnez Restore pour renvoyer une entrée à la collection. Une entrée restaurée revient comme 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 collection appartiennent
à l’objet data de la requête. Une mise à jour enregistre une révision de brouillon ; la publication est une action séparée.
Passez la dernière valeur _rev lors de la mise à jour ou de la publication afin que le serveur refuse 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.
Continuez avec Interroger le contenu pour rendre les entrées publiées dans un site Astro, ou Bibliothèque multimédia pour ajouter et gérer des fichiers réutilisables.