Komentáře a dokumentační řetězce (Docstrings) v kódu: Jak překládat pouze komentáře bez zásahu do samotného kódu?
Diagnostika aktuálního stavu
“Při vložení zdrojového souboru do překladače bývají často přeložena i jména proměnných a klíčová slova (if/for), což vede k nefunkčnosti kódu.”
Analýza hlavní příčiny
1
Rozpoznání na úrovni AST (abstraktní syntaktický strom)
Shangyi AI není pouze založena na regulárních výrazech, ale umožňuje i lehkou syntaktickou analýzu. U Pythonu dokáže přesně rozpoznat Docstrings uzavřené v `'''...'''`; Pro Java/JS rozpozná bloky `/**...*/`.
2
Zachování instrukcí
Uvnitř komentářových bloků systém zachovává hlavičky specifických instrukcí, jako jsou `@param`, `@return`, `@autor`, a překládá pouze popisný text za nimi, aby byla při generování API dokumentace (např. Javadoc, Sphinx) zajištěna správná struktura.
Shrnutí konečného řešení
Pomáhá open-source projektům rychle generovat vícejazyčnou dokumentaci a snižovat bariéry pro přispívání vývojářů z celého světa.