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

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

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

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

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

Приступим!

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

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

2. Модели

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

3. Вью

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

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

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

5. Другие компоненты

Расширения ядра Active Support
Это руководство документирует расширения ядра Ruby, определенные в Active Support.
Основы Action Mailer
Это руководство описывает, как использовать Action Mailer для отправки электронной почты.
Основы Action Mailbox
Это руководство описывает, как использовать Action Mailbox для получения электронной почты.
Обзор Action Text
Это руководство описывает, как использовать Action Text для обработки содержимого обогащенного текста.
Основы Active Job
Это руководство даст вам все, что нужно, чтобы начать создавать, ставить в очередь и запускать фоновые задания.
Обзор Active Storage
В этом руководстве описывается, как прикреплять файлы к моделям Active Record.
Обзор Action Cable
Это руководство документирует, как работает Action Cable, и как использовать WebSockets для создания функционала в реальном времени.

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

API интернационализации Rails (I18n)
Это руководство раскрывает, как добавить интернационализацию в ваше приложение. Ваше приложение будет способно переводить содержимое на разные языки, изменять правила образования множественного числа, использовать правильные форматы дат для каждой страны и так далее.
Тестирование приложений на Rails
Это достаточно полное руководство по осуществлению различных возможностей тестирования в Rails. Оно раскрывает все от “Что такое тест?” до интеграционного тестирования. Наслаждайтесь.
Безопасность приложений на Rails
Это руководство описывает общие проблемы безопасности в приложениях веб, и как избежать их в Rails.
Отчет об ошибках в приложениях Rails
Это руководство представляет способы управления исключениями, которые случаются в приложениях Ruby on Rails.
Отладка приложений на Rails
Это руководство описывает, как отлаживать приложения на Rails. Оно раскрывает различные способы достижения этого, и как понять что произошло "за кулисами" вашего кода.
Конфигурирование приложений на Rails
Это руководство раскрывает основные конфигурационные настройки для приложения на Rails.
Командная строка Rails
Это руководство раскроет инструменты командной строки, предоставленные Rails.
Asset Pipeline
Это руководство документирует файлопровод (asset pipeline)
Работа с JavaScript в Rails
Это руководство раскрывает встроенную в Rails функциональность Ajax/JavaScript.
Процесс инициализации в Rails
Это руководство объясняет внутренние процессы инициализации в Rails.
Автозагрузка и перезагрузка констант
Это руководство документирует, как работает автозагрузка и перезагрузка констант (режим Zeitwerk).
Как перейти с Classic на Zeitwerk
Это руководство документирует, как мигрировать приложение Rails с режима classic на zeitwerk.
Кэширование с Rails: Обзор
Это руководство является введением в ускорение вашего приложения на Rails с помощью кэширования.
Инструментарий Active Support
В этом руководстве, вы научитесь использовать инструменты Active Support API для отслеживания событий внутри Rails или другого кода на Ruby.
Использование Rails для API-приложений
Это руководство раскрывает, как эффективно использовать Rails для разработки приложения JSON API.
Active Record для PostgreSQL
Это руководство рассказывает о специфике использования PostgreSQL с Active Record.
Несколько баз данных с Active Record
Это руководство раскрывает использование нескольких баз данных в вашем приложении.
Шифрование Active Record
Это руководство раскрывает шифрование информации в базе данных с использованием Active Record.

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

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

8. Вносим вклад в Ruby on Rails

Вносим вклад в Ruby on Rails
Rails — это не 'чей-то там фреймворк'. Это руководство раскрывает многообразие способов, которыми вы можете быть вовлечены в продолжающуюся разработку Rails.
Рекомендации по документированию API
Это руководство документирует рекомендации для документации Ruby on Rails.
Рекомендации для руководств по Ruby on Rails
Это руководство документирует рекомендации для руководств по Ruby on Rails.
Установка зависимостей для разработки
Это руководство раскрывает, как настроить среду для разработки ядра Ruby on Rails.
Политика поддержки (версий)
Какие версии Ruby on Rails поддерживаются в настоящее время и когда ожидать новые версии.

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

Апгрейд Ruby on Rails
Это руководство поможет произвести апгрейд приложения до последних версий Ruby on Rails.
Версия 7.1 - Октябрь 2023
Заметки о релизе Rails 7.1
Версия 7.0 - Декабрь 2021
Заметки о релизе Rails 7.0
Версия 6.1 - Декабрь 2020
Заметки о релизе Rails 6.1
Версия 6.0 - Август 2019
Заметки о релизе Rails 6.0
Версия 5.2 - Апрель 2018
Заметки о релизе Rails 5.2
Версия 5.1 - Апрель 2017
Заметки о релизе Rails 5.1
Версия 5.0 - Июнь 2016
Заметки о релизе Rails 5.0
Версия 4.2 - Декабрь 2014
Заметки о релизе Rails 4.2
Версия 4.1 - Апрель 2014
Заметки о релизе Rails 4.1
Версия 4.0 - Июнь 2013
Заметки о релизе Rails 4.0
Версия 3.2 - Январь 2012
Заметки о релизе Rails 3.2
Версия 3.1 - Август 2011
Заметки о релизе Rails 3.1
Версия 3.0 - Август 2010
Заметки о релизе Rails 3.0