atom narrow

狭窄的

狭窄的东西。
代码导航工具灵感来自unite.vim，emacs-helm。
有关Wiki的更多信息

这是什么？

• 提供较窄的UI，例如Emacs-Helm和Unite/denite.vim。
• 不打算成为“可以从可窄UI”包中打开任何内容。
• 原始重点是代码范围。
• 提供者提供项目（例如，通过项目中的search文件），您可以通过查询过滤项目以进一步缩小。
• 当您在Active-Editor上移动光标时，狭窄UI上的当前项目会自动同步。
• 您不再像“我在哪里？”那样迷路了。当您处理多个文件时。
• 让狭窄导航到下一个/上一个项目以帮助您的集中注意力。
• 通过直接编辑充满信心地编辑（对窄编辑器上的ag search result进行编辑，然后将更改应用于真实文件）。
• 考虑到
  • 键盘导航。
  • vim-mode-plus集成（我也是vim-mode-plus的维护者）。
• 还可以在此文档上查看Wiki和问答

在游戏中的角色。

• narrow-editor或narrow-ui ：通过查询和渲染项目进行过滤项目。
• narrow-provider ：提供狭窄的物品。

概述

控制栏

捆绑提供者

您可以在此处查看所有捆绑提供商的GIF。
我使用scan ， search ， git-diff-all ，日常基础中的symbols ，对于其他提供商，我使用的不是太多。

• scan ：扫描当前编辑器。
• search ： ag搜索（您需要自己安装ag ）。
• atom-scan ：类似于search ，但使用Atom的atom.workspace.scan 。
• fold ：提供折叠行作为项目。
• git-diff-all ：在项目中显示所有修改的状态文件。
• symbols ：提供当前文件的符号。
• project-symbols ：通过读取tags文件提供项目范围的符号信息。

快速游览

要遵循此快速旅行，您不需要自定义Keymap。

步骤1。基本使用narrow:scan

1. 打开一些文本编辑器，然后通过命令 - 调用Narrow Scan 。
2. narrow-editor打开，初始项目是编辑器上的各行。当您键入时，您可以缩小物品。
3. 当您将apple键入查询时。列出了所有apple匹配项。
4. 您可以将正常up移动， down （或以读取模式为j ，k，k，k，k，k，k k k，k，k，k，k，k，k，k，k，k，k k k in for Read-hody Mode）键转到快速浏览项目。
5. enter以确认。确认后， narrow-editor关闭。

默认情况下启用了仅读取模式。

步骤2。从narrow-editor的外部导航。

1. 打开一些文本编辑器，然后通过命令 - 调用Narrow Scan 。
2. narrow-editor打开。当您键入时，您可以缩小物品。
3. 单击调用编辑器。并查看您的点击位置会自动反映narrow-editor 。
4. ctrl-cmd-n移至next-item ， ctrl-cmd-p转到previous-item 。

• 如果您是VIM-Mode-Plus用户，则可以使用tab和shift-tab 。

5. 您可以通过ctrl-g关闭narrow-editor （无需集中narrow-editor ）。
6. 如果您想更改窄质量，则必须专注于narrow-editor

• 使用ctrl-cmd-f （ narrow:focus ）来焦点narrow-editor 。
• 使用ctrl-cmd-i （ narrow:focus-prompt ）直接聚焦窄编辑器的查询提示行。
• 这两个命令均可从窄编辑器的外部/内部提供。

7. 这些导航keymaps可用于所有提供商（例如search ， fold等）。

步骤3。直接编辑

Direct-Edit是“在narrow-editor上编辑，然后保存到实实际文件”功能。
可用于以下提供商。

• scan
• search
• atom-scan

配x此操作很危险，因为您可以一次更新多个文件。配x您必须小心地使用此功能，不要在不了解您在做什么的情况下使用此功能。配x我可以说抱歉，但我无法为您恢复文件。

1. 从项目打开文件，放置可变名称的光标hello
2. 然后Narrow Search By Current Word 。
3. 所有的hello匹配项目都显示在窄编辑器上。
4. 如果需要，您可以通过查询进一步缩小。
5. 然后直接编辑窄编辑的文本。

• 将光标放在hello上。然后ctrl-cmd-g （ find-and-replace:select-all ），然后键入world 。

6. 调用Narrow Ui: Update Real File 。
7. 完成了，您对窄编辑项目进行的更改应用于实体（保存）。
8. 您可以通过在窄编辑器上重新编辑项目来撤消更改，然后通过Narrow Ui: Update Real File 。

