Administrate
用于在 Rails 中创建灵活、强大的管理仪表板的框架。试试这个演示。
警告:
Administrate 仍然是 pre-1.0,并且可能偶尔会对 API 进行重大更改。查看发行说明以获取重要更新。
Administrate 是什么?
Administrate 是一个 Rails 应用程序库,用于自动生成管理仪表板。 Administrate 的管理仪表板为非技术用户提供了干净的界面,允许他们为应用程序中的任何模型创建、编辑、搜索和删除记录。
Administrate 解决了与 Rails Admin 和 ActiveAdmin 相同的问题,但目的是为站点管理员提供更好的用户体验,并使开发人员更容易定制。
为了实现这些目标,Administrate 遵循一些指导原则:
- 没有 DSL(特定于域的语言)
- 支持最简单的用例,并允许用户使用标准工具(如普通Rails控制器和视图)覆盖默认值。
- 将库拆分为核心组件和插件,因此每个组件都很小,易于维护。
入门
Administrate 支持从4.2到5.0及更高版本的 Rails。我们支持 Ruby 2.4 及更高版本。
将 Administrate 添加到 Gemfile 并重新打包
gem "administrate"
随附的安装程序将为应用程序中的每个模型创建仪表板,并完成路由:
$ rails generate administrate:install
重新启动服务器,然后访问 http://localhost:3000/admin 以查看新的仪表板。
要获得更详细的说明,或者使其只适用于 Rails api 应用程序,请阅读“入门”指南。
创建其他仪表板
要创建其他仪表板,请将资源名称传递给仪表板生成器。将创建仪表板和控制器。
$ rails generate administrate:dashboard Foo
文档
要定制仪表板的外观、行为和内容,请参阅 https://administrate-prototype.herokuapp.com 上的指南。这些指南也可以作为 markdown 文件在 git 存储库的 docs 子目录中使用。
存储库结构
此存储库包含 Administrate 的源代码和使用 Administrate 的演示 Rails 应用程序。演示应用程序在 Heroku 上公开托管。
- gem 的源代码存在于 app 和 lib 子目录中。
- 演示应用程序嵌套在 spec/example_app 中。
- https://administrate-prototype.herokuapp.com 上的指南在docs 子目录中作为 markdown 文件存在。
Rails 配置文件已经更改,以便在新位置识别应用程序,因此运行服务器或部署到 Heroku 可以正常工作。
使用这种结构,开发一个典型的特性看起来是这样的:
- 在
spec/
中添加测试 - Implement a feature in 在
administrate/
中实现一项功能 - Exercise the feature using 使用 demo rails app (
spec/example_app/app/
) 练习该功能
前端架构
该项目使用:
- Sass
- BEM-style CSS selectors, with namespaces
- Autoprefixer
- SCSS-Lint, with Hound (configuration)
- A variety of CSS units:
em
for typographical-related elementsrem
for lengths related to componentspx
for borders, text shadows, etc.vw
/vh
for lengths that should be relational to the viewport
许可
administrate 版权所有©2015-2019 thoughtbot。 它是免费软件,可以根据 LICENSE 文件中指定的条款重新分发。