278 lines
9.0 KiB
Markdown
278 lines
9.0 KiB
Markdown
<p align="center">
|
||
<img src="https://s3.amazonaws.com/ohmyzsh/oh-my-zsh-logo.png" alt="Oh My Zsh">
|
||
</p>
|
||
|
||
Oh My Zsh is an open source, community-driven framework for managing your [zsh](http://www.zsh.org/) configuration.
|
||
|
||
Sounds boring. Let's try again.
|
||
|
||
__Oh My Zsh will not make you a 10x developer...but you might feel like one.__
|
||
|
||
Once installed, your terminal shell will become the talk of the town _or your money back!_ With each keystroke in your command prompt, you'll take advantage of the hundreds of powerful plugins and beautiful themes. Strangers will come up to you in cafés and ask you, _"that is amazing! are you some sort of genius?"_
|
||
|
||
Finally, you'll begin to get the sort of attention that you have always felt you deserved. ...or maybe you'll use the time that you're saving to start flossing more often. 😬
|
||
|
||
To learn more, visit [ohmyz.sh](http://ohmyz.sh) and follow [@ohmyzsh](https://twitter.com/ohmyzsh) on Twitter.
|
||
|
||
## Getting Started
|
||
|
||
### Prerequisites
|
||
|
||
## __Disclaimer:__ _This custom Oh My Zsh only works on **Ubuntu/Debian**._
|
||
|
||
* Unix-like operating system (Linux)
|
||
* [Zsh](http://www.zsh.org) is installed along with _Oh My Zsh_ (v4.3.9 or more recent).
|
||
* `curl` or `wget` should be installed
|
||
* `git` should be installed
|
||
|
||
### Basic Installation
|
||
|
||
Oh My Zsh is installed by running one of the following commands in your terminal. You can install this via the command-line with either `curl` or `wget`.
|
||
|
||
#### via curl
|
||
|
||
```shell
|
||
sh -c "$(curl -fsSL https://git.adphi.net/Adphi/oh-my-zsh/raw/master/tools/install.sh)"
|
||
```
|
||
|
||
#### via wget
|
||
|
||
```shell
|
||
sh -c "$(wget https://git.adphi.net/Adphi/oh-my-zsh/raw/master/tools/install.sh -O -)"
|
||
```
|
||
|
||
## Customs adds
|
||
|
||
If zsh is not intalled, the script handle it.
|
||
|
||
|
||
Default theme is 'agnoster', with powerline fonts installation at the beginning of the script.
|
||
|
||
|
||
#### create a file along with folder path
|
||
```shell
|
||
fp filepath/myfile
|
||
```
|
||
|
||
#### alias to 'clear'
|
||
```shell
|
||
c
|
||
```
|
||
|
||
#### launch nano to edit zsh config
|
||
```shell
|
||
zshconfig
|
||
```
|
||
|
||
###### To do just after:
|
||
|
||
#### refresh zsh configuration
|
||
```shell
|
||
zshrefresh
|
||
```
|
||
|
||
### Docker:
|
||
|
||
######
|
||
```
|
||
alias d="docker"
|
||
alias dc="docker-compose"
|
||
alias dm="docker-machine"
|
||
|
||
|
||
# Set Docker-Machine node Env
|
||
# Example: dme node1
|
||
dme() {
|
||
eval $(docker-machine env $1)
|
||
}
|
||
|
||
# Quit Docker-Machine node Env
|
||
alias dmq="eval $(docker-machine env -u)"
|
||
|
||
alias cleanContainers="docker container rm \$(docker container ls -a -q) "
|
||
alias cleanVolumes="docker volume rm \$(docker volume ls -q) "
|
||
|
||
swarmCleanVolumes(){
|
||
nodes=($(docker-machine ls -q))
|
||
|
||
for node in "${nodes[@]}"
|
||
do
|
||
volumes=($(docker-machine ssh ${node} "docker volume ls -q"))
|
||
docker-machine ssh ${node} "docker volume rm ${volumes[@]}"
|
||
done
|
||
}
|
||
|
||
swarmCleanContainers() {
|
||
nodes=($(docker-machine ls -q))
|
||
for node in "${nodes[@]}"
|
||
do
|
||
containers=($(docker-machine ssh ${node} "docker container ls -aq"))
|
||
docker-machine ssh ${node} "docker container rm ${containers[@]}"
|
||
done
|
||
}
|
||
```
|
||
|
||
### TODO :
|
||
- improve aliases
|
||
- more aliases ...
|
||
- any help is welcome ...
|
||
|
||
## Using Oh My Zsh
|
||
|
||
### Plugins
|
||
|
||
Oh My Zsh comes with a shitload of plugins to take advantage of. You can take a look in the [plugins](https://github.com/robbyrussell/oh-my-zsh/tree/master/plugins) directory and/or the [wiki](https://github.com/robbyrussell/oh-my-zsh/wiki/Plugins) to see what's currently available.
|
||
|
||
#### Enabling Plugins
|
||
|
||
Once you spot a plugin (or several) that you'd like to use with Oh My Zsh, you'll need to enable them in the `.zshrc` file. You'll find the zshrc file in your `$HOME` directory. Open it with your favorite text editor and you'll see a spot to list all the plugins you want to load.
|
||
|
||
```shell
|
||
vi ~/.zshrc
|
||
```
|
||
|
||
For example, this might begin to look like this:
|
||
|
||
```shell
|
||
plugins=(
|
||
git
|
||
bundler
|
||
dotenv
|
||
osx
|
||
rake
|
||
rbenv
|
||
ruby
|
||
)
|
||
```
|
||
|
||
#### Using Plugins
|
||
|
||
Most plugins (should! we're working on this) include a __README__, which documents how to use them.
|
||
|
||
### Themes
|
||
|
||
We'll admit it. Early in the Oh My Zsh world, we may have gotten a bit too theme happy. We have over one hundred themes now bundled. Most of them have [screenshots](https://wiki.github.com/robbyrussell/oh-my-zsh/themes) on the wiki. Check them out!
|
||
|
||
#### Selecting a Theme
|
||
|
||
_Robby's theme is the default one. It's not the fanciest one. It's not the simplest one. It's just the right one (for him)._
|
||
|
||
Once you find a theme that you'd like to use, you will need to edit the `~/.zshrc` file. You'll see an environment variable (all caps) in there that looks like:
|
||
|
||
```shell
|
||
ZSH_THEME="robbyrussell"
|
||
```
|
||
|
||
To use a different theme, simply change the value to match the name of your desired theme. For example:
|
||
|
||
```shell
|
||
ZSH_THEME="agnoster" # (this is one of the fancy ones)
|
||
# see https://github.com/robbyrussell/oh-my-zsh/wiki/Themes#agnoster
|
||
```
|
||
|
||
_Note: many themes require installing the [Powerline Fonts](https://github.com/powerline/fonts) in order to render properly._
|
||
|
||
Open up a new terminal window and your prompt should look something like this:
|
||
|
||
|
||
|
||
In case you did not find a suitable theme for your needs, please have a look at the wiki for [more of them](https://github.com/robbyrussell/oh-my-zsh/wiki/External-themes).
|
||
|
||
If you're feeling feisty, you can let the computer select one randomly for you each time you open a new terminal window.
|
||
|
||
|
||
```shell
|
||
ZSH_THEME="random" # (...please let it be pie... please be some pie..)
|
||
```
|
||
|
||
And if you want to pick random theme from a list of your favorite themes:
|
||
|
||
```shell
|
||
ZSH_THEME_RANDOM_CANDIDATES=(
|
||
"robbyrussell"
|
||
"agnoster"
|
||
)
|
||
```
|
||
|
||
### Installation Problems
|
||
|
||
If you have any hiccups installing, here are a few common fixes.
|
||
|
||
* You _might_ need to modify your `PATH` in `~/.zshrc` if you're not able to find some commands after switching to `oh-my-zsh`.
|
||
* If you installed manually or changed the install location, check the `ZSH` environment variable in `~/.zshrc`.
|
||
|
||
### Custom Plugins and Themes
|
||
|
||
If you want to override any of the default behaviors, just add a new file (ending in `.zsh`) in the `custom/` directory.
|
||
|
||
If you have many functions that go well together, you can put them as a `XYZ.plugin.zsh` file in the `custom/plugins/` directory and then enable this plugin.
|
||
|
||
If you would like to override the functionality of a plugin distributed with Oh My Zsh, create a plugin of the same name in the `custom/plugins/` directory and it will be loaded instead of the one in `plugins/`.
|
||
|
||
## Getting Updates
|
||
|
||
By default, you will be prompted to check for upgrades every few weeks. If you would like `oh-my-zsh` to automatically upgrade itself without prompting you, set the following in your `~/.zshrc`:
|
||
|
||
```shell
|
||
DISABLE_UPDATE_PROMPT=true
|
||
```
|
||
|
||
To disable automatic upgrades, set the following in your `~/.zshrc`:
|
||
|
||
```shell
|
||
DISABLE_AUTO_UPDATE=true
|
||
```
|
||
|
||
### Manual Updates
|
||
|
||
If you'd like to upgrade at any point in time (maybe someone just released a new plugin and you don't want to wait a week?) you just need to run:
|
||
|
||
```shell
|
||
upgrade_oh_my_zsh
|
||
```
|
||
|
||
Magic! 🎉
|
||
|
||
## Uninstalling Oh My Zsh
|
||
|
||
Oh My Zsh isn't for everyone. We'll miss you, but we want to make this an easy breakup.
|
||
|
||
If you want to uninstall `oh-my-zsh`, just run `uninstall_oh_my_zsh` from the command-line. It will remove itself and revert your previous `bash` or `zsh` configuration.
|
||
|
||
## Contributing
|
||
|
||
I'm far from being a [Zsh](http://www.zsh.org/) expert and suspect there are many ways to improve – if you have ideas on how to make the configuration easier to maintain (and faster), don't hesitate to fork and send pull requests!
|
||
|
||
We also need people to test out pull-requests. So take a look through [the open issues](https://github.com/robbyrussell/oh-my-zsh/issues) and help where you can.
|
||
|
||
### Do NOT send us themes
|
||
|
||
We have (more than) enough themes for the time being. Please add your theme to the [external themes](https://github.com/robbyrussell/oh-my-zsh/wiki/External-themes) wiki page.
|
||
|
||
## Contributors
|
||
|
||
Oh My Zsh has a vibrant community of happy users and delightful contributors. Without all the time and help from our contributors, it wouldn't be so awesome.
|
||
|
||
Thank you so much!
|
||
|
||
## Follow Us
|
||
|
||
We're on the social media.
|
||
|
||
* [@ohmyzsh](https://twitter.com/ohmyzsh) on Twitter. You should follow it.
|
||
* [Oh My Zsh](https://www.facebook.com/Oh-My-Zsh-296616263819290/) on Facebook.
|
||
|
||
## Merchandise
|
||
|
||
We have [stickers](https://shop.planetargon.com/products/ohmyzsh-stickers-set-of-3-stickers) and [shirts](http://shop.planetargon.com/products/ohmyzsh-t-shirts) for you to show off your love of Oh My Zsh. Again, this will help you become the talk of the town!
|
||
|
||
## License
|
||
|
||
Oh My Zsh is released under the [MIT license](LICENSE.txt).
|
||
|
||
## About Planet Argon
|
||
|
||
|
||
|
||
Oh My Zsh was started by the team at [Planet Argon](https://www.planetargon.com/?utm_source=github), a [Ruby on Rails development agency](https://www.planetargon.com/skills/ruby-on-rails-development?utm_source=github). Check out our [other open source projects](https://www.planetargon.com/open-source?utm_source=github).
|