atom narrow

sempit

Sempit sesuatu.
Alat Navigasi Kode Terinspirasi oleh Unite.vim, Emacs-Helm.
Informasi lebih lanjut tentang wiki

Apa ini?

• Berikan UI yang mempersempit seperti Emacs-Helm dan Unite/Denite.vim.
• Tidak bertujuan untuk menjadi paket "dapat membuka apapun dari UI yang dapat disempit".
• Fokus primal adalah pada navigasi kode .
• Penyedia menyediakan item (misalnya dengan file search dalam proyek), Anda dapat memfilter item dengan kueri untuk mempersempit lebih lanjut.
• Saat Anda menggerakkan kursor pada editor aktif, item saat ini pada Sempit-UI secara otomatis disinkronkan.
• Anda tidak lagi tersesat seperti "dimana saya?" Saat Anda mengerjakan beberapa file.
• Biarkan navigasi sempit ke item berikutnya/sebelumnya untuk membantu konsentrasi Anda.
• Sunting dengan percaya diri untuk no-overlook oleh langsung-edit (sunting ag search result pada editor sempit kemudian menerapkan perubahan pada file nyata).
• Dalam pikiran
  • navigasi keyboard.
  • integrasi vim-mode-plus (saya juga pemelihara vim-mode-plus).
• Lihat juga Usecase di Wiki dan Tanya Jawab di dokumen ini

Peran dalam permainan.

• narrow-editor atau narrow-ui : Filter item berdasarkan kueri dan render item.
• narrow-provider : Menyediakan barang untuk menyempit.

ringkasan

bilah kontrol

Penyedia yang dibundel

Anda dapat memeriksa GIF untuk semua penyedia yang dibundel di sini.
Saya menggunakan scan , search , git-diff-all , symbols dalam basis harian, untuk penyedia lain yang tidak banyak saya gunakan.

• scan : Pindai editor saat ini.
• search : Cari ag (Anda perlu menginstal ag sendiri).
• atom-scan : Mirip dengan search tetapi menggunakan atom atom.workspace.scan .
• fold : Berikan baris fold-start sebagai item.
• git-diff-all : Tampilkan semua file negara yang dimodifikasi di seluruh proyek.
• symbols : Berikan simbol untuk file saat ini.
• project-symbols : Memberikan informasi simbol di seluruh proyek dengan membaca file tags .

Tur cepat

Untuk mengikuti tur cepat ini, Anda tidak memerlukan keymap khusus.

Langkah1. Dasar dengan menggunakan narrow:scan

1. Buka beberapa editor teks, lalu melalui Palette Perintah, panggil Narrow Scan .
2. narrow-editor dibuka, item awal adalah setiap baris pada editor. Saat Anda mengetik, Anda dapat mempersempit item.
3. Saat Anda mengetik apple sebagai kueri. Semua item pencocokan apple terdaftar.
4. Anda dapat memindahkan tombol normal, up (atau j , k dalam mode read down only) ke item preview cepat.
5. enter untuk mengonfirmasi. Saat dikonfirmasi, narrow-editor ditutup.

Mode read-only diaktifkan secara default.

Langkah2. menavigasi dari luar narrow-editor .

1. Buka beberapa editor teks, lalu melalui Palette Perintah, panggil Narrow Scan .
2. narrow-editor dibuka. Saat Anda mengetik, Anda dapat mempersempit item.
3. Klik Editor Invoking. Dan lihat posisi Anda yang diklik secara otomatis tercermin narrow-editor .
4. ctrl-cmd-n untuk pindah ke next-item , ctrl-cmd-p untuk pindah ke previous-item .

• Jika Anda adalah pengguna vim-mode-plus, Anda dapat menggunakan tab dan shift-tab .

5. Anda dapat menutup narrow-editor dengan ctrl-g (tidak perlu memfokuskan narrow-editor ).
6. Jika Anda ingin mengubah Query, Anda harus fokus pada narrow-editor

• Gunakan ctrl-cmd-f ( narrow:focus ) untuk memfokuskan narrow-editor .
• Gunakan ctrl-cmd-i ( narrow:focus-prompt ) untuk secara langsung memfokuskan baris cepat permintaan editor sempit.
• Kedua perintah tersedia dari luar/di dalam editor sempit.

