Sublime Text 2插件：简单Rails导航器

用于导航Ruby on Rails应用程序的简单插件。

注意：master分支与Sublime Text 3不兼容，但现在有一个独立的ST3分支（感谢@doz！）它与ST3兼容（但不与ST2兼容）。直到ST3的Package Control准备就绪，可以通过克隆GitHub仓库（见下面的从GitHub克隆）并运行git checkout ST3来安装ST3版本。

此插件提供了用于在快速面板中列出模型、控制器、视图、助手、 fixtures、测试/specs、javascript文件或样式的命令，以便轻松选择。

相关文件位于列表顶部，可以通过按Enter键轻松选择。例如，如果活动视图是一个Rails模型，您请求控制器的列表，则与模型对应的控制器将列在顶部，前提是您遵循常规的Rails资源约定，将控制器名称中的模型名称复数化（例如，post.rb和posts_controller.rb）。

对于测试或specs也是如此（在示例情况中，测试文件应命名为test/unit/post_test.rb或spec/models/post_spec.rb）。如果应用程序包含一个spec目录，插件将搜索 specs 并忽略test目录；否则，将使用test目录。

以下表格显示了哪些相关文件将置于列表顶部

此插件灵感来源于Luqman Amjad的Rails Related Files插件。这两个插件具有互补的功能（Amjad的插件在一个列表中显示所有类型的关联文件），并且它们可以一起使用。

安装

Package Control

安装此插件的WebDriver最简单的方法是使用Package Control。

• 如果您刚刚安装了Package Control，在执行下一步之前，您可能需要重启Sublime Text 2。
• 打开命令面板（在OS X上使用Command+Shift+p，在Linux/Windows上使用Control+Shift+p）。
• 选择“Package Control：安装包”（这可能需要几秒钟）
• 当列表出现时，选择Simple Rails Navigator。

Package Control会自动将Simple Rails Navigator更新到最新版本。

从GitHub克隆

或者，您可以直接从GitHub将存储库克隆到您的Packages目录中

git clone http://github.com/noklesta/SublimeRailsNav

按键绑定

插件不会自动安装任何按键绑定。以下是您如何设置自己的按键绑定的示例。为了避免与现有命令冲突，首先在控制台运行sublime.log_commands(True)，尝试按键组合并查看是否有什么被记录。

{ "keys": ["super+ctrl+m"], "command": "list_rails_models" },
{ "keys": ["super+ctrl+c"], "command": "list_rails_controllers" },
{ "keys": ["super+ctrl+v"], "command": "list_rails_views" },
{ "keys": ["super+ctrl+h"], "command": "list_rails_helpers" },
{ "keys": ["super+ctrl+x"], "command": "list_rails_fixtures" },
{ "keys": ["super+ctrl+t"], "command": "list_rails_tests" },
{ "keys": ["super+ctrl+i"], "command": "list_rails_javascripts" },
{ "keys": ["super+ctrl+y"], "command": "list_rails_stylesheets" }

如果您正在使用Vintage模式并想使用非修饰键的序列，可以将按键绑定限制如下

{ "keys": [" ", "m"], "command": "list_rails_models", "context": [{"key": "setting.command_mode"}] },
{ "keys": [" ", "c"], "command": "list_rails_controllers", "context": [{"key": "setting.command_mode"}] },
{ "keys": [" ", "v"], "command": "list_rails_views", "context": [{"key": "setting.command_mode"}] },
{ "keys": [" ", "h"], "command": "list_rails_helpers", "context": [{"key": "setting.command_mode"}] },
{ "keys": [" ", "x"], "command": "list_rails_fixtures", "context": [{"key": "setting.command_mode"}] },
{ "keys": [" ", "t"], "command": "list_rails_tests", "context": [{"key": "setting.command_mode"}] },
{ "keys": [" ", "i"], "command": "list_rails_javascripts", "context": [{"key": "setting.command_mode"}] },
{ "keys": [" ", "y"], "command": "list_rails_stylesheets", "context": [{"key": "setting.command_mode"}] }

所有命令也都可通过命令面板（搜索以“Simple Rails Navigator”开头的命令）访问。

设置

SublimeRailsNav.sublime-settings中的设置可以通过Packages/User/SublimeRailsNav.sublime-settings或特定项目的项目文件中的顶层“设置”键进行覆盖。后者的一个示例

"settings":
{
  "SublimeRailsNav":
  {
    "javascript_locations": [
      ["app", "assets", "javascripts"]
    ],
    "stylesheet_locations": [
      ["app", "assets", "stylesheets"],
      ["lib", "assets", "stylesheets"]
    ]
  }
}

鸣谢

• 灵感到来于ST2的Luqman Amjad的Rails Related Files插件，以及Tim Pope的rails.vim插件（它当然比这个功能丰富得多，:-)
• Rails分类程序的Python版本：https://bitbucket.org/ixmatus/inflector
• 包含自ST2的Git包中修改过的一个小代码片段。

许可

SublimeRailsNav的所有内容均受MIT许可证的许可。

版权所有 © 2012 Anders Nøklestad

特此赋予任何获得本软件及其相关文档文件（“软件”）副本的任何人，免费使用软件的权利，不受任何限制，包括但不限于使用、复制、修改、合并、发布、分发、 sublicense 和/或销售软件副本的权利，并允许获得软件副本的个人使用软件，前提是必须遵守以下条件

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

软件按“原样”提供，不提供任何形式的保证，无论是明示的还是暗示的，包括但不限于适销性、特定用途的适用性和非侵权性保证。在任何情况下，作者或版权所有者不应对任何索赔、损害或其他责任负责，无论是基于合同、侵权或任何其他方式，从软件本身、使用或其它与软件相关的活动中产生的、源自的或与其相关的。