Entwicklung & API

Bludit-Plugin oder Theme veröffentlichen: Paketstruktur, Versionierung und Repository

Vom lokalen Projekt zum teilbaren ZIP und öffentlichen Repository.

Wenn ein eigenes Plugin oder Theme nicht nur lokal genutzt werden soll, braucht es nachvollziehbare Metadaten, eine saubere Verzeichnisstruktur, eine Lizenz und idealerweise ein öffentliches Repository. Bludit dokumentiert einen Weg, Erweiterungen in die offiziellen Listen aufnehmen zu lassen.

Vor Veröffentlichung prüfen

  • Repository-Wurzel enthält die eigentliche Erweiterung und keine zufälligen Build-/IDE-Dateien.
  • metadata.json nennt Version, Datum, Lizenz und Kompatibilität.
  • Mindestens languages/en.json ist vorhanden.
  • README enthält Installation, Konfiguration, Screenshots/Beispiele und Changelog.
  • Keine Passwörter, Tokens oder lokalen Pfade im Repository.
  • ZIP-Struktur besitzt genau einen Plugin- bzw. Theme-Ordner.

Offizielle Repositories

Die Bludit-Dokumentation beschreibt, dass öffentliche GitHub-Repositories über die jeweiligen repositories.txt-Listen für Plugins bzw. Themes vorgeschlagen werden können. Dafür wird ein Pull Request auf die entsprechende Liste erstellt.

Versionierung

Nutze nachvollziehbare Versionsnummern. Bei kompatibilitätsbrechenden Änderungen sollte die Hauptversion steigen; Bugfixes gehören in Patch-Versionen. Für Bludit ist zusätzlich das Feld compatible wichtig, damit Administratoren Warnungen erhalten, wenn die Erweiterung nicht zur installierten Haupt-/Nebenversion passt.

Quellen und weiterführende Dokumentation