7. Keymaps navigasi ini tersedia untuk semua penyedia (misalnya search , fold dll).

Langkah3. Langsung-Edit

Direct-Edit adalah fitur "Edit pada narrow-editor lalu simpan ke file nyata".
Tersedia untuk penyedia berikut.

• scan
• search
• atom-scan

️ Operasi ini berbahaya, karena Anda dapat memperbarui beberapa file sekaligus. ️ Anda harus cukup berhati -hati untuk menggunakan fitur ini, jangan gunakan ini tanpa memahami apa yang Anda lakukan. ️ Saya bisa meminta maaf, tetapi saya tidak dapat memulihkan file untuk Anda.

1. Buka file dari proyek, tempatkan kursor untuk nama variabel hello
2. Kemudian panggil Narrow Search By Current Word .
3. Semua item hello yang cocok muncul di editor sempit.
4. Jika Anda mau, Anda dapat lebih mempersempit dengan kueri.
5. Kemudian edit teks editor sempit secara langsung .

• Tempatkan kursor di hello . Kemudian ctrl-cmd-g ( find-and-replace:select-all ), lalu ketik world .

6. Invoke Narrow Ui: Update Real File dari Palette perintah.
7. Selesai, perubahan yang Anda buat pada item editor sempit diterapkan pada file nyata (dan disimpan).
8. Anda dapat membatalkan perubahan dengan mengedit kembali item pada editor sempit dan menampilkan kembali perubahan dengan Narrow Ui: Update Real File .

Langkah4. [Eksperimental] Kata kunci pencarian dengan mouse

1. Atur Search.startByDoubleClick ke true dari pengaturan-pandangan.
2. Kata kunci klik dua kali di editor.
3. Setiap kali Anda mengklik dua kali kata kunci, editor sempit baru terbuka dan yang lama diganti.
4. Anda dapat melanjutkan klik dua kali editor yang pernah sempit atau editor normal.

Perintah

Tersedia di semua editor teks

Lainnya

• narrow:focus : ( ctrl-cmd-f ) Fokus ke narrow-editor , jika dieksekusi dalam narrow-editor , fokus kembali pada editor asli.
• narrow:focus-prompt : ( ctrl-cmd-i ) Fokus untuk prompt input kueri narrow-editor , jika dieksekusi dalam narrow-editor , fokus kembali pada editor asli.
• narrow:refresh : Segarkan item secara manual dalam narrow-editor .
• narrow:close : ( ctrl-g ) Tutup saat ini dibuka narrow-editor satu per satu.
• narrow:next-item : ( ctrl-cmd-n ) Pindahkan kursor ke posisi-item berikutnya.
• narrow:previous-item : ( ctrl-cmd-p ) Pindahkan kursor ke posisi item sebelumnya.
• narrow:reopen : (Tidak ada keymap default) Buka kembali editor sempit tertutup hingga 10 tertutup baru -baru ini.
• narrow:query-current-word : ( ctrl-cmd-e ) Ganti permintaan narrow-editor aktif dengan kata kursor.
• narrow:previous-query-history : ( ctrl-cmd-[ ) Ganti kueri narrow-editor aktif dengan entri sejarah sebelumnya.
• narrow:next-query-history : ( ctrl-cmd-] ) Ganti permintaan narrow-editor aktif dengan entri sejarah berikutnya.

Menerapkan penyediaan yang sempit

Tidak ada keymaps yang disediakan

• narrow:scan
• narrow:scan-by-current-word
• narrow:fold
• narrow:fold-by-current-word
• narrow:search : AG Search. Perlu diinstal sendiri.
• 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

Tersedia dalam editor sempit (UI sempit)

!vmp diikuti oleh keymap berarti "Keymap mana yang tidak tersedia untuk pengguna vim-mode-plus".
Jika Anda ingin menggunakan keymap ini dengan vim-mode-plus , atur sendiri.
Lihat Wiki

