mcpField
A
arabic-ui

arabic-ui

github.com/jkc66デザイン・UI1640 回インストール5 週間前に更新
リポジトリ

arabic-ui について

arabic-uiは、アラビア語のインターフェース、技術文書、記事、長文向けの執筆・ローカライズスキルです。UI文案と文章の手順を分け、文法、複数形、組版、検証の規則を示します。

主な機能

  1. 01UIマイクロコピーの文法指針
  2. 02アラビア語長文の編集規則
  3. 036分類の複数形処理
  4. 04RTLと双方向テキストの指針
  5. 05文案の検証チェックリスト

活用シーン

  1. 01アラビア語のボタンや入力文を作成
  2. 02ダッシュボードやUIメッセージをローカライズ
  3. 03アラビア語の技術文書を執筆
  4. 04記事の文法と組版を確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jkc66/arabic-ui --skill arabic-ui

インストール後、Claude Code で/arabic-uiを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

.gitignore
README.md
package.json
LICENSE
references/
rtl-engineering.md
editorial-and-articles.md
aranjiya-glossary.md
scripts/
pluralize.test.ts
pluralize.ts

詳細

正格なアラビア語の文章とUIローカライズ(العربية الفصيحة للواجهات والمقالات)

現代のデジタルインターフェース、記事、技術文書、長文向けに設計された、高品質で簡潔なアラビア語テキストです。ネイティブのアラビア語文法、6種類の複数形、動詞文の勢いを徹底し、直訳調の語彙を厳しく排除します。


運用ワークフロー

対象領域を特定し、適切な手順に従います。

モード A:UI とインターフェースのマイクロコピー(ボタン、アラート、入力欄、ダッシュボード)
  1. 要素の種類を文法形式に対応させる:セクション 1.1 に従い、UI 要素を適切な文法形式に対応させます(例:ボタンには動名詞、プレースホルダーには命令形)。
  2. 簡潔なマイクロコピーを作成する:セクション 3(チェックリスト)と references/aranjiya-glossary.md に従い、助動詞や直訳調の表現を取り除きます。
  3. 動的カウンターを整形する:数値は scripts/pluralize.ts の formatArabicPlural() を通し、双数形の格変化(主格と斜格)に対応させます。
  4. BiDi と論理レイアウトを分離する:CSS の論理プロパティ(inset-inline-end)を使用し、中立文字(2 GB / 10 GB)を references/rtl-engineering.md に従って分離します。
  5. チェックリストで検証する:セクション 3.1 と 3.2 の基準を満たしているか確認します。
モード B:長文、記事、エッセイ(ブログ記事、ドキュメント、レポート)
  1. 動詞文の勢いを確立する:名詞中心の直訳調表現ではなく、能動態の動詞(تقديم الفعل والجملة الفعلية)から文を始めます(セクション 1.2 と references/editorial-and-articles.md を参照)。
  2. 報道調の冗長表現を取り除く:references/editorial-and-articles.md に従い、中身のない書き出し(من الجدير بالذكر أن、لا شك في أن)や直訳調の接続表現(يلعب دورًا、على صعيد آخر)を削除します。
  3. 意味の密度を高める:アル・ジャーヒズの原則を適用します。«إجاعة اللفظ وإشباع المعنى»(表現を切り詰め、意味を充実させる)。実務上または意味上の価値を何も加えない語はすべて削除します。
  4. 一貫したつなぎと表記を用いる:自然なアラビア語の接続詞(إذ、حيث、بل、ثم、فـ)で節をつなぎ、接続詞の Waw و の前後に空白を入れず、アラビア語の引用符 « » を使用します。
  5. チェックリストで検証する:セクション 3.1 と 3.3 の基準を満たしているか確認します。

1. 文法の枠組み

1.1 UI 文法の基本表
UI 要素の種類目標とする文法形式適切な例禁止する定型表現
ボタンとアクションのトリガー動名詞حفظ、تعديل、تسجيل الدخولاحفظ(ボタンに命令形を使わない)
フィールドのプレースホルダーとヒント命令形أدخل بريدك الإلكتروني、اختر الخطةقم بإدخال / يرجى إدخال
ステータスバッジと結果能動分詞/受動分詞/受動態مكتمل、معلّق、أُرسلت الرسالةتم الحفظ بنجاح
1.2 長文と編集の枠組み

