tagbar

TagBar: Penampil Garis Besar Kelas untuk VIM

Tagbar apa itu

TagBar adalah plugin VIM yang menyediakan cara mudah untuk menelusuri tag file saat ini dan mendapatkan gambaran umum dari strukturnya. Ini melakukan ini dengan membuat bilah samping yang menampilkan tag yang dihasilkan Ctags dari file saat ini, dipesan oleh ruang lingkup mereka. Ini berarti bahwa misalnya metode dalam C ++ ditampilkan di bawah kelas tempat mereka didefinisikan.

Tagbar apa yang tidak

TagBar bukan alat tujuan umum untuk mengelola file tags . Ini hanya membuat tag yang dibutuhkan dalam memori-memori tanpa membuat file apa pun. tags Manajemen File disediakan oleh plugin lain, seperti misalnya Gutentags.

Dependensi

• Vim> = 7.3.1058 atau versi neovim apa pun.

• Implementasi CTAGS: Kami sangat merekomendasikan versi ctag universal apa pun. Ini adalah garpu CTAG yang bersemangat dengan banyak perbaikan bug, dukungan untuk lebih banyak format, dan dukungan unicode yang tepat.

  CTAGs yang bersemangat 5.5 atau lebih tinggi pada tingkat tertentu tetapi pada akhirnya akan sudah usang.

  Beberapa format tambahan juga dapat ditangani oleh penyedia lain seperti JSCTAGS atau PHPCTAGS.

Instalasi

Ekstrak arsip atau klon repositori ke dalam direktori di 'runtimepath' Anda, atau gunakan manajer plugin pilihan Anda seperti patogen. Jangan lupa untuk menjalankan :helptags Jika manajer plugin Anda tidak melakukannya untuk Anda sehingga Anda dapat mengakses dokumentasi dengan :help tagbar .

Jika CTAGS dieksekusi tidak diinstal di salah satu direktori dalam variabel lingkungan $PATH Anda, Anda harus mengatur variabel g:tagbar_ctags_bin , lihat dokumentasi untuk info lebih lanjut.

QuickStart

Letakkan sesuatu seperti berikut ini ke ~/.vimrc Anda:

 nmap <F8> :TagbarToggle <CR>

Jika Anda melakukan ini, kunci F8 akan beralih ke jendela tagbar. Anda tentu saja dapat menggunakan jalan pintas apa pun yang Anda inginkan. Untuk cara yang lebih fleksibel untuk membuka dan menutup jendela (dan sisa fungsionalitas) lihat dokumentasi menggunakan :help tagbar .

Dukungan untuk filetypes tambahan

Untuk filetypes yang tidak didukung oleh CTAG yang bersemangat, periksa wiki untuk melihat apakah proyek lain menawarkan dukungan untuk mereka dan bagaimana menggunakannya. Harap tambahkan proyek/konfigurasi lain yang Anda temukan atau buat sendiri sehingga orang lain juga dapat memperoleh manfaat darinya.

Catatan: Jika tampilan struktur file salah

Jika Anda melihat bahwa ada beberapa kesalahan dalam cara struktur file Anda ditampilkan di tagbar, pastikan bug itu sebenarnya ada di tagbar sebelum Anda melaporkan masalah. Karena TagBar menggunakan CTAGS yang bersemangat dan program yang kompatibel untuk melakukan penguraian file yang sebenarnya, ada kemungkinan bahwa bug sebenarnya dalam program yang bertanggung jawab untuk filetype itu sebagai gantinya.

Ada contoh di :h tagbar-issues tentang cara menjalankan CTAG secara manual sehingga Anda dapat menentukan di mana bug itu sebenarnya. Jika bug benar -benar ada di CTAG, silakan laporkan di situs web mereka sebagai gantinya, karena tidak ada yang bisa saya lakukan di Tagbar. Terima kasih!

Anda juga dapat melihat bug CTAGS yang sebelumnya telah diajukan terhadap Tagbar.

Tangkapan layar

Lisensi

TagBar didistribusikan berdasarkan ketentuan lisensi VIM , lihat file lisensi yang disertakan.

Kontributor

Tagbar awalnya ditulis oleh Jan Larres. Ini secara aktif dikelola oleh Caleb Maclennan dan David Hegland. Setidaknya 75 lainnya telah menyumbangkan fitur dan perbaikan bug selama bertahun -tahun. Harap dokumentasikan masalah atau kirimkan permintaan tarik di GitHub.