Rusrails: Ruby on Rails по-русски

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

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

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

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

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

Приступим!

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).
Кэширование с 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.2 - ?: Заметки о релизе Rails 7.2
Версия 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

Принимаем пожелания и пул-реквесты!