Bu repo, Apple'ın resmi [The Swift Programming Language][orijinal-repo] kitabının Türkçe'ye çevrilmesi amacıyla oluşturulmuş bir projedir. Amacımız, Swift'in resmi dokümantasyonunu Türk diline kazandırarak Türkiye'deki Swift topluluğu için güncel ve erişilebilir bir kaynak sunmaktır.
Kitabın orijinal ve güncel İngilizce versiyonu her zaman [docs.swift.org][orijinal-site] adresinde yayınlanmaktadır ve [Swift-DocC][swift-docc] kullanılarak derlenmektedir.
Bu proje aktif olarak çevrilmektedir ve henüz tamamlanmamıştır.
Çeviri sürecinde hatalar, eksiklikler veya tutarsızlıklar bulunabilir. Çevirinin kalitesini artırmak için topluluğun geri bildirimleri ve katkıları bizim için çok değerlidir. Nihai hedef, çevirinin tamamlanıp docs.swift.org.tr (veya benzeri bir adreste) yayınlanmasıdır.
Bu projeye katkıda bulunmak isterseniz çok seviniriz! Yazım hatalarını düzeltmek, çeviri önermek veya yeni bölümleri çevirmek için bir "Pull Request" açabilirsiniz.
Katkıda bulunma süreciyle ilgili daha detaylı bir rehber hazırlanmaktadır. Şimdilik, orijinal projenin Swift Davranış Kuralları belgesine uymanız beklenmektedir.
Çevirinin web sitesi olarak nasıl göründüğünü test etmek için projeyi kendi bilgisayarınızda derleyebilirsiniz. Bu reponun kök dizininde aşağıdaki komutu çalıştırın:
docc preview TSPL.doccDocC'yi çalıştırdıktan sonra, tarayıcınızda yerel bir önizleme görüntülemek için docc'nin terminalde verdiği linki açın.
Not:
Eğer DocC'yi Swift.org'dan bir toolchain indirerek kurduysanız,
docckomutu toolchain kurulum yoluna göreusr/bin/içinde yer alır. Kullandığınız Shell'inPATHortam değişkeninin bu dizini içerdiğinden emin olun.Eğer DocC'yi Xcode indirerek kurduysanız, bunun yerine
xcrun docc preview TSPL.docckomutunu çalıştırın.