步骤4。 [实验]搜索关键字由鼠标

1. 将Search.startByDoubleClick true为“从设置”视图。
2. 编辑器中的双击关键字。
3. 每次您双击关键字时，新的窄编辑器都会打开，旧的编辑将更换。
4. 您可以继续双击较狭窄的编辑器或正常编辑器。

命令

在所有文本编辑中可用

其他

• narrow:focus ：（ ctrl-cmd-f ）将重点放在narrow-editor上，如果在narrow-editor中执行，则重新聚焦于原始编辑器。
• narrow:focus-prompt ：（ ctrl-cmd-i ）专注于narrow-editor的查询输入提示，如果在narrow-editor中执行，则将其重点放在原始编辑器中。
• narrow:refresh ：在narrow-editor中手动刷新项目。
• narrow:close ：（ ctrl-g ）当前关闭一次narrow-editor一次。
• narrow:next-item ：（ ctrl-cmd-n ）将光标移至Next-Sutem的位置。
• narrow:previous-item ：（ ctrl-cmd-p ）将光标移至上一个项目的位置。
• narrow:reopen ：（无默认的keymap）重新打开了封闭的狭窄编辑器，最多可直至10个关闭。
• narrow:query-current-word ：（ ctrl-cmd-e ）用光标单词替换活跃的narrow-editor的查询。
• narrow:previous-query-history ：（ ctrl-cmd-[ ）用以前的历史记录输入替换Active narrow-editor的查询。
• narrow:next-query-history ：（ ctrl-cmd-] ）用下一个历史记录输入替换活跃的narrow-editor的查询。

调用狭窄的提供

没有提供keymaps

• narrow:scan
• narrow:scan-by-current-word
• narrow:fold
• narrow:fold-by-current-word
• narrow:search ：AG搜索。需要按照自己的安装。
• narrow:search-by-current-word
• narrow:search-current-project
• narrow:search-current-project-by-current-word
• narrow:atom-scan
• narrow:atom-scan-by-current-word
• narrow:symbols
• narrow:symbols-by-current-word
• narrow:project-symbols ：
• narrow:project-symbols-by-current-word ：
• narrow:git-diff-all

可在窄编辑（狭窄的UI）中使用

!vmp之后的keymap表示“哪个KeyMap不适合Vim-Mode-Plus用户使用”。
如果您想将这些keymap与vim-mode-plus一起使用，请自己设置。
参见Wiki

• core:confirm ：（ enter ）关闭narrow-editor
• narrow-ui:confirm-keep-open ：保持开放式narrow-editor
• narrow-ui:open-here ：在UI窗格的同一窗格上打开物品。
• narrow-ui:preview-item ：当前手动选择的项目（在大多数情况下您不需要）。
• narrow-ui:preview-next-item ：（ tab ）预览下一个项目，而无需从narrow-editor的查询提示中移动光标。
• narrow-ui:preview-previous-item ：（ shift-tab ）预览下一个项目，而无需从narrow-editor的查询提示中移动光标。
• narrow-ui:toggle-auto-preview ：（非vim-mode-plus用户的ctrl-r ）禁用/启用此narrow-editor的自动浏览。
• narrow-ui:move-to-prompt ： ctrl-cmd-i
• narrow-ui:stop-insert ： escape
• narrow-ui:update-real-file ：应用narrow-editor中所做的更改对实实际文件。（在narrow-editor中进行编辑，然后将其保存到真实文件中。）
• narrow-ui:protect ：默认情况下没有keymap，保护狭窄的编辑器免于被narrow:close （ ctrl-g ）摧毁。
• narrow-ui:exclude-file ： backspace ，排除与当前选择项目的filepath相匹配的项目。
• narrow-ui:clear-excluded-files ： ctrl-backspace ，清晰的排除文件列表。
• narrow-ui:select-files ： cmd-backspace ，交互式选择哪些FilePath的项目出现在narrow-editor上。
• narrow-ui:toggle-search-whole-word ： alt-cmd-w
• narrow-ui:toggle-search-ignore-case ： alt-cmd-c
• narrow-ui:toggle-search-use-regex ： alt-cmd-/
• narrow-ui:start-insert ： I （ !vmp ）， a （ !vmp ）
• narrow-ui:move-to-next-file-item ： n （ !vmp ）
• narrow-ui:move-to-previous-file-item ： p （ !vmp ）
• narrow-ui:relocate ：默认情况下没有keymap，在center工作区和bottom码头之间打开UI的开关位置。

