Learning to use Conjure
:help conjure opens the conjure documentation in neovim. Use
j to scroll down,
k to scroll up.
:ConjureSchool command will start an interactive tutorial and introduce Conjure's workflow and key mappings
Start a REPL on the command line
practicalli/clojure-deps-edn aliases, run a command line REPL that starts a nrepl server and starts the rebel readline terminal UI
Then open a Clojure file and Conjure will (magically) connect to the running REPL and pop-up a connect message in the top right corner.
Starting a REPL from Vim
Start neovim with a Clojure file, e.g.
nvim src/practialli/playground.clj or run
nvim and open a Clojure file using
:NERDTree. A Clojure file has a name ending in
:Clj command to start a REPL using Clojure CLI Tools
:Lein command to start a REPL using Leiningen
Neovim switches to a terminal state, use
C-\ C-n to leave the terminal state. Use
:previous to switch back to the source code buffer
, c f to connect to the REPL from Conjure, or simply open a Clojure file. Automated connection will be added in a future version on Conjure.
vim-jack-in plugin enables Neovim to call out to Clojure tools or Leiningen to start a REPL and connect to it once its started.
A full screen REPL log is displayed.
, l q to close the log window and return to the Clojure file.
, l v to create a vertical split between code and REPL log,
, l h for a horizontal split.
maplocalleader key set to
, e b evaluates the current buffer
, e f evaluate the code in the file (from the file system)
, e e evaluate the current expression
, e r evaluate top level form (root)
, e ! evaluate current form and replace with result
NOTE: Conjure results appear in a pop-up panel which displays until the cursor is moved. Whilst the pop-up is displaying, it is not possible to quit a file with
:q. Move the cursor or use
g t to change tabs to remove the popup.
Neovim commands and history
: in Vim normal mode to start entering a command, type the start of a command and press
TAB to use command completion.
Shift-TAB navigate the completion menu.
q: to popup a list of recent commands
Multiple files can be opened in Neovim, either as split windows or tabs.
nvim src.clj deps.edn readme.org will open three files in separate tabs
:next to switch to the next tab,
:2next to jump 2 tabs,
:last for the last tab.
:previous to switch to the previous tab
C-^ to toggle to last shown tab
:NERDTreeToggle to show a graphical file manager in a left side split.
NERDTree opens files as splits.
C-w followed by either
jkhl will move the cursor to the split in that direction.
Navigation within projects
g d go to definition of current symbol
General vim commands
:cd changes the current working directory, use by
:lcd ^ but local to the current window
:windo lcd ^ for all windows in the current tab
:pwd prints the current working directory
:e! reloads the current buffer, discarding unsaved changes
:find to search for file names relative to the path option (set path?) and open them.
Install the Deoplete plugin (from Olical configuration)
" Completion support
Plug 'Shougo/deoplete.nvim' | Plug 'ncm2/float-preview.nvim'
:wq to quit neovim.
Run neovim and
:PlugInstall to install all plugins defined in the
Alternative completion plugin: Conquer of Completion - required node.js install
, t n to test the current namespace
<( to slurp and barf, where the angle bracket indicates the direction, and the parenthesis indicates which end to operate on.
Searching through projects
TODO: find equivalents for narrowing, iedit and helm search results editing for vim
Code analysis and idom checking
clj-kondo automatically checks Clojure code at it is typed, providing instant feedback on Clojure syntax and idioms
Linting works continually once the dense/ale plugin and clj-kondo is installed via the 'w0rp/ale' plugin