Themes | EmDash CMS Everything

Ein EmDash-Theme ist ein vollständiges Astro-Projekt, das als create-astro-Vorlage verteilt wird. Es enthält die öffentlichen Routen und Komponenten, die EmDash-Laufzeitkonfiguration und eine optionale Seed-Datei für das anfängliche Inhaltsmodell der Website.

Es gibt kein Laufzeit-Theme-Paket und keine Vorlagenhierarchie. Nach dem Scaffolding gehören die Theme-Dateien zur Website und können direkt bearbeitet werden.

Theme-Inhalte

Aktuelle EmDash-Vorlagen verwenden diese Pfade:

astro.config.mjs
package.json
seed/
└── seed.json
src/
├── components/
├── layouts/
├── live.config.ts
├── pages/
└── styles/

astro.config.mjs konfiguriert Server-Ausgabe, Deployment-Adapter, EmDash, Datenbank und Speicher.
src/live.config.ts registriert die Live-Collection _emdash.
src/pages/ definiert öffentliche Routen.
seed/seed.json kann anfängliche Collections, Felder, Einstellungen, Taxonomien, Bylines, Menüs, Redirects, Widget-Bereiche, Sections und Beispielinhalte deklarieren.
package.json#emdash.seed zeigt auf die Seed-Datei.

Die Blank-Vorlage hat absichtlich keinen Benutzer-Seed und fällt auf EmDashs eingebauten Standard-Seed zurück. Die anderen aktuellen Vorlagen zeigen auf seed/seed.json.

Eine Vorlage installieren

Der folgende Befehl scaffoldet die Node-Blog-Vorlage:

npm create astro@latest -- --template @emdash-cms/template-blog

Verwenden Sie das entsprechende -cloudflare-Paket für ein Cloudflare-Workers-Projekt:

npm create astro@latest -- --template @emdash-cms/template-blog-cloudflare

Aktuelle Vorlagenpakete umfassen:

Zweck	Node	Cloudflare
Leere Projekthülle	`@emdash-cms/template-blank`	Kein aktuelles Gegenstück
Einfache Seiten-Website	`@emdash-cms/template-starter`	`@emdash-cms/template-starter-cloudflare`
Beiträge, Seiten, Kategorien, Tags und Widgets	`@emdash-cms/template-blog`	`@emdash-cms/template-blog-cloudflare`
Projektportfolio	`@emdash-cms/template-portfolio`	`@emdash-cms/template-portfolio-cloudflare`
Marketingseiten aus versionierten Blöcken	`@emdash-cms/template-marketing`	`@emdash-cms/template-marketing-cloudflare`

Nach dem Scaffolding Abhängigkeiten installieren und die generierte Website starten:

cd my-site
npm install
npm run dev

Öffnen Sie http://localhost:4321/_emdash/admin. Beim ersten Besuch erfolgt die Weiterleitung zum Setup, wo Sie Site-Identität und Administratorangaben eingeben. Wenn die gewählte Vorlage Beispiel-Einträge hat, kann der Assistent sie einschließen oder weglassen. Einschließen ist nützlich bei der Bewertung des Designs, weil die Routen realistische Inhalte zum Rendern haben.

Erste Einrichtung

EmDash liest den Seed zur Build-Zeit. Die Suche erfolgt in dieser Reihenfolge:

.emdash/seed.json.
Der Pfad in package.json#emdash.seed.
seed/seed.json.
Der eingebaute Standard-Seed, wenn kein Benutzer-Seed gefunden wird.

Beim ersten Admin-Besuch zeigt der Setup-Assistent Seed-Metadaten und lässt den Administrator wählen, ob Beispielinhalte eingeschlossen werden. Er wendet den Seed auf eine leere Datenbank an und speichert den Abschluss des Setups. Spätere Starts wenden den Seed nicht erneut auf eine bestehende Website an.

Die installierte Website anpassen

Bearbeiten Sie das generierte Projekt direkt:

Routen-Dateien in src/pages/ ändern.
Gemeinsames Markup in src/layouts/ und src/components/ ändern.
Das anfängliche Modell in seed/seed.json vor dem ersten Setup ändern.
Das Modell einer bestehenden Website unter Content Types im Admin verwalten.

Nutzen Sie Themes erstellen, um eine wiederverwendbare Vorlage vorzubereiten, und Seed-Dateien für den vollständigen Seed-Vertrag.