Travailler avec le contenu

Ce guide couvre la création, la modification et la gestion du contenu à l’aide du tableau de bord admin d’EmDash.

Accéder à l’admin

Ouvrez votre navigateur à /_emdash/admin sur votre site. Connectez-vous avec les identifiants créés lors de la configuration.

Le tableau de bord affiche :

• Barre latérale - Navigation vers les collections, médias et paramètres
• Liste de contenu - Entrées dans la collection sélectionnée
• Actions rapides - Créer un nouveau contenu, opérations en masse

Créer du contenu

1. Cliquez sur un nom de collection dans la barre latérale (ex., Posts)

2. Cliquez sur New Post (ou l’équivalent pour votre collection)

3. Remplissez les champs obligatoires :

   • Title - Le nom d’affichage du contenu
   • Slug - Identifiant URL (généré automatiquement à partir du titre, modifiable)

4. Ajoutez du contenu avec l’éditeur de texte riche

5. Définissez les métadonnées dans la barre latérale :

   • Status - Brouillon, Publié ou Archivé
   • Date de publication - Quand publier
   • Catégories et tags - Attributions de taxonomie

6. Cliquez sur Enregistrer

Les brouillons ne sont visibles que dans l’admin. Changez le statut en Publié pour rendre le contenu visible sur votre site.

Statuts du contenu

Chaque entrée a l’un des trois statuts :

Changez le statut via le menu déroulant dans la barre latérale de l’éditeur.

L’éditeur de texte riche

L’éditeur d’EmDash prend en charge :

• Titres - H2 à H6
• Mise en forme - Gras, italique, souligné, barré
• Listes - Ordonnées et non ordonnées
• Liens - Internes et externes
• Images - Insertion depuis la bibliothèque de médias
• Blocs de code - Avec coloration syntaxique
• Blocs HTML - HTML brut pour les intégrations et widgets personnalisés
• Intégrations - YouTube, Vimeo, Twitter
• Sections - Blocs de contenu réutilisables via la commande /section

Commandes slash

Tapez / pour accéder aux commandes d’insertion rapide :

Raccourcis clavier

Insérer des images

1. Cliquez sur le bouton image dans la barre d’outils

2. Sélectionnez une image existante de la bibliothèque de médias, ou téléversez-en une nouvelle

3. Ajoutez un texte alternatif (obligatoire pour l’accessibilité)

4. Ajustez les options d’alignement et de taille

5. Cliquez sur Insérer

Blocs HTML

Utilisez /html pour insérer un bloc HTML brut. C’est utile pour intégrer des widgets tiers, du balisage personnalisé ou du contenu qui ne correspond pas aux types de blocs standards. Les blocs HTML sont aussi créés automatiquement lors de l’importation de contenu depuis WordPress ou Contentful contenant du balisage qu’EmDash ne peut pas convertir en blocs Portable Text natifs.

Pour autoriser les iframes de fournisseurs supplémentaires, remplacez le composant htmlBlock dans votre rendu Portable Text :

---
// src/components/MyHtmlBlock.astro
import sanitizeHtml from "sanitize-html";

const { node } = Astro.props;

if (!node?.html) {
  return null;
}

const sanitized = sanitizeHtml(node.html, {
  allowedTags: [...sanitizeHtml.defaults.allowedTags, "img", "span", "iframe"],
  allowedAttributes: {
    ...sanitizeHtml.defaults.allowedAttributes,
    "*": ["class", "id", "data-*", "style"],
    iframe: ["src", "width", "height", "frameborder", "allow", "allowfullscreen"],
    img: ["src", "srcset", "alt", "title", "width", "height", "loading"],
  },
  allowedIframeHostnames: [
    "www.youtube.com",
    "player.vimeo.com",
    "iframe.videodelivery.net", // Cloudflare Stream
    // Ajoutez vos fournisseurs ici
  ],
});
---

<div class="html-block" set:html={sanitized} />

Puis passez-le à <PortableText> :

---
import { PortableText } from "emdash/ui";
import MyHtmlBlock from "../components/MyHtmlBlock.astro";
---

<PortableText
  value={post.data.content}
  components={{ type: { htmlBlock: MyHtmlBlock } }}
/>

Modifier le contenu

1. Naviguez vers la collection contenant le contenu

2. Cliquez sur l’entrée que vous souhaitez modifier

3. Effectuez vos modifications

4. Cliquez sur Enregistrer

Les modifications du contenu publié apparaissent immédiatement sur votre site.

Historique des révisions

EmDash suit les modifications du contenu. Accédez à l’historique des révisions depuis la barre latérale de l’éditeur :

