harpoon

⇁ HARPOON 2

Ini tidak berlaku lagi dan semua perubahan di masa depan akan dilakukan pada cabang harpoon2 .

Harpun 2

STATUS : Bergabung ke jalur utama 20 April atau 9 Juni (bagus)

---

README Harpoon Warisan

Seruit

Membawa Anda ke tempat yang Anda inginkan dengan penekanan tombol paling sedikit.

-- gambar disediakan oleh Bob Rust

⇁ WIP

Ini belum matang sepenuhnya, meski digunakan oleh beberapa orang. Jika Anda mengalami masalah apa pun, lihat beberapa peningkatan yang menurut Anda luar biasa, atau sekadar mendapat masukan untuk harpun (atau saya), buatlah masalah!

⇁ Masalah:

1. Anda sedang mengerjakan basis kode. sedang, besar, kecil, apa saja. Anda sering mengunjungi sekumpulan kecil file dan bosan menggunakan fuzzy finder, :bnext & :bprev menjadi terlalu berulang, file alternatif tidak cukup, dll.
2. Anda ingin menjalankan beberapa perintah khusus proyek atau memiliki sejumlah terminal persisten yang dapat dinavigasi dengan mudah.

⇁ Solusi:

1. Kemampuan untuk menentukan, atau dengan cepat, menandai dan membuat penekanan tombol yang tetap untuk membuka file yang Anda inginkan.
2. Terminal dan navigasi tidak terbatas.

⇁ Instalasi

• neovim 0.5.0+ diperlukan
• instal menggunakan pengelola plugin favorit Anda ( vim-plug dalam contoh ini)

Plug ' nvim-lua/plenary.nvim ' " don't forget to add this one if you don't have it yet!
Plug ' ThePrimeagen/harpoon ' 

⇁ Menombak

di sini kami akan menjelaskan cara menggunakan kekuatan tombak:

Tanda

Anda menandai file yang ingin Anda kunjungi lagi nanti

: lua require ( " harpoon.mark " ). add_file ()

Navigasi Berkas

lihat semua tanda proyek dengan:

: lua require ( " harpoon.ui " ). toggle_quick_menu ()

Anda dapat naik dan turun daftar, memasukkan, menghapus, atau menyusun ulang. q dan <ESC> keluar dan simpan menu

Anda juga dapat beralih ke tanda apa pun tanpa membuka menu, gunakan yang di bawah ini dengan indeks tanda yang diinginkan

: lua require ( " harpoon.ui " ). nav_file ( 3 )                  -- navigates to file 3

Anda juga dapat memutar daftar di kedua arah

: lua require ( " harpoon.ui " ). nav_next ()                   -- navigates to next mark
: lua require ( " harpoon.ui " ). nav_prev ()                   -- navigates to previous mark

dari menu cepat, buka file di: pemisahan vertikal dengan kontrol+v, pemisahan horizontal dengan kontrol+x, tab baru dengan kontrol+t

Navigasi Terminal

ini berfungsi seperti navigasi file kecuali jika tidak ada terminal pada indeks yang ditentukan, terminal baru akan dibuat.

 lua require ( " harpoon.term " ). gotoTerminal ( 1 )             -- navigates to term 1

Perintah ke Terminal

perintah dapat dikirim ke terminal mana pun

 lua require ( " harpoon.term " ). sendCommand ( 1 , " ls -La " )    -- sends ls -La to tmux window 1

lebih jauh lagi, lebih banyak perintah dapat disimpan untuk nanti dengan cepat

 lua require ( ' harpoon.cmd-ui ' ). toggle_quick_menu ()       -- shows the commands menu
lua require ( " harpoon.term " ). sendCommand ( 1 , 1 )           -- sends command 1 to term 1

Dukungan Tmux

tmux langsung didukung dan dapat digunakan sebagai pengganti terminal normal hanya dengan mengganti 'term' with 'tmux' seperti itu

 lua require ( " harpoon.tmux " ). gotoTerminal ( 1 )             -- goes to the first tmux window
lua require ( " harpoon.tmux " ). sendCommand ( 1 , " ls -La " )    -- sends ls -La to tmux window 1
lua require ( " harpoon.tmux " ). sendCommand ( 1 , 1 )           -- sends command 1 to tmux window 1

sendCommand dan goToTerminal juga menerima pengenal panel tmux yang valid.

 lua require ( " harpoon.tmux " ). gotoTerminal ( " {down-of} " )   -- focus the pane directly below
lua require ( " harpoon.tmux " ). sendCommand ( " %3 " , " ls " )     -- send a command to the pane with id '%3'

Setelah Anda beralih ke jendela tmux Anda selalu dapat beralih kembali ke neovim, ini adalah skrip bash kecil yang akan beralih ke jendela yang menjalankan neovim.

Di tmux.conf Anda (atau di mana pun Anda memiliki keybinds), tambahkan ini

bind-key -r G run-shell " path-to-harpoon/harpoon/scripts/tmux/switch-back-to-nvim "

Dukungan Teleskop

