Medienbibliothek

Die Medienbibliothek speichert wiederverwendbare Bilder, Dokumente, Videos und Audio. Redakteure können Dateien einmal hochladen, sie aus Inhaltsfeldern und Portable Text auswählen und sehen, welche Inhaltseinträge auf ein lokales Medienelement verweisen.

Medienbibliothek öffnen

Wählen Sie Media in der Admin-Seitenleiste. Die Hauptbibliothek enthält Ordner und Dateien, die keinem Ordner zugeordnet wurden. Wählen Sie einen Ordner, um seine Dateien zu durchsuchen, oder wechseln Sie zwischen Raster- und Listenansicht.

Wenn die Website externe Medienanbieter hat, erscheint jeder Anbieter als weitere Quelle. Die Fähigkeiten der Anbieter variieren: Eine Quelle kann das Durchsuchen und Auswählen unterstützen, aber nicht Ordner, lokale Bildbearbeitung oder Löschung.

Dateien hochladen

Aus der Bibliothek hochladen

Uploads beginnen, sobald Dateien hinzugefügt werden. Neue lokale Dateien landen in der Hauptbibliothek, auch wenn zuvor ein anderer Ordner geöffnet war.

Beim Bearbeiten von Inhalten hochladen

Bild-, Datei-, Galerie- und Portable-Text-Bildfelder verwenden einen Medienauswähler. Öffnen Sie das Feld, wählen Sie Upload files und wählen oder ziehen Sie Dateien. Ein abgeschlossener Upload wird Teil der aktuellen Auswahl; fehlgeschlagene Uploads bleiben sichtbar, damit Sie sie wiederholen oder entfernen können.

Bei einer Galerie prüfen Sie Selected media und verwenden die Verschiebe-Steuerelemente, um die Reihenfolge festzulegen, bevor Sie Add images wählen. Bei einem einzelnen Bild oder einer Datei wählen Sie Select oder Insert image, nachdem der Upload abgeschlossen ist.

Akzeptierte Dateien und Größenlimit

Die lokale Medienbibliothek akzeptiert standardmäßig diese Dateigruppen:

• PNG-, JPEG-, GIF-, WebP- und AVIF-Bilder;
• gängige Videoformate wie MP4, WebM und QuickTime-Video;
• gängige Audioformate wie MP3, WAV und Ogg-Audio; sowie
• PDF-Dokumente.

SVG ist von der Standard-Upload-Liste ausgeschlossen, weil SVG-Dateien aktiven Inhalt enthalten können. Ein Bild- oder Dateifeld kann eine eigene Liste akzeptierter Dateitypen definieren, wenn das Inhaltsmodell eine engere Auswahl oder ein anderes Format braucht. EmDash identifiziert jede Datei anhand ihres Medientyps — einer Bezeichnung wie image/png oder application/pdf — und prüft die Feldliste erneut, wenn Inhalte gespeichert werden. Das Ändern der Dateiauswahl im Browser umgeht diese Serverprüfung nicht.

Das Standardmaximum beträgt 50 MB pro Datei. Website-Entwickler können es mit maxUploadSize ändern. Ein Anbieter kann ein zusätzliches Format- oder Größenlimit auferlegen und meldet diesen Fehler in der Upload-Zeile.

Dateien finden und organisieren

Die Suche stimmt mit Teil-Dateinamen überein. Der Typfilter beschränkt Ergebnisse auf Bilder, Dokumente, Video oder Audio. Eine Dateinamensuche deckt die gesamte lokale Bibliothek ab, auch wenn ein Ordner geöffnet ist; das Durchsuchen eines Ordners ohne Suche zeigt nur die diesem Ordner zugeordneten Dateien.

Redakteure können in der Hauptbibliothek Add new folder wählen. Verschieben Sie eine lokale Datei, indem Sie ihre Karte oder Zeile auf einen sichtbaren Ordner ziehen, oder öffnen Sie die Datei, ändern Sie Location und wählen Sie Save. Verwenden Sie Main library als Ort, um eine Datei aus ihrem aktuellen Ordner zu entfernen.

Autoren können lokale Dateien verschieben, die sie hochgeladen haben. Redakteure können jede lokale Datei verschieben. Elemente externer Anbieter können keinen Ordnern der Medienbibliothek zugeordnet werden.

Das Löschen eines Ordners verschiebt seine Dateien zurück in die Hauptbibliothek. Es löscht die Dateien nicht, ändert ihre URLs nicht und entfernt ihre Inhaltsverweise nicht.

Medien für Inhalte auswählen

Portable-Text-Bilder

Platzieren Sie den Cursor in einem Portable-Text-Feld, öffnen Sie das Blockmenü und wählen Sie Image. Wählen oder laden Sie ein Bild hoch und wählen Sie dann Insert image. Wählen Sie danach den Bildblock aus, um Alt-Text, eine Bildunterschrift, Anzeigeabmessungen und Ausrichtung hinzuzufügen.

Bild- und Dateifelder

