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

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

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

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

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

Это перевод Ruby on Rails Guides для версии Rails 6.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 для получения электронной почты.
Обзор Action Text: Это руководство описывает, как использовать Action Text для обработки содержимого обогащенного текста.
Основы 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

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