Ako postupovať pri preklade technickej dokumentácie (Markdown) z hľadiska kódových blokov a Front Matter?
“Ak sa kódové bloky, vnútrokódové úseky a hlavičkové konfiguračné položky (Front Matter) v technickej dokumentácii preložia násilne, môže to viesť k jej nefunkčnosti.”
Analýza základných príčin
Mechanizmus „izolovanej zóny“ pre kódové bloky
Systém automaticky rozpozná obsah ohraničený ``` (kódový blok) a ` (vnútrokódový úsek). Tieto oblasti sú označené ako „zóny bez prekladu“ a AI ich preskakuje, aby bola zabezpečená neporušenosť logiky kódu v jazykoch ako Python, JS a pod.
Ochrana metadát Front Matter
Pre YAML konfiguráciu v hlavičke (napr. `date:`, `slug:`), ktorá je bežná v statických blogoch, ako sú Jekyll alebo Hugo, prekladáme iba vybrané polia, ako napríklad `title` a `description`, a konfiguračné parametre potrebné na zostavenie ponechávame bezo zmeny.
Adaptívne preusporiadanie Markdown tabuliek
Markdown tabuľky po preklade často kvôli zmene dĺžky znakov spôsobujú posunutie. DL.Translator v rámci postprocesingu nanovo vypočíta pozíciu znakov `|` a zabezpečí, aby bol zdrojový kód tabuľky zarovnaný a prehľadný.
Zhrnutie konečného riešenia
Navrhnuté špeciálne pre open-source komunitu a vývojárov s cieľom zabezpečiť, aby si README.md a technické návody zachovali profesionalitu a čitateľnosť pri prepínaní viacerých jazykov.