1. Cliquez sur Revisions dans la barre latérale de l’éditeur

2. Consultez la liste des versions précédentes avec horodatages

3. Cliquez sur une révision pour la prévisualiser

4. Cliquez sur Restaurer pour revenir à cette version

La restauration d’une révision crée une nouvelle révision avec le contenu restauré. L’historique des révisions original est préservé.

Opérations en masse

Effectuez des actions sur plusieurs entrées à la fois :

1. Utilisez les cases à cocher pour sélectionner des entrées dans la liste de contenu

2. Cliquez sur le menu déroulant Actions en masse

3. Sélectionnez une action :

   • Publier - Mettre tous les sélectionnés en publié
   • Archiver - Mettre tous les sélectionnés en archivé
   • Supprimer - Supprimer définitivement les sélectionnés

4. Confirmez l’action

Recherche et filtrage

Recherche

Utilisez le champ de recherche pour trouver du contenu par titre ou contenu. La recherche ne distingue pas les majuscules et correspond aux mots partiels.

Filtres

Filtrez la liste de contenu par :

• Statut - Brouillon, Publié, Archivé
• Plage de dates - Dates de création ou modification
• Auteur - Qui a créé le contenu
• Taxonomie - Attributions de catégorie ou tag

Cliquez sur Effacer les filtres pour réinitialiser.

Planifier du contenu

Planifiez du contenu pour publication à une date future :

1. Créez ou modifiez du contenu

2. Définissez le statut sur Brouillon

3. Définissez la Date de publication sur une date et heure futures

4. Cliquez sur Enregistrer

Quand la date de publication arrive, le contenu est automatiquement publié.

Supprimer du contenu

Supprimez du contenu depuis l’écran d’édition ou la liste de contenu :

Depuis l’éditeur

1. Ouvrez le contenu que vous voulez supprimer

2. Cliquez sur Supprimer dans la barre d’outils

3. Confirmez la suppression

Depuis la liste

1. Sélectionnez des entrées avec les cases à cocher

2. Cliquez sur Actions en masse > Supprimer

3. Confirmez la suppression

API de contenu

Pour un accès programmé, utilisez l’API d’administration EmDash.

Créer du contenu

La requête suivante crée un brouillon de post :

POST /_emdash/api/content/posts
Content-Type: application/json
Authorization: Bearer YOUR_API_TOKEN

{
  "title": "Mon nouveau post",
  "slug": "mon-nouveau-post",
  "content": "<p>Contenu du post ici</p>",
  "status": "draft"
}

Mettre à jour le contenu

La requête suivante met à jour un post existant et le publie :

PUT /_emdash/api/content/posts/mon-nouveau-post
Content-Type: application/json
Authorization: Bearer YOUR_API_TOKEN

{
  "title": "Titre mis à jour",
  "status": "published"
}

Supprimer du contenu

La requête suivante supprime définitivement un post :

DELETE /_emdash/api/content/posts/mon-nouveau-post
Authorization: Bearer YOUR_API_TOKEN

Traduire le contenu

Quand l’i18n est activé, vous pouvez créer des traductions de toute entrée de contenu.

Créer une traduction

1. Ouvrez l’entrée de contenu que vous voulez traduire

2. Dans la barre latérale de l’éditeur, trouvez le panneau Translations

3. Cliquez sur Traduire à côté de la langue cible

4. Modifiez le contenu pré-rempli — ajustez le titre, le slug et le corps pour la nouvelle langue

5. Cliquez sur Enregistrer

La nouvelle traduction est liée à l’entrée originale et commence comme brouillon. Publiez-la indépendamment quand la traduction est prête.

Basculer entre les traductions

Le panneau Traductions affiche toutes les langues configurées. Cliquez sur Modifier à côté de toute traduction existante pour y naviguer directement. La langue actuelle est marquée d’une coche.

Filtre de langue

Dans la liste de contenu, utilisez le menu déroulant de langue dans la barre d’outils pour filtrer les entrées par langue. Chaque entrée affiche sa langue dans une colonne dédiée.

Chaque traduction a son propre slug, statut et historique de révisions. Publiez, planifiez et gérez les traductions indépendamment.

Consultez le guide d’Internationalisation pour les détails complets sur la configuration, les requêtes et le sélecteur de langue.

Prochaines étapes

• Interroger le contenu - Récupérer le contenu dans vos templates
• Bibliothèque de médias - Téléverser et gérer les fichiers
• Taxonomies - Organiser le contenu avec des catégories et tags
• Internationalisation - Contenu multilingue et traductions