summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md33
1 files changed, 30 insertions, 3 deletions
diff --git a/README.md b/README.md
index 4aec6745..787e98f6 100644
--- a/README.md
+++ b/README.md
@@ -11,7 +11,7 @@ Look like a bad-ass. Impress everyone in 'Screenshot Your Desktop' threads. Use
![](http://bhilburn.org/content/images/2015/01/pl9k-improved.png)
There are a number of Powerline ZSH themes available, now. The developers of
-this theme focus on three primary goals:
+this theme focus on four primary goals:
1. Give users a great out-of-the-box configuration with no additional
configuration required.
@@ -19,6 +19,8 @@ this theme focus on three primary goals:
3. Provide useful segments that you can enable to make your prompt even more
effective and helpful. We have prompt segments for everything from unit test
coverage to your AWS instance.
+4. Optimize the code for execution speed as much as possible. A snappy terminal
+ is a happy terminal.
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
@@ -45,11 +47,13 @@ this theme focus on three primary goals:
- [Symbols](#symbols)
- [Styling](#styling)
- [Double-Lined Prompt](#double-lined-prompt)
+ - [Disable Right Prompt](#disable-right-prompt)
- [Light Color Theme](#light-color-theme)
- [Segment Color Customization](#segment-color-customization)
- [Special Segment Colors](#special-segment-colors)
- [Troubleshooting](#troubleshooting)
- [Gaps Between Segments](#gaps-between-segments)
+ - [Segment Colors are Wrong](#segment-colors-are-wrong)
- [Meta](#meta)
- [Kudos](#kudos)
- [Developing](#developing)
@@ -229,6 +233,7 @@ currently available are:
* **dir** - Your current working directory.
* **history** - The command number for the current line.
* **node_version** - Show the version number of the installed Node.js.
+* **os_icon** - Display a nice little icon, depending on your operating system.
* **rbenv** - Ruby environment information (if one is active).
* **rspec_stats** - Show a ratio of test classes vs code classes for RSpec.
* **status** - The return code of the previous command, and status of background jobs.
@@ -287,10 +292,17 @@ others whole directories.
#### The 'time' segment
By default the time is show in 'H:M:S' format. If you want to change it,
-just set another format in your `~/.zshrc`:
+just set another format in your `~/.zshrc`. As an example, this is a reversed
+time format:
# Reversed time format
- POWERLEVEL9K_TIME_FORMAT='%D{%S:%M:%H}'
+ POWERLEVEL9K_TIME_FORMAT='%D{%S:%M:%H}'
+
+If you are using an "Awesome Powerline Font", you can add a time symbol to this
+segment, as well:
+
+ # Output time, date, and a symbol from the "Awesome Powerline Font" set
+ POWERLEVEL9K_TIME_FORMAT="%D{%H:%M:%S \uE868 %d.%m.%y}"
#### Unit Test Ratios
@@ -364,6 +376,12 @@ following variables in your `~/.zshrc`:
POWERLEVEL9K_MULTILINE_FIRST_PROMPT_PREFIX="↱"
POWERLEVEL9K_MULTILINE_SECOND_PROMPT_PREFIX="↳ "
+#### Disable Right Prompt
+
+If you do not want a right prompt, you can disable it by setting:
+
+ POWERLEVEL9K_DISABLE_RPROMPT=true
+
#### Light Color Theme
If you prefer to use "light" colors, simply set `POWERLEVEL9K_COLOR_SCHEME`
@@ -447,6 +465,15 @@ Thankfully, this is easy to fix. This happens if you have successfully installed
Powerline fonts, but did not make a Powerline font the default font in your
terminal emulator (e.g., 'terminator', 'gnome-terminal', 'konsole', etc.,).
+#### Segment Colors are Wrong
+
+If the color display within your terminal seems off, it's possible you are using
+a reduced color set. You can check this by invoking `echotc Co` in your
+terminal, which should yield `256`. If you see something different, try setting
+`xterm-256color` in your `~/.zshrc`:
+
+ TERM=xterm-256color
+
### Meta
#### Kudos