Guías de Ruby on Rails

Comience aquí

Empezando con Rails: Todo lo que necesitas saber para instalar Rails y crear tu primera aplicación.

Modelos

Conceptos básicos de Active Record: Active Record permite que tus modelos interactúen con la base de datos de la aplicación. Esta guía te ayudará a comenzar con los modelos de Active Record y la persistencia en la base de datos.
Migraciones de Active Record: Las migraciones son una característica de Active Record que te permite evolucionar el esquema de tu base de datos con el tiempo. En lugar de escribir modificaciones de esquema en SQL puro, las migraciones te permiten usar un DSL de Ruby para describir los cambios en tus tablas.
Validaciones de Active Record: Las validaciones se utilizan para asegurar que solo se guarde en la base de datos datos válidos. Esta guía te enseña cómo validar el estado de los objetos antes de que se guarden en la base de datos, utilizando la función de validaciones de Active Record.
Callbacks de Active Record: Los callbacks hacen posible escribir código que se ejecutará cada vez que se crea, actualiza, destruye, etc. un objeto. Esta guía te enseña cómo conectarte a este ciclo de vida de objetos de Active Record.
Asociaciones de Active Record: En Active Record, una asociación es una conexión entre dos modelos de Active Record. Esta guía cubre todas las asociaciones proporcionadas por Active Record.
Interfaz de consulta de Active Record: En lugar de utilizar SQL sin procesar para encontrar registros de la base de datos, Active Record proporciona mejores formas de llevar a cabo las mismas operaciones. Esta guía cubre diferentes formas de recuperar datos de la base de datos utilizando Active Record.
Fundamentos de Active Model: Active Model te permite crear objetos Ruby simples que se integran con Action Pack, pero no necesitan Active Record para la persistencia en la base de datos. Active Model también ayuda a construir ORMs personalizados para su uso fuera del marco de Rails. Esta guía te proporciona todo lo que necesitas para comenzar a usar clases de Active Model.

Vistas

Resumen de Action View: Action View es responsable de generar el HTML para las respuestas web. Esta guía proporciona una introducción a Action View.
Diseños y Renderizado en Rails: Esta guía cubre las características básicas de diseño de Action Controller y Action View, incluyendo la renderización y redirección, el uso de bloques content_for y el trabajo con parciales.
Ayudantes de Action View: Action View tiene helpers para manejar todo, desde formatear fechas y enlazar imágenes, hasta sanitizar y localizar contenido. Esta guía presenta algunos de los helpers de Action View más comunes.
Ayudantes de Formularios de Action View: Los formularios HTML pueden volverse rápidamente tediosos de escribir y mantener debido a la necesidad de manejar el nombre de los controles del formulario y sus numerosos atributos. Rails elimina esta complejidad al proporcionar ayudantes de vista para generar el marcado del formulario.

Controladores

Resumen de Action Controller: Los controladores de acción son el núcleo de una solicitud web en Rails. Esta guía cubre cómo funcionan los controladores y cómo se integran en el ciclo de solicitud de tu aplicación. Incluye sesiones, filtros, cookies, transmisión de datos y manejo de excepciones generadas por una solicitud, entre otros temas.
Enrutamiento de Rails de afuera hacia adentro: El enrutador de Rails reconoce las URL y las envía a la acción de un controlador. Esta guía cubre las características orientadas al usuario del enrutamiento de Rails. Si quieres entender cómo usar el enrutamiento en tus propias aplicaciones de Rails, comienza aquí.

Otros componentes

