Как да се обработват кодовите блокове и Front Matter при превод на техническа документация (Markdown)?
“Ако кодовите блокове, вграденият код и конфигурационните елементи в началото (Front Matter) в техническата документация бъдат преведени, това ще направи документа неизползваем.”
Анализ на основната причина
Механизъм за „изолирана зона“ на кодовите блокове
Системата автоматично разпознава съдържанието, заградено с ``` (кодови блокове) и ` (вграден код). Тези зони са отбелязани като „забранени за превод“, като AI пропуска това съдържание, за да гарантира, че логиката на кода на Python, JS и други езици не се нарушава.
Защита на Front Matter метаданни
При YAML конфигурация в началото на файла, често срещана при статични блогове като Jekyll/Hugo (например `date:`, `slug:`), превеждаме само определени полета като `title` и `description`, като запазваме конфигурационните параметри, необходими за изграждане.
Автоматично пренареждане на Markdown таблици
Markdown таблиците често се изместват след превод поради промяна в дължината на символите. DL.Translator преизчислява позициите на разделителя `|` на етап постобработка и изкарва подравнен изходен код на таблицата.
Обобщение на крайното решение
Създаден специално за отворената общност и разработчиците, като гарантира професионализъм и четимост на README.md и техническите ръководства при превключване между езици.