Dotfiles (James Whitney)

My dotfiles.

How to install

The installation only requires curl, and git to be installed. Pretty much any of your previous files will be backed up to;

$DOTFILES_DIRECTORY/backupes/${date_time}

To actually kick off the instalation run;

$ bash -c "$(curl -fsSL https://raw.github.com/whitneyit/dotfiles/master/bin/dotfiles)"

Windows Subsystem for Linux (WSL)

If you are using WSL, you will need to unmount, then remount the drive with the following command:

$ sudo umount /mnt/c
$ sudo mount -t drvfs C: /mnt/c -o metadata,uid=1000,gid=1000,umask=22,fmask=111

How to update

You should run the update when:

• You want to pull changes from the remote repository.

Run the dotfiles command:

$ dotfiles

Options:

-h, --help	Help
-l, --list	List of additional applications to install

NOTE

For the editorconfig vim plugin to work under cygwin, you need to do the following;

cp /cygdrive/c/Chocolatey/bin/editorconfig ~/
dos2unix ~/editorconfig
mv ~/editorconfig /cygdrive/c/Chocolatey/bin/

This will give the file the correct line endings so that cygwin won't chuch a hissy fit when it tries to run the file

Adding new git submodules

If you want to add more git submodules, e.g., Vim plugins to be managed by pathogen, then follow these steps while in the root of the superproject.

# Add the new submodule
git submodule add https://example.com/remote/path/to/repo.git vim/bundle/one-submodule
# Initialize and clone the submodule
git submodule update --init
# Stage the changes
git add vim/bundle/one-submodule
# Commit the changes
git commit -m "Add a new submodule: one-submodule"

Also, pathogen will create tags for docs if they are not present. This will lead to your submodule always being considered dirty. To get around this, make sure that you edit the .vim/config file and add ignore = dirty to each of the submodule entries. Like so;

[submodule "vim/bundle/emmet-vim"]
    url = https://github.com/mattn/emmet-vim.git
    ignore = dirty

Updating git submodules

Updating individual submodules within the superproject:

# Change to the submodule directory
cd vim/bundle/one-submodule
# Checkout the desired branch (of the submodule)
git checkout master
# Pull from the tip of master (of the submodule - could be any sha or pointer)
git pull origin master
# Go back to main dotfiles repo root
cd ../../..
# Stage the submodule changes
git add vim/bundle/one-submodule
# Commit the submodule changes
git commit -m "Update submodule 'one-submodule' to the latest version"
# Push to a remote repository
git push origin master

Now, if anyone updates their local repository from the remote repository, then using git submodule update will update the submodules (that have been initialized) in their local repository. N.B This will wipe away any local changes made to those submodules.

Acknowledgements

Inspiration and code was taken from many sources, including:

• @necolas (Nicolas Gallagher) https://github.com/necolas/dotfiles
• @sabiddle (Shawn Biddle) https://github.com/shawncplus/dotfiles
• @cowboy (Ben Alman) https://github.com/cowboy/dotfiles