atom narrow

étroit

restreindre quelque chose.
Outil de navigation de code inspiré de Unite.vim, Emacs-helm.
Plus d'informations sur le wiki

Qu'est-ce que c'est ça?

• Fournissez une interface utilisateur de rétrécissement comme Emacs-helm et Unite / denite.vim.
• Ne pas viser à devenir "peut ouvrir quoi que ce soit à partir du package d'interface utilisateur étroit".
• Primal Focus est sur la navigation de code .
• Fournisseur fournit des éléments (par exemple par des fichiers search dans le projet), vous pouvez filtrer les éléments par requête pour restreindre davantage.
• Lorsque vous déplacez le curseur sur l'administrateur actif, l'élément actuel sur étroit-UI est automatiquement synchronisé.
• Vous ne perdez plus comme "où suis-je?" Lorsque vous travaillez sur plusieurs fichiers.
• Laissez étroitement accéder à l'élément suivant / précédent pour aider votre concentration.
• Modifier avec confiance pour le non-Govert par l'édition directe (modifier ag search result sur un éditeur étroit puis appliquer des modifications au fichier réel).
• À l'esprit
  • Navigation du clavier.
  • Intégration VIM-Mode-Plus (je suis également mainteneur de main de VIM-Mode-Plus).
• Voir également UseCase sur Wiki et Q&R sur ce doc

Rôles dans le jeu.

• narrow-editor ou narrow-ui : Filtrez les éléments par requête et rendez les articles.
• narrow-provider : Fournissez des articles à étroiter.

aperçu

barre de contrôle

Fournisseurs groupés

Vous pouvez consulter les GIF pour tous les fournisseurs groupés ici.
J'utilise scan , search , git-diff-all , symbols dans Daily-Basis, pour d'autres fournisseurs que je n'utilise pas beaucoup.

• scan : scanner l'éditeur actuel.
• search : recherche par ag (vous devez installer ag par vous-même).
• atom-scan : similaire à search mais utilisez ATOM atom.workspace.scan .
• fold : Fournissez des lignes de démarrage en tant qu'élément.
• git-diff-all : Afficher tous les fichiers d'état modifiés sur le projet.
• symbols : fournissez des symboles pour le fichier actuel.
• project-symbols : fournissez des informations sur les symboles à l'échelle du projet en lisant le fichier tags .

Tournée rapide

Pour suivre cette touche rapide, vous n'avez pas besoin de Keymap personnalisé.

Étape 1. Basique en utilisant narrow:scan

1. Ouvrez un éditeur de texte, puis via Command-Palette, invoquez Narrow Scan .
2. narrow-editor ouvert, les éléments initiaux sont chaque ligne sur l'éditeur. Au moment où vous tapez, vous pouvez restreindre les éléments.
3. Lorsque vous tapez apple comme requête. Tous les éléments correspondants apple sont répertoriés.
4. Vous pouvez déplacer la touche normale, up bas, down (ou j , k en mode en lecture seule) pour les éléments à prévision rapide.
5. enter pour confirmer. Lorsqu'il est confirmé, narrow-editor s'est fermé.

Le mode en lecture seule est activé par défaut.

Étape2. naviguer de l'extérieur de narrow-editor .

1. Ouvrez un éditeur de texte, puis via Command-Palette, invoquez Narrow Scan .
2. narrow-editor s'est ouvert. Au moment où vous tapez, vous pouvez restreindre les éléments.
3. Cliquez sur Invoking Editor. Et voir votre position cliquée est automatiquement réfléchie par narrow-editor .
4. ctrl-cmd-n pour passer à next-item , ctrl-cmd-p pour passer à previous-item .

• Si vous êtes un utilisateur Vim-Mode-Plus, vous pouvez utiliser tab et shift-tab .

5. Vous pouvez fermer narrow-editor par ctrl-g (pas besoin de concentrer narrow-editor ).
6. Si vous voulez changer de quête étroite, vous devez vous concentrer sur narrow-editor

• Utilisez ctrl-cmd-f ( narrow:focus ) pour concentrer narrow-editor .
• Utilisez ctrl-cmd-i ( narrow:focus-prompt ) pour concentrer directement la ligne invite de requête de l'éditeur étroit.
• Les deux commandes sont disponibles à l'extérieur / à l'intérieur de l'éditeur étroit.

