Arbeiten mit Inhalten

Dieser Leitfaden behandelt, wie Sie Inhalte mit dem EmDash Admin-Dashboard erstellen, bearbeiten und verwalten.

Zugriff auf den Admin-Bereich

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

Das Dashboard zeigt:

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

Inhalte erstellen

1. Klicken Sie auf einen Sammlungsnamen in der Seitenleiste (z. B. Posts)

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

3. Füllen Sie die erforderlichen Felder aus:

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

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

5. Legen Sie Metadaten in der Seitenleiste fest:

   • Status - Draft, Published oder Archived
   • Publication date - Wann veröffentlicht werden soll
   • Categories and tags - Taxonomiezuweisungen

6. Klicken Sie auf Save

Inhaltsstatus

Jeder Eintrag hat einen von drei Status:

Ändern Sie den Status über das Dropdown-Menü 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
• Codeblöcke - Mit Syntaxhervorhebung
• HTML-Blöcke - Rohes HTML für benutzerdefinierte Einbettungen und Widgets
• Einbettungen - YouTube, Vimeo, Twitter
• Abschnitte - Wiederverwendbare Inhaltsblöcke über den /section-Befehl

Slash-Befehle

Geben Sie / ein, um auf Schnelleinfügungsbefehle zuzugreifen:

Tastaturkürzel

Bilder einfügen

1. Klicken Sie auf die Bildschaltfläche in der Symbolleiste

2. Wählen Sie ein vorhandenes 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 Insert

HTML-Blöcke

Verwenden Sie /html, um einen rohen HTML-Block einzufügen. Dies ist nützlich zum 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 zu erlauben, ü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
    // Add your providers here
  ],
});
---

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

Übergeben Sie sie dann 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 zu der Sammlung, die den Inhalt enthält

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

3. Nehmen Sie Ihre Änderungen vor

4. Klicken Sie auf Save

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

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 sich die Liste der vorherigen Versionen mit Zeitstempeln an

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

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

Massenoperationen

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

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

2. Klicken Sie auf das Dropdown Bulk Actions

3. Wählen Sie eine Aktion:

   • Publish - Alle ausgewählten auf veröffentlicht setzen
   • Archive - Alle ausgewählten auf archiviert setzen
   • Delete - 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 case-sensitiv und findet Teilwörter.

Filter

Filtern Sie die Inhaltsliste nach:

• Status - Draft, Published, Archived
• Datumsbereich - Erstellungs- oder Änderungsdaten
• Author - Wer den Inhalt erstellt hat
• Taxonomy - Kategorie- oder Tag-Zuweisungen

Klicken Sie auf Clear Filters, um zurückzusetzen.

Inhalte planen

Planen Sie Inhalte für ein zukünftiges Veröffentlichungsdatum:

1. Erstellen oder bearbeiten Sie Inhalte

2. Setzen Sie den Status auf Draft

3. Setzen Sie das Publication date auf ein zukünftiges Datum und eine Uhrzeit

4. Klicken Sie auf Save

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

Inhalte löschen

Löschen Sie Inhalte über den Bearbeitungsbildschirm oder die Inhaltsliste:

Im Editor

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

2. Klicken Sie auf Delete in der Symbolleiste

3. Bestätigen Sie die Löschung

In der Liste

1. Wählen Sie Einträge mit Kontrollkästchen aus

2. Klicken Sie auf Bulk Actions > Delete

3. Bestätigen Sie die Löschung

Content-API

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

Inhalt erstellen

Die folgende Anfrage erstellt einen Entwurfsbeitrag:

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"
}

Inhalt aktualisieren

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

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

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

Inhalt löschen

Die folgende Anfrage löscht einen Beitrag dauerhaft:

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

Inhalte übersetzen

Wenn i18n aktiviert ist, können Sie Übersetzungen beliebiger Content-Einträge erstellen.

Eine Übersetzung erstellen

1. Öffnen Sie den Content-Eintrag, den Sie übersetzen möchten

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

3. Klicken Sie neben der Ziel-Locale auf Translate

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

5. Klicken Sie auf Save

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

Zwischen Übersetzungen wechseln

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

Locale-Filter

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

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

Nächste Schritte

• Querying Content - Inhalte in Ihren Templates abrufen
• Media Library - Dateien hochladen und verwalten
• Taxonomies - Inhalte mit Kategorien und Tags organisieren
• Internationalization - Mehrsprachige Inhalte und Übersetzungen