URL-Slug aus einem Git-Branch-Namen erstellen

Die Funktion erkennt das erste Pfadsegment als Branch-Typ, verwendet alles danach als Beschreibung und normalisiert diesen Teil zu kleingeschriebenen, durch Bindestriche getrennten Wörtern. Sie arbeitet deterministisch und ohne Netzwerkzugriff. Enthält der Branch zwar ein Präfix, aber keine brauchbare Beschreibung, erhalten Sie eine eindeutige Fehlermeldung.

Trennen Sie Workflow-Metadaten von der nützlichen Beschreibung

Git-Teams beginnen Branch-Namen häufig mit einem Workflow-Typ wie feature, fix, chore, release oder docs. Dieses erste Segment hilft Menschen und Automatisierungen, den Zweck eines Branches zu erkennen, ist in einer öffentlichen URL jedoch meist überflüssig. Diese Funktion behandelt den Text vor dem ersten Schrägstrich als Typpräfix und leitet den Slug ausschließlich aus dem nachfolgenden Inhalt ab. So wird feature/add-user-login zu add-user-login und fix/checkout/payment-timeout zu checkout-payment-timeout. Verschachtelte Beschreibungspfade bleiben als Wörter erhalten, damit Ihr Team aussagekräftige Bereiche bewahren kann, ohne Schrägstriche in der endgültigen URL zu verwenden. Ein optionales Präfix refs/heads/, das Git-Werkzeuge und Systeme für kontinuierliche Integration häufig liefern, wird vor der Auswertung entfernt. Der Vorgang arbeitet nicht mit einer festen Liste zulässiger Branch-Typen. Jedes nicht leere erste Segment kann als Präfix dienen. Dadurch gilt dieselbe Regel auch für eigene Konventionen wie spike, experiment, maintenance oder einen von Ihrer Organisation festgelegten Ticketablauf.

Verstehen Sie die genaue Normalisierung des Slugs

Nach der Auswahl des beschreibenden Teils führt der Algorithmus eine feste Folge von Umwandlungen aus. Er entfernt äußere Leerzeichen, normalisiert lateinische Buchstaben mit Akzenten, wandelt Buchstaben in Kleinschreibung um, ersetzt jede Folge außerhalb von ASCII-Buchstaben und Ziffern durch einen Bindestrich und entfernt Bindestriche am Anfang und Ende. Schrägstriche, Leerzeichen, Unterstriche, Satzzeichen und wiederholte Trennzeichen ergeben deshalb dieselbe URL-sichere Form. Ein Branch wie feature/Account Settings_v2 wird zu account-settings-v2. Das Ergebnis ist bewusst vorhersehbar: Sprachmodelle, Wörterbücher, Netzwerkabfragen, Zufallswerte, Zeitangaben und Repository-Zustände spielen keine Rolle. Die Funktion erfindet keine Wörter und deutet keine Ticketkennungen. Bereits vorhandene Zahlen bleiben erhalten, was bei Namen wie fix/PROJ-482-login-loop hilfreich ist. Da die Normalisierung Symbole und nicht unterstützte Schriften entfernen kann, prüft die Funktion außerdem, ob mindestens ein verwendbarer Buchstabe oder eine Ziffer übrig bleibt. Besteht die Beschreibung nur aus Satzzeichen oder ungeeigneten Zeichen, wird ein Eingabefehler ausgegeben und nicht unbemerkt ein leerer Wert erzeugt.

Setzen Sie das Ergebnis sicher beim Publizieren ein

Das zurückgegebene Objekt enthält nur das Feld slug und kann daher unmittelbar eine Dokumentationsvorschau, die URL einer kurzlebigen Umgebung, einen Pfad für Versionshinweise, eine Änderungsseite oder einen Veröffentlichungsablauf für Pull Requests versorgen. Prüfen Sie das Ergebnis vor dem Reservieren einer Route, wenn Ihr Ziel zusätzliche Regeln besitzt, etwa eine Höchstlänge, geschützte Pfade oder die Forderung nach Eindeutigkeit. Diese Funktion fragt weder Ihren Router noch den Hosting-Anbieter, Git-Dienst oder die Inhaltsdatenbank ab und kann deshalb nicht erkennen, ob der Slug bereits vergeben ist. Sie prüft auch nicht, ob die Eingabe tatsächlich als Branch im Repository vorhanden ist, sondern wendet nur die dokumentierte Namenskonvention an. Namen ohne Schrägstrich, Namen direkt nach dem Typpräfix und Beschreibungen, die einen leeren Slug ergeben, werden abgewiesen. Dieses strenge Fehlerverhalten verhindert in Automatisierungen, dass fehlerhafte Quellen versehentlich unter einer leeren oder allgemeinen Route veröffentlicht werden. Bei Nutzung der API gilt pro Anfrage der veröffentlichte Grundpreis von $0.002. Für einzelne Umwandlungen läuft dieselbe deterministische Verarbeitung im Browser.