從這裡開始
- Rails 入門指南
-
安裝Rails和創建第一個應用程式所需的所有資訊。
模型
- Active Record 基礎
-
Active Record 允許您的模型與應用程式的資料庫互動。本指南將引導您開始使用 Active Record 模型並將資料持久化到資料庫中。
- Active Record Migrations
-
遷移是Active Record的一個功能，它允許您隨著時間的推移演進您的資料庫架構。與純SQL編寫架構修改不同，遷移允許您使用Ruby DSL來描述對表格的更改。
- Active Record 驗證
-
驗證用於確保只有有效的資料被儲存到資料庫中。本指南將教你如何使用Active Record的驗證功能，在資料進入資料庫之前驗證物件的狀態。
- Active Record 回呼函式
-
回呼函式使得我們能夠撰寫程式碼，當物件被建立、更新、刪除等等時，能夠執行特定的程式碼。本指南將教你如何連結到Active Record物件的生命週期。
- Active Record關聯
-
在Active Record中，關聯是兩個Active Record模型之間的連接。本指南涵蓋了Active Record提供的所有關聯。
- Active Record 查詢介面
-
與使用原始的SQL查找數據庫記錄不同，Active Record提供了更好的方法來執行相同的操作。本指南介紹了使用Active Record從數據庫檢索數據的不同方法。
- Active Model 基礎
-
Active Model 允許您創建純粹的 Ruby 物件，與 Action Pack 整合，但不需要 Active Record 進行資料庫持久化。Active Model 也有助於建立用於 Rails 框架之外的自訂 ORM。本指南提供您所需的一切，以開始使用 Active Model 類別。
觀點
- Action View 概述
-
Action View 負責生成網頁回應的 HTML。本指南提供了對 Action View 的介紹。
- Rails中的佈局和渲染
-
這個指南涵蓋了Action Controller和Action View的基本佈局功能，包括渲染和重定向、使用content_for區塊以及處理局部視圖。
- 動作視圖輔助程式
-
Action View 提供了各種輔助方法，用於處理日期格式化、圖片連結、內容清理和本地化等功能。本指南介紹了一些常用的 Action View 輔助方法。
- Action View 表單輔助程式
-
HTML表單的撰寫和維護往往讓人感到繁瑣，因為需要處理表單控制元件的命名和眾多屬性。Rails通過提供視圖助手來生成表單標記，從而消除了這種複雜性。
控制器
- Action Controller 概述
-
Action Controllers 是 Rails 中網路請求的核心。本指南涵蓋了控制器的工作原理以及它們如何融入應用程式的請求週期。其中包括會話、過濾器、Cookie、資料串流以及處理請求中引發的異常等主題。
- 從外部開始的Rails路由
-
Rails 路由器能夠識別 URL 並將其分派給控制器的動作。本指南涵蓋了 Rails 路由的用戶界面功能。如果您想了解如何在自己的 Rails 應用程序中使用路由，請從這裡開始。
其他組件
- Active Support 核心擴展
-
Active Support 提供了 Ruby 語言的擴展和工具。它豐富了 Ruby 語言在開發 Rails 應用程序以及開發 Ruby on Rails 本身方面的功能。
- Action Mailer 基礎知識
-
這個指南提供了您在應用程式中開始發送電子郵件所需的一切，以及 Action Mailer 的許多內部細節。
- Action Mailbox基礎知識
-
這個指南描述了如何使用 Action Mailbox 來接收郵件。
- Action Text 概述
-
這個指南描述了如何使用 Action Text 處理豐富文本內容。
- Active Job 基礎
-
Active Job 是一個用於聲明背景工作並在各種佇列後端上運行的框架。本指南提供了您開始創建、入隊和執行背景工作所需的所有資訊。
- Active Storage 概述
-
Active Storage 有助於將文件上傳到雲端儲存服務，轉換上傳並提取元數據。本指南介紹了如何將文件附加到您的 Active Record 模型。
- Action Cable 概述
-
Action Cable整合了WebSockets與Rails應用程式的其他部分。它允許使用Ruby以與Rails應用程式的其他部分相同的風格和形式來撰寫即時功能。本指南將解釋Action Cable的運作方式，以及如何使用WebSockets來創建即時功能。
- Webpacker
-
這個指南將向您展示如何安裝和使用Webpacker來打包JavaScript、CSS和其他用於Rails應用程式客戶端的資源。
深入挖掘
- Rails國際化（I18n）API
-
這個指南涵蓋了如何為您的應用程式新增國際化功能。您的應用程式將能夠將內容翻譯成不同的語言，更改複數規則，使用每個國家的正確日期格式等等。
- 測試 Rails 應用程式
-
這是一份相當全面的指南，介紹了Rails中各種測試設施。從「什麼是測試？」到整合測試，涵蓋了所有內容。請享用。
- 保護Rails應用程式
-
這個指南描述了網絡應用程序中常見的安全問題，以及如何在Rails中避免它們。
- Rails應用程式中的錯誤報告
-
這個指南介紹了在Ruby on Rails應用程式中處理例外的方法。
- 除錯 Rails 應用程式
-
這個指南描述了如何除錯Rails應用程式。它涵蓋了不同的方法以及如何理解您的程式碼「幕後」發生的事情。
- 配置Rails應用程序
-
這份指南涵蓋了Rails應用程式的基本配置設定。
- Rails命令行
-
有幾個命令對於你日常使用 Rails 是絕對關鍵的。本指南涵蓋了 Rails 提供的命令行工具。
- 資產管道
-
資產管道提供了一個框架，用於串聯和壓縮JavaScript、CSS和圖像資產。它還增加了在其他語言和預處理器（如CoffeeScript、Sass和ERB）中編寫這些資產的能力。
- 在Rails中使用JavaScript
-
這個指南解釋了如何在Rails應用程式中使用import maps或jsbundling-rails來包含JavaScript，並介紹了在Rails中使用Turbo的基本知識。
- Rails 初始化過程
-
這個指南解釋了Rails中初始化過程的內部細節。這是一個非常深入的指南，建議給有經驗的Rails開發者閱讀。
- 自動加載和重新加載常量
-
這個指南文件記錄了自動加載和重新加載常數的運作方式（Zeitwerk模式）。
- Classic to Zeitwerk HOWTO
-
這份指南記錄了如何將Rails應用程式從`classic`模式遷移到`zeitwerk`模式。
- Rails中的緩存：概述
-
這個指南是介紹如何使用快取來加速你的Rails應用程式。
- 主動支援儀器
-
這個指南解釋了如何在Rails和其他Ruby代碼中使用Active Support內的儀器API來測量事件。
- 使用Rails開發API應用程式
-
這個指南解釋了如何有效地使用Rails來開發JSON API應用程式。
- Active Record 和 PostgreSQL
-
這個指南涵蓋了 PostgreSQL 在 Active Record 中的特定用法。
- 使用Active Record與多個資料庫
-
這個指南涵蓋了在你的應用程式中使用多個資料庫的方法。
- Active Record 加密
-
這個指南涵蓋了使用Active Record加密您的資料庫資訊。
擴展Rails
- 創建Rails插件的基礎知識
-
這個指南涵蓋了如何建立一個插件來擴展Rails的功能。
- Rails on Rack
-
這個指南涵蓋了Rails與Rack的整合，以及與其他Rack組件的接口。
- 建立和自訂 Rails 產生器和模板
-
本指南涵蓋了將全新的發電機添加到您的擴展或為內建的Rails發電機提供替代方案的過程（例如為脚手架發電機提供替代的測試存根）。
- 使用引擎入門
-
引擎可以被視為為其主應用程式提供額外功能的小型應用程式。在本指南中，您將學習如何創建自己的引擎並將其與主應用程式整合。
- Rails應用程式模板
-
應用程式模板是簡單的 Ruby 檔案，其中包含用於在新建的 Rails 專案或現有的 Rails 專案中添加 gem、初始化程式等的 DSL。
- 在Rails中的線程和代碼執行
-
這個指南描述了在Rails應用程式中直接處理並發時所需考慮的事項和可用的工具。
貢獻
- 貢獻於Ruby on Rails
-
Rails不是「別人的框架」。本指南涵蓋了多種方式，讓您可以參與Rails的持續開發。
- API 文件撰寫指南
-
這份指南記錄了Ruby on Rails API文件撰寫的準則。
- Ruby on Rails指南指南
-
這個指南記錄了Ruby on Rails指南的準則。
- 安裝Rails核心開發相依套件
-
這個指南涵蓋了如何建立一個適合 Ruby on Rails 核心開發的環境。
政策
- Ruby on Rails 維護政策
-
目前支援的Ruby on Rails版本有哪些，以及預計何時推出新版本。
發行說明
- 升級Ruby on Rails
-
這個指南提供了在升級你的應用程式到較新版本的Ruby on Rails時應該遵循的步驟。
- Ruby on Rails 7.1 發行說明
-
Rails 7.1 發行說明
- Ruby on Rails 7.0 發行說明
-
Rails 7.0 發行說明
- 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 發行說明
- Ruby on Rails 2.3 發行說明
-
Rails 2.3 發行說明
- Ruby on Rails 2.2 發行說明
-
Rails 2.2 釋出說明
回饋
歡迎協助提升本指南的品質。
如果您發現任何錯別字或事實錯誤，請貢獻您的力量。 開始之前，您可以閱讀我們的 文件貢獻 部分。
您也可能會發現不完整的內容或過時的資訊。 請為主要的文件補充任何遺漏的內容。請先檢查 Edge 指南，以確認問題是否已經修復或尚未在主分支上修復。 請參考 Ruby on Rails 指南指引 以了解風格和慣例。
如果您發現需要修復但無法自行修補的問題，請 開啟一個問題。
最後但同樣重要的是，關於 Ruby on Rails 文件的任何討論都非常歡迎在 官方 Ruby on Rails 論壇 上進行。