Wählen Sie die Feldaktion, z. B. Select image oder Select file, wählen Sie dann ein Element und bestätigen Sie die Auswahl. Die MIME-Typ-Regeln eines Feldes beschränken, welche Bibliothekselemente und Medienquellen erscheinen.

Das Feld featured_image der Blog-Vorlage speichert den ausgewählten Medienwert mit dem Beitrag. Das Speichern des Eintrags speichert diesen Verweis im Entwurf; das Veröffentlichen macht ihn für öffentliche Inhaltsabfragen verfügbar.

Galeriefelder

Wählen Sie ein oder mehrere Bilder aus, ordnen Sie sie unter Selected media an und bestätigen Sie. Eine Galerie behält ihre eigene Reihenfolge sowie Alt-Text und Bildunterschrift pro Bild, auch wenn mehrere Positionen auf Elemente der Medienbibliothek verweisen.

Ein in Inhalten verwendetes Bild bearbeiten

Ein ausgewähltes lokales Bild bietet Aktionen mit unterschiedlichem Umfang:

• Replace wählt ein anderes Element der Medienbibliothek für dieses Feld, diesen Block oder diese Galerieposition. Andere Einträge, die das Original verwenden, ändern sich nicht.
• Edit asset öffnet das zugrunde liegende Element der Medienbibliothek. Metadatenänderungen und zerstörerische Bildänderungen können andere Verwendungen dieses Elements betreffen.
• Remove löscht diesen Inhaltsverweis. Das Element der Medienbibliothek bleibt verfügbar.

Wenn Edit asset eine beschnittene Kopie erstellt, wählt der Auswähler die neue Kopie für die aktuelle Verwendung. Portable-Text- und Galeriebilder behalten Alt-Text, Bildunterschrift, Layout und Position dieser Verwendung. Wenn Edit asset das Original ersetzt, bleibt die Medien-ID gleich, sodass jede Verwendung dieses Elements das geänderte Bild erhält.

Bilder externer Anbieter und Dateifelder bieten Replace und Remove, öffnen aber nicht den lokalen Asset-Editor.

Ein lokales Bild ersetzen

Replace image lädt neue Bytes hinter ein bestehendes Element der Medienbibliothek. Verwenden Sie es, wenn jede Stelle, die auf das Element verweist, eine neue Version des Bildes zeigen soll.

Die Aktion ist für bereite JPEG-, PNG- und WebP-Elemente verfügbar. Autoren können Bilder ersetzen, die sie hochgeladen haben; Redakteure können jedes lokale Bild ersetzen.

EmDash behält die Medien-ID, den Dateinamen, die URL, den Alt-Text, die Bildunterschrift und den Ordner. Bestehende Inhaltsverweise funktionieren daher weiter und zeigen den Ersatz. Der Ersatz löscht den gespeicherten Fokuspunkt, weil seine Koordinaten das neue Bild möglicherweise nicht beschreiben.

Verwenden Sie stattdessen Replace im Inhaltseditor, wenn sich nur ein Feld oder Bildblock ändern soll.

Fokuspunkt setzen

Ein Fokuspunkt markiert den Teil eines Bildes, der sichtbar bleiben soll, wenn ein Layout das Bild auf ein Quadrat, Querformat, Hochformat oder eine andere feste Form zuschneidet.

Wählen Sie Reset, um den benutzerdefinierten Punkt zu entfernen. Wenn Sie ein Bild für ein Feld oder eine Galerie wählen, kopiert EmDash den aktuellen Fokuspunkt des Assets in diesen Inhaltswert. Inhalte, die das Bild bereits verwenden, behalten ihren gespeicherten Punkt, bis Sie das Bild erneut auswählen. Das Öffnen von Edit asset aus einem Inhaltsfeld aktualisiert diese aktuelle Verwendung mit dem Punkt, den Sie speichern.

Ein lokales Bild beschneiden

Das Beschneiden ist für bereite JPEG-, PNG- und WebP-Bilder verfügbar, die EmDash speichert. Bilder externer Anbieter können im lokalen Asset-Editor nicht beschnitten werden.

Replace original ist nur mit dem Seitenverhältnis Original verfügbar. Verwenden Sie Create cropped copy für Freeform und die anderen Verhältnisse. Eine beschnittene Kopie bleibt im selben Ordner wie ihre Quelle und erhält einen eindeutigen Dateinamen.

Das Beschneiden eines animierten WebP erzeugt ein stilles WebP. Das beschnittene Ergebnis behält die Animation nicht.

Sehen, wo eine Datei verwendet wird

Öffnen Sie eine lokale Datei und wählen Sie Used in, um die Inhaltseinträge und Website-Einstellungen aufzulisten, die darauf verweisen. Jedes Inhaltsergebnis nennt die Sammlung und Felder, die den Verweis enthalten, und kann den Eintrag zum Bearbeiten öffnen. Gelöschte Einträge werden in der Liste gekennzeichnet. Ein Ergebnis Site Settings nennt die Einstellungen, die die Datei auswählen: Logo, Favicon oder Default Social Image.

