Markdown tabanlı teknik dokümanları çevirirken, kod blokları ve Front Matter nasıl işlenmelidir?
“Teknik dokümanlardaki kod blokları, satır içi kodlar ve baştaki yapılandırma bölümü (Front Matter) zorla çevrildiğinde, dokümanın kullanılamaz hale gelmesine yol açar.”
Kök Neden Analizi
Kod bloklarının 'izolasyon bölgesi' mekanizması
Sistem, ``` (kod bloğu) ve ` (satır içi kod) ile çevrili içerikleri otomatik olarak algılar. Bu alanlar 'çevrilemez bölge' olarak işaretlenir, yapay zeka bu kısımları atlar ve Python, JS gibi kod mantığı korunur.
Front Matter meta verisinin korunması
Jekyll/Hugo gibi statik bloglarda yaygın olarak kullanılan baştaki YAML yapılandırmasında (örneğin, `date:`, `slug:` gibi), yalnızca `title` ve `description` gibi belirli alanlar çevrilir, derleme için gerekli olan yapılandırma parametreleri ise korunur.
Markdown tablolarının otomatik yeniden biçimlendirilmesi
Markdown tabloları çeviri sonrasında karakter uzunluğundaki değişiklikler nedeniyle sıklıkla hizalama sorunları yaşar. DL.Translator, son işlem aşamasında boru karakteri `|` konumlarını yeniden hesaplayarak, hizalı ve estetik görünümlü tablo kaynak kodu oluşturur.
Nihai Çözüm Özeti
Açık kaynak topluluğu ve geliştiriciler için özel olarak tasarlanmış olup, README.md ve teknik eğitimlerin çok dilli geçişlerde profesyonellik ve okunabilirliğini korur.