Extensiones principales de Active Support: Active Support proporciona extensiones y utilidades para el lenguaje Ruby. Enriquece el lenguaje Ruby para el desarrollo de aplicaciones Rails y para el desarrollo de Ruby on Rails en sí mismo.
Fundamentos de Action Mailer: Esta guía te proporciona todo lo que necesitas para comenzar a enviar correos electrónicos desde tu aplicación, y muchos detalles internos de Action Mailer.
Conceptos básicos de Action Mailbox: Esta guía describe cómo usar Action Mailbox para recibir correos electrónicos.
Resumen de Action Text: Esta guía describe cómo usar Action Text para manejar contenido de texto enriquecido.
Conceptos básicos de Active Job: Active Job es un marco para declarar trabajos en segundo plano y hacer que se ejecuten en una variedad de backend de encolamiento. Esta guía te proporciona todo lo que necesitas para comenzar a crear, encolar y ejecutar trabajos en segundo plano.
Resumen de Active Storage: Active Storage facilita la carga de archivos a un servicio de almacenamiento en la nube, transformando las cargas y extrayendo metadatos. Esta guía cubre cómo adjuntar archivos a tus modelos de Active Record.
Resumen de Action Cable: Action Cable integra WebSockets con el resto de tu aplicación Rails. Permite escribir características en tiempo real en Ruby, en el mismo estilo y forma que el resto de tu aplicación Rails. Esta guía explica cómo funciona Action Cable y cómo usar WebSockets para crear características en tiempo real.
Webpacker: Esta guía te mostrará cómo instalar y usar Webpacker para empaquetar JavaScript, CSS y otros activos para el lado del cliente de tu aplicación Rails.

Profundizando más

API de Internacionalización (I18n) de Rails: Esta guía cubre cómo agregar internacionalización a tus aplicaciones. Tu aplicación podrá traducir contenido a diferentes idiomas, cambiar reglas de pluralización, utilizar formatos de fecha correctos para cada país, y más.
Pruebas de aplicaciones Rails: Esta es una guía bastante completa sobre las diferentes instalaciones de pruebas en Rails. Cubre todo, desde '¿Qué es una prueba?' hasta las pruebas de integración. Disfruta.
Asegurando Aplicaciones Rails: Esta guía describe problemas de seguridad comunes en aplicaciones web y cómo evitarlos con Rails.
Informes de errores en aplicaciones Rails: Esta guía presenta formas de manejar excepciones que ocurren en aplicaciones de Ruby on Rails.
Depuración de aplicaciones Rails: Esta guía describe cómo depurar aplicaciones de Rails. Cubre las diferentes formas de lograr esto y cómo entender lo que está sucediendo "detrás de escena" de tu código.
Configuración de aplicaciones Rails: Esta guía cubre la configuración básica para una aplicación de Rails.
La línea de comandos de Rails: Hay algunos comandos que son absolutamente críticos para tu uso diario de Rails. Esta guía cubre las herramientas de línea de comandos proporcionadas por Rails.
El Pipeline de Activos: El pipeline de activos proporciona un marco para concatenar y minimizar o comprimir activos de JavaScript, CSS e imágenes. También agrega la capacidad de escribir estos activos en otros lenguajes y preprocesadores como CoffeeScript, Sass y ERB.
Trabajando con JavaScript en Rails: Esta guía explica cómo usar import maps o jsbundling-rails para incluir JavaScript en aplicaciones de Rails, y cubre los conceptos básicos de trabajar con Turbo en Rails.
El Proceso de Inicialización de Rails: Esta guía explica los detalles internos del proceso de inicialización en Rails. Es una guía extremadamente detallada y recomendada para desarrolladores avanzados de Rails.
Autocarga y recarga de constantes: Esta guía documenta cómo funciona la carga automática y la recarga de constantes (modo Zeitwerk).
Clásico a Zeitwerk HOWTO: Esta guía documenta cómo migrar aplicaciones Rails de `classic` a `zeitwerk` mode.
Caché con Rails: Una Visión General: Esta guía es una introducción para acelerar tu aplicación de Rails con el uso de caché.
Instrumentación de Active Support: Esta guía explica cómo utilizar la API de instrumentación dentro de Active Support para medir eventos dentro de Rails y otros códigos de Ruby.
Usando Rails para aplicaciones solo de API: Esta guía explica cómo utilizar de manera efectiva Rails para desarrollar una aplicación de API JSON.
Active Record y PostgreSQL: Esta guía cubre el uso específico de PostgreSQL en Active Record.
Múltiples bases de datos con Active Record: Esta guía cubre el uso de múltiples bases de datos en tu aplicación.
Encriptación de Active Record: Esta guía cubre cómo encriptar la información de tu base de datos utilizando Active Record.

Ampliando Rails

