dotfiles

What is this?

These are Jim's shell configuration dot files. The goal is to increase CLI productivity on Linux (mainly Ubuntu) and OSX, though many scripts run just fine on any POSIX implementation.

Focus

The focus is on Zsh support. This used to work with Bash, but I switched and don't support that any more.

Inspirations

The contents of this repo are based on Matthew McCullough's original. Other bits have been added over the years.

Acquiring This Repo

This project contains submodules. It is suggested that you clone this into your home directory, as follows.

> cd ~
> git clone --recurse-submodules https://github.com/jimlawton/dotfiles

Setup

Personalisation settings are in personalisation. Replace the values with your own.

There is a set up script that establishes the symlinks in your home directory. Run this:

> ~/dotfiles/_setupdotfiles.sh

This will attempt to set up symlinks to the relevant dot files from your home directory. In the event of files already existing in your home directory, it will warn and skip them. Carefully check the warnings, and when you are happy to proceed, do:

> MOVE=true ~/dotfiles/_setupdotfiles.sh

NOTE: Some of my personal configuration will remain after setup. You should fork and tweak to your specific needs.

Non-automated, non-captured config

Reminder-to-self: Some additional personalization lives in the ~/.config/ directory. Specifically, the ~/.config/gh/config.yml file for gh. It is not yet in scope for capture or copy, but some users have shared their configuration in a Gist.

Contributions

Contributions are always welcome in the form of pull requests with explanatory comments.