Branch-Geschichte #

Diese Seite erklärt, wie die Exponential-Repositories Branches und Tags verwenden: wo die Entwicklung stattfindet, wie ein Release entsteht, welche Linien gepflegt werden und auf welchem Branch oder Tag Sie eine Website aufbauen. Der letzte Abschnitt bewahrt die Branches des ursprünglichen SVN-Repositorys aus den Jahren, in denen die Software eZ Publish hieß.

Jeder hier genannte Branch und Tag wurde am 18.10.2026 mit den Repositories auf GitHub abgeglichen. Branches und Tags entwickeln sich weiter; die Befehle unter jeder Überschrift zeigen den aktuellen Stand.

Kurz gefasst #

Das Kernel-Repository #

github.com/se7enxweb/exponential enthält den Kernel, die Designs der Administrationsoberfläche, die mitgelieferten Extensions (ezjscore, ezoe, ezformtoken, expservices) und diese Dokumentation.

main, der einzige langlebige Branch #

main ist der Standard-Branch und die Entwicklungslinie von 6.0. Er weist sich als 6.0.15 aus (lib/version.php) und enthält die Änderungen aus dem Changelog 6.0.15. Für Composer ist er dev-main, mit dem Branch-Alias 6.0.x-dev, sodass Pakete, die den Kernel mit einer Versionsbedingung wie ^6.0.14 verlangen, gegen ihn aufgelöst werden.

Jede Arbeit gelangt auf demselben Weg nach main:

1. Eine Änderung beginnt auf einem kurzlebigen Branch (eine Funktion, eine Korrektur oder eine Welle zusammengehöriger Arbeit), in einem Fork oder im Repository selbst.
2. Der Branch wird als Pull Request gegen main vorgeschlagen.
3. Jeder Pull Request wird gemergt, als Merge-Commit. Solange er offen ist, fasst sein Autor ihn zusammen (Squash) und setzt ihn per Rebase auf main auf, wie die Reviews es verlangen; nach dem Merge wird main nie umgeschrieben, und eine spätere Korrektur kommt als neuer Pull Request, sodass main sicher bleibt.
4. Der Branch wird gelöscht oder einfach liegen gelassen; aus ihm wird nichts weiter gemergt.

git log --merges origin/main listet die Merges auf. Commits von Projektautoren beginnen mit Added:, Updated:, Fixed:, Removed: oder Renamed:; daraus werden die Changelogs zusammengestellt.

Die Prüfungen bei jedem Push und Pull Request #

GitHub Actions führt bei einem Push auf main und bei einem Pull Request (auf dem Merge des Branches in main) dieselben blockierenden Prüfungen aus. Qualitätsprüfungen beschreibt jede davon; kurz gefasst:

Bei einem Pull Request sind eine veraltete Manifestzeile und die Commit-Nachricht eines Beitragenden Warnungen; wer mergt, aktualisiert das Manifest auf main. Bevor Sie pushen listet die Befehle auf, mit denen Sie die blockierenden Prüfungen lokal ausführen.

Release-Tags #

Ein Release ist ein Tag auf einem Commit von main mit dem Namen v6.0.<n>. Jedes hat eine Changelog-Seite in doc/changelogs/6.0 (die der aktuellen Linie: Changelog 6.0.15) und ein Release auf GitHub Releases:

Ein Tag ist dauerhaft. Composer und Packagist lesen ihn einmal, und ein „korrigierter“ Tag ergäbe zwei verschiedene Pakete mit derselben Versionsnummer. Ein Fehler in einem Release wird durch das nächste Release behoben. Sortieren Sie Tags nach Version, nie nach Namen (v6.0.10 steht nach Namen sortiert vor v6.0.8):

git fetch --tags
git tag -l 'v*' --sort=version:refname | tail -5

Release-Branches #

Neben main führt das Repository ab 6.0.7 einen Branch pro Release: 6.0.7 bis 6.0.14. Ab 6.0.8 zeigt jeder auf den Commit seines Tags; 6.0.7 hat spätere Commits als v6.0.7. Sie dokumentieren jedes Release und sind kein Ort, an dem die Entwicklung weitergeht; eine Korrektur geht nach main und in das nächste Release.

