1
0
mirror of https://github.com/Llewellynvdm/starship.git synced 2024-12-27 03:42:39 +00:00

docs: Add undocumented config options (#262)

This commit is contained in:
Matan Kushner 2019-08-29 13:09:36 -04:00 committed by GitHub
parent 9918dd1aac
commit c121dd4d44
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -63,7 +63,9 @@ prompt_order=["rust","line_break","package","line_break","character"]
``` ```
### Default prompt order ### Default prompt order
The ```default_prompt_order``` configuration option is used to define the order in which modules are shown in the prompt, if empty or no ```prompt_order``` is provided. The default is as shown:
The `default_prompt_order` configuration option is used to define the order in which modules are shown in the prompt, if empty or no `prompt_order` is provided. The default is as shown:
``` ```
default_prompt_order = [ default_prompt_order = [
"username", "username",
@ -84,7 +86,6 @@ default_prompt_order = [
] ]
``` ```
## Battery ## Battery
The `battery` module shows how charged the device's battery is and its current charging status. The `battery` module shows how charged the device's battery is and its current charging status.
@ -189,7 +190,7 @@ it would have been `nixpkgs/pkgs`.
### Options ### Options
| Variable | Default | Description | | Variable | Default | Description |
| ------------------- | ------- | -------------------------------------------------------------------------------- | | --------------------------- | ------- | -------------------------------------------------------------------------------- |
| `truncation_length` | `3` | The number of parent folders that the current directory should be truncated to. | | `truncation_length` | `3` | The number of parent folders that the current directory should be truncated to. |
| `truncate_to_repo` | `true` | Whether or not to truncate to the root of the git repo that you're currently in. | | `truncate_to_repo` | `true` | Whether or not to truncate to the root of the git repo that you're currently in. |
| `disabled` | `false` | Disables the `directory` module. | | `disabled` | `false` | Disables the `directory` module. |
@ -302,7 +303,8 @@ more than the `threshold` config value, if it exists.
### Options ### Options
| Variable | Default | Description | | Variable | Default | Description |
| ----------- | ------- | -------------------------------- | | ----------- | ------- | ----------------------------------------------------- |
| `symbol` | `"✦ "` | The symbol used before displaying the number of jobs. |
| `threshold` | `1` | Show number of jobs if exceeded. | | `threshold` | `1` | Show number of jobs if exceeded. |
| `disabled` | `false` | Disables the `jobs` module. | | `disabled` | `false` | Disables the `jobs` module. |
@ -312,6 +314,7 @@ more than the `threshold` config value, if it exists.
# ~/.config/starship.toml # ~/.config/starship.toml
[jobs] [jobs]
symbol = "+ "
threshold = 4 threshold = 4
``` ```
@ -346,6 +349,7 @@ The module will be shown if any of the following conditions are met:
| Variable | Default | Description | | Variable | Default | Description |
| ---------- | ------- | --------------------------- | | ---------- | ------- | --------------------------- |
| `symbol` | `"💎 "` | The symbol used before displaying the version of Ruby. |
| `disabled` | `false` | Disables the `ruby` module. | | `disabled` | `false` | Disables the `ruby` module. |
### Example ### Example
@ -354,7 +358,7 @@ The module will be shown if any of the following conditions are met:
# ~/.config/starship.toml # ~/.config/starship.toml
[ruby] [ruby]
disabled = false symbol = "🔺 "
``` ```
## NodeJS ## NodeJS
@ -463,7 +467,7 @@ The module will be shown if any of the following conditions are met:
### Options ### Options
| Variable | Default | Description | | Variable | Default | Description |
| ---------- | ------- | -------------------------------------------------------- | | ---------- | ------- | ------------------------------------------------------ |
| `symbol` | `"🦀 "` | The symbol used before displaying the version of Rust. | | `symbol` | `"🦀 "` | The symbol used before displaying the version of Rust. |
| `disabled` | `false` | Disables the `rust` module. | | `disabled` | `false` | Disables the `rust` module. |