简介

Ransack 将帮助您轻松地为 Rails 应用程序添加搜索功能，无需任何额外的依赖。

市面上有一些高级搜索解决方案，如 ElasticSearch 或 Algolia。对于许多 Rails 网站来说，Ransack 能够胜任，无需运行额外的基础设施或使用不同的语言。使用 Ransack，您可以仅用标准的 Ruby 和 ERB 完成所有工作。

准备好超越基础了吗？使用高级功能，如国际化和广泛的配置选项。

Ransack 支持 Ruby 3.1 及更高版本上的 Rails 7.2、7.1、7.0、6.1。

安装

要安装 ransack 并将其添加到您的 Gemfile 中，运行

gem 'ransack'

最新版本

如果您想使用尚未发布到 RubyGems 的最新更新，请使用 main 分支：

gem 'ransack', :github => 'activerecord-hackery/ransack', :branch => 'main'

文档

Ransack 有详尽的文档，这是一个 Docusaurus 项目，作为 GitHub Pages 网站运行。

问题追踪

• 在提交问题之前，请阅读贡献指南。
• 如果发现 Ransack 导致的 bug，且该问题是新的（尚未被报告过），并且_可以根据您提供的信息复现_，请提交问题。
• 请考虑添加一个包含失败测试的分支来描述问题。
• 欢迎贡献。:smiley:
• 请不要使用问题追踪器寻求个人支持。Stack Overflow 或 GitHub Discussions 是更适合的地方，那里有更广泛的社区可以帮助您！

贡献

要支持该项目：

• 考虑通过Open Collective支持我们
• 在你的应用中使用Ransack，如果遇到任何问题或缺失，请告诉我们。提供一个失败的测试用例来演示问题将会很棒。提交一个包含通过测试的拉取请求则更好！
• 在提交问题或拉取请求之前，请务必阅读并遵循贡献指南。
• 请使用Stack Overflow或GitHub讨论来询问问题或进行与错误报告、拉取请求或文档改进无直接关系的讨论。
• 如果Ransack对你有用，请在社交媒体上传播。使用这个项目的人越多，我们就能越快地发现并修复错误！

贡献者

Ransack由Ernie Miller创建，并由以下人员开发和维护：

• Sean Carroll
• Deivid Rodriguez
• Greg Molnar
• 一群优秀的贡献者。

• Ransack的标志由Anıl Kılıç设计。

前任维护者

• Jon Atack
• Ryan Bigg

这个项目的存在要感谢所有做出贡献的人。<img src="https://yellow-cdn.veclightyear.com/0a4dffa0/0d74ba89-aa0d-42c0-a7db-86d8df1169e1.svg?width=890&button=false" />

支持者

感谢所有的支持者！🙏 [成为支持者]

<a href="https://opencollective.com/ransack#backers" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/7acf280b-c5c0-42f6-bd96-ae133b2deb80.svg?width=890" /></a>

赞助商

通过成为赞助商来支持这个项目。你的logo将会显示在这里，并链接到你的网站。[成为赞助商] <a href="https://opencollective.com/ransack/sponsor/0/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/8aa3794b-74d1-4183-bcbe-fbcf225134ff.svg" /></a> <a href="https://opencollective.com/ransack/sponsor/1/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/914cd14f-b2ad-498c-be31-b7d54c8f96d2.svg" /></a> <a href="https://opencollective.com/ransack/sponsor/2/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/98d88db9-592a-41bb-a5fd-417c6fa3ede2.svg" /></a> <a href="https://opencollective.com/ransack/sponsor/3/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/8bc0f71a-7239-4340-8fe2-ea8c8d233f03.svg" /></a> <a href="https://opencollective.com/ransack/sponsor/4/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/e02f56bd-2abf-4096-b9e5-995254b47714.svg" /></a> <a href="https://opencollective.com/ransack/sponsor/5/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/83a9d04f-c2b7-45d3-bff1-5831cc9164f0.svg" /></a> <a href="https://opencollective.com/ransack/sponsor/6/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/26f67f60-5423-475f-82b5-2e5a655f45bd.svg" /></a> <a href="https://opencollective.com/ransack/sponsor/7/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/503d38fe-4811-4fde-807f-5bec1f2f54da.svg" /></a> <a href="https://opencollective.com/ransack/sponsor/8/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/f38b33a0-148b-466e-9d1f-627e8c49467d.svg" /></a> <a href="https://opencollective.com/ransack/sponsor/9/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/21ea44a8-6c3f-4dd0-9d5a-6ea59ea225ec.svg" /></a>