diff options
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 20 |
1 files changed, 17 insertions, 3 deletions
@@ -34,6 +34,7 @@ it will generate the same prompt. 1. [Why is my cursor in the wrong place?](#why-is-my-cursor-in-the-wrong-place) 1. [Why is my prompt wrapping around in a weird way?](#why-is-my-prompt-wrapping-around-in-a-weird-way) 1. [Why is my right prompt in the wrong place?](#why-is-my-right-prompt-in-the-wrong-place) + 1. [Why does the configuration wizard run automatically every time I start zsh?](#why-does-the-configuration-wizard-run-automatically-every-time-i-start-zsh) 1. [I cannot install the recommended font. Help!](#i-cannot-install-the-recommended-font-help) 1. [Why do I have a question mark symbol in my prompt? Is my font broken?](#why-do-i-have-a-question-mark-symbol-in-my-prompt-is-my-font-broken) 1. [What do different symbols in Git status mean?](#what-do-different-symbols-in-git-status-mean) @@ -100,7 +101,7 @@ supported by Powerlevel10k. ### For new users -On the first run Powerlevel10k configuration wizard will ask you a few questions and configure +On the first run, Powerlevel10k configuration wizard will ask you a few questions and configure your prompt. If it doesn't trigger automatically, type `p10k configure`. You can further customize your prompt by editing `~/.p10k.zsh`. @@ -160,7 +161,7 @@ applications on your system. Configure your terminal to use this font: Run `p10k configure` to pick the best style for your new font. -_Using a different terminal and know how to set font for it? Share your knowledge by sending a PR +_Using a different terminal and know how to set the font for it? Share your knowledge by sending a PR to expand the list!_ ## Try it in Docker @@ -215,7 +216,7 @@ covered by the same license. ### <a name='instant-prompt'></a>What is instant prompt? *Instant Prompt* is an optional feature of Powerlevel10k. When enabled, it gives you a limited -prompt within a few milliseconds of starting zsh, alowing 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 is initializing. Once initialization is complete, the full-featured Powerlevel10k prompt will seamlessly replace instant prompt. @@ -385,6 +386,19 @@ See [Why is my cursor in the wrong place?](#why-is-my-cursor-in-the-wrong-place) See [Why is my cursor in the wrong place?](#why-is-my-cursor-in-the-wrong-place) +### Why does the configuration wizard run automatically every time I start zsh? + +When Powerlevel10k starts, it automatically runs `p10k configure` if no `POWERLEVEL9K_*` +parameters are defined. Based on your prompt style choices, the configuration wizard creates +`~/.p10k.zsh` with a bunch of `POWERLEVEL9K_*` parameters in it and adds a line to `~/.zshrc` to +source this file. The next time you start zsh, the configuration wizard shouldn't run automatically. +If it does, this means the evaluation of `~/.zshrc` terminates prematurely before it reaches the +line that sources `~/.p10k.zsh`. This most often happens due to syntax errors in `~/.zshrc`. These +errors get hidden by the configuration wizard screen, so you don't notice them. Scroll up in the +first configuration wizard screen to see these errors. Alternatively, run +`POWERLEVEL9K_DISABLE_CONFIGURATION_WIZARD=true zsh` to start zsh without automatically running the +configuration wizard. Once you can see the errors, fix `~/.zshrc` to get rid of them. + ### I cannot install the recommended font. Help! Once you download [the recommended font](#recommended-meslo-nerd-font-patched-for-powerlevel10k), |