7. Ces keymaps de navigation sont disponibles pour tous les fournisseurs (par exemple, search , fold , etc.).

Étape 3. édition directe

Direct-Edit est "Modifier sur narrow-editor puis enregistrer sur le fichier réel".
Disponible pour les fournisseurs suivants.

• scan
• search
• atom-scan

️ Cette opération est dangereuse, car vous pouvez mettre à jour plusieurs fichiers à la fois. ️ Vous devez être suffisamment prudent pour utiliser cette fonctionnalité, n'utilisez pas cela sans comprendre ce que vous faites. ️ Je peux dire désolé, mais je ne peux pas récupérer le fichier pour vous.

1. Ouvrez le fichier du projet, placez le curseur pour le nom de la variable hello
2. Invoquez ensuite Narrow Search By Current Word .
3. Tous les éléments de correspondance hello sont apparus sur un éditeur étroit.
4. Si vous le souhaitez, vous pouvez vous rétrécir davantage par la requête.
5. Modifiez ensuite directement le texte de l'éditeur étroit.

• Placer le curseur sur hello . Ensuite, ctrl-cmd-g ( find-and-replace:select-all ), puis tapez world .

6. Invoquez Narrow Ui: Update Real File de Command-Palette.
7. Effectué, les modifications que vous avez apportées sur les éléments de l'éditeur étroit sont appliquées à un fichier réel (et enregistré).
8. Vous pouvez annuler les modifications en réédite les éléments sur l'éditeur étroit et réappliquer les modifications par Narrow Ui: Update Real File .

Étape 4. [Expérimental] Rechercher le mot-clé par souris

1. Définissez Search.startByDoubleClick sur true depuis Settings-View.
2. Double-cliquez sur Mot-clé dans l'éditeur.
3. Chaque fois que vous double-cliquez sur le mot-clé, un nouvel éditeur étroit ouvert et ancien est remplacé.
4. Vous pouvez continuer à double clic de l'éditeur toujours étroit ou de l'éditeur normal.

Commandes

Disponible dans tous les rédacteurs en texte

Autre

• narrow:focus : ( ctrl-cmd-f ) Focus de narrow-editor , s'il est exécuté en narrow-editor , il recentre à l'éditeur original.
• narrow:focus-prompt : ( ctrl-cmd-i ) Focus de l'invite d'entrée de requête de narrow-editor , si elle est exécutée dans narrow-editor , il redéquate à l'éditeur d'origine.
• narrow:refresh : rafraîchir manuellement les articles en narrow-editor .
• narrow:close : ( ctrl-g ) Close actuellement ouverte en narrow-editor un à la fois.
• narrow:next-item : ( ctrl-cmd-n ) Déplacez le curseur vers la position de l'élément suivant.
• narrow:previous-item : ( ctrl-cmd-p ) Déplacez le curseur vers la position de l'élément précédent.
• narrow:reopen : (pas de keymap par défaut) Rouvrir l'éditeur étroit fermé jusqu'à 10 fermés récents.
• narrow:query-current-word : ( ctrl-cmd-e ) Remplacez la requête de l' narrow-editor actif par un mot de curseur.
• narrow:previous-query-history : ( ctrl-cmd-[ ) Remplacez la requête de l' narrow-editor actif par l'entrée de l'historique précédent.
• narrow:next-query-history : ( ctrl-cmd-] ) Remplacez la requête de l' narrow-editor actif par une entrée d'historique suivante.

Invoquer étroit fournir

Aucun keymaps n'est fourni

• narrow:scan
• narrow:scan-by-current-word
• narrow:fold
• narrow:fold-by-current-word
• narrow:search : recherche AG. Besoin d'installer par vous-même.
• 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 éditeur étroit (étroit-UI)

Le !vmp suivi de KeyMAP signifie "quel keymap n'est pas disponible pour l'utilisateur vim-mode-plus".
Si vous souhaitez utiliser ces keymap avec vim-mode-plus , définissez-le par vous-même.
Voir wiki

