summaryrefslogtreecommitdiffstats
path: root/docs/config/README.md
diff options
context:
space:
mode:
author[Error_27] <error27dev@gmail.com>2024-04-05 17:56:49 -0400
committerGitHub <noreply@github.com>2024-04-05 23:56:49 +0200
commit335c514e9ee5fa5bc8a8294b4804ddf198504b97 (patch)
tree0b1cbf1398416142864a110f92a30483aeaf0338 /docs/config/README.md
parent34a8f7e62845fd66df3f6f9003cb850f2b0d9bc5 (diff)
feat(odin): Add Odin Lang module (#5873)
* Add Odin lang module * add utils string and remove commit number from output * switch to new symbol because ZWJ support is rare * add config docs * add option to show the commit number * fix lack of trimming * fix formatting to comply with checks * Add trailing newline to comply with cargo fmt * Add new Odin test and add newline in cmd output
Diffstat (limited to 'docs/config/README.md')
-rw-r--r--docs/config/README.md37
1 files changed, 37 insertions, 0 deletions
diff --git a/docs/config/README.md b/docs/config/README.md
index f889ca8ff..794190b71 100644
--- a/docs/config/README.md
+++ b/docs/config/README.md
@@ -3114,6 +3114,43 @@ By default the module will be shown if any of the following conditions are met:
format = 'via [🐪 $version]($style) '
```
+## Odin
+
+The 'odin' module shows the currently installed version of [Odin](https://odin-lang.org/). By default the module will be shown if the current directory contains a `.odin` file.
+
+### Options
+
+| Option | Default | Description |
+| ------------------- | ------------------------------------ | ----------------------------------------------------- |
+| `format` | `'via [$symbol($version )]($style)'` | The format for the module. |
+| `show_commit` | `false` | Shows the commit as part of the version. |
+| `symbol` | `'Ø '` | The symbol used before displaying the version of Zig. |
+| `style` | `'bold bright-blue'` | The style for the module. |
+| `disabled` | `false` | Disables the `odin` module. |
+| `detect_extensions` | `['odin']` | Which extensions should trigger this module. |
+| `detect_files` | `[]` | Which filenames should trigger this module. |
+| `detect_folders` | `[]` | Which folders should trigger this module. |
+
+### Variables
+
+| Variable | Example | Description |
+| -------- | ------------- | ------------------------------------ |
+| version | `dev-2024-03` | The version of `odin` |
+| symbol | | Mirrors the value of option `symbol` |
+| style\* | | Mirrors the value of option `style` |
+
+*: This variable can only be used as a part of a style string
+
+### Example
+
+```toml
+# ~/.config/starship.toml
+
+[odin]
+format = 'via [󰹩 ($version )]($style)'
+show_commit = true
+```
+
## Open Policy Agent
The `opa` module shows the currently installed version of the OPA tool.