Used in prüft diese Verweise:

• Bild- und Dateifelder
• Bildfelder in Repeatern
• Bild-, Datei- und Portable-Text-Felder in blocks-Feldern
• Bild- und Galerieblöcke in Portable-Text-Feldern
• das Website-Logo, Favicon und Standard-Social-Image

Wenn die Nutzungsabdeckung vollständig ist und die Datei keinen dieser Verweise hat, zeigt die Liste No tracked references found. Bis die Abdeckung vollständig ist, zeigt eine leere Liste No usage to show yet.

Die Mediennutzungsnachverfolgung muss aktiv sein, bevor die Inhaltsergebnisse vollständig sein können. Website-Einstellungen werden aufgelistet, unabhängig davon, ob die Nachverfolgung aktiv ist. Ein Administrator aktiviert die Nachverfolgung einmal für die Website:

Einmal aktiviert, kann die Mediennutzungsnachverfolgung nicht mehr ausgeschaltet werden. Neue Inhaltsänderungen werden nachverfolgt, nachdem die Erfassung aktiv wird; der Hintergrundscan fügt Verweise aus bereits vorhandenen Einträgen hinzu.

Wenn die Ansicht Used in meldet, dass die Indexierung läuft, veraltet, teilweise oder fehlgeschlagen ist, behandeln Sie ihre Ergebnisse als unvollständig. Ein Administrator kann zu Media usage tracking zurückkehren, um den aktuellen Status und Wiederherstellungshinweise zu erhalten.

Ein Bild in einem Template rendern

Bildfelder geben einen Medienwert statt einer einfachen URL zurück. Rendern Sie diesen Wert mit Image aus emdash/ui, damit lokale und anbieterbasierte Bilder die passende URL, Abmessungen, Fokuspunkt, responsive Varianten und einen Low-Quality-Platzhalter verwenden:

---
import { getEmDashEntry } from "emdash";
import { Image } from "emdash/ui";

const { entry: post, error } = await getEmDashEntry("posts", Astro.params.slug);
if (error) return new Response("Unable to load post", { status: 500 });
if (!post) return Astro.redirect("/404");
---

{post.data.featured_image && (
  <Image image={post.data.featured_image} width={1200} height={675} priority />
)}

Verwenden Sie priority nur für das Hauptbild, das oben auf der Seite sichtbar ist. Es fordert eager Loading an und gibt dem Browser einen hohen Fetch-Priority-Hinweis. Andere Bilder sollten die Lazy-Loading-Standardeinstellung der Komponente behalten.

Wenn das Feld ein Dark-Mode-Gegenstück hat, rendert Image beide Quellen und wählt eine anhand des Farbschemas des Besuchers. Siehe Dark-Mode-Bilder für die Feld- und Template-Einrichtung.

Das Template erhält die mit dem Inhaltsverweis gespeicherten Medienmetadaten ohne eine weitere Abfrage der Medienbibliothek. Wenn eine benutzerdefinierte Integration die neuesten Metadaten des Anbieters benötigt, fordern Sie dieses Element explizit an und vermeiden Sie eine Anbieterabfrage pro Bild auf einer Sammlungsseite. Die Feldtyp-Referenz beschreibt gespeicherte Datei- und Bildwerte.

Speicher und Anbieter konfigurieren

Die lokale Bibliothek speichert Dateien über den konfigurierten Speicheradapter der Website. Node.js-Websites können lokale Festplatte oder S3-kompatiblen Speicher verwenden; Cloudflare-Websites nutzen häufig eine R2-Bindung. Der Adapter entscheidet, wo Bytes gespeichert werden, während die Medienbibliothek denselben Autor-Workflow beibehält. Siehe Medienspeicher für Konfiguration und Persistenzanforderungen in der Produktion.

Cloudflare Images und Cloudflare Stream können als externe Medienanbieter registriert werden. Sie erscheinen als Quellen im Auswähler, und Image versteht anbieterbasierte Bildwerte. Anbieterelemente bleiben von diesem Dienst verwaltet, sodass lokale Ordner, Fokuspunkte, Beschneiden und Ersetzen für diese Elemente im EmDash-Asset-Editor nicht verfügbar sind.

Medien sicher löschen

Öffnen Sie eine Datei in der Medienbibliothek, wählen Sie Delete und bestätigen Sie die dauerhafte Löschung. Autoren können lokale Dateien löschen, die sie hochgeladen haben; Redakteure können jede lokale Datei löschen. Ein Anbieterelement wird nur dann beim Anbieter gelöscht, wenn diese Quelle die Löschung freigibt und der aktuelle Benutzer die Berechtigung hat.

Für automatisierte Uploads und Medienverwaltung siehe die Medien-Endpunkt-Referenz oder die CLI-Medienbefehle. Fahren Sie mit Mit Inhalten arbeiten fort, um Einträge zu veröffentlichen, die die ausgewählten Medien verwenden.