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或關閉按鈕。