• core:confirm : ( enter ) Fermer narrow-editor
• narrow-ui:confirm-keep-open : gardez l'ouverture narrow-editor
• narrow-ui:open-here : Open Item dans le même volet du volet de l'interface utilisateur.
• narrow-ui:preview-item : Aperçu de l'élément actuellement sélectionné manuellement (vous n'avez pas besoin dans la plupart des cas).
• narrow-ui:preview-next-item : ( tab ) prévisualiser le prochain item sans déplacer le curseur de l'invite de requête de l' narrow-editor .
• narrow-ui:preview-previous-item : ( shift-tab ) prévisualiser le sujet suivant sans déplacer le curseur de l'invite de requête de narrow-editor .
• narrow-ui:toggle-auto-preview : ( ctrl-r pour l'utilisateur non-vim-mode-plus) Désactiver / activer automatiquement la prévision de cet narrow-editor .
• narrow-ui:move-to-prompt : ctrl-cmd-i
• narrow-ui:stop-insert : escape
• narrow-ui:update-real-file : appliquez des modifications apportées en narrow-editor au fichier réel. (Modifiez-le en narrow-editor puis enregistrez-le dans le fichier réel.)
• narrow-ui:protect : pas de keymap par défaut, protégez un éditeur étroit contre le détruit par narrow:close ( ctrl-g ).
• narrow-ui:exclude-file : backspace , exclure les éléments qui correspondent à FilePath des articles actuellement sélectionnés.
• narrow-ui:clear-excluded-files : ctrl-backspace , Liste des fichiers exclues claires.
• narrow-ui:select-files : cmd-backspace , sélectionnez interactivement les articles de Filepath à apparaître sur 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 : pas de keymap par défaut, emplacement de commutateur où l'interface utilisateur s'est ouverte entre l'espace de travail center et le quai bottom .

Keymaps

Pas de keymap pour invoquer un fournisseur étroit (par exemple narrow:scan ).
Démarrez-le à partir de commande-palette ou définissez Keymap dans keymap.cson .

️ Le keymap par défaut n'est pas encore réglé, cela va probablement changer dans la version future.

Mon keymap (utilisateur vim-mode-plus) et config

config.cson

  narrow :
    SelectFiles :
      rememberQuery : true
    confirmOnUpdateRealFile : false 

keymap.cson

Explication de mon keymap.

• cmd-f : se concentrer sur le rédacteur étroit et le focus à l'éditeur d'origine
• cmd-i : se concentrer sur l'invite et le focus de l'éditeur étroit à l'éditeur d'origine
• cmd-e :
  • Lorsque l'espace de travail n'a pas narrow-edior sur l'espace de travail: Démarrez narrow:search-by-current-word .
  • Lorsque Workspace a au moins un narrow-edior : query-current-word (par défaut Keymap).
    • Remplacez la requête active de narrow-edior par un mot de curseur.
• cmd-[ : narrow:previous-query-history de l'histoire antérieure
• cmd-] : narrow:next-query-history , Rappel Next History
• ctrl-g : Fermer narrow-editor de partout.
• tab , shift-tab : pour passer à l'élément suivant / précédent.
• ; : Confirmer les éléments actuels sans fermer narrow-editor , je peux fermer narrow-editor par 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 '

Configuration recommandée pour les autres packages.

• Supprimez la popup de l'observance de secours pour le rédacteur étroit
• Désactiver la recherche de points forts de Vim-Mode-Plus sur le rédacteur étroit

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

Notes pour l'utilisateur de Vim-Mode plus

️ Limitation: pour compatibilité avec VIM-mode-plus.

• Si vous utilisez Atom v1.16.0 ou plus,
  • N'activez pas vim-mode-plus.automaticallyEscapeInsertModeOnActivePaneItemChange
  • Si vous avez activé, chaque entrée de requête sur l'éditeur étroit du fournisseur search provoque un changement de mode du insert-mode au normal-mode .
• Si vous utilisez Atom v1.17.0 ou plus (actuellement en version bêta).
  • Cette limitation n'existe plus.

Keymap

Apprenez Keymap disponible par défaut.
Par exemple, vous pouvez passer à l'élément suivant ou précédent par tab , shift-tab (pour que cela fonctionne, vous avez besoin de VIM-mode-plus V0.81.0 ou ultérieure).

Démarrer étroit à partir de la forme de recherche de la recherche de Vim-Plus

Si vous êtes un utilisateur Vim-Mode-plus. La commande suivante est disponible dans le mini-éditeur de recherche ( / ou ? ) De 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

Comment modifier la zone d'articles pour l'édition directe.

• En éditeur étroit, i , a en normal-mode Déplacer le curseur vers une ligne invite.
• Ainsi, lorsque vous souhaitez modifier les éléments lui-même pour direct-edit et update-real-file utilisez une autre touche pour entrer insert-mode .
• I est intentionnellement mappé à vim-mode-plus:activate-insert-mode qui est normalement cartographié sur i .
  • Ce qui peut ne pas être intuitif, mais je veux rendre difficile la mutatation des éléments. L'utilisateur doit donc taper I .
• Autre que I , vous pouvez commencer insert-mode par A , c etc.

Q&R

Quels fournisseurs utilisez-vous sérieusement?

Dans l'édition quotidienne, j'utilise.

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

Pourquoi je n'en utilise pas les autres? La raison est là.

• fold : car il similaire aux symbols .
• atom-scan : il est fourni pour l'utilisateur de Windows qui ne peut pas utiliser search (besoin ag ou rg ).

Remarqué que je peux fermer narrow-editor par cmd-w normal ( core:close ). Pourquoi j'ai besoin narrow:close ? Quelle est la différence?

La plus grande différence est narrow:close l'état de l'éditeur de restauration (ScrollTop, pli, élément de volet actif) si l'utilisateur n'a fait que preview à partir du démarrage.

• narrow:close : Fermer narrow-editor et restaurer l'état de l'éditeur lorsqu'il est approprié. Peut également fermer narrow-editor quel que soit le rédacteur actif actuel.
• core:close : Il suffit de détruire narrow-editor .

Utilisez ce que vous voulez en conséquence. J'utilise normalement narrow:close et utilise occasionnellement core:close comme lorsque je veux me concentrer sur le poane à proximité de narrow-editor (donc je ne veux pas restaurer la mise au point pour un éditeur initié étroit).

Comment puis-je exclure un fichier particulier de narrow:search

Utilisez backspace sur l'article

• Utilisez backspace pour exclure le fichier particulier du résultat.
• ctrl-backspace Clear List excluant la liste et actualiser
• Ces keymaps sont disponibles en narrow-editor et vous êtes en read-only-mode

Utilisez le fournisseur select-files

• Vous pouvez lancer select-files par cmd-backspace ou cliquer sur folder-icon sur la barre de contrôle .

1. Recherche editor par narrow:search , vous voyez beaucoup d' editor Mached Items
2. Mais vous voulez exclure les éléments dans le fichier de marquage?

• Lancez select-files , tous les chemins de fichier sont répertoriés comme élément.
• Ensuite, tapez md sur la requête, vous voyez Markdown Filepath qui Macheed md .
• Puis ajoutez ! , maintenant votre requête est md! , Ceci est traité comme tous les fichiers ne correspond pas md .
• enter pour confirmer.

3. Vous voyez des éléments avec des éléments dans les fichiers Markdown sont exclus.
4. Vous pouvez refaire des fichiers pour exclure en relancant select-files .

• Par exemple, pour exclure le dossier spec , vous pouvez ajouter spec/! comme requête.
• Par exemple, pour inclure le fichier .js uniquement, vous pouvez définir une requête sur .js .

Voulez passer à next-file , previous-file

• Utilisez n , p en mode en read-only .

Je veux narrow:symbols apparaissent toujours dans le volet le plus à droite et ne veulent pas fermer.

1. Ouvert narrow:symbols (ou peut-être que vous souhaitez utiliser narrow:fold )
2. Déplacez cet narrow-editor en faisant glisser et tombez à l'endroit où vous voulez.
3. De Command-Palette, exécutez Narrow Ui: Protect . Maintenant protégée par narrow-editor .
4. narrow-editor protégé n'est pas fermé par ctrl-g ( narrow:close ), et non fermé par confirmation par enter .
5. Pour fermer, utilisez le bouton cmd-w ou Fermer normal dans l'onglet.