Travailler avec le contenu

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

Accéder à l’Admin

Ouvrez votre navigateur sur /_emdash/admin sur votre site. Connectez-vous avec les identifiants que vous avez 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 du nouveau contenu, opérations en masse

Créer du contenu

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

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

3. Remplissez les champs requis :

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

4. Ajoutez du contenu à l’aide de l’éditeur de texte enrichi

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

   • Status - Draft, Published ou Archived
   • Publication date - Quand publier
   • Categories and tags - Attributions de taxonomie

6. Cliquez sur Save

Statuts du contenu

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

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

L’éditeur de texte enrichi

L’éditeur EmDash prend en charge :

• Titres - H2 à H6
• Formatage - Gras, italique, souligné, barré
• Listes - Ordonnées et non ordonnées
• Liens - Internes et externes
• Images - Insérer depuis la bibliothèque média
• 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 dans la bibliothèque média, ou téléchargez-en une nouvelle

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

4. Ajustez les options d’alignement et de taille

5. Cliquez sur Insert

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 standard. Les blocs HTML sont également 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
    // Add your providers here
  ],
});
---

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

Passez-le ensuite à <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 Save

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 Restore pour revenir à cette version

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 Bulk Actions

3. Sélectionnez une action :

   • Publish - Définir tous les sélectionnés comme publiés
   • Archive - Définir tous les sélectionnés comme archivés
   • Delete - Supprimer définitivement les sélectionnés

4. Confirmez l’action

Rechercher et filtrer

Recherche

Utilisez la zone de recherche pour trouver du contenu par titre ou contenu. La recherche ne distingue pas la casse et correspond aux mots partiels.

Filtres

Filtrez la liste de contenu par :

• Status - Draft, Published, Archived
• Date range - Dates de création ou de modification
• Author - Qui a créé le contenu
• Taxonomy - Attributions de catégorie ou de tag

Cliquez sur Clear Filters pour réinitialiser.

Planifier le contenu

Planifiez la publication du contenu à une date future :

1. Créez ou modifiez du contenu

2. Définissez le statut sur Draft

3. Définissez la Publication date à une date et heure futures

4. Cliquez sur Save

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

Supprimer le contenu

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

Depuis l’éditeur

1. Ouvrez le contenu que vous souhaitez supprimer

2. Cliquez sur Delete dans la barre d’outils

3. Confirmez la suppression

Depuis la liste

1. Sélectionnez des entrées à l’aide des cases à cocher

2. Cliquez sur Bulk Actions > Delete

3. Confirmez la suppression

API de contenu

Pour un accès programmatique, utilisez l’API admin EmDash.

Créer du contenu

La requête suivante crée un brouillon d’article :

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

{
  "title": "My New Post",
  "slug": "my-new-post",
  "content": "<p>Post content here</p>",
  "status": "draft"
}

Mettre à jour le contenu

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

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

{
  "title": "Updated Title",
  "status": "published"
}

Supprimer le contenu

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

DELETE /_emdash/api/content/posts/my-new-post
Authorization: Bearer YOUR_API_TOKEN

Traduire le contenu

Lorsque 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 souhaitez traduire

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

3. Cliquez sur Translate à côté de la locale cible

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

5. Cliquez sur Save

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

Basculer entre les traductions

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

Filtre de locale

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

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

Prochaines étapes

• Querying Content - Récupérer du contenu dans vos modèles
• Media Library - Télécharger et gérer des fichiers
• Taxonomies - Organiser le contenu avec catégories et tags
• Internationalization - Contenu multilingue et traductions