Mit Inhalten arbeiten

Diese Anleitung behandelt das Erstellen, Bearbeiten und Verwalten von Inhalten über das EmDash-Admin-Dashboard.

Zugriff auf den Admin

Öffnen Sie Ihren Browser unter /_emdash/admin auf Ihrer Seite. Melden Sie sich mit den Zugangsdaten an, die Sie während der Einrichtung erstellt haben.

Das Dashboard zeigt an:

• Seitenleiste - Navigation zu Collections, Medien und Einstellungen
• Inhaltsliste - Einträge in der ausgewählten Collection
• Schnellaktionen - Neue Inhalte erstellen, Massenoperationen

Inhalte erstellen

1. Klicken Sie auf einen Collection-Namen in der Seitenleiste (z.B. Posts)

2. Klicken Sie auf New Post (oder das Äquivalent für Ihre Collection)

3. Füllen Sie die erforderlichen Felder aus:

   • Title - Der Anzeigename des Inhalts
   • Slug - URL-Bezeichner (automatisch aus dem Titel generiert, bearbeitbar)

4. Fügen Sie Inhalte mit dem Rich-Text-Editor hinzu

5. Setzen Sie Metadaten in der Seitenleiste:

   • Status - Entwurf, Veröffentlicht oder Archiviert
   • Veröffentlichungsdatum - Wann veröffentlicht werden soll
   • Kategorien und Tags - Taxonomie-Zuweisungen

6. Klicken Sie auf Speichern

Entwürfe sind nur im Admin sichtbar. Ändern Sie den Status auf Veröffentlicht, um Inhalte auf Ihrer Seite sichtbar zu machen.

Inhalts-Status

Jeder Eintrag hat einen von drei Status:

Ändern Sie den Status über das Dropdown in der Editor-Seitenleiste.

Der Rich-Text-Editor

Der EmDash-Editor unterstützt:

• Überschriften - H2 bis H6
• Formatierung - Fett, kursiv, unterstrichen, durchgestrichen
• Listen - Geordnet und ungeordnet
• Links - Intern und extern
• Bilder - Einfügen aus der Medienbibliothek
• Code-Blöcke - Mit Syntax-Hervorhebung
• HTML-Blöcke - Rohes HTML für benutzerdefinierte Einbettungen und Widgets
• Einbettungen - YouTube, Vimeo, Twitter
• Sections - Wiederverwendbare Inhaltsblöcke über den /section-Befehl

Slash-Befehle

Tippen Sie /, um auf Schnelleinfüge-Befehle zuzugreifen:

Tastenkürzel

Bilder einfügen

1. Klicken Sie auf die Bild-Schaltfläche in der Toolbar

2. Wählen Sie ein bestehendes Bild aus der Medienbibliothek oder laden Sie ein neues hoch

3. Fügen Sie Alt-Text hinzu (erforderlich für Barrierefreiheit)

4. Passen Sie Ausrichtungs- und Größenoptionen an

5. Klicken Sie auf Einfügen

HTML-Blöcke

Verwenden Sie /html, um einen rohen HTML-Block einzufügen. Dies ist nützlich für das Einbetten von Drittanbieter-Widgets, benutzerdefiniertem Markup oder Inhalten, die nicht in die Standard-Blocktypen passen. HTML-Blöcke werden auch automatisch erstellt, wenn Inhalte aus WordPress oder Contentful importiert werden, die Markup enthalten, das EmDash nicht in native Portable-Text-Blöcke konvertieren kann.

Um Iframes von zusätzlichen Anbietern zuzulassen, überschreiben Sie die htmlBlock-Komponente in Ihrem Portable-Text-Rendering:

---
// 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
    // Fügen Sie hier Ihre Anbieter hinzu
  ],
});
---

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

Dann übergeben Sie es an <PortableText>:

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

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

Inhalte bearbeiten

1. Navigieren Sie zur Collection mit dem Inhalt

2. Klicken Sie auf den Eintrag, den Sie bearbeiten möchten

3. Nehmen Sie Ihre Änderungen vor

4. Klicken Sie auf Speichern

Änderungen an veröffentlichten Inhalten erscheinen sofort auf Ihrer Seite.

Versionshistorie

EmDash verfolgt Änderungen an Inhalten. Greifen Sie auf die Versionshistorie über die Editor-Seitenleiste zu:

1. Klicken Sie auf Revisions in der Editor-Seitenleiste

2. Sehen Sie die Liste vorheriger Versionen mit Zeitstempeln

3. Klicken Sie auf eine Version, um sie in der Vorschau anzuzeigen

4. Klicken Sie auf Wiederherstellen, um zu dieser Version zurückzukehren

Das Wiederherstellen einer Version erstellt eine neue Version mit dem wiederhergestellten Inhalt. Die ursprüngliche Versionshistorie bleibt erhalten.

Massenoperationen

