From 84ce0f42b5bef0c7e9f358990c3ba9af431a97b2 Mon Sep 17 00:00:00 2001 From: Sorin Ionescu Date: Thu, 29 Dec 2011 22:55:45 -0500 Subject: [PATCH] Simplified the README. --- README.md | 114 ++++++++++++++++++++++++++++++------------------------ 1 file changed, 63 insertions(+), 51 deletions(-) diff --git a/README.md b/README.md index 08c4fd2..1f190f1 100644 --- a/README.md +++ b/README.md @@ -1,68 +1,79 @@ -A handful of functions, auto-complete helpers, and stuff that makes you shout... +# Oh My Zsh -> “OH MY ZSHELL!” +OMZ is a configuration framework for [Zsh](http://www.zsh.org) that enriches +the command line interface environment with sane defaults, aliases, functions, +auto completion, and prompt themes. -## Setup +## Installation -`oh-my-zsh` should work with any recent release of [Zsh](http://www.zsh.org), but the -minimum recommended version is 4.3.9. +Oh My Zsh will work with any recent release of Zsh, but the minimum recommended +version is 4.3.10. -1. Clone the repository. +1. Clone the repository: - `git clone git://github.com/sorin-ionescu/oh-my-zsh.git ~/.oh-my-zsh` + `git clone https://github.com/sorin-ionescu/oh-my-zsh.git ~/.oh-my-zsh` -2. Create a new Zsh configuration by copying the Zsh template provided. +2. Create a new Zsh configuration by copying the Zsh template provided: -**NOTE**: If you already have a `~/.zshrc` file, you should back it up with `cp -~/.zshrc{,.orig}` in case you want to go back to your original settings. - - cp ~/.oh-my-zsh/templates/zshrc.template.zsh ~/.zshrc + `cp ~/.oh-my-zsh/templates/zshrc.zsh ~/.zshrc` 3. Set Zsh as your default shell: `chsh -s /bin/zsh` -4. Start / restart Zsh by opening a new terminal window or tab. +4. Open a new Zsh terminal window or tab. -### Problems? +### Mac OS X -If you are not able to find certain commands after switching to *Oh My Zsh*, you need -to modify `PATH` in `~/.zshrc`, or better yet, in `~/functions/02.environment.zsh` -(may be subject to merge conflicts). +If you have administrator privileges, you must fix an Apple miss configuration +in Mac OS X 10.7 Lion by renaming `/etc/zshenv` to `/etc/zprofile`, or Zsh will +have the wrong `PATH` when executed non-interactively by scripts. + +### Troubleshooting + +If you are not able to find certain commands after switching to *Oh My Zsh*, +modify the `PATH` variable in `environment.zsh` then open a new Zsh terminal +window or tab. ## Usage -- Enable the plugins you want in `~/.zshrc`. - - Browse `plugins/` to see what is available. - - Populate the plugins array `plugins=(git osx ruby)`. +Oh My Zsh has many features disabled by default. Read the source code and +accompanying README files to learn of what is available. -- Change the prompt in `~/.zshrc`. - - For a list of themes, type `prompt -l`. - - To preview a theme, type `prompt -p name`. +### Plugins -## Useful +1. Browse `plugins/` to see what is available. +2. Load the plugins you need in `~/.zshrc` then open a new Zsh terminal window + or tab. -The [Zsh Reference Card](http://www.bash2zsh.com/zsh_refcard/refcard.pdf) is tasty. +### Themes + +1. For a list of themes, type `prompt -l`. +2. To preview a theme, type `prompt -p name`. +3. Load the theme you like in `~/.zshrc` then open a new Zsh terminal window or + tab. + ![sorin theme](http://i.imgur.com/aipDQ.png "sorin theme") ### Customization -If you have many related functions, you can organise them in a file in the -`functions/` directory. +The project is managed via [Git](http://git-scm.com). It is highly recommend +that you commit your changes and push them to [GitHub](http://github.com) to +not lose them. If you do not know how to use Git, follow this +[tutorial](http://gitimmersion.com) and bookmark this +[reference](http://gitref.org). -## Help out! +## Resources -I am not a Zsh expert and suspect that there are improvements to be made. If you have -ideas on how to make the configuration easier to maintain or improve the performance, -do not hesitate to fork and send pull requests! +The [Zsh Reference Card](http://www.bash2zsh.com/zsh_refcard/refcard.pdf) is +indispensable. -## Contributors +## Contribute -This project would not exist without all of our awesome users and contributors. +This project would not exist without all of its users and +[contributors](https://github.com/sorin-ionescu/oh-my-zsh/contributors). -- View the growing [list](https://github.com/robbyrussell/oh-my-zsh/contributors) of - contributors. - -Thank you so much! +If you have ideas on how to make the configuration easier to maintain or +improve its performance, do not hesitate to fork and send pull requests. ## License @@ -70,20 +81,21 @@ Thank you so much! Copyright (c) 2011 Robby Russell, Sorin Ionescu, and contributors. -Permission is hereby granted, free of charge, to any person obtaining a copy of this -software and associated documentation files (the "Software"), to deal in the Software -without restriction, including without limitation the rights to use, copy, modify, -merge, publish, distribute, sublicense, and/or sell copies of the Software, and to -permit persons to whom the Software is furnished to do so, subject to the following -conditions: +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies +of the Software, and to permit persons to whom the Software is furnished to do +so, subject to the following conditions: -The above copyright notice and this permission notice shall be included in all copies -or substantial portions of the Software. +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, -INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR -A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT -HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF -CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE -OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE.