Добро пожаловать!

Ruby on Rails — это веб-фреймворк с открытым кодом, от которого программисты становятся счастливыми, код — красивым, а разработка — устойчивой и быстрой.

На этом сайте выложены переводы официального руководства по Rails. Надеемся, эти руководства позволят вам немедленно приступить к использованию Rails и помогут разобраться, что и как в нем работает.

Переводы постоянно актуализируются и добавляются. Код проекта и тексты переводов открыты и размещены на Гитхабе. Желающим помочь всегда рады! Форкайте, предлагайте изменения, вносите их, отправляйте пул-реквесты!

Это перевод Ruby on Rails Guides для версии Rails 4.1. Переводы для ранних версий доступны в архиве или на гитхабе:

Приступим!

1. С чего начать?

Rails для начинающих
Все, что вы должны знать, чтобы установить Rails и создать свое первое приложение.

2. Модели

Основы Active Record
Это руководство поможет начать работать с моделями, сохранять в базу данных и расскажет о паттернах и библиотеке Active Record.
Миграции базы данных Rails
Это руководство раскрывает, как вы должны использовать миграции Active Record, чтобы привести свою базу данных к структурированной и организованной форме.
Валидации Active Record
Это руководство раскрывает, как вы можете применять валидации Active Record.
Колбэки Active Record
Это руководство раскрывает, как вы можете применять колбэки (методы обратного вызова) Active Record.
Связи (ассоциации) Active Record
Это руководство раскрывает все связи, предоставленные Active Record.
Интерфейс запросов Active Record
Это руководство раскрывает интерфейс запросов к базе данных, предоставленный Active Record.
Основы Active Model
Это руководство познакомит вас со всем, что вам надо для начала использования моделей классов Active Model.

3. Вьюхи

Макеты и рендеринг в Rails
Это руководство раскрывает основы возможностей макетов Action Controller и Action View, включая рендеринг и перенаправление, использование содержимого для блоков и работу с частичными шаблонами.
Хелперы форм Action View
Руководство по использованию встроенных хелперов форм.

4. Контроллеры

Обзор Action Controller
Это руководство раскрывает, как работают контроллеры, и как они вписываются в цикл запроса к вашему приложению. Оно включает сессии, фильтры, куки, потоковые данные, работу с исключениями, вызванными запросами, и другие статьи.
Роутинг Rails
Это руководство раскрывает открытые для пользователя функции роутинга. Если хотите понять, как использовать роутинг в вашем приложении на Rails, начните отсюда.

5. Копаем глубже

Расширения ядра Active Support
Это руководство документирует расширения ядра Ruby, определенные в Active Support.
Инструментарий Active Support
В этом руководстве, вы научитесь использовать инструменты Active Support API для отслеживания событий внутри Rails или другого Ruby кода.
Rails Internationalization API
Это руководство раскрывает, как добавить интернационализацию в ваше приложение. Ваше приложение будет способно переводить содержимое на разные языки, изменять правила образования множественного числа, использовать правильные форматы дат для каждой страны и так далее.
Основы Action Mailer
Это руководство описывает, как использовать Action Mailer для отправки и получения электронной почты.
Тестирование приложений на Rails
Это достаточно полное руководство по осуществлению юнит- и функциональных тестов в Rails. Оно раскрывает все от “Что такое тест?” до тестирования API. Наслаждайтесь.
Безопасность приложений на Rails
Это руководство опиcывает общие проблемы безопасности в приложениях веб, и как избежать их в Rails.
Отладка приложений на Rails
Это руководство описывает, как отлаживать приложения на Rails. Оно раскрывает различные способы достижения этого, и как понять что произошло "за кулисами" вашего кода.
Конфигурирование приложений на Rails
Это руководство раскрывает основные конфигурационые настройки для приложения на Rails.
Руководство по командной строке Rails и задачам Rake
Это руководство раскроет инструменты командной строки и задачи rake, предоставленные Rails.
Кэширование с Rails
Различные техники кэширования, предоставленные Rails.
Asset Pipeline
Это руководство документирует файлопровод (asset pipeline)
Работа с JavaScript в Rails
Это руководство раскрывает встроенный в Rails функционал Ajax/JavaScript.
Engine для начинающих
Это руководство объясняет, как написать монтируемый engine
Процесс инициализации в Rails
Это руководство объясняет внутренние процессы инициализации в Rails, начиная с Rails 4.

6. Расширяем Rails

Основы создания плагинов Rails
Это руководство раскрывает, как создать плагин, расширяющий функционал Rails.
Rails on Rack
Это руководство раскрывает интеграцию Rails и Rack, и взаимодействие с другими компонентами Rack
Создание и настройка генераторов Rails
Это руководство раскрывает процесс добавления совершенно нового генератора для вашего расширения или представления альтернативного элемента для встроенного в Rails генератора (такого как представление альтернативных тестовых заглушек для генератора скаффолда).

7. Заметки о релизах

Руководство по обновлению Ruby on Rails
Это руководство поможет обновить приложения на последние версии Ruby on Rails.
Заметки о релизе Ruby on Rails 4.2
Заметки о релизе Rails 4.2
Заметки о релизе Ruby on Rails 4.1
Заметки о релизе Rails 4.1
Заметки о релизе Ruby on Rails 4.0
Заметки о релизе Rails 4.0
Заметки о релизе Ruby on Rails 3.2
Заметки о релизе Rails 3.2
Заметки о релизе Ruby on Rails 3.1
Заметки о релизе Rails 3.1
Заметки о релизе Ruby on Rails 3.0
Заметки о релизе Rails 3.0