dot/README.md

Dotfiles

Dotfiles configurations for headless Kubuntu linux environments. Be sure to clone recursively if you want to grab updated plugins / submodules included. For example, using Pathogen with Vim to manage plugins requires that the plugin to be installed are cloned to the ~/.vim/bundle/ directory. Cloning recursively allows git to clone these same nested repositories/submodules within this directory so Pathogen can handle running the Vim plugins.

Once installed, editing source code in vim supports features displayed in the screenshot below

Install

Installation instructions -

git clone --recursive https://github.com/shaunrd0/dot
cd dot/
./setup.sh
mv ~/.bashrc ~/.bashrc.backup
stow . -t ~

Docker

You can run these dotfiles in a docker container -

git clone git@github.com:shaunrd0/dot.git
cd dot
docker build -t dot .
docker run -it dot bash

Configurations

Plugin / Tool	Description	Repository
tmux	Terminal multiplexer configured within .tmux.conf and .tmux.d/.	https://github.com/tmux/tmux
tmux plugin manager	Manages tmux plugins directly from GitHub.	https://github.com/tmux-plugins/tpm
tmux-sensible	Provides improved sane defaults for tmux behavior and usability.	https://github.com/tmux-plugins/tmux-sensible
tmux-resurrect	Saves and restores tmux sessions, panes, and layouts between restarts.	https://github.com/tmux-plugins/tmux-resurrect
tmux-continuum	Automatically saves tmux sessions and can restore them on system reboot.	https://github.com/tmux-plugins/tmux-continuum
xclip	Integrates tmux copy mode with the system clipboard under X11.	https://github.com/astrand/xclip

Plugin	Description	Repository
Colorizer	Highlights color codes in Vim buffers (useful for CSS/ web).	https://github.com/chrisbra/Colorizer
ALE	Asynchronous Lint Engine – linting & fixing in Vim asynchronously.	https://github.com/dense-analysis/ale
clang_complete	Auto-completion support for C/C++ using libclang.	https://github.com/xavierd/clang_complete
supertab	Expand completions using <Tab> in insert mode.	https://github.com/ervandew/supertab
unicode.vim	Unicode helpers (insert and inspect Unicode characters).	https://github.com/chrisbra/unicode.vim
vim-airline	Lean and fast status/tabline for Vim.	https://github.com/vim-airline/vim-airline
vim-airline-themes	Additional themes for vim-airline.	https://github.com/vim-airline/vim-airline-themes
vim-signify	Shows VCS (git/hg) changes in the sign column.	https://github.com/mhinz/vim-signify

Tool / File	Description	Repository
ranger	Terminal file manager with Vim-like keybindings & previews.	https://github.com/ranger/ranger
GNU Stow	Manages dotfiles by symlinking grouped configurations.	https://www.gnu.org/software/stow/
.stow-local-ignore	Specifies files/patterns for Stow to skip when linking.	https://www.gnu.org/software/stow/manual/stow.html
setup.sh	Bootstrap script to automate initial symlinking and environment setup.	(Repository-local script)