• core:confirm : ( enter ) Tutup narrow-editor
• narrow-ui:confirm-keep-open : Tetap Buka narrow-editor
• narrow-ui:open-here : Barang terbuka di panel yang sama dari panel UI.
• narrow-ui:preview-item : Pratinjau item yang dipilih saat ini secara manual (Anda tidak perlu dalam kebanyakan kasus).
• narrow-ui:preview-next-item : ( tab ) Pratinjau-item Next-item tanpa menggerakkan kursor dari prompt narrow-editor .
• narrow-ui:preview-previous-item : ( shift-tab ) Pratinjau-item Next tanpa menggerakkan kursor dari permintaan narrow-editor .
• narrow-ui:toggle-auto-preview : ( ctrl-r untuk pengguna non-mode-plus) menonaktifkan/mengaktifkan preview otomatis untuk narrow-editor ini.
• narrow-ui:move-to-prompt : ctrl-cmd-i
• narrow-ui:stop-insert : escape
• narrow-ui:update-real-file : Terapkan perubahan yang dibuat di narrow-editor ke file nyata. (Sunting di narrow-editor kemudian simpan ke file nyata.)
• narrow-ui:protect : Tidak ada keymap secara default, lindungi editor sempit dari dihancurkan oleh narrow:close ( ctrl-g ).
• narrow-ui:exclude-file : backspace , mengecualikan item yang cocok dengan filepath dari item yang saat ini dipilih.
• narrow-ui:clear-excluded-files : ctrl-backspace , daftar file yang dikecualikan.
• narrow-ui:select-files : cmd-backspace , pilih secara interaktif item FilePath mana yang muncul di 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 : Tidak ada keymap secara default, sakelar lokasi di mana UI dibuka antara ruang kerja center dan dermaga bottom .

Keymaps

Tidak ada keymap untuk memohon penyedia sempit (mis. narrow:scan ).
Mulailah dari Palette Command atau atur keymap di keymap.cson .

️ Keymap default belum diselesaikan, ini kemungkinan akan berubah dalam versi mendatang.

KEYMAP saya (pengguna vim-mode-plus) dan konfigurasi

config.cson

  narrow :
    SelectFiles :
      rememberQuery : true
    confirmOnUpdateRealFile : false 

keymap.cson

Penjelasan tentang keymap saya.

• cmd-f : Untuk fokus pada editor sempit dan fokus ke editor asli
• cmd-i : Untuk fokus pada prompt dan fokus editor sempit untuk editor asli
• cmd-e :
  • Ketika ruang kerja tidak memiliki narrow-edior di ruang kerja: Mulai narrow:search-by-current-word .
  • Ketika ruang kerja memiliki setidaknya satu narrow-edior : query-current-word (secara default keymap).
    • Ganti kueri narrow-edior yang aktif dengan kata-kata kursor.
• cmd-[ : narrow:previous-query-history History Sebelumnya
• cmd-] : narrow:next-query-history , Recall Next History
• ctrl-g : Tutup narrow-editor dari mana saja.
• tab , shift-tab : Untuk pindah ke item berikutnya/sebelumnya.
• ; : Konfirmasi item saat ini tanpa menutup narrow-editor , saya dapat menutup narrow-editor dengan 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 '

Konfigurasi yang disarankan untuk paket lain.

• Tekan popup AutoComplete-plus pada editor sempit
• Nonaktifkan pencarian sorotan vim-mode-plus tentang editor sempit

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

Catatan untuk pengguna vim-mode-plus

️ Batasan: Untuk kompatibilitas dengan vim-mode-plus.

• Jika Anda menggunakan atom v1.16.0 atau lebih,
  • Jangan Aktifkan vim-mode-plus.automaticallyEscapeInsertModeOnActivePaneItemChange
  • Jika Anda diaktifkan, setiap input kueri pada editor sempit penyedia search menyebabkan perubahan mode dari insert-mode ke normal-mode .
• Jika Anda menggunakan Atom v1.17.0 atau lebih tua (saat ini dalam beta).
  • Keterbatasan ini tidak ada lagi.

Keymap

Pelajari KeyMap tersedia sebagai default.
misalnya Anda dapat pindah ke item berikutnya atau sebelumnya dengan tab , shift-tab (agar ini berfungsi, Anda memerlukan vim-mode-plus v0.81.0 atau lebih baru).

Mulai sempit dari bentuk input pencarian vim-mode-plus

