Cara Install Toggleterm.nvim - Terminal untuk Neovim

Meskipun neovim sudah menyediakan terminal bawaan (gunakan :terminal untuk membuka), toggleterm sangat membantu kita dalam mengelola terminal.

Toggleterm.nvim adalah plugin neovim untuk manajemen terminal yang memungkinkan kita untuk mengelola, melakukan kustomisasi, dan membuka atau membuat beberapa jendela terminal dengan mudah.

Dokumentasi lengkap, contoh dan cara penggunaanya bisa dilihat pada repo: Toggleterm.nvim. Untuk contoh instalasi dan konfigurasinya di neovim akan dijelaskan di bawah.

Instalasi

Plugin manager yang digunakan dalam contoh disini adalah Packer.nvim. Silahkan sesuaikan apabila menggunakan plugin manager yang berbeda. Sedangkan struktur file / letak file konfigurasi plugin mengunakan wahyunanangwidodo/nvim.

Pada file konfigurasi daftar plugin, silakan tambahkan di bawah ini. Silakan sesuaikan lokasi 'config.toggleterm' untuk lokasi konfigurasi toggleterm yang akan dipanggil.

use {
   'akinsho/toggleterm.nvim',
   config = function()
      require('config.toggleterm')
   end,
}  

Kemudian, silakan buat file toggleterm.lua di direktori config / plugins, copas konfigurasi toggleterm di bawah ini.

local ok, toggleterm = pcall(require, 'toggleterm')
if not ok then
    return
end

toggleterm.setup {
    size = function(term)
        if term.direction == 'horizontal' then
            return 15
        elseif term.direction == 'vertical' then
            return math.floor(vim.o.columns * 0.4)
        end
    end,
    direction = 'horizontal', 
    open_mapping = [[<c-\>]],
    start_in_insert = true,
    insert_mappings = false,
    shade_filetypes = { 'none' }, 
}

Terakhir, jalankan perintah Packer di bawah ini.

:PackerInstall

:PackerCompile

Penggunaan

Setelah compling selesai, silakan muat ulang atau restart editor vim terlebih dahulu, atau gunakan :so %.

Untuk membuka terminal, gunakan ctrl + \. Untuk split, atau membuka banyak terminal / jendela, pastikan dalam mode normal terlebih dahulu (ESC), kemudian tekan angka lalu <open_mapping>. Contoh membuka termial ke 2: 2 ctrl + \.

Pengaturan Shell

Kita bisa merubah shell default atau bawaan toogleterm jika ingin menggunakan yang lain. Silakan tambahkan di bawah ini pada file pengaturan konfigurasi editor vim(neovim).

vim.cmd([[
set shell=pwsh
set shellcmdflag=-command
set shellquote=\"
set shellxquote=
]])

#atau
if vim.fn.has "win32" == 1 then
    vim.o.shell = "pwsh"
end

pwsh adalah PowerShell, silakan ubah sesuai yang ingin digunakan.

Selesai

Instalasi dan pengaturan konfigurasi toggleterm.nvim di neovim telah selesai. Silakan buka dokumentasi dan coba lakukan perubahan-perubahan yang diinginkan.

Kita sampai disini. Berikut adalah contoh hasilnya:

Rekomendasi plugin: Telescope.nvim: Pencarian File Fuzzy untuk Neovim.