Customization/powerlevel10k
1
0
Fork 0
mirror of https://github.com/romkatv/powerlevel10k.git synced 2024-11-22 04:10:07 +00:00
Code Releases Activity

minor style fixes

Browse source
This commit is contained in:
romkatv 2020-01-29 18:42:39 +01:00
parent 7ae901212c
commit 6c507767b8
1 changed files with 12 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

22
README.md
View file

@ -46,16 +46,15 @@ customization can be done by editing this file. It has many comments to help you
configuration options. configuration options.
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 or Termux, `p10k configure` can install the font running `p10k configure`.
for you. Simply say *Yes* when asked.
### Unparalleled performance ### Unparalleled performance
When you hit *ENTER*, the next prompt appears instantly. With Powerlevel10k there is no prompt lag. When you hit *ENTER*, the next prompt appears instantly. With Powerlevel10k there is no prompt lag.
If you install Cygwin on Raspberry Pi, `cd` in a Linux Git repository and activate enough prompt If you install Cygwin on Raspberry Pi, `cd` into a Linux Git repository and activate enough prompt
segments to fill four prompt lines on both sides of the screen... wait, that's just crazy and no segments to fill four prompt lines on both sides of the screen... wait, that's just crazy and no
one ever does that. Probably impossible, too. The point is, Powerlevel10k prompt is always fast, no one ever does that. Probably impossible, too. The point is, Powerlevel10k prompt is always fast, no
matter what! matter what you do!
![Powerlevel10k Performance]( ![Powerlevel10k Performance](
https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/performance.gif) https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/performance.gif)
@ -91,13 +90,15 @@ How to switch to Powerlevel10k if you are using Powerlevel9k with Oh My Zsh:
2. Replace `ZSH_THEME="powerlevel9k/powerlevel9k"` with `ZSH_THEME="powerlevel10k/powerlevel10k"` 2. Replace `ZSH_THEME="powerlevel9k/powerlevel9k"` with `ZSH_THEME="powerlevel10k/powerlevel10k"`
3. Restart Zsh. 3. Restart Zsh.
Copy-paste this command to perform the 3 steps automatically:
```zsh ```zsh
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git $ZSH_CUSTOM/themes/powerlevel10k git clone --depth=1 https://github.com/romkatv/powerlevel10k.git $ZSH_CUSTOM/themes/powerlevel10k
sed 's/powerlevel9k/powerlevel10k/g' -i ~/.zshrc sed 's/powerlevel9k/powerlevel10k/g' -i ~/.zshrc
exec zsh exec zsh
``` ```
Optional steps (highly recommended): Optional steps (*highly recommended*):
4. Install [the recommended font](#meslo-nerd-font-patched-for-powerlevel10k). 4. Install [the recommended font](#meslo-nerd-font-patched-for-powerlevel10k).
5. Type `p10k configure` and explore exlusive Powerlevel10k prompt styles. 5. Type `p10k configure` and explore exlusive Powerlevel10k prompt styles.
@ -132,7 +133,7 @@ Powerlevel10k can remove Zsh startup lag *even if it's not caused by a theme*.
This feature is called *Instant Prompt*. You need to explicitly enable it through `p10k configure` This feature is called *Instant Prompt*. You need to explicitly enable it through `p10k configure`
or [manually](#what-is-instant-prompt). It does what it says on the tin -- prints prompt instantly or [manually](#what-is-instant-prompt). It does what it says on the tin -- prints prompt instantly
upon Zsh startup so you can start typing while plugins are still loading. upon Zsh startup allowing you to 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.
@ -146,13 +147,14 @@ image on the cluster defined by the current kubernetes context. If you frequentl
between "prod" and "testing", you might want to display the current context in Zsh prompt. If you do between "prod" and "testing", you might want to display the current context in Zsh prompt. If you do
likewise for AWS, Azure and Google Cloud credentials, prompt will get pretty crowded. likewise for AWS, Azure and Google Cloud credentials, prompt will get pretty crowded.
Enter *Show On Command*. This feature makes certain prompt segments appear only when they are Enter *Show On Command*. This feature makes prompt segments appear only when they are relevant to
relevant to the command you are currently typing. the command you are currently typing.
![Powerlevel10k Show On Command]( ![Powerlevel10k Show On Command](
https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/show-on-command.gif) https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/show-on-command.gif)
Configs created by `p10k configure` enable Show On Command for several prompt segments by default. Configs created by `p10k configure` enable Show On Command for several prompt segments by default.
Here's the relevant parameter for kubernetes context:
```zsh ```zsh
# Show prompt segment "kubecontext" only when the command you are typing # Show prompt segment "kubecontext" only when the command you are typing
@ -175,7 +177,7 @@ prompt when accepting a command line.
Transient Prompt makes it much easier to copy-paste series of commands from the terminal scrollback. Transient Prompt makes it much easier to copy-paste series of commands from the terminal scrollback.
Tip: If you enable Transient Prompt, take advantage of two-line prompt. You'll get the benefit of Tip: If you enable Transient Prompt, take advantage of two-line prompt. You'll get the benefit of
extra space for typing commands without the usual downside of reduced scrollback density. extra space for typing commands without the usual drawback of reduced scrollback density.
### Current directory that just works ### Current directory that just works
@ -192,9 +194,9 @@ would be ambiguous (there was `~/wireguard` when the session was recorded). The
Directory segments are shown in one of three colors: Directory segments are shown in one of three colors:
- Truncated segments are bleak.
- Important segments are bright and never truncated. These include the first and the last segment, - Important segments are bright and never truncated. These include the first and the last segment,
roots of Git repositories, etc. roots of Git repositories, etc.
- Truncated segments are bleak.
- Regular segments (not truncated but can be) use in-between color. - Regular segments (not truncated but can be) use in-between color.
Tip: If you copy-paste a truncated directory and hit *TAB*, it'll complete to the original. Tip: If you copy-paste a truncated directory and hit *TAB*, it'll complete to the original.