正格なアラビア語の文章では、能動態の動詞文(الجملة الفعلية)から始め、助動詞(قام بـ、عمل على)を省き、翻訳調の決まり文句(يلعب دورًا、يسلط الضوء)に置き換え、意味のないつなぎの表現(من الجدير بالذكر أن)を避けます。

(変更前/変更後の包括的な表、禁止する書き出し、接続詞の一覧については、references/editorial-and-articles.md を確認してください)


2. 数え方、複数形、タイポグラフィの規則

2.1 6 つの複数形カテゴリー(CLDR)

動的なカウンターと数を含む文はすべて、次の 6 つのカテゴリーに対応する必要があります。

  • ゼロ(0):لا توجد ملفات または 0 ملف
  • 単数(1):ملف واحد(単数形+形容詞)
  • 双数(2):文法上の位置に応じて語形を変化させます。
    • 主格(アリフを伴う主格):تطبيقان متبقيان / ملفان(主語、述語、見出し)
    • 斜格(ヤーを伴う対格/属格):قبل دقيقتين / حذف تطبيقين(前置詞の後、直接目的語)
  • 少数(3~10):属格の少数複数形(3 تطبيقات、5 دقائق)
  • 多数(11~99):対格の単数形を区別語として使用(11 تطبيقًا、25 دقيقةً)
  • その他(100 以上):属格の単数形(100 تطبيق、1000 مستخدم)

実装ヘルパー:コードでは、数を scripts/pluralize.ts の formatArabicPlural() に渡してください。文字列を手動で連結しないでください(count + " " + noun)。

2.2 タイポグラフィ、接続詞、双方向テキスト
  • 接続詞ワーウ(و):後続の単語に空白なしで直接つなげます(الملفات والمجلدات)。
  • 句読点の字形:アラビア語のコンマ ،(U+060C)、セミコロン ؛(U+061B)、疑問符 ؟(U+061F)を使用します。直前に空白を入れないでください。
  • 引用符:文章や記事での引用には、アラビア語のギュメ « » を使用します。
  • 中立文字の双方向テキスト分離:数値の間にある中立文字(/、-、:)は、RTL では逆順に表示されます(2 GB / 10 GB は 10 GB / 2 GB に反転します)。式を <bdi> または <span dir="ltr"> で囲んでください。

3. 運用検証チェックリストと「アラブ風英語」防止ゲート

アラビア語の UI 文字列、翻訳、または長文はすべて、この客観的に検証可能な完了基準を満たす必要があります。

