A collection of miscellaneous .files ("dot" files) and some regular files. Files can be saved anywhere in the repository, and symlinked to the actual files in their correct different locations on the system.
Heavily influenced by https://github.com/mathiasbynens/dotfiles and https://github.com/orrsella/dotfiles
Noteworthy:
links– The list of files to manageinstall– Setup symlinks based onlinksremove– Destroy symlinks by copying .files over themosx– Some OS X configuration (based on .osx)
Clone to a local directory, like ~/.dotfiles:
$ cd ~
$ git clone https://github.com/mawie81/dotfiles.git .dotfiles
$ cd .dotfiles/IMPORTANT: This will override all existing files with a symlink to the new repository, losing anything you have in current files. If you have any important configuration in current .files, make sure to first save it to the cloned repo, and only then run the script:
$ ./installRun ./osx for some sane OS X config settings.
If you decide you don't want the symlinks anymore, and want the full files in the right locations, run:
$ ./removeThis will copy every file from ~/.dotfiles to its respective place, overriding the symlinks.
To add a new .file (or any other config file for that matter):
-
Copy the existing file to anywhere in the repo, chose the most logical path (the place you save the file in the repo doesn't have to correspond to the actual real path on the system where the original file is – chose whatever's most convenient for you). It makes sense to group multiple related files into appropriately named folders. File names must be identical to the actual ones on the system.
-
Add a new entry to the
linksfile. The format is:
/path/on/system/.my-file1, /path/in/repo/.my-file1
/path/on/system/with\ space/.my-file2 /path/in/repo/.my-file2
See links for more details and examples.
When setting up a new Mac, you may want to install some common Homebrew formulae (after installing Homebrew, of course):
./brew.sh