Einige ältere Branches stammen noch aus der Anfangszeit der Linie 6.0 (6.0.0-beta2, 6.0.1-beta1, 6.0.8-devel), dazu einige Themen-Branches aus Pull Requests, die vor langer Zeit gemergt wurden. Keiner davon wird gepflegt.

git ls-remote --heads https://github.com/se7enxweb/exponential.git

Release-Linien #

Die Release-Geschichte listet die Releases von 2.9 bis 6.0.15 mit ihren Daten und Quellen auf.

Extension-Repositories #

Jede Extension, die Exponential mit Composer installiert, liegt in einem eigenen Repository unter github.com/se7enxweb. Am 18.10.2026 verlangte die composer.json des Kernels 66 davon:

• 34 haben master als Standard-Branch und 32 haben main; in beiden Fällen ist er die Entwicklungslinie.
• Releases sind Tags, meist mit einem v (eztags v2.4.21, explayouts v1.4.39); einige haben keines (cjw_newsletter 4.2.12, enhancedselection2 2.1.8, birthday 1.3.3, ngclasslist 1.1.4, exponential-legacy-installer 2.2.4).
• Der Kernel verlangt jede davon mit einer Tilde-Bedingung auf ihr aktuelles Release, etwa ~2.4.21, die auch die späteren Releases derselben Linie akzeptiert (2.4.22 und folgende).
• Jedes Release hebt die Version in ezinfo.php und extension.xml der Extension in dem Commit, der getaggt wird, auf die Nummer des Releases an, sodass eine installierte Kopie angibt, welches Release sie ist.

Die mit dem Kernel mitgelieferten Extensions tragen ihre eigene Version: ezjscore wird gleichzeitig mit seinem Spiegel se7enxweb/ezjscore veröffentlicht (beide 1.8.4).

So sehen Sie die Branches und Tags einer Extension:

git ls-remote --heads --tags https://github.com/se7enxweb/eztags.git

Velocity und die Plattform-Distributionen #

Den Standard-Branch und die neuesten Releases eines Repositorys lesen Sie mit der GitHub CLI:

gh api repos/se7enxweb/exponential-platform-nexus --jq .default_branch
gh release list -R se7enxweb/exponential-platform-nexus --limit 5

Auf welchem Branch oder Tag Sie eine Website aufbauen #

Mit Git entwickeln zeigt, wie Sie den Kernel und die Extensions als Git-Klone installieren, einen Branch für Ihre Website beginnen, ihn aktuell halten und eine Korrektur als Pull Request zurückschicken. Versionen, Tags und Branches listet auf, welches Release welche PHP-Version benötigt.

Historische Branches (ursprüngliches SVN, 3.x) #

Hinweis: Dieser Abschnitt stammt aus der Dokumentation der ursprünglichen Software. Er wurde von eZ Systems AS und den Beitragenden zwischen 2003 und 2006 verfasst, als die Software eZ Publish hieß, und wird hier inhaltlich unverändert zum Nachschlagen aufbewahrt. Sein Originaltext wird unter der Lizenz verbreitet, mit der er kam, der GNU General Public License, Version 2 (Copyright (C) 1999 - 2014 eZ Systems AS and contributors). Der Text darüber ist neue Dokumentation unter der GNU Free Documentation License 1.3 oder später.

Das ursprüngliche Repository war SVN, wo ein Branch ein Verzeichnis war: stable/3.x für die Pflege einer Release-Linie und unstable/... für Entwicklungsarbeit. Ein Branch begann bei einer Revision („Revision“) und endete, wenn er geschlossen wurde, bei einer letzten Revision. Diese Branches sind nicht im Git-Repository; die Release-Tags derselben Jahre schon.

Stabile Branches #

Entwicklungs-Branches #

Der Datentyp-Branch wurde in Revision 2714 in den Trunk gemergt; die Release-Geschichte enthält seinen Eintrag und die Releases der Linien 3.x und 4.x.

Die ganze Geschichte des Codes, von eZ publish 1999 bis zu Exponential heute, erzählt Geschichte von Exponential (1999 - 2026).