2021-05-04 01:59:31 +00:00
|
|
|
# Prezto — Instantly Awesome Zsh
|
2011-07-18 04:00:35 +00:00
|
|
|
|
2012-09-03 20:08:39 +00:00
|
|
|
Prezto is the configuration framework for [Zsh][1]; it enriches the command line
|
2012-05-22 00:18:30 +00:00
|
|
|
interface environment with sane defaults, aliases, functions, auto completion,
|
|
|
|
and prompt themes.
|
2011-07-18 04:00:35 +00:00
|
|
|
|
2021-05-04 01:59:31 +00:00
|
|
|
## Installation
|
2011-07-18 04:00:35 +00:00
|
|
|
|
2022-06-15 17:42:21 +00:00
|
|
|
### Manual
|
|
|
|
|
2014-10-06 01:10:27 +00:00
|
|
|
Prezto will work with any recent release of Zsh, but the minimum required
|
2021-05-04 01:59:31 +00:00
|
|
|
version is **4.3.11**.
|
2011-07-18 04:00:35 +00:00
|
|
|
|
2021-05-04 01:59:31 +00:00
|
|
|
01. Launch Zsh:
|
2011-07-18 04:00:35 +00:00
|
|
|
|
2021-05-04 01:59:31 +00:00
|
|
|
```console
|
|
|
|
zsh
|
|
|
|
```
|
2011-07-18 04:00:35 +00:00
|
|
|
|
2021-05-04 01:59:31 +00:00
|
|
|
02. Clone the repository:
|
2011-07-18 04:00:35 +00:00
|
|
|
|
2021-05-04 01:59:31 +00:00
|
|
|
```console
|
|
|
|
git clone --recursive https://github.com/sorin-ionescu/prezto.git "${ZDOTDIR:-$HOME}/.zprezto"
|
|
|
|
```
|
2012-09-03 20:08:39 +00:00
|
|
|
|
2021-05-05 17:59:01 +00:00
|
|
|
<details>
|
|
|
|
<summary><em>Optional: Installing in <code>$XDG_CONFIG_HOME</code></em></summary>
|
|
|
|
|
|
|
|
Optionally, if you already have `$XDG_CONFIG_HOME` configured (usually as
|
|
|
|
_`$HOME/.config`_ by default) and intend to install Prezto under
|
|
|
|
_`$XDG_CONFIG_HOME/zsh`_ instead, you can clone the repository there and
|
|
|
|
configure `$ZDOTDIR` separately if not already configured.
|
|
|
|
|
|
|
|
- Clone the repository:
|
|
|
|
|
|
|
|
```console
|
|
|
|
git clone --recursive https://github.com/sorin-ionescu/prezto.git "${ZDOTDIR:-${XDG_CONFIG_HOME:-$HOME/.config}/zsh}/.zprezto"
|
|
|
|
```
|
|
|
|
|
2021-11-12 16:07:53 +00:00
|
|
|
- Configure `$XDG_CONFIG_HOME` and `$ZDOTDIR` in _`$HOME/.zshenv`_:
|
2021-05-05 17:59:01 +00:00
|
|
|
|
|
|
|
```sh
|
|
|
|
export XDG_CONFIG_HOME="${XDG_CONFIG_HOME:=$HOME/.config}"
|
2024-01-19 01:13:22 +00:00
|
|
|
[[ -d $XDG_CONFIG_HOME/zsh ]] && export ZDOTDIR="$XDG_CONFIG_HOME/zsh"
|
2021-05-05 17:59:01 +00:00
|
|
|
source "$ZDOTDIR/.zshenv"
|
|
|
|
```
|
|
|
|
|
|
|
|
</details>
|
|
|
|
|
|
|
|
03. Create a new Zsh configuration by copying/linking the Zsh configuration
|
|
|
|
files provided:
|
2012-09-03 20:08:39 +00:00
|
|
|
|
2021-05-04 01:59:31 +00:00
|
|
|
```console
|
|
|
|
setopt EXTENDED_GLOB
|
|
|
|
for rcfile in "${ZDOTDIR:-$HOME}"/.zprezto/runcoms/^README.md(.N); do
|
|
|
|
ln -s "$rcfile" "${ZDOTDIR:-$HOME}/.${rcfile:t}"
|
|
|
|
done
|
|
|
|
```
|
2011-07-18 04:00:35 +00:00
|
|
|
|
2021-05-04 01:59:31 +00:00
|
|
|
**Note:** If you already have any of the given configuration files, `ln` in
|
|
|
|
the above operation will cause an error. In simple cases, you can load
|
|
|
|
Prezto by adding the line `source "${ZDOTDIR:-$HOME}/.zprezto/init.zsh"` to
|
2021-05-05 17:59:01 +00:00
|
|
|
the bottom of your _`${ZDOTDIR:-$HOME}/.zshrc`_ and keep the rest of your
|
|
|
|
Zsh configuration intact. For more complicated setups, we recommend that you
|
2021-05-04 01:59:31 +00:00
|
|
|
back up your original configs and replace them with the provided Prezto
|
2021-05-05 17:59:01 +00:00
|
|
|
[_`runcoms`_][10].
|
2017-04-13 09:53:07 +00:00
|
|
|
|
2021-05-04 01:59:31 +00:00
|
|
|
04. Set Zsh as your default shell:
|
2011-07-18 04:00:35 +00:00
|
|
|
|
2021-05-04 01:59:31 +00:00
|
|
|
```console
|
|
|
|
chsh -s /bin/zsh
|
|
|
|
```
|
2011-07-18 04:00:35 +00:00
|
|
|
|
2021-05-04 01:59:31 +00:00
|
|
|
05. Open a new Zsh terminal window or tab.
|
2011-12-30 03:55:45 +00:00
|
|
|
|
|
|
|
### Troubleshooting
|
2011-07-18 04:00:35 +00:00
|
|
|
|
2021-05-04 01:59:31 +00:00
|
|
|
If you are not able to find certain commands after switching to Prezto, modify
|
2021-05-05 17:59:01 +00:00
|
|
|
the `PATH` variable in _`${ZDOTDIR:-$HOME}/.zprofile`_ then open a new Zsh
|
2021-05-04 01:59:31 +00:00
|
|
|
terminal window or tab.
|
2011-07-18 04:00:35 +00:00
|
|
|
|
2021-05-04 01:59:31 +00:00
|
|
|
## Updating
|
2013-09-26 18:06:54 +00:00
|
|
|
|
2021-05-04 01:59:31 +00:00
|
|
|
Run `zprezto-update` to automatically check if there is an update to Prezto.
|
|
|
|
If there are no file conflicts, Prezto and its submodules will be automatically
|
|
|
|
updated. If there are conflicts you will be instructed to go into the
|
|
|
|
`$ZPREZTODIR` directory and resolve them yourself.
|
2013-09-26 18:06:54 +00:00
|
|
|
|
2017-06-30 06:26:53 +00:00
|
|
|
To pull the latest changes and update submodules manually:
|
|
|
|
|
2017-07-21 01:07:29 +00:00
|
|
|
```console
|
|
|
|
cd $ZPREZTODIR
|
|
|
|
git pull
|
2021-05-05 02:18:59 +00:00
|
|
|
git submodule sync --recursive
|
2017-07-21 01:07:29 +00:00
|
|
|
git submodule update --init --recursive
|
|
|
|
```
|
2013-09-26 18:06:54 +00:00
|
|
|
|
2021-05-04 01:59:31 +00:00
|
|
|
## Usage
|
2011-07-18 04:00:35 +00:00
|
|
|
|
2021-05-04 01:59:31 +00:00
|
|
|
Prezto has many features disabled by default. Read the source code and the
|
|
|
|
accompanying README files to learn about what is available.
|
2011-07-18 04:00:35 +00:00
|
|
|
|
2012-03-28 16:41:39 +00:00
|
|
|
### Modules
|
2011-07-18 04:00:35 +00:00
|
|
|
|
2021-05-05 17:59:01 +00:00
|
|
|
01. Browse [_`modules`_][9] to see what is available.
|
|
|
|
02. Load the modules you need in _`${ZDOTDIR:-$HOME}/.zpreztorc`_ and then open
|
|
|
|
a new Zsh terminal window or tab.
|
2011-07-18 04:00:35 +00:00
|
|
|
|
2011-12-30 03:55:45 +00:00
|
|
|
### Themes
|
2011-07-18 04:00:35 +00:00
|
|
|
|
2021-05-04 01:59:31 +00:00
|
|
|
01. For a list of themes, type `prompt -l`.
|
|
|
|
02. To preview a theme, type `prompt -p name`.
|
2021-05-05 17:59:01 +00:00
|
|
|
03. Load the theme you like in _`${ZDOTDIR:-$HOME}/.zpreztorc`_ and then
|
|
|
|
open a new Zsh terminal window or tab.
|
2011-07-18 04:00:35 +00:00
|
|
|
|
2021-05-04 01:59:31 +00:00
|
|
|
![sorin theme][2]
|
2021-05-05 17:59:01 +00:00
|
|
|
Note that the [_`git`_][11] module may be required for special symbols to
|
|
|
|
appear, such as those on the right of the above image. Add `'git'` to the
|
|
|
|
`pmodule` list (under `zstyle ':prezto:load' pmodule \` in your
|
|
|
|
_`${ZDOTDIR:-$HOME}/.zpreztorc`_) to enable this module.
|
2018-10-11 22:10:35 +00:00
|
|
|
|
2017-11-13 01:53:10 +00:00
|
|
|
### External Modules
|
|
|
|
|
2021-05-05 17:59:01 +00:00
|
|
|
01. By default modules will be loaded from [_`/modules`_][9] and _`/contrib`_.
|
2021-05-04 01:59:31 +00:00
|
|
|
02. Additional module directories can be added to the
|
2021-05-05 17:59:01 +00:00
|
|
|
`:prezto:load:pmodule-dirs` setting in _`${ZDOTDIR:-$HOME}/.zpreztorc`_.
|
2017-11-13 01:53:10 +00:00
|
|
|
|
2021-05-04 01:59:31 +00:00
|
|
|
Note that module names need to be unique or they will cause an error when
|
|
|
|
loading.
|
2017-11-13 01:53:10 +00:00
|
|
|
|
2021-05-05 17:59:01 +00:00
|
|
|
```sh
|
2021-05-04 01:59:31 +00:00
|
|
|
zstyle ':prezto:load' pmodule-dirs $HOME/.zprezto-contrib
|
|
|
|
```
|
2017-11-13 01:53:10 +00:00
|
|
|
|
2021-05-04 01:59:31 +00:00
|
|
|
## Customization
|
2011-07-18 04:00:35 +00:00
|
|
|
|
2021-05-04 01:59:31 +00:00
|
|
|
The project is managed via [Git][3]. We highly recommend that you fork this
|
|
|
|
project so that you can commit your changes and push them to your fork on
|
|
|
|
[GitHub][4] to preserve them. If you do not know how to use Git, follow this
|
|
|
|
[tutorial][5] and bookmark this [reference][6].
|
2011-07-18 04:00:35 +00:00
|
|
|
|
2021-05-04 01:59:31 +00:00
|
|
|
## Resources
|
2011-07-18 04:00:35 +00:00
|
|
|
|
2012-08-28 00:17:36 +00:00
|
|
|
The [Zsh Reference Card][7] and the [zsh-lovers][8] man page are indispensable.
|
2011-07-18 04:00:35 +00:00
|
|
|
|
2021-05-04 01:59:31 +00:00
|
|
|
## License
|
2011-12-28 22:04:43 +00:00
|
|
|
|
2017-04-05 16:34:31 +00:00
|
|
|
This project is licensed under the MIT License.
|
2011-12-28 22:04:43 +00:00
|
|
|
|
2021-05-04 01:59:31 +00:00
|
|
|
[1]: https://www.zsh.org
|
|
|
|
[2]: https://i.imgur.com/nrGV6pg.png "sorin theme"
|
|
|
|
[3]: https://git-scm.com
|
2012-05-22 00:18:30 +00:00
|
|
|
[4]: https://github.com
|
2021-05-04 01:59:31 +00:00
|
|
|
[5]: https://gitimmersion.com
|
2018-07-28 16:33:24 +00:00
|
|
|
[6]: https://git.github.io/git-reference/
|
2012-08-28 00:17:36 +00:00
|
|
|
[7]: http://www.bash2zsh.com/zsh_refcard/refcard.pdf
|
2021-05-04 01:59:31 +00:00
|
|
|
[8]: https://grml.org/zsh/zsh-lovers.html
|
2021-05-05 17:59:01 +00:00
|
|
|
[9]: modules#readme
|
|
|
|
[10]: runcoms#readme
|
|
|
|
[11]: modules/git#readme
|