Yapay zekayla çevrilen resmi Angular dokümantasyonu
(angular-kr-docs.web.app)Merhaba! Kısa süre önce Angular projesine katılırken Türkçe kaynak eksikliği nedeniyle zorlandım.
Bu yüzden açık kaynaklı bir yapay zeka çeviri projesinden yararlanarak Angular'ın resmi dokümantasyonunu yalnızca 5 saat içinde Türkçeye çevirip yayımlamayı denedim.
Şu anda çevirilerin büyük kısmı hâlâ yapay zekayla hazırlanmış ilk taslak düzeyinde.
Çeviri ilerleme durumu
- Yaklaşık 300 adet
.mddosyasının çevirisi tamamlandı - HTML dosyaları gibi otomatik çevrilmeyen dosyalar ayrıca çevriliyor
- Kod örnekleriyle birlikte temel kavramlar Türkçe olarak anlaşılabiliyor
- İngilizce orijinal metinle aynı yapıda olduğu için ihtiyaç duyulan içerik kolayca bulunabiliyor
Aslında çevirdiğim Angular dokümanlarını tanıtmak için Show GN kategorisini mi kullanayım, yoksa çeviri aracını tanıtmak için News kategorisini mi kullanayım diye düşündüm.
Angular kullanan kişi sayısı çok fazla olmayabilir ama belki Türkçe kaynak arayanlara yardımcı olur diye Show GN'yi seçtim!
Kullanılan araç
"ai-markdown-translator" adlı küçük bir projeyi keşfettim ve beklediğimden daha iyi sonuçlar verdi.
Oldukça beğendiğim için projeye katkıda bulunmak amacıyla depoyu fork edip kod üzerinde değişiklikler yapmayı deniyorum.
Avantajlar
- Markdown belgelerinin çevirisine odaklanan açık kaynaklı bir proje
- Bir klasör içindeki belirli uzantıya sahip dosyaları özyinelemeli olarak çevirebiliyor
npx ai-markdown-translator -i . -e md -l "Korean" --logkomutuyla tek seferde çeviri yapılabiliyor- Sözdizimi yapısını ve Markdown formatını büyük ölçüde koruyarak çeviri yapıyor
- MD içeriğinden sayfa üreten teknik dokümantasyonlar için uygun bir araç
Sınırlamalar
Signalterimini "sinyal" diye çevirmesi gibi, bazı teknik terimlerde kelimesi kelimesine çeviri zayıf kalabiliyor- Bazı dosya referans yollarının hatalı değiştirildiği bir sorun tespit edildi
- İlk taslak düzeyinde olduğu için iyileştirilmesi gereken yerler var
Çeviri ve dağıtım süreci
- Angular resmi dokümantasyon deposunu klonladım
- Komutu çalıştırdıktan 2 saat sonra yaklaşık 300 dosyanın çevirisi tamamlandı
- Hatalı dosya referans yolları düzeltildi
- Mevcut Angular projesinin Firebase ayarları referans alınarak dağıtım yapıldı
Hâlâ düzeltilmesi gereken çok yer var; zamanla gözden geçirip düzenlemem gerekecek, ama harcadığım zamana kıyasla ortaya çıkan sonuç bence oldukça iyiydi.
Markdown formatında yazılmış teknik dokümanları çevirmek isteyenlere denemelerini tavsiye ederim!!
Uzun yazıyı okuduğunuz için teşekkürler! İyi günler!! ❤️🔥
4 yorum
Vay! Angular!
...! Angular kullanıyor musunuz?
Bu aralar Koreli kullanıcının neredeyse hiç kalmadığını sanıyordum; yorum bırakmanıza çok sevindim! haha
React bilmiyorum ve yalnızca biraz Angular biliyorum ama Kore topluluğunda Angular hakkında bir yazı görmek sevindirici.
Ben sadece React kullanırken Angular'a geçtim, ama burada tam tersi olmuş lol
Bir gün fırsat olursa yine Angular hakkında bir yazı yazarım,,, hehe