Skip to content

Frequently asked questions

Oliver Caldwell edited this page May 22, 2020 · 12 revisions

The HUD window background colour makes the text unreadable, how can I change it?

Since the HUD is just a regular floating window you can alter the colours with the Pmenu group. Conjure doesn’t pick the colours for you, so some themes may use hard to read contrasts, especially when it comes to comments.

:highlight Pmenu ctermbg=<colour> guibg=<colour>

Can I add another language client?

Yes! By design Conjure supports language modules from inside this repository or in your own plugins. All a language client needs to be is a Lua module with a set of values and functions exposed, you can read all about that in :help conjure-clients.

You can learn a lot by having a read through the existing clients in fnl/conjure/client. Your client doesn’t have to be written in Fennel if it’s in your own repository but I’d highly recommend it. You’ll just have to get to grips with Aniseed.

Feel free to have a chat with me (Olical) about what you’d like to add and how you want to go about doing it. We can work out if it should be a 3rd party plugin or a fork of this repository until it’s time for wider release.

Can I write plugins that hook into Conjure?

Yep! Although what’s available isn’t documented right now so you’ll just have to read through Conjure’s source code and have a play. Some modules you may be interested in are conjure.eval, conjure.client and conjure.extract for example, you can require them from any Fennel or Lua file within Neovim if Conjure is installed.

Have a look through fnl/conjure/**.fnl for what’s available, not an awful lot is private so you’re more than welcome to hook into function calls at your own risk. There’s a chance they could change until I have some sort of stable proxy API.