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 içeriğini ve işaretleri kontrol etme
Mevcut işlem, çeviri içeriğini Markdown yapısına göre çıkarır. Satır içi kod, çevresindeki metinle birlikte çıkarılabilir ve kod bloklarındaki yorumlar da çeviriye dahil olabilir. Çeviriden sonra ``` ve ` gibi işaretleri ve Python ile JS örneklerinin söz dizimini ve mantığını kontrol edin. Tüm kod alanlarının atlanacağını varsaymayın.
Front Matter meta verisinin korunması
Jekyll/Hugo gibi statik bloglarda yaygın olan belgenin başındaki YAML yapılandırmasında (Front Matter), mevcut çıkarma işlemi `title` ve `description` gibi alan değerlerini ayrı çeviri metinleri olarak işlemez. Çeviri sonrasında meta verileri elle kontrol edin ve `date:` ile `slug:` gibi derleme parametrelerini koruyun.
Markdown tablolarının kaynak metnini kontrol etme
Markdown tabloları çevrildikten sonra metin uzunluğundaki değişiklikler kaynak metindeki sütun hizalamasında farklılıklara yol açabilir. `|` karakterini, ayırıcı satırı ve hücre içeriklerini kontrol edin ve gerektiğinde tablonun kaynak metnini elle düzenleyin.
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.