arabic-ui について
arabic-uiは、アラビア語のインターフェース、技術文書、記事、長文向けの執筆・ローカライズスキルです。UI文案と文章の手順を分け、文法、複数形、組版、検証の規則を示します。
主な機能
- 01UIマイクロコピーの文法指針
- 02アラビア語長文の編集規則
- 036分類の複数形処理
- 04RTLと双方向テキストの指針
- 05文案の検証チェックリスト
活用シーン
- 01アラビア語のボタンや入力文を作成
- 02ダッシュボードやUIメッセージをローカライズ
- 03アラビア語の技術文書を執筆
- 04記事の文法と組版を確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ jkc66/ arabic-ui --skill arabic-uiインストール後、Claude Code で/arabic-uiを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
.gitignoreREADME.mdpackage.jsonLICENSEreferences/rtl-engineering.mdeditorial-and-articles.mdaranjiya-glossary.mdscripts/pluralize.test.tspluralize.ts詳細
正格なアラビア語の文章とUIローカライズ(العربية الفصيحة للواجهات والمقالات)
現代のデジタルインターフェース、記事、技術文書、長文向けに設計された、高品質で簡潔なアラビア語テキストです。ネイティブのアラビア語文法、6種類の複数形、動詞文の勢いを徹底し、直訳調の語彙を厳しく排除します。
運用ワークフロー
対象領域を特定し、適切な手順に従います。
モード A:UI とインターフェースのマイクロコピー(ボタン、アラート、入力欄、ダッシュボード)
- 要素の種類を文法形式に対応させる:セクション 1.1 に従い、UI 要素を適切な文法形式に対応させます(例:ボタンには動名詞、プレースホルダーには命令形)。
- 簡潔なマイクロコピーを作成する:セクション 3(チェックリスト)と references/aranjiya-glossary.md に従い、助動詞や直訳調の表現を取り除きます。
- 動的カウンターを整形する:数値は scripts/pluralize.ts の
formatArabicPlural()を通し、双数形の格変化(主格と斜格)に対応させます。 - BiDi と論理レイアウトを分離する:CSS の論理プロパティ(
inset-inline-end)を使用し、中立文字(2 GB / 10 GB)を references/rtl-engineering.md に従って分離します。 - チェックリストで検証する:セクション 3.1 と 3.2 の基準を満たしているか確認します。
モード B:長文、記事、エッセイ(ブログ記事、ドキュメント、レポート)
- 動詞文の勢いを確立する:名詞中心の直訳調表現ではなく、能動態の動詞(تقديم الفعل والجملة الفعلية)から文を始めます(セクション 1.2 と references/editorial-and-articles.md を参照)。
- 報道調の冗長表現を取り除く:references/editorial-and-articles.md に従い、中身のない書き出し(
من الجدير بالذكر أن、لا شك في أن)や直訳調の接続表現(يلعب دورًا、على صعيد آخر)を削除します。 - 意味の密度を高める:アル・ジャーヒズの原則を適用します。«إجاعة اللفظ وإشباع المعنى»(表現を切り詰め、意味を充実させる)。実務上または意味上の価値を何も加えない語はすべて削除します。
- 一貫したつなぎと表記を用いる:自然なアラビア語の接続詞(
إذ、حيث、بل、ثم、فـ)で節をつなぎ、接続詞の Wawوの前後に空白を入れず、アラビア語の引用符« »を使用します。 - チェックリストで検証する:セクション 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 を確認してください)