Jak při překladu technické dokumentace (Markdown) správně zacházet s kódovými bloky a Front Matter?
“Pokud jsou v technické dokumentaci kódové bloky, řádkový kód a hlavičkové konfigurační položky (Front Matter) přeloženy násilně, může to vést k nefunkčnosti dokumentu.”
Analýza hlavní příčiny
Mechanismus „izolované oblasti“ pro kódové bloky
Systém automaticky rozpoznává obsah uzavřený v ``` (kódovém bloku) a ` (řádkovém kódu). Tyto oblasti jsou označeny jako „nepřekládané“; AI tuto část vynechává a zajišťuje, že logika kódu v Pythonu, JS apod. nebude narušena.
Ochrana metadat Front Matter
U běžných YAML konfigurací v záhlaví statických blogů (například Jekyll/Hugo, jako jsou `date:`, `slug:`) překládáme pouze vybraná pole, například `title` a `description`, zatímco konfigurační parametry potřebné pro sestavení ponecháváme v původním znění.
Automatické přeformátování Markdown tabulek
Markdown tabulky po překladu často ztrácejí zarovnání v důsledku změny délky znaků. DL.Translator při následném zpracování znovu vypočítává pozici svislých čar `|` a generuje zdrojový kód tabulky s přesným a estetickým zarovnáním.
Shrnutí konečného řešení
Speciálně navrženo pro open source komunitu a vývojáře, aby byla zachována profesionalita a čitelnost dokumentů README.md a technických tutoriálů při přepínání jazyků.