|
| 1 | +Matjaž Dotfiles Repository |
| 2 | +========================== |
| 3 | + |
| 4 | +_a.k.a. yet another dotfiles repo but now with powerful installer scripts_ |
| 5 | + |
| 6 | +Features |
| 7 | +-------- |
| 8 | + |
| 9 | +### Configuration files |
| 10 | + |
| 11 | +- [`zshrc`](zshrc): general |
| 12 | + [_Oh My ZSH!_](https://github.com/robbyrussell/oh-my-zsh) settings |
| 13 | +- [`zsh_path`](zsh_path): `$PATH` variable setting and `export` settings, like |
| 14 | + default text editors and so on |
| 15 | +- [`zsh_aliases`](zsh_aliases): custom aliases and functions for the zsh |
| 16 | +- [`zsh_fino_custom.zsh-theme`](zsh_fino_custom.zsh-theme): a customized `fino` |
| 17 | + theme for _Oh My ZSH!_ |
| 18 | +- [`gitconfig`](gitconfig): general Git settings |
| 19 | +- [`gitignore_global`](gitignore_global): a list of files Git should ignore in |
| 20 | + any repository |
| 21 | +- [`emacs_init.el`](emacs_init.el): Emacs configuration that also installs some |
| 22 | + ELPA packages, if not already installed, to completely clone an existing |
| 23 | + configuration |
| 24 | +- [`hgrc`](hgrc): general Mercurial settings |
| 25 | +- [`htoprc`](htoprc): looks and columns for `htop` process viewer |
| 26 | +- [`screenrc`](screenrc): basic settings of `screen` terminal multiplexer |
| 27 | +- [`wgetrc`](wgetrc): global configurations of the `wget` command line |
| 28 | + downloader |
| 29 | + |
| 30 | + |
| 31 | +### Installer/automation scripts |
| 32 | + |
| 33 | +Those scripts are meant to be portable, so they react differently based on the |
| 34 | +operative system. Currently are implemented for OS X and Linux Debian/Ubuntu. |
| 35 | + |
| 36 | +- [`matjaz_dotfiles_installer.sh`](matjaz_dotfiles_installer.sh) installs _Oh My |
| 37 | + ZSH!_, if not already installed, clones this dotfiles repository and applies |
| 38 | + those dotfiles to the user, by creating symlinks to them from the home |
| 39 | + directory. |
| 40 | +- [`new_system_packages_installer.sh`](new_system_packages_installer.sh) which |
| 41 | + installs some packages which the Matjaž's dotfiles are for. It calls the |
| 42 | + system's package manager. Currently only for `brew` + `brew cask` or |
| 43 | + `apt-get`. |
| 44 | +- [`full_system_updater.sh`](full_system_updater.sh) just like |
| 45 | + `new_system_packages_installs.sh` detects the operative system and updates |
| 46 | + all the packages of its package managers. Currently only for `brew` + `brew |
| 47 | + cask` or `apt-get`, `pip3` and `gem`. |
| 48 | + |
| 49 | + |
| 50 | +Installation |
| 51 | +------------ |
| 52 | + |
| 53 | +All you need to do is download and run the |
| 54 | +[`matjaz_dotfiles_installer.sh`](matjaz_dotfiles_installer.sh) which should |
| 55 | +handle all the rest. It installs the dotfiles repository in |
| 56 | +`~/Development/Dotfiles`, the necessary packages, HomeBrew and _Oh My ZSH!_. |
| 57 | + |
| 58 | +Run the following command to download the installer and run it: |
| 59 | + |
| 60 | +```bash |
| 61 | +bash -c "$(wget https://raw.github.com/TheMatjaz/dotfiles/master/matjaz_dotfiles_installer.sh -O -)" |
| 62 | +``` |
| 63 | + |
| 64 | +After that I suggest running the |
| 65 | +[`full_system_updater.sh`](full_system_updater.sh), which will be |
| 66 | +located in the just downloaded dotfiles repository (default in `~/Development/Dotfiles`), to update and upgrade everything. It ask for root password just for `gem` updates. |
| 67 | + |
| 68 | +```bash |
| 69 | +bash full_system_updater.sh |
| 70 | +``` |
| 71 | + |
| 72 | + |
| 73 | +License |
| 74 | +------- |
| 75 | + |
| 76 | +This dotfiles repository is released under the |
| 77 | +[BSD 3-clause license](LICENSE.md). |
| 78 | + |
| 79 | + |
| 80 | +Thanks to |
| 81 | +--------- |
| 82 | + |
| 83 | +Those repositories were used as a huge inspiration, some functions and |
| 84 | +aliases were also taken from them. All of those repositories are subject to the |
| 85 | +[MIT license](https://opensource.org/licenses/MIT), released by their respective |
| 86 | +owners. |
| 87 | + |
| 88 | +- [Mathias Bynens's dotfiles](https://github.com/mathiasbynens/dotfiles) |
| 89 | +- [Holman's dotfiles](https://github.com/holman/dotfiles) |
| 90 | +- [Joined's dotfiles](https://github.com/joined/dotfiles) |
| 91 | + |
| 92 | +Some really useful documentation about the dotfiles repositories may be found |
| 93 | +here: |
| 94 | + |
| 95 | +- [Getting started with dotfiles](https://medium.com/@webprolific/getting-started-with-dotfiles-43c3602fd789), |
| 96 | + great for beginners |
| 97 | +- [Dotfiles are meant to be forked](http://zachholman.com/2010/08/dotfiles-are-meant-to-be-forked/) |
| 98 | + by Holman |
| 99 | +- [Using Git and GitHub to manage your dotfiles](http://blog.smalleycreative.com/tutorials/using-git-and-github-to-manage-your-dotfiles/) |
0 commit comments