Slugify

Was ist ein Slugify-Werkzeug?#

Ein Slugify-Werkzeug verwandelt einen menschenlesbaren Titel in einen URL-sicheren Slug — die kompakte, kleingeschriebene, zeichensatzfreie Zeichenkette, die in einer Webadresse nach der Domain steht. How to Brew Coffee at Home wird zu how-to-brew-coffee-at-home; Café Münchën wird zu cafe-munchen; 你好世界 wird zu ni-hao-shi-jie. Slugs sind die Art, wie Blogs, E-Commerce-Seiten und Dokumentationssysteme lesbare, teilbare, SEO-freundliche URLs aus Titeln bauen, die nie mit einer URL im Hinterkopf geschrieben wurden.

Die kniffligen Teile sind genau die Zeichen, die Menschen tatsächlich nutzen: Akzente (café), Ligaturen (ß, æ), Geviertstriche und typografische Anführungszeichen sowie CJK-Ideographen, die überhaupt keine ASCII-Repräsentation haben. Ein naives „alles löschen, was nicht a-z ist“, macht aus 你好世界 eine leere Zeichenkette, was eine kaputte URL ergibt. Dieses Werkzeug behandelt alle drei sauber: Es zerlegt akzentuierte Buchstaben und streift die Kombinationszeichen (é → e), bildet die nicht zerlegbaren lateinischen Ligaturen ab (ß → ss, æ → ae) und transliteriert CJK-Ideographen zu tonlosem Pinyin (你好世界 → ni hao shi jie), sodass ein chinesischer Titel immer noch einen sinnvollen, aussprechbaren Slug erzeugt.

Alles läuft lokal. Das Pinyin-Wörterbuch wird nur geladen, wenn die Eingabe tatsächlich CJK enthält, sodass ein rein lateinischer Slug nie dafür bezahlt.

So wird es verwendet#

1. Tippen oder fügen Sie den Titel in die Eingabe-Spalte links ein.
2. Wählen Sie das Trennzeichen — Bindestrich (Standard) oder Unterstrich.
3. Aktivieren Sie Kleinbuchstaben (standardmäßig an), um die Ausgabe in Kleinbuchstaben zu falten; deaktivieren Sie es, wenn Sie Groß-/Kleinschreibung bewahren müssen.
4. Aktivieren Sie CJK zu Pinyin transliterieren (standardmäßig an), um CJK-Zeichen zu tonlosem Pinyin zu wandeln; deaktivieren Sie es, wenn Sie CJK lieber gestrippt als transliteriert haben möchten.
5. Setzen Sie optional eine Max. Länge (0 bedeutet unbegrenzt). Wenn der Slug sie überschreitet, wird er geschnitten und jeder hängende abschließende Trenner entfernt, sodass die URL nie auf einem bloßen - endet.
6. Lesen Sie die Ausgabe-Spalte rechts — der Slug erscheint im Moment, in dem sich Eingabe oder Optionen ändern. Klicken Sie auf Kopieren, um ihn zu übernehmen.

Die Statuszeile meldet die Slug-Länge und markiert zwei Sonderfälle: wenn CJK transliteriert wurde, und wenn das Ergebnis gekürzt wurde, um eine Maximalänge einzuhalten.

Die wichtigsten Funktionen#

• Akzent- und Ligatur-Behandlung. NFKD-Zerlegung plus eine kleine lateinische Kompatibilitäts-Tabelle macht café, Münchën, straße, œuvre zu sauberem ASCII (cafe, munchen, strasse, oeuvre), statt die Buchstaben einfach zu verwerfen.
• CJK zu Pinyin. Chinesische Ideographen werden über ein mitgeliefertes Wörterbuch zu tonlosem Pinyin transliteriert, sodass 你好世界 zu ni-hao-shi-jie wird — ein aussprechbarer, sinnvoller Slug statt eines leeren oder verstümmelten.
• Saubere Wortgrenzen. CJK-Läufe werden vor dem Trenner-Durchgang in Leerzeichen eingefasst, sodass die transliterierte Ausgabe in Wörter trennt (ni-hao) statt zusammenzukleben (nihao).
• Längenbegrenzung mit sauberem Trim. Eine Maximalänge schneidet den Slug und streift dann jeden hängenden abschließenden Trenner, sodass Sie nie eine URL erhalten, die auf - endet.
• Bindestrich oder Unterstrich. Wählen Sie das Trennzeichen, das Ihre Plattform erwartet — die meisten modernen Web-Slugs nutzen Bindestriche, aber manche Systeme und Dateinamenskonventionen nutzen Unterstriche.
• Fauler Pinyin-Ladevorgang. Das Pinyin-Wörterbuch wird nur importiert, wenn die Eingabe erstmals tatsächlich CJK enthält, sodass ein rein lateinischer Slug es nie herunterlädt.
• Lokal und wirft nie. Leere Eingabe meldet empty; Eingabe, die zu nichts reduziert (z. B. nur Emoji), meldet no-output. Fehler werden zu einer klaren Meldung, nie zu einer Ausnahme.

