Basic config to transform your NVIM in a powerful Clojure IDE using fennel, clojure-lsp and conjure.
This project will be archived as the author of Aniseed is making a significant change to how Fennel is used and creating the nfnl project.
A new fennel based configuration based on this is being evaluated to in the future to replace this project.
If you want to test the new setup please check it on cajus-nfnl
A curvy and juicy neovim configuration following the "Keep it simple!" design principle.
Setup config to transform your NVIM in a powerful Clojure IDE using fennel, clojure-lsp and conjure.
Things you need installed in your OS to use this setup
Make sure you backup your current configuration files in $HOME/.config/nvim
BEFORE running this.
Run these commands in the root of this repo:
# Delete the current nvim config
rm -rf $HOME/.config/nvim
# Makes a symbolic link to the files in this repo
ln -sf $PWD/.config/nvim $HOME/.config/nvim
When you start nvim for the first time it will download packer and aniseed and show some errors, thats normal press enter to ignore and go to the nvim console pressing :
and type PackerInstall
.
This will install all plugins declared in fnl/config/plugin.fnl
, after packer's panel showing all the plugins where installed, close nvim and open it again, no errors should show up this time.
Wrapper responsible for two things:
fnl/config/init.fnl
.In this file among other settings I do set the leader key as
space
and local-leader as,
for the sake of the examples of how use this configuration I will use this as basis for the commands.
Here we define the plugins we want packer to download and load for us, we define here a private function called use
which will search in the plugin map for the keyword :mod
and load the namespace defined in its value.
For example in the line we define that we need telescope we have this map:
:nvim-telescope/telescope.nvim {:requires [:nvim-lua/popup.nvim
:nvim-lua/plenary.nvim]
:mod :telescope}
This will state to packer download nvim-telescope/telescope.nvim
and all the required plugins in :requires
and search for the namespace telescope
in file located in the following path fnl/config/plugin/telescope
, where I usually add plugin specific configuration like keymaps and settings.
Conjure specifics settings, I like to remap the doc work keymap to be <localleader>K
instead the only K
, to not conflict with the LSP docs K
.
Settings like ignore node_modules
and everything in .gitignore
to be listed in the file finder.
Keymaps:
<leader>ff
open the find files<leader>fg
open the fuzzy finder<leader>fb
open the find open buffer<leader>fh
open the nvim help fuzzy finderSettings to select which treesitter's features we want enabled and which language extension we want to ensure they will be always installed.
All about nvim's lsp settings and keymaps.
gd
Go to definitionK
Show documentations<leader>ld
Function declarations<leader>lt
Type Definitions<leader>lh
Signature Help<leader>ln
Rename<leader>le
Show line diagnostics<leader>lq
Show all diagnostics information<leader>lf
Auto format<leader>lj
Go to next diagnostic<leader>lk
Go to previous diagnostic<leader>la
Open code actions menu (Using telescope plugin interface)<leader>la
Open code actions menu for the selected text in VISUAL mode (Using telescope plugin interface)<leader>lw
Open workspace diagnostics list (Using telescope plugin interface)<leader>lr
Show all references list for item under the cursor (Using telescope plugin interface)<leader>lr
Show all implementations list for item under the cursor (Using telescope plugin interface)Here settings of which sources we want to show up in the autocomple menu like (conjure, lsp, buffer) and some mapping to navigate in the menu.
Theme settings like style and comment style.
Settings for vim-sexp like enabling it for another lisp languages like Fennel and Jannet
Settings for lualine status line like some theme overides and setting what will be shown in the line.
Some gifs showing how it works.
<leader>ff
on startup
<leader>le
gd
K
/<leader>lh
<leader>lr
<leader>lf
<leader>la
<leader>la
<leader>ln
<localleader>er
<localleader>lv
<localleader>K
Cajus is the Portuguese for cashews, which is a fitting name because the format of its nuts reminded me of a parenthesis.
If you find any dead links, misinformation or any improvements in this documents at all Emails, PRs and Issues are highly encouraged.
This is free and unencumbered software released into the public domain. For more information, please refer to http://unlicense.org