Los fundamentos de la creación de plugins en Rails: Esta guía cubre cómo construir un complemento para ampliar la funcionalidad de Rails.
Rails en Rack: Esta guía cubre la integración de Rails con Rack y la interfaz con otros componentes de Rack.
Creando y personalizando generadores y plantillas de Rails: Esta guía cubre el proceso de agregar un generador completamente nuevo a tu extensión o proporcionar una alternativa a un elemento de un generador incorporado en Rails (como proporcionar stubs de prueba alternativos para el generador de andamios).
Introducción a los motores: Los motores pueden considerarse aplicaciones en miniatura que proporcionan funcionalidad adicional a sus aplicaciones anfitrionas. En esta guía aprenderás cómo crear tu propio motor e integrarlo con una aplicación anfitriona.
Plantillas de Aplicación en Rails: Las plantillas de aplicación son archivos Ruby simples que contienen DSL para agregar gemas, inicializadores, etc. a tu proyecto Rails recién creado o a un proyecto Rails existente.
Hilos y ejecución de código en Rails: Esta guía describe las consideraciones necesarias y las herramientas disponibles al trabajar directamente con la concurrencia en una aplicación Rails.

Contribuyendo

Contribuir a Ruby on Rails: Rails no es "el marco de trabajo de otra persona". Esta guía cubre una variedad de formas en las que puedes involucrarte en el desarrollo continuo de Rails.
Directrices de Documentación de API: Esta guía documenta las pautas de documentación de la API de Ruby on Rails.
Guías de Ruby on Rails - Directrices: Esta guía documenta las pautas de las guías de Ruby on Rails.
Instalación de las dependencias principales de desarrollo de Rails: Esta guía cubre cómo configurar un entorno para el desarrollo central de Ruby on Rails.

Políticas

Política de Mantenimiento para Ruby on Rails: ¿Qué versiones de Ruby on Rails están actualmente soportadas y cuándo se esperan nuevas versiones?

Notas de la versión

Actualización de Ruby on Rails: Esta guía proporciona los pasos a seguir cuando actualizas tus aplicaciones a una versión más nueva de Ruby on Rails.
Notas de la versión de Ruby on Rails 7.1: Notas de lanzamiento para Rails 7.1.
Notas de lanzamiento de Ruby on Rails 7.0: Notas de lanzamiento para Rails 7.0.
Notas de lanzamiento de Ruby on Rails 6.1: Notas de lanzamiento para Rails 6.1.
Notas de lanzamiento de Ruby on Rails 6.0: Notas de lanzamiento para Rails 6.0.
Notas de lanzamiento de Ruby on Rails 5.2: Notas de lanzamiento para Rails 5.2.
Notas de lanzamiento de Ruby on Rails 5.1: Notas de lanzamiento para Rails 5.1.
Notas de lanzamiento de Ruby on Rails 5.0: Notas de lanzamiento para Rails 5.0.
Ruby on Rails 4.2 Notas de la Versión: Notas de lanzamiento para Rails 4.2.
Ruby on Rails 4.1 Notas de la versión: Notas de lanzamiento para Rails 4.1.
Notas de lanzamiento de Ruby on Rails 4.0: Notas de lanzamiento para Rails 4.0.
Notas de lanzamiento de Ruby on Rails 3.2: Notas de lanzamiento para Rails 3.2.
Notas de lanzamiento de Ruby on Rails 3.1: Notas de lanzamiento para Rails 3.1.
Notas de lanzamiento de Ruby on Rails 3.0: Notas de lanzamiento para Rails 3.0.
Notas de lanzamiento de Ruby on Rails 2.3: Notas de lanzamiento para Rails 2.3.
Notas de lanzamiento de Ruby on Rails 2.2: Notas de lanzamiento para Rails 2.2.

Comentarios

Se te anima a ayudar a mejorar la calidad de esta guía.

Por favor, contribuye si encuentras algún error tipográfico o factual. Para empezar, puedes leer nuestra contribución a la documentación sección.

También puedes encontrar contenido incompleto o desactualizado. Por favor, añade cualquier documentación faltante para main. Asegúrate de revisar Edge Guides primero para verificar si los problemas ya están resueltos o no en la rama principal. Consulta las Directrices de las Guías de Ruby on Rails para el estilo y las convenciones.

Si por alguna razón encuentras algo que corregir pero no puedes solucionarlo tú mismo, por favor abre un problema.

Y por último, cualquier tipo de discusión sobre la documentación de Ruby on Rails es muy bienvenida en el Foro oficial de Ruby on Rails.

Guías de Ruby on Rails (ae44dcb)