arabic-ui

地道阿拉伯语写作与界面本地化（面向界面与文章的规范阿拉伯语）

为现代数字界面、文章、技术文档和长篇写作打造高保真、简洁的阿拉伯语文本。严格遵循地道的阿拉伯语语法、六类复数规则、动词句的行文节奏，并避免生硬直译词汇。

---

操作工作流

确定目标领域，并遵循相应路径：

模式 A：UI 与界面微文案（按钮、警报、输入框、仪表板）

1. 将界面元素映射到语法形式：参照第 1.1 节，将界面元素匹配到目标语法形式（例如，按钮使用动名词，输入框占位符使用命令式动词）。
2. 撰写简洁的微文案：参照第 3 节（检查清单）和 references/aranjiya-glossary.md，删去助动词和生硬直译。
3. 格式化动态计数器：通过 scripts/pluralize.ts 中的 formatArabicPlural() 处理数字，并区分双数格变化（主格与斜格）。
4. 隔离双向文本与逻辑布局：使用 CSS 逻辑属性（inset-inline-end），并通过 references/rtl-engineering.md 隔离中性字符（2 GB / 10 GB）。
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 六种复数类别（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 排版、连接词与双向文本

• 连接词 Waw（و）：与后接词直接连接，不留空格（الملفات والمجلدات）。
• 标点符号：使用阿拉伯逗号 ،（U+060C）、分号 ؛（U+061B）和问号 ؟（U+061F）。前面不得留空格。
• 引号：在散文和文章中引用内容时，使用阿拉伯书名号 « »。
• 中性字符双向文本隔离：RTL 文本中的数字之间的中性字符（/、-、:）会导致顺序颠倒（2 GB / 10 GB 会变成 10 GB / 2 GB）。使用 <bdi> 或 <span dir="ltr"> 包裹表达式。

---

3. 操作验证清单与反「العرنجية」关卡

每条阿拉伯语 UI 字符串、译文或长篇内容都必须通过以下可验证的完成关卡：

3.1 适用于所有阿拉伯语文本（界面和文章）

• 过去时被动动作：使用自然的内部被动语态（حُذف الملف、أُطلق التحديث、أُرسل الرابط），完全不使用辅助动词（تم + مصدر 或 تمت عملية）。
• 所属关系：使用附着式人称后缀（حسابك、ملفك、فكرتك），完全不使用迂回形容词（الخاص بك / الخاصة بـ）。
• 副词和状态：使用直接宾格副词或动名词（تلقائيًا、فوريًا、باستمرار），完全不使用仿译介词结构（بشكل تلقائي、بصورة مستمرة）。
• 时长和时间：时间副词前不加多余介词（صالح 3 أيام、في 5 دقائق），绝不使用（لمدة 3 أيام、خلال 5 دقائق）。
• 工具关系的准确表达：使用工具格介词 بـ 或直接表达语境（بالضغط هنا、في الإعدادات），避免仿译的媒介表达（من خلال、عبر）。
• 直接使用最高级：使用自然的 أَفْعَل 形式（الأسرع、الأكفأ、الأضمن），绝不使用迂回仿译形式（الأكثر سرعة、الأكثر كفاءة）。
• 最高级的一致关系和属格结构：绝对最高级优先采用属格结构（أطول الليالي、أجمل الفتيات）；若作形容词，则严格遵守语法一致关系（الدولتان العُظمَيان），绝不使用僵化的阳性单数形式（الدولتان الأعظم）。
• 因果形容词（النعت السببي）：使用灵活的因果形容词（مشاريع باهظة تكاليفها、القرية الظالم أهلها），避免笨重的关系从句（المشاريع التي تكاليفها مرتفعة）。
• 不定性和部分关系：不定名词和不可数名词直接使用双元音符号（استغرق وقتاً、أعجب ناسٌ），避免仿译的媒介表达（بعض الوقت、بعض الناس、أحد المطورين、أي مشكلة）。
• 并列属格结构：第一个名词与属格词构成属格结构，第二个名词添加人称后缀（عرض البيانات وتعديلها），绝不使用双重结构（عرض وتعديل البيانات）。
• 否定并列：用 ولا 连接否定分句（لا تعديل ولا حذف、لن نترك رجلاً ولا طفلاً），绝不使用仿译的 أو。
• 相互关系动词：使用不带冗余成分的相互关系动词形式（如 تحالفوا、تعاونوا），严格避免添加多余的小品词（مع بعضهم البعض）。
• 禁止与可选表达：警告和限制绝不使用 لا يجب（该表达表示可选）；应使用直接的虚拟式否定祈使句（لا تُغلق الصفحة、يحظر الحذف）。
• 存在状态：描述状态和事件时省略伪存在词 هناك（حدث خطأ、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）