المواصفات المترجمة

لم يُطلق بعد

تُشحن المواصفات المترجمة في إصدار بعد API-dex 3.1.0 وليس في المنتج الحالي. يدرجه سجلّ التغييرات تحت Unreleased.

المواصفة التي يحمّلها المنتِج هي مستند OpenAPI الأصلي. والترجمة هي طبقة لغة: مستند منفصل، واحد لكل لغة، يسمّي مواضع في المواصفة ويوفّر لها العناوين والملخصات والأوصاف المترجمة. تطبّق API-dex الطبقة حين يقرأ أحدهم المواصفة، باللغة التي اختارها في البوابة.

• حيث لا توجد طبقة للغة المحددة، تقدّم API-dex المواصفة الأصلية.
• حيث توجد طبقة لكن لا يمكن تطبيقها، تقدّم API-dex المواصفة الأصلية أيضًا. لا تعيق مشكلة ترجمة القارئ أبدًا.
• الطبقة ليست نسخة ثانية من المواصفة. تغيّر المواضع التي تسمّيها فقط؛ ويبقى كل ما عداها كما حُمِّل تمامًا.
• تتبع التنزيلات اللغة المعروضة على الشاشة، فالتنزيل المترجم مستند OpenAPI صالح يصف الواجهة نفسها.

تنتمي الطبقات إلى إصدار المواصفة. يبدأ الإصدار الجديد بلا ترجمات، وترفض API-dex تحميلًا يُسقط بصمت لغة منشورة أصلًا.

يختار المسؤولون اللغات التي تقدّمها البوابة في Settings. ينبغي أن تطابق تلك اللغات اللغات التي ينشر المنتِجون طبقات لها، حتى لا يختار القارئ لغة لا ترجمة لها.

مواضيع ذات صلة

• ترجمة مواصفة، خطوات النشر
• استهلاك واجهة برمجة تطبيقات، قراءة مواصفة بلغتك
• المرجع: طبقات اللغة، شكل المستند واللغات وسلوك واجهة المنصّة
• المرجع: الإعدادات، اللغات التي تقدّمها البوابة