Komentáre v kóde a dokumentačné reťazce (docstrings): Ako preložiť len komentáre bez zásahu do kódu?
Diagnostika aktuálneho stavu
“Pri priamom vložení zdrojového súboru do prekladača sa často preložia aj názvy premenných a logické kľúčové slová (if/for), čo vedie k nefunkčnosti kódu.”
Analýza základných príčin
1
Identifikácia na úrovni AST (abstraktného syntaktického stromu)
Shangyi AI nepoužíva iba regulárne výrazy, ale umožňuje aj ľahkú syntaktickú analýzu. Pre Python dokáže presne identifikovať docstrings uzavreté v `'''...'''`; Pre Java/JS dokáže rozpoznať bloky `/**...*/`.
2
Zachovanie inštrukcie
V rámci komentárových blokov systém pri špecifických inštrukciách, ako sú `@param`, `@return`, `@author`, zachová hlavičku príkazu a preloží len následný opisný text, čím zabezpečí správny formát pri generovaní API dokumentácie (napríklad Javadoc, Sphinx).
Zhrnutie konečného riešenia
Pomáha open-source projektom rýchlo generovať viacjazyčnú dokumentáciu a znižuje bariéry pre prispievanie globálnych vývojárov.