RTLタイポグラフィ:ペルシア語とアラビア語を正しく扱う
このスキルは、右から左方向のインターフェース向けタイポグラフィレイヤーを定義します。ページのテキストがペルシア語またはアラビア語である場合に適用してください。フルページ構築については rtl-landing を、コンポーネントパターンについては rtl-components を参照してください。
1. 文書設定 — 常に最初に行う
<html lang="fa" dir="rtl">
langとdirは常に一緒に設定します。ペルシア語の場合はlang="fa"、アラビア語の場合はlang="ar"です。- LTR文書で
text-align: rightを使用してRTLをシミュレートしないでください。ブラウザ、スクリーンリーダー、フォームコントロール、スクロールバーはすべてdirを基準に動作します。 - すべての配置は論理値を使用します:
text-align: start、leftは使用しません。
2. フォント
言語向けに設計されたフォントを使用します。ペルシア語のグリフがないフォントは、文字化け/トーフ(豆腐)形状を表示するか、静かに代替フォントに置き換わります。
信頼できる選択肢(詳細とCDNスニペットは fonts.md にあります):
| ユースケース | ペルシア語 | アラビア語 |
|---|---|---|
| 本文/UI(デフォルト) | Vazirmatn | IBM Plex Sans Arabic |
| 見出し/ディスプレイ | Lalezar、Estedad | Cairo、Changa |
| エディトリアル/セリフ風 | Markazi Text、Parastoo | Noto Naskh Arabic |
| 親しみやすい/システム風 | Sahel、Shabnam | Tajawal、Almarai |
スタックパターン — 常にフォールバックを指定し、1つのフォントでラテン文字をカバーします:
font-family: 'Vazirmatn', Tahoma, sans-serif;
woff2 のみを読み込み、font-display: swap を使用し、使用するウェイト(通常400、500、700で十分)にサブセット化します。
3. アラビア文字にletter-spacingを使用しない
これは、AIが生成するRTLバグの中で最も一般的なものです。
アラビア文字は筆記体であり、結合(ジャスト)しています。letter-spacing は結合されたグリフ間にギャップを挿入し、視覚的に単語を破壊します:「مدیریت」は「م د ی ر ی ت」になります。
/* 間違い — 結合を壊す */
.hero-title { letter-spacing: 0.05em; }
/* 正しい — より広い表示テキストが必要な場合は、代わりにサイズ/ウェイトを使用 */
.hero-title { font-weight: 800; font-size: 3rem; }
ルール:アラビア文字テキストには letter-spacing: 0、または設定しない。トラッキングのトリック(大文字、ワイドトラッキング)はそもそも適用されません — アラビア文字には大文字小文字がありません。
4. 行間とリズム
アラビア文字の行ボックスはラテン文字より高い(アセンダー/ディセンダー + ダイアクリティカルマーク)。ラテン文字のデフォルトは窮屈に見えます。
- ペルシア語本文:
line-height: 1.8–2.0(1.9が安全なデフォルト) - アラビア語本文:
line-height: 1.6–1.8 - 見出し:
1.3–1.4 - ペルシア語テキストは同じ内容でも英語より約10~15%幅が広くなります — ボタンは広めに、段落の幅も広めに確保し、切り詰めすぎないようにします。
両端揃え:先頭揃え( ragged text)を推奨します。カシダ(kashida)対応がないブラウザでの両端揃えは、単語間に醜い川(river)を作り出します。
5. ZWNJ — نیمفاصله(U+200C)
ペルシア語の複合語や接辞は、部分の間にゼロ幅非接合子(ZWNJ)を挟んで書きます。ZWNJの欠落は、AIが生成したペルシア語コピーで最も顕著なつづりの欠陥です。
正しい使用法の表
| 間違い(スペースまたは結合) | 正しい(U+200Cを使用) |
|---|---|
می رود | میرود |
نمی شود | نمیشود |
می خواهم | میخواهم |
خانه ها | خانهها |
کتاب های | کتابهای |
بهترین ها | بهترینها |
خوب تر | خوبتر |
برنامه نویسی | برنامهنویسی |
راه اندازی | راهاندازی |
ورود به سیستم می پردازد | ورود به سیستم میپردازد |
経験則:
- 接頭辞
می、نمی、بی、هم、نا、باز+ 動詞/形容詞 → ZWNJ:میگوید、نمیدانست、بینقص、همگام - 接尾辞
ها、های、تر、ترینが単語の後 → ZWNJ:پرندهها、کتابهای、بزرگتر、بزرگترین - アカデミー語彙リストからの複合名詞 → ZWNJ:راهاندازی、برنامهنویسی、نرمافزار、ذخیرهسازی
- 所有接尾辞
ام/ات/اشは結合して書く:کتابم、خانهات — ここにはZWNJを挿入しない。
ペルシア語のコピーを生成するときは、ZWNJをネイティブに(スペースではなく)書きます。既存テキストをサニタイズするには、バンドルされたスクリプトを使用します:
python3 scripts/fix-zwnj.py draft.md # dry-run diff
python3 draft-output.md > fixed.md --apply ... # --help 参照
このスクリプトは一般的な破損パターン(می رود、خانه ها、خوب تر)を結合し、アラビア語の ي ك をペルシア語の ی ک に変換し、コードブロックやURLには触れません。
6. 数字
| 言語 | 数字 | Unicode範囲 |
|---|---|---|
| ペルシア語 | ۰۱۲۳۴۵۶۷۸۹ | U+06F0–U+06F9 |
| アラビア語 | ٠١٢٣٤٥٦٧٨٩ | U+0660–U+0669 |
| ラテン語(埋め込みコンテキスト) | 0123456789 | U+0030–U+0039 |
- ペルシア語で書かれたコピーはペルシア数字を使用します:「۵ دلیل」、「۲۴ ساعت」.
- 価格:
۱۲۵٬۰۰۰ تومان— 3桁区切りは U+066C(٬)、小数点は U+066B(٫)です。 - パーセントは数字の後ろにスペースなしで:
۱۲٪(アラビアパーセント記号 U+066A). - これらを手動でフォーマットしないでください:JSのlocale APIを使用します。
(125000).toLocaleString('fa-IR') // "۱۲۵٬۰۰۰"
(12.5).toLocaleString('fa-IR') // "۱۲٫۵"
new Intl.NumberFormat('fa-IR', { style: 'percent' }).format(0.12) // "۱۲٪"
西洋数字は、本質的にLTRの原子(電話番号、URL、コード、外貨での価格)内でのみ保持します。
7. 句読点 — ペルシア語テキストにはペルシア語記号を
| 目的 | ペルシア語/アラビア語 | 使用しない |
|---|---|---|
| コンマ | ، (U+060C) | , |
| 疑問符 | ؟ (U+061F) | ? |
| セミコロン | ؛ (U+061B) | ; |
| 引用符 | «متن» | "متن" |
| 小数点 / 3桁区切り | ٫ ٬ | . , |
| パーセント | ٪ (U+066A) | % |
省略記号は …、三点リーダーではありません。، ؟ ؛ の前にスペースなし;後に1つのスペース。
8. ペルシア語 vs アラビア語 — まず判断する
これらは異なる規則を持つ異なる言語です。スタイリング前にどちらかを確認してください:
- 数字:fa → ۱۲۳ (U+06F0)、ar → ١٢٣ (U+0660)
- 文字:ペルシア語 ی/ک vs アラビア語 ي/ك — ペルシア語フォントはペルシア語形式を含める必要があります
- 句読点は重複しますが、トーン/慣用句は異なります
- アラビア語ページにペルシア語専用フォントを使用すると、ک/یの文字形式が間違って表示され、その逆も同様です
機械可読な規則(数字範囲、区切り、句読点、接辞リスト)は raast/profiles/fa.json と raast/profiles/ar.json に保存されています — これらは raast CLIが使用するのと同じファイルであり、散文ルールと自動チェックが乖離しないようにします。
9. コピー、ペースト、選択、レンダリング
アラビア文字テキストは、コピー/ペーストおよび選択において、ラテン文字よりも頻繁に問題が発生します。ルール:
- 選択レンダリング: 十分なコントラストで
::selectionを設定します(アラビア文字のグリフクラスタは行の下に拡張するため、細いハイライトバンドで視覚的にスライスされます)。::selectionにパディングを追加すると効果的です。 - コピー/ペーストの整合性: ユーザーがプレーンテキストフィールドにペーストする可能性のある領域に、プログラムでZWNJを挿入しないでください。ページへのペースト時は、ペーストされたテキストをバイト単位でそのまま保持します(U+200C、U+200E/F、U+061Cアラビア文字マークの自動「クリーンアップ」は行わない)。不可視文字を削除すると、ペルシア語の検索とつづりが密かに破損します。
- 引用/引用文の
user-select: allにより、ギュメ(«»)がくっついたままになります。 - クリップボードへのコピーコンポーネント(価格、トラッキング番号)は、視覚的にリオーダーされた文字列ではなく、論理的な文字列をコピーする必要があります — RTLページとLTRクリップボードビューアでテストしてください。
- フォントレンダリングフラグ:
text-rendering: optimizeLegibilityを推奨します。アラビア語表示用フェイスにfont-synthesisウェイトを使用しない(偽のボールドはnaskhリズムを壊す) — 実際のウェイトを読み込んでください。 - 曖昧な変換に関する警告: アラビア・インド数字(٠١٢)をペルシア数字(۰۱۲)に正規化することは、faコンテンツでは安全ですが、arコンテンツでは破壊的です。自動変換は言語でゲート制御する必要があります — 判断表については
references/normalization.mdを参照してください。
10. 混在スクリプトの基本(詳細は rtl-bidi スキル)
- ペルシア語テキスト内の電話/メール/URL/コード:
<bdi>またはdir="ltr"スパンで囲みます。 - コードブロック:RTLページでも、常に
dir="ltr"+text-align: left。 - ユーザー生成入力:
dir="auto"により、各入力が自身のコンテンツに適応します。
11. 出発前チェックリスト
-
<html lang="fa|ar" dir="rtl">が設定されている - フォントが言語をカバーしている;フォールバックが指定されている
- アラビア文字テキストに
letter-spacingがない - 本文のline-height ≥ 1.8(ペルシア語)
- すべての接辞に実際のU+200Cが使用され、スペースではない
- コピー内でペルシア数字 + ٬ ٫ ٪ ٬ が使用され、ラテン数字はLTR原子のみ
- コピー内でペルシア語句読点 、 ؟ ؛ «» が使用されている
- 配置は
start/endを使用し、left/rightは使用しない