Jak postępować z blokami kodu i Front Matter podczas tłumaczenia dokumentacji technicznej w Markdown?
“Bloki kodu, kod liniowy oraz sekcje konfiguracyjne (Front Matter) w dokumentacji technicznej, jeśli zostaną przetłumaczone, mogą spowodować, że dokument stanie się nieużyteczny.”
Analiza przyczyn podstawowych
Mechanizm „stref izolowanych” dla bloków kodu
System automatycznie rozpoznaje zawartość otoczoną przez ``` (bloki kodu) oraz ` (kod liniowy). Te obszary są oznaczane jako „strefy nietłumaczone” – AI pomija tę część treści, aby zapewnić, że logika kodu Python, JS i innych nie zostanie naruszona.
Ochrona metadanych Front Matter
Dla nagłówkowych konfiguracji YAML powszechnych w statycznych blogach takich jak Jekyll/Hugo (np. `date:`, `slug:`), tłumaczymy wyłącznie wybrane pola, takie jak `title` i `description`, pozostawiając nietknięte ustawienia wymagane do poprawnej budowy serwisu.
Automatyczne dostosowanie układu tabel Markdown
Tabele Markdown po tłumaczeniu często ulegają rozregulowaniu z powodu zmiany długości znaków. DL.Translator na etapie postprocessingu ponownie wylicza pozycje separatorów `|`, aby uzyskać estetyczny i czytelny kod źródłowy tabeli.
Podsumowanie rozwiązania końcowego
Stworzony specjalnie dla społeczności open source i deweloperów, zapewnia zachowanie profesjonalizmu oraz czytelności plików README.md i instrukcji technicznych podczas zmiany wersji językowej.