Quarto Nvim Kickstarter

Companion to https://github.com/quarto-dev/quarto-nvim.

This requires Neovim >= v0.9.5 (https://github.com/neovim/neovim/releases/tag/stable)

Videos

Check out this playlist for a full guide and walkthrough: https://youtube.com/playlist?list=PLabWm-zCaD1axcMGvf7wFxJz8FZmyHSJ7

Setup

Clone this repo into ~/.config/nvim/ or copy-paste just the parts you like.

If you already have your own configuration, check out lua/plugins/quarto.lua for the configuration of plugins directly relevant to your Quarto experience. The comments in this file will also point to to other plugins required for the full functionality.

This configuration can make use of a "Nerd Font" for icons and symbols. Download one here: https://www.nerdfonts.com/ and set it as your terminal font.

Unix, Linux Installation

git clone https://github.com/jmbuhr/quarto-nvim-kickstarter.git ~/.config/nvim

For displaying images in your terminal a recent version of kitty or wezterm is required as well as the dependecies of image.nvim (see ./lua/plugins/ui.lua). Additionally, if you plan to use this through tmux make sure to have version >= 3.3a.

If you are unable to install those in your enviroment, disable the plugin by setting enabled = false.

Example dependencies install on ubuntu-based systems:

sudo apt install imagemagick
sudo apt install libmagickwand-dev
sudo apt install liblua5.1-0-dev
sudo apt install luajit
sudo apt install tree-sitter-cli

Manually installing luarocks and the magick rock is no longer required, this is handled by luarocks.nvim.

[!NOTE] Do this before opening nvim, otherwise luarocks.nvim might pick up the wrong luarocks version. If you forgot this step, you can do :Lazy build luarocks.nvim again manually after installation to fix it.

Windows Powershell Installation

git clone https://github.com/jmbuhr/quarto-nvim-kickstarter.git "$env:LOCALAPPDATA\nvim"

The telescope file finder uses fzf for fuzzy finding via the telescope-fzf-native extension. It will automatically install fzf, but needs some requirements which are not pre-installed on Windows. Check out the previous link for those (or comment out the extension in ./lua/plugins/ui.lua).

Now you are good to go!

Updating

Certain updates to plugins may leave behind unused plugin data. If this configuration produces an error on startup, try removing those first, allowing the lazy.nvim package manager to recreate the correct plugin structure:

rm -r ~/.local/share/nvim
rm -r ~/.local/state/nvim

Screenshots

Use the integrated neovim terminal to execute code chunks: