atom narrow

angosto

estrecho algo.
Herramienta de navegación de código inspirada en Unite.vim, Emacs-Helm.
Más información sobre wiki

¿Qué es esto?

• Proporcione una interfaz de usuario en estrechamiento como Emacs-Helm y Unite/Denite.vim.
• No tiene como objetivo convertirse en "puede abrir cualquier cosa desde la interfaz de usuario estrecha".
• El enfoque primario está en la navegación en código .
• El proveedor proporciona elementos (por ejemplo, archivos search en el proyecto), puede filtrar elementos por consulta para reducir aún más.
• A medida que mueve el cursor en Active-Editor, el elemento actual en Round-UI se sincroniza automáticamente.
• Ya no has perdido como "¿Dónde estoy?" Cuando está trabajando en varios archivos.
• Deje que el estrecho navegue al siguiente elemento anterior/anterior para ayudar a su concentración.
• Editar con confianza para la no porción por Direct-Edit (editar ag search result en el editor estrecho y luego aplicar los cambios en el archivo real).
• En cuenta
  • Navegación del teclado.
  • Integración VIM-Mode-Plus (también soy mantenedor de VIM-Mode-Plus).
• Vea también USECase en wiki y preguntas y respuestas en este documento

Roles en el juego.

• narrow-editor o narrow-ui : Filtrar elementos por consulta y artículos de renderizado.
• narrow-provider : proporcione elementos a estrecho.

descripción general

barra de control

Proveedores agrupados

Puede consultar GIF para todos los proveedores agrupados aquí.
Utilizo symbols scan , search , git-diff-all , en la base diaria, para otros proveedores que no uso mucho.

• scan : Escanear editor actual.
• search : Búsqueda por ag (necesita instalar ag solo).
• atom-scan : similar a search pero use Atom atom.workspace.scan .
• fold : proporcione filas de inicio plegable como elemento.
• git-diff-all : Muestre todo el archivo de estado modificado en todo el proyecto.
• symbols : proporcione símbolos para el archivo actual.
• project-symbols : proporcione información de símbolos de todo el proyecto leyendo el archivo tags .

Recorrido rápido

Para seguir este tour rápido, no necesita keymap personalizado.

Paso 1. Básico usando narrow:scan

1. Abra un editor de texto, luego a través de Command-Palette, invoque Narrow Scan .
2. narrow-editor abierto, los elementos iniciales son cada líneas en el editor. Mientras escribe, puede limitar los artículos.
3. Cuando escribe apple como consulta. Se enumeran todos los elementos a juego apple .
4. Puede mover la tecla Normal up , down (o j , k en modo de solo lectura) a los elementos de previsión rápida.
5. enter para confirmar. Cuando se confirma, narrow-editor cerrado.

El modo de solo lectura está habilitado de forma predeterminada.

Paso 2. Navegue desde fuera del narrow-editor .

1. Abra un editor de texto, luego a través de Command-Palette, invoque Narrow Scan .
2. narrow-editor abierto. Mientras escribe, puede limitar los artículos.
3. Haga clic en Invocar editor. Y ver su posición de clics se refleja automáticamente con narrow-editor .
4. ctrl-cmd-n para moverse a next-item , ctrl-cmd-p para moverse a previous-item .

• Si es un usuario VIM-Mode-Plus, puede usar tab y shift-tab .

5. Puede cerrar narrow-editor por ctrl-g (no es necesario enfocar narrow-editor ).
6. Si desea cambiar de cuantía estrecha, debe concentrarse en narrow-editor

• Use ctrl-cmd-f ( narrow:focus ) para enfocar narrow-editor .
• Use ctrl-cmd-i ( narrow:focus-prompt ) para enfocar directamente la fila rápida de consulta del editor estrecho.
• Ambos comandos están disponibles desde afuera/dentro del editor estrecho.

7. Estas teclas de navegación están disponibles para todos los proveedores (por ejemplo, search , fold , etc.).

Paso 3. edición directa

Direct-edit es la función "editar en narrow-editor y luego guardar en archivo real".
Disponible para los siguientes proveedores.

• scan
• search
• atom-scan

️ Esta operación es peligrosa, ya que puede actualizar varios archivos a la vez. ️ Debe tener lo suficientemente cuidadoso como para usar esta función, no use esto sin comprender lo que está haciendo. ️ Puedo decir lo siento, pero no puedo recuperar el archivo para usted.

1. Abra el archivo desde el proyecto, coloque el cursor para el nombre de la variable hello
2. Luego invoca Narrow Search By Current Word .
3. Todos los artículos de hello Matching aparecen en Editor Round.
4. Si lo desea, puede reducir aún más por consulta.
5. Luego edite el texto del editor estrecho directamente .

• Coloque el cursor en hello . Luego ctrl-cmd-g ( find-and-replace:select-all ), luego escriba world .

6. Invoca Narrow Ui: Update Real File de la paleta de comandos.
7. Hechos, los cambios que realizó en elementos de editor estrecho se aplican al archivo real (y se guardan).
8. Puede deshacer los cambios mediante elementos de reedición en los cambios de editor estrecho y volver a aplicar por Narrow Ui: Update Real File .

Paso 4. Palabra clave de búsqueda [experimental] por mouse

1. Establezca Search.startByDoubleClick en true desde Configuración-View.
2. Haga doble clic en la palabra clave en el editor.
3. Cada vez que haga doble clic en la palabra clave, se reemplaza el nuevo editor estrecho y el viejo.
4. Puede continuar con doble clic en el editor estrecho o editor normal.

Comandos

Disponible en todo el editor de texto

Otro

• narrow:focus : ( ctrl-cmd-f ) Enfoque al narrow-editor , si se ejecuta en narrow-editor , se vuelve a enfocar en el editor original.
• narrow:focus-prompt : ( ctrl-cmd-i ) Enfoque al indicador de la entrada de consulta de narrow-editor , si se ejecuta en narrow-editor , se vuelve a enfocar en el editor original.
• narrow:refresh : Actualice los artículos manualmente en narrow-editor .
• narrow:close : ( ctrl-g ) Cerrar actualmente abierto de narrow-editor uno a la vez.
• narrow:next-item : ( ctrl-cmd-n ) mover el cursor a la posición del siguiente ítem.
• narrow:previous-item : ( ctrl-cmd-p ) Mueva el cursor a la posición del ítem anterior.
• narrow:reopen : (sin KEYMAP predeterminado) Reaber el editor estrecho cerrado hasta 10 cerrados recientes.
• narrow:query-current-word : ( ctrl-cmd-e ) Reemplace la consulta activa de narrow-editor con palabra cursor.
• narrow:previous-query-history : ( ctrl-cmd-[ ) Reemplace la consulta activa del narrow-editor con entrada de historial anterior.
• narrow:next-query-history : ( ctrl-cmd-] ) Reemplace la consulta activa del narrow-editor con la próxima entrada del historial.

Invocar a la proporcionalidad estrecha

No se proporcionan keymaps

• narrow:scan
• narrow:scan-by-current-word
• narrow:fold
• narrow:fold-by-current-word
• narrow:search : Búsqueda AG. Necesita instalar por usted mismo.
• 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

Disponible en editor estrecho (estrecho-ui)

El !vmp seguido de KEYMAP significa "que KEYMAP no está disponible para el usuario VIM-Mode-Plus".
Si desea usar estos keymap con vim-mode-plus , configúrelo usted mismo.
Ver wiki

• core:confirm : ( enter ) Cerrar narrow-editor
• narrow-ui:confirm-keep-open : Mantenga narrow-editor abierto
• narrow-ui:open-here : Artículo abierto en el mismo panel del panel de UI.
• narrow-ui:preview-item : Vista previa actualmente El elemento seleccionado manualmente (no necesita en la mayoría de los casos).
• narrow-ui:preview-next-item : ( tab ) Vista previa del siguiente ítem sin mover el cursor de la solicitud de consulta del narrow-editor .
• narrow-ui:preview-previous-item : ( shift-tab ) Vista previa del siguiente ítem sin mover el cursor de la solicitud de consulta del narrow-editor .
• narrow-ui:toggle-auto-preview : ( ctrl-r para usuario no VIM-MODE-plus) Desactivar/habilitar Auto-Preview para este narrow-editor .
• narrow-ui:move-to-prompt : ctrl-cmd-i
• narrow-ui:stop-insert : escape
• narrow-ui:update-real-file : Aplique los cambios realizados en narrow-editor a la archivo real (editar en narrow-editor y luego guárdelo en un archivo real).
• narrow-ui:protect : no hay keymap por defecto, proteger el editor estrecho de ser destruido por narrow:close ( ctrl-g ).
• narrow-ui:exclude-file : backspace , excluir elementos que coinciden con el filepath de los elementos seleccionados actualmente.
• narrow-ui:clear-excluded-files : ctrl-backspace , Lista de archivos CORREDE EXCLUCIÓN.
• narrow-ui:select-files : cmd-backspace , seleccione interactivamente qué elementos de FilePath aparecerán en 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 : no hay keymap de forma predeterminada, la ubicación de cambio donde se abrió la interfaz de usuario entre el espacio de trabajo center y el muelle bottom .

Kimapas

No hay keymap para invocar un proveedor estrecho (por ejemplo, narrow:scan ).
Inicie desde comando-palette o establezca kymap en keymap.cson .

️ KEYMAP predeterminado aún no está resuelto, es probable que esto cambie en la versión futura.

Mi kymap (user de Vim-Mode-Plus) y config

config.cson

  narrow :
    SelectFiles :
      rememberQuery : true
    confirmOnUpdateRealFile : false 

keymap.cson

Explicación de mi kimap.

• cmd-f : Centrarse en el editor estrecho y el enfoque al editor original
• cmd-i : Centrarse en el aviso y retroceso de los editor estrecho al editor original
• cmd-e :
  • Cuando el espacio de trabajo no tiene narrow-edior en el espacio de trabajo: Comience narrow:search-by-current-word .
  • Cuando el espacio de trabajo tiene al menos una narrow-edior : query-current-word (por defecto KeyMap).
    • Reemplace la consulta activa de los narrow-edior con palabra cursor.
• cmd-[ : narrow:previous-query-history recuerdo de historia anterior
• cmd-] : narrow:next-query-history , Recuerde la próxima historia
• ctrl-g : Cerrar narrow-editor desde donde sea.
• tab , shift-tab : para moverse al elemento siguiente/anterior.
• ; : Confirmar el ítem actual sin cerrar narrow-editor , puedo cerrar 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 '

Configuración recomendada para otros paquetes.

• Suprima la ventana emergente de autocompleto-plus en editor estrecho
• Deshabilitar la búsqueda más destacada de VIM-Mode-Plus en el editor estrecho

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

Notas para el usuario de VIM-Mode-Plus

️ Limitación: para compatibilidad con VIM-Mode-Plus.

• Si usa Atom V1.16.0 o más,
  • No habilite vim-mode-plus.automaticallyEscapeInsertModeOnActivePaneItemChange
  • Si habilitó, cada entrada de consulta en el editor estrecho del proveedor search causa cambio de modo desde insert-mode al normal-mode .
• Si usa Atom V1.17.0 o más (actualmente en beta).
  • Esta limitación ya no existe.

Kimap

Aprenda kymap disponible como predeterminado.
Por ejemplo, puede pasar al elemento siguiente o anterior por tab , shift-tab (para que esto funcione, necesita VIM-MODE-plus V0.81.0 o posterior).

Iniciar estrecho desde la forma de entrada de búsqueda de Vim-Mode-plus

Si es usuario VIM-Mode-Plus. El siguiente comando está disponible en Vim-Mode-Plus's Search ( / o ? ) Mini editor.

• 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

Cómo editar el área de elementos para la edición directa.

• En el editor estrecho, i , a cursor de movimiento en normal-mode a la línea rápida.
• Entonces, cuando desee editar elementos en sí para el archivo direct-edit y update-real-file use otra clave para ingresar insert-mode .
• I mapean intencionalmente a vim-mode-plus:activate-insert-mode que normalmente se asigna a i .
  • Lo que podría no ser intuitivo, pero quiero que la mutación de los elementos sea difícil. Entonces el usuario tiene que escribir I
• Aparte de I , puede comenzar insert-mode por A , c etc.

Preguntas y respuestas

¿Qué proveedores estás usando seriamente?

En la edición diaria, uso.

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

¿Por qué no estoy usando a los demás? la razón está aquí.

• fold : ya que es similar a symbols .
• atom-scan : se proporciona para el usuario de Windows que no puede usar search (NECESITA ag o rg ).

Noté que puedo cerrar narrow-editor por cmd-w normal ( core:close ). ¿Por qué necesito narrow:close ? ¿Cuál es la diferencia?

La mayor diferencia es narrow:close (scrolltop, plate, elemento de panel activo) si el usuario solo realizó preview desde el inicio.

• narrow:close : cierre el estado de narrow-editor y restauración cuando sea apropiado. También puede cerrar narrow-editor independientemente del editor activo actual.
• core:close : solo destruye narrow-editor .

Use lo que desee en consecuencia. Normalmente uso narrow:close y ocasionalmente uso core:close como cuando quiero enfocar el ítem en el siguiente panel de narrow-editor (así que no quiero restaurar el enfoque al editor iniciado por estrecho).

¿Cómo puedo excluir un archivo en particular desde narrow:search

Use backspace en el artículo

• Use backspace para excluir un archivo particular del resultado.
• ctrl-backspace Borrar lista de archivos excluidos y actualizar
• Estos keymaps están disponibles en narrow-editor y usted está en read-only-mode

Utilice el proveedor select-files

• Puede iniciar select-files por cmd-backspace o hacer clic en folder-icon en la barra de control .

1. Search editor de narrow:search , ves muchos elementos machizados editor
2. ¿Pero desea excluir elementos en el archivo de Markdown?

• Iniciar select-files , todas las rutas de archivo se enumeran como elemento.
• Luego escriba md en la consulta, verá a Markdown Filepath que Macheled md .
• ¡Entonces agrega ! , ahora tu consulta es md! , Esto se trata como todos los archivos que no coinciden md .
• enter para confirmar.

3. Ves que se excluyen los elementos con elementos en los archivos de Markdown.
4. Puede volver a financiar archivos para excluir reiniciando select-files .

• por ejemplo, para excluir la carpeta spec , puede agregar spec/! como consulta.
• por ejemplo, para incluir el archivo .js solamente, puede establecer la consulta en .js .

Quiero omitir al next-file , previous-file

• Use n , p en modo read-only .

Quiero narrow:symbols siempre aparecen en el panel más a la derecha y no quiero cerrar.

1. Abierto narrow:symbols (o tal vez desee usar narrow:fold )
2. Mueva este narrow-editor arrastrando y suelte al lugar donde desee.
3. De Command-Palette, ejecute Narrow Ui: Protect . Ahora narrow-editor protegido.
4. narrow-editor protegido no está cerrado por ctrl-g ( narrow:close ), y no se cierra por confirmación por enter .
5. Para cerrar, use el botón Normal cmd-w o Cerrar en la pestaña.