Communitygithub.com

rtl-typography

ペルシア語(ファルシー)およびアラビア語Webインターフェース向けのコアタイポグラフィルール。ペルシア語/アラビア語テキストを含むUIの構築やスタイリング時、またはユーザーが「فارسی、عربی、RTL、نیم‌فاصله、فونت فارسی」に言及した際に使用します。フォント選択、ZWNJ(نیم‌فاصله)、ペルシア数字、句読法、行間、およびアラビア文字へのletter-spacing禁止パターンをカバーします。

rtl-typography とは?

このスキルは、右から左(RTL)方向のインターフェースにおけるタイポグラフィのベストプラクティスを定義します。ペルシア語またはアラビア語のテキストを含むあらゆるWeb UIの構築時に適用され、正しい文書設定、適切なフォントスタック、ZWNJ(ゼロ幅非接合子)の正しい使用法、適切な行間、誤ったletter-spacingの禁止など、RTL特有の重要なレイアウト問題を解決します。主にClaude Code、Cursor、CodexなどのAIエージェント向けに設計されており、マークダウンとコードブロックを含む包括的なSKILL.mdドキュメントを通じて、これらのルールを自動的に適用します。このスキルは、AIが生成するRTLテキストに頻繁に見られるフォントの欠落、ZWNJの誤用、letter-spacingの破壊的効果などのバグを防止します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mhmdsdqi87-cloud/TEKA_raast/tree/HEAD/skills/rtl-typography

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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(デフォルト)VazirmatnIBM Plex Sans Arabic
見出し/ディスプレイLalezar、EstedadCairo、Changa
エディトリアル/セリフ風Markazi Text、ParastooNoto Naskh Arabic
親しみやすい/システム風Sahel、ShabnamTajawal、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
ラテン語(埋め込みコンテキスト)0123456789U+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 は使用しない

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

関連スキル