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

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

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

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

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

• Rails 5.2
• Rails 5.1
• Rails 5.0
• Rails 4.2
• Rails 4.1
• Rails 4.0
• Rails 3.2
• Rails 3.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 Model.

3 . Вьюхи

Обзор Action View

Это руководство представляет введение в Action View.

Макеты и рендеринг в Rails

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

Хелперы Action View

Это руководство знакомит с некоторыми из многих хелперов вьюх.

Хелперы форм в Action View

Руководство по использованию встроенных хелперов форм.

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

Обзор Action Controller

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

Роутинг в Rails

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

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

Расширения ядра Active Support

Это руководство документирует расширения ядра Ruby, определенные в Active Support.

Основы Action Mailer

Это руководство описывает, как использовать Action Mailer для отправки электронной почты.

Основы Action Mailbox

Это руководство описывает, как использовать Action Mailbox для получения электронной почты.

Основы Active Job

Это руководство даст вам все, что нужно, чтобы начать создавать, ставить в очередь и запускать фоновые задания.

Обзор Active Storage

В этом руководстве описывается, как прикреплять файлы к моделям Active Record.

Обзор Action Cable

Это руководство документирует, как работает Action Cable, и как использовать WebSockets.

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

API интернационализации Rails (I18n)

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

Тестирование приложений на Rails

Это достаточно полное руководство по осуществлению юнит- и функциональных тестов в Rails. Оно раскрывает все от “Что такое тест?” до тестирования API. Наслаждайтесь.

Безопасность приложений на Rails

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

Отладка приложений на Rails

Это руководство описывает, как отлаживать приложения на Rails. Оно раскрывает различные способы достижения этого, и как понять что произошло "за кулисами" вашего кода.

Конфигурирование приложений на Rails

Это руководство раскрывает основные конфигурационные настройки для приложения на Rails.

Командная строка Rails

Это руководство раскроет инструменты командной строки, предоставленные Rails.

Asset Pipeline

Это руководство документирует файлопровод (asset pipeline)

Работа с JavaScript в Rails

Это руководство раскрывает встроенную в Rails функциональность Ajax/JavaScript.

Процесс инициализации в Rails

Это руководство объясняет внутренние процессы инициализации в Rails, начиная с Rails 4.

Автозагрузка и перезагрузка констант (режим Zeitwerk)

Это руководство документирует, как работает автозагрузка и перезагрузка констант (режим Zeitwerk).

Автозагрузка и перезагрузка констант (режим Classic)

Это руководство документирует, как работает автозагрузка и перезагрузка констант (режим Classic).

Кэширование с Rails: Обзор

Различные техники кэширования, предоставленные Rails.

Инструментарий Active Support

В этом руководстве, вы научитесь использовать инструменты Active Support API для отслеживания событий внутри Rails или другого кода на Ruby.

Использование Rails для API-приложений

Это руководство раскрывает создание приложения Rails, отдающего ресурсы JSON клиентам API или клиентскому фреймворку.

Active Record для PostgreSQL

Это руководство рассказывает о специфике использования PostgreSQL с 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.

Заметки о релизе Ruby on Rails 6.1

Заметки о релизе Rails 6.1

Заметки о релизе Ruby on Rails 6.0

Заметки о релизе Rails 6.0

Заметки о релизе Ruby on Rails 5.2

Заметки о релизе Rails 5.2

Заметки о релизе Ruby on Rails 5.1

Заметки о релизе Rails 5.1

Заметки о релизе Ruby on Rails 5.0

Заметки о релизе Rails 5.0

Заметки о релизе 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