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.