mirror of
https://github.com/romkatv/powerlevel10k.git
synced 2025-12-25 22:22:31 +01:00
Moving docs
This commit is contained in:
John Long
parent
781a2e35b7
commit
59781d8744
65 changed files with 13830 additions and 0 deletions
|
|
@ -1,69 +0,0 @@
|
|||
# Batteries included
|
||||
|
||||
Powerlevel10k comes with dozens of built-in high quality segments. When you run `p10k configure`
|
||||
and choose any style except [Pure](pure_compatibility.md), many of these segments get enabled by
|
||||
default while others be manually enabled by opening `~/.p10k.zsh` and uncommenting them. You can
|
||||
enable as many segments as you like. It won't slow down your prompt or Zsh startup.
|
||||
|
||||
| Segment | Meaning |
|
||||
| -----------------------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `os_icon` | your OS logo (apple for macOS, swirl for debian, etc.) |
|
||||
| `dir` | current working directory |
|
||||
| `vcs` | Git repository status |
|
||||
| `prompt_char` | multi-functional prompt symbol; changes depending on vi mode: `❯`, `❮`, `V`, `▶` for insert, command, visual and replace mode respectively; turns red on error |
|
||||
| `context` | user@hostname |
|
||||
| `status` | exit code of the last command |
|
||||
| `command_execution_time` | duration (wall time) of the last command |
|
||||
| `background_jobs` | presence of background jobs |
|
||||
| `time` | current time |
|
||||
| `direnv` | [direnv](https://direnv.net/) status |
|
||||
| `asdf` | tool versions from [asdf](https://github.com/asdf-vm/asdf) |
|
||||
| `virtualenv` | python environment from [venv](https://docs.python.org/3/library/venv.html) |
|
||||
| `anaconda` | virtual environment from [conda](https://conda.io/) |
|
||||
| `pyenv` | python environment from [pyenv](https://github.com/pyenv/pyenv) |
|
||||
| `goenv` | go environment from [goenv](https://github.com/syndbg/goenv) |
|
||||
| `nodenv` | node.js environment from [nodenv](https://github.com/nodenv/nodenv) |
|
||||
| `nvm` | node.js environment from [nvm](https://github.com/nvm-sh/nvm) |
|
||||
| `nodeenv` | node.js environment from [nodeenv](https://github.com/ekalinin/nodeenv) |
|
||||
| `rbenv` | ruby environment from [rbenv](https://github.com/rbenv/rbenv) |
|
||||
| `rvm` | ruby environment from [rvm](https://rvm.io) |
|
||||
| `fvm` | flutter environment from [fvm](https://github.com/leoafarias/fvm) |
|
||||
| `luaenv` | lua environment from [luaenv](https://github.com/cehoffman/luaenv) |
|
||||
| `jenv` | java environment from [jenv](https://github.com/jenv/jenv) |
|
||||
| `plenv` | perl environment from [plenv](https://github.com/tokuhirom/plenv) |
|
||||
| `phpenv` | php environment from [phpenv](https://github.com/phpenv/phpenv) |
|
||||
| `haskell_stack` | haskell version from [stack](https://haskellstack.org/) |
|
||||
| `node_version` | [node.js](https://nodejs.org/) version |
|
||||
| `go_version` | [go](https://golang.org) version |
|
||||
| `rust_version` | [rustc](https://www.rust-lang.org) version |
|
||||
| `dotnet_version` | [dotnet](https://dotnet.microsoft.com) version |
|
||||
| `php_version` | [php](https://www.php.net/) version |
|
||||
| `laravel_version` | [laravel php framework](https://laravel.com/) version |
|
||||
| `java_version` | [java](https://www.java.com/) version |
|
||||
| `package` | `name@version` from [package.json](https://docs.npmjs.com/files/package.json) |
|
||||
| `kubecontext` | current [kubernetes](https://kubernetes.io/) context |
|
||||
| `terraform` | [terraform](https://www.terraform.io) workspace |
|
||||
| `aws` | [aws profile](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html) |
|
||||
| `aws_eb_env` | [aws elastic beanstalk](https://aws.amazon.com/elasticbeanstalk/) environment |
|
||||
| `azure` | [azure](https://docs.microsoft.com/en-us/cli/azure) account name |
|
||||
| `gcloud` | [google cloud](https://cloud.google.com/) cli account and project |
|
||||
| `google_app_cred` | [google application credentials](https://cloud.google.com/docs/authentication/production) |
|
||||
| `nordvpn` | [nordvpn](https://nordvpn.com/) connection status |
|
||||
| `ranger` | [ranger](https://github.com/ranger/ranger) shell |
|
||||
| `nnn` | [nnn](https://github.com/jarun/nnn) shell |
|
||||
| `vim_shell` | [vim](https://www.vim.org/) shell (`:sh`) |
|
||||
| `midnight_commander` | [midnight commander](https://midnight-commander.org/) shell |
|
||||
| `nix_shell` | [nix shell](https://nixos.org/nixos/nix-pills/developing-with-nix-shell.html) indicator |
|
||||
| `todo` | [todo](https://github.com/todotxt/todo.txt-cli) items |
|
||||
| `timewarrior` | [timewarrior](https://timewarrior.net/) tracking status |
|
||||
| `taskwarrior` | [taskwarrior](https://taskwarrior.org/) task count |
|
||||
| `vpn_ip` | virtual private network indicator |
|
||||
| `ip` | IP address and bandwidth usage for a specified network interface |
|
||||
| `load` | CPU load |
|
||||
| `disk_usage` | disk usage |
|
||||
| `ram` | free RAM |
|
||||
| `swap` | used swap |
|
||||
| `public_ip` | public IP address |
|
||||
| `proxy` | system-wide http/https/ftp proxy |
|
||||
| `wifi` | WiFi speed |
|
||||
| `battery` | internal battery state and charge level (yep, batteries _literally_ included) |
|
||||
483
docs/features/batteries_included/index.html
Normal file
483
docs/features/batteries_included/index.html
Normal file
|
|
@ -0,0 +1,483 @@
|
|||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
|
||||
|
||||
<link rel="shortcut icon" href="../../img/favicon.ico">
|
||||
<title>Batteries included - Powerlevel10k</title>
|
||||
<link href="../../css/bootstrap.min.css" rel="stylesheet">
|
||||
<link href="../../css/font-awesome.min.css" rel="stylesheet">
|
||||
<link href="../../css/base.css" rel="stylesheet">
|
||||
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/atom-one-dark.min.css">
|
||||
|
||||
<script src="../../js/jquery-1.10.2.min.js" defer></script>
|
||||
<script src="../../js/bootstrap.min.js" defer></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/highlight.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/bash.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/zsh.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/sh.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/yaml.min.js"></script>
|
||||
<script>hljs.initHighlightingOnLoad();</script>
|
||||
</head>
|
||||
|
||||
<body>
|
||||
<div class="navbar fixed-top navbar-expand-lg navbar-dark bg-dark">
|
||||
<div class="container">
|
||||
<a class="navbar-brand" href="../..">Powerlevel10k</a>
|
||||
<!-- Expander button -->
|
||||
<button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
|
||||
<span class="navbar-toggler-icon"></span>
|
||||
</button>
|
||||
|
||||
<!-- Expanded navigation -->
|
||||
<div id="navbar-collapse" class="navbar-collapse collapse">
|
||||
<!-- Main navigation -->
|
||||
<ul class="nav navbar-nav">
|
||||
<li class="navitem">
|
||||
<a href="../.." class="nav-link">Home</a>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../installation/" class="nav-link">Get Started</a>
|
||||
</li>
|
||||
<li class="dropdown active">
|
||||
<a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Features <b class="caret"></b></a>
|
||||
<ul class="dropdown-menu">
|
||||
|
||||
<li>
|
||||
<a href="../wizard/" class="dropdown-item">Configuration wizard</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../uncompromising_performance/" class="dropdown-item">Uncompromising performance</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../p9k_compatibility/" class="dropdown-item">Powerlevel9k Compatibility</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../pure_compatibility/" class="dropdown-item">Pure compatibility</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../instant_prompt/" class="dropdown-item">Instant prompt</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../show_on_command/" class="dropdown-item">Show on command</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../transient_prompt/" class="dropdown-item">Transient prompt</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../current_directory/" class="dropdown-item">Current Directory that just works</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../customizable/" class="dropdown-item">Extremely Customizable</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="./" class="dropdown-item active">Batteries included</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../extensible/" class="dropdown-item">Extensible</a>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../faq/" class="nav-link">FAQ</a>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../troubleshooting/" class="nav-link">Troubleshooting</a>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<ul class="nav navbar-nav ml-auto">
|
||||
<li class="nav-item">
|
||||
<a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
|
||||
<i class="fa fa-search"></i> Search
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a rel="prev" href="../customizable/" class="nav-link">
|
||||
<i class="fa fa-arrow-left"></i> Previous
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a rel="next" href="../extensible/" class="nav-link">
|
||||
Next <i class="fa fa-arrow-right"></i>
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a href="https://github.com/romkatv/powerlevel10k/edit/master/docs/features/batteries_included.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="container">
|
||||
<div class="row">
|
||||
<div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
|
||||
<div class="navbar-header">
|
||||
<button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
|
||||
<span class="fa fa-angle-down"></span>
|
||||
</button>
|
||||
</div>
|
||||
|
||||
|
||||
<div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
|
||||
<ul class="nav flex-column">
|
||||
|
||||
<li class="nav-item" data-level="1"><a href="#batteries-included" class="nav-link">Batteries included</a>
|
||||
<ul class="nav flex-column">
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div></div>
|
||||
<div class="col-md-9" role="main">
|
||||
|
||||
<h1 id="batteries-included">Batteries included</h1>
|
||||
<p>Powerlevel10k comes with dozens of built-in high quality segments. When you run <code>p10k configure</code>
|
||||
and choose any style except <a href="../pure_compatibility/">Pure</a>, many of these segments get enabled by
|
||||
default while others be manually enabled by opening <code>~/.p10k.zsh</code> and uncommenting them. You can
|
||||
enable as many segments as you like. It won't slow down your prompt or Zsh startup.</p>
|
||||
<table>
|
||||
<thead>
|
||||
<tr>
|
||||
<th align="right">Segment</th>
|
||||
<th>Meaning</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td align="right"><code>os_icon</code></td>
|
||||
<td>your OS logo (apple for macOS, swirl for debian, etc.)</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>dir</code></td>
|
||||
<td>current working directory</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>vcs</code></td>
|
||||
<td>Git repository status</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>prompt_char</code></td>
|
||||
<td>multi-functional prompt symbol; changes depending on vi mode: <code>❯</code>, <code>❮</code>, <code>V</code>, <code>▶</code> for insert, command, visual and replace mode respectively; turns red on error</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>context</code></td>
|
||||
<td>user@hostname</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>status</code></td>
|
||||
<td>exit code of the last command</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>command_execution_time</code></td>
|
||||
<td>duration (wall time) of the last command</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>background_jobs</code></td>
|
||||
<td>presence of background jobs</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>time</code></td>
|
||||
<td>current time</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>direnv</code></td>
|
||||
<td><a href="https://direnv.net/">direnv</a> status</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>asdf</code></td>
|
||||
<td>tool versions from <a href="https://github.com/asdf-vm/asdf">asdf</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>virtualenv</code></td>
|
||||
<td>python environment from <a href="https://docs.python.org/3/library/venv.html">venv</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>anaconda</code></td>
|
||||
<td>virtual environment from <a href="https://conda.io/">conda</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>pyenv</code></td>
|
||||
<td>python environment from <a href="https://github.com/pyenv/pyenv">pyenv</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>goenv</code></td>
|
||||
<td>go environment from <a href="https://github.com/syndbg/goenv">goenv</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>nodenv</code></td>
|
||||
<td>node.js environment from <a href="https://github.com/nodenv/nodenv">nodenv</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>nvm</code></td>
|
||||
<td>node.js environment from <a href="https://github.com/nvm-sh/nvm">nvm</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>nodeenv</code></td>
|
||||
<td>node.js environment from <a href="https://github.com/ekalinin/nodeenv">nodeenv</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>rbenv</code></td>
|
||||
<td>ruby environment from <a href="https://github.com/rbenv/rbenv">rbenv</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>rvm</code></td>
|
||||
<td>ruby environment from <a href="https://rvm.io">rvm</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>fvm</code></td>
|
||||
<td>flutter environment from <a href="https://github.com/leoafarias/fvm">fvm</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>luaenv</code></td>
|
||||
<td>lua environment from <a href="https://github.com/cehoffman/luaenv">luaenv</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>jenv</code></td>
|
||||
<td>java environment from <a href="https://github.com/jenv/jenv">jenv</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>plenv</code></td>
|
||||
<td>perl environment from <a href="https://github.com/tokuhirom/plenv">plenv</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>phpenv</code></td>
|
||||
<td>php environment from <a href="https://github.com/phpenv/phpenv">phpenv</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>haskell_stack</code></td>
|
||||
<td>haskell version from <a href="https://haskellstack.org/">stack</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>node_version</code></td>
|
||||
<td><a href="https://nodejs.org/">node.js</a> version</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>go_version</code></td>
|
||||
<td><a href="https://golang.org">go</a> version</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>rust_version</code></td>
|
||||
<td><a href="https://www.rust-lang.org">rustc</a> version</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>dotnet_version</code></td>
|
||||
<td><a href="https://dotnet.microsoft.com">dotnet</a> version</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>php_version</code></td>
|
||||
<td><a href="https://www.php.net/">php</a> version</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>laravel_version</code></td>
|
||||
<td><a href="https://laravel.com/">laravel php framework</a> version</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>java_version</code></td>
|
||||
<td><a href="https://www.java.com/">java</a> version</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>package</code></td>
|
||||
<td><code>name@version</code> from <a href="https://docs.npmjs.com/files/package.json">package.json</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>kubecontext</code></td>
|
||||
<td>current <a href="https://kubernetes.io/">kubernetes</a> context</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>terraform</code></td>
|
||||
<td><a href="https://www.terraform.io">terraform</a> workspace</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>aws</code></td>
|
||||
<td><a href="https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html">aws profile</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>aws_eb_env</code></td>
|
||||
<td><a href="https://aws.amazon.com/elasticbeanstalk/">aws elastic beanstalk</a> environment</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>azure</code></td>
|
||||
<td><a href="https://docs.microsoft.com/en-us/cli/azure">azure</a> account name</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>gcloud</code></td>
|
||||
<td><a href="https://cloud.google.com/">google cloud</a> cli account and project</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>google_app_cred</code></td>
|
||||
<td><a href="https://cloud.google.com/docs/authentication/production">google application credentials</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>nordvpn</code></td>
|
||||
<td><a href="https://nordvpn.com/">nordvpn</a> connection status</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>ranger</code></td>
|
||||
<td><a href="https://github.com/ranger/ranger">ranger</a> shell</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>nnn</code></td>
|
||||
<td><a href="https://github.com/jarun/nnn">nnn</a> shell</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>vim_shell</code></td>
|
||||
<td><a href="https://www.vim.org/">vim</a> shell (<code>:sh</code>)</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>midnight_commander</code></td>
|
||||
<td><a href="https://midnight-commander.org/">midnight commander</a> shell</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>nix_shell</code></td>
|
||||
<td><a href="https://nixos.org/nixos/nix-pills/developing-with-nix-shell.html">nix shell</a> indicator</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>todo</code></td>
|
||||
<td><a href="https://github.com/todotxt/todo.txt-cli">todo</a> items</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>timewarrior</code></td>
|
||||
<td><a href="https://timewarrior.net/">timewarrior</a> tracking status</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>taskwarrior</code></td>
|
||||
<td><a href="https://taskwarrior.org/">taskwarrior</a> task count</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>vpn_ip</code></td>
|
||||
<td>virtual private network indicator</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>ip</code></td>
|
||||
<td>IP address and bandwidth usage for a specified network interface</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>load</code></td>
|
||||
<td>CPU load</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>disk_usage</code></td>
|
||||
<td>disk usage</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>ram</code></td>
|
||||
<td>free RAM</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>swap</code></td>
|
||||
<td>used swap</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>public_ip</code></td>
|
||||
<td>public IP address</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>proxy</code></td>
|
||||
<td>system-wide http/https/ftp proxy</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>wifi</code></td>
|
||||
<td>WiFi speed</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="right"><code>battery</code></td>
|
||||
<td>internal battery state and charge level (yep, batteries <em>literally</em> included)</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table></div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<footer class="col-md-12">
|
||||
<hr>
|
||||
<p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
|
||||
</footer>
|
||||
<script>
|
||||
var base_url = "../..",
|
||||
shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
|
||||
</script>
|
||||
<script src="../../js/base.js" defer></script>
|
||||
<script src="../../search/main.js" defer></script>
|
||||
|
||||
<div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
|
||||
<div class="modal-dialog modal-lg">
|
||||
<div class="modal-content">
|
||||
<div class="modal-header">
|
||||
<h4 class="modal-title" id="searchModalLabel">Search</h4>
|
||||
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
||||
</div>
|
||||
<div class="modal-body">
|
||||
<p>
|
||||
From here you can search these documents. Enter
|
||||
your search terms below.
|
||||
</p>
|
||||
<form>
|
||||
<div class="form-group">
|
||||
<input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
|
||||
</div>
|
||||
</form>
|
||||
<div id="mkdocs-search-results"></div>
|
||||
</div>
|
||||
<div class="modal-footer">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
|
||||
<div class="modal-dialog">
|
||||
<div class="modal-content">
|
||||
<div class="modal-header">
|
||||
<h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
|
||||
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
||||
</div>
|
||||
<div class="modal-body">
|
||||
<table class="table">
|
||||
<thead>
|
||||
<tr>
|
||||
<th style="width: 20%;">Keys</th>
|
||||
<th>Action</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td class="help shortcut"><kbd>?</kbd></td>
|
||||
<td>Open this help</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="next shortcut"><kbd>n</kbd></td>
|
||||
<td>Next page</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="prev shortcut"><kbd>p</kbd></td>
|
||||
<td>Previous page</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="search shortcut"><kbd>s</kbd></td>
|
||||
<td>Search</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<div class="modal-footer">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
|
@ -1,23 +0,0 @@
|
|||
# Current directory that just works
|
||||
|
||||
The current working directory is perhaps the most important prompt segment. Powerlevel10k goes to
|
||||
great length to highlight its important parts and to truncate it with the least loss of information
|
||||
when horizontal space gets scarce.
|
||||
|
||||
|
||||
|
||||
When the full directory doesn't fit, the leftmost segment gets truncated to its shortest unique
|
||||
prefix. In the screencast, `~/work` becomes `~/wo`. It couldn't be truncated to `~/w` because it
|
||||
would be ambiguous (there was `~/wireguard` when the session was recorded). The next segment --
|
||||
`projects` -- turns into `p` as there was nothing else that started with `p` in `~/work/`.
|
||||
|
||||
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,
|
||||
roots of Git repositories, etc.
|
||||
- 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.
|
||||
|
||||
_Troubleshooting_: [Directory is difficult to see in prompt when using Rainbow style.](../troubleshooting.md#directory-is-difficult-to-see-in-prompt-when-using-rainbow-style)
|
||||
246
docs/features/current_directory/index.html
Normal file
246
docs/features/current_directory/index.html
Normal file
|
|
@ -0,0 +1,246 @@
|
|||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
|
||||
|
||||
<link rel="shortcut icon" href="../../img/favicon.ico">
|
||||
<title>Current Directory that just works - Powerlevel10k</title>
|
||||
<link href="../../css/bootstrap.min.css" rel="stylesheet">
|
||||
<link href="../../css/font-awesome.min.css" rel="stylesheet">
|
||||
<link href="../../css/base.css" rel="stylesheet">
|
||||
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/atom-one-dark.min.css">
|
||||
|
||||
<script src="../../js/jquery-1.10.2.min.js" defer></script>
|
||||
<script src="../../js/bootstrap.min.js" defer></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/highlight.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/bash.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/zsh.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/sh.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/yaml.min.js"></script>
|
||||
<script>hljs.initHighlightingOnLoad();</script>
|
||||
</head>
|
||||
|
||||
<body>
|
||||
<div class="navbar fixed-top navbar-expand-lg navbar-dark bg-dark">
|
||||
<div class="container">
|
||||
<a class="navbar-brand" href="../..">Powerlevel10k</a>
|
||||
<!-- Expander button -->
|
||||
<button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
|
||||
<span class="navbar-toggler-icon"></span>
|
||||
</button>
|
||||
|
||||
<!-- Expanded navigation -->
|
||||
<div id="navbar-collapse" class="navbar-collapse collapse">
|
||||
<!-- Main navigation -->
|
||||
<ul class="nav navbar-nav">
|
||||
<li class="navitem">
|
||||
<a href="../.." class="nav-link">Home</a>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../installation/" class="nav-link">Get Started</a>
|
||||
</li>
|
||||
<li class="dropdown active">
|
||||
<a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Features <b class="caret"></b></a>
|
||||
<ul class="dropdown-menu">
|
||||
|
||||
<li>
|
||||
<a href="../wizard/" class="dropdown-item">Configuration wizard</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../uncompromising_performance/" class="dropdown-item">Uncompromising performance</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../p9k_compatibility/" class="dropdown-item">Powerlevel9k Compatibility</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../pure_compatibility/" class="dropdown-item">Pure compatibility</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../instant_prompt/" class="dropdown-item">Instant prompt</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../show_on_command/" class="dropdown-item">Show on command</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../transient_prompt/" class="dropdown-item">Transient prompt</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="./" class="dropdown-item active">Current Directory that just works</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../customizable/" class="dropdown-item">Extremely Customizable</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../batteries_included/" class="dropdown-item">Batteries included</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../extensible/" class="dropdown-item">Extensible</a>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../faq/" class="nav-link">FAQ</a>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../troubleshooting/" class="nav-link">Troubleshooting</a>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<ul class="nav navbar-nav ml-auto">
|
||||
<li class="nav-item">
|
||||
<a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
|
||||
<i class="fa fa-search"></i> Search
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a rel="prev" href="../transient_prompt/" class="nav-link">
|
||||
<i class="fa fa-arrow-left"></i> Previous
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a rel="next" href="../customizable/" class="nav-link">
|
||||
Next <i class="fa fa-arrow-right"></i>
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a href="https://github.com/romkatv/powerlevel10k/edit/master/docs/features/current_directory.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="container">
|
||||
<div class="row">
|
||||
<div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
|
||||
<div class="navbar-header">
|
||||
<button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
|
||||
<span class="fa fa-angle-down"></span>
|
||||
</button>
|
||||
</div>
|
||||
|
||||
|
||||
<div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
|
||||
<ul class="nav flex-column">
|
||||
|
||||
<li class="nav-item" data-level="1"><a href="#current-directory-that-just-works" class="nav-link">Current directory that just works</a>
|
||||
<ul class="nav flex-column">
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div></div>
|
||||
<div class="col-md-9" role="main">
|
||||
|
||||
<h1 id="current-directory-that-just-works">Current directory that just works</h1>
|
||||
<p>The current working directory is perhaps the most important prompt segment. Powerlevel10k goes to
|
||||
great length to highlight its important parts and to truncate it with the least loss of information
|
||||
when horizontal space gets scarce.</p>
|
||||
<p><img alt="Powerlevel10k Directory Truncation" src="https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/directory-truncation.gif" /></p>
|
||||
<p>When the full directory doesn't fit, the leftmost segment gets truncated to its shortest unique
|
||||
prefix. In the screencast, <code>~/work</code> becomes <code>~/wo</code>. It couldn't be truncated to <code>~/w</code> because it
|
||||
would be ambiguous (there was <code>~/wireguard</code> when the session was recorded). The next segment --
|
||||
<code>projects</code> -- turns into <code>p</code> as there was nothing else that started with <code>p</code> in <code>~/work/</code>.</p>
|
||||
<p>Directory segments are shown in one of three colors:</p>
|
||||
<ul>
|
||||
<li>Truncated segments are bleak.</li>
|
||||
<li>Important segments are bright and never truncated. These include the first and the last segment,
|
||||
roots of Git repositories, etc.</li>
|
||||
<li>Regular segments (not truncated but can be) use in-between color.</li>
|
||||
</ul>
|
||||
<p><em>Tip</em>: If you copy-paste a truncated directory and hit <em>TAB</em>, it'll complete to the original.</p>
|
||||
<p><em>Troubleshooting</em>: <a href="../../troubleshooting/#directory-is-difficult-to-see-in-prompt-when-using-rainbow-style">Directory is difficult to see in prompt when using Rainbow style.</a></p></div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<footer class="col-md-12">
|
||||
<hr>
|
||||
<p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
|
||||
</footer>
|
||||
<script>
|
||||
var base_url = "../..",
|
||||
shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
|
||||
</script>
|
||||
<script src="../../js/base.js" defer></script>
|
||||
<script src="../../search/main.js" defer></script>
|
||||
|
||||
<div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
|
||||
<div class="modal-dialog modal-lg">
|
||||
<div class="modal-content">
|
||||
<div class="modal-header">
|
||||
<h4 class="modal-title" id="searchModalLabel">Search</h4>
|
||||
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
||||
</div>
|
||||
<div class="modal-body">
|
||||
<p>
|
||||
From here you can search these documents. Enter
|
||||
your search terms below.
|
||||
</p>
|
||||
<form>
|
||||
<div class="form-group">
|
||||
<input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
|
||||
</div>
|
||||
</form>
|
||||
<div id="mkdocs-search-results"></div>
|
||||
</div>
|
||||
<div class="modal-footer">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
|
||||
<div class="modal-dialog">
|
||||
<div class="modal-content">
|
||||
<div class="modal-header">
|
||||
<h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
|
||||
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
||||
</div>
|
||||
<div class="modal-body">
|
||||
<table class="table">
|
||||
<thead>
|
||||
<tr>
|
||||
<th style="width: 20%;">Keys</th>
|
||||
<th>Action</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td class="help shortcut"><kbd>?</kbd></td>
|
||||
<td>Open this help</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="next shortcut"><kbd>n</kbd></td>
|
||||
<td>Next page</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="prev shortcut"><kbd>p</kbd></td>
|
||||
<td>Previous page</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="search shortcut"><kbd>s</kbd></td>
|
||||
<td>Search</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<div class="modal-footer">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
|
@ -1,18 +0,0 @@
|
|||
# Extremely customizable
|
||||
|
||||
Powerlevel10k can be configured to look like any other Zsh theme out there.
|
||||
|
||||
|
||||
|
||||
[Pure](pure_compatibility.md), [Powerlevel9k](p9k_compatibility.md) and [robbyrussell](../faq.md#how-to-make-powerlevel10k-look-like-robbyrussell-oh-my-zsh-theme) emulations are built-in.
|
||||
To emulate the appearance of other themes, you'll need to write a suitable configuration file. The
|
||||
best way to go about it is to run `p10k configure`, select the style that is the closest to your
|
||||
goal and then edit `~/.p10k.zsh`.
|
||||
|
||||
The full range of Powerlevel10k appearance spans from spartan:
|
||||
|
||||
|
||||
|
||||
To ~~ridiculous~~ extravagant:
|
||||
|
||||
|
||||
239
docs/features/customizable/index.html
Normal file
239
docs/features/customizable/index.html
Normal file
|
|
@ -0,0 +1,239 @@
|
|||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
|
||||
|
||||
<link rel="shortcut icon" href="../../img/favicon.ico">
|
||||
<title>Extremely Customizable - Powerlevel10k</title>
|
||||
<link href="../../css/bootstrap.min.css" rel="stylesheet">
|
||||
<link href="../../css/font-awesome.min.css" rel="stylesheet">
|
||||
<link href="../../css/base.css" rel="stylesheet">
|
||||
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/atom-one-dark.min.css">
|
||||
|
||||
<script src="../../js/jquery-1.10.2.min.js" defer></script>
|
||||
<script src="../../js/bootstrap.min.js" defer></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/highlight.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/bash.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/zsh.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/sh.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/yaml.min.js"></script>
|
||||
<script>hljs.initHighlightingOnLoad();</script>
|
||||
</head>
|
||||
|
||||
<body>
|
||||
<div class="navbar fixed-top navbar-expand-lg navbar-dark bg-dark">
|
||||
<div class="container">
|
||||
<a class="navbar-brand" href="../..">Powerlevel10k</a>
|
||||
<!-- Expander button -->
|
||||
<button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
|
||||
<span class="navbar-toggler-icon"></span>
|
||||
</button>
|
||||
|
||||
<!-- Expanded navigation -->
|
||||
<div id="navbar-collapse" class="navbar-collapse collapse">
|
||||
<!-- Main navigation -->
|
||||
<ul class="nav navbar-nav">
|
||||
<li class="navitem">
|
||||
<a href="../.." class="nav-link">Home</a>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../installation/" class="nav-link">Get Started</a>
|
||||
</li>
|
||||
<li class="dropdown active">
|
||||
<a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Features <b class="caret"></b></a>
|
||||
<ul class="dropdown-menu">
|
||||
|
||||
<li>
|
||||
<a href="../wizard/" class="dropdown-item">Configuration wizard</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../uncompromising_performance/" class="dropdown-item">Uncompromising performance</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../p9k_compatibility/" class="dropdown-item">Powerlevel9k Compatibility</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../pure_compatibility/" class="dropdown-item">Pure compatibility</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../instant_prompt/" class="dropdown-item">Instant prompt</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../show_on_command/" class="dropdown-item">Show on command</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../transient_prompt/" class="dropdown-item">Transient prompt</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../current_directory/" class="dropdown-item">Current Directory that just works</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="./" class="dropdown-item active">Extremely Customizable</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../batteries_included/" class="dropdown-item">Batteries included</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../extensible/" class="dropdown-item">Extensible</a>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../faq/" class="nav-link">FAQ</a>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../troubleshooting/" class="nav-link">Troubleshooting</a>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<ul class="nav navbar-nav ml-auto">
|
||||
<li class="nav-item">
|
||||
<a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
|
||||
<i class="fa fa-search"></i> Search
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a rel="prev" href="../current_directory/" class="nav-link">
|
||||
<i class="fa fa-arrow-left"></i> Previous
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a rel="next" href="../batteries_included/" class="nav-link">
|
||||
Next <i class="fa fa-arrow-right"></i>
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a href="https://github.com/romkatv/powerlevel10k/edit/master/docs/features/customizable.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="container">
|
||||
<div class="row">
|
||||
<div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
|
||||
<div class="navbar-header">
|
||||
<button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
|
||||
<span class="fa fa-angle-down"></span>
|
||||
</button>
|
||||
</div>
|
||||
|
||||
|
||||
<div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
|
||||
<ul class="nav flex-column">
|
||||
|
||||
<li class="nav-item" data-level="1"><a href="#extremely-customizable" class="nav-link">Extremely customizable</a>
|
||||
<ul class="nav flex-column">
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div></div>
|
||||
<div class="col-md-9" role="main">
|
||||
|
||||
<h1 id="extremely-customizable">Extremely customizable</h1>
|
||||
<p>Powerlevel10k can be configured to look like any other Zsh theme out there.</p>
|
||||
<p><img alt="Powerlevel10k Other Theme Emulation" src="https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/other-theme-emulation.gif" /></p>
|
||||
<p><a href="../pure_compatibility/">Pure</a>, <a href="../p9k_compatibility/">Powerlevel9k</a> and <a href="../../faq/#how-to-make-powerlevel10k-look-like-robbyrussell-oh-my-zsh-theme">robbyrussell</a> emulations are built-in.
|
||||
To emulate the appearance of other themes, you'll need to write a suitable configuration file. The
|
||||
best way to go about it is to run <code>p10k configure</code>, select the style that is the closest to your
|
||||
goal and then edit <code>~/.p10k.zsh</code>.</p>
|
||||
<p>The full range of Powerlevel10k appearance spans from spartan:</p>
|
||||
<p><img alt="Powerlevel10k Spartan Style" src="https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/spartan-style.png" /></p>
|
||||
<p>To ~~ridiculous~~ extravagant:</p>
|
||||
<p><img alt="Powerlevel10k Extravagant Style" src="https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/extravagant-style.png" /></p></div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<footer class="col-md-12">
|
||||
<hr>
|
||||
<p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
|
||||
</footer>
|
||||
<script>
|
||||
var base_url = "../..",
|
||||
shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
|
||||
</script>
|
||||
<script src="../../js/base.js" defer></script>
|
||||
<script src="../../search/main.js" defer></script>
|
||||
|
||||
<div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
|
||||
<div class="modal-dialog modal-lg">
|
||||
<div class="modal-content">
|
||||
<div class="modal-header">
|
||||
<h4 class="modal-title" id="searchModalLabel">Search</h4>
|
||||
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
||||
</div>
|
||||
<div class="modal-body">
|
||||
<p>
|
||||
From here you can search these documents. Enter
|
||||
your search terms below.
|
||||
</p>
|
||||
<form>
|
||||
<div class="form-group">
|
||||
<input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
|
||||
</div>
|
||||
</form>
|
||||
<div id="mkdocs-search-results"></div>
|
||||
</div>
|
||||
<div class="modal-footer">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
|
||||
<div class="modal-dialog">
|
||||
<div class="modal-content">
|
||||
<div class="modal-header">
|
||||
<h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
|
||||
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
||||
</div>
|
||||
<div class="modal-body">
|
||||
<table class="table">
|
||||
<thead>
|
||||
<tr>
|
||||
<th style="width: 20%;">Keys</th>
|
||||
<th>Action</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td class="help shortcut"><kbd>?</kbd></td>
|
||||
<td>Open this help</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="next shortcut"><kbd>n</kbd></td>
|
||||
<td>Next page</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="prev shortcut"><kbd>p</kbd></td>
|
||||
<td>Previous page</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="search shortcut"><kbd>s</kbd></td>
|
||||
<td>Search</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<div class="modal-footer">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
|
@ -1,16 +0,0 @@
|
|||
# Extensible
|
||||
|
||||
If there is no prompt segment that does what you need, implement your own. Powerlevel10k provides
|
||||
public API for defining segments that are as fast and as flexible as built-in ones.
|
||||
|
||||
|
||||
|
||||
On Linux you can fetch current CPU temperature by reading `/sys/class/thermal/thermal_zone0/temp`.
|
||||
The screencast shows how to define a prompt segment to display this value. Once the segment is
|
||||
defined, you can use it like any other segment. All standard customization parameters will work for
|
||||
it out of the box.
|
||||
|
||||
Type `p10k help segment` for reference.
|
||||
|
||||
_Tip_: Prefix names of your own segments with `my_` to avoid clashes with future versions of
|
||||
Powerlevel10k.
|
||||
239
docs/features/extensible/index.html
Normal file
239
docs/features/extensible/index.html
Normal file
|
|
@ -0,0 +1,239 @@
|
|||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
|
||||
|
||||
<link rel="shortcut icon" href="../../img/favicon.ico">
|
||||
<title>Extensible - Powerlevel10k</title>
|
||||
<link href="../../css/bootstrap.min.css" rel="stylesheet">
|
||||
<link href="../../css/font-awesome.min.css" rel="stylesheet">
|
||||
<link href="../../css/base.css" rel="stylesheet">
|
||||
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/atom-one-dark.min.css">
|
||||
|
||||
<script src="../../js/jquery-1.10.2.min.js" defer></script>
|
||||
<script src="../../js/bootstrap.min.js" defer></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/highlight.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/bash.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/zsh.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/sh.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/yaml.min.js"></script>
|
||||
<script>hljs.initHighlightingOnLoad();</script>
|
||||
</head>
|
||||
|
||||
<body>
|
||||
<div class="navbar fixed-top navbar-expand-lg navbar-dark bg-dark">
|
||||
<div class="container">
|
||||
<a class="navbar-brand" href="../..">Powerlevel10k</a>
|
||||
<!-- Expander button -->
|
||||
<button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
|
||||
<span class="navbar-toggler-icon"></span>
|
||||
</button>
|
||||
|
||||
<!-- Expanded navigation -->
|
||||
<div id="navbar-collapse" class="navbar-collapse collapse">
|
||||
<!-- Main navigation -->
|
||||
<ul class="nav navbar-nav">
|
||||
<li class="navitem">
|
||||
<a href="../.." class="nav-link">Home</a>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../installation/" class="nav-link">Get Started</a>
|
||||
</li>
|
||||
<li class="dropdown active">
|
||||
<a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Features <b class="caret"></b></a>
|
||||
<ul class="dropdown-menu">
|
||||
|
||||
<li>
|
||||
<a href="../wizard/" class="dropdown-item">Configuration wizard</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../uncompromising_performance/" class="dropdown-item">Uncompromising performance</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../p9k_compatibility/" class="dropdown-item">Powerlevel9k Compatibility</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../pure_compatibility/" class="dropdown-item">Pure compatibility</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../instant_prompt/" class="dropdown-item">Instant prompt</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../show_on_command/" class="dropdown-item">Show on command</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../transient_prompt/" class="dropdown-item">Transient prompt</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../current_directory/" class="dropdown-item">Current Directory that just works</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../customizable/" class="dropdown-item">Extremely Customizable</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../batteries_included/" class="dropdown-item">Batteries included</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="./" class="dropdown-item active">Extensible</a>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../faq/" class="nav-link">FAQ</a>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../troubleshooting/" class="nav-link">Troubleshooting</a>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<ul class="nav navbar-nav ml-auto">
|
||||
<li class="nav-item">
|
||||
<a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
|
||||
<i class="fa fa-search"></i> Search
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a rel="prev" href="../batteries_included/" class="nav-link">
|
||||
<i class="fa fa-arrow-left"></i> Previous
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a rel="next" href="../../faq/" class="nav-link">
|
||||
Next <i class="fa fa-arrow-right"></i>
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a href="https://github.com/romkatv/powerlevel10k/edit/master/docs/features/extensible.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="container">
|
||||
<div class="row">
|
||||
<div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
|
||||
<div class="navbar-header">
|
||||
<button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
|
||||
<span class="fa fa-angle-down"></span>
|
||||
</button>
|
||||
</div>
|
||||
|
||||
|
||||
<div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
|
||||
<ul class="nav flex-column">
|
||||
|
||||
<li class="nav-item" data-level="1"><a href="#extensible" class="nav-link">Extensible</a>
|
||||
<ul class="nav flex-column">
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div></div>
|
||||
<div class="col-md-9" role="main">
|
||||
|
||||
<h1 id="extensible">Extensible</h1>
|
||||
<p>If there is no prompt segment that does what you need, implement your own. Powerlevel10k provides
|
||||
public API for defining segments that are as fast and as flexible as built-in ones.</p>
|
||||
<p><img alt="Powerlevel10k Custom Segment" src="https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/custom-segment.gif" /></p>
|
||||
<p>On Linux you can fetch current CPU temperature by reading <code>/sys/class/thermal/thermal_zone0/temp</code>.
|
||||
The screencast shows how to define a prompt segment to display this value. Once the segment is
|
||||
defined, you can use it like any other segment. All standard customization parameters will work for
|
||||
it out of the box.</p>
|
||||
<p>Type <code>p10k help segment</code> for reference.</p>
|
||||
<p><em>Tip</em>: Prefix names of your own segments with <code>my_</code> to avoid clashes with future versions of
|
||||
Powerlevel10k.</p></div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<footer class="col-md-12">
|
||||
<hr>
|
||||
<p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
|
||||
</footer>
|
||||
<script>
|
||||
var base_url = "../..",
|
||||
shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
|
||||
</script>
|
||||
<script src="../../js/base.js" defer></script>
|
||||
<script src="../../search/main.js" defer></script>
|
||||
|
||||
<div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
|
||||
<div class="modal-dialog modal-lg">
|
||||
<div class="modal-content">
|
||||
<div class="modal-header">
|
||||
<h4 class="modal-title" id="searchModalLabel">Search</h4>
|
||||
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
||||
</div>
|
||||
<div class="modal-body">
|
||||
<p>
|
||||
From here you can search these documents. Enter
|
||||
your search terms below.
|
||||
</p>
|
||||
<form>
|
||||
<div class="form-group">
|
||||
<input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
|
||||
</div>
|
||||
</form>
|
||||
<div id="mkdocs-search-results"></div>
|
||||
</div>
|
||||
<div class="modal-footer">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
|
||||
<div class="modal-dialog">
|
||||
<div class="modal-content">
|
||||
<div class="modal-header">
|
||||
<h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
|
||||
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
||||
</div>
|
||||
<div class="modal-body">
|
||||
<table class="table">
|
||||
<thead>
|
||||
<tr>
|
||||
<th style="width: 20%;">Keys</th>
|
||||
<th>Action</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td class="help shortcut"><kbd>?</kbd></td>
|
||||
<td>Open this help</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="next shortcut"><kbd>n</kbd></td>
|
||||
<td>Next page</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="prev shortcut"><kbd>p</kbd></td>
|
||||
<td>Previous page</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="search shortcut"><kbd>s</kbd></td>
|
||||
<td>Search</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<div class="modal-footer">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
232
docs/features/index.html
Normal file
232
docs/features/index.html
Normal file
|
|
@ -0,0 +1,232 @@
|
|||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
|
||||
|
||||
<link rel="shortcut icon" href="../img/favicon.ico">
|
||||
<title>Features - Powerlevel10k</title>
|
||||
<link href="../css/bootstrap.min.css" rel="stylesheet">
|
||||
<link href="../css/font-awesome.min.css" rel="stylesheet">
|
||||
<link href="../css/base.css" rel="stylesheet">
|
||||
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/atom-one-dark.min.css">
|
||||
|
||||
<script src="../js/jquery-1.10.2.min.js" defer></script>
|
||||
<script src="../js/bootstrap.min.js" defer></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/highlight.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/bash.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/zsh.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/sh.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/yaml.min.js"></script>
|
||||
<script>hljs.initHighlightingOnLoad();</script>
|
||||
</head>
|
||||
|
||||
<body>
|
||||
<div class="navbar fixed-top navbar-expand-lg navbar-dark bg-dark">
|
||||
<div class="container">
|
||||
<a class="navbar-brand" href="..">Powerlevel10k</a>
|
||||
<!-- Expander button -->
|
||||
<button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
|
||||
<span class="navbar-toggler-icon"></span>
|
||||
</button>
|
||||
|
||||
<!-- Expanded navigation -->
|
||||
<div id="navbar-collapse" class="navbar-collapse collapse">
|
||||
<!-- Main navigation -->
|
||||
<ul class="nav navbar-nav">
|
||||
<li class="navitem">
|
||||
<a href=".." class="nav-link">Home</a>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../installation/" class="nav-link">Get Started</a>
|
||||
</li>
|
||||
<li class="dropdown">
|
||||
<a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Features <b class="caret"></b></a>
|
||||
<ul class="dropdown-menu">
|
||||
|
||||
<li>
|
||||
<a href="wizard/" class="dropdown-item">Configuration wizard</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="uncompromising_performance/" class="dropdown-item">Uncompromising performance</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="p9k_compatibility/" class="dropdown-item">Powerlevel9k Compatibility</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="pure_compatibility/" class="dropdown-item">Pure compatibility</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="instant_prompt/" class="dropdown-item">Instant prompt</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="show_on_command/" class="dropdown-item">Show on command</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="transient_prompt/" class="dropdown-item">Transient prompt</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="current_directory/" class="dropdown-item">Current Directory that just works</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="customizable/" class="dropdown-item">Extremely Customizable</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="batteries_included/" class="dropdown-item">Batteries included</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="extensible/" class="dropdown-item">Extensible</a>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../faq/" class="nav-link">FAQ</a>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../troubleshooting/" class="nav-link">Troubleshooting</a>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<ul class="nav navbar-nav ml-auto">
|
||||
<li class="nav-item">
|
||||
<a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
|
||||
<i class="fa fa-search"></i> Search
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a href="https://github.com/romkatv/powerlevel10k/edit/master/docs/features.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="container">
|
||||
<div class="row">
|
||||
<div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
|
||||
<div class="navbar-header">
|
||||
<button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
|
||||
<span class="fa fa-angle-down"></span>
|
||||
</button>
|
||||
</div>
|
||||
|
||||
|
||||
<div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
|
||||
<ul class="nav flex-column">
|
||||
|
||||
<li class="nav-item" data-level="1"><a href="#features" class="nav-link">Features</a>
|
||||
<ul class="nav flex-column">
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div></div>
|
||||
<div class="col-md-9" role="main">
|
||||
|
||||
<h1 id="features">Features</h1>
|
||||
<ul>
|
||||
<li><a href="wizard/">Configuration wizard</a></li>
|
||||
<li><a href="uncompromising_performance/">Uncompromising performance</a></li>
|
||||
<li><a href="p9k_compatibility/">Powerlevel9k Compatibility</a></li>
|
||||
<li><a href="pure_compatibility/">Pure compatibility</a></li>
|
||||
<li><a href="instant_prompt/">Instant prompt</a></li>
|
||||
<li><a href="show_on_command/">Show on Command</a></li>
|
||||
<li><a href="transient_prompt/">Transient Prompt</a></li>
|
||||
<li><a href="current_directory/">Current Directory that just works</a></li>
|
||||
<li><a href="customizable/">Extremely Customizable</a></li>
|
||||
<li><a href="batteries_included/">Batteries included</a></li>
|
||||
<li><a href="extensible/">Extensible</a></li>
|
||||
</ul></div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<footer class="col-md-12">
|
||||
<hr>
|
||||
<p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
|
||||
</footer>
|
||||
<script>
|
||||
var base_url = "..",
|
||||
shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
|
||||
</script>
|
||||
<script src="../js/base.js" defer></script>
|
||||
<script src="../search/main.js" defer></script>
|
||||
|
||||
<div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
|
||||
<div class="modal-dialog modal-lg">
|
||||
<div class="modal-content">
|
||||
<div class="modal-header">
|
||||
<h4 class="modal-title" id="searchModalLabel">Search</h4>
|
||||
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
||||
</div>
|
||||
<div class="modal-body">
|
||||
<p>
|
||||
From here you can search these documents. Enter
|
||||
your search terms below.
|
||||
</p>
|
||||
<form>
|
||||
<div class="form-group">
|
||||
<input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
|
||||
</div>
|
||||
</form>
|
||||
<div id="mkdocs-search-results"></div>
|
||||
</div>
|
||||
<div class="modal-footer">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
|
||||
<div class="modal-dialog">
|
||||
<div class="modal-content">
|
||||
<div class="modal-header">
|
||||
<h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
|
||||
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
||||
</div>
|
||||
<div class="modal-body">
|
||||
<table class="table">
|
||||
<thead>
|
||||
<tr>
|
||||
<th style="width: 20%;">Keys</th>
|
||||
<th>Action</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td class="help shortcut"><kbd>?</kbd></td>
|
||||
<td>Open this help</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="next shortcut"><kbd>n</kbd></td>
|
||||
<td>Next page</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="prev shortcut"><kbd>p</kbd></td>
|
||||
<td>Previous page</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="search shortcut"><kbd>s</kbd></td>
|
||||
<td>Search</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<div class="modal-footer">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
|
@ -1,20 +0,0 @@
|
|||
# Instant prompt
|
||||
|
||||
If your `~/.zshrc` loads many plugins, or perhaps just a few slow ones
|
||||
(for example, [pyenv](https://github.com/pyenv/pyenv) or [nvm](https://github.com/nvm-sh/nvm)), you
|
||||
may have noticed that it takes some time for Zsh to start.
|
||||
|
||||
|
||||
|
||||
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`
|
||||
or [manually](../faq.md#how-do-i-enable-instant-prompt). It does what it says on the tin -- prints prompt
|
||||
instantly 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
|
||||
_removes_ it outright.
|
||||
|
||||
_FAQ:_ [How do I enable instant prompt?](../faq.md#how-do-i-enable-instant-prompt)
|
||||
241
docs/features/instant_prompt/index.html
Normal file
241
docs/features/instant_prompt/index.html
Normal file
|
|
@ -0,0 +1,241 @@
|
|||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
|
||||
|
||||
<link rel="shortcut icon" href="../../img/favicon.ico">
|
||||
<title>Instant prompt - Powerlevel10k</title>
|
||||
<link href="../../css/bootstrap.min.css" rel="stylesheet">
|
||||
<link href="../../css/font-awesome.min.css" rel="stylesheet">
|
||||
<link href="../../css/base.css" rel="stylesheet">
|
||||
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/atom-one-dark.min.css">
|
||||
|
||||
<script src="../../js/jquery-1.10.2.min.js" defer></script>
|
||||
<script src="../../js/bootstrap.min.js" defer></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/highlight.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/bash.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/zsh.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/sh.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/yaml.min.js"></script>
|
||||
<script>hljs.initHighlightingOnLoad();</script>
|
||||
</head>
|
||||
|
||||
<body>
|
||||
<div class="navbar fixed-top navbar-expand-lg navbar-dark bg-dark">
|
||||
<div class="container">
|
||||
<a class="navbar-brand" href="../..">Powerlevel10k</a>
|
||||
<!-- Expander button -->
|
||||
<button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
|
||||
<span class="navbar-toggler-icon"></span>
|
||||
</button>
|
||||
|
||||
<!-- Expanded navigation -->
|
||||
<div id="navbar-collapse" class="navbar-collapse collapse">
|
||||
<!-- Main navigation -->
|
||||
<ul class="nav navbar-nav">
|
||||
<li class="navitem">
|
||||
<a href="../.." class="nav-link">Home</a>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../installation/" class="nav-link">Get Started</a>
|
||||
</li>
|
||||
<li class="dropdown active">
|
||||
<a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Features <b class="caret"></b></a>
|
||||
<ul class="dropdown-menu">
|
||||
|
||||
<li>
|
||||
<a href="../wizard/" class="dropdown-item">Configuration wizard</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../uncompromising_performance/" class="dropdown-item">Uncompromising performance</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../p9k_compatibility/" class="dropdown-item">Powerlevel9k Compatibility</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../pure_compatibility/" class="dropdown-item">Pure compatibility</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="./" class="dropdown-item active">Instant prompt</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../show_on_command/" class="dropdown-item">Show on command</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../transient_prompt/" class="dropdown-item">Transient prompt</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../current_directory/" class="dropdown-item">Current Directory that just works</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../customizable/" class="dropdown-item">Extremely Customizable</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../batteries_included/" class="dropdown-item">Batteries included</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../extensible/" class="dropdown-item">Extensible</a>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../faq/" class="nav-link">FAQ</a>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../troubleshooting/" class="nav-link">Troubleshooting</a>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<ul class="nav navbar-nav ml-auto">
|
||||
<li class="nav-item">
|
||||
<a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
|
||||
<i class="fa fa-search"></i> Search
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a rel="prev" href="../pure_compatibility/" class="nav-link">
|
||||
<i class="fa fa-arrow-left"></i> Previous
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a rel="next" href="../show_on_command/" class="nav-link">
|
||||
Next <i class="fa fa-arrow-right"></i>
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a href="https://github.com/romkatv/powerlevel10k/edit/master/docs/features/instant_prompt.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="container">
|
||||
<div class="row">
|
||||
<div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
|
||||
<div class="navbar-header">
|
||||
<button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
|
||||
<span class="fa fa-angle-down"></span>
|
||||
</button>
|
||||
</div>
|
||||
|
||||
|
||||
<div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
|
||||
<ul class="nav flex-column">
|
||||
|
||||
<li class="nav-item" data-level="1"><a href="#instant-prompt" class="nav-link">Instant prompt</a>
|
||||
<ul class="nav flex-column">
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div></div>
|
||||
<div class="col-md-9" role="main">
|
||||
|
||||
<h1 id="instant-prompt">Instant prompt</h1>
|
||||
<p>If your <code>~/.zshrc</code> loads many plugins, or perhaps just a few slow ones
|
||||
(for example, <a href="https://github.com/pyenv/pyenv">pyenv</a> or <a href="https://github.com/nvm-sh/nvm">nvm</a>), you
|
||||
may have noticed that it takes some time for Zsh to start.</p>
|
||||
<p><img alt="Powerlevel10k No Instant Prompt" src="https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/no-instant-prompt.gif" /></p>
|
||||
<p>Powerlevel10k can remove Zsh startup lag <strong>even if it's not caused by a theme</strong>.</p>
|
||||
<p><img alt="Powerlevel10k Instant Prompt" src="https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/instant-prompt.gif" /></p>
|
||||
<p>This feature is called <em>Instant Prompt</em>. You need to explicitly enable it through <code>p10k configure</code>
|
||||
or <a href="../../faq/#how-do-i-enable-instant-prompt">manually</a>. It does what it says on the tin -- prints prompt
|
||||
instantly upon Zsh startup allowing you to start typing while plugins are still loading.</p>
|
||||
<p>Other themes <em>increase</em> Zsh startup lag -- some by a lot, others by a just a little. Powerlevel10k
|
||||
<em>removes</em> it outright.</p>
|
||||
<p><em>FAQ:</em> <a href="../../faq/#how-do-i-enable-instant-prompt">How do I enable instant prompt?</a></p></div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<footer class="col-md-12">
|
||||
<hr>
|
||||
<p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
|
||||
</footer>
|
||||
<script>
|
||||
var base_url = "../..",
|
||||
shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
|
||||
</script>
|
||||
<script src="../../js/base.js" defer></script>
|
||||
<script src="../../search/main.js" defer></script>
|
||||
|
||||
<div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
|
||||
<div class="modal-dialog modal-lg">
|
||||
<div class="modal-content">
|
||||
<div class="modal-header">
|
||||
<h4 class="modal-title" id="searchModalLabel">Search</h4>
|
||||
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
||||
</div>
|
||||
<div class="modal-body">
|
||||
<p>
|
||||
From here you can search these documents. Enter
|
||||
your search terms below.
|
||||
</p>
|
||||
<form>
|
||||
<div class="form-group">
|
||||
<input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
|
||||
</div>
|
||||
</form>
|
||||
<div id="mkdocs-search-results"></div>
|
||||
</div>
|
||||
<div class="modal-footer">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
|
||||
<div class="modal-dialog">
|
||||
<div class="modal-content">
|
||||
<div class="modal-header">
|
||||
<h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
|
||||
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
||||
</div>
|
||||
<div class="modal-body">
|
||||
<table class="table">
|
||||
<thead>
|
||||
<tr>
|
||||
<th style="width: 20%;">Keys</th>
|
||||
<th>Action</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td class="help shortcut"><kbd>?</kbd></td>
|
||||
<td>Open this help</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="next shortcut"><kbd>n</kbd></td>
|
||||
<td>Next page</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="prev shortcut"><kbd>p</kbd></td>
|
||||
<td>Previous page</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="search shortcut"><kbd>s</kbd></td>
|
||||
<td>Search</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<div class="modal-footer">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
|
@ -1,17 +0,0 @@
|
|||
# Powerlevel9k compatibility
|
||||
|
||||
Powerlevel10k understands all [Powerlevel9k](https://github.com/Powerlevel9k/powerlevel9k)
|
||||
configuration parameters.
|
||||
|
||||
|
||||
|
||||
[Migration](#installation) from Powerlevel9k to Powerlevel10k is a straightforward process. All
|
||||
your `POWERLEVEL9K` configuration parameters will still work. Prompt will look the same as before
|
||||
([almost](#does-powerlevel10k-always-render-exactly-the-same-prompt-as-powerlevel9k-given-the-same-config))
|
||||
but it will be [much faster](#uncompromising-performance) ([certainly](#is-it-really-fast)).
|
||||
|
||||
_FAQ_:
|
||||
|
||||
- [I'm using Powerlevel9k with Oh My Zsh. How do I migrate?](../faq.md#im-using-powerlevel9k-with-oh-my-zsh-how-do-i-migrate)
|
||||
- [Does Powerlevel10k always render exactly the same prompt as Powerlevel9k given the same config?](../faq.md#does-powerlevel10k-always-render-exactly-the-same-prompt-as-powerlevel9k-given-the-same-config)
|
||||
- [What is the relationship between Powerlevel9k and Powerlevel10k?](../faq.md#What-is-the-relationship-between-powerlevel9k-and-powerlevel10k)
|
||||
242
docs/features/p9k_compatibility/index.html
Normal file
242
docs/features/p9k_compatibility/index.html
Normal file
|
|
@ -0,0 +1,242 @@
|
|||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
|
||||
|
||||
<link rel="shortcut icon" href="../../img/favicon.ico">
|
||||
<title>Powerlevel9k Compatibility - Powerlevel10k</title>
|
||||
<link href="../../css/bootstrap.min.css" rel="stylesheet">
|
||||
<link href="../../css/font-awesome.min.css" rel="stylesheet">
|
||||
<link href="../../css/base.css" rel="stylesheet">
|
||||
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/atom-one-dark.min.css">
|
||||
|
||||
<script src="../../js/jquery-1.10.2.min.js" defer></script>
|
||||
<script src="../../js/bootstrap.min.js" defer></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/highlight.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/bash.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/zsh.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/sh.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/yaml.min.js"></script>
|
||||
<script>hljs.initHighlightingOnLoad();</script>
|
||||
</head>
|
||||
|
||||
<body>
|
||||
<div class="navbar fixed-top navbar-expand-lg navbar-dark bg-dark">
|
||||
<div class="container">
|
||||
<a class="navbar-brand" href="../..">Powerlevel10k</a>
|
||||
<!-- Expander button -->
|
||||
<button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
|
||||
<span class="navbar-toggler-icon"></span>
|
||||
</button>
|
||||
|
||||
<!-- Expanded navigation -->
|
||||
<div id="navbar-collapse" class="navbar-collapse collapse">
|
||||
<!-- Main navigation -->
|
||||
<ul class="nav navbar-nav">
|
||||
<li class="navitem">
|
||||
<a href="../.." class="nav-link">Home</a>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../installation/" class="nav-link">Get Started</a>
|
||||
</li>
|
||||
<li class="dropdown active">
|
||||
<a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Features <b class="caret"></b></a>
|
||||
<ul class="dropdown-menu">
|
||||
|
||||
<li>
|
||||
<a href="../wizard/" class="dropdown-item">Configuration wizard</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../uncompromising_performance/" class="dropdown-item">Uncompromising performance</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="./" class="dropdown-item active">Powerlevel9k Compatibility</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../pure_compatibility/" class="dropdown-item">Pure compatibility</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../instant_prompt/" class="dropdown-item">Instant prompt</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../show_on_command/" class="dropdown-item">Show on command</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../transient_prompt/" class="dropdown-item">Transient prompt</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../current_directory/" class="dropdown-item">Current Directory that just works</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../customizable/" class="dropdown-item">Extremely Customizable</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../batteries_included/" class="dropdown-item">Batteries included</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../extensible/" class="dropdown-item">Extensible</a>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../faq/" class="nav-link">FAQ</a>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../troubleshooting/" class="nav-link">Troubleshooting</a>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<ul class="nav navbar-nav ml-auto">
|
||||
<li class="nav-item">
|
||||
<a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
|
||||
<i class="fa fa-search"></i> Search
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a rel="prev" href="../uncompromising_performance/" class="nav-link">
|
||||
<i class="fa fa-arrow-left"></i> Previous
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a rel="next" href="../pure_compatibility/" class="nav-link">
|
||||
Next <i class="fa fa-arrow-right"></i>
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a href="https://github.com/romkatv/powerlevel10k/edit/master/docs/features/p9k_compatibility.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="container">
|
||||
<div class="row">
|
||||
<div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
|
||||
<div class="navbar-header">
|
||||
<button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
|
||||
<span class="fa fa-angle-down"></span>
|
||||
</button>
|
||||
</div>
|
||||
|
||||
|
||||
<div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
|
||||
<ul class="nav flex-column">
|
||||
|
||||
<li class="nav-item" data-level="1"><a href="#powerlevel9k-compatibility" class="nav-link">Powerlevel9k compatibility</a>
|
||||
<ul class="nav flex-column">
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div></div>
|
||||
<div class="col-md-9" role="main">
|
||||
|
||||
<h1 id="powerlevel9k-compatibility">Powerlevel9k compatibility</h1>
|
||||
<p>Powerlevel10k understands all <a href="https://github.com/Powerlevel9k/powerlevel9k">Powerlevel9k</a>
|
||||
configuration parameters.</p>
|
||||
<p><img alt="Powerlevel10k Compatibility with 9k" src="https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/9k-compatibility.gif" /></p>
|
||||
<p><a href="#installation">Migration</a> from Powerlevel9k to Powerlevel10k is a straightforward process. All
|
||||
your <code>POWERLEVEL9K</code> configuration parameters will still work. Prompt will look the same as before
|
||||
(<a href="#does-powerlevel10k-always-render-exactly-the-same-prompt-as-powerlevel9k-given-the-same-config">almost</a>)
|
||||
but it will be <a href="#uncompromising-performance">much faster</a> (<a href="#is-it-really-fast">certainly</a>).</p>
|
||||
<p><em>FAQ</em>:</p>
|
||||
<ul>
|
||||
<li><a href="../../faq/#im-using-powerlevel9k-with-oh-my-zsh-how-do-i-migrate">I'm using Powerlevel9k with Oh My Zsh. How do I migrate?</a></li>
|
||||
<li><a href="../../faq/#does-powerlevel10k-always-render-exactly-the-same-prompt-as-powerlevel9k-given-the-same-config">Does Powerlevel10k always render exactly the same prompt as Powerlevel9k given the same config?</a></li>
|
||||
<li><a href="../../faq/#What-is-the-relationship-between-powerlevel9k-and-powerlevel10k">What is the relationship between Powerlevel9k and Powerlevel10k?</a></li>
|
||||
</ul></div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<footer class="col-md-12">
|
||||
<hr>
|
||||
<p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
|
||||
</footer>
|
||||
<script>
|
||||
var base_url = "../..",
|
||||
shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
|
||||
</script>
|
||||
<script src="../../js/base.js" defer></script>
|
||||
<script src="../../search/main.js" defer></script>
|
||||
|
||||
<div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
|
||||
<div class="modal-dialog modal-lg">
|
||||
<div class="modal-content">
|
||||
<div class="modal-header">
|
||||
<h4 class="modal-title" id="searchModalLabel">Search</h4>
|
||||
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
||||
</div>
|
||||
<div class="modal-body">
|
||||
<p>
|
||||
From here you can search these documents. Enter
|
||||
your search terms below.
|
||||
</p>
|
||||
<form>
|
||||
<div class="form-group">
|
||||
<input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
|
||||
</div>
|
||||
</form>
|
||||
<div id="mkdocs-search-results"></div>
|
||||
</div>
|
||||
<div class="modal-footer">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
|
||||
<div class="modal-dialog">
|
||||
<div class="modal-content">
|
||||
<div class="modal-header">
|
||||
<h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
|
||||
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
||||
</div>
|
||||
<div class="modal-body">
|
||||
<table class="table">
|
||||
<thead>
|
||||
<tr>
|
||||
<th style="width: 20%;">Keys</th>
|
||||
<th>Action</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td class="help shortcut"><kbd>?</kbd></td>
|
||||
<td>Open this help</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="next shortcut"><kbd>n</kbd></td>
|
||||
<td>Next page</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="prev shortcut"><kbd>p</kbd></td>
|
||||
<td>Previous page</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="search shortcut"><kbd>s</kbd></td>
|
||||
<td>Search</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<div class="modal-footer">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
|
@ -1,16 +0,0 @@
|
|||
# Pure compatibility
|
||||
|
||||
Powerlevel10k can produce the same prompt as [Pure](https://github.com/sindresorhus/pure). Type
|
||||
`p10k configure` and select _Pure_ style.
|
||||
|
||||
|
||||
|
||||
You can still use Powerlevel10k features such as [transient prompt](#transient-prompt) or
|
||||
[instant prompt](#instant-prompt) when sporting Pure style.
|
||||
|
||||
To customize prompt, edit `~/.p10k.zsh`. Powerlevel10k doesn't recognize Pure configuration
|
||||
parameters, so you'll need to use `POWERLEVEL9K_COMMAND_EXECUTION_TIME_THRESHOLD=3` instead of
|
||||
`PURE_CMD_MAX_EXEC_TIME=3`, etc. All relevant parameters are in `~/.p10k.zsh`. This file has
|
||||
plenty of comments to help you navigate through it.
|
||||
|
||||
_FAQ:_ [What is the best prompt style in the configuration wizard?](#what-is-the-best-prompt-style-in-the-configuration-wizard)
|
||||
239
docs/features/pure_compatibility/index.html
Normal file
239
docs/features/pure_compatibility/index.html
Normal file
|
|
@ -0,0 +1,239 @@
|
|||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
|
||||
|
||||
<link rel="shortcut icon" href="../../img/favicon.ico">
|
||||
<title>Pure compatibility - Powerlevel10k</title>
|
||||
<link href="../../css/bootstrap.min.css" rel="stylesheet">
|
||||
<link href="../../css/font-awesome.min.css" rel="stylesheet">
|
||||
<link href="../../css/base.css" rel="stylesheet">
|
||||
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/atom-one-dark.min.css">
|
||||
|
||||
<script src="../../js/jquery-1.10.2.min.js" defer></script>
|
||||
<script src="../../js/bootstrap.min.js" defer></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/highlight.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/bash.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/zsh.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/sh.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/yaml.min.js"></script>
|
||||
<script>hljs.initHighlightingOnLoad();</script>
|
||||
</head>
|
||||
|
||||
<body>
|
||||
<div class="navbar fixed-top navbar-expand-lg navbar-dark bg-dark">
|
||||
<div class="container">
|
||||
<a class="navbar-brand" href="../..">Powerlevel10k</a>
|
||||
<!-- Expander button -->
|
||||
<button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
|
||||
<span class="navbar-toggler-icon"></span>
|
||||
</button>
|
||||
|
||||
<!-- Expanded navigation -->
|
||||
<div id="navbar-collapse" class="navbar-collapse collapse">
|
||||
<!-- Main navigation -->
|
||||
<ul class="nav navbar-nav">
|
||||
<li class="navitem">
|
||||
<a href="../.." class="nav-link">Home</a>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../installation/" class="nav-link">Get Started</a>
|
||||
</li>
|
||||
<li class="dropdown active">
|
||||
<a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Features <b class="caret"></b></a>
|
||||
<ul class="dropdown-menu">
|
||||
|
||||
<li>
|
||||
<a href="../wizard/" class="dropdown-item">Configuration wizard</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../uncompromising_performance/" class="dropdown-item">Uncompromising performance</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../p9k_compatibility/" class="dropdown-item">Powerlevel9k Compatibility</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="./" class="dropdown-item active">Pure compatibility</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../instant_prompt/" class="dropdown-item">Instant prompt</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../show_on_command/" class="dropdown-item">Show on command</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../transient_prompt/" class="dropdown-item">Transient prompt</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../current_directory/" class="dropdown-item">Current Directory that just works</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../customizable/" class="dropdown-item">Extremely Customizable</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../batteries_included/" class="dropdown-item">Batteries included</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../extensible/" class="dropdown-item">Extensible</a>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../faq/" class="nav-link">FAQ</a>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../troubleshooting/" class="nav-link">Troubleshooting</a>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<ul class="nav navbar-nav ml-auto">
|
||||
<li class="nav-item">
|
||||
<a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
|
||||
<i class="fa fa-search"></i> Search
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a rel="prev" href="../p9k_compatibility/" class="nav-link">
|
||||
<i class="fa fa-arrow-left"></i> Previous
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a rel="next" href="../instant_prompt/" class="nav-link">
|
||||
Next <i class="fa fa-arrow-right"></i>
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a href="https://github.com/romkatv/powerlevel10k/edit/master/docs/features/pure_compatibility.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="container">
|
||||
<div class="row">
|
||||
<div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
|
||||
<div class="navbar-header">
|
||||
<button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
|
||||
<span class="fa fa-angle-down"></span>
|
||||
</button>
|
||||
</div>
|
||||
|
||||
|
||||
<div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
|
||||
<ul class="nav flex-column">
|
||||
|
||||
<li class="nav-item" data-level="1"><a href="#pure-compatibility" class="nav-link">Pure compatibility</a>
|
||||
<ul class="nav flex-column">
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div></div>
|
||||
<div class="col-md-9" role="main">
|
||||
|
||||
<h1 id="pure-compatibility">Pure compatibility</h1>
|
||||
<p>Powerlevel10k can produce the same prompt as <a href="https://github.com/sindresorhus/pure">Pure</a>. Type
|
||||
<code>p10k configure</code> and select <em>Pure</em> style.</p>
|
||||
<p><img alt="Powerlevel10k Pure Style" src="https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/pure-style.gif" /></p>
|
||||
<p>You can still use Powerlevel10k features such as <a href="#transient-prompt">transient prompt</a> or
|
||||
<a href="#instant-prompt">instant prompt</a> when sporting Pure style.</p>
|
||||
<p>To customize prompt, edit <code>~/.p10k.zsh</code>. Powerlevel10k doesn't recognize Pure configuration
|
||||
parameters, so you'll need to use <code>POWERLEVEL9K_COMMAND_EXECUTION_TIME_THRESHOLD=3</code> instead of
|
||||
<code>PURE_CMD_MAX_EXEC_TIME=3</code>, etc. All relevant parameters are in <code>~/.p10k.zsh</code>. This file has
|
||||
plenty of comments to help you navigate through it.</p>
|
||||
<p><em>FAQ:</em> <a href="#what-is-the-best-prompt-style-in-the-configuration-wizard">What is the best prompt style in the configuration wizard?</a></p></div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<footer class="col-md-12">
|
||||
<hr>
|
||||
<p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
|
||||
</footer>
|
||||
<script>
|
||||
var base_url = "../..",
|
||||
shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
|
||||
</script>
|
||||
<script src="../../js/base.js" defer></script>
|
||||
<script src="../../search/main.js" defer></script>
|
||||
|
||||
<div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
|
||||
<div class="modal-dialog modal-lg">
|
||||
<div class="modal-content">
|
||||
<div class="modal-header">
|
||||
<h4 class="modal-title" id="searchModalLabel">Search</h4>
|
||||
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
||||
</div>
|
||||
<div class="modal-body">
|
||||
<p>
|
||||
From here you can search these documents. Enter
|
||||
your search terms below.
|
||||
</p>
|
||||
<form>
|
||||
<div class="form-group">
|
||||
<input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
|
||||
</div>
|
||||
</form>
|
||||
<div id="mkdocs-search-results"></div>
|
||||
</div>
|
||||
<div class="modal-footer">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
|
||||
<div class="modal-dialog">
|
||||
<div class="modal-content">
|
||||
<div class="modal-header">
|
||||
<h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
|
||||
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
||||
</div>
|
||||
<div class="modal-body">
|
||||
<table class="table">
|
||||
<thead>
|
||||
<tr>
|
||||
<th style="width: 20%;">Keys</th>
|
||||
<th>Action</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td class="help shortcut"><kbd>?</kbd></td>
|
||||
<td>Open this help</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="next shortcut"><kbd>n</kbd></td>
|
||||
<td>Next page</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="prev shortcut"><kbd>p</kbd></td>
|
||||
<td>Previous page</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="search shortcut"><kbd>s</kbd></td>
|
||||
<td>Search</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<div class="modal-footer">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
|
@ -1,24 +0,0 @@
|
|||
# Show on command
|
||||
|
||||
The behavior of some commands depends on global environment. For example, `kubectl run ...` runs an
|
||||
image on the cluster defined by the current kubernetes context. If you frequently change context
|
||||
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.
|
||||
|
||||
Enter _Show On Command_. This feature makes prompt segments appear only when they are relevant to
|
||||
the command you are currently typing.
|
||||
|
||||
|
||||
|
||||
Configs created by `p10k configure` enable show on command for several prompt segments by default.
|
||||
Here's the relevant parameter for kubernetes context:
|
||||
|
||||
```zsh
|
||||
# Show prompt segment "kubecontext" only when the command you are typing
|
||||
# invokes kubectl, helm, kubens, kubectx, oc, istioctl, kogito, k9s or helmfile.
|
||||
typeset -g POWERLEVEL9K_KUBECONTEXT_SHOW_ON_COMMAND='kubectl|helm|kubens|kubectx|oc|istioctl|kogito|k9s|helmfile'
|
||||
```
|
||||
|
||||
To customize when different prompt segments are shown, open `~/.p10k.zsh`, search for
|
||||
`SHOW_ON_COMMAND` and either remove these parameters to display affected segments unconditionally,
|
||||
or change their values.
|
||||
246
docs/features/show_on_command/index.html
Normal file
246
docs/features/show_on_command/index.html
Normal file
|
|
@ -0,0 +1,246 @@
|
|||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
|
||||
|
||||
<link rel="shortcut icon" href="../../img/favicon.ico">
|
||||
<title>Show on command - Powerlevel10k</title>
|
||||
<link href="../../css/bootstrap.min.css" rel="stylesheet">
|
||||
<link href="../../css/font-awesome.min.css" rel="stylesheet">
|
||||
<link href="../../css/base.css" rel="stylesheet">
|
||||
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/atom-one-dark.min.css">
|
||||
|
||||
<script src="../../js/jquery-1.10.2.min.js" defer></script>
|
||||
<script src="../../js/bootstrap.min.js" defer></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/highlight.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/bash.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/zsh.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/sh.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/yaml.min.js"></script>
|
||||
<script>hljs.initHighlightingOnLoad();</script>
|
||||
</head>
|
||||
|
||||
<body>
|
||||
<div class="navbar fixed-top navbar-expand-lg navbar-dark bg-dark">
|
||||
<div class="container">
|
||||
<a class="navbar-brand" href="../..">Powerlevel10k</a>
|
||||
<!-- Expander button -->
|
||||
<button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
|
||||
<span class="navbar-toggler-icon"></span>
|
||||
</button>
|
||||
|
||||
<!-- Expanded navigation -->
|
||||
<div id="navbar-collapse" class="navbar-collapse collapse">
|
||||
<!-- Main navigation -->
|
||||
<ul class="nav navbar-nav">
|
||||
<li class="navitem">
|
||||
<a href="../.." class="nav-link">Home</a>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../installation/" class="nav-link">Get Started</a>
|
||||
</li>
|
||||
<li class="dropdown active">
|
||||
<a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Features <b class="caret"></b></a>
|
||||
<ul class="dropdown-menu">
|
||||
|
||||
<li>
|
||||
<a href="../wizard/" class="dropdown-item">Configuration wizard</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../uncompromising_performance/" class="dropdown-item">Uncompromising performance</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../p9k_compatibility/" class="dropdown-item">Powerlevel9k Compatibility</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../pure_compatibility/" class="dropdown-item">Pure compatibility</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../instant_prompt/" class="dropdown-item">Instant prompt</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="./" class="dropdown-item active">Show on command</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../transient_prompt/" class="dropdown-item">Transient prompt</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../current_directory/" class="dropdown-item">Current Directory that just works</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../customizable/" class="dropdown-item">Extremely Customizable</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../batteries_included/" class="dropdown-item">Batteries included</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../extensible/" class="dropdown-item">Extensible</a>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../faq/" class="nav-link">FAQ</a>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../troubleshooting/" class="nav-link">Troubleshooting</a>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<ul class="nav navbar-nav ml-auto">
|
||||
<li class="nav-item">
|
||||
<a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
|
||||
<i class="fa fa-search"></i> Search
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a rel="prev" href="../instant_prompt/" class="nav-link">
|
||||
<i class="fa fa-arrow-left"></i> Previous
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a rel="next" href="../transient_prompt/" class="nav-link">
|
||||
Next <i class="fa fa-arrow-right"></i>
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a href="https://github.com/romkatv/powerlevel10k/edit/master/docs/features/show_on_command.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="container">
|
||||
<div class="row">
|
||||
<div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
|
||||
<div class="navbar-header">
|
||||
<button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
|
||||
<span class="fa fa-angle-down"></span>
|
||||
</button>
|
||||
</div>
|
||||
|
||||
|
||||
<div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
|
||||
<ul class="nav flex-column">
|
||||
|
||||
<li class="nav-item" data-level="1"><a href="#show-on-command" class="nav-link">Show on command</a>
|
||||
<ul class="nav flex-column">
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div></div>
|
||||
<div class="col-md-9" role="main">
|
||||
|
||||
<h1 id="show-on-command">Show on command</h1>
|
||||
<p>The behavior of some commands depends on global environment. For example, <code>kubectl run ...</code> runs an
|
||||
image on the cluster defined by the current kubernetes context. If you frequently change context
|
||||
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.</p>
|
||||
<p>Enter <em>Show On Command</em>. This feature makes prompt segments appear only when they are relevant to
|
||||
the command you are currently typing.</p>
|
||||
<p><img alt="Powerlevel10k Show On Command" src="https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/show-on-command.gif" /></p>
|
||||
<p>Configs created by <code>p10k configure</code> enable show on command for several prompt segments by default.
|
||||
Here's the relevant parameter for kubernetes context:</p>
|
||||
<pre><code class="zsh"># Show prompt segment "kubecontext" only when the command you are typing
|
||||
# invokes kubectl, helm, kubens, kubectx, oc, istioctl, kogito, k9s or helmfile.
|
||||
typeset -g POWERLEVEL9K_KUBECONTEXT_SHOW_ON_COMMAND='kubectl|helm|kubens|kubectx|oc|istioctl|kogito|k9s|helmfile'
|
||||
</code></pre>
|
||||
|
||||
<p>To customize when different prompt segments are shown, open <code>~/.p10k.zsh</code>, search for
|
||||
<code>SHOW_ON_COMMAND</code> and either remove these parameters to display affected segments unconditionally,
|
||||
or change their values.</p></div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<footer class="col-md-12">
|
||||
<hr>
|
||||
<p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
|
||||
</footer>
|
||||
<script>
|
||||
var base_url = "../..",
|
||||
shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
|
||||
</script>
|
||||
<script src="../../js/base.js" defer></script>
|
||||
<script src="../../search/main.js" defer></script>
|
||||
|
||||
<div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
|
||||
<div class="modal-dialog modal-lg">
|
||||
<div class="modal-content">
|
||||
<div class="modal-header">
|
||||
<h4 class="modal-title" id="searchModalLabel">Search</h4>
|
||||
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
||||
</div>
|
||||
<div class="modal-body">
|
||||
<p>
|
||||
From here you can search these documents. Enter
|
||||
your search terms below.
|
||||
</p>
|
||||
<form>
|
||||
<div class="form-group">
|
||||
<input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
|
||||
</div>
|
||||
</form>
|
||||
<div id="mkdocs-search-results"></div>
|
||||
</div>
|
||||
<div class="modal-footer">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
|
||||
<div class="modal-dialog">
|
||||
<div class="modal-content">
|
||||
<div class="modal-header">
|
||||
<h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
|
||||
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
||||
</div>
|
||||
<div class="modal-body">
|
||||
<table class="table">
|
||||
<thead>
|
||||
<tr>
|
||||
<th style="width: 20%;">Keys</th>
|
||||
<th>Action</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td class="help shortcut"><kbd>?</kbd></td>
|
||||
<td>Open this help</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="next shortcut"><kbd>n</kbd></td>
|
||||
<td>Next page</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="prev shortcut"><kbd>p</kbd></td>
|
||||
<td>Previous page</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="search shortcut"><kbd>s</kbd></td>
|
||||
<td>Search</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<div class="modal-footer">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
|
@ -1,12 +0,0 @@
|
|||
# Transient prompt
|
||||
|
||||
When _Transient Prompt_ is enabled through `p10k configure`, Powerlevel10k will trim down every
|
||||
prompt when accepting a command line.
|
||||
|
||||
|
||||
|
||||
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
|
||||
extra space for typing commands without the usual drawback of reduced scrollback density. Sparse
|
||||
prompt (with an empty line before prompt) also works great in combination with transient prompt.
|
||||
236
docs/features/transient_prompt/index.html
Normal file
236
docs/features/transient_prompt/index.html
Normal file
|
|
@ -0,0 +1,236 @@
|
|||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
|
||||
|
||||
<link rel="shortcut icon" href="../../img/favicon.ico">
|
||||
<title>Transient prompt - Powerlevel10k</title>
|
||||
<link href="../../css/bootstrap.min.css" rel="stylesheet">
|
||||
<link href="../../css/font-awesome.min.css" rel="stylesheet">
|
||||
<link href="../../css/base.css" rel="stylesheet">
|
||||
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/atom-one-dark.min.css">
|
||||
|
||||
<script src="../../js/jquery-1.10.2.min.js" defer></script>
|
||||
<script src="../../js/bootstrap.min.js" defer></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/highlight.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/bash.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/zsh.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/sh.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/yaml.min.js"></script>
|
||||
<script>hljs.initHighlightingOnLoad();</script>
|
||||
</head>
|
||||
|
||||
<body>
|
||||
<div class="navbar fixed-top navbar-expand-lg navbar-dark bg-dark">
|
||||
<div class="container">
|
||||
<a class="navbar-brand" href="../..">Powerlevel10k</a>
|
||||
<!-- Expander button -->
|
||||
<button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
|
||||
<span class="navbar-toggler-icon"></span>
|
||||
</button>
|
||||
|
||||
<!-- Expanded navigation -->
|
||||
<div id="navbar-collapse" class="navbar-collapse collapse">
|
||||
<!-- Main navigation -->
|
||||
<ul class="nav navbar-nav">
|
||||
<li class="navitem">
|
||||
<a href="../.." class="nav-link">Home</a>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../installation/" class="nav-link">Get Started</a>
|
||||
</li>
|
||||
<li class="dropdown active">
|
||||
<a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Features <b class="caret"></b></a>
|
||||
<ul class="dropdown-menu">
|
||||
|
||||
<li>
|
||||
<a href="../wizard/" class="dropdown-item">Configuration wizard</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../uncompromising_performance/" class="dropdown-item">Uncompromising performance</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../p9k_compatibility/" class="dropdown-item">Powerlevel9k Compatibility</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../pure_compatibility/" class="dropdown-item">Pure compatibility</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../instant_prompt/" class="dropdown-item">Instant prompt</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../show_on_command/" class="dropdown-item">Show on command</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="./" class="dropdown-item active">Transient prompt</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../current_directory/" class="dropdown-item">Current Directory that just works</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../customizable/" class="dropdown-item">Extremely Customizable</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../batteries_included/" class="dropdown-item">Batteries included</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../extensible/" class="dropdown-item">Extensible</a>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../faq/" class="nav-link">FAQ</a>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../troubleshooting/" class="nav-link">Troubleshooting</a>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<ul class="nav navbar-nav ml-auto">
|
||||
<li class="nav-item">
|
||||
<a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
|
||||
<i class="fa fa-search"></i> Search
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a rel="prev" href="../show_on_command/" class="nav-link">
|
||||
<i class="fa fa-arrow-left"></i> Previous
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a rel="next" href="../current_directory/" class="nav-link">
|
||||
Next <i class="fa fa-arrow-right"></i>
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a href="https://github.com/romkatv/powerlevel10k/edit/master/docs/features/transient_prompt.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="container">
|
||||
<div class="row">
|
||||
<div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
|
||||
<div class="navbar-header">
|
||||
<button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
|
||||
<span class="fa fa-angle-down"></span>
|
||||
</button>
|
||||
</div>
|
||||
|
||||
|
||||
<div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
|
||||
<ul class="nav flex-column">
|
||||
|
||||
<li class="nav-item" data-level="1"><a href="#transient-prompt" class="nav-link">Transient prompt</a>
|
||||
<ul class="nav flex-column">
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div></div>
|
||||
<div class="col-md-9" role="main">
|
||||
|
||||
<h1 id="transient-prompt">Transient prompt</h1>
|
||||
<p>When <em>Transient Prompt</em> is enabled through <code>p10k configure</code>, Powerlevel10k will trim down every
|
||||
prompt when accepting a command line.</p>
|
||||
<p><img alt="Powerlevel10k Transient Prompt" src="https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/transient-prompt.gif" /></p>
|
||||
<p>Transient prompt makes it much easier to copy-paste series of commands from the terminal scrollback.</p>
|
||||
<p><em>Tip</em>: 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 drawback of reduced scrollback density. Sparse
|
||||
prompt (with an empty line before prompt) also works great in combination with transient prompt.</p></div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<footer class="col-md-12">
|
||||
<hr>
|
||||
<p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
|
||||
</footer>
|
||||
<script>
|
||||
var base_url = "../..",
|
||||
shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
|
||||
</script>
|
||||
<script src="../../js/base.js" defer></script>
|
||||
<script src="../../search/main.js" defer></script>
|
||||
|
||||
<div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
|
||||
<div class="modal-dialog modal-lg">
|
||||
<div class="modal-content">
|
||||
<div class="modal-header">
|
||||
<h4 class="modal-title" id="searchModalLabel">Search</h4>
|
||||
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
||||
</div>
|
||||
<div class="modal-body">
|
||||
<p>
|
||||
From here you can search these documents. Enter
|
||||
your search terms below.
|
||||
</p>
|
||||
<form>
|
||||
<div class="form-group">
|
||||
<input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
|
||||
</div>
|
||||
</form>
|
||||
<div id="mkdocs-search-results"></div>
|
||||
</div>
|
||||
<div class="modal-footer">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
|
||||
<div class="modal-dialog">
|
||||
<div class="modal-content">
|
||||
<div class="modal-header">
|
||||
<h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
|
||||
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
||||
</div>
|
||||
<div class="modal-body">
|
||||
<table class="table">
|
||||
<thead>
|
||||
<tr>
|
||||
<th style="width: 20%;">Keys</th>
|
||||
<th>Action</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td class="help shortcut"><kbd>?</kbd></td>
|
||||
<td>Open this help</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="next shortcut"><kbd>n</kbd></td>
|
||||
<td>Next page</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="prev shortcut"><kbd>p</kbd></td>
|
||||
<td>Previous page</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="search shortcut"><kbd>s</kbd></td>
|
||||
<td>Search</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<div class="modal-footer">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
|
@ -1,24 +0,0 @@
|
|||
# Uncompromising performance
|
||||
|
||||
When you hit _ENTER_, the next prompt appears instantly. With Powerlevel10k there is no prompt lag.
|
||||
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
|
||||
one ever does that. Probably impossible, too. The point is, Powerlevel10k prompt is always fast, no
|
||||
matter what you do!
|
||||
|
||||
|
||||
|
||||
Note how the effect of every command is instantly reflected by the very next prompt.
|
||||
|
||||
| Command | Prompt Indicator | Meaning |
|
||||
| ----------------------------- | :--------------: | --------------------------------------------------------------------: |
|
||||
| `timew start hack linux` | `🛡️ hack linux` | time tracking enabled in [timewarrior](https://timewarrior.net/) |
|
||||
| `touch x y` | `?2` | 2 untracked files in the Git repo |
|
||||
| `rm COPYING` | `!1` | 1 unstaged change in the Git repo |
|
||||
| `echo 3.7.3 >.python-version` | `🐍 3.7.3` | the current python version in [pyenv](https://github.com/pyenv/pyenv) |
|
||||
|
||||
Other Zsh themes capable of displaying the same information either produce prompt lag or print
|
||||
prompt that doesn't reflect the current state of the system and then refresh it later. With
|
||||
Powerlevel10k you get fast prompt _and_ up-to-date information.
|
||||
|
||||
_FAQ_: [Is it really fast?](../faq.md#is-it-really-fast)
|
||||
271
docs/features/uncompromising_performance/index.html
Normal file
271
docs/features/uncompromising_performance/index.html
Normal file
|
|
@ -0,0 +1,271 @@
|
|||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
|
||||
|
||||
<link rel="shortcut icon" href="../../img/favicon.ico">
|
||||
<title>Uncompromising performance - Powerlevel10k</title>
|
||||
<link href="../../css/bootstrap.min.css" rel="stylesheet">
|
||||
<link href="../../css/font-awesome.min.css" rel="stylesheet">
|
||||
<link href="../../css/base.css" rel="stylesheet">
|
||||
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/atom-one-dark.min.css">
|
||||
|
||||
<script src="../../js/jquery-1.10.2.min.js" defer></script>
|
||||
<script src="../../js/bootstrap.min.js" defer></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/highlight.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/bash.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/zsh.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/sh.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/yaml.min.js"></script>
|
||||
<script>hljs.initHighlightingOnLoad();</script>
|
||||
</head>
|
||||
|
||||
<body>
|
||||
<div class="navbar fixed-top navbar-expand-lg navbar-dark bg-dark">
|
||||
<div class="container">
|
||||
<a class="navbar-brand" href="../..">Powerlevel10k</a>
|
||||
<!-- Expander button -->
|
||||
<button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
|
||||
<span class="navbar-toggler-icon"></span>
|
||||
</button>
|
||||
|
||||
<!-- Expanded navigation -->
|
||||
<div id="navbar-collapse" class="navbar-collapse collapse">
|
||||
<!-- Main navigation -->
|
||||
<ul class="nav navbar-nav">
|
||||
<li class="navitem">
|
||||
<a href="../.." class="nav-link">Home</a>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../installation/" class="nav-link">Get Started</a>
|
||||
</li>
|
||||
<li class="dropdown active">
|
||||
<a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Features <b class="caret"></b></a>
|
||||
<ul class="dropdown-menu">
|
||||
|
||||
<li>
|
||||
<a href="../wizard/" class="dropdown-item">Configuration wizard</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="./" class="dropdown-item active">Uncompromising performance</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../p9k_compatibility/" class="dropdown-item">Powerlevel9k Compatibility</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../pure_compatibility/" class="dropdown-item">Pure compatibility</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../instant_prompt/" class="dropdown-item">Instant prompt</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../show_on_command/" class="dropdown-item">Show on command</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../transient_prompt/" class="dropdown-item">Transient prompt</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../current_directory/" class="dropdown-item">Current Directory that just works</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../customizable/" class="dropdown-item">Extremely Customizable</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../batteries_included/" class="dropdown-item">Batteries included</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../extensible/" class="dropdown-item">Extensible</a>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../faq/" class="nav-link">FAQ</a>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../troubleshooting/" class="nav-link">Troubleshooting</a>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<ul class="nav navbar-nav ml-auto">
|
||||
<li class="nav-item">
|
||||
<a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
|
||||
<i class="fa fa-search"></i> Search
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a rel="prev" href="../wizard/" class="nav-link">
|
||||
<i class="fa fa-arrow-left"></i> Previous
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a rel="next" href="../p9k_compatibility/" class="nav-link">
|
||||
Next <i class="fa fa-arrow-right"></i>
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a href="https://github.com/romkatv/powerlevel10k/edit/master/docs/features/uncompromising_performance.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="container">
|
||||
<div class="row">
|
||||
<div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
|
||||
<div class="navbar-header">
|
||||
<button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
|
||||
<span class="fa fa-angle-down"></span>
|
||||
</button>
|
||||
</div>
|
||||
|
||||
|
||||
<div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
|
||||
<ul class="nav flex-column">
|
||||
|
||||
<li class="nav-item" data-level="1"><a href="#uncompromising-performance" class="nav-link">Uncompromising performance</a>
|
||||
<ul class="nav flex-column">
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div></div>
|
||||
<div class="col-md-9" role="main">
|
||||
|
||||
<h1 id="uncompromising-performance">Uncompromising performance</h1>
|
||||
<p>When you hit <em>ENTER</em>, the next prompt appears instantly. With Powerlevel10k there is no prompt lag.
|
||||
If you install Cygwin on Raspberry Pi, <code>cd</code> 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
|
||||
one ever does that. Probably impossible, too. The point is, Powerlevel10k prompt is always fast, no
|
||||
matter what you do!</p>
|
||||
<p><img alt="Powerlevel10k Performance" src="https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/performance.gif" /></p>
|
||||
<p>Note how the effect of every command is instantly reflected by the very next prompt.</p>
|
||||
<table>
|
||||
<thead>
|
||||
<tr>
|
||||
<th>Command</th>
|
||||
<th align="center">Prompt Indicator</th>
|
||||
<th align="right">Meaning</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><code>timew start hack linux</code></td>
|
||||
<td align="center"><code>🛡️ hack linux</code></td>
|
||||
<td align="right">time tracking enabled in <a href="https://timewarrior.net/">timewarrior</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>touch x y</code></td>
|
||||
<td align="center"><code>?2</code></td>
|
||||
<td align="right">2 untracked files in the Git repo</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>rm COPYING</code></td>
|
||||
<td align="center"><code>!1</code></td>
|
||||
<td align="right">1 unstaged change in the Git repo</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>echo 3.7.3 >.python-version</code></td>
|
||||
<td align="center"><code>🐍 3.7.3</code></td>
|
||||
<td align="right">the current python version in <a href="https://github.com/pyenv/pyenv">pyenv</a></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p>Other Zsh themes capable of displaying the same information either produce prompt lag or print
|
||||
prompt that doesn't reflect the current state of the system and then refresh it later. With
|
||||
Powerlevel10k you get fast prompt <em>and</em> up-to-date information.</p>
|
||||
<p><em>FAQ</em>: <a href="../../faq/#is-it-really-fast">Is it really fast?</a></p></div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<footer class="col-md-12">
|
||||
<hr>
|
||||
<p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
|
||||
</footer>
|
||||
<script>
|
||||
var base_url = "../..",
|
||||
shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
|
||||
</script>
|
||||
<script src="../../js/base.js" defer></script>
|
||||
<script src="../../search/main.js" defer></script>
|
||||
|
||||
<div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
|
||||
<div class="modal-dialog modal-lg">
|
||||
<div class="modal-content">
|
||||
<div class="modal-header">
|
||||
<h4 class="modal-title" id="searchModalLabel">Search</h4>
|
||||
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
||||
</div>
|
||||
<div class="modal-body">
|
||||
<p>
|
||||
From here you can search these documents. Enter
|
||||
your search terms below.
|
||||
</p>
|
||||
<form>
|
||||
<div class="form-group">
|
||||
<input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
|
||||
</div>
|
||||
</form>
|
||||
<div id="mkdocs-search-results"></div>
|
||||
</div>
|
||||
<div class="modal-footer">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
|
||||
<div class="modal-dialog">
|
||||
<div class="modal-content">
|
||||
<div class="modal-header">
|
||||
<h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
|
||||
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
||||
</div>
|
||||
<div class="modal-body">
|
||||
<table class="table">
|
||||
<thead>
|
||||
<tr>
|
||||
<th style="width: 20%;">Keys</th>
|
||||
<th>Action</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td class="help shortcut"><kbd>?</kbd></td>
|
||||
<td>Open this help</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="next shortcut"><kbd>n</kbd></td>
|
||||
<td>Next page</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="prev shortcut"><kbd>p</kbd></td>
|
||||
<td>Previous page</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="search shortcut"><kbd>s</kbd></td>
|
||||
<td>Search</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<div class="modal-footer">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
|
@ -1,29 +0,0 @@
|
|||
# Configuration wizard
|
||||
|
||||
Type `p10k configure` to access the builtin configuration wizard right from your terminal.
|
||||
|
||||
|
||||
|
||||
All styles except [Pure](pure_compatibility.md) are functionally equivalent. They display the same
|
||||
information and differ only in presentation.
|
||||
|
||||
Configuration wizard creates `~/.p10k.zsh` based on your preferences. Additional prompt
|
||||
customization can be done by editing this file. It has plenty of comments to help you navigate
|
||||
through configuration options.
|
||||
|
||||
_Tip_: Install [the recommended font](../fonts.md) before
|
||||
running `p10k configure` to unlock all prompt styles.
|
||||
|
||||
_FAQ:_
|
||||
|
||||
- [What is the best prompt style in the configuration wizard?](../faq.md#what-is-the-best-prompt-style-in-the-configuration-wizard)
|
||||
- [What do different symbols in Git status mean?](../faq.md#what-do-different-symbols-in-git-status-mean)
|
||||
- [How do I change prompt colors?](../faq.md#how-do-i-change-prompt-colors)
|
||||
|
||||
_Troubleshooting_:
|
||||
|
||||
- [Some prompt styles are missing from the configuration wizard](../troubleshooting.md#some-prompt-styles-are-missing-from-the-configuration-wizard).
|
||||
- [Question mark in prompt](../troubleshooting.md#question-mark-in-prompt).
|
||||
- [Icons, glyphs or powerline symbols don't render](../troubleshooting.md#icons-glyphs-or-powerline-symbols-dont-render).
|
||||
- [Sub-pixel imperfections around powerline symbols](../troubleshooting.md#sub-pixel-imperfections-around-powerline-symbols).
|
||||
- [Directory is difficult to see in prompt when using Rainbow style](../troubleshooting.md#directory-is-difficult-to-see-in-prompt-when-using-rainbow-style).
|
||||
252
docs/features/wizard/index.html
Normal file
252
docs/features/wizard/index.html
Normal file
|
|
@ -0,0 +1,252 @@
|
|||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=edge">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
|
||||
|
||||
<link rel="shortcut icon" href="../../img/favicon.ico">
|
||||
<title>Configuration wizard - Powerlevel10k</title>
|
||||
<link href="../../css/bootstrap.min.css" rel="stylesheet">
|
||||
<link href="../../css/font-awesome.min.css" rel="stylesheet">
|
||||
<link href="../../css/base.css" rel="stylesheet">
|
||||
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/atom-one-dark.min.css">
|
||||
|
||||
<script src="../../js/jquery-1.10.2.min.js" defer></script>
|
||||
<script src="../../js/bootstrap.min.js" defer></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/highlight.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/bash.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/zsh.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/sh.min.js"></script>
|
||||
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/languages/yaml.min.js"></script>
|
||||
<script>hljs.initHighlightingOnLoad();</script>
|
||||
</head>
|
||||
|
||||
<body>
|
||||
<div class="navbar fixed-top navbar-expand-lg navbar-dark bg-dark">
|
||||
<div class="container">
|
||||
<a class="navbar-brand" href="../..">Powerlevel10k</a>
|
||||
<!-- Expander button -->
|
||||
<button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbar-collapse">
|
||||
<span class="navbar-toggler-icon"></span>
|
||||
</button>
|
||||
|
||||
<!-- Expanded navigation -->
|
||||
<div id="navbar-collapse" class="navbar-collapse collapse">
|
||||
<!-- Main navigation -->
|
||||
<ul class="nav navbar-nav">
|
||||
<li class="navitem">
|
||||
<a href="../.." class="nav-link">Home</a>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../installation/" class="nav-link">Get Started</a>
|
||||
</li>
|
||||
<li class="dropdown active">
|
||||
<a href="#" class="nav-link dropdown-toggle" data-toggle="dropdown">Features <b class="caret"></b></a>
|
||||
<ul class="dropdown-menu">
|
||||
|
||||
<li>
|
||||
<a href="./" class="dropdown-item active">Configuration wizard</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../uncompromising_performance/" class="dropdown-item">Uncompromising performance</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../p9k_compatibility/" class="dropdown-item">Powerlevel9k Compatibility</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../pure_compatibility/" class="dropdown-item">Pure compatibility</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../instant_prompt/" class="dropdown-item">Instant prompt</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../show_on_command/" class="dropdown-item">Show on command</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../transient_prompt/" class="dropdown-item">Transient prompt</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../current_directory/" class="dropdown-item">Current Directory that just works</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../customizable/" class="dropdown-item">Extremely Customizable</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../batteries_included/" class="dropdown-item">Batteries included</a>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<a href="../extensible/" class="dropdown-item">Extensible</a>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../faq/" class="nav-link">FAQ</a>
|
||||
</li>
|
||||
<li class="navitem">
|
||||
<a href="../../troubleshooting/" class="nav-link">Troubleshooting</a>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<ul class="nav navbar-nav ml-auto">
|
||||
<li class="nav-item">
|
||||
<a href="#" class="nav-link" data-toggle="modal" data-target="#mkdocs_search_modal">
|
||||
<i class="fa fa-search"></i> Search
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a rel="prev" href="../../installation/" class="nav-link">
|
||||
<i class="fa fa-arrow-left"></i> Previous
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a rel="next" href="../uncompromising_performance/" class="nav-link">
|
||||
Next <i class="fa fa-arrow-right"></i>
|
||||
</a>
|
||||
</li>
|
||||
<li class="nav-item">
|
||||
<a href="https://github.com/romkatv/powerlevel10k/edit/master/docs/features/wizard.md" class="nav-link"><i class="fa fa-github"></i> Edit on GitHub</a>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="container">
|
||||
<div class="row">
|
||||
<div class="col-md-3"><div class="navbar-light navbar-expand-md bs-sidebar hidden-print affix" role="complementary">
|
||||
<div class="navbar-header">
|
||||
<button type="button" class="navbar-toggler collapsed" data-toggle="collapse" data-target="#toc-collapse" title="Table of Contents">
|
||||
<span class="fa fa-angle-down"></span>
|
||||
</button>
|
||||
</div>
|
||||
|
||||
|
||||
<div id="toc-collapse" class="navbar-collapse collapse card bg-secondary">
|
||||
<ul class="nav flex-column">
|
||||
|
||||
<li class="nav-item" data-level="1"><a href="#configuration-wizard" class="nav-link">Configuration wizard</a>
|
||||
<ul class="nav flex-column">
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div></div>
|
||||
<div class="col-md-9" role="main">
|
||||
|
||||
<h1 id="configuration-wizard">Configuration wizard</h1>
|
||||
<p>Type <code>p10k configure</code> to access the builtin configuration wizard right from your terminal.</p>
|
||||
<p><img alt="Powerlevel10k Configuration Wizard" src="https://raw.githubusercontent.com/romkatv/powerlevel10k-media/master/configuration-wizard.gif" /></p>
|
||||
<p>All styles except <a href="../pure_compatibility/">Pure</a> are functionally equivalent. They display the same
|
||||
information and differ only in presentation.</p>
|
||||
<p>Configuration wizard creates <code>~/.p10k.zsh</code> based on your preferences. Additional prompt
|
||||
customization can be done by editing this file. It has plenty of comments to help you navigate
|
||||
through configuration options.</p>
|
||||
<p><em>Tip</em>: Install <a href="../../fonts/">the recommended font</a> before
|
||||
running <code>p10k configure</code> to unlock all prompt styles.</p>
|
||||
<p><em>FAQ:</em></p>
|
||||
<ul>
|
||||
<li><a href="../../faq/#what-is-the-best-prompt-style-in-the-configuration-wizard">What is the best prompt style in the configuration wizard?</a></li>
|
||||
<li><a href="../../faq/#what-do-different-symbols-in-git-status-mean">What do different symbols in Git status mean?</a></li>
|
||||
<li><a href="../../faq/#how-do-i-change-prompt-colors">How do I change prompt colors?</a></li>
|
||||
</ul>
|
||||
<p><em>Troubleshooting</em>:</p>
|
||||
<ul>
|
||||
<li><a href="../../troubleshooting/#some-prompt-styles-are-missing-from-the-configuration-wizard">Some prompt styles are missing from the configuration wizard</a>.</li>
|
||||
<li><a href="../../troubleshooting/#question-mark-in-prompt">Question mark in prompt</a>.</li>
|
||||
<li><a href="../../troubleshooting/#icons-glyphs-or-powerline-symbols-dont-render">Icons, glyphs or powerline symbols don't render</a>.</li>
|
||||
<li><a href="../../troubleshooting/#sub-pixel-imperfections-around-powerline-symbols">Sub-pixel imperfections around powerline symbols</a>.</li>
|
||||
<li><a href="../../troubleshooting/#directory-is-difficult-to-see-in-prompt-when-using-rainbow-style">Directory is difficult to see in prompt when using Rainbow style</a>.</li>
|
||||
</ul></div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<footer class="col-md-12">
|
||||
<hr>
|
||||
<p>Documentation built with <a href="https://www.mkdocs.org/">MkDocs</a>.</p>
|
||||
</footer>
|
||||
<script>
|
||||
var base_url = "../..",
|
||||
shortcuts = {"help": 191, "next": 78, "previous": 80, "search": 83};
|
||||
</script>
|
||||
<script src="../../js/base.js" defer></script>
|
||||
<script src="../../search/main.js" defer></script>
|
||||
|
||||
<div class="modal" id="mkdocs_search_modal" tabindex="-1" role="dialog" aria-labelledby="searchModalLabel" aria-hidden="true">
|
||||
<div class="modal-dialog modal-lg">
|
||||
<div class="modal-content">
|
||||
<div class="modal-header">
|
||||
<h4 class="modal-title" id="searchModalLabel">Search</h4>
|
||||
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
||||
</div>
|
||||
<div class="modal-body">
|
||||
<p>
|
||||
From here you can search these documents. Enter
|
||||
your search terms below.
|
||||
</p>
|
||||
<form>
|
||||
<div class="form-group">
|
||||
<input type="search" class="form-control" placeholder="Search..." id="mkdocs-search-query" title="Type search term here">
|
||||
</div>
|
||||
</form>
|
||||
<div id="mkdocs-search-results"></div>
|
||||
</div>
|
||||
<div class="modal-footer">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div><div class="modal" id="mkdocs_keyboard_modal" tabindex="-1" role="dialog" aria-labelledby="keyboardModalLabel" aria-hidden="true">
|
||||
<div class="modal-dialog">
|
||||
<div class="modal-content">
|
||||
<div class="modal-header">
|
||||
<h4 class="modal-title" id="keyboardModalLabel">Keyboard Shortcuts</h4>
|
||||
<button type="button" class="close" data-dismiss="modal"><span aria-hidden="true">×</span><span class="sr-only">Close</span></button>
|
||||
</div>
|
||||
<div class="modal-body">
|
||||
<table class="table">
|
||||
<thead>
|
||||
<tr>
|
||||
<th style="width: 20%;">Keys</th>
|
||||
<th>Action</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td class="help shortcut"><kbd>?</kbd></td>
|
||||
<td>Open this help</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="next shortcut"><kbd>n</kbd></td>
|
||||
<td>Next page</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="prev shortcut"><kbd>p</kbd></td>
|
||||
<td>Previous page</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="search shortcut"><kbd>s</kbd></td>
|
||||
<td>Search</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
<div class="modal-footer">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
Loading…
Add table
Add a link
Reference in a new issue