Nvim Illumination : A lightweight GTK live preview for your notes

An illuminated manuscript is a manuscript in which the text is supplemented with such decoration as initials, borders (marginalia) and miniature illustrations. In the strictest definition, the term refers only to manuscripts decorated with either gold or silver; but in both common usage and modern scholarship, the term refers to any decorated or illustrated manuscript from Western traditions.

From Wikipedia, the free encyclopedia

Nvim Illumination is a simple Neovim plugin to render buffers in a WebKit2Gtk window. Since it uses the Neovim rpc-api to send buffer updates, ⚠️ it will not work with vim ⚠️.

Note that unlike many note rendering plugins Illumination does not render files, it renders your buffer directly via nvim rpc api, it means you don't need to save the current buffer to render your notes, it is really live!

Issues and PRs are welcome!

Intallation

Manual installation

git clone  https://github.com/oknozor/illumination/
cd illumination
./install

Using vim-plug

Requirement

• vim-plug obviously
• Rust with cargo as a package manager
• You need to have $HOME/.cargo/bin/ in your $PATH : you can add the following line in your bashrs, zshrc or /etc/profile : export PATH="$HOME/.cargo/bin:$PATH"

Plug 'oknozor/illumination', { 'dir': '~/.illumination', 'do': '.install.sh' }

Usage

Debug

To debug Illumination start nvim in RPC mode on port 6666 :

nvim test.md --listen 127.0.0.1:6666

Then run Illumination without cargo --release option.

cd illumination
cargo run