dotfiles

My config files for Linux. Installation should be as easy as cloning the repo and either:

• linking dotfiles with stow
• using an install script, e.g. ./install_fzf

Going forward I'll be mainly using GNU stow for managing dotfiles, rather than writing custom symlinking scripts for everything. Any remaining install scripts will just be doing things like installing & configuring other tools for you (e.g. cloning github repos, in the case of fzf).

Installation

For the most part, just use GNU stow. For example:

stow -t ~ nvim zsh zsh-sparx

nvim

You may need to uninstall any existing nvim config first:

rm -rf ~/.config/nvim ~/.local/share/nvim

You may need to copy lua/jam/local.sample.lua to lua/jam/local.lua to enable certain system-specific settings (e.g. enable nerd font symbols).

fzf

The install_fzf script just runs the commands needed to clone & set up fzf locally. It's not necessarily required, but is used by zsh & nvim.

Rendering markdown to HTML

Some of my dotfiles have their own markdown files (e.g. nvim). You can render these nicely with, for example:

cd nvim/.config/nvim
pandoc CHEATSHEET.md -s --to=html --toc --css=../../../styles.css -o CHEATSHEET.html

...and view it at file:///path/to/dotfiles/nvim/CHEATSHEET.html.

You can use --embed-resources to embed the styles (change the path to the CSS to be relative to you instead of to the file).

Install packages

Ubuntu

sudo apt install zsh neovim curl git mpv streamlink youtube-dl htop ripgrep stow

Differences on Windows

Ideally use WSL 2 - WSL 1 caused me a bunch of issues (e.g. with nodejs). The new windows terminal app (from MS store) is quite nice, as is WSLtty.

Install neovim in both linux and in Windows (e.g. using chocolatey). This will make win32yank (included in the Windows install) available to neovim in WSL, enabling clipboard support.

Other edge cases

Get a newer neovim version on older Ubuntu versions:

sudo add-apt-repository ppa:neovim-ppa/stable
sudo apt update
sudo apt install neovim