Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rmm5t/dotfiles

●📄 Ryan McGeary's configuration shiznit that makes him productive
https://github.com/rmm5t/dotfiles

bash dotfiles emacs git tmux

Last synced: 9 days ago
JSON representation

●📄 Ryan McGeary's configuration shiznit that makes him productive

Awesome Lists containing this project

README

        

# Getting Started

Clone this (or a forked version of this) repository.

$ cd ~
$ git clone https://github.com/rmm5t/dotfiles.git .dotfiles

**(Option 1)** If you'd like to symlink everything from this repository to your
home directory, run `install.rb`. This will also sync and update all the git
submodules within.

$ cd ~/.dotfiles
$ ./install.rb

This install script is idempotent, meaning you can run it over and over again
without fear of breaking anything. Use it as an installer or to upgrade after
merging from an upstream fork.

**(Option 2)** If you'd like to just symlink one or more configurations to your
home directory manually, you can. If you take this approach, you'll have to
update all the git submodules manually.

$ cd ~/.dotfiles
$ git submodule sync
$ git submodule update --init --recursive
$ ln -ns emacs ~/.emacs
$ ln -ns emacs.d ~/.emacs.d

**(Option 3)** Just look around and pick and choose what you like for your own
dotfiles.

## Notes

If you'd like to use git and github, be sure to add your own `~/.gitconfig_local` file:

```
[user]
email = [email protected]
name = Your Name
[github]
user = your-github-username
```

## Requirements

* *nix environment (e.g. Mac OS X or Linux)
* Bash version >= 3 (for command line enhancements)
* Emacs version >= 24 (for emacs config and setup)
* Ruby (for the install.rb to work)

## License

[MIT License](https://rmm5t.mit-license.org/)