RTL-Typografie: Persisch & Arabisch richtig gemacht
Dieser Skill kodiert die Typografie-Ebene für rechts-nach-links-Oberflächen. Folge ihm immer, wenn der Text auf der Seite Persisch oder Arabisch ist. Für komplette Seitenaufbauten siehe rtl-landing, für Komponentenmuster siehe rtl-components.
1. Dokument-Einrichtung — immer zuerst
<html lang="fa" dir="rtl">
- Setze
langUNDdirgemeinsam.lang="fa"für Persisch,lang="ar"für Arabisch. - Simuliere RTL niemals mit
text-align: rightin einem LTR-Dokument. Browser, Screenreader, Formularelemente und Bildlaufleisten richten sich nachdir. - Jede Ausrichtung muss logische Werte verwenden:
text-align: start, nichtleft.
2. Schriftarten
Verwende eine Schriftart, die für die Sprache entwickelt wurde. Eine Schriftart, der persische Glyphen fehlen, erzeugt defekte/Tofu-Formen oder ersetzt sie stillschweigend.
Zuverlässige Optionen (Details + CDN-Snippets in fonts.md):
| Verwendungszweck | Persisch | Arabisch |
|---|---|---|
| Fließtext/UI (Standard) | Vazirmatn | IBM Plex Sans Arabic |
| Auszeichnung/Überschriften | Lalezar, Estedad | Cairo, Changa |
| Redaktionell/Serifen-Stil | Markazi Text, Parastoo | Noto Naskh Arabic |
| Vertrautes/System-Stil | Sahel, Shabnam | Tajawal, Almarai |
Stapelmuster — benenne immer einen Fallback und lasse eine Schriftart Latein abdecken:
font-family: 'Vazirmatn', Tahoma, sans-serif;
Lade nur woff2, verwende font-display: swap, subsette die verwendeten Schriftstärken (400, 500, 700 reichen normalerweise).
3. NIEMALS Buchstabenabstand bei arabischer Schrift verwenden
Dies ist der häufigste KI-generierte RTL-Fehler.
Arabische Schriftzeichen sind kursiv und verbunden. letter-spacing fügt Lücken zwischen verbundenen Glyphen ein und zerbricht Wörter optisch: «مدیریت» wird zu م د ی ر ی ت.
/* FALSCH — zerstört die Verbindung */
.hero-title { letter-spacing: 0.05em; }
/* RICHTIG — falls breiterer Darstellungstext benötigt wird, stattdessen Größe/Schriftstärke verwenden */
.hero-title { font-weight: 800; font-size: 3rem; }
Regel: letter-spacing: 0 oder nicht gesetzt für jeden arabischen Text. Tracking-Tricks (Großbuchstaben, breites Tracking) treffen ohnehin nicht zu — die arabische Schrift hat keine Groß-/Kleinschreibung.
4. Zeilenhöhe und Rhythmus
Zeilenboxen arabischer Schrift sind höher als lateinische (Ober-/Unterlängen + Diakritika). Lateinische Standardwerte wirken gedrängt.
- Persischer Fließtext:
line-height: 1.8–2.0(1.9 ist ein sicherer Standardwert) - Arabischer Fließtext:
line-height: 1.6–1.8 - Überschriften:
1.3–1.4 - Persischer Text läuft ~10–15 % breiter als Englisch für denselben Inhalt — kalkuliere breitere Buttons, mehr Absatzbreite ein, kürze nicht übermäßig.
Blocksatz: Bevorzuge start-ausgerichteten (gebrochenen) Text. Browser-Blocksatz ohne Kashida-Unterstützung erzeugt hässliche Flüsse zwischen Wörtern.
5. ZWNJ — نیمفاصله (U+200C)
Persische Zusammensetzungen und Affixe werden mit einem Zero-Width Non-Joiner zwischen den Teilen geschrieben. Fehlender ZWNJ ist der sichtbarste Rechtschreibfehler in generierten persischen Texten.
Tabelle zur korrekten Verwendung
| Falsch (Leerzeichen oder verbunden) | Richtig (mit U+200C) |
|---|---|
می رود | میرود |
نمی شود | نمیشود |
می خواهم | میخواهم |
خانه ها | خانهها |
کتاب های | کتابهای |
بهترین ها | بهترینها |
خوب تر | خوبتر |
برنامه نویسی | برنامهنویسی |
راه اندازی | راهاندازی |
ورود به سیستم می پردازد | ورود به سیستم میپردازد |
Faustregeln:
- Präfixe
می,نمی,بی,هم,نا,باز+ Verb/Adjektiv → ZWNJ: میگوید، نمیدانست، بینقص، همگام - Suffixe
ها,های,تر,ترینnach einem Wort → ZWNJ: پرندهها، کتابهای، بزرگتر، بزرگترین - Zusammengesetzte Substantive aus der Akademie-Wortliste → ZWNJ: راهاندازی، برنامهنویسی، نرمافزار، ذخیرهسازی
- Possessivsuffixe
ام/ات/اشwerden verbunden geschrieben: کتابم، خانهات — füge dort KEINEN ZWNJ ein.
Beim Generieren von persischen Texten schreibe ZWNJ nativ (kein Leerzeichen). Um vorhandenen Text zu bereinigen, verwende das beiliegende Skript:
python3 scripts/fix-zwnj.py draft.md # Trockentest-Diff
python3 draft-output.md > fixed.md --apply ... # siehe --help
Das Skript verbindet häufige defekte Muster (می رود, خانه ها, خوب تر), konvertiert arabisches ي ك in persisches ی ک und verändert niemals Codeblöcke oder URLs.
6. Ziffern
| Sprache | Ziffern | Unicode-Bereich |
|---|---|---|
| Persisch | ۰۱۲۳۴۵۶۷۸۹ | U+06F0–U+06F9 |
| Arabisch | ٠١٢٣٤٥٦٧٨٩ | U+0660–U+0669 |
| Lateinisch (eingebettete Kontexte) | 0123456789 | U+0030–U+0039 |
- In persischer Sprache verfasster Text verwendet persische Ziffern: «۵ دلیل»، «۲۴ ساعت».
- Preise:
۱۲۵٬۰۰۰ تومان— Tausendertrennzeichen ist U+066C (٬), Dezimaltrennzeichen ist U+066B (٫). - Prozent nach der Zahl, kein Leerzeichen:
۱۲٪(arabisches Prozentzeichen U+066A). - Formatiere diese niemals von Hand: Verwende JS-Locale-APIs.
(125000).toLocaleString('fa-IR') // "۱۲۵٬۰۰۰"
(12.5).toLocaleString('fa-IR') // "۱۲٫۵"
new Intl.NumberFormat('fa-IR', { style: 'percent' }).format(0.12) // "۱۲٪"
erhalte westliche Ziffern nur in inhärent LTR-Atomen: Telefonnummern, URLs, Code, Preise in Fremdwährung.
7. Zeichensetzung — persische Zeichen in persischem Text
| Zweck | Persisch/Arabisch | Nicht verwenden |
|---|---|---|
| Komma | ، (U+060C) | , |
| Fragezeichen | ؟ (U+061F) | ? |
| Semikolon | ؛ (U+061B) | ; |
| Anführungszeichen | «متن» | "متن" |
| Dezimal / Tausender | ٫ ٬ | . , |
| Prozent | ٪ (U+066A) | % |
Auslassungspunkte sind …, nicht drei Punkte. Kein Leerzeichen vor ، ؟ ؛; ein Leerzeichen danach.
8. Persisch vs. Arabisch — zuerst entscheiden
Es sind unterschiedliche Sprachen mit unterschiedlichen Konventionen. Bestätige vor dem Gestalten, welche verwendet wird:
- Ziffern: fa → ۱۲۳ (U+06F0), ar → ١٢٣ (U+0660)
- Buchstaben: Persisch ی/ک vs. Arabisch ي/ك — eine persische Schriftart muss persische Formen enthalten
- Zeichensetzung überschneidet sich, aber Tonfall/Sprachgebrauch unterscheiden sich
- Eine nur für Persisch geeignete Schriftart zeigt auf einer arabischen Seite falsche Buchstabenformen für ک/ی und umgekehrt
Die maschinenlesbaren Konventionen (Ziffernbereiche, Trennzeichen, Zeichensetzung, Affixlisten) befinden sich in raast/profiles/fa.json und raast/profiles/ar.json — denselben Dateien, die auch die raast CLI verwendet, sodass Prosa-Regeln und automatisierte Prüfungen nie auseinanderdriften.
9. Kopieren, Einfügen, Auswahl & Darstellung
Text in arabischer Schrift bricht beim Kopieren/Einfügen und bei der Auswahl häufiger als lateinischer Text. Regeln:
- Darstellung der Auswahl: setze
::selectionmit ausreichendem Kontrast (Glyphencluster arabischer Schrift erstrecken sich unter die Grundlinie; ein dünner Hervorhebungsbalken schneidet sie optisch ab). Ein Innenabstand bei::selectionhilft. - Integrität von Kopieren/Einfügen: füge ZWNJ niemals programmatisch in Bereiche ein, in die Benutzer in Klartextfelder einfügen könnten; beim Einfügen auf die Seite hin behalte den eingefügten Text bytegenau bei (keine automatische "Bereinigung" von U+200C, U+200E/F, U+061C arabisches Buchstabenzeichen). Das Entfernen unsichtbarer Zeichen beschädigt stillschweigend die persische Suche und Rechtschreibung.
user-select: allbei Zitaten/Quellenangaben, damit Guillemets verbunden bleiben.- In-die-Zwischenablage-Kopierkomponenten (Preis, Sendungsnummer) müssen die logische Zeichenfolge kopieren, nicht die visuell neu angeordnete — teste mit einer RTL-Seite + LTR-Zwischenablage-Viewer.
- Schriftdarstellungsflags: bevorzuge
text-rendering: optimizeLegibility; verwende KEINEfont-synthesis-Gewichtungen bei arabischen Auszeichnungsschriftarten (gefälschtes Fett zerstört den Naskh-Rhythmus) — lade echte Gewichtungen. - Warnungen zu mehrdeutigen Transformationen: Das Normalisieren arabisch-indischer Ziffern (٠١٢) zu persischen (۰۱۲) ist in fa-Inhalten sicher, in ar-Inhalten zerstörend. Jede automatisierte Konvertierung muss sprachabhängig sein — siehe
references/normalization.mdfür die Entscheidungstabelle.
10. Grundlagen gemischter Schriftsysteme (Details im rtl-bidi-Skill)
- Telefon/E-Mail/URL/Code innerhalb von persischem Text: umschließe mit
<bdi>oder einemdir="ltr"-Span. - Codeblöcke: immer
dir="ltr"+text-align: left, auch auf RTL-Seiten. - Benutzereingaben:
dir="auto", sodass jede Eingabe sich an ihren eigenen Inhalt anpasst.
11. Vorab-Checkliste
-
<html lang="fa|ar" dir="rtl">gesetzt - Schriftart deckt die Sprache ab; Fallback benannt
-
letter-spacingfehlt bei arabischem Text - Zeilenhöhe Fließtext ≥ 1.8 (Persisch)
- Alle Affixe verwenden echten U+200C, keine Leerzeichen
- Persische Ziffern + ٬ ٫ ٪ ٬ im Text; lateinische Ziffern nur in LTR-Atomen
- Persische Zeichensetzung ، ؟ ؛ «» im Text
- Ausrichtungen verwenden
start/end, niemalsleft/right