Discourse unterstützt nativ Themes, die aus einem .tar.gz-Archiv oder aus einem entfernten Git-Repository bezogen werden können, einschließlich privater Repositories.
Ein Beispiel-Theme finden Sie unter: GitHub - discourse/discourse-simple-theme: Sam's simple discourse theme · GitHub
Das Git-Repository wird auf Updates überprüft (einmal täglich) oder über die Auf Updates prüfen-Schaltfläche. Wenn Änderungen erkannt werden, wechselt die Auf Updates prüfen-Schaltfläche zu Auf neueste Version aktualisieren.
Um ein Theme zu erstellen, müssen Sie eine bestimmte Dateistruktur einhalten. Dies sind die Dateien, die Sie einbinden können:
about.json (erforderlich)
common/common.scss
common/header.html
common/after_header.html
common/footer.html
common/head_tag.html
common/body_tag.html
common/embedded.scss
desktop/desktop.scss
desktop/header.html
desktop/after_header.html
desktop/footer.html
desktop/head_tag.html
desktop/body_tag.html
mobile/mobile.scss
mobile/header.html
mobile/after_header.html
mobile/footer.html
mobile/head_tag.html
mobile/body_tag.html
locales/en.yml
locales/{locale}.yml
stylesheets/{anything}/{anything}/{anything}.scss
javascripts/{anything}.js
javascripts/{anything}.gjs
javascripts/{anything}.hbs
assets/{asset_filename}
settings.yml
Alle diese Dateien 
sind optional, sodass Sie nur die erstellen müssen, die Sie benötigen.
Für diejenigen, die das Theme-SCSS in mehrere Dateien aufteilen möchten, ist dies jetzt möglich.
Für diejenigen, die das Theme in mehrere JS-Dateien aufteilen möchten, fügen Sie einfach die gewünschten JS-Dateien in das javascripts-Verzeichnis ein.
Die Struktur der about.json-Datei ist unten dargestellt, und weitere Informationen dazu finden Sie unter https://meta.discourse.org/t/adding-metadata-to-a-theme/119205:
{
"name": "My Theme",
"component": false,
"license_url": null,
"about_url": null,
"authors": null,
"theme_version": null,
"minimum_discourse_version": null,
"maximum_discourse_version": null,
"assets": {
"variable-name": "assets/my-asset.jpg"
},
"color_schemes": {
"My Color Scheme": {
"primary": "222222"
}
},
"screenshots": ["screenshots/light.jpeg", "screenshots/dark.jpeg"]
}
Anweisungen zum Hinzufügen von Einstellungen zu Ihrem Theme finden Sie hier: Add settings to your Discourse theme.
Um Discourse mitzuteilen, dass Sie ein Theme-Komponente und kein vollständiges Theme hinzufügen werden, fügen Sie einfach die Zeile "component": true zur about.json-Datei hinzu.
Die Dateistruktur entspricht dem benutzerdefinierten CSS / HTML des Themes.
Weiterlesen
Schauen Sie sich die anderen Artikel mit dem #themes::tag-Tag an.
Siehe auch:
- Developing Discourse Themes & Theme Components
- Install the Discourse Theme CLI console app to help you build themes
- Include assets (e.g. images, fonts) in themes and components
Zuletzt geprüft von @SaraDev am 2022-08-15T21:00:00Z
Dieses Dokument wird versioniert verwaltet – schlagen Sie Änderungen auf GitHub vor.