Коментарі до коду та docstring-коментарі: як перекладати лише коментарі, не змінюючи код?
“При прямому завантаженні вихідних кодових файлів у перекладач часто перекладаються навіть назви змінних та логічні ключові слова (if/for), що призводить до некоректної роботи коду.”
Аналіз основних причин
Розпізнавання на рівні AST (абстрактного синтаксичного дерева)
商译 AI не обмежується регулярними виразами, а також здійснює легкий синтаксичний аналіз. Для Python інструмент точно розпізнає docstrings, обгорнуті в `'''...'''`; Для Java/JS система розпізнає блоки `/**...*/`.
Зберігання інструкції
Усередині блоку коментаря для таких спеціальних інструкцій, як `@param`, `@return`, `@author` тощо, система зберігає заголовок інструкції, перекладаючи лише подальший описовий текст, щоб під час генерації API-документації (наприклад, Javadoc, Sphinx) формат залишався коректним.
Підсумок остаточного рішення
Сприяє швидкому створенню багатомовної документації для open-source проєктів, знижуючи поріг входу для розробників усього світу.