عند ترجمة الوثائق التقنية (Markdown)، كيف يتم التعامل مع كتل الشيفرة و Front Matter؟
“إن ترجمة كتل الشيفرة، الشيفرة المضمنة، وعناصر الإعداد الرأسية (Front Matter) في الوثائق التقنية بشكل قسري سيؤدي إلى جعل الوثيقة غير صالحة للاستخدام.”
تحليل الأسباب الجذرية
آلية “منطقة العزل” لكتل الشيفرة
يكتشف النظام تلقائيًا المحتوى المحاط بـ ``` (كتلة الشيفرة) و ` (الشيفرة المضمنة). تُصنَّف هذه المناطق كمناطق غير قابلة للترجمة، حيث يتجاوزها الذكاء الاصطناعي لضمان عدم الإضرار بمنطق شيفرات Python أو JS أو غيرها.
حماية بيانات Front Matter
بالنسبة لإعدادات YAML في رأس الصفحة الشائعة في منصات المدونات الثابتة مثل Jekyll/Hugo (مثل `date:`, `slug:`)، تتم ترجمة الحقول المحددة فقط مثل `title` و `description`، مع الحفاظ على معلمات التكوين الضرورية للبناء.
إعادة ترتيب جداول Markdown بشكل تلقائي
في كثير من الأحيان، يؤدي تغير طول الأحرف بعد الترجمة إلى اختلال محاذاة جداول Markdown. يقوم DL.Translator خلال مرحلة المعالجة اللاحقة بإعادة حساب مواضع رمز الأنبوب `|`، لإخراج كود جدول منسق وذو مظهر جميل.
ملخص الحل النهائي
مصمم خصيصًا لمجتمع المصادر المفتوحة والمطورين، لضمان الاحترافية وقابلية القراءة لملفات README.md والدروس التقنية عند التبديل بين اللغات.