Discourse-Themen und Themenkomponenten können verwendet werden, um das Aussehen, die Haptik und die Funktionalität des Frontends von Discourse anzupassen. Dieser Abschnitt der Entwickler-Guides soll alle Referenzmaterialien bereitstellen, die Sie benötigen, um einfache Themes für eine einzelne Website bis hin zu komplexen Open-Source-Themenkomponenten zu entwickeln.
Diese Einführung soll eine Übersicht über alle Tools und APIs für die Theme-Entwicklung geben. Wenn Sie ein schrittweises Tutorial für die Theme-Entwicklung bevorzugen, springen Sie direkt zu:
Themes vs. Themenkomponenten
Discourse Themes können verwendet werden, um die Frontend-Benutzererfahrung mithilfe von CSS und JavaScript anzupassen. Jedes Theme hat sein eigenes Git-Repository, und Community-Administratoren können sie in der Regel über das Discourse-Admin-Panel installieren und verwalten, selbst auf Shared-Hosting-Plattformen.
Themenkomponenten sind Themes, die zur Verwendung neben anderen Themenkomponenten als Teil eines übergeordneten Themes gedacht sind. Aus Entwicklungssicht sind Themenkomponenten und Themes nahezu identisch. In diesen Anleitungen werden die Begriffe „Theme“ und „Themenkomponente“ austauschbar verwendet.
Voraussetzungen
Stellen Sie zunächst sicher, dass Sie verstehen, wie bestehende Themes und Themenkomponenten in Discourse verwendet werden. Die Verwendung fertiger Themes ist der schnellste und sicherste Weg, Ihre Community anzupassen. Wenn Sie mehr benötigen, ist es Zeit, über das Schreiben Ihres eigenen Themes nachzudenken.
Als Teil von Discourse’s Gesamtarchitektur werden Discourse Themes mit Standard-HTML-, CSS- und JavaScript-Technologien erstellt und nutzen Ember-Konzepte für fortgeschrittenere Benutzeroberflächen. Diese Referenzhandbücher setzen ein grundlegendes Verständnis dieser Technologien voraus und verlinken, wo möglich, auf externe Referenzen.
Discourse ist ein sich schnell entwickelndes Projekt, und daher wird jedes benutzerdefinierte Theme mit der Zeit Wartung erfordern. Berücksichtigen Sie dies bei Ihren Planungs- und Entwicklungsprozessen.
Erste Schritte
Frontend-Anpassung
Mehr!
Schauen Sie sich die restlichen Entwickler-Guides an!
Dieses Dokument wird versioniert – schlagen Sie Änderungen auf github vor.