Führen Sie Aktionen für mehrere Einträge gleichzeitig durch:

1. Verwenden Sie die Kontrollkästchen, um Einträge in der Inhaltsliste auszuwählen

2. Klicken Sie auf das Dropdown Massenaktionen

3. Wählen Sie eine Aktion:

   • Veröffentlichen - Alle ausgewählten auf veröffentlicht setzen
   • Archivieren - Alle ausgewählten auf archiviert setzen
   • Löschen - Ausgewählte dauerhaft entfernen

4. Bestätigen Sie die Aktion

Suchen und Filtern

Suche

Verwenden Sie das Suchfeld, um Inhalte nach Titel oder Inhalt zu finden. Die Suche ist nicht zwischen Groß- und Kleinschreibung unterscheidend und findet auch Teilwörter.

Filter

Filtern Sie die Inhaltsliste nach:

• Status - Entwurf, Veröffentlicht, Archiviert
• Datumsbereich - Erstellungs- oder Änderungsdaten
• Autor - Wer den Inhalt erstellt hat
• Taxonomie - Kategorie- oder Tag-Zuweisungen

Klicken Sie auf Filter zurücksetzen, um zurückzusetzen.

Inhalte planen

Planen Sie Inhalte zur Veröffentlichung an einem zukünftigen Datum:

1. Erstellen oder bearbeiten Sie Inhalte

2. Setzen Sie den Status auf Entwurf

3. Setzen Sie das Veröffentlichungsdatum auf ein zukünftiges Datum und eine Uhrzeit

4. Klicken Sie auf Speichern

Wenn das Veröffentlichungsdatum erreicht ist, wird der Inhalt automatisch veröffentlicht.

Inhalte löschen

Löschen Sie Inhalte vom Bearbeitungsbildschirm oder der Inhaltsliste:

Vom Editor

1. Öffnen Sie den Inhalt, den Sie löschen möchten

2. Klicken Sie auf Löschen in der Toolbar

3. Bestätigen Sie die Löschung

Von der Liste

1. Wählen Sie Einträge über Kontrollkästchen aus

2. Klicken Sie auf Massenaktionen > Löschen

3. Bestätigen Sie die Löschung

Content-API

Für programmgesteuerten Zugriff verwenden Sie die EmDash-Admin-API.

Inhalte erstellen

Die folgende Anfrage erstellt einen Entwurfs-Post:

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

{
  "title": "Mein neuer Post",
  "slug": "mein-neuer-post",
  "content": "<p>Post-Inhalt hier</p>",
  "status": "draft"
}

Inhalte aktualisieren

Die folgende Anfrage aktualisiert einen bestehenden Post und veröffentlicht ihn:

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

{
  "title": "Aktualisierter Titel",
  "status": "published"
}

Inhalte löschen

Die folgende Anfrage löscht einen Post dauerhaft:

DELETE /_emdash/api/content/posts/mein-neuer-post
Authorization: Bearer YOUR_API_TOKEN

Inhalte übersetzen

Wenn i18n aktiviert ist, können Sie Übersetzungen jedes Inhaltseintrags erstellen.

Eine Übersetzung erstellen

1. Öffnen Sie den Inhaltseintrag, den Sie übersetzen möchten

2. Finden Sie in der Editor-Seitenleiste das Panel Translations

3. Klicken Sie auf Übersetzen neben der Zielsprache

4. Bearbeiten Sie den vorausgefüllten Inhalt — passen Sie Titel, Slug und Text für die neue Sprache an

5. Klicken Sie auf Speichern

Die neue Übersetzung ist mit dem Originaleintrag verknüpft und beginnt als Entwurf. Veröffentlichen Sie sie unabhängig, wenn die Übersetzung fertig ist.

Zwischen Übersetzungen wechseln

Das Translations-Panel zeigt alle konfigurierten Sprachen. Klicken Sie auf Bearbeiten neben einer bestehenden Übersetzung, um direkt dorthin zu navigieren. Die aktuelle Sprache ist mit einem Häkchen markiert.

Sprachfilter

Verwenden Sie in der Inhaltsliste das Sprach-Dropdown in der Toolbar, um Einträge nach Sprache zu filtern. Jeder Eintrag zeigt seine Sprache in einer eigenen Spalte.

Jede Übersetzung hat ihren eigenen Slug, Status und Versionshistorie. Veröffentlichen, planen und verwalten Sie Übersetzungen unabhängig.

Siehe den Internationalisierungs-Leitfaden für vollständige Details zu Konfiguration, Abfragen und dem Sprachumschalter.

Nächste Schritte

• Inhalte abfragen - Inhalte in Ihren Templates abrufen
• Medienbibliothek - Dateien hochladen und verwalten
• Taxonomien - Inhalte mit Kategorien und Tags organisieren
• Internationalisierung - Mehrsprachige Inhalte und Übersetzungen