keymaps

没有keymap调用狭窄的提供商（例如narrow:scan ）。
从Command-Palette或keymap.cson中的Keymap启动。

配x默认的keymap尚未解决，这可能会在未来版本中改变。

我的keymap（vim-mode-plus用户）和配置

config.cson

  narrow :
    SelectFiles :
      rememberQuery : true
    confirmOnUpdateRealFile : false 

keymap.cson

解释我的keymap。

• cmd-f ：专注于狭窄编辑器，并将重点放在原始编辑中
• cmd-i ：专注于缩小编辑的及时及重点放在原始编辑中
• cmd-e ：
  • 当工作空间在工作区没有narrow-edior时：开始narrow:search-by-current-word 。
  • 当工作空间至少具有一个narrow-edior ： query-current-word （默认情况下）。
    • 用光标字代替活跃的narrow-edior查询。
• cmd-[ ： narrow:previous-query-history记忆以前的历史
• cmd-] ： narrow:next-query-history ，回想下一个历史
• ctrl-g ：在任何地方关闭narrow-editor 。
• tab ， shift-tab ：移至下一个/上一个项目。
• ; ：确认电流项目而不关闭narrow-editor ，我可以通过ctrl-g关闭narrow-editor 。

 # From outside of narrow-editor
# -------------------------

# `cmd-e` start `search-by-current-word` only when workspace does NOT have `narrow-editor`.
# NOTE: When workspace.has-narrow, `cmd-e` is mapped to `query-current-word` by default.
' atom-workspace:not(.has-narrow) atom-text-editor.vim-mode-plus:not(.insert-mode) ' :
  ' cmd-e ' : ' narrow:search-by-current-word '

' atom-text-editor.vim-mode-plus:not(.insert-mode) ' :
  ' ctrl-z ' :      ' narrow:reopen '
  ' space f ' :     ' narrow:fold '
  ' cmd-o ' :       ' narrow:symbols-by-current-word '
  ' cmd-shift-o ' : ' narrow:project-symbols-by-current-word '
  ' cmd-r ' :       ' narrow:symbols ' # Override default cmd-r
  ' cmd-shift-r ' : ' narrow:project-symbols ' # Override default cmd-shift-r
  ' space l ' :     ' narrow:scan '
  ' cmd-l ' :       ' narrow:scan-by-current-word '
  ' space s ' :     ' narrow:search '
  ' space G ' :     ' narrow:git-diff-all '

# When workspace has narrow-editor
' atom-workspace.has-narrow atom-text-editor.vim-mode-plus.normal-mode ' :
  ' cmd-f ' : ' narrow:focus ' # focus to narrow-editor
  ' cmd-i ' : ' narrow:focus-prompt ' # focus to prompt of narrow-editor

  # Following three command have ctrl- prefixed by default to avoid conflicts.
  # But I don' care conflict, prefer more accessible keymap.
  ' cmd-[ ' : ' narrow:previous-query-history '
  ' cmd-] ' : ' narrow:next-query-history '
  ' cmd-e ' : ' narrow:query-current-word '

# narrow-editor regardless of mode of vim
' atom-text-editor.narrow.narrow-editor[data-grammar="source narrow"] ' :
  ' cmd-f ' : ' narrow:focus '
  ' cmd-i ' : ' narrow:focus-prompt ' # cmd-i to return to calling editor.

  # Danger: apply change on narrow-editor to real file by `cmd-s`.
  ' cmd-s ' : ' narrow-ui:update-real-file '

  # Move ui in between bottom dock and center workspace.
  ' cmd-t ' : ' narrow-ui:relocate '

' atom-workspace.has-narrow atom-text-editor.vim-mode-plus.normal-mode,
  atom-workspace.has-narrow atom-text-editor.vim-mode-plus.visual-mode ' :
    ' cmd-e ' : ' narrow:query-current-word ' # set current word as query of active ui.

' atom-text-editor.narrow.narrow-editor.vim-mode-plus.normal-mode ' :
  ' g g ' : ' narrow-ui:move-to-prompt '
  ' s ' : ' narrow-ui:select-files '
  ' ; ' : ' narrow-ui:confirm-keep-open '
  ' n ' : ' narrow-ui:move-to-next-file-item '
  ' p ' : ' narrow-ui:move-to-previous-file-item '

其他软件包的建议配置。