Daftarkan harpun pertama sebagai perpanjangan teleskop

 require ( " telescope " ). load_extension ( ' harpoon ' )

saat ini hanya tanda yang didukung di teleskop

 :Telescope harpoon marks

⇁ Konfigurasi

jika ingin mengkonfigurasi harpoon, hal itu harus dilakukan melalui fungsi pengaturan harpoon

 require ( " harpoon " ). setup ({ ... })

Pengaturan Global

berikut adalah semua pengaturan global yang tersedia dengan nilai defaultnya

 global_settings = {
    -- sets the marks upon calling `toggle` on the ui, instead of require `:w`.
    save_on_toggle = false ,

    -- saves the harpoon file upon every change. disabling is unrecommended.
    save_on_change = true ,

    -- sets harpoon to run the command immediately as it's passed to the terminal when calling `sendCommand`.
    enter_on_sendcmd = false ,

    -- closes any tmux windows harpoon that harpoon creates when you close Neovim.
    tmux_autoclose_windows = false ,

    -- filetypes that you want to prevent from adding to the harpoon list menu.
    excluded_filetypes = { " harpoon " },

    -- set marks specific to each git branch inside git repository
    mark_branch = false ,

    -- enable tabline with harpoon marks
    tabline = false ,
    tabline_prefix = "   " ,
    tabline_suffix = "   " ,
}

Perintah Terminal yang telah dikonfigurasi sebelumnya

untuk melakukan prakonfigurasi perintah terminal untuk digunakan nanti

 projects = {
    -- Yes $HOME works
    [ " $HOME/personal/vim-with-me/server " ] = {
        term = {
            cmds = {
                " ./env && npx ts-node src/index.ts "
            }
        }
    }
}

⇁ Pencatatan

• log ditulis ke harpoon.log dalam jalur cache nvim ( :echo stdpath("cache") )
• level log yang tersedia adalah trace , debug , info , warn , error , atau fatal . warn adalah default
• level log dapat diatur dengan vim.g.harpoon_log_level (harus sebelum setup() )
• meluncurkan nvim dengan HARPOON_LOG=debug nvim lebih diutamakan daripada vim.g.harpoon_log_level .
• nilai yang tidak valid default kembali untuk warn .

⇁ Lainnya

Apa perbedaan tanda Harpoon dengan tanda global vim

keduanya memiliki tujuan yang sama namun tanda tombak berbeda dalam beberapa hal utama:

1. Mereka secara otomatis memperbarui posisinya di dalam file
2. Mereka disimpan per proyek .
3. Mereka dapat diedit secara manual atau diganti (menukarnya lebih mudah)

Motivasi di balik terminal Harpoon

1. Saya ingin menggunakan terminal karena saya dapat melakukan gF dan gF terhadap kesalahan apa pun yang timbul dari eksekusi yang ada di dalam terminal yang tidak sesuai untuk sesuatu seperti pengiriman. (tidak hanya menjalankan pengujian tetapi mungkin server yang berjalan selama X waktu sebelum mogok).
2. Saya ingin terminal tetap gigih dan saya dapat kembali ke salah satu dari banyak terminal dengan sedikit keajaiban dan memilah ulang informasi eksekusi apa pun yang belum tentu terkait dengan kesalahan.
3. Saya ingin memiliki perintah yang dapat diikat ke terminal dan mengirimkannya tanpa banyak berpikir. Semacam jalan tengah antara vim-test dan hanya mengetikkannya ke terminal (mengonfigurasi proyek televisi Netflix tidak cukup rumit dan ada banyak cara untuk mengonfigurasinya).

Gunakan lebar dinamis untuk menu popup Harpoon

Terkadang lebar default 60 tidak cukup lebar. Contoh berikut menunjukkan cara mengonfigurasi lebar khusus dengan mengatur lebar menu relatif terhadap lebar jendela saat ini.

 require ( " harpoon " ). setup ({
    menu = {
        width = vim . api . nvim_win_get_width ( 0 ) - 4 ,
    }
})

Tabel

Secara default, tabline akan menggunakan tema default tema Anda. Anda dapat menyesuaikan dengan mengedit sorotan berikut:

• HarpoonTidak Aktif
• Harpoon Aktif
• HarpoonNumberAktif
• HarpoonNumberTidak aktif

Contoh untuk membuatnya lebih bersih:

 vim . cmd ( ' highlight! HarpoonInactive guibg=NONE guifg=#63698c ' )
vim . cmd ( ' highlight! HarpoonActive guibg=NONE guifg=white ' )
vim . cmd ( ' highlight! HarpoonNumberActive guibg=NONE guifg=#7aa2f7 ' )
vim . cmd ( ' highlight! HarpoonNumberInactive guibg=NONE guifg=#7aa2f7 ' )
vim . cmd ( ' highlight! TabLineFill guibg=NONE guifg=white ' )

Hasil:

⇁ Sosial

Untuk pertanyaan tentang Harpoon, ada saluran #harpoon di server Discord Primeagen.

• Perselisihan
• Berkedut
• Twitter