Kılavuzlardaki tüm çeviriler Dilan Kaya tarafından yapılmıştır. Hata bulursanız veya katkıda bulunmak isterseniz GitHub üzerinden iletişime geçebilirsiniz.
Ruby on Rails Kılavuzları (v8.0.2)
Bunlar v8.0.2 tabanlı Rails 8.0 için yeni kılavuzlardır. Bu kılavuzlar, Ruby on Rails ile daha üretken olmanıza ve tüm parçaların nasıl bir araya geldiğini anlamanıza yardımcı olmak için tasarlanmıştır.
Buradan Başlayın
Rails ile Başlarken
Rails’i nasıl kuracağınızı ve ilk uygulamanızı nasıl oluşturacağınızı öğrenin.
Ruby on Rails İndirme Kılavuzu
Ruby programlama dilini ve Ruby on Rails’i nasıl kuracağınızı öğrenin.
Model
Active Record Temelleri
Active Record, modellerinizin uygulamanın veritabanıyla etkileşime girmesini sağlar. Bu kılavuz, Active Record modelleri ve veritabanına kalıcılık konusunda size başlangıç sağlayacaktır.
Active Record Migration
Migration’lar, veritabanı şemanızı zaman içinde geliştirmenize olanak tanıyan bir Active Record özelliğidir. Şema değişikliklerini saf SQL ile yazmak yerine, migration tablolarınızdaki değişiklikleri tanımlamak için bir Ruby DSL kullanmanıza olanak tanır.
Active Record Doğrulamaları
Doğrulamalar, veritabanınıza yalnızca geçerli verilerin kaydedilmesini sağlamak için kullanılır. Bu kılavuz, Active Record’un doğrulama özelliğini kullanarak nesnelerin veritabanına girmeden önce durumlarını nasıl doğrulayacağınızı öğretir.
Active Record Callback
Callback’ler; bir nesne oluşturulduğunda, güncellendiğinde, yok edildiğinde vb. çalışacak kod yazmayı mümkün kılar. Bu kılavuz size Active Record nesnelerinin bu nesne yaşam döngüsüne nasıl bağlanacağınızı öğretir.
Active Record İlişkileri
Active Record’da bir ilişki, iki Active Record modeli arasındaki bir bağlantıdır. Bu kılavuz, Active Record tarafından sağlanan tüm ilişkileri kapsar.
Active Record Sorgu Arayüzü
Veritabanı kayıtlarını bulmak için ham SQL kullanmak yerine, Active Record aynı işlemleri gerçekleştirmek için daha iyi yollar sağlar. Bu kılavuz, Active Record kullanarak veritabanından veri almanın farklı yollarını ele alır.
Active Model Temelleri
Active Model, Action Pack ile entegre olan, ancak veritabanı kalıcılığı için Active Record’a ihtiyaç duymayan yalın Ruby nesneleri oluşturmanıza olanak tanır. Active Model ayrıca Rails çerçevesi dışında kullanılmak üzere özel ORM’ler oluşturmaya da yardımcı olur. Bu kılavuz, Active Model sınıflarını kullanmaya başlamak için ihtiyacınız olan her şeyi sağlar.
View
Action View Overview
Action View, web yanıtları için HTML oluşturmaktan sorumludur. Bu kılavuz Action View’e giriş niteliğindedir.
Layout ve Rendering
Bu kılavuz; işleme ve yönlendirme, content_for bloklarını kullanma ve kısmi öğelerle çalışma gibi Action Controller ve Action View’in temel düzen özelliklerini kapsar.
Action View Helper
Action View; tarihleri biçimlendirmekten ve görsellere bağlantı vermekten, içeriği temizlemeye ve yerelleştirmeye kadar her şeyi halletmek için helper’lara sahiptir. Bu kılavuz, daha yaygın Action View helper’larından birkaçını tanıtmaktadır.
Action View Form Helper
HTML formlarının yazılması ve bakımı; form kontrolü adlandırma ve çok sayıda özniteliğini ele alma ihtiyacı nedeniyle hızla sıkıcı hale gelebilir. Rails, form biçimlendirmesi oluşturmak için view helper’ları sağlayarak bu karmaşıklığı ortadan kaldırır.
Controller
Action Controller
Action Controller, Rails’teki bir web isteğinin temelidir. Bu kılavuz, denetleyicilerin nasıl çalıştığını ve uygulamanızın istek döngüsüne nasıl uyduğunu ele alır. Konular arasında denetleyici eylemlerinde parametrelere erişim, oturum ve çerez kullanımı, denetleyici geri aramaları yer almaktadır.
Action Controller İleri Konular
Bu kılavuz, Rails uygulamasındaki controller’lar ile ilgili çeşitli gelişmiş konuları ele almaktadır. Bunlar arasında; siteler arası istek sahteciliğine karşı koruma, HTTP kimlik doğrulaması, veri akışı ve istisnalarla başa çıkma, log filtreleme ve daha fazlası yer almaktadır.
Dışarıdan İçeriye Routing
Rails router’ı, URL’leri tanır ve bunları bir controller’ın action’ına gönderir. Bu kılavuz, Rails routing’in kullanıcıya dönük özelliklerini ele alır. Kendi Rails uygulamalarınızda routing’i nasıl kullanacağınızı anlamak istiyorsanız, buradan başlayın.
Diğer Bileşenler
Active Support Core Uzantılar
Active Support, Ruby uzantıları ve yardımcı programları sağlar. Ruby dilini, Rails uygulamalarının geliştirilmesi ve Ruby on Rails’in kendisinin geliştirilmesi için zenginleştirir.
Action Mailer Temelleri
Bu kılavuz, uygulamanızdan e-posta göndermeye başlamak için ihtiyacınız olan her şeyi ve Action Mailer’ın birçok dahili özelliğini sağlar.
Action Mailbox Temelleri
Bu kılavuzda Action Mailbox’ın e-posta almak için nasıl kullanılacağı anlatılmaktadır.
Action Text
Bu kılavuzda, zengin metin içeriğini işlemek için Action Text’in nasıl kullanılacağı açıklanmaktadır.
Active Job Temelleri
Active Job, arka plan işlerini bildirmek ve bunları çeşitli kuyruk backend’lerinde çalıştırmak için bir framework’tür. Bu kılavuz; arka plan işlerini oluşturmaya, kuyruğa almaya ve yürütmeye başlamak için ihtiyacınız olan her şeyi sağlar.
Active Storage
Active Storage; dosyaları bir bulut depolama hizmetine yüklemeyi, yüklemeleri dönüştürmeyi ve meta verileri çıkarmayı kolaylaştırır. Bu kılavuz, dosyaların Active Record modellerinize nasıl ekleneceğini ele alır.
Action Cable
Action Cable, Rails uygulamanıza WebSocket‘i sorunsuz bir şekilde entegre eder. Performans ve ölçeklenebilirliği sağlarken aynı zamanda gerçek zamanlı özelliklerin, Rails uygulamanızın geri kalanında olduğu gibi aynı stil ve formda Ruby’de yazılmasını sağlar. Bu kılavuz, Action Cable’ın nasıl çalıştığını ve gerçek zamanlı özellikler oluşturmak için WebSocket’in nasıl kullanılacağını açıklamaktadır.
Daha Derin Konular
Rails Uluslararasılaştırma API
Bu kılavuz, uygulamalarınızı nasıl uluslararasılaştıracağınızı ele alır. Uygulamanız; içeriği farklı dillere çevirebilir, çoğullaştırma kurallarını değiştirebilir, her ülke için doğru tarih biçimlerini kullanabilir, vb.
Rails Uygulamalarını Test Etme
Bu kılavuz, Rails’te testlerin nasıl yazılacağını inceler. Ayrıca test yapılandırmasını ele alır ve bir uygulamayı test etme yaklaşımlarını karşılaştırır.
Rails Uygulamalarında Hata Ayıklama
Bu kılavuzda, Rails uygulamalarında nasıl hata ayıklanacağı anlatılmaktadır. Bunu başarmanın farklı yollarını ve kodunuzun “perde arkasında” neler olduğunu nasıl anlayacağınızı kapsar.
Rails Uygulamalarını Yapılandırma
Bu kılavuz, bir Rails uygulaması için temel yapılandırma ayarlarını kapsar.
Rails Komut Satırı
Günlük Rails kullanımınız için kesinlikle kritik olan birkaç komut vardır. Bu kılavuz Rails tarafından sağlanan komut satırı araçlarını kapsamaktadır.
Asset Pipeline
Asset pipeline kılavuzu, temel asset yönetimi görevlerini yerine getiren bir framework olan Propshaft’ın nasıl kullanılacağını açıklamaktadır.
Rails’te JavaScript ile Çalışma
Bu kılavuz, JavaScript’i Rails uygulamalarına dahil etmek için import maps veya jsbundling-rails’in nasıl kullanılacağını açıklar ve Rails’te Turbo ile çalışmanın temellerini kapsar.
Rails Başlatma Süreci
🚧 Bu kılavuz, Rails’teki başlatma sürecinin iç yapısını açıklar. Son derece derinlemesine bir kılavuzdur ve ileri düzey Rails geliştiricileri için önerilir.
Otomatik Yükleme ve Yeniden Yükleme
Bu kılavuzda otomatik yükleme ve yeniden yükleme sabitlerinin nasıl çalıştığı anlatılmaktadır.
Active Support Instrumentation
🚧 Bu kılavuz, Rails ve diğer Ruby kodları içindeki olayları ölçmek için Active Support içindeki instrumentation API’sinin nasıl kullanılacağını açıklar.
API Özel Uygulamalar için Rails Kullanımı
Bu kılavuz, JSON API uygulamasını geliştirmek için Rails’i etkili bir şekilde nasıl kullanacağınızı açıklar.
Ürün Çıkarmak
Dağıtım için Performans Ayarlama
Bu kılavuz, üretim ortamındaki Ruby on Rails uygulamanızı dağıtmak için performans ve eşzamanlılık yapılandırmasını ele almaktadır.
Rails ile Önbelleğe Alma: Genel Bakış
Bu kılavuz, Rails uygulamanızı önbelleğe alma ile hızlandırmaya yönelik bir giriş niteliğindedir.
Rails Uygulamalarının Güvenliğini Sağlama
Bu kılavuzda web uygulamalarındaki yaygın güvenlik sorunları ve Rails ile bunlardan nasıl kaçınılacağı açıklanmaktadır.
Rails Uygulamalarında Hata Bildirim
Bu kılavuz, Ruby on Rails uygulamalarında oluşan hataları yönetme yollarını tanıtmaktadır.
İleri Seviye Active Record
Active Record ve PostgreSQL
🚧 Bu kılavuz, Active Record’un PostgreSQL’e özgü kullanımını kapsamaktadır.
Çoklu Veritabanı
Bu kılavuz, uygulamanızda birden fazla veritabanının nasıl kullanılacağını ele almaktadır.
Active Record Şifreleme
🚧 Bu kılavuz, Active Record kullanarak veritabanı bilgilerinizin şifrelenmesini ele almaktadır.
Bileşik Birincil Anahtarlar
Bu kılavuz, veritabanı tabloları için bileşik birincil anahtarlara giriş niteliğindedir.
Rails Uygulamalarını Büyütelim
Rails Eklentileri Oluşturmanın Temelleri
🚧 Bu kılavuz, Rails’in işlevselliğini genişletecek bir eklentinin nasıl oluşturulacağını ele almaktadır.
Rack’te Rails
Bu kılavuz, Rails’in Rack ile entegrasyonunu ve diğer Rack bileşenleriyle arayüz oluşturmayı kapsar.
Rails Generator ve Şablonları Oluşturma ve Özelleştirme
Bu kılavuz, uzantınıza yepyeni bir generator ekleme veya yerleşik bir Rails generator’ünün bir öğesine alternatif sağlama (iskele generator için alternatif test taslakları sağlamak gibi) sürecini kapsar.
Engine ile Çalışmaya Başlarken
🚧 Engine’ler, host uygulamalarına ek işlevsellik sağlayan minyatür uygulamalar olarak düşünülebilir. Bu kılavuzda kendi engine’inizi nasıl oluşturacağınızı ve onu bir host uygulamasına nasıl entegre edeceğinizi öğreneceksiniz.
Rails Uygulama Şablonları
🚧 Uygulama şablonları, yeni oluşturduğunuz Rails projenize veya mevcut bir Rails projesine gem’ler, initializer’lar vb. eklemek için DSL içeren basit Ruby dosyalarıdır.
Rails’te İş Parçacığı Oluşturma ve Kod Yürütme
🚧 Bu kılavuz, bir Rails uygulamasında eşzamanlılıkla doğrudan çalışırken dikkat edilmesi gereken hususları ve kullanılabilecek araçları açıklamaktadır.
Katkıda Bulunun
Ruby on Rails’e Katkıda Bulunma
Rails “başka birinin framework’ü” değildir. Bu kılavuz, Rails’in devam eden gelişimine dahil olabileceğiniz çeşitli yolları kapsar.
API Dokümantasyon Yönergeleri
Bu kılavuz Ruby on Rails API dokümantasyon yönergelerini belgelemektedir.
Kılavuz Yönergeleri
Bu kılavuz Ruby on Rails kılavuzlarının yönergelerini belgelemektedir.
Rails Core Geliştirme Bağımlılıklarını Yükleme
Bu kılavuz, Ruby on Rails core geliştirme için bir ortamın nasıl kurulacağını ele almaktadır.
Politikalar
Ruby on Rails’te şu anda hangi sürümlerin desteklendiğini ve yeni sürümlerin ne zaman çıkacağını buradan takip edebilirsiniz.
Sürüm Notları
(Sürüm notlarının çevirisi yapılmayacaktır. Linkler, ilgili sürüm notlarının resmi sitesine yönlendirmektedir.)
Geri Bildirim
Bu rehberin kalitesinin iyileştirilmesine yardımcı olmanızı öneririz.
Herhangi bir yazım hatası veya olgusal hata görürseniz lütfen katkıda bulunun. Başlamak için, dokümantasyon katkıları bölümünü okuyabilirsiniz.
Ayrıca eksik veya güncel olmayan içerik de bulabilirsiniz. Lütfen main için eksik olan belgeleri ekleyin. Sorunların main dalda zaten düzeltilip düzeltilmediğini doğrulamak için önce Edge Guides'ı kontrol ettiğinizden emin olun. Stil ve kurallar için Ruby on Rails Guides Guidelines'ı kontrol edin.
Herhangi bir sebepten dolayı düzeltebileceğiniz bir şey bulursanız ancak kendiniz patch yapamıyorsanız lütfen bir issue açın.
Ve son olarak, Ruby on Rails dokümantasyonu ile ilgili her türlü tartışma resmi Ruby on Rails Forum'unda memnuniyetle karşılanacaktır.