• 在窄编辑器上抑制AutoComplete Plus的弹出窗口
• 禁用vim-mode-plus对窄编辑器的突出显示

 " * " :
  " autocomplete-plus " :
    suppressActivationForEditorClasses : [
      # snip
      " narrow "
    ]
  # snip
  " vim-mode-plus " :
    highlightSearchExcludeScopes : [
      " narrow "
    ]

vim-mode-plus用户的注释

配x限制：与VIM-Mode-Plus兼容。

• 如果使用Atom v1.16.0或以上，
  • 不要启用vim-mode-plus.automaticallyEscapeInsertModeOnActivePaneItemChange
  • 如果启用了，则从search提供程序的窄编辑器上的每个查询输入从insert-mode到normal-mode 。
• 如果您使用ATOM v1.17.0或以上（目前在beta中）。
  • 这种限制不再存在。

keymap

学习默认情况下可用的keymap。
例如，您可以通过tab （ shift-tab移动到下一个或上一个项目（为此，您需要vim-mode-plus v0.81.0或更高版本）。

从VIM-Mode-Plus的搜索输入形式开始缩小

如果您是vim-mode-plus用户。以下命令可从VIM-Mode-Plus的搜索（ /或? ）迷你版中获得。

• vim-mode-plus-user:narrow:scan
• vim-mode-plus-user:narrow:search
• vim-mode-plus-user:narrow:search-current-project
• vim-mode-plus-user:narrow:atom-scan

如何为Direct-Edit编辑项目 - 地区。

• 在狭窄编辑器中， i ， a normal-mode移动光标以提示线路。
• 因此，当您想编辑项目本身以进行direct-edit和update-real-file时，请使用其他密钥输入insert-mode 。
• I有意映射到vim-mode-plus：通常映射到i vim-mode-plus:activate-insert-mode 。
  • 这可能不是直观的，但我想让项目变异很困难。因此用户必须键入I
• 除了I ，您还可以通过A ， c等开始insert-mode 。

问答

您认真使用哪些提供商？

在日常编辑中，我使用。

scan ， search ， git-diff-all ， symbols 。

为什么我不使用别人？原因在这里。

• fold ：因为它类似于symbols 。
• atom-scan ：为无法使用search的Windows用户提供（需要ag或rg ）。

注意到我可以通过普通cmd-w关闭narrow-editor （ core:close ）。为什么我需要narrow:close ？有什么区别？

最大的区别是narrow:close如果用户仅从启动中preview ，则关闭还原编辑器状态（scrolltop，fold，活动窗格项目）。

• narrow:close ：合适时关闭narrow-editor和还原编辑状态。无论当前的活动编辑器如何，都可以关闭narrow-editor 。
• core:close ：只需销毁narrow-editor 。

使用任何您想要的。我通常使用narrow:close和偶尔使用core:close诸如我想集中narrow-editor的下一窗格项目时（因此，不要恢复焦点以缩小启动编辑器）。

我如何从narrow:search中排除特定文件

在项目上使用backspace

• 使用backspace将特定文件排除在结果之外。
• ctrl-backspace清除排除的文件列表和刷新
• 这些keymaps在narrow-editor中可用，您在read-only-mode中

使用select-files提供商

• 您可以通过cmd-backspace启动select-files ，也可以在Control-bar上单击folder-icon 。

1. 搜索editor narrow:search ，您会看到许多editor器手机
2. 但是您想在Markdown文件中排除项目吗？

• 启动select-files ，所有文件路径均列为项目。
• 然后在查询上输入md ，您会看到Macheed md的Markdown Filepath。
• 然后添加! ，现在您的查询是md! ，这被视为所有文件都不匹配md 。
• enter以确认。

3. 您会看到不包括在降价文件中带有项目的项目。
4. 您可以通过重新发布select-files重新加密文件来排除。

• 例如，要排除spec文件夹，您可以添加spec/!作为查询。
• 例如，仅包括.js文件，您可以将查询设置为.js 。

想跳到next-file ， previous-file

• 在read-only模式下使用n ， p 。

我想要narrow:symbols总是以最正确的窗格出现，并且不想关闭。

1. 打开narrow:symbols （或者您想使用narrow:fold ）
2. 通过拖放到您想要的地方，将此narrow-editor移动。
3. 从命令 - 塞子中执行Narrow Ui: Protect 。现在narrow-editor受到保护。
4. 受保护的narrow-editor不会被ctrl-g （ narrow:close ）关闭，也不会通过enter确认封闭。
5. 要关闭，请在选项卡上使用普通的cmd-w或关闭按钮。