تعليقات الكود وشرائح التوثيق (Docstrings): كيف نترجم الشروحات دون تعديل الشيفرة نفسها؟
تشخيص الوضع الحالي الأساسي
“عند وضع ملف الشيفرة المصدرية مباشرة في المترجم، غالباً ما تُترجم أيضاً أسماء المتغيرات والكلمات المفتاحية المنطقية (if/for)، مما يسبب تلف الشيفرة.”
تحليل الأسباب الجذرية
1
التعرّف على مستوى AST (شجرة البنية المجردة)
ذكاء 商译 AI يتجاوز مطابقة القوالب عبر regex، إذ يمكنه إجراء تحليل نحوي خفيف الوزن. بالنسبة لـ Python، يمكنه التعرف بدقة على شرائح التوثيق (Docstrings) المحاطة بـ `'''...'''`; بالنسبة لـ Java/JS، يستطيع النظام التعرف على كتل `/**...*/`.
2
الاحتفاظ بالتوجيه
داخل كتلة التعليقات، بالنسبة لتوجيهات مثل `@param` و `@return` و `@author`، سيحتفظ النظام برأس التوجيه ويترجم فقط النص الوصفي الذي يليها، وذلك لضمان صحة تنسيقات وثائق الـ API (مثل Javadoc وSphinx).
ملخص الحل النهائي
يساعد هذا الحل المشاريع مفتوحة المصدر على توليد وثائق متعددة اللغات بسرعة، مما يقلل من حاجز مساهمة المطورين حول العالم.