dict-popup.nvim

A simple plugin for the Linux command dict which shows the definitions in a popup. (vim9script version)

Features

center and cursor popups
ex command: :Dict {word} (center)
normal mode: lookup current word (cursor)
visual mode: lookup selection (cursor)
dict filetype and accompanying syntax
in-buffer sudo jumplist

Install

Command

sudo apt install dictd
# or
sudo dnf install dictd

# extra dictionaries
sudo apt install dict-jargon dict-vera

Note: Syntax tested with gcide (default), jargon and vera

Plugin

https://github.com/folke/lazy.nvim

{
    "Nealium/dict-popup.nvim",
    opts = {
        normal_mapping = nil, -- disable
        visual_mapping = "<Leader>h",
        visual_reg = "*",
        stack = false,
    },
}

Notes:

Setting normal_mapping or visual_mapping to nil (actual nil, not a string), or leaving the keys out all together, will disable the mapping.
Setting stack to true will open up a cursor popup on top of a center popup instead of the default behavior which is to overwrite the center popup's contents. This may lead you with the center popup open and unfocused, to refocus do <C-w><C-w>- in some situations this won't work and you are on your own!

Dict buffer keymaps

<ESC> and q close popup
} next definition
{ previous definition
<C-O> next in search jumplist
<C-I> and <TAB> previous in search jumplist
<C-]> search current word
if stacked, <C-W> close popup

Keymaps can be changed through the opts key buffer_mappings:

{
    "Nealium/dict-popup.nvim",
    opts = {
        normal_mapping = "<Leader>h",
        visual_mapping = "<Leader>h",
        visual_reg = "*",
        stack = false,
        buffer_mappings = { -- defaults
            close = { "<Esc>", "q" },
            next_definition = { "}" },
            previous_definition = { "{" },
            jump_back = { "<C-o>" },
            jump_forward = { "<C-i>", "<Tab>" },
            jump_definition = { "<C-]>" },
        },
    },
}

TODO

Proper config & setup
Center popup for :Dict command
Ability to call dict.Cursor inside of a dict popup and have it overwrite the current contents
Colors set in config