Nutzen Sie das EmDash-Admin, um einen Eintrag vom ersten Entwurf zu einer veröffentlichten Seite zu bringen. Der Editor hält Entwurfsänderungen getrennt von der Version, die Besucher sehen können, sodass Speichern und Veröffentlichen zwei getrennte Aktionen sind.
Eine Collection öffnen
Öffnen Sie /_emdash/admin auf Ihrer Site und melden Sie sich an. Wählen Sie in der Seitenleiste eine Collection wie Posts oder Pages.
Die Collection-Seite listet ihre Einträge. Von hier aus können Sie:
- Add New wählen, um einen Eintrag zu erstellen;
- nach Eintragstitel, Slug und als durchsuchbar markierten Feldern suchen;
- nach Veröffentlichungsstatus, Autor, Byline, Datum und Locale filtern;
- Einträge für Massenveröffentlichung, Zurücksetzen auf Entwurf oder Verschieben in den Papierkorb auswählen; und
- Trash öffnen, um einen Eintrag wiederherzustellen oder dauerhaft zu löschen.
Die im Editor verfügbaren Felder und Veröffentlichungsfunktionen hängen vom Inhaltsmodell der Collection ab. Eine Collection kann beispielsweise Revisionen, Vorschauen, Taxonomien oder Suche unterstützen.
Einen Eintrag erstellen und veröffentlichen
-
Wählen Sie Add New auf der Collection-Seite.
-
Füllen Sie die erforderlichen Felder aus. Wenn die Collection ein Titelfeld hat, nutzt EmDash es, um einen Slug vorzuschlagen. Sie können den Slug vor dem Veröffentlichen bearbeiten.
-
Fügen Sie den Textkörper und unterstützende Felder hinzu, etwa Excerpt, Beitragsbild, Byline, Kategorien oder Tags.
-
Wählen Sie Save. Das erste Speichern erstellt den Eintrag als Entwurf und öffnet seine permanente Editor-URL.
-
Prüfen Sie den Entwurf. Wenn die Collection Vorschauen unterstützt, wählen Sie Preview, um die gerenderte Seite vor dem Veröffentlichen zu sehen.
-
Wählen Sie Publish now und bestätigen Sie. Der gespeicherte Entwurf wird die Live-Version, die öffentliche Inhaltsabfragen zurückgeben.
Der Eintrag hat eine stabile Inhalts-ID und einen separaten Slug. Die ID identifiziert denselben Eintrag weiterhin,
wenn sich sein Slug ändert. Vorlagen nutzen normalerweise den URL-seitigen Bezeichner, den
getEmDashCollection() zurückgibt; der Leitfaden Inhalte abfragen
erklärt beide Werte.
Rich Text schreiben
Portable-Text-Felder bieten einen Block-Editor für Überschriften, Absätze, Zitate, Listen, Links, Bilder, Galerien, Codeblöcke, Tabellen, HTML-Blöcke und wiederverwendbare Abschnitte. Installierte Plugins können weitere Blöcke hinzufügen.
Nutzen Sie die Symbolleiste, um den ausgewählten Text zu formatieren. Um einen Block einzufügen, wählen Sie die Block-hinzufügen-Steuerung neben
einem Absatz oder tippen Sie / und suchen Sie einen Block nach Namen. Bild- und Galerieblöcke öffnen denselben Medien-
Auswahldialog wie Bildfelder.
Wenn Sie einen Bildblock auswählen, lassen seine Einstellungen diese Verwendung des Bildes ersetzen oder entfernen und Anzeigegröße, Ausrichtung, Alt-Text, Bildunterschrift und optionalen Tooltip festlegen. Edit asset öffnet das zugrunde liegende Mediathek-Element, wo das Ändern oder Ersetzen des Assets andere Einträge betreffen kann, die es nutzen. Siehe Mediathek für diesen Unterschied.
Entwurfsänderungen speichern
Nach dem ersten Speichern speichert der Editor Änderungen automatisch zwei Sekunden, nachdem Sie mit dem Tippen aufgehört haben. Die Schaltfläche Save wechselt von Saving… zu Saved, damit Sie bestätigen können, dass der Server den Entwurf akzeptiert hat. Autosave ersetzt die aktuelle Autosave-Revision, statt die Revisionshistorie mit einem Checkpoint für jede Pause zu füllen.
Wählen Sie Save, wenn ein Punkt in der Bearbeitungssequenz in der Revisionshistorie bleiben soll. Wenn ein Speichern fehlschlägt, behält der Editor die ungespeicherten Felder und zeigt den Fehler. Verlassen Sie die Seite nicht, bis die Schaltfläche zu Saved zurückkehrt oder Sie die ungespeicherte Arbeit woanders kopiert haben.
Bei einem veröffentlichten Eintrag aktualisiert Speichern nur dessen Entwurf. Besucher erhalten weiterhin die vorherige Live-Revision. Nutzen Sie Preview draft, um die ausstehende Version zu prüfen, Live View, um die öffentliche Version zu prüfen, und Publish changes, wenn der Entwurf sie ersetzen soll.
Das Ändern des Slugs eines veröffentlichten Eintrags folgt demselben Entwurfsfluss. Die öffentliche URL ändert sich, wenn Sie den Entwurf veröffentlichen, nicht wenn Autosave läuft.
Mit einem anderen Redakteur arbeiten
Das Öffnen eines Eintrags nimmt eine Bearbeitungssperre für diesen Eintrag und diese Locale. Wenn eine andere Person ihn bereits offen hat, identifiziert EmDash den Sperrinhaber und bietet zwei Wahlmöglichkeiten:
- Open read-only zeigt den Eintrag, ohne Bearbeitungen anzunehmen, sodass Sie keine Arbeit tippen können, die verworfen wird.
- Take over gibt Ihnen die Sperre. Die andere Person behält, was sie getippt hat, aber innerhalb von zwei Minuten meldet ihr Editor, dass Sie den Eintrag halten. Ihr nächstes Speichern wird abgelehnt.
Die Sperre wird erneuert, solange der Eintrag offen ist, und freigegeben, wenn Sie den Editor verlassen oder den Tab schließen. Wenn Browser oder Computer schließen, ohne sie freizugeben, läuft die Sperre sieben Minuten nach ihrer letzten Erneuerung ab.
Sperren sind pro Locale unabhängig, sodass zwei Personen unterschiedliche Übersetzungen desselben Eintrags bearbeiten können. Ein Skript oder API-Client wird ebenfalls abgelehnt, während ein anderer Redakteur die Sperre hält, sofern er nicht den dokumentierten Override nutzt. Siehe Eintrags-Bearbeitungssperre für das vollständige API-Verhalten.
Ein Administrator kann die Sperre für eine Collection unter Content Types, dann die Collection, dann Edit locking ausschalten.
Änderungen veröffentlichen oder planen
Veröffentlichen und Planen nutzen getrennte Steuerungen:
- Publish now macht einen neuen Entwurf nach Bestätigung live.
- Publish changes macht ausstehende Änderungen an einem veröffentlichten Eintrag nach Bestätigung live.
- Schedule legt fest, wann ein neuer Eintrag oder ausstehende Änderungen live werden.
- Change schedule aktualisiert einen bestehenden Zeitplan.
- Remove schedule storniert einen bestehenden Zeitplan.
- Unpublish entfernt die Live-Revision aus öffentlichen Abfragen, storniert jeden Zeitplan und behält einen bearbeitbaren Entwurf.
Um einen Eintrag zu planen, speichern Sie ihn zuerst, wählen Sie Schedule unter der Veröffentlichungszusammenfassung und wählen Sie ein zukünftiges Datum und eine Uhrzeit. Der Editor zeigt die für den Zeitplan verwendete Zeitzone. Bis zu diesem Zeitpunkt bleibt die aktuelle Live-Revision öffentlich; bei einem neuen Eintrag ist noch nichts öffentlich.
Node.js-Deployments führen den Sweep für geplantes Veröffentlichen automatisch aus. Cloudflare Workers erfordern einen Cron-Trigger. Die Cloudflare-Starter-Vorlagen enthalten ihn; bestehende Deployments können Geplantes Veröffentlichen folgen, um den Trigger zu prüfen.
Eine Revision wiederherstellen
Collections mit Revisionsunterstützung zeigen Revisions im Einstellungsbereich. Erweitern Sie ihn, um gespeicherte Versionen und die zwischen ihnen geänderten Felder zu sehen. Wählen Sie eine Revision, um ihren Inhalt zu prüfen, und wählen Sie Restore, wenn Sie diese Version erneut verwenden möchten.
Wiederherstellen erzeugt eine neue Revision mit dem ausgewählten Inhalt. Es löscht nicht die Revisionen, die davor kamen, sodass Sie danach weiterhin die vollständige Sequenz prüfen können.
Einen Eintrag übersetzen
Wenn Internationalisierung aktiviert ist, zeigt das Panel Translations die konfigurierten Locales für den aktuellen Eintrag.
-
Öffnen Sie den Quell-Eintrag und finden Sie Translations im Einstellungsbereich.
-
Wählen Sie Translate für eine Locale, die noch keinen Eintrag hat.
-
Bearbeiten Sie den kopierten Titel, Slug, Textkörper und andere übersetzbare Felder.
-
Wählen Sie Save und veröffentlichen oder planen Sie die Übersetzung, wenn sie bereit ist.
Jede Übersetzung hat eigenen Slug, Veröffentlichungsstatus, Zeitplan und Revisionshistorie. Nutzen Sie den Locale- Selektor auf der Collection-Seite, um jeweils eine Sprache anzuzeigen.
Inhalte in den Papierkorb verschieben
Öffnen Sie die Aktionen eines Eintrags oder wählen Sie eine oder mehrere Zeilen auf der Collection-Seite und wählen Sie dann Move to Trash. Papierkorb-Einträge erscheinen nicht mehr in gewöhnlichen Inhaltsabfragen, bleiben aber auf dem Trash-Tab der Collection verfügbar.
Unter Trash wählen Sie Restore, um einen Eintrag zur Collection zurückzubringen. Ein wiederhergestellter Eintrag kommt als Entwurf ohne Zeitplan zurück. Veröffentlichen Sie ihn, um ihn öffentlich zu machen.
Inhaltsarbeit automatisieren
Die REST-API und die EmDash-CLI unterstützen denselben Entwurfs- und Veröffentlichungsworkflow. Collection-Felder gehören
in das data-Objekt der Anfrage. Eine Aktualisierung speichert eine Entwurfsrevision; Veröffentlichen ist eine separate Aktion.
Übergeben Sie den neuesten _rev-Wert beim Aktualisieren oder Veröffentlichen, damit der Server einen veralteten Schreibvorgang ablehnt, statt
neuere Arbeit zu ersetzen.
Nutzen Sie die Inhaltslebenszyklus-Referenz für Zustandsübergänge, Berechtigungen, Konflikte und Hooks. Die REST-API-Referenz definiert Anfrage- und Antwortkörper, und die CLI-Referenz deckt entsprechende Terminal- Befehle ab.
Fahren Sie mit Inhalte abfragen fort, um veröffentlichte Einträge in einer Astro- Site zu rendern, oder mit Mediathek, um wiederverwendbare Dateien hinzuzufügen und zu verwalten.