padrino-framework - 基于Sinatra的全功能Ruby Web开发框架

= Padrino

Padrino 是 Sinatra 的教父。在 {www.padrinorb.com}[http://padrinorb.com] 和 Twitter {@padrinorb}[http://twitter.com/padrinorb] 上关注我们。加入我们的 {gitter}[https://gitter.im/padrino/padrino-framework] 频道。

{rdoc-image:https://github.com/padrino/padrino-framework/actions/workflows/ci.yml/badge.svg?branch=master}[https://github.com/padrino/padrino-framework/actions/workflows/ci.yml] {rdoc-image:https://api.codeclimate.com/v1/badges/900d6e424498f0e2b7ff/maintainability}[https://codeclimate.com/github/padrino/padrino-framework/maintainability] {rdoc-image:https://badges.gitter.im/Join Chat.svg}[https://gitter.im/padrino/padrino-framework] {rdoc-image:https://www.codetriage.com/padrino/padrino-framework/badges/users.svg}[https://www.codetriage.com/padrino/padrino-framework]

== 前言

Padrino 是一个基于优秀的 {Sinatra Web 库}[http://www.sinatrarb.com] 构建的 Ruby 框架。Sinatra 是一个用于快速创建简单 Ruby Web 应用程序的 DSL，只需最少的努力。这个框架试图通过建立在 Sinatra 的理念和基础之上，使编写更高级的 Web 应用程序变得尽可能有趣和容易。

== 简介

许多人喜欢 Sinatra 的简单和轻量，但在构建非平凡的应用程序时，很快就会开始怀念其他 Web 框架（如 Django 或 Rails）提供的大量功能。

我们开发这个框架的目标是坚持 Sinatra 的本质，同时创建一个标准工具库、辅助函数和组件，使 Sinatra 适用于日益复杂的应用程序。

以下是 Padrino 框架提供的功能概述：

灵活性:: 全面支持多种流行的测试、模板、模拟和数据存储选择。生成器:: 创建 Padrino 应用程序、模型、控制器，例如：padrino-gen project。可挂载:: 与其他 Ruby 框架不同，主要设计用于挂载多个应用程序。路由:: 完整的 URL 命名路由、命名参数、前置/后置过滤器支持。标签辅助:: 视图辅助函数，如：tag、content_tag、input_tag。资源辅助:: 视图辅助函数，如：link_to、image_tag、javascript_include_tag。表单辅助:: 构建器支持，如：form_tag、form_for、field_set_tag、text_field。文本辅助:: 有用的格式化，如：time_ago_in_words、js_escape_html、sanitize_html。邮件发送:: 快速简单的邮件发送支持（类似于 ActionMailer）。缓存:: 简单的路由和片段缓存，轻松加速 Web 请求。管理界面:: 内置管理界面（类似 Django）。日志:: 提供可与 ORM 或任何库交互的统一日志记录器。重新加载:: 在开发过程中自动重新加载服务器代码。本地化:: 全面支持 I18n 语言本地化，可自动设置用户的语言环境。

请记住，开发人员可以将这些模块化组件单独引入{现有的 Sinatra 应用程序中}[http://padrinorb.com/guides/advanced-usage/standalone-usage-in-sinatra/]，或者将它们全部用于构建完整的 Padrino 应用程序。

== 安装

要安装 Padrino 框架，只需从 {RubyGems}[https://rubygems.org] 获取最新版本：

$ gem install padrino

这将安装必要的 Padrino gem 以帮助你开始。现在你可以使用这个 gem 来增强你的 Sinatra 项目或创建新的 Padrino 应用程序。

要更详细地了解如何安装 Padrino，请查看{安装指南}[http://padrinorb.com/guides/getting-started/installation/]。

== 使用

Padrino 是一个在 Sinatra 现有功能基础上构建的框架，提供了各种额外的工具和辅助函数来扩展其基础。本 README 和 Padrino 文档主要关注对 Sinatra 核心功能的增强。要使用 Padrino，应该熟悉 Sinatra 本身的基本用法。

你还可以查看{为什么要学习 Padrino？}[http://padrinorb.com/guides/introduction/why-learn-padrino/]介绍，了解更多关于 Sinatra 和 Padrino 如何协同工作的信息。

有关如何在现有 Sinatra 项目中单独使用特定 gem 的信息，请查看{在 Sinatra 中使用 Padrino}[http://padrinorb.com/guides/advanced-usage/standalone-usage-in-sinatra/]指南。

== 入门

一旦开发人员了解了 Sinatra，Padrino 就很容易上手，因为 Padrino 只是现有 Sinatra 功能的超集！

首先，请务必阅读{入门}[http://padrinorb.com/guides/getting-started/overview/]指南，了解更多关于 Sinatra 和 Padrino 如何协同工作的信息。

学习构建 Padrino 应用程序的最佳方式是阅读以下资源：

{Padrino 指南}[http://padrinorb.com/guides] - 概述 Padrino 中的主要功能的指南。
{博客教程}[http://padrinorb.com/guides/getting-started/blog-tutorial/] - 使用 Padrino 构建博客应用程序的分步指南。
{Padrino API}[http://www.rubydoc.info/github/padrino/padrino-framework] - Padrino 框架的 YARD 文档。
{快速概览}[http://padrinorb.com/guides/getting-started/basic-projects/] - 概述基本的生成命令。

各个 Padrino 子 gem 也包含 README，概述了它们的功能。

== 更多问题

在上述资源中找不到答案？

在 {gitter 频道}[https://gitter.im/padrino/padrino-framework] 上提出任何问题。

== 错误报告

通过{创建新问题}[http://github.com/padrino/padrino-framework/issues]在 Github 上记录。

请确保包含所有相关信息，如你正在使用的 Padrino、Rack、Sinatra、Ruby 和操作系统的版本。

在 Github 上发布一个包含 Gemfile.lock 的最小项目展示问题也非常有帮助。

== 版权