Jika Anda adalah pengguna vim-mode-plus. Perintah berikut tersedia dari mini-editor pencarian ( / atau ? ) VIM-Mode ( / atau?).

• 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

Cara mengedit area item untuk edit langsung.

• Di editor sempit, i , a dalam kursor bergerak normal-mode ke jalur yang cepat.
• Jadi, ketika Anda ingin mengedit item itu sendiri untuk direct-edit dan update-real-file Gunakan kunci lain untuk memasukkan insert-mode .
• I sengaja dipetakan ke vim-mode-plus:activate-insert-mode yang biasanya dipetakan ke i .
  • Yang mungkin tidak intuitif, tapi saya ingin membuat mutasi item agak sulit. Jadi pengguna harus mengetik I .
• Selain I , Anda dapat mulai insert-mode oleh A , c dll.

Q&A

Penyedia apa yang Anda gunakan dengan serius?

Dalam pengeditan harian, saya menggunakan.

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

Mengapa saya tidak menggunakan orang lain? Alasan ada di sini.

• fold : Karena itu mirip dengan symbols .
• atom-scan : Ini disediakan untuk pengguna Windows yang tidak dapat menggunakan search (perlu ag atau rg ).

Memperhatikan saya dapat menutup narrow-editor dengan cmd-w normal ( core:close ). Mengapa saya membutuhkan narrow:close ? Apa bedanya?

Perbedaan terbesar adalah narrow:close keadaan editor pemulihan (scrolltop, lipat, item panel aktif) jika pengguna hanya preview dari startup.

• narrow:close : Tutup narrow-editor dan kembalikan status editor jika perlu. Juga dapat menutup narrow-editor terlepas dari editor aktif saat ini.
• core:close : Hancurkan narrow-editor .

Gunakan mana pun yang Anda inginkan. Saya biasanya menggunakan narrow:close dan sesekali menggunakan core:close seperti ketika saya ingin memfokuskan next-pane-item narrow-editor (jadi tidak ingin mengembalikan fokus untuk mempersempit editor yang diinisiasi).

Bagaimana saya bisa mengecualikan file tertentu dari narrow:search

Gunakan backspace pada item

• Gunakan backspace untuk mengecualikan file tertentu dari hasil.
• ctrl-backspace Clear Excuded File List dan Refresh
• Keymaps ini tersedia di narrow-editor dan Anda berada di read-only-mode

Gunakan Penyedia select-files

• Anda dapat meluncurkan select-files by cmd-backspace atau mengklik folder-icon di Control-Bar .

1. Cari editor dengan narrow:search , Anda melihat banyak item editor mesin editor
2. Tetapi Anda ingin mengecualikan item dalam file Markdown?

• Luncurkan select-files , semua jalur file terdaftar sebagai item.
• Kemudian ketik md pada kueri, Anda melihat Markdown Filepath yang Macheed md .
• Lalu tambahkan ! , sekarang pertanyaan Anda adalah md! , ini diperlakukan karena semua file yang tidak cocok md .
• enter untuk mengonfirmasi.

3. Anda melihat item dengan item dalam file Markdown dikecualikan.
4. Anda dapat membasmi kembali file untuk dikecualikan dengan meluncurkan kembali select-files .

• misalnya untuk mengecualikan folder spec , Anda dapat menambahkan spec/! sebagai kueri.
• misalnya hanya untuk memasukkan file .js , Anda dapat mengatur kueri ke .js .

Ingin melompat ke next-file , previous-file

• Gunakan n , p dalam mode read-only .

Saya ingin narrow:symbols selalu muncul di panel paling kanan dan tidak ingin menutup.

1. Buka narrow:symbols (atau mungkin Anda ingin menggunakan narrow:fold )
2. Pindahkan narrow-editor ini dengan drag dan jatuhkan ke tempat yang Anda inginkan.
3. Dari Command-Palette, jalankan Narrow Ui: Protect . Sekarang narrow-editor dilindungi.
4. narrow-editor yang dilindungi tidak ditutup oleh ctrl-g ( narrow:close ), dan tidak ditutup dengan konfirmasi oleh enter .
5. Untuk menutup, gunakan tombol cmd-w atau tutup normal pada tab.