3.1 すべてのアラビア語の文章(UI と記事)
  • 過去の受動動作:アラビア語本来の内部受動態(حُذف الملف、أُطلق التحديث、أُرسل الرابط)を使用し、補助動詞(تم + مصدر または تمت عملية)を一切使用しません。
  • 所有:接尾代名詞(حسابك、ملفك、فكرتك)を使用し、迂言的な形容詞(الخاص بك / الخاصة بـ)を一切使用しません。
  • 副詞と状態:直接的な対格副詞または動名詞(تلقائيًا、فوريًا、باستمرار)を使用し、前置詞を介した直訳調の表現(بشكل تلقائي、بصورة مستمرة)を一切使用しません。
  • 期間と時間:時間を表す副詞の前に不要な前置詞を置きません(صالح 3 أيام、في 5 دقائق)。لمدة 3 أيام、خلال 5 دقائق は使用しません。
  • 手段の正確な表現:手段を表す Baa بـ または直接的な文脈(بالضغط هنا、في الإعدادات)を使用し、直訳調の媒介表現(من خلال、عبر)を排除します。
  • 直接的な最上級:本来の أَفْعَل 形(الأسرع、الأكفأ、الأضمن)を使用し、迂言的な直訳調の表現(الأكثر سرعة、الأكثر كفاءة)は使用しません。
  • 最上級の一致と属格:絶対最上級には属格構文(أطول الليالي、أجمل الفتيات)を優先するか、形容詞として使う場合は厳密な文法的一致(الدولتان العُظمَيان)を適用し、固定化された男性単数形(الدولتان الأعظم)は使用しません。
  • 原因を示す形容詞(النعت السببي):ぎこちない関係節(المشاريع التي تكاليفها مرتفعة)ではなく、簡潔な原因を示す形容詞(مشاريع باهظة تكاليفها、القرية الظالم أهلها)を使用します。
  • 不定性と部分性:不定名詞や不可算名詞には直接 Tanween(استغرق وقتاً、أعجب ناسٌ)を用い、直訳調の媒介表現(بعض الوقت、بعض الناس、أحد المطورين、أي مشكلة)を排除します。
  • 並列される属格構文:最初の名詞を属格にし、2つ目の名詞には代名詞を付けます(عرض البيانات وتعديلها)。二重の属格構文(عرض وتعديل البيانات)は使用しません。
  • 否定の選言:否定節は ولا でつなぎます(لا تعديل ولا حذف、لن نترك رجلاً ولا طفلاً)。直訳調の أو は使用しません。
  • 相互動詞:相互形(تحالفوا、تعاونوا などの تفاعل)をそのまま使用し、冗長な語句(مع بعضهم البعض)は厳格に省きます。
  • 禁止と任意性の区別:警告や制限に لا يجب(任意であることを示す)を決して使わず、直接的な接続法の否定命令(لا تُغلق الصفحة、يحظر الحذف)を使用します。
  • 存在状態:状態や出来事を表す場合、擬似存在表現 هناك を省きます(حدث خطأ、3 تحديثات معلقة)。هناك خطأ は使用しません。
  • 役割と行き先:機能や行き先を示す際、余分な كـ(比喩)を避けます(حفظ في المسودات、دخول المشرف)。حفظ كمسودة、الدخول كمسؤول は使用しません。
  • 隠れた外来表現の落とし穴:直訳調の表現を官僚的な擬似修正に置き換えません。as a の意味で بوصفه / بصفته مسؤولاً を使わず、دخول المشرف と直接表現します。
  • 直接動詞とコピュラ:コピュラ كن + صفة ではなく、直接動詞を使用します(احذر、تأكد)。كن حذرًا、كن متأكدًا は使用しません。
  • エラーと能力不足:肯定形の能力不足表現(تعذّر الاتصال、لم نتمكن من الحفظ)を使用し、失敗を表す直訳調の表現(فشل في الاتصال)は使用しません。
  • 双数の数え方(المثنى):双数名詞形(ملفان / ملفين)を使用し、数字を前に付ける形(2 ملف)は使用しません。
  • 複数形の区分:3~10には属格複数形(3 ملفات)、11~99には対格単数形(15 ملفًا)を正しく適用します。
  • 接続詞 Waw(و):後続する語に空白を入れず直接接続します(الملفات والمجلدات)。
  • アラビア語のタイポグラフィ:アラビア語の字形(،、؛、؟)を使用し、前に空白を入れません。

(85語以上の用語対応と構文の詳細については、references/aranjiya-glossary.md を参照してください)

3.2 UI とフロントエンドに特化した項目
  • ボタンとアクショントリガー:命令形の動詞(احفظ)ではなく、動名詞(حفظ、تعديل、تسجيل الدخول)を使用します。
  • フィールドの説明とヒント:丁寧表現や補助構文(قم بـ、يرجى、الرجاء)を一切使わず、命令形(أدخل、اختر)を使用します。
  • 双方向テキストの分離:数字の間にある中立文字(/、-、:)を、<bdi> または <span dir="ltr"> で分離します(<span dir="ltr">2 GB / 10 GB</span>)。
  • CSS論理インセット:末尾のアイコンと入力欄には inset-inline-end を使用し、物理方向を示す right は使用しません。

(レイアウトパターン、SSR の方向設定、アイコンの反転については、references/rtl-engineering.md を確認してください)

3.3 記事や長文の執筆に特化した項目
  • 動詞を軸にした表現:名詞中心の直訳調(الشركة قامت بإطلاق)ではなく、能動的な動詞(الجملة الفعلية)を文頭に置きます(أطلقت الشركة)。
  • 中身のない導入句:つなぎの定型句(من الجدير بالذكر أن、لا شك في أن、تجدر الإشارة إلى أن)を排除します。
  • 翻訳の決まり文句:外国語由来の比喩(يلعب دورًا、يسلط الضوء على、على مدار الساعة)を、直接的なアラビア語表現(يؤثر أثرًا بالغًا、يُبيّن、ليل نهار)に置き換えます。
  • 引用符:引用、出典、タイトルはアラビア語のギュメ « » で囲み、ラテン文字の " はコードに限って使用します。
  • アル・ジャーヒズの簡潔さの原則:表現を削ぎ落とし、意味を豊かにします(«إجاعة اللفظ وإشباع المعنى»)。省いても意味が変わらない語は削除します。

(記事の執筆ガイドラインと接続詞の検索について詳しくは、references/editorial-and-articles.md を確認してください)

コメント