1.9 KiB
"OH MY ZSHELL!"
NOTE: This documentation isn't finished and this project is currently under rapid development. Be cautious, information here may not be up to date.
NOTE: This fork is specifically for Archlinux and has been patched for a system-wide install; Don't attempt to install to ~/.oh-my-zsh! This project had radically diverged away from its source. While plugins should remain compatible, there is much which has changed.
Setup
oh-my-zsh should work with any recent release of zsh, the
minimum recommended version is 4.3.9. A package can be found in
Archlinux's AUR. We recommend using cower to
install it:
$ cower -dd oh-my-zsh-git
The user must have zsh set as their shell.
# chsh -s /bin/zsh <USERNAME>
The following needs to be added to the start of the user's ~/.zshrc
file to activate oh-my-zshell goodness.
ZSH_THEME="arch-blue"
plugins=(archlinux sprunge git)
load_oh_my_zshell
A skeleton template can be found in
/usr/share/oh-my-zsh/templates/user.zsh-template
Customization
- To enable more the plugins, customize the plugins array in your
~/.zshrc - To change themes, change the @ZSH_THEME@ environment variable in
~/.zshrc.
If you want to override any of the default behaviour, just add a new
file (ending in .zsh) into the ~/.omz/ directory. If you have many
functions which go good together you can put them as a *.plugin.zsh
file in the ~/.omz/plugins/ directory.
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
~/.omz/plugins/ directory and it will be loaded instead of the one
provided one.
Resources
The refcard is pretty tasty for tips.