add table of contents; add try-it-in-docker

pull/22/head
romkatv 6 years ago
parent a6eb14db5e
commit a05b085236

@ -11,33 +11,78 @@ shell like it's 80's again!
Powerlevel10k uses the same configuration options as Powerlevel9k and produces the Powerlevel10k uses the same configuration options as Powerlevel9k and produces the
same results. It's simply faster. There is no catch. same results. It's simply faster. There is no catch.
If you are on Linux or WSL, consider enabling [gitstatus](https://github.com/romkatv/gitstatus) If you are on Linux or WSL, enable [gitstatus](https://github.com/romkatv/gitstatus)
plugin for additional performance improvement in the vcs/prompt segment. plugin for additional performance improvement in the vcs/prompt segment.
## Installation & Configuration ## Table of Contents
1. [Installation & Configuration](#installation-and-configuration)
2. [Try it in Docker](#try-it-in-docker)
3. [How fast is it?](#how-fast-is-it)
4. [What's the catch?](#whats-the-catch)
## Installation and Configuration
For installation and configuration instructions see For installation and configuration instructions see
[Powerlevel9k](https://github.com/bhilburn/powerlevel9k). Everything in there applies to [Powerlevel9k](https://github.com/bhilburn/powerlevel9k). Everything in there applies to
Powerlevel10k as well. Follow the official installation guide, make sure everything works Powerlevel10k as well. Follow the official installation guide, make sure everything works
and you like the way prompt looks. Then simply replace the content of your `powerlevel9k` and you like the way prompt looks. Then simply replace Powerlevel9k with Powerlevel10k. Once
directory with Powerlevel10k. Once you restart zsh, your prompt will be faster. No you restart zsh, your prompt will be faster. No configuration changes are needed.
configuration changes are needed.
Manual installation:
```zsh
git clone https://github.com/romkatv/gitstatus.git ~/gitstatus
git clone https://github.com/romkatv/powerlevel10k.git ~/powerlevel10k
echo 'source ~/gitstatus/gitstatus.plugin.zsh' >>! ~/.zshrc
echo 'source ~/powerlevel10k/powerlevel10k.zsh-theme' >>! ~/.zshrc
```
**Do not load both Powerlevel9k and Powerlevel10k themes at the same time. Variable name clashes
will cause mayhem. You can source either one or the other. Consider Powerlevel10k a patched fork
of Powerlevel9k, which it is.**
## Try it in Docker
If you are using oh-my-zsh, here's how you can replace Powerlevel9k with Powerlevel10k. Try Powerlevel10k in Docker without making any changes to your system.
```zsh ```zsh
# Delete the original powerlevel9k theme. docker run -e LANG=C.UTF-8 -e LC_ALL=C.UTF-8 -e TERM=$TERM -it --rm ubuntu bash -c '
rm -rf ~/.oh-my-zsh/custom/themes/powerlevel9k set -uex
# Put powerlevel10k in its place. apt update
git clone https://github.com/romkatv/powerlevel10k.git ~/.oh-my-zsh/custom/themes/powerlevel9k apt install -y zsh git
cd
git clone https://github.com/romkatv/gitstatus.git
git clone https://github.com/romkatv/powerlevel10k.git
echo "
# Your prompt configuration goes here.
POWERLEVEL9K_PROMPT_ON_NEWLINE=true
POWERLEVEL9K_LEFT_PROMPT_ELEMENTS=(root_indicator dir_writable dir vcs)
POWERLEVEL9K_RIGHT_PROMPT_ELEMENTS=(status command_execution_time background_jobs time)
source ~/gitstatus/gitstatus.plugin.zsh
source ~/powerlevel10k/powerlevel10k.zsh-theme" >~/.zshrc
cd powerlevel10k
zsh -i'
``` ```
Adjust these commands based on where your `powerlevel9k` directory is. Compare prompt responsiveness to Powerlevel9k.
Alternatively, you can place `Powerlevel10k` in `powerlevel10k` directory and modify ```zsh
the theme name in your `.zshrc`. **However, do not load both Powerlevel9k and Powerlevel10k docker run -e LANG=C.UTF-8 -e LC_ALL=C.UTF-8 -e TERM=$TERM -it --rm ubuntu bash -c '
themes at the same time. Variable name clashes will cause mayhem. You can source either set -uex
one or the other. Consider Powerlevel10k a patched fork of Powerlevel9k, which it is.** apt update
apt install -y zsh git
cd
git clone https://github.com/bhilburn/powerlevel9k.git
echo "
# Your prompt configuration goes here.
POWERLEVEL9K_PROMPT_ON_NEWLINE=true
POWERLEVEL9K_LEFT_PROMPT_ELEMENTS=(root_indicator dir_writable dir vcs)
POWERLEVEL9K_RIGHT_PROMPT_ELEMENTS=(status command_execution_time background_jobs time)
source ~/powerlevel9k/powerlevel9k.zsh-theme" >~/.zshrc
cd powerlevel9k
zsh -i'
```
## How fast is it? ## How fast is it?

Loading…
Cancel
Save