An open API service indexing awesome lists of open source software.

https://github.com/zimfw/bira

A fork of bira's theme.
https://github.com/zimfw/bira

prompt theme zimfw zsh zsh-plugin zsh-plugins zsh-prompt zsh-theme

Last synced: 19 days ago
JSON representation

A fork of bira's theme.

Awesome Lists containing this project

README

          

bira
====

A fork of [bira]'s theme.

What does it show?
------------------

* On the left:
* `username@hostname`
* Working directory.
* Current git branch name, or commit short hash when in ['detached HEAD' state].
Also an indicator when in a dirty working tree.
* Python [venv] indicator.
* `#` when root, `$` otherwise.
* On the right:
* Status code when there was an error.

Advanced settings
-----------------

The git indicators can be customized by changing the following git-info module
context formats:

| Context name | Description | Default format |
| ------------ | ----------------- | -------------------------- |
| branch | Branch name | `%b` |
| commit | Commit short hash | `%c` |
| dirty | Dirty state | `%F{red}%{%Gā—%}%F{yellow}` |

Use the following command to override a git-info context format:

zstyle ':zim:git-info:' format ''

For detailed information about these and other git-info settings, check the
[git-info documentation].

These advanced settings must be defined at the bottom of your `~/.zshrc`, after
the modules are initialized with `source ${ZIM_HOME}/init.zsh`, in order to
override the theme defaults.

Requirements
------------

Requires Zim Framework's [git-info] module to show git information.

[bira]: https://github.com/ohmyzsh/ohmyzsh/blob/master/themes/bira.zsh-theme
['detached HEAD' state]: https://git-scm.com/docs/git-checkout#_detached_head
[venv]: https://docs.python.org/3/library/venv.html
[git-info documentation]: https://github.com/zimfw/git-info/blob/master/README.md#settings
[git-info]: https://github.com/zimfw/git-info