atom narrow

estreito

estreita algo.
Ferramenta de navegação de código inspirada no unite.vim, emacs-helm.
Mais informações sobre o wiki

O que é isso?

• Forneça uma interface do estreitamento como o emacs-helm e une/denite.vim.
• Não pretendendo se tornar o pacote "pode abrir qualquer coisa do pacote de interface do usuário de imbecil estreito".
• O foco primal está na navegação de código .
• O fornecedor fornece itens (por exemplo, por arquivos search no projeto), você pode filtrar itens por consulta para diminuir ainda mais.
• À medida que você move o cursor no editor ativo, o item atual no Larroge-UI é sincronizado automaticamente.
• Você não perde mais como "Onde estou?" Quando você está trabalhando em vários arquivos.
• Deixe estreito navegar para o item próximo/anterior para ajudar sua concentração.
• Edite com confiança para não-overlook por edit direto (editar ag search result no editor estreito e aplique alterações no arquivo real).
• Em mente
  • Navegação do teclado.
  • Integração VIM-Mode-Plus (também sou mantenedor de Vim-Mode-plus).
• Veja também USECASE no wiki e perguntas e respostas neste documento

Papéis no jogo.

• narrow-editor ou narrow-ui : Filtre os itens por consulta e renderizar itens.
• narrow-provider : forneça itens para estreitar.

visão geral

barra de controle

Fornecedores agrupados

Você pode verificar os GIFs para todo o fornecedor agrupado aqui.
Eu uso symbols scan , search , git-diff-all , no Daily-Basis, para outros provedores que não uso muito.

• scan : Digitalizar editor atual.
• search : Pesquise por ag (você precisa instalar ag por si mesmo).
• atom-scan : semelhante à search , mas use o Atom do atom.workspace.scan .
• fold : Forneça linhas de partida dobrada como item.
• git-diff-all : mostre todo o arquivo de estado modificado no projeto.
• symbols : Forneça símbolos para o arquivo atual.
• project-symbols : Forneça informações de símbolos em todo o projeto lendo o arquivo tags .

Tour rápido

Para seguir este turista rápido, você não precisa de teclas personalizadas.

Etapa1. básico usando narrow:scan

1. Abra um editor de texto e, em seguida, via Palette de Comando, invocar Narrow Scan .
2. narrow-editor foi aberto, os itens iniciais são cada uma das linhas no editor. À medida que você digita, você pode restringir itens.
3. Quando você digita apple como consulta. Todos os itens de correspondência apple estão listados.
4. Você pode mover a tecla normal up , down (ou j , k no modo somente leitura) para itens de previsão rápida.
5. enter para confirmar. Quando confirmado, narrow-editor fechou.

O modo somente leitura é ativado por padrão.

Etapa2. Navegue de fora do narrow-editor .

1. Abra um editor de texto e, em seguida, via Palette de Comando, invocar Narrow Scan .
2. narrow-editor foi aberto. À medida que você digita, você pode restringir itens.
3. Clique em Invocar Editor. E consulte sua posição clicada é automaticamente refletida com narrow-editor .
4. ctrl-cmd-n para passar para o next-item , ctrl-cmd-p para passar para o previous-item .

• Se você é o usuário do VIM-Mode-plus, poderá usar tab e shift-tab .

5. Você pode fechar narrow-editor por ctrl-g (não precisa se concentrar narrow-editor ).
6. Se você deseja mudar de estrela estreita, precisa se concentrar no narrow-editor

• Use ctrl-cmd-f ( narrow:focus ) para focar narrow-editor .
• Use ctrl-cmd-i ( narrow:focus-prompt ) para concentrar diretamente a linha de solicitação de consulta do editor estreito.
• Ambos os comandos estão disponíveis de fora/interior do editor estreito.

7. Esses teclados de navegação estão disponíveis para todo o provedor (por exemplo, search , fold etc.).

Etapa3. edit direto

O Recurso direto é o recurso "Editar no narrow-editor e, em seguida, salvar no arquivo real".
Disponível para os seguintes fornecedores.

• scan
• search
• atom-scan

️ Esta operação é perigosa, pois você pode atualizar vários arquivos de uma só vez. ️ Você deve ter cuidado o suficiente para usar esse recurso, não use isso sem entender o que está fazendo. ️ Posso pedir desculpas, mas não posso recuperar o arquivo para você.

1. Abra o arquivo do projeto, coloque o cursor para o nome da variável hello
2. Em seguida, invoco Narrow Search By Current Word .
3. Todos os itens de correspondência hello estão aparecem em editor estreito.
4. Se você quiser, você pode restringir ainda mais por consulta.
5. Em seguida, edite o texto do editor estreito diretamente .

• Coloque o cursor no hello . Em seguida, ctrl-cmd-g ( find-and-replace:select-all ), depois digite world .

6. Invoque Narrow Ui: Update Real File do comando-palette.
7. Feito, as alterações que você fez em itens de editor estreito são aplicados ao arquivo real (e salvo).
8. Você pode desfazer alterações por itens reedit em editor estreito e reaplicar as alterações por Narrow Ui: Update Real File .

Etapa4. [Experimental] Pesquisar palavras -chave por mouse

1. Defina Search.startByDoubleClick como true a partir do Settings-View.
2. Palavra -chave de clique duas vezes no editor.
3. Cada vez que você clica duas vezes em palavras-chave, o novo editor estreito aberto e o antigo é substituído.
4. Você pode continuar clique duas vezes como o editor estreito ou o editor normal.

Comandos

Disponível em todo o editor de texto

Outro

• narrow:focus : ( ctrl-cmd-f ) Foco para narrow-editor , se executado em narrow-editor , ele se concentra novamente no editor original.
• narrow:focus-prompt : ( ctrl-cmd-i ) Foco no prompt de entrada de consultas do narrow-editor , se executado em narrow-editor , ele se concentra novamente no editor original.
• narrow:refresh : Atualizar manualmente os itens em narrow-editor .
• narrow:close : ( ctrl-g ) Close atualmente abriu narrow-editor um de cada vez.
• narrow:next-item : ( ctrl-cmd-n ) Mova o cursor para a posição do próximo item.
• narrow:previous-item : ( ctrl-cmd-p ) Mova o cursor para a posição de itens anteriores.
• narrow:reopen : (sem keymap padrão) Reabrir o editor estreito fechado até 10 fechados recentes.
• narrow:query-current-word : ( ctrl-cmd-e ) Substitua a consulta de narrow-editor ativo pela palavra cursor.
• narrow:previous-query-history : ( ctrl-cmd-[ ) Substitua a consulta de narrow-editor ativo pela entrada anterior do histórico.
• narrow:next-query-history : ( ctrl-cmd-] ) Substitua a consulta de narrow-editor ativo pela próxima entrada do histórico.

Invoque o fornecimento estreito

Nenhuma chaves são fornecidas

• narrow:scan
• narrow:scan-by-current-word
• narrow:fold
• narrow:fold-by-current-word
• narrow:search : Pesquisa AG. Precisa instalar por si mesmo.
• 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

Disponível em editor estreito (Larroge-UI)

O !vmp seguido por keymap significa "que o keymap não está disponível para o usuário do Modo-Modo Vim".
Se você quiser usar esses keymap com vim-mode-plus , defina-o sozinho.
Veja Wiki

• core:confirm : ( enter ) Fechar narrow-editor
• narrow-ui:confirm-keep-open : Mantenha narrow-editor aberto
• narrow-ui:open-here : Item aberto no mesmo painel do painel da interface do usuário.
• narrow-ui:preview-item : visualizar o item atualmente selecionado manualmente (você não precisa na maioria dos casos).
• narrow-ui:preview-next-item : ( tab ) Visualize o próximo item sem mover o cursor do prompt de consulta do narrow-editor .
• narrow-ui:preview-previous-item : ( shift-tab ) Visualize o próximo item sem mover o cursor do prompt de consulta do narrow-editor .
• narrow-ui:toggle-auto-preview : ( ctrl-r para usuário que não é de VIM-Mode-plus) Desative/Ative a previsão automática para este narrow-editor .
• narrow-ui:move-to-prompt : ctrl-cmd-i
• narrow-ui:stop-insert : escape
• narrow-ui:update-real-file : Aplique alterações feitas no narrow-editor no arquivo real. (Editar em narrow-editor e salve-o no arquivo real.)
• narrow-ui:protect : Nenhuma alcance por padrão, proteja o editor estreito de ser destruído por narrow:close ( ctrl-g ).
• narrow-ui:exclude-file : backspace , exclua itens que correspondem ao FilePath dos itens atualmente selecionados.
• narrow-ui:clear-excluded-files : ctrl-backspace , Lista de arquivos excluídos claros.
• narrow-ui:select-files : cmd-backspace , selecione interativamente quais itens do FilePath aparecerem no 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 : Não por padrão, alterne o local onde a interface do usuário abriu entre o espaço de trabalho center e a doca bottom .

Keymaps

Nenhuma chave de chave para invocar provedor estreito (por exemplo, narrow:scan ).
Inicie-o no comando-palette ou defina keymap em keymap.cson .

️ O keymap padrão ainda não está resolvido, é provável que isso mude na versão futura.

Meu keymap (usuário de Modo-Modo Vim) e Config

config.cson

  narrow :
    SelectFiles :
      rememberQuery : true
    confirmOnUpdateRealFile : false 

keymap.cson

Explicação do meu keymap.

• cmd-f : Focalizar-se para estreito e foco para o editor original
• cmd-i : Focalizar-se para estrear o prompt e o foco para o editor original do Original-Editor
• cmd-e :
  • Quando o espaço de trabalho não tem narrow-edior no espaço de trabalho: Start narrow:search-by-current-word .
  • Quando o espaço de trabalho tem pelo menos um narrow-edior : query-current-word (por padrão, keymap).
    • Substitua a consulta de narrow-edior ativo por uma palavra do cursor.
• cmd-[ : narrow:previous-query-history
• cmd-] : narrow:next-query-history -se da próxima história
• ctrl-g : próximo narrow-editor de onde.
• tab , shift-tab : para mudar para o item próximo/anterior.
• ; : Confirme o item atual sem fechar narrow-editor , posso fechar narrow-editor por ctrl-g .

 # 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 '

Configuração recomendada para outros pacotes.

• Suprimir o pop-up do AutoComplete-Plus no editor estreito
• Desative a pesquisa de destaque do VIM-Mode-Plus em editor estreito

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

Notas para o usuário do Modo-Modo Vim

️ Limitação: Para compatibilidade com o Modo-mais.

• Se você usar o Atom v1.16.0 ou mais, mais,
  • Não habilite vim-mode-plus.automaticallyEscapeInsertModeOnActivePaneItemChange
  • Se você ativou, cada entrada de consulta no editor estreito do provedor search que causa o modo de mudança do insert-mode para normal-mode .
• Se você usar o Atom v1.17.0 ou mais ou mais (atualmente na versão beta).
  • Essa limitação não existe mais.

Keymap

Aprenda o KeyMap disponível como padrão.
Por exemplo, você pode passar para o item próximo ou anterior por tab , shift-tab (para que isso funcione, você precisa de vim-mais v0.81.0 ou posterior).

Comece estreito a partir do formulário de entrada de vim-mode-plus

Se você é o usuário do VIM-Mode-plus. O comando a seguir estão disponíveis no mini-editor de pesquisa do Vim-Mode-plus ( / ou ? ).

• 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

Como editar a área de itens para edit direto.

• No editor estreito, i , a cursor de movimentos no normal-mode para solicitar a linha.
• Portanto, quando você deseja editar os próprios itens para direct-edit e update-real-file use outra chave para inserir insert-mode .
• I sou intencionalmente mapeado para o vim-mode-plus:activate-insert-mode que normalmente é mapeado para i .
  • O que pode não ser intuitivo, mas quero dificultar a mutação do item. Portanto, o usuário precisa digitar I .
• Fora I , você pode começar insert-mode por A , c etc ..

Q&A

Quais provedores você está usando seriamente?

Na edição diária, eu uso.

scan , search , git-diff-all , symbols .

Por que não estou usando outros? A razão está aqui.

• fold : como é semelhante aos symbols .
• atom-scan : é fornecido para o usuário do Windows que não pode usar search (precisa de ag ou rg ).

Percebi que posso fechar narrow-editor por cmd-w normal ( core:close ). Por que eu preciso narrow:close ? Qual é a diferença?

A maior diferença é narrow:close o estado do editor de restauração (scrolltop, dobrar, item do painel ativo) se o usuário preview apenas a inicialização.

• narrow:close : Fechar narrow-editor e o estado do editor de restauração quando apropriado. Também pode fechar narrow-editor independentemente do editor ativo atual.
• core:close : Basta destruir narrow-editor .

Use o que quiser de acordo. Normalmente, uso narrow:close e ocasionalmente usar core:close como quando eu quero focar o próximo item de pano de narrow-editor (portanto, não quero restaurar o foco para restringir o editor iniciado).

Como posso excluir o arquivo específico de narrow:search

Use backspace no item

• Use backspace para excluir o arquivo específico do resultado.
• ctrl-backspace Clear Lista de arquivos e atualização excluídos
• Esses tecidos de chave estão disponíveis em narrow-editor e você está no read-only-mode

Use o provedor select-files

• Você pode iniciar select-files pelo cmd-backspace ou clicando em folder-icon na barra de controle .

1. editor de pesquisa por narrow:search , você vê muitos itens com máquinas de editor
2. Mas você deseja excluir itens no arquivo de marcação?

• Inicie select-files , todos os caminhos de arquivo estão listados como item.
• Em seguida, digite md na consulta, você vê o Markdown FilePath que Macheed md .
• Então adicione ! , agora sua consulta é md! , isso é tratado como todos os arquivos que não correspondem md .
• enter para confirmar.

3. Você vê itens com itens nos arquivos de marcação são excluídos.
4. Você pode re-fingir os arquivos a serem excluídos relançando select-files .

• Por exemplo, para excluir a pasta spec , você pode adicionar spec/! como consulta.
• Por exemplo, para incluir apenas o arquivo .js , você pode definir consulta como .js .

Quero pular para o next-file , previous-file

• Use n , p no modo read-only .

Eu quero narrow:symbols sempre aparecem no painel mais à direita e não quero fechar.

1. Aberto narrow:symbols (ou talvez você queira usar narrow:fold )
2. Mova este narrow-editor por arrasto e solte para o local onde quiser.
3. Da paleta de comando, execute Narrow Ui: Protect . Agora narrow-editor protegido.
4. narrow-editor protegido não é fechado por ctrl-g ( narrow:close ) e não fechado por confirmar por enter .
5. Para fechar, use o botão cmd-w ou feche normal na guia.