عند ترجمة الوثائق التقنية (Markdown)، كيف يتم التعامل مع كتل الشيفرة و Front Matter؟

تستخرج العملية الحالية محتوى الترجمة وفق بنية Markdown. قد تُستخرج الشيفرة المضمنة مع النص المحيط بها، وقد تدخل تعليقات كتل الشيفرة أيضاً ضمن الترجمة. بعد الترجمة، تحقق من علامات مثل ``` و` ومن الصياغة والمنطق في أمثلة Python وJS، ولا تفترض أن جميع مناطق الشيفرة ستُتجاوز.

بالنسبة إلى إعدادات YAML في بداية المستند (Front Matter)، الشائعة في المدونات الثابتة مثل Jekyll/Hugo، لا تتعامل عملية الاستخراج الحالية مع قيم حقول مثل `title` و`description` كنصوص مستقلة للترجمة. راجع البيانات الوصفية يدوياً بعد الترجمة، واحتفظ بمعلمات البناء مثل `date:` و`slug:`.

قد تظهر اختلافات في محاذاة أعمدة الشيفرة المصدرية لجداول Markdown بعد الترجمة بسبب تغير طول النص. تحقق من علامة الأنبوب `|` وصف الفواصل ومحتويات الخلايا، ورتب الشيفرة المصدرية للجدول يدوياً عند الحاجة.