Anwendungsbeispiel#

Fügen Sie den Titel aus dem Eingabe-Platzhalter ein, mit allen Standards (Bindestrich-Trennzeichen, Kleinbuchstaben an, Transliteration an):

Café Münchën — 你好世界

Schritt für Schritt:

1. CJK wird erkannt, sodass 你好世界 zu ni hao shi jie transliteriert wird.
2. Akzente werden gestrippt: Café → Cafe, Münchën → Munchen.
3. Geviertstrich und Leerzeichen kollabieren zum Trennzeichen.
4. Das Ergebnis wird in Kleinbuchstaben gewandelt und führende/abschließende Trenner entfernt.

Die Ausgabespalte zeigt:

cafe-munchen-ni-hao-shi-jie

Setzen Sie nun Max. Länge auf 20 und regenerieren. Der Slug wird geschnitten und der hängende abschließende Bindestrich entfernt:

cafe-munchen-ni-hao

Beachten Sie, dass die Akzente zu einfachem ASCII wurden, der chinesische Titel zu aussprechbarem, in Wörter getrenntem Pinyin wurde und die Längenbegrenzung ein sauberes URL-Fragment erzeugte statt eines mid-Wort oder auf bloßem Bindestrich endenden.

FAQ#

Warum wird mein chinesischer Titel zu Pinyin, statt ein Zeichen zu bleiben?#

Weil URLs am sichersten und portabelsten sind, wenn sie ASCII nutzen. CJK-Zeichen in einer URL benötigen Percent-Encoding (jedes 你 wird zu %E4%BD%A0), das für Menschen und viele Analysetools unlesbar ist. Tonloses Pinyin hält den Slug aussprechbar, sinnvoll und rein ASCII — ni-hao-shi-jie ist eine weitaus bessere URL als eine Zeichenkette aus Prozentzeichen. Wenn Sie die Originalzeichen lieber behalten möchten, deaktivieren Sie CJK zu Pinyin transliterieren.

Was passiert mit Emoji und anderen nicht-alphanumerischen Symbolen?#

Sie werden gestrippt. Emoji, typografische Anführungszeichen, Klammern und die meisten Satzzeichen überleben die Slug-Pipeline nicht — sie sind keine Buchstaben, daher macht der Kollaps-Durchgang für Nicht-Alphanumerische sie zu Trennern. Wenn Ihre Eingabe nur aus Emoji und Symbolen besteht, wird alles weggestrippt und das Werkzeug meldet no-output, statt einen leeren Slug auszugeben.

Soll ich Bindestrich oder Unterstrich als Trennzeichen verwenden?#

Für URLs, die Menschen lesen werden, nutzen Sie einen Bindestrich — Suchmaschinen behandeln Bindestriche als Worttrenner und Bindestriche sind die Konvention über praktisch alle modernen Webplattformen. Unterstriche sind angebracht, wenn der Slug eigentlich ein Dateiname oder ein Bezeichner ist, der von einem System konsumiert wird, das Bindestriche für etwas anderes reserviert (Versionsbereiche, Flags). Das Werkzeug unterstützt beides, sodass Sie auf Ihr Ziel abstimmen können.

Wie funktioniert der Schnitt bei Maximalänge?#

Der Slug wird zuerst vollständig gebaut, dann auf die gewünschte Länge geschnitten. Fällt der Schnitt mitten in ein Wort, bleibt das Wort partial; lässt der Schnitt einen abschließenden Trenner zurück, wird dieser entfernt. Das garantiert, dass der Slug nie die Grenze überschreitet und nie auf einem bloßen - oder _ endet — was URL-Felder und Datenbank-Spaltenbreiten tatsächlich verlangen.

Ist dasselbe wie URL-Kodierung?#

Nein, und der Unterschied zählt. URL-Kodierung (Percent-Encoding) escapet Zeichen, damit sie in einer URL reisen können — café wird zu caf%C3%A9. Slugify normalisiert den Text stattdessen in ASCII-Buchstaben und Trenner — café wird zu cafe. Slugs sind für das menschenlesbare Pfadsegment einer URL; Percent-Encoding ist für den sicheren Transport beliebiger Werte in Query-Strings. Brauchen Sie letzteres, nutzen Sie das Werkzeug /en/encoding/url/.