Laravel Türkiye Discord Kanalı Forumda kod paylaşılırken dikkat edilmesi gerekenler!Birlikte proje geliştirmek ister misiniz?

Laravel 4 Dokümantasyon Yerelleştirme Çalışmaları

sineld · 2013-05-30T16:34:39+00:00

Merhaba arkadaşlar, Nihayet hepimizin sabırsızlıkla beklediği Laravel 4 resmi olarak sevgili Taylor'ın doğum günü olan 28 Mayıs'ta yayınlandı. Birçok kişin...

burak166

Merhaba,
Biraz hort olacak ama orjinal dökümana eklenen fakat Türkçe dokümanda bulunmayan ve çevrilmeyen bir kaç yer mevcut.
Örneğin orjinal döküman eloquent sayfasında

$model = User::findOrFail(1);

örneğinin hemen altına

$model = User::where('votes', '>', 100)->firstOrFail();

eklenmiş bulunmakta.

Arda

Rota kelimesinin öyle kalmasından yanayım ben de, sonuçta kullanıdığımız metodların adları İngilizce, PHP'deki temel fonksiyonlar da İngilizce, Türkçe ve ne kadar orijinal isme yakın olursa o kadar kolay olur hatırlaması.

Misal, çalıştığım iş yerinde grafiker arkadaşlarda lisanslı Adobe Photoshop var, Türkçe'sine baksanız acı çekersiniz

Umarım anlatabilmişimdir,

sineld

burak166 yazdıMerhaba,
Biraz hort olacak ama orjinal dökümana eklenen fakat Türkçe dokümanda bulunmayan ve çevrilmeyen bir kaç yer mevcut.
Örneğin orjinal döküman eloquent sayfasında

$model = User::findOrFail(1);

örneğinin hemen altına

$model = User::where('votes', '>', 100)->firstOrFail();

eklenmiş bulunmakta.

Eksikleri ilave etmeye çalışıyorum, birkaç güne kadar tamamı güncellenecek.

cangelis

Herkese merhaba,

Türkçe çeviriler ile ilgili 1-2 önerim olacaktı. Öncelikle türkçe çevirilerin bulunduğu GitHub reposu bir fork olduğu için Issue yaratmak mümkün değil. Bu yüzden bence bu repo kullanılarak yeni bir repo oluşturulmalı. Bu şekilde türkçe çeviriler hakkında issue yaratabilir orada oylama yapabiliriz.

Diğeri ise şu anda kullanılan Dayle tarafından geliştirilen docs-reader anladığım kadarı ile artık geliştirilmiyor. Ancak reader da zaman zaman hata çıkabilir -nitekim şu anda var-. Bu yüzden bu repoyu clonelayıp kendi docs-reader'ımızın bulunduğu bir repo yaratabiliriz.

Hata ise: http://laravel.gen.tr/docs/schema adresindeki tabloların (html table) markdownlarının çalışmaması. Zaman zaman laravel.com çöktüğü için bende kendim documentation'ı clone edip kendi vpsime atmıştım oradada bu hatayı düzeltmiştim. Şuradan çalışır haline bakabilirsiniz: http://docs.cangelis.com/docs/schema
Aslında çözümü çok basit ama bu işi bir topluluk olarak yapıyorsak, readerı da belki zaman zaman topluluk olarak geliştirip yeni şeyler ekleyebiliriz veya değiştirebiliriz.

Bunun için Dayle'nin reposuna pr yaratacaktım ancak gördüğüm kadarı ile 7 aydır bekleyen pr bile cevap bulmamış bu yüzden bende göndermedim.

Belki de GitHub üzerinde laravel türkiye isminde bir organisation bile kurulabilir. (edit: bu zaten varmış

)

sineld

Sevgili @cangelis önerilerin için teşekkürler.

Söz ettiklerini en kısa zamanda tamamlayacağım.

Aaron

Elimden geldiği kadar dokümantasyondaki yazım hatalarını düzeltmeye çalıştım. Dokümanı baştan sona bir kere okudum ve ilk gözüme çarpan onlar olmuştu. Eğer boş vaktim olursa dokümanı tekrardan okuyacağım. Git üzerinden düzeltmelere devam edebilirim.

cangelis

Tekrar merhaba,

Laravel'in yeni dökümantasyonu gibi sürümlere göre bir docs reader yapma planı var mı? Eğerki yoksa böyle bir plan yapalım mı ?

sineld

Arkadaşlar Twitter'dan duyurduğum gibi çevirinin 4.0'dan 4.1'e yükseltilmesi için gerekli ilaveleri yaptım.

Eksik bölümleri dosyaları açtığınız zaman Türkçe metinler içindeki İngilizce alanlardan görüp bunları çevirebilirsiniz.

Sevgili @cangelis, önerin nedir reader ile ilgili, bir çalışma yapar mısın?

Katkılarınızı bekliyorum.

hkan

Bugün dökümantasyonun küçük bir kısmını Türkçeye çevirdim. Genel olarak çevirilerdeki en büyük problem kelimelerin tutarlılığı olur. Birden fazla kişi katkıda bulunduğunda, kişiler eşanlamlı kelimeler kullanabilir, doğaldır. Yapılması gerekense belli başlı kelimelerin karşılıklarını bir yerde toplayıp işi kişilerin tercihine bırakmamak olur.

Örneğin bugün çeviriye başlarken Sinan Eldem'e Twitter'dan service provider kelime grubunu nasıl çevirebileceğimi danıştım. Bu şekilde belirli kelimelere bir standart belirlenip Github'daki reponun readme.md dosyasına eklenmesini öneriyorum.

sineld

Sevgili Hakan, aslında bu yönde bir wiki çalışması olsa çok daha iyi olur.

Çevirideki tutarlılığı sağlamak için tüm bölümlerin çevirisi tamamlandıktan sonra @sergin ve ben bu dosyaların tamamını inceleyip son düzeltmeleri yapıyoruz.

cangelis

IRC üzerinden şu anki docs reader'ı open source olarak yayınlayacaklar mı diye bir soruyorum. Eğerki imkanınız olabilirse siz de sorabilirsiniz. Eğerki olumsuz bir cevap gelirse şu anki docs reader üzerinde geliştirme yapabiliriz.

sineld

Sevgili @cangelis , github üzerinde laravel.com sitesi kodları paylaşılmış durumda: https://github.com/laravel/website bu sitenin tamamını ve doc-reader'ı da içeriyor.

Bunu laravel.gen.tr için düzenleyebilecek kimse var mı?

hkan

@sineld routes.php'yi ve viewları inceledim. sitede çevirilmesi gereken birkaç text var sadece. dökümantasyon sayfalarını laravel-tr/docs reposunda çevirdiğimiz markdown dosyalarından anlık olarak oluşturuyor sistem. bu gece kendim bir repo oluşturup düzenlemeleri yapıp burada linkini yayınlarım.

hkan

Merhabalar. Sitenin çevirilerini tamamlayıp bir repoya yükledim. Dökümantasyon için yapılması gereken şey, laravel-tr/docs reposundaki markdown dosyalarını sitenin root dizinine yerleştirmek.

https://github.com/hkan/laravel-website

Bir de Taylor repoya Sami diye bir kütüphaneyi eklemiş ama herhangi bir yerde kullanıldığına denk gelmedim kodların içinde. Muhtemelen bir şeyler denedikten sonra tekrar kullanmadı ve kaldırmayı unuttu.

cangelis

@sineld görmemişim o zaman süper.
@hkan repodaki kodları alıp yeni bir repo oluşturmaktansa var olan reponun clonenu üzerinden geliştirme yapılması, önceki commit historynin kaybedilmemesi açısından daha doğru olduğunu düşünüyorum. Mesela şu anda senin neleri değiştirdiğini, neler kattığını anlayamıyoruz. Ayrıca sami api doc oluşturmaya yarıyor. http://laravel.com/api/ bizim pek işimize yaramaz muhtemelen.

sineld

Sevgili @hkan ve @cangelis; Hakan'ın yaptığı haliyle çalışmayı tamamlayıp hem siteye hem de laravel-tr github ambarına yükleyeceğim, sonra gerekirse, düzeltmeleri oradan da paylaşabilirsiniz.

hkan

@cangelis repoyu söylediğin şekilde tekrar oluşturdum.

https://github.com/hkan/laravel-website

sineld

Arkadaşlar repoyu oluşturdum, lütfen çalışmalara buradan devam edelim: https://github.com/laravel-tr/laraveltr-website

cangelis

Teşekkürler @hkan ama @sineld pek sallamadı sanırım :))

sineld

Sevgili can, senin belirttiğini görünceye kadar yapmıştım zaten, üstünde de birçok değişiklik yaptım, sallamamak ne demek

Yayında, hayırlı olsun.

« Önceki Sayfa Sonraki Sayfa »