update toc; explain how the screenshots and gifs were produced; clean things up

pull/471/head
romkatv 5 years ago
parent e916104c1c
commit 7ae901212c

@ -1,16 +1,20 @@
# Powerlevel10k # Powerlevel10k
[![Gitter](https://badges.gitter.im/powerlevel10k/community.svg)](https://gitter.im/powerlevel10k/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge) [![Gitter](https://badges.gitter.im/powerlevel10k/community.svg)](https://gitter.im/powerlevel10k/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
Powerlevel10k is a theme for ZSH. It's fast, flexible and easy to get started with. Powerlevel10k is a theme for ZSH. It emphasizes [speed](#unparalleled-performance),
[flexibility](#extremely-customizable) and [out-of-the-box experience](#configuration-wizard).
![Powerlevel10k](https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/prompt-styles.png) ![Powerlevel10k](
https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/prompt-styles.png)
To see what Powerlevel10k is about, scroll through [features](#features). To see what Powerlevel10k is about, scroll through [features](#features).
Ready to give it a try? Powerlevel9k users, go [here](#powerlevel9k-compatibility).
1. Install [the recommended font](#recommended-meslo-nerd-font-patched-for-powerlevel10k). Optional Ready to give Powerlevel10k a try?
but highly recommended.
1. Install [the recommended font](#meslo-nerd-font-patched-for-powerlevel10k). *Optional but highly
recommended.*
1. Install Powerlevel10k for your plugin manager. 1. Install Powerlevel10k for your plugin manager.
- [Manual](#manual) 👈 **choose this if confused or uncertain** - [Manual](#manual) 👈 **choose this if confused or uncertain**
- [Oh My Zsh](#oh-my-zsh) - [Oh My Zsh](#oh-my-zsh)
@ -21,8 +25,9 @@ Ready to give it a try?
- [Zgen](#zgen) - [Zgen](#zgen)
- [Antibody](#antibody) - [Antibody](#antibody)
- [Zplugin](#zplugin) - [Zplugin](#zplugin)
1. Restart Zsh. If the configuration wizard doesn't start automatically, type `p10k configure`.
The full [table of contents](#table-of-contents) is at the bottom. The full [table of contents](#table-of-contents) is at the bottom of the page.
## Features ## Features
@ -33,16 +38,16 @@ Type `p10k configure` to access the builtin configuration wizard right from your
![Powerlevel10k Configuration Wizard]( ![Powerlevel10k Configuration Wizard](
https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/configuration-wizard.gif) https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/configuration-wizard.gif)
All styles except [Pure](#pure-compatibility) are functionally equivalent. They display the same
information and differ only in presentation.
Configuration wizard creates `~/.p10k.zsh` based on your preferences. Additional prompt Configuration wizard creates `~/.p10k.zsh` based on your preferences. Additional prompt
customization can be done by editing this file. It has many comments to help you navigate through customization can be done by editing this file. It has many comments to help you navigate through
configuration options. configuration options.
All styles except [Pure](#pure-compatibility) are functionally equivalent. They display the same
information and differ only in presentation.
Tip: Install [the recommended font](#recommended-meslo-nerd-font-patched-for-powerlevel10k) before Tip: Install [the recommended font](#recommended-meslo-nerd-font-patched-for-powerlevel10k) before
running `p10k configure`. If you are using iTerm2, `p10k configure` can install the font for you. running `p10k configure`. If you are using iTerm2 or Termux, `p10k configure` can install the font
Simply say *Yes* when asked. for you. Simply say *Yes* when asked.
### Unparalleled performance ### Unparalleled performance
@ -92,7 +97,10 @@ sed 's/powerlevel9k/powerlevel10k/g' -i ~/.zshrc
exec zsh exec zsh
``` ```
Optional: Type `p10k configure` and explore exlusive Powerlevel10k prompt styles. Optional steps (highly recommended):
4. Install [the recommended font](#meslo-nerd-font-patched-for-powerlevel10k).
5. Type `p10k configure` and explore exlusive Powerlevel10k prompt styles.
### Pure compatibility ### Pure compatibility
@ -129,6 +137,8 @@ upon Zsh startup so you can start typing while plugins are still loading.
Other themes *increase* Zsh startup lag -- some by a lot, others by a just a little. Powerlevel10k Other themes *increase* Zsh startup lag -- some by a lot, others by a just a little. Powerlevel10k
*removes* it outright. *removes* it outright.
For details, see [FAQ](#what-is-instant-prompt).
### Show on command ### Show on command
The behavior of some commands depends on global environment. For example, `kubectl run ...` runs an The behavior of some commands depends on global environment. For example, `kubectl run ...` runs an
@ -454,7 +464,7 @@ covered by the same license.
## FAQ ## FAQ
### <a name='instant-prompt'></a>What is instant prompt? ### </a>What is instant prompt?
*Instant Prompt* is an optional feature of Powerlevel10k. When enabled, it gives you a limited *Instant Prompt* is an optional feature of Powerlevel10k. When enabled, it gives you a limited
prompt within a few milliseconds of starting zsh, allowing you to start hacking right away while zsh prompt within a few milliseconds of starting zsh, allowing you to start hacking right away while zsh
@ -816,20 +826,20 @@ theme (so that you end up with no theme) and then installing Powerlevel10k manua
1. Disable the current theme in your framework / plugin manager. 1. Disable the current theme in your framework / plugin manager.
- **oh-my-zsh:** Open `~/.zshrc` and remove the line that sets `ZSH_THEME`. It might look like this:
`ZSH_THEME="powerlevel9k/powerlevel9k"`.
- **zplug:** Open `~/.zshrc` and remove the `zplug` command that refers to your current theme. For - **zplug:** Open `~/.zshrc` and remove the `zplug` command that refers to your current theme. For
example, if you are currently using Powerlevel9k, look for example, if you are currently using Powerlevel9k, look for
`zplug bhilburn/powerlevel9k, use:powerlevel9k.zsh-theme`. `zplug bhilburn/powerlevel9k, use:powerlevel9k.zsh-theme`.
- **prezto:** Open `~/.zpreztorc` and put `zstyle :prezto:module:prompt theme off` in it. Remove - **prezto:** Open `~/.zpreztorc` and put `zstyle :prezto:module:prompt theme off` in it. Remove
any other command that sets `theme` such as `zstyle :prezto:module:prompt theme powerlevel9k`. any other command that sets `theme` such as `zstyle :prezto:module:prompt theme powerlevel9k`.
- **oh-my-zsh:** Open `~/.zshrc` and remove the line that sets `ZSH_THEME`, such as - **antigen:** Open `~/.zshrc` and remove the line that sets `antigen theme`. It might look like
`ZSH_THEME=powerlevel9k/powerlevel9k`. this: `antigen theme powerlevel9k/powerlevel9k`.
- **antigen:** Open `~/.zshrc` and remove the line that sets `antigen theme`, such as
`antigen theme powerlevel9k/powerlevel9k`.
2. Install Powerlevel10k manually. 2. Install Powerlevel10k manually.
```zsh ```zsh
git clone https://github.com/romkatv/powerlevel10k.git ~/powerlevel10k git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ~/powerlevel10k
echo 'source ~/powerlevel10k/powerlevel10k.zsh-theme' >>! ~/.zshrc echo 'source ~/powerlevel10k/powerlevel10k.zsh-theme' >>! ~/.zshrc
``` ```
@ -839,9 +849,27 @@ This method of installation won't make anything slower or otherwise sub-par.
Zsh 5.1 or newer should work. Fast startup requires zsh >= 5.4. Zsh 5.1 or newer should work. Fast startup requires zsh >= 5.4.
### How were these screenshots and animated gifs created?
All screenshots and animated gifs were recorded in GNOME Terminal with white text on black
background, Tango palette, and [the recommended font](#meslo-nerd-font-patched-for-powerlevel10k).
![GNOME Terminal Color Settings](
https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/gnome-terminal-colors.png)
## Table of contents ## Table of contents
1. [Features](#features) 1. [Features](#features)
1. [Configuration wizard](#configuration-wizard)
1. [Unparalleled performance](#unparalleled-performance)
1. [Powerlevel9k compatibility](#powerlevel9k-compatibility)
1. [Pure compatibility](#pure-compatibility)
1. [Instant prompt](#instant-prompt)
1. [Show On Command](#show-on-command)
1. [Transient prompt](#transient-prompt)
1. [Current directory that just works](#current-directory-that-just-works)
1. [Extremely customizable](#extremely-customizable)
1. [Batteries included](#batteries-included)
1. [Installation](#installation) 1. [Installation](#installation)
1. [Manual](#manual) 1. [Manual](#manual)
1. [Oh My Zsh](#oh-my-zsh) 1. [Oh My Zsh](#oh-my-zsh)
@ -856,7 +884,9 @@ Zsh 5.1 or newer should work. Fast startup requires zsh >= 5.4.
1. [For new users](#for-new-users) 1. [For new users](#for-new-users)
1. [For Powerlevel9k users](#for-powerlevel9k-users) 1. [For Powerlevel9k users](#for-powerlevel9k-users)
1. [Fonts](#fonts) 1. [Fonts](#fonts)
1. [Recommended: Meslo Nerd Font patched for Powerlevel10k](#recommended-meslo-nerd-font-patched-for-powerlevel10k) 1. [Meslo Nerd Font patched for Powerlevel10k](#meslo-nerd-font-patched-for-powerlevel10k)
1. [Automatic font installation](#automatic-font-installation)
1. [Manual font installation](#manual-font-installation)
1. [Try it in Docker](#try-it-in-docker) 1. [Try it in Docker](#try-it-in-docker)
1. [Is it really fast?](#is-it-really-fast) 1. [Is it really fast?](#is-it-really-fast)
1. [License](#license) 1. [License](#license)
@ -882,3 +912,4 @@ Zsh 5.1 or newer should work. Fast startup requires zsh >= 5.4.
1. [Is there an AUR package for Powerlevel10k?](#is-there-an-aur-package-for-powerlevel10k) 1. [Is there an AUR package for Powerlevel10k?](#is-there-an-aur-package-for-powerlevel10k)
1. [I cannot make Powerlevel10k work with my plugin manager. Help!](#i-cannot-make-powerlevel10k-work-with-my-plugin-manager-help) 1. [I cannot make Powerlevel10k work with my plugin manager. Help!](#i-cannot-make-powerlevel10k-work-with-my-plugin-manager-help)
1. [What is the minimum supported zsh version?](#what-is-the-minimum-supported-zsh-version) 1. [What is the minimum supported zsh version?](#what-is-the-minimum-supported-zsh-version)
1. [How were these screenshots and animated gifs created?](#how-were-these-screenshots-and-animated-gifs-created)

Loading…
Cancel
Save