Komentarze i docstringi w kodzie: jak tłumaczyć tylko komentarze, nie zmieniając kodu?
“Przy bezpośrednim wczytywaniu plików źródłowych do tłumacza często tłumaczone są nawet nazwy zmiennych i słowa kluczowe (if/for), co powoduje, że kod przestaje działać.”
Analiza przyczyn podstawowych
Rozpoznawanie na poziomie AST (abstrakcyjne drzewo składniowe)
商译 AI to nie tylko dopasowywanie przez wyrażenia regularne – umożliwia także lekką analizę składniową. W przypadku Pythona precyzyjnie rozpoznaje docstringi otoczone przez `'''...'''`. W przypadku Java/JS narzędzie rozpoznaje bloki `/**...*/`.
Zachowanie dyrektyw
Wewnątrz bloków komentarzy, w przypadku takich dyrektyw jak `@param`, `@return`, `@author` itp., system zachowuje nagłówek dyrektywy, tłumacząc jedynie opis znajdujący się po nim, aby zapewnić prawidłowy format dokumentacji API (np. Javadoc, Sphinx).
Podsumowanie rozwiązania końcowego
Pomaga projektom open source szybko generować dokumentację wielojęzyczną, obniżając próg wejścia dla programistów z całego świata.