mirror of
https://github.com/starship/starship.git
synced 2024-11-07 08:54:50 +01:00
docs(i18n): new Crowdin updates (#5898)
* New translations readme.md (Russian) * New translations readme.md (Turkish) * New translations readme.md (Ukrainian) * New translations readme.md (Chinese Simplified) * New translations readme.md (Chinese Traditional) * New translations readme.md (Vietnamese) * New translations readme.md (Portuguese, Brazilian) * New translations readme.md (Indonesian) * New translations readme.md (Bengali) * New translations readme.md (Sorani (Kurdish)) * New translations readme.md (Ukrainian) * New translations readme.md (Ukrainian) * New translations readme.md (Ukrainian) * New translations readme.md (Ukrainian) * New translations readme.md (French) * New translations readme.md (Spanish) * New translations readme.md (Arabic) * New translations readme.md (German) * New translations readme.md (Italian) * New translations readme.md (Japanese) * New translations readme.md (Korean) * New translations readme.md (Dutch) * New translations readme.md (Norwegian) * New translations readme.md (Polish) * New translations readme.md (Portuguese) * New translations readme.md (Russian) * New translations readme.md (Turkish) * New translations readme.md (Ukrainian) * New translations readme.md (Chinese Simplified) * New translations readme.md (Chinese Traditional) * New translations readme.md (Vietnamese) * New translations readme.md (Portuguese, Brazilian) * New translations readme.md (Indonesian) * New translations readme.md (Bengali) * New translations readme.md (Sorani (Kurdish)) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations no-nerd-font.md (Japanese) * New translations no-empty-icons.md (Japanese) * New translations gruvbox-rainbow.md (Japanese) * New translations jetpack.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (French) * New translations readme.md (Spanish) * New translations readme.md (Arabic) * New translations readme.md (German) * New translations readme.md (Italian) * New translations readme.md (Japanese) * New translations readme.md (Korean) * New translations readme.md (Dutch) * New translations readme.md (Norwegian) * New translations readme.md (Polish) * New translations readme.md (Portuguese) * New translations readme.md (Russian) * New translations readme.md (Turkish) * New translations readme.md (Ukrainian) * New translations readme.md (Chinese Simplified) * New translations readme.md (Chinese Traditional) * New translations readme.md (Vietnamese) * New translations readme.md (Portuguese, Brazilian) * New translations readme.md (Indonesian) * New translations readme.md (Bengali) * New translations readme.md (Sorani (Kurdish)) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (French) * New translations readme.md (Spanish) * New translations readme.md (Arabic) * New translations readme.md (German) * New translations readme.md (Italian) * New translations readme.md (Japanese) * New translations readme.md (Korean) * New translations readme.md (Dutch) * New translations readme.md (Norwegian) * New translations readme.md (Polish) * New translations readme.md (Portuguese) * New translations readme.md (Russian) * New translations readme.md (Turkish) * New translations readme.md (Ukrainian) * New translations readme.md (Chinese Simplified) * New translations readme.md (Chinese Traditional) * New translations readme.md (Vietnamese) * New translations readme.md (Portuguese, Brazilian) * New translations readme.md (Indonesian) * New translations readme.md (Bengali) * New translations readme.md (Sorani (Kurdish)) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Ukrainian) * New translations readme.md (Ukrainian) * New translations readme.md (Japanese) * New translations readme.md (French) * New translations readme.md (Spanish) * New translations readme.md (Arabic) * New translations readme.md (German) * New translations readme.md (Italian) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Korean) * New translations readme.md (Dutch) * New translations readme.md (Norwegian) * New translations readme.md (Polish) * New translations readme.md (Portuguese) * New translations readme.md (Russian) * New translations readme.md (Turkish) * New translations readme.md (Ukrainian) * New translations readme.md (Chinese Simplified) * New translations readme.md (Chinese Traditional) * New translations readme.md (Vietnamese) * New translations readme.md (Portuguese, Brazilian) * New translations readme.md (Indonesian) * New translations readme.md (Bengali) * New translations readme.md (Sorani (Kurdish)) * New translations readme.md (French) * New translations readme.md (Spanish) * New translations readme.md (Arabic) * New translations readme.md (German) * New translations readme.md (Italian) * New translations readme.md (Japanese) * New translations readme.md (Korean) * New translations readme.md (Dutch) * New translations readme.md (Norwegian) * New translations readme.md (Polish) * New translations readme.md (Portuguese) * New translations readme.md (Russian) * New translations readme.md (Turkish) * New translations readme.md (Ukrainian) * New translations readme.md (Chinese Simplified) * New translations readme.md (Chinese Traditional) * New translations readme.md (Vietnamese) * New translations readme.md (Portuguese, Brazilian) * New translations readme.md (Indonesian) * New translations readme.md (Bengali) * New translations readme.md (Sorani (Kurdish)) * New translations readme.md (Spanish) * New translations readme.md (Japanese) * New translations readme.md (Russian) * New translations readme.md (Ukrainian) * New translations readme.md (Chinese Simplified) * New translations readme.md (Portuguese, Brazilian) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Ukrainian) * New translations readme.md (Ukrainian) * New translations readme.md (Chinese Simplified) * New translations readme.md (Vietnamese) * New translations readme.md (French) * New translations readme.md (Spanish) * New translations readme.md (Arabic) * New translations readme.md (German) * New translations readme.md (Italian) * New translations readme.md (Japanese) * New translations readme.md (Korean) * New translations readme.md (Dutch) * New translations readme.md (Norwegian) * New translations readme.md (Polish) * New translations readme.md (Portuguese) * New translations readme.md (Russian) * New translations readme.md (Turkish) * New translations readme.md (Ukrainian) * New translations readme.md (Chinese Simplified) * New translations readme.md (Chinese Traditional) * New translations readme.md (Vietnamese) * New translations readme.md (Portuguese, Brazilian) * New translations readme.md (Indonesian) * New translations readme.md (Bengali) * New translations readme.md (Sorani (Kurdish)) * New translations readme.md (French) * New translations readme.md (Spanish) * New translations readme.md (Spanish) * New translations readme.md (Arabic) * New translations readme.md (Arabic) * New translations readme.md (German) * New translations readme.md (German) * New translations readme.md (Italian) * New translations readme.md (Italian) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Korean) * New translations readme.md (Korean) * New translations readme.md (Dutch) * New translations readme.md (Dutch) * New translations readme.md (Norwegian) * New translations readme.md (Norwegian) * New translations readme.md (Polish) * New translations readme.md (Polish) * New translations readme.md (Portuguese) * New translations readme.md (Portuguese) * New translations readme.md (Russian) * New translations readme.md (Russian) * New translations readme.md (Turkish) * New translations readme.md (Turkish) * New translations readme.md (Ukrainian) * New translations readme.md (Ukrainian) * New translations readme.md (Chinese Simplified) * New translations readme.md (Chinese Simplified) * New translations readme.md (Chinese Traditional) * New translations readme.md (Chinese Traditional) * New translations readme.md (Vietnamese) * New translations readme.md (Vietnamese) * New translations readme.md (Portuguese, Brazilian) * New translations readme.md (Portuguese, Brazilian) * New translations readme.md (Indonesian) * New translations readme.md (Indonesian) * New translations readme.md (Bengali) * New translations readme.md (Bengali) * New translations readme.md (Sorani (Kurdish)) * New translations readme.md (Sorani (Kurdish)) * New translations readme.md (French) * New translations readme.md (French) * New translations readme.md (Spanish) * New translations readme.md (Arabic) * New translations readme.md (German) * New translations readme.md (Italian) * New translations readme.md (Japanese) * New translations readme.md (Korean) * New translations readme.md (Dutch) * New translations readme.md (Norwegian) * New translations readme.md (Polish) * New translations readme.md (Portuguese) * New translations readme.md (Russian) * New translations readme.md (Turkish) * New translations readme.md (Ukrainian) * New translations readme.md (Chinese Simplified) * New translations readme.md (Chinese Traditional) * New translations readme.md (Vietnamese) * New translations readme.md (Portuguese, Brazilian) * New translations readme.md (Indonesian) * New translations readme.md (Bengali) * New translations readme.md (Sorani (Kurdish))
This commit is contained in:
Matan Kushner
GitHub
parent
1e69606360
commit
4ab10c8d10
@ -25,6 +25,20 @@ metaTitle: "Starship: Cross-Shell Prompt"
|
||||
description: Starship is the minimal, blazing fast, and extremely customizable prompt for any shell! Shows the information you need, while staying sleek and minimal. Quick installation available for Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, and PowerShell.
|
||||
---
|
||||
|
||||
<script setup>
|
||||
import { onMounted } from 'vue'
|
||||
|
||||
onMounted(() => {
|
||||
const urlParams = new URLSearchParams(window.location.search)
|
||||
if (urlParams.has('uwu') || urlParams.has('kawaii')) {
|
||||
const img = document.querySelector('.VPHero .VPImage.image-src')
|
||||
img.classList.add('uwu')
|
||||
img.src = '/logo-uwu.png'
|
||||
img.alt = 'Kawaii Starship Logo by @sawaratsuki1004'
|
||||
}
|
||||
})
|
||||
</script>
|
||||
|
||||
<video class="demo-video" muted autoplay loop playsinline>
|
||||
<source src="/demo.webm" type="video/webm">
|
||||
<source src="/demo.mp4" type="video/mp4">
|
||||
|
||||
@ -84,20 +84,20 @@ enable_transience
|
||||
|
||||
The [Ble.sh](https://github.com/akinomyoga/ble.sh) framework at v0.4 or higher allows you to replace the previous-printed prompt with custom strings. This is useful in cases where all the prompt information is not always needed. To enable this, put this in `~/.bashrc` `bleopt prompt_ps1_transient=<value>`:
|
||||
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and this option has a non-empty value, the prompt specified by `PS1` is erased on leaving the current command line. If the value contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in the value and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and the option `prompt_ps1_transient` has a non-empty \<value\>, the prompt specified by `PS1` is erased on leaving the current command line. If \<value\> contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in \<value\> and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
|
||||
Make the following changes to your `~/.bashrc` to customize what gets displayed on the left and on the right:
|
||||
Make the following changes to your `~/.blerc` (or in `~/.config/blesh/init.sh`) to customize what gets displayed on the left and on the right:
|
||||
|
||||
- To customize what the left side of input gets replaced with, configure the `prompt_ps1_final` Ble.sh option. For example, to display Starship's `character` module here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_ps1_final="$(starship module character)"
|
||||
bleopt prompt_ps1_final='$(starship module character)'
|
||||
```
|
||||
|
||||
- To customize what the right side of input gets replaced with, configure the `prompt_rps1_final` Ble.sh option. For example, to display the time at which the last command was started here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_rps1_final="$(starship module time)"
|
||||
bleopt prompt_rps1_final='$(starship module time)'
|
||||
```
|
||||
|
||||
## Custom pre-prompt and pre-execution Commands in Cmd
|
||||
@ -266,7 +266,7 @@ Note: Continuation prompts are only available in the following shells:
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
# A continuation prompt that displays two filled in arrows
|
||||
# A continuation prompt that displays two filled-in arrows
|
||||
continuation_prompt = '▶▶ '
|
||||
```
|
||||
|
||||
@ -301,6 +301,6 @@ If multiple colors are specified for foreground/background, the last one in the
|
||||
|
||||
Not every style string will be displayed correctly by every terminal. In particular, the following known quirks exist:
|
||||
|
||||
- Many terminals disable support for `blink` by default
|
||||
- Many terminals disable support for `blink` by default.
|
||||
- `hidden` is [not supported on iTerm](https://gitlab.com/gnachman/iterm2/-/issues/4564).
|
||||
- `strikethrough` is not supported by the default macOS Terminal.app
|
||||
- `strikethrough` is not supported by the default macOS Terminal.app.
|
||||
|
||||
@ -281,6 +281,7 @@ $elixir\
|
||||
$elm\
|
||||
$erlang\
|
||||
$fennel\
|
||||
$gleam\
|
||||
$golang\
|
||||
$guix_shell\
|
||||
$haskell\
|
||||
@ -324,6 +325,7 @@ $aws\
|
||||
$gcloud\
|
||||
$openstack\
|
||||
$azure\
|
||||
$nats\
|
||||
$direnv\
|
||||
$env_var\
|
||||
$crystal\
|
||||
@ -601,7 +603,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
|
||||
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | The format for the module. |
|
||||
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'🍞 '` | A format string representing the symbol of Bun. |
|
||||
| `symbol` | `'🥟 '` | A format string representing the symbol of Bun. |
|
||||
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['bun.lockb', 'bunfig.toml']` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this module. |
|
||||
@ -1966,6 +1968,44 @@ Use Windows Starship executable on Windows paths in WSL
|
||||
windows_starship = '/mnt/c/Users/username/scoop/apps/starship/current/starship.exe'
|
||||
```
|
||||
|
||||
## Gleam
|
||||
|
||||
The `gleam` module shows the currently installed version of [Gleam](https://gleam.run/). By default the module will be shown if any of the following conditions are met:
|
||||
|
||||
- The current directory contains a `gleam.toml` file
|
||||
- The current directory contains a file with the `.gleam` extension
|
||||
|
||||
### Options
|
||||
|
||||
| Option | الافتراضي | الوصف |
|
||||
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | The format for the module. |
|
||||
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'⭐ '` | A format string representing the symbol of Go. |
|
||||
| `detect_extensions` | `['gleam']` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['gleam.toml']` | Which filenames should trigger this module. |
|
||||
| `style` | `'bold #FFAFF3'` | The style for the module. |
|
||||
| `disabled` | `false` | Disables the `gleam` module. |
|
||||
|
||||
### Variables
|
||||
|
||||
| Variable | مثال | الوصف |
|
||||
| --------- | -------- | ------------------------------------ |
|
||||
| version | `v1.0.0` | The version of `gleam` |
|
||||
| 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
|
||||
|
||||
### مثال
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
[gleam]
|
||||
format = 'via [⭐ $version](bold red) '
|
||||
```
|
||||
|
||||
## Go
|
||||
|
||||
The `golang` module shows the currently installed version of [Go](https://golang.org/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2444,7 +2484,7 @@ Displays the current [Kubernetes context](https://kubernetes.io/docs/concepts/co
|
||||
|
||||
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
|
||||
|
||||
When the module is enabled it will always be active, unless any of `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions.
|
||||
When the module is enabled it will always be active, unless any of `detect_env_vars`, `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions or one of the environmatal variable has been set.
|
||||
|
||||
:::
|
||||
|
||||
@ -2466,6 +2506,7 @@ The `context_aliases` and `user_aliases` options are deprecated. Use `contexts`
|
||||
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `[]` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this modules. |
|
||||
| `detect_env_vars` | `[]` | Which environmental variables should trigger this module |
|
||||
| `contexts` | `[]` | Customized styles and symbols for specific contexts. |
|
||||
| `disabled` | `true` | Disables the `kubernetes` module. |
|
||||
|
||||
@ -2768,6 +2809,35 @@ truncation_length = 4
|
||||
truncation_symbol = ''
|
||||
```
|
||||
|
||||
## NATS
|
||||
|
||||
The `nats` module shows the name of the current [NATS](https://nats.io) context.
|
||||
|
||||
### Options
|
||||
|
||||
| Option | الافتراضي | الوصف |
|
||||
| ---------- | -------------------------- | ------------------------------------------------------------ |
|
||||
| `symbol` | `'✉️ '` | The symbol used before the NATS context (defaults to empty). |
|
||||
| `style` | `'bold purple'` | The style for the module. |
|
||||
| `format` | `'[$symbol$name]($style)'` | The format for the module. |
|
||||
| `disabled` | `false` | Disables the `nats` module. |
|
||||
|
||||
### Variables
|
||||
|
||||
| Variable | مثال | الوصف |
|
||||
| --------- | ----------- | ------------------------------------ |
|
||||
| name | `localhost` | The name of the NATS context |
|
||||
| symbol | | Mirrors the value of option `symbol` |
|
||||
| style\* | | Mirrors the value of option `style` |
|
||||
|
||||
### مثال
|
||||
|
||||
```toml
|
||||
[nats]
|
||||
format = '[$symbol]($style)'
|
||||
style = 'bold purple'
|
||||
```
|
||||
|
||||
## Nim
|
||||
|
||||
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2943,6 +3013,43 @@ The `ocaml` module shows the currently installed version of [OCaml](https://ocam
|
||||
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 | الافتراضي | الوصف |
|
||||
| ------------------- | ------------------------------------ | ----------------------------------------------------- |
|
||||
| `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 | مثال | الوصف |
|
||||
| --------- | ------------- | ------------------------------------ |
|
||||
| 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
|
||||
|
||||
### مثال
|
||||
|
||||
```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. By default the module will be shown if the current directory contains a `.rego` file.
|
||||
@ -3811,7 +3918,7 @@ format = '$shlvl level(s) down'
|
||||
threshold = 3
|
||||
```
|
||||
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceeding characters are provided by `shlvl`.
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceding characters are provided by `shlvl`.
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
@ -4241,6 +4348,7 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
|
||||
| `format` | `'[$user]($style) in '` | The format for the module. |
|
||||
| `show_always` | `false` | Always shows the `username` module. |
|
||||
| `disabled` | `false` | Disables the `username` module. |
|
||||
| `aliases` | `{}` | Translate system usernames to something else |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -4262,6 +4370,7 @@ style_root = 'black bold'
|
||||
format = 'user: [$user]($style) '
|
||||
disabled = false
|
||||
show_always = true
|
||||
aliases = { "corpuser034g" = "matchai" }
|
||||
```
|
||||
|
||||
#### Hide the hostname in remote tmux sessions
|
||||
|
||||
@ -123,7 +123,7 @@ sh -c 'rm "$(command -v 'starship')"'
|
||||
|
||||
## How do I install Starship without `sudo`?
|
||||
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation directory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
|
||||
For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
|
||||
|
||||
|
||||
@ -431,6 +431,8 @@ If you're looking to further customize Starship:
|
||||
|
||||
Support this project by [becoming a sponsor](https://github.com/sponsors/starship). Your name or logo will show up here with a link to your website.
|
||||
|
||||
- Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org)
|
||||
|
||||
<p align="center">
|
||||
<br>
|
||||
<img width="100" src="https://raw.githubusercontent.com/starship/starship/master/media/icon.png" alt="Starship rocket icon">
|
||||
|
||||
@ -45,7 +45,7 @@ curl -sS https://starship.rs/install.sh | sh -s -- --bin-dir /data/data/com.term
|
||||
emerge app-shells/starship
|
||||
```
|
||||
|
||||
## [Nix](https://nixos.wiki/wiki/Nix)
|
||||
## [Nix](https://wiki.nixos.org/wiki/Nix)
|
||||
|
||||
### احصل على ملفات الباينري
|
||||
|
||||
|
||||
@ -25,6 +25,20 @@ metaTitle: "Starship: Cross-Shell Prompt"
|
||||
description: Starship is the minimal, blazing fast, and extremely customizable prompt for any shell! Shows the information you need, while staying sleek and minimal. Quick installation available for Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, and PowerShell.
|
||||
---
|
||||
|
||||
<script setup>
|
||||
import { onMounted } from 'vue'
|
||||
|
||||
onMounted(() => {
|
||||
const urlParams = new URLSearchParams(window.location.search)
|
||||
if (urlParams.has('uwu') || urlParams.has('kawaii')) {
|
||||
const img = document.querySelector('.VPHero .VPImage.image-src')
|
||||
img.classList.add('uwu')
|
||||
img.src = '/logo-uwu.png'
|
||||
img.alt = 'Kawaii Starship Logo by @sawaratsuki1004'
|
||||
}
|
||||
})
|
||||
</script>
|
||||
|
||||
<video class="demo-video" muted autoplay loop playsinline>
|
||||
<source src="/demo.webm" type="video/webm">
|
||||
<source src="/demo.mp4" type="video/mp4">
|
||||
|
||||
@ -84,20 +84,20 @@ enable_transience
|
||||
|
||||
The [Ble.sh](https://github.com/akinomyoga/ble.sh) framework at v0.4 or higher allows you to replace the previous-printed prompt with custom strings. This is useful in cases where all the prompt information is not always needed. To enable this, put this in `~/.bashrc` `bleopt prompt_ps1_transient=<value>`:
|
||||
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and this option has a non-empty value, the prompt specified by `PS1` is erased on leaving the current command line. If the value contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in the value and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and the option `prompt_ps1_transient` has a non-empty \<value\>, the prompt specified by `PS1` is erased on leaving the current command line. If \<value\> contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in \<value\> and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
|
||||
Make the following changes to your `~/.bashrc` to customize what gets displayed on the left and on the right:
|
||||
Make the following changes to your `~/.blerc` (or in `~/.config/blesh/init.sh`) to customize what gets displayed on the left and on the right:
|
||||
|
||||
- To customize what the left side of input gets replaced with, configure the `prompt_ps1_final` Ble.sh option. For example, to display Starship's `character` module here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_ps1_final="$(starship module character)"
|
||||
bleopt prompt_ps1_final='$(starship module character)'
|
||||
```
|
||||
|
||||
- To customize what the right side of input gets replaced with, configure the `prompt_rps1_final` Ble.sh option. For example, to display the time at which the last command was started here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_rps1_final="$(starship module time)"
|
||||
bleopt prompt_rps1_final='$(starship module time)'
|
||||
```
|
||||
|
||||
## Custom pre-prompt and pre-execution Commands in Cmd
|
||||
@ -266,7 +266,7 @@ Note: Continuation prompts are only available in the following shells:
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
# A continuation prompt that displays two filled in arrows
|
||||
# A continuation prompt that displays two filled-in arrows
|
||||
continuation_prompt = '▶▶ '
|
||||
```
|
||||
|
||||
@ -301,6 +301,6 @@ If multiple colors are specified for foreground/background, the last one in the
|
||||
|
||||
Not every style string will be displayed correctly by every terminal. In particular, the following known quirks exist:
|
||||
|
||||
- Many terminals disable support for `blink` by default
|
||||
- Many terminals disable support for `blink` by default.
|
||||
- `hidden` is [not supported on iTerm](https://gitlab.com/gnachman/iterm2/-/issues/4564).
|
||||
- `strikethrough` is not supported by the default macOS Terminal.app
|
||||
- `strikethrough` is not supported by the default macOS Terminal.app.
|
||||
|
||||
@ -281,6 +281,7 @@ $elixir\
|
||||
$elm\
|
||||
$erlang\
|
||||
$fennel\
|
||||
$gleam\
|
||||
$golang\
|
||||
$guix_shell\
|
||||
$haskell\
|
||||
@ -324,6 +325,7 @@ $aws\
|
||||
$gcloud\
|
||||
$openstack\
|
||||
$azure\
|
||||
$nats\
|
||||
$direnv\
|
||||
$env_var\
|
||||
$crystal\
|
||||
@ -601,7 +603,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
|
||||
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | The format for the module. |
|
||||
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'🍞 '` | A format string representing the symbol of Bun. |
|
||||
| `symbol` | `'🥟 '` | A format string representing the symbol of Bun. |
|
||||
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['bun.lockb', 'bunfig.toml']` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this module. |
|
||||
@ -1966,6 +1968,44 @@ Use Windows Starship executable on Windows paths in WSL
|
||||
windows_starship = '/mnt/c/Users/username/scoop/apps/starship/current/starship.exe'
|
||||
```
|
||||
|
||||
## Gleam
|
||||
|
||||
The `gleam` module shows the currently installed version of [Gleam](https://gleam.run/). By default the module will be shown if any of the following conditions are met:
|
||||
|
||||
- The current directory contains a `gleam.toml` file
|
||||
- The current directory contains a file with the `.gleam` extension
|
||||
|
||||
### Options
|
||||
|
||||
| Option | Default | Description |
|
||||
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | The format for the module. |
|
||||
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'⭐ '` | A format string representing the symbol of Go. |
|
||||
| `detect_extensions` | `['gleam']` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['gleam.toml']` | Which filenames should trigger this module. |
|
||||
| `style` | `'bold #FFAFF3'` | The style for the module. |
|
||||
| `disabled` | `false` | Disables the `gleam` module. |
|
||||
|
||||
### Variables
|
||||
|
||||
| Variable | Example | Description |
|
||||
| --------- | -------- | ------------------------------------ |
|
||||
| version | `v1.0.0` | The version of `gleam` |
|
||||
| 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
|
||||
|
||||
[gleam]
|
||||
format = 'via [⭐ $version](bold red) '
|
||||
```
|
||||
|
||||
## Go
|
||||
|
||||
The `golang` module shows the currently installed version of [Go](https://golang.org/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2444,7 +2484,7 @@ Displays the current [Kubernetes context](https://kubernetes.io/docs/concepts/co
|
||||
|
||||
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
|
||||
|
||||
When the module is enabled it will always be active, unless any of `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions.
|
||||
When the module is enabled it will always be active, unless any of `detect_env_vars`, `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions or one of the environmatal variable has been set.
|
||||
|
||||
:::
|
||||
|
||||
@ -2466,6 +2506,7 @@ The `context_aliases` and `user_aliases` options are deprecated. Use `contexts`
|
||||
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `[]` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this modules. |
|
||||
| `detect_env_vars` | `[]` | Which environmental variables should trigger this module |
|
||||
| `contexts` | `[]` | Customized styles and symbols for specific contexts. |
|
||||
| `disabled` | `true` | Disables the `kubernetes` module. |
|
||||
|
||||
@ -2768,6 +2809,35 @@ truncation_length = 4
|
||||
truncation_symbol = ''
|
||||
```
|
||||
|
||||
## NATS
|
||||
|
||||
The `nats` module shows the name of the current [NATS](https://nats.io) context.
|
||||
|
||||
### Options
|
||||
|
||||
| Option | Default | Description |
|
||||
| ---------- | -------------------------- | ------------------------------------------------------------ |
|
||||
| `symbol` | `'✉️ '` | The symbol used before the NATS context (defaults to empty). |
|
||||
| `style` | `'bold purple'` | The style for the module. |
|
||||
| `format` | `'[$symbol$name]($style)'` | The format for the module. |
|
||||
| `disabled` | `false` | Disables the `nats` module. |
|
||||
|
||||
### Variables
|
||||
|
||||
| Variable | Example | Description |
|
||||
| --------- | ----------- | ------------------------------------ |
|
||||
| name | `localhost` | The name of the NATS context |
|
||||
| symbol | | Mirrors the value of option `symbol` |
|
||||
| style\* | | Mirrors the value of option `style` |
|
||||
|
||||
### Example
|
||||
|
||||
```toml
|
||||
[nats]
|
||||
format = '[$symbol]($style)'
|
||||
style = 'bold purple'
|
||||
```
|
||||
|
||||
## Nim
|
||||
|
||||
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2943,6 +3013,43 @@ The `ocaml` module shows the currently installed version of [OCaml](https://ocam
|
||||
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. By default the module will be shown if the current directory contains a `.rego` file.
|
||||
@ -3811,7 +3918,7 @@ format = '$shlvl level(s) down'
|
||||
threshold = 3
|
||||
```
|
||||
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceeding characters are provided by `shlvl`.
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceding characters are provided by `shlvl`.
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
@ -4241,6 +4348,7 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
|
||||
| `format` | `'[$user]($style) in '` | The format for the module. |
|
||||
| `show_always` | `false` | Always shows the `username` module. |
|
||||
| `disabled` | `false` | Disables the `username` module. |
|
||||
| `aliases` | `{}` | Translate system usernames to something else |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -4262,6 +4370,7 @@ style_root = 'black bold'
|
||||
format = 'user: [$user]($style) '
|
||||
disabled = false
|
||||
show_always = true
|
||||
aliases = { "corpuser034g" = "matchai" }
|
||||
```
|
||||
|
||||
#### Hide the hostname in remote tmux sessions
|
||||
|
||||
@ -123,7 +123,7 @@ sh -c 'rm "$(command -v 'starship')"'
|
||||
|
||||
## How do I install Starship without `sudo`?
|
||||
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation directory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
|
||||
For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
|
||||
|
||||
|
||||
@ -431,6 +431,8 @@ eval "$(starship init zsh)"
|
||||
|
||||
[একজন স্পনসর হয়ে](https://github.com/sponsors/starship) এই প্রোজেক্টটিকে আর্থিক ভাবে সহায়তা করুন । আপনার নাম অথবা লোগো নিম্নে দেখা যাবে আপনার ওয়েবসাইট এর লিঙ্ক সহ ।
|
||||
|
||||
- Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org)
|
||||
|
||||
<p align="center">
|
||||
<br>
|
||||
<img width="100" src="https://raw.githubusercontent.com/starship/starship/master/media/icon.png" alt="Starship rocket icon">
|
||||
|
||||
@ -45,7 +45,7 @@ On Funtoo Linux, starship can be installed from [core-kit](https://github.com/fu
|
||||
emerge app-shells/starship
|
||||
```
|
||||
|
||||
## [Nix](https://nixos.wiki/wiki/Nix)
|
||||
## [Nix](https://wiki.nixos.org/wiki/Nix)
|
||||
|
||||
### Getting the Binary
|
||||
|
||||
|
||||
@ -25,6 +25,20 @@ metaTitle: "Starship: یەکێ لە Promptـە شێڵ نەناسەکان"
|
||||
description: 'Starship: یەکێ لە promptـە سوکەڵە، خێرا، و بێسنور دڵخوازکراوەکان بۆ هەر شێڵێک! ئەو زانیارییانە پشان دەدات کە پێویستە، لەوکاتەیا بە ئارامی و سوکەڵەیی ئەمێنێتەوە. Quick installation available for Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, and PowerShell.'
|
||||
---
|
||||
|
||||
<script setup>
|
||||
import { onMounted } from 'vue'
|
||||
|
||||
onMounted(() => {
|
||||
const urlParams = new URLSearchParams(window.location.search)
|
||||
if (urlParams.has('uwu') || urlParams.has('kawaii')) {
|
||||
const img = document.querySelector('.VPHero .VPImage.image-src')
|
||||
img.classList.add('uwu')
|
||||
img.src = '/logo-uwu.png'
|
||||
img.alt = 'Kawaii Starship Logo by @sawaratsuki1004'
|
||||
}
|
||||
})
|
||||
</script>
|
||||
|
||||
<video class="demo-video" muted autoplay loop playsinline>
|
||||
<source src="/demo.webm" type="video/webm">
|
||||
<source src="/demo.mp4" type="video/mp4">
|
||||
|
||||
@ -84,20 +84,20 @@ enable_transience
|
||||
|
||||
The [Ble.sh](https://github.com/akinomyoga/ble.sh) framework at v0.4 or higher allows you to replace the previous-printed prompt with custom strings. This is useful in cases where all the prompt information is not always needed. To enable this, put this in `~/.bashrc` `bleopt prompt_ps1_transient=<value>`:
|
||||
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and this option has a non-empty value, the prompt specified by `PS1` is erased on leaving the current command line. If the value contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in the value and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and the option `prompt_ps1_transient` has a non-empty \<value\>, the prompt specified by `PS1` is erased on leaving the current command line. If \<value\> contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in \<value\> and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
|
||||
Make the following changes to your `~/.bashrc` to customize what gets displayed on the left and on the right:
|
||||
Make the following changes to your `~/.blerc` (or in `~/.config/blesh/init.sh`) to customize what gets displayed on the left and on the right:
|
||||
|
||||
- To customize what the left side of input gets replaced with, configure the `prompt_ps1_final` Ble.sh option. For example, to display Starship's `character` module here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_ps1_final="$(starship module character)"
|
||||
bleopt prompt_ps1_final='$(starship module character)'
|
||||
```
|
||||
|
||||
- To customize what the right side of input gets replaced with, configure the `prompt_rps1_final` Ble.sh option. For example, to display the time at which the last command was started here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_rps1_final="$(starship module time)"
|
||||
bleopt prompt_rps1_final='$(starship module time)'
|
||||
```
|
||||
|
||||
## Custom pre-prompt and pre-execution Commands in Cmd
|
||||
@ -266,7 +266,7 @@ Note: Continuation prompts are only available in the following shells:
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
# A continuation prompt that displays two filled in arrows
|
||||
# A continuation prompt that displays two filled-in arrows
|
||||
continuation_prompt = '▶▶ '
|
||||
```
|
||||
|
||||
@ -301,6 +301,6 @@ If multiple colors are specified for foreground/background, the last one in the
|
||||
|
||||
Not every style string will be displayed correctly by every terminal. In particular, the following known quirks exist:
|
||||
|
||||
- Many terminals disable support for `blink` by default
|
||||
- Many terminals disable support for `blink` by default.
|
||||
- `hidden` is [not supported on iTerm](https://gitlab.com/gnachman/iterm2/-/issues/4564).
|
||||
- `strikethrough` is not supported by the default macOS Terminal.app
|
||||
- `strikethrough` is not supported by the default macOS Terminal.app.
|
||||
|
||||
@ -281,6 +281,7 @@ $elixir\
|
||||
$elm\
|
||||
$erlang\
|
||||
$fennel\
|
||||
$gleam\
|
||||
$golang\
|
||||
$guix_shell\
|
||||
$haskell\
|
||||
@ -324,6 +325,7 @@ $aws\
|
||||
$gcloud\
|
||||
$openstack\
|
||||
$azure\
|
||||
$nats\
|
||||
$direnv\
|
||||
$env_var\
|
||||
$crystal\
|
||||
@ -601,7 +603,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
|
||||
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | The format for the module. |
|
||||
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'🍞 '` | A format string representing the symbol of Bun. |
|
||||
| `symbol` | `'🥟 '` | A format string representing the symbol of Bun. |
|
||||
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['bun.lockb', 'bunfig.toml']` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this module. |
|
||||
@ -1966,6 +1968,44 @@ Use Windows Starship executable on Windows paths in WSL
|
||||
windows_starship = '/mnt/c/Users/username/scoop/apps/starship/current/starship.exe'
|
||||
```
|
||||
|
||||
## Gleam
|
||||
|
||||
The `gleam` module shows the currently installed version of [Gleam](https://gleam.run/). By default the module will be shown if any of the following conditions are met:
|
||||
|
||||
- The current directory contains a `gleam.toml` file
|
||||
- The current directory contains a file with the `.gleam` extension
|
||||
|
||||
### Options
|
||||
|
||||
| Option | Default | Description |
|
||||
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | The format for the module. |
|
||||
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'⭐ '` | A format string representing the symbol of Go. |
|
||||
| `detect_extensions` | `['gleam']` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['gleam.toml']` | Which filenames should trigger this module. |
|
||||
| `style` | `'bold #FFAFF3'` | The style for the module. |
|
||||
| `disabled` | `false` | Disables the `gleam` module. |
|
||||
|
||||
### Variables
|
||||
|
||||
| گۆڕاو | نموونە | Description |
|
||||
| --------- | -------- | ------------------------------------ |
|
||||
| version | `v1.0.0` | The version of `gleam` |
|
||||
| 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
|
||||
|
||||
### نموونە
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
[gleam]
|
||||
format = 'via [⭐ $version](bold red) '
|
||||
```
|
||||
|
||||
## Go
|
||||
|
||||
The `golang` module shows the currently installed version of [Go](https://golang.org/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2444,7 +2484,7 @@ Displays the current [Kubernetes context](https://kubernetes.io/docs/concepts/co
|
||||
|
||||
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
|
||||
|
||||
When the module is enabled it will always be active, unless any of `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions.
|
||||
When the module is enabled it will always be active, unless any of `detect_env_vars`, `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions or one of the environmatal variable has been set.
|
||||
|
||||
:::
|
||||
|
||||
@ -2466,6 +2506,7 @@ The `context_aliases` and `user_aliases` options are deprecated. Use `contexts`
|
||||
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `[]` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this modules. |
|
||||
| `detect_env_vars` | `[]` | Which environmental variables should trigger this module |
|
||||
| `contexts` | `[]` | Customized styles and symbols for specific contexts. |
|
||||
| `disabled` | `true` | Disables the `kubernetes` module. |
|
||||
|
||||
@ -2768,6 +2809,35 @@ truncation_length = 4
|
||||
truncation_symbol = ''
|
||||
```
|
||||
|
||||
## NATS
|
||||
|
||||
The `nats` module shows the name of the current [NATS](https://nats.io) context.
|
||||
|
||||
### Options
|
||||
|
||||
| Option | Default | Description |
|
||||
| ---------- | -------------------------- | ------------------------------------------------------------ |
|
||||
| `symbol` | `'✉️ '` | The symbol used before the NATS context (defaults to empty). |
|
||||
| `style` | `'bold purple'` | The style for the module. |
|
||||
| `format` | `'[$symbol$name]($style)'` | The format for the module. |
|
||||
| `disabled` | `false` | Disables the `nats` module. |
|
||||
|
||||
### Variables
|
||||
|
||||
| گۆڕاو | نموونە | Description |
|
||||
| --------- | ----------- | ------------------------------------ |
|
||||
| name | `localhost` | The name of the NATS context |
|
||||
| symbol | | Mirrors the value of option `symbol` |
|
||||
| style\* | | Mirrors the value of option `style` |
|
||||
|
||||
### نموونە
|
||||
|
||||
```toml
|
||||
[nats]
|
||||
format = '[$symbol]($style)'
|
||||
style = 'bold purple'
|
||||
```
|
||||
|
||||
## Nim
|
||||
|
||||
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2943,6 +3013,43 @@ The `ocaml` module shows the currently installed version of [OCaml](https://ocam
|
||||
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
|
||||
|
||||
| گۆڕاو | نموونە | 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
|
||||
|
||||
### نموونە
|
||||
|
||||
```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. By default the module will be shown if the current directory contains a `.rego` file.
|
||||
@ -3811,7 +3918,7 @@ format = '$shlvl level(s) down'
|
||||
threshold = 3
|
||||
```
|
||||
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceeding characters are provided by `shlvl`.
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceding characters are provided by `shlvl`.
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
@ -4241,6 +4348,7 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
|
||||
| `format` | `'[$user]($style) in '` | The format for the module. |
|
||||
| `show_always` | `false` | Always shows the `username` module. |
|
||||
| `disabled` | `false` | Disables the `username` module. |
|
||||
| `aliases` | `{}` | Translate system usernames to something else |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -4262,6 +4370,7 @@ style_root = 'black bold'
|
||||
format = 'user: [$user]($style) '
|
||||
disabled = false
|
||||
show_always = true
|
||||
aliases = { "corpuser034g" = "matchai" }
|
||||
```
|
||||
|
||||
#### Hide the hostname in remote tmux sessions
|
||||
|
||||
@ -123,7 +123,7 @@ sh -c 'rm "$(command -v 'starship')"'
|
||||
|
||||
## How do I install Starship without `sudo`?
|
||||
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation directory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
|
||||
For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
|
||||
|
||||
|
||||
@ -427,6 +427,8 @@ If you're looking to further customize Starship:
|
||||
|
||||
Support this project by [becoming a sponsor](https://github.com/sponsors/starship). Your name or logo will show up here with a link to your website.
|
||||
|
||||
- Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org)
|
||||
|
||||
<p align="center">
|
||||
<br>
|
||||
<img width="100" src="https://raw.githubusercontent.com/starship/starship/master/media/icon.png" alt="ئایکۆنی مووشەکی Starship">
|
||||
|
||||
@ -45,7 +45,7 @@ On Funtoo Linux, starship can be installed from [core-kit](https://github.com/fu
|
||||
emerge app-shells/starship
|
||||
```
|
||||
|
||||
## [Nix](https://nixos.wiki/wiki/Nix)
|
||||
## [Nix](https://wiki.nixos.org/wiki/Nix)
|
||||
|
||||
### Getting the Binary
|
||||
|
||||
|
||||
@ -25,6 +25,20 @@ metaTitle: "Starship: Cross-Shell Prompt"
|
||||
description: Starship ist eine minimale, super schnelle, und extrem anpassbare Prompt für jede Shell! Sie zeigt die Information, die man benötigt an, während sie schnell und minimal bleibt. Schnell-Installation verfügbar für Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, und PowerShell.
|
||||
---
|
||||
|
||||
<script setup>
|
||||
import { onMounted } from 'vue'
|
||||
|
||||
onMounted(() => {
|
||||
const urlParams = new URLSearchParams(window.location.search)
|
||||
if (urlParams.has('uwu') || urlParams.has('kawaii')) {
|
||||
const img = document.querySelector('.VPHero .VPImage.image-src')
|
||||
img.classList.add('uwu')
|
||||
img.src = '/logo-uwu.png'
|
||||
img.alt = 'Kawaii Starship Logo by @sawaratsuki1004'
|
||||
}
|
||||
})
|
||||
</script>
|
||||
|
||||
<video class="demo-video" muted autoplay loop playsinline>
|
||||
<source src="/demo.webm" type="video/webm">
|
||||
<source src="/demo.mp4" type="video/mp4">
|
||||
|
||||
@ -84,20 +84,20 @@ enable_transience
|
||||
|
||||
The [Ble.sh](https://github.com/akinomyoga/ble.sh) framework at v0.4 or higher allows you to replace the previous-printed prompt with custom strings. This is useful in cases where all the prompt information is not always needed. To enable this, put this in `~/.bashrc` `bleopt prompt_ps1_transient=<value>`:
|
||||
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and this option has a non-empty value, the prompt specified by `PS1` is erased on leaving the current command line. If the value contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in the value and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and the option `prompt_ps1_transient` has a non-empty \<value\>, the prompt specified by `PS1` is erased on leaving the current command line. If \<value\> contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in \<value\> and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
|
||||
Make the following changes to your `~/.bashrc` to customize what gets displayed on the left and on the right:
|
||||
Make the following changes to your `~/.blerc` (or in `~/.config/blesh/init.sh`) to customize what gets displayed on the left and on the right:
|
||||
|
||||
- To customize what the left side of input gets replaced with, configure the `prompt_ps1_final` Ble.sh option. For example, to display Starship's `character` module here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_ps1_final="$(starship module character)"
|
||||
bleopt prompt_ps1_final='$(starship module character)'
|
||||
```
|
||||
|
||||
- To customize what the right side of input gets replaced with, configure the `prompt_rps1_final` Ble.sh option. For example, to display the time at which the last command was started here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_rps1_final="$(starship module time)"
|
||||
bleopt prompt_rps1_final='$(starship module time)'
|
||||
```
|
||||
|
||||
## Custom pre-prompt and pre-execution Commands in Cmd
|
||||
@ -266,7 +266,7 @@ Hinweis: Fortsetzungs-Prompts sind nur für folgende Shells verfügbar:
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
# Ein Fortsetzungs-Prompt der 2 ausgefüllte Pfeile darstellt
|
||||
# A continuation prompt that displays two filled-in arrows
|
||||
continuation_prompt = '▶▶ '
|
||||
```
|
||||
|
||||
@ -301,6 +301,6 @@ Wenn mehrere Farben für Vordergrund oder Hintergrund angegeben werden, hat die
|
||||
|
||||
Not every style string will be displayed correctly by every terminal. In particular, the following known quirks exist:
|
||||
|
||||
- Many terminals disable support for `blink` by default
|
||||
- Many terminals disable support for `blink` by default.
|
||||
- `hidden` is [not supported on iTerm](https://gitlab.com/gnachman/iterm2/-/issues/4564).
|
||||
- `strikethrough` is not supported by the default macOS Terminal.app
|
||||
- `strikethrough` is not supported by the default macOS Terminal.app.
|
||||
|
||||
@ -282,6 +282,7 @@ $elixir\
|
||||
$elm\
|
||||
$erlang\
|
||||
$fennel\
|
||||
$gleam\
|
||||
$golang\
|
||||
$guix_shell\
|
||||
$haskell\
|
||||
@ -325,6 +326,7 @@ $aws\
|
||||
$gcloud\
|
||||
$openstack\
|
||||
$azure\
|
||||
$nats\
|
||||
$direnv\
|
||||
$env_var\
|
||||
$crystal\
|
||||
@ -602,7 +604,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
|
||||
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | Das Format für das Modul. |
|
||||
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'🍞 '` | A format string representing the symbol of Bun. |
|
||||
| `symbol` | `'🥟 '` | A format string representing the symbol of Bun. |
|
||||
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['bun.lockb', 'bunfig.toml']` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this module. |
|
||||
@ -1967,6 +1969,44 @@ Use Windows Starship executable on Windows paths in WSL
|
||||
windows_starship = '/mnt/c/Users/username/scoop/apps/starship/current/starship.exe'
|
||||
```
|
||||
|
||||
## Gleam
|
||||
|
||||
The `gleam` module shows the currently installed version of [Gleam](https://gleam.run/). By default the module will be shown if any of the following conditions are met:
|
||||
|
||||
- The current directory contains a `gleam.toml` file
|
||||
- The current directory contains a file with the `.gleam` extension
|
||||
|
||||
### Optionen
|
||||
|
||||
| Option | Standartwert | Beschreibung |
|
||||
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | Das Format für das Modul. |
|
||||
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'⭐ '` | A format string representing the symbol of Go. |
|
||||
| `detect_extensions` | `['gleam']` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['gleam.toml']` | Which filenames should trigger this module. |
|
||||
| `style` | `'bold #FFAFF3'` | Stil für dieses Modul. |
|
||||
| `disabled` | `false` | Disables the `gleam` module. |
|
||||
|
||||
### Variables
|
||||
|
||||
| Variable | Beispiel | Beschreibung |
|
||||
| --------- | -------- | ------------------------------------- |
|
||||
| version | `v1.0.0` | The version of `gleam` |
|
||||
| symbol | | Spiegelt den Wert der Option `symbol` |
|
||||
| style\* | | Spiegelt den Wert der Option `style` |
|
||||
|
||||
*: This variable can only be used as a part of a style string
|
||||
|
||||
### Beispiel
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
[gleam]
|
||||
format = 'via [⭐ $version](bold red) '
|
||||
```
|
||||
|
||||
## Go
|
||||
|
||||
The `golang` module shows the currently installed version of [Go](https://golang.org/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2445,7 +2485,7 @@ Displays the current [Kubernetes context](https://kubernetes.io/docs/concepts/co
|
||||
|
||||
Dieses Modul ist standardmäßig deaktiviert. Setze in deiner Konfiguration `disabled` auf `false` um es zu aktivieren.
|
||||
|
||||
When the module is enabled it will always be active, unless any of `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions.
|
||||
When the module is enabled it will always be active, unless any of `detect_env_vars`, `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions or one of the environmatal variable has been set.
|
||||
|
||||
:::
|
||||
|
||||
@ -2467,6 +2507,7 @@ The `context_aliases` and `user_aliases` options are deprecated. Use `contexts`
|
||||
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `[]` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this modules. |
|
||||
| `detect_env_vars` | `[]` | Which environmental variables should trigger this module |
|
||||
| `contexts` | `[]` | Customized styles and symbols for specific contexts. |
|
||||
| `disabled` | `true` | Deaktiviert das `kubernetes`-Modul. |
|
||||
|
||||
@ -2769,6 +2810,35 @@ truncation_length = 4
|
||||
truncation_symbol = ''
|
||||
```
|
||||
|
||||
## NATS
|
||||
|
||||
The `nats` module shows the name of the current [NATS](https://nats.io) context.
|
||||
|
||||
### Optionen
|
||||
|
||||
| Option | Standartwert | Beschreibung |
|
||||
| ---------- | -------------------------- | ------------------------------------------------------------ |
|
||||
| `symbol` | `'✉️ '` | The symbol used before the NATS context (defaults to empty). |
|
||||
| `style` | `'bold purple'` | Stil für dieses Modul. |
|
||||
| `format` | `'[$symbol$name]($style)'` | Das Format für das Modul. |
|
||||
| `disabled` | `false` | Disables the `nats` module. |
|
||||
|
||||
### Variables
|
||||
|
||||
| Variable | Beispiel | Beschreibung |
|
||||
| --------- | ----------- | ------------------------------------- |
|
||||
| name | `localhost` | The name of the NATS context |
|
||||
| symbol | | Spiegelt den Wert der Option `symbol` |
|
||||
| style\* | | Spiegelt den Wert der Option `style` |
|
||||
|
||||
### Beispiel
|
||||
|
||||
```toml
|
||||
[nats]
|
||||
format = '[$symbol]($style)'
|
||||
style = 'bold purple'
|
||||
```
|
||||
|
||||
## Nim
|
||||
|
||||
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2944,6 +3014,43 @@ The `ocaml` module shows the currently installed version of [OCaml](https://ocam
|
||||
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.
|
||||
|
||||
### Optionen
|
||||
|
||||
| Option | Standartwert | Beschreibung |
|
||||
| ------------------- | ------------------------------------ | ----------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | Das Format für das Modul. |
|
||||
| `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'` | Stil für dieses Modul. |
|
||||
| `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 | Beispiel | Beschreibung |
|
||||
| --------- | ------------- | ------------------------------------- |
|
||||
| version | `dev-2024-03` | The version of `odin` |
|
||||
| symbol | | Spiegelt den Wert der Option `symbol` |
|
||||
| style\* | | Spiegelt den Wert der Option `style` |
|
||||
|
||||
*: This variable can only be used as a part of a style string
|
||||
|
||||
### Beispiel
|
||||
|
||||
```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. By default the module will be shown if the current directory contains a `.rego` file.
|
||||
@ -3812,7 +3919,7 @@ format = '$shlvl level(s) down'
|
||||
threshold = 3
|
||||
```
|
||||
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceeding characters are provided by `shlvl`.
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceding characters are provided by `shlvl`.
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
@ -4242,6 +4349,7 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
|
||||
| `format` | `'[$user]($style) in '` | Das Format für das Modul. |
|
||||
| `show_always` | `false` | Immer das `username` Modul anzeigen. |
|
||||
| `disabled` | `false` | Deavktiviert das `username` Modul. |
|
||||
| `aliases` | `{}` | Translate system usernames to something else |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -4263,6 +4371,7 @@ style_root = 'black bold'
|
||||
format = 'user: [$user]($style) '
|
||||
disabled = false
|
||||
show_always = true
|
||||
aliases = { "corpuser034g" = "matchai" }
|
||||
```
|
||||
|
||||
#### Hide the hostname in remote tmux sessions
|
||||
|
||||
@ -123,7 +123,7 @@ sh -c 'rm "$(command -v 'starship')"'
|
||||
|
||||
## How do I install Starship without `sudo`?
|
||||
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation directory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
|
||||
For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
|
||||
|
||||
|
||||
@ -431,6 +431,8 @@ Schaut euch bitte auch die Projekte an, die die Entstehung von Starship inspirie
|
||||
|
||||
Unterstütze dieses Projekt, indem du [ein Sponsor wirst](https://github.com/sponsors/starship). Dein Name und Logo wird hier mit einem Link zu deiner Website erscheinen.
|
||||
|
||||
- Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org)
|
||||
|
||||
<p align="center">
|
||||
<br>
|
||||
<img width="100" src="https://raw.githubusercontent.com/starship/starship/master/media/icon.png" alt="Starship Raketen-Symbol">
|
||||
|
||||
@ -45,7 +45,7 @@ Unter Funtoo Linux kann starship von [core-kit](https://github.com/funtoo/core-k
|
||||
emerge app-shells/starship
|
||||
```
|
||||
|
||||
## [Nix](https://nixos.wiki/wiki/Nix)
|
||||
## [Nix](https://wiki.nixos.org/wiki/Nix)
|
||||
|
||||
### Das Binary holen
|
||||
|
||||
|
||||
@ -25,6 +25,20 @@ metaTitle: "Starship: el prompt multi-intérprete"
|
||||
description: '¡Starship es el prompt minimalista, ultrarápido e infinitamente personalizable para cualquier intérprete de comandos! Muestra la información que necesitas, a la par que es elegante y minimalista. Instalación rápida disponible para Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, y PowerShell.'
|
||||
---
|
||||
|
||||
<script setup>
|
||||
import { onMounted } from 'vue'
|
||||
|
||||
onMounted(() => {
|
||||
const urlParams = new URLSearchParams(window.location.search)
|
||||
if (urlParams.has('uwu') || urlParams.has('kawaii')) {
|
||||
const img = document.querySelector('.VPHero .VPImage.image-src')
|
||||
img.classList.add('uwu')
|
||||
img.src = '/logo-uwu.png'
|
||||
img.alt = 'Kawaii Starship Logo by @sawaratsuki1004'
|
||||
}
|
||||
})
|
||||
</script>
|
||||
|
||||
<video class="demo-video" muted autoplay loop playsinline>
|
||||
<source src="/demo.webm" type="video/webm">
|
||||
<source src="/demo.mp4" type="video/mp4">
|
||||
|
||||
@ -84,20 +84,20 @@ enable_transience
|
||||
|
||||
The [Ble.sh](https://github.com/akinomyoga/ble.sh) framework at v0.4 or higher allows you to replace the previous-printed prompt with custom strings. Esto es útil en los casos en que la información del prompt no es siempre necesaria. To enable this, put this in `~/.bashrc` `bleopt prompt_ps1_transient=<value>`:
|
||||
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and this option has a non-empty value, the prompt specified by `PS1` is erased on leaving the current command line. If the value contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in the value and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and the option `prompt_ps1_transient` has a non-empty \<value\>, the prompt specified by `PS1` is erased on leaving the current command line. If \<value\> contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in \<value\> and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
|
||||
Make the following changes to your `~/.bashrc` to customize what gets displayed on the left and on the right:
|
||||
Make the following changes to your `~/.blerc` (or in `~/.config/blesh/init.sh`) to customize what gets displayed on the left and on the right:
|
||||
|
||||
- To customize what the left side of input gets replaced with, configure the `prompt_ps1_final` Ble.sh option. For example, to display Starship's `character` module here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_ps1_final="$(starship module character)"
|
||||
bleopt prompt_ps1_final='$(starship module character)'
|
||||
```
|
||||
|
||||
- To customize what the right side of input gets replaced with, configure the `prompt_rps1_final` Ble.sh option. Por ejemplo, para mostrar la hora en la que se inició el último comando aquí, lo harías
|
||||
|
||||
```bash
|
||||
bleopt prompt_rps1_final="$(starship module time)"
|
||||
bleopt prompt_rps1_final='$(starship module time)'
|
||||
```
|
||||
|
||||
## Comandos pre-prompt y pre-ejecución personalizados en Cmd
|
||||
@ -266,7 +266,7 @@ Nota: Los prompts de continuación solo están disponibles en los siguientes int
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
# Un prompt de continuación que muestra dos flechas rellenas
|
||||
# A continuation prompt that displays two filled-in arrows
|
||||
continuation_prompt = '▶▶ '
|
||||
```
|
||||
|
||||
@ -301,6 +301,6 @@ Si se especifican varios colores para el primer plano/fondo, el último en la ca
|
||||
|
||||
No todas las cadenas de estilo se mostrarán correctamente en cada terminal. En particular, existen las siguientes rarezas conocidas:
|
||||
|
||||
- Muchos terminales deshabilitan el soporte para `parpadear` por defecto
|
||||
- Muchos terminales deshabilitan el soporte para `parpadear` por defecto.
|
||||
- `hiden` no es [compatible con iTerm](https://gitlab.com/gnachman/iterm2/-/issues/4564).
|
||||
- `strikethrough` no está soportado por macOS Terminal.app por defecto
|
||||
- `strikethrough` no está soportado por macOS Terminal.app por defecto.
|
||||
|
||||
@ -281,6 +281,7 @@ $elixir\
|
||||
$elm\
|
||||
$erlang\
|
||||
$fennel\
|
||||
$gleam\
|
||||
$golang\
|
||||
$guix_shell\
|
||||
$haskell\
|
||||
@ -324,6 +325,7 @@ $aws\
|
||||
$gcloud\
|
||||
$openstack\
|
||||
$azure\
|
||||
$nats\
|
||||
$direnv\
|
||||
$env_var\
|
||||
$crystal\
|
||||
@ -601,7 +603,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
|
||||
| ------------------- | ------------------------------------ | --------------------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | El formato del módulo. |
|
||||
| `version_format` | `'v${raw}'` | El formato de versión. Las variables disponibles son `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'🍞 '` | A format string representing the symbol of Bun. |
|
||||
| `symbol` | `'🥟 '` | A format string representing the symbol of Bun. |
|
||||
| `detect_extensions` | `[]` | Qué extensiones deberían activar este módulo. |
|
||||
| `detect_files` | `['bun.lockb', 'bunfig.toml']` | Qué nombres de archivo deberían activar este módulo. |
|
||||
| `detect_folders` | `[]` | Qué carpetas deberían activar este módulo. |
|
||||
@ -1966,6 +1968,44 @@ Usar el ejecutable de Starship de Windows en las rutas de Windows en WSL
|
||||
windows_starship = '/mnt/c/Users/username/scoop/apps/starship/current/starship.exe'
|
||||
```
|
||||
|
||||
## Gleam
|
||||
|
||||
The `gleam` module shows the currently installed version of [Gleam](https://gleam.run/). Por defecto, el módulo se mostrará si se cumplen cualquiera de las siguientes condiciones:
|
||||
|
||||
- The current directory contains a `gleam.toml` file
|
||||
- The current directory contains a file with the `.gleam` extension
|
||||
|
||||
### Opciones
|
||||
|
||||
| Opción | Predeterminado | Descripción |
|
||||
| ------------------- | ------------------------------------ | --------------------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | El formato del módulo. |
|
||||
| `version_format` | `'v${raw}'` | El formato de versión. Las variables disponibles son `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'⭐ '` | Una cadena de formato que representa el símbolo de Go. |
|
||||
| `detect_extensions` | `['gleam']` | Qué extensiones deberían activar este módulo. |
|
||||
| `detect_files` | `['gleam.toml']` | Qué nombres de archivo deberían activar este módulo. |
|
||||
| `style` | `'bold #FFAFF3'` | El estilo del módulo. |
|
||||
| `disabled` | `false` | Disables the `gleam` module. |
|
||||
|
||||
### Variables
|
||||
|
||||
| Variable | Ejemplo | Descripción |
|
||||
| --------- | -------- | -------------------------------------- |
|
||||
| version | `v1.0.0` | The version of `gleam` |
|
||||
| symbol | | Refleja el valor de la opción `symbol` |
|
||||
| style\* | | Refleja el valor de la opción `style` |
|
||||
|
||||
*: Esta variable solamente puede ser usada como parte de una cadena de caracteres de estilo
|
||||
|
||||
### Ejemplo
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
[gleam]
|
||||
format = 'via [⭐ $version](bold red) '
|
||||
```
|
||||
|
||||
## Go
|
||||
|
||||
El módulo `golang` muestra la versión instalada de [Go](https://golang.org/). Por defecto, el módulo se mostrará si se cumplen cualquiera de las siguientes condiciones:
|
||||
@ -2444,7 +2484,7 @@ Muestra el nombre actual del [contexto de Kubernetes](https://kubernetes.io/docs
|
||||
|
||||
Este módulo está deshabilitado por defecto. Para activarlo, establece `disabled` como `false` en tu archivo de configuración.
|
||||
|
||||
When the module is enabled it will always be active, unless any of `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions.
|
||||
When the module is enabled it will always be active, unless any of `detect_env_vars`, `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions or one of the environmatal variable has been set.
|
||||
|
||||
:::
|
||||
|
||||
@ -2466,6 +2506,7 @@ The `context_aliases` and `user_aliases` options are deprecated. Use `contexts`
|
||||
| `detect_extensions` | `[]` | Qué extensiones deberían activar este módulo. |
|
||||
| `detect_files` | `[]` | Qué nombres de archivo deberían activar este módulo. |
|
||||
| `detect_folders` | `[]` | Qué carpetas deberían activar estos módulos. |
|
||||
| `detect_env_vars` | `[]` | Which environmental variables should trigger this module |
|
||||
| `contextos` | `[]` | Customized styles and symbols for specific contexts. |
|
||||
| `disabled` | `true` | Desactiva el módulo `kubernetes`. |
|
||||
|
||||
@ -2768,6 +2809,35 @@ truncation_length = 4
|
||||
truncation_symbol = ''
|
||||
```
|
||||
|
||||
## NATS
|
||||
|
||||
The `nats` module shows the name of the current [NATS](https://nats.io) context.
|
||||
|
||||
### Opciones
|
||||
|
||||
| Opción | Predeterminado | Descripción |
|
||||
| ---------- | -------------------------- | ------------------------------------------------------------ |
|
||||
| `symbol` | `'✉️ '` | The symbol used before the NATS context (defaults to empty). |
|
||||
| `style` | `'bold purple'` | El estilo del módulo. |
|
||||
| `format` | `'[$symbol$name]($style)'` | El formato del módulo. |
|
||||
| `disabled` | `false` | Disables the `nats` module. |
|
||||
|
||||
### Variables
|
||||
|
||||
| Variable | Ejemplo | Descripción |
|
||||
| --------- | ----------- | -------------------------------------- |
|
||||
| name | `localhost` | The name of the NATS context |
|
||||
| symbol | | Refleja el valor de la opción `symbol` |
|
||||
| style\* | | Refleja el valor de la opción `style` |
|
||||
|
||||
### Ejemplo
|
||||
|
||||
```toml
|
||||
[nats]
|
||||
format = '[$symbol]($style)'
|
||||
style = 'bold purple'
|
||||
```
|
||||
|
||||
## Nim
|
||||
|
||||
El módulo `nim` muestra la versión instalada de [Nim](https://nim-lang.org/). Por defecto, el módulo se mostrará si se cumplen cualquiera de las siguientes condiciones:
|
||||
@ -2943,6 +3013,43 @@ El módulo `ocaml` muestra la versión instalada de [OCaml](https://ocaml.org/).
|
||||
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.
|
||||
|
||||
### Opciones
|
||||
|
||||
| Opción | Predeterminado | Descripción |
|
||||
| ------------------- | ------------------------------------ | ---------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | El formato del módulo. |
|
||||
| `show_commit` | `false` | Shows the commit as part of the version. |
|
||||
| `symbol` | `'Ø '` | El símbolo usado antes de mostrar la versión de Zig. |
|
||||
| `style` | `'bold bright-blue'` | El estilo del módulo. |
|
||||
| `disabled` | `false` | Disables the `odin` module. |
|
||||
| `detect_extensions` | `['odin']` | Qué extensiones deberían activar este módulo. |
|
||||
| `detect_files` | `[]` | Qué nombres de archivo deberían activar este módulo. |
|
||||
| `detect_folders` | `[]` | Qué carpetas deberían activar este módulo. |
|
||||
|
||||
### Variables
|
||||
|
||||
| Variable | Ejemplo | Descripción |
|
||||
| --------- | ------------- | -------------------------------------- |
|
||||
| version | `dev-2024-03` | The version of `odin` |
|
||||
| symbol | | Refleja el valor de la opción `symbol` |
|
||||
| style\* | | Refleja el valor de la opción `style` |
|
||||
|
||||
*: Esta variable solamente puede ser usada como parte de una cadena de caracteres de estilo
|
||||
|
||||
### Ejemplo
|
||||
|
||||
```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. By default the module will be shown if the current directory contains a `.rego` file.
|
||||
@ -3811,7 +3918,7 @@ format = '$shlvl level(s) down'
|
||||
threshold = 3
|
||||
```
|
||||
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceeding characters are provided by `shlvl`.
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceding characters are provided by `shlvl`.
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
@ -4241,6 +4348,7 @@ La conexión SSH se detecta comprobando las variables de entorno `SSH_CONNECTION
|
||||
| `format` | `'[$user]($style) in '` | El formato del módulo. |
|
||||
| `show_always` | `false` | Siempre muestra el módulo `username`. |
|
||||
| `disabled` | `false` | Deshabilita el módulo `username`. |
|
||||
| `aliases` | `{}` | Translate system usernames to something else |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -4262,6 +4370,7 @@ style_root = 'black bold'
|
||||
format = 'user: [$user]($style) '
|
||||
disabled = false
|
||||
show_always = true
|
||||
aliases = { "corpuser034g" = "matchai" }
|
||||
```
|
||||
|
||||
#### Ocultar el nombre de host en sesiones remotas de tmux
|
||||
|
||||
@ -123,7 +123,7 @@ sh -c 'rm "$(comando -v 'starship')"'
|
||||
|
||||
## ¿Cómo instalo Starship sin `sudo`?
|
||||
|
||||
El script de instalación del shell (`https://starship.rs/install.sh`) solo intenta usar `sudo` si el directorio de instalación no es escribible para el usuario actual. El directorio de instalación por defecto es el valor de la variable de entorno `$BIN_DIR` o `/usr/local/bin` si `$BIN_DIR` no está establecido. Si en su lugar establece el directorio de instalación a uno que tenga permisos de escritura para su usuario, deberías ser capaz de instalar starship sin `sudo`. Por ejemplo, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` usa la opción de línea de comando `b` del script de instalación para establecer el directorio de instalación a `~/.local/bin`.
|
||||
El script de instalación del shell (`https://starship.rs/install.sh`) solo intenta usar `sudo` si el directorio de instalación no es escribible para el usuario actual. The default installation directory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. Si en su lugar establece el directorio de instalación a uno que tenga permisos de escritura para su usuario, deberías ser capaz de instalar starship sin `sudo`. Por ejemplo, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` usa la opción de línea de comando `b` del script de instalación para establecer el directorio de instalación a `~/.local/bin`.
|
||||
|
||||
Para una instalación no interactiva de Starship, no te olvides de añadir la opción `y` para omitir la confirmación. Consulte la fuente del script de instalación para ver una lista de todas las opciones de instalación soportadas.
|
||||
|
||||
|
||||
@ -431,6 +431,8 @@ Por favor, revisa estas obras anteriores que ayudaron a inspirar la creación de
|
||||
|
||||
Apoya este proyecto [convirtiéndote en patrocinador](https://github.com/sponsors/starship). Tu nombre o logo aparecerá aquí con un enlace a tu sitio web.
|
||||
|
||||
- Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org)
|
||||
|
||||
<p align="center">
|
||||
<br>
|
||||
<img width="100" src="https://raw.githubusercontent.com/starship/starship/master/media/icon.png" alt="Starship rocket icon">
|
||||
|
||||
@ -45,7 +45,7 @@ En Funtoo Linux, Starship puede instalarse desde [core-kit](https://github.com/f
|
||||
emerge app-shells/starship
|
||||
```
|
||||
|
||||
## [Nix](https://nixos.wiki/wiki/Nix)
|
||||
## [Nix](https://wiki.nixos.org/wiki/Nix)
|
||||
|
||||
### Obtener el binario
|
||||
|
||||
|
||||
@ -25,6 +25,20 @@ metaTitle: "Starship : Invite Multi-Shell"
|
||||
description: Starship est une invite minimaliste, ultra-rapide et hautement personnalisable pour n'importe quel shell ! Montre les informations dont vous avez besoin tout en restant élégante et minimaliste. Installation rapide disponible pour Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, et PowerShell.
|
||||
---
|
||||
|
||||
<script setup>
|
||||
import { onMounted } from 'vue'
|
||||
|
||||
onMounted(() => {
|
||||
const urlParams = new URLSearchParams(window.location.search)
|
||||
if (urlParams.has('uwu') || urlParams.has('kawaii')) {
|
||||
const img = document.querySelector('.VPHero .VPImage.image-src')
|
||||
img.classList.add('uwu')
|
||||
img.src = '/logo-uwu.png'
|
||||
img.alt = 'Kawaii Starship Logo by @sawaratsuki1004'
|
||||
}
|
||||
})
|
||||
</script>
|
||||
|
||||
<video class="demo-video" muted autoplay loop playsinline>
|
||||
<source src="/demo.webm" type="video/webm">
|
||||
<source src="/demo.mp4" type="video/mp4">
|
||||
|
||||
@ -84,20 +84,20 @@ enable_transience
|
||||
|
||||
The [Ble.sh](https://github.com/akinomyoga/ble.sh) framework at v0.4 or higher allows you to replace the previous-printed prompt with custom strings. This is useful in cases where all the prompt information is not always needed. To enable this, put this in `~/.bashrc` `bleopt prompt_ps1_transient=<value>`:
|
||||
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and this option has a non-empty value, the prompt specified by `PS1` is erased on leaving the current command line. If the value contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in the value and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and the option `prompt_ps1_transient` has a non-empty \<value\>, the prompt specified by `PS1` is erased on leaving the current command line. If \<value\> contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in \<value\> and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
|
||||
Make the following changes to your `~/.bashrc` to customize what gets displayed on the left and on the right:
|
||||
Make the following changes to your `~/.blerc` (or in `~/.config/blesh/init.sh`) to customize what gets displayed on the left and on the right:
|
||||
|
||||
- To customize what the left side of input gets replaced with, configure the `prompt_ps1_final` Ble.sh option. For example, to display Starship's `character` module here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_ps1_final="$(starship module character)"
|
||||
bleopt prompt_ps1_final='$(starship module character)'
|
||||
```
|
||||
|
||||
- To customize what the right side of input gets replaced with, configure the `prompt_rps1_final` Ble.sh option. Par exemple, pour afficher l'heure à laquelle la dernière commande a été lancée ici, vous feriez
|
||||
|
||||
```bash
|
||||
bleopt prompt_rps1_final="$(starship module time)"
|
||||
bleopt prompt_rps1_final='$(starship module time)'
|
||||
```
|
||||
|
||||
## Commandes pré-invite et pré-exécution personnalisées dans Cmd
|
||||
@ -266,7 +266,7 @@ Note: les invites de confirmation sont uniquement disponibles pour les shells su
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
# Un invite de continuation qui affiche deux flèches pleines
|
||||
# A continuation prompt that displays two filled-in arrows
|
||||
continuation_prompt = '▶▶ '
|
||||
```
|
||||
|
||||
@ -301,6 +301,6 @@ Si plusieurs couleurs sont définies pour l’avant-plan/arrière-plan, la derni
|
||||
|
||||
Not every style string will be displayed correctly by every terminal. In particular, the following known quirks exist:
|
||||
|
||||
- Many terminals disable support for `blink` by default
|
||||
- Many terminals disable support for `blink` by default.
|
||||
- `hidden` is [not supported on iTerm](https://gitlab.com/gnachman/iterm2/-/issues/4564).
|
||||
- `strikethrough` is not supported by the default macOS Terminal.app
|
||||
- `strikethrough` is not supported by the default macOS Terminal.app.
|
||||
|
||||
@ -281,6 +281,7 @@ $elixir\
|
||||
$elm\
|
||||
$erlang\
|
||||
$fennel\
|
||||
$gleam\
|
||||
$golang\
|
||||
$guix_shell\
|
||||
$haskell\
|
||||
@ -324,6 +325,7 @@ $aws\
|
||||
$gcloud\
|
||||
$openstack\
|
||||
$azure\
|
||||
$nats\
|
||||
$direnv\
|
||||
$env_var\
|
||||
$crystal\
|
||||
@ -601,7 +603,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
|
||||
| ------------------------------------ | ------------------------------------ | ------------------------------------------------------------------------------------------ |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | Format du module. |
|
||||
| `version_format` | `'v${raw}'` | Le format de la version. Les variables disponibles sont `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbole` | `'🍞 '` | A format string representing the symbol of Bun. |
|
||||
| `symbole` | `'🥟 '` | A format string representing the symbol of Bun. |
|
||||
| `detect_extensionsdetect_extensions` | `[]` | Les extensions qui déclenchent ce module. |
|
||||
| `detect_files` | `['bun.lockb', 'bunfig.toml']` | Les fichiers qui activent ce module. |
|
||||
| `detect_folders` | `[]` | Les dossiers qui activent ce module. |
|
||||
@ -1966,6 +1968,44 @@ Utiliser un exécutable Starship Windows pour les chemins Windows dans WSL
|
||||
windows_starship = '/mnt/c/Users/username/scoop/apps/starship/current/starship.exe'
|
||||
```
|
||||
|
||||
## Gleam
|
||||
|
||||
The `gleam` module shows the currently installed version of [Gleam](https://gleam.run/). Par défaut, le module sera affiché si l’une de ces conditions est remplie:
|
||||
|
||||
- The current directory contains a `gleam.toml` file
|
||||
- The current directory contains a file with the `.gleam` extension
|
||||
|
||||
### Options
|
||||
|
||||
| Option | Défaut | Description |
|
||||
| ------------------------------------ | ------------------------------------ | ------------------------------------------------------------------------------------------ |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | Format du module. |
|
||||
| `version_format` | `'v${raw}'` | Le format de la version. Les variables disponibles sont `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbole` | `'⭐ '` | Une chaîne de caractères représentant le symbole de Go. |
|
||||
| `detect_extensionsdetect_extensions` | `['gleam']` | Les extensions qui déclenchent ce module. |
|
||||
| `detect_files` | `['gleam.toml']` | Les fichiers qui activent ce module. |
|
||||
| `style` | `'bold #FFAFF3'` | Le style pour le module. |
|
||||
| `disabled` | `false` | Disables the `gleam` module. |
|
||||
|
||||
### Variables
|
||||
|
||||
| Variable | Exemple | Description |
|
||||
| --------- | -------- | -------------------------------------- |
|
||||
| version | `v1.0.0` | The version of `gleam` |
|
||||
| symbole | | Reflète la valeur de l'option `symbol` |
|
||||
| style\* | | Reflète la valeur de l'option `style` |
|
||||
|
||||
*: Cette variable peut uniquement être utilisée dans une chaine de style
|
||||
|
||||
### Exemple
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
[gleam]
|
||||
format = 'via [⭐ $version](bold red) '
|
||||
```
|
||||
|
||||
## Go
|
||||
|
||||
Le module `golang` affiche la version de [Go](https://golang.org/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
|
||||
@ -2444,7 +2484,7 @@ Afficher le nom du [contexte Kubernetes](https://kubernetes.io/docs/concepts/con
|
||||
|
||||
Ce module est désactivé par défaut. Pour l'activer, configurez `disabled` sur `false` dans votre fichier de configuration.
|
||||
|
||||
When the module is enabled it will always be active, unless any of `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions.
|
||||
When the module is enabled it will always be active, unless any of `detect_env_vars`, `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions or one of the environmatal variable has been set.
|
||||
|
||||
:::
|
||||
|
||||
@ -2466,6 +2506,7 @@ The `context_aliases` and `user_aliases` options are deprecated. Use `contexts`
|
||||
| `detect_extensionsdetect_extensions` | `[]` | Les extensions qui déclenchent ce module. |
|
||||
| `detect_files` | `[]` | Les fichiers qui activent ce module. |
|
||||
| `detect_folders` | `[]` | Quels dossiers devraient activer ce module. |
|
||||
| `detect_env_vars` | `[]` | Which environmental variables should trigger this module |
|
||||
| `contexts` | `[]` | Customized styles and symbols for specific contexts. |
|
||||
| `disabled` | `true` | Désactiver le module `kubernetes`. |
|
||||
|
||||
@ -2768,6 +2809,35 @@ truncation_length = 4
|
||||
truncation_symbol = ''
|
||||
```
|
||||
|
||||
## NATS
|
||||
|
||||
The `nats` module shows the name of the current [NATS](https://nats.io) context.
|
||||
|
||||
### Options
|
||||
|
||||
| Option | Défaut | Description |
|
||||
| ---------- | -------------------------- | ------------------------------------------------------------ |
|
||||
| `symbole` | `'✉️ '` | The symbol used before the NATS context (defaults to empty). |
|
||||
| `style` | `'bold purple'` | Le style pour le module. |
|
||||
| `format` | `'[$symbol$name]($style)'` | Format du module. |
|
||||
| `disabled` | `false` | Disables the `nats` module. |
|
||||
|
||||
### Variables
|
||||
|
||||
| Variable | Exemple | Description |
|
||||
| --------- | ----------- | -------------------------------------- |
|
||||
| name | `localhost` | The name of the NATS context |
|
||||
| symbole | | Reflète la valeur de l'option `symbol` |
|
||||
| style\* | | Reflète la valeur de l'option `style` |
|
||||
|
||||
### Exemple
|
||||
|
||||
```toml
|
||||
[nats]
|
||||
format = '[$symbol]($style)'
|
||||
style = 'bold purple'
|
||||
```
|
||||
|
||||
## Nim
|
||||
|
||||
Le module `nim` affiche la version de [Nim](https://nim-lang.org/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
|
||||
@ -2943,6 +3013,43 @@ Le module `ocaml` affiche la version de [OCaml](https://ocaml.org/) installée.
|
||||
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 | Défaut | Description |
|
||||
| ------------------------------------ | ------------------------------------ | ------------------------------------------------------ |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | Format du module. |
|
||||
| `show_commit` | `false` | Shows the commit as part of the version. |
|
||||
| `symbole` | `'Ø '` | Le symbole utilisé avant d'afficher la version de Zig. |
|
||||
| `style` | `'bold bright-blue'` | Le style pour le module. |
|
||||
| `disabled` | `false` | Disables the `odin` module. |
|
||||
| `detect_extensionsdetect_extensions` | `['odin']` | Les extensions qui déclenchent ce module. |
|
||||
| `detect_files` | `[]` | Les fichiers qui activent ce module. |
|
||||
| `detect_folders` | `[]` | Les dossiers qui activent ce module. |
|
||||
|
||||
### Variables
|
||||
|
||||
| Variable | Exemple | Description |
|
||||
| --------- | ------------- | -------------------------------------- |
|
||||
| version | `dev-2024-03` | The version of `odin` |
|
||||
| symbole | | Reflète la valeur de l'option `symbol` |
|
||||
| style\* | | Reflète la valeur de l'option `style` |
|
||||
|
||||
*: Cette variable peut uniquement être utilisée dans une chaine de style
|
||||
|
||||
### Exemple
|
||||
|
||||
```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. By default the module will be shown if the current directory contains a `.rego` file.
|
||||
@ -3811,7 +3918,7 @@ format = '$shlvl level(s) down'
|
||||
threshold = 3
|
||||
```
|
||||
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceeding characters are provided by `shlvl`.
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceding characters are provided by `shlvl`.
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
@ -4241,6 +4348,7 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
|
||||
| `format` | `'[$user]($style) in '` | Format du module. |
|
||||
| `show_always` | `false` | Toujours afficher le module `username`. |
|
||||
| `disabled` | `false` | Désactive le module `username`. |
|
||||
| `aliases` | `{}` | Translate system usernames to something else |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -4262,6 +4370,7 @@ style_root = 'black bold'
|
||||
format = 'user: [$user]($style) '
|
||||
disabled = false
|
||||
show_always = true
|
||||
aliases = { "corpuser034g" = "matchai" }
|
||||
```
|
||||
|
||||
#### Hide the hostname in remote tmux sessions
|
||||
|
||||
@ -123,7 +123,7 @@ sh -c 'rm "$(command -v 'starship')"'
|
||||
|
||||
## How do I install Starship without `sudo`?
|
||||
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation directory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
|
||||
For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
|
||||
|
||||
|
||||
@ -431,6 +431,8 @@ Voyez ces travaux précédents qui ont contribué à inspirer la création de St
|
||||
|
||||
Soutenez ce projet en [devenant un collaborateur](https://github.com/sponsors/starship). Votre nom ou logo apparaîtra ici avec un lien vers votre site Web.
|
||||
|
||||
- Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org)
|
||||
|
||||
<p align="center">
|
||||
<br>
|
||||
<img width="100" src="https://raw.githubusercontent.com/starship/starship/master/media/icon.png" alt="Icône de roquette de Starship">
|
||||
|
||||
@ -45,7 +45,7 @@ Sur Funtoo Linux, starship peut être installé à partir de [core-kit](https://
|
||||
emerge app-shells/starship
|
||||
```
|
||||
|
||||
## [Nix](https://nixos.wiki/wiki/Nix)
|
||||
## [Nix](https://wiki.nixos.org/wiki/Nix)
|
||||
|
||||
### Obtention du binaire
|
||||
|
||||
|
||||
@ -25,6 +25,20 @@ metaTitle: "Starship: Prompt Lintas Shell"
|
||||
description: Starship merupakan sebuah prompt yang minimal, super cepat, dan sangat bisa untuk dikustomisasi untuk shell apapun! Bisa menampilkan informasi yang kamu butuhkan, namun tetap bisa tampil dengan ramping dan minimal. Instalasi sederhana tersedia untuk Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, dan PowerShell.
|
||||
---
|
||||
|
||||
<script setup>
|
||||
import { onMounted } from 'vue'
|
||||
|
||||
onMounted(() => {
|
||||
const urlParams = new URLSearchParams(window.location.search)
|
||||
if (urlParams.has('uwu') || urlParams.has('kawaii')) {
|
||||
const img = document.querySelector('.VPHero .VPImage.image-src')
|
||||
img.classList.add('uwu')
|
||||
img.src = '/logo-uwu.png'
|
||||
img.alt = 'Kawaii Starship Logo by @sawaratsuki1004'
|
||||
}
|
||||
})
|
||||
</script>
|
||||
|
||||
<video class="demo-video" muted autoplay loop playsinline>
|
||||
<source src="/demo.webm" type="video/webm">
|
||||
<source src="/demo.mp4" type="video/mp4">
|
||||
|
||||
@ -84,20 +84,20 @@ enable_transience
|
||||
|
||||
The [Ble.sh](https://github.com/akinomyoga/ble.sh) framework at v0.4 or higher allows you to replace the previous-printed prompt with custom strings. This is useful in cases where all the prompt information is not always needed. To enable this, put this in `~/.bashrc` `bleopt prompt_ps1_transient=<value>`:
|
||||
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and this option has a non-empty value, the prompt specified by `PS1` is erased on leaving the current command line. If the value contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in the value and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and the option `prompt_ps1_transient` has a non-empty \<value\>, the prompt specified by `PS1` is erased on leaving the current command line. If \<value\> contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in \<value\> and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
|
||||
Make the following changes to your `~/.bashrc` to customize what gets displayed on the left and on the right:
|
||||
Make the following changes to your `~/.blerc` (or in `~/.config/blesh/init.sh`) to customize what gets displayed on the left and on the right:
|
||||
|
||||
- To customize what the left side of input gets replaced with, configure the `prompt_ps1_final` Ble.sh option. For example, to display Starship's `character` module here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_ps1_final="$(starship module character)"
|
||||
bleopt prompt_ps1_final='$(starship module character)'
|
||||
```
|
||||
|
||||
- To customize what the right side of input gets replaced with, configure the `prompt_rps1_final` Ble.sh option. For example, to display the time at which the last command was started here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_rps1_final="$(starship module time)"
|
||||
bleopt prompt_rps1_final='$(starship module time)'
|
||||
```
|
||||
|
||||
## Kustomisasi Perintah pre-prompt dan pre-execution Pada Cmd
|
||||
@ -266,7 +266,7 @@ Catatan: Continuation prompts hanya tersedia pada beberapa shells berikut:
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
# Continuation prompt yang menampilkan dua panah solid
|
||||
# A continuation prompt that displays two filled-in arrows
|
||||
continuation_prompt = '▶▶ '
|
||||
```
|
||||
|
||||
@ -301,6 +301,6 @@ Jika warna yang dipakai pada latar depan/latar belakang banyak, maka warna yang
|
||||
|
||||
Not every style string will be displayed correctly by every terminal. In particular, the following known quirks exist:
|
||||
|
||||
- Many terminals disable support for `blink` by default
|
||||
- Many terminals disable support for `blink` by default.
|
||||
- `hidden` is [not supported on iTerm](https://gitlab.com/gnachman/iterm2/-/issues/4564).
|
||||
- `strikethrough` is not supported by the default macOS Terminal.app
|
||||
- `strikethrough` is not supported by the default macOS Terminal.app.
|
||||
|
||||
@ -281,6 +281,7 @@ $elixir\
|
||||
$elm\
|
||||
$erlang\
|
||||
$fennel\
|
||||
$gleam\
|
||||
$golang\
|
||||
$guix_shell\
|
||||
$haskell\
|
||||
@ -324,6 +325,7 @@ $aws\
|
||||
$gcloud\
|
||||
$openstack\
|
||||
$azure\
|
||||
$nats\
|
||||
$direnv\
|
||||
$env_var\
|
||||
$crystal\
|
||||
@ -601,7 +603,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
|
||||
| ------------------- | ------------------------------------ | ----------------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | Format dari modul. |
|
||||
| `version_format` | `'v${raw}'` | Format dari versi. Variabel yang tersedia adalah `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'🍞 '` | A format string representing the symbol of Bun. |
|
||||
| `symbol` | `'🥟 '` | A format string representing the symbol of Bun. |
|
||||
| `detect_extensions` | `[]` | Ekstensi mana yang sebaiknya memicu modul ini. |
|
||||
| `detect_files` | `['bun.lockb', 'bunfig.toml']` | filenames mana yang sebaiknya memicu modul ini. |
|
||||
| `detect_folders` | `[]` | Folder mana yang sebaiknya memicul modul ini. |
|
||||
@ -1966,6 +1968,44 @@ Use Windows Starship executable on Windows paths in WSL
|
||||
windows_starship = '/mnt/c/Users/username/scoop/apps/starship/current/starship.exe'
|
||||
```
|
||||
|
||||
## Gleam
|
||||
|
||||
The `gleam` module shows the currently installed version of [Gleam](https://gleam.run/). Secara bawaan, modul akan aktif jika beberapa syarat berikut telah terpenuhi:
|
||||
|
||||
- The current directory contains a `gleam.toml` file
|
||||
- The current directory contains a file with the `.gleam` extension
|
||||
|
||||
### Opsi
|
||||
|
||||
| Opsi | Bawaan | Deskripsi |
|
||||
| ------------------- | ------------------------------------ | ----------------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | Format dari modul. |
|
||||
| `version_format` | `'v${raw}'` | Format dari versi. Variabel yang tersedia adalah `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'⭐ '` | A format string representing the symbol of Go. |
|
||||
| `detect_extensions` | `['gleam']` | Ekstensi mana yang sebaiknya memicu modul ini. |
|
||||
| `detect_files` | `['gleam.toml']` | filenames mana yang sebaiknya memicu modul ini. |
|
||||
| `style` | `'bold #FFAFF3'` | Gaya penataan untuk modul. |
|
||||
| `disabled` | `false` | Disables the `gleam` module. |
|
||||
|
||||
### Variabel
|
||||
|
||||
| Variabel | Contoh | Deskripsi |
|
||||
| --------- | -------- | --------------------------------- |
|
||||
| version | `v1.0.0` | The version of `gleam` |
|
||||
| symbol | | Menyalin nilai dari opsi `symbol` |
|
||||
| style\* | | Menyalin nilai dari opsi `style` |
|
||||
|
||||
*: Variabel tersebut hanya dapat digunakan sebagai bagian dari penataan string
|
||||
|
||||
### Contoh
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
[gleam]
|
||||
format = 'via [⭐ $version](bold red) '
|
||||
```
|
||||
|
||||
## Go
|
||||
|
||||
The `golang` module shows the currently installed version of [Go](https://golang.org/). Secara bawaan, modul akan aktif jika beberapa syarat berikut telah terpenuhi:
|
||||
@ -1984,7 +2024,7 @@ The `golang` module shows the currently installed version of [Go](https://golang
|
||||
|
||||
| Opsi | Bawaan | Deskripsi |
|
||||
| ------------------- | ----------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | Format dari modul. |
|
||||
| `fromat` | `'via [$symbol($version )]($style)'` | Format dari modul. |
|
||||
| `version_format` | `'v${raw}'` | Format dari versi. Variabel yang tersedia adalah `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'🐹 '` | A format string representing the symbol of Go. |
|
||||
| `detect_extensions` | `['go']` | Ekstensi mana yang sebaiknya memicu modul ini. |
|
||||
@ -2444,7 +2484,7 @@ Displays the current [Kubernetes context](https://kubernetes.io/docs/concepts/co
|
||||
|
||||
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
|
||||
|
||||
When the module is enabled it will always be active, unless any of `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions.
|
||||
When the module is enabled it will always be active, unless any of `detect_env_vars`, `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions or one of the environmatal variable has been set.
|
||||
|
||||
:::
|
||||
|
||||
@ -2466,6 +2506,7 @@ The `context_aliases` and `user_aliases` options are deprecated. Use `contexts`
|
||||
| `detect_extensions` | `[]` | Ekstensi mana yang sebaiknya memicu modul ini. |
|
||||
| `detect_files` | `[]` | filenames mana yang sebaiknya memicu modul ini. |
|
||||
| `detect_folders` | `[]` | Folder mana yang sebaiknya memicul modul ini. |
|
||||
| `detect_env_vars` | `[]` | Which environmental variables should trigger this module |
|
||||
| `contexts` | `[]` | Customized styles and symbols for specific contexts. |
|
||||
| `disabled` | `true` | Disables the `kubernetes` module. |
|
||||
|
||||
@ -2768,6 +2809,35 @@ truncation_length = 4
|
||||
truncation_symbol = ''
|
||||
```
|
||||
|
||||
## NATS
|
||||
|
||||
The `nats` module shows the name of the current [NATS](https://nats.io) context.
|
||||
|
||||
### Opsi
|
||||
|
||||
| Opsi | Bawaan | Deskripsi |
|
||||
| ---------- | -------------------------- | ------------------------------------------------------------ |
|
||||
| `symbol` | `'✉️ '` | The symbol used before the NATS context (defaults to empty). |
|
||||
| `style` | `'bold purple'` | Gaya penataan untuk modul. |
|
||||
| `fromat` | `'[$symbol$name]($style)'` | Format dari modul. |
|
||||
| `disabled` | `false` | Disables the `nats` module. |
|
||||
|
||||
### Variabel
|
||||
|
||||
| Variabel | Contoh | Deskripsi |
|
||||
| --------- | ----------- | --------------------------------- |
|
||||
| name | `localhost` | The name of the NATS context |
|
||||
| symbol | | Menyalin nilai dari opsi `symbol` |
|
||||
| style\* | | Menyalin nilai dari opsi `style` |
|
||||
|
||||
### Contoh
|
||||
|
||||
```toml
|
||||
[nats]
|
||||
format = '[$symbol]($style)'
|
||||
style = 'bold purple'
|
||||
```
|
||||
|
||||
## Nim
|
||||
|
||||
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). Secara bawaan, modul akan aktif jika beberapa syarat berikut telah terpenuhi:
|
||||
@ -2943,6 +3013,43 @@ The `ocaml` module shows the currently installed version of [OCaml](https://ocam
|
||||
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.
|
||||
|
||||
### Opsi
|
||||
|
||||
| Opsi | Bawaan | Deskripsi |
|
||||
| ------------------- | ------------------------------------ | ----------------------------------------------------- |
|
||||
| `fromat` | `'via [$symbol($version )]($style)'` | Format dari modul. |
|
||||
| `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'` | Gaya penataan untuk modul. |
|
||||
| `disabled` | `false` | Disables the `odin` module. |
|
||||
| `detect_extensions` | `['odin']` | Ekstensi mana yang sebaiknya memicu modul ini. |
|
||||
| `detect_files` | `[]` | filenames mana yang sebaiknya memicu modul ini. |
|
||||
| `detect_folders` | `[]` | Folder mana yang sebaiknya memicul modul ini. |
|
||||
|
||||
### Variabel
|
||||
|
||||
| Variabel | Contoh | Deskripsi |
|
||||
| --------- | ------------- | --------------------------------- |
|
||||
| version | `dev-2024-03` | The version of `odin` |
|
||||
| symbol | | Menyalin nilai dari opsi `symbol` |
|
||||
| style\* | | Menyalin nilai dari opsi `style` |
|
||||
|
||||
*: Variabel tersebut hanya dapat digunakan sebagai bagian dari penataan string
|
||||
|
||||
### Contoh
|
||||
|
||||
```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. By default the module will be shown if the current directory contains a `.rego` file.
|
||||
@ -3811,7 +3918,7 @@ format = '$shlvl level(s) down'
|
||||
threshold = 3
|
||||
```
|
||||
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceeding characters are provided by `shlvl`.
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceding characters are provided by `shlvl`.
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
@ -4241,6 +4348,7 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
|
||||
| `fromat` | `'[$user]($style) in '` | Format dari modul. |
|
||||
| `show_always` | `false` | Always shows the `username` module. |
|
||||
| `disabled` | `false` | Disables the `username` module. |
|
||||
| `aliases` | `{}` | Translate system usernames to something else |
|
||||
|
||||
### Variabel
|
||||
|
||||
@ -4262,6 +4370,7 @@ style_root = 'black bold'
|
||||
format = 'user: [$user]($style) '
|
||||
disabled = false
|
||||
show_always = true
|
||||
aliases = { "corpuser034g" = "matchai" }
|
||||
```
|
||||
|
||||
#### Hide the hostname in remote tmux sessions
|
||||
|
||||
@ -123,7 +123,7 @@ sh -c 'rm "$(command -v 'starship')"'
|
||||
|
||||
## How do I install Starship without `sudo`?
|
||||
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation directory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
|
||||
For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
|
||||
|
||||
|
||||
@ -431,6 +431,8 @@ Please check out these previous works that helped inspire the creation of starsh
|
||||
|
||||
Support this project by [becoming a sponsor](https://github.com/sponsors/starship). Your name or logo will show up here with a link to your website.
|
||||
|
||||
- Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org)
|
||||
|
||||
<p align="center">
|
||||
<br>
|
||||
<img width="100" src="https://raw.githubusercontent.com/starship/starship/master/media/icon.png" alt="Ikon roket Starship">
|
||||
|
||||
@ -45,7 +45,7 @@ On Funtoo Linux, starship can be installed from [core-kit](https://github.com/fu
|
||||
emerge app-shells/starship
|
||||
```
|
||||
|
||||
## [Nix](https://nixos.wiki/wiki/Nix)
|
||||
## [Nix](https://wiki.nixos.org/wiki/Nix)
|
||||
|
||||
### Getting the Binary
|
||||
|
||||
|
||||
@ -25,6 +25,20 @@ metaTitle: "Starship: Cross-Shell Prompt"
|
||||
description: Starship è il prompt minimalista, super veloce ed estremamente personalizzabile per qualsiasi shell! Mostra le informazioni di cui hai bisogno, rimanendo elegante e minimale. Quick installation available for Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, and PowerShell.
|
||||
---
|
||||
|
||||
<script setup>
|
||||
import { onMounted } from 'vue'
|
||||
|
||||
onMounted(() => {
|
||||
const urlParams = new URLSearchParams(window.location.search)
|
||||
if (urlParams.has('uwu') || urlParams.has('kawaii')) {
|
||||
const img = document.querySelector('.VPHero .VPImage.image-src')
|
||||
img.classList.add('uwu')
|
||||
img.src = '/logo-uwu.png'
|
||||
img.alt = 'Kawaii Starship Logo by @sawaratsuki1004'
|
||||
}
|
||||
})
|
||||
</script>
|
||||
|
||||
<video class="demo-video" muted autoplay loop playsinline>
|
||||
<source src="/demo.webm" type="video/webm">
|
||||
<source src="/demo.mp4" type="video/mp4">
|
||||
|
||||
@ -84,20 +84,20 @@ enable_transience
|
||||
|
||||
The [Ble.sh](https://github.com/akinomyoga/ble.sh) framework at v0.4 or higher allows you to replace the previous-printed prompt with custom strings. This is useful in cases where all the prompt information is not always needed. To enable this, put this in `~/.bashrc` `bleopt prompt_ps1_transient=<value>`:
|
||||
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and this option has a non-empty value, the prompt specified by `PS1` is erased on leaving the current command line. If the value contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in the value and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and the option `prompt_ps1_transient` has a non-empty \<value\>, the prompt specified by `PS1` is erased on leaving the current command line. If \<value\> contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in \<value\> and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
|
||||
Make the following changes to your `~/.bashrc` to customize what gets displayed on the left and on the right:
|
||||
Make the following changes to your `~/.blerc` (or in `~/.config/blesh/init.sh`) to customize what gets displayed on the left and on the right:
|
||||
|
||||
- To customize what the left side of input gets replaced with, configure the `prompt_ps1_final` Ble.sh option. For example, to display Starship's `character` module here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_ps1_final="$(starship module character)"
|
||||
bleopt prompt_ps1_final='$(starship module character)'
|
||||
```
|
||||
|
||||
- To customize what the right side of input gets replaced with, configure the `prompt_rps1_final` Ble.sh option. For example, to display the time at which the last command was started here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_rps1_final="$(starship module time)"
|
||||
bleopt prompt_rps1_final='$(starship module time)'
|
||||
```
|
||||
|
||||
## Custom pre-prompt and pre-execution Commands in Cmd
|
||||
@ -266,7 +266,7 @@ Note: Continuation prompts are only available in the following shells:
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
# A continuation prompt that displays two filled in arrows
|
||||
# A continuation prompt that displays two filled-in arrows
|
||||
continuation_prompt = '▶▶ '
|
||||
```
|
||||
|
||||
@ -301,6 +301,6 @@ Se sono specificati più colori per il primo piano/sfondo, l'ultimo nella string
|
||||
|
||||
Not every style string will be displayed correctly by every terminal. In particular, the following known quirks exist:
|
||||
|
||||
- Many terminals disable support for `blink` by default
|
||||
- Many terminals disable support for `blink` by default.
|
||||
- `hidden` is [not supported on iTerm](https://gitlab.com/gnachman/iterm2/-/issues/4564).
|
||||
- `strikethrough` is not supported by the default macOS Terminal.app
|
||||
- `strikethrough` is not supported by the default macOS Terminal.app.
|
||||
|
||||
@ -281,6 +281,7 @@ $elixir\
|
||||
$elm\
|
||||
$erlang\
|
||||
$fennel\
|
||||
$gleam\
|
||||
$golang\
|
||||
$guix_shell\
|
||||
$haskell\
|
||||
@ -324,6 +325,7 @@ $aws\
|
||||
$gcloud\
|
||||
$openstack\
|
||||
$azure\
|
||||
$nats\
|
||||
$direnv\
|
||||
$env_var\
|
||||
$crystal\
|
||||
@ -601,7 +603,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
|
||||
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | The format for the module. |
|
||||
| `version_format` | `'v${raw}'` | Il formato della versione. Le variabili disponibili sono `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'🍞 '` | A format string representing the symbol of Bun. |
|
||||
| `symbol` | `'🥟 '` | A format string representing the symbol of Bun. |
|
||||
| `detect_extensions` | `[]` | Quali estensioni dovrebbero attivare questo modulo. |
|
||||
| `detect_files` | `['bun.lockb', 'bunfig.toml']` | Quali nomi di file dovrebbero attivare questo modulo. |
|
||||
| `detect_folders` | `[]` | Quali cartelle dovrebbero attivare questo modulo. |
|
||||
@ -1966,6 +1968,44 @@ Use Windows Starship executable on Windows paths in WSL
|
||||
windows_starship = '/mnt/c/Users/username/scoop/apps/starship/current/starship.exe'
|
||||
```
|
||||
|
||||
## Gleam
|
||||
|
||||
The `gleam` module shows the currently installed version of [Gleam](https://gleam.run/). By default the module will be shown if any of the following conditions are met:
|
||||
|
||||
- The current directory contains a `gleam.toml` file
|
||||
- The current directory contains a file with the `.gleam` extension
|
||||
|
||||
### Opzioni
|
||||
|
||||
| Opzione | Default | Descrizione |
|
||||
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | The format for the module. |
|
||||
| `version_format` | `'v${raw}'` | Il formato della versione. Le variabili disponibili sono `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'⭐ '` | A format string representing the symbol of Go. |
|
||||
| `detect_extensions` | `['gleam']` | Quali estensioni dovrebbero attivare questo modulo. |
|
||||
| `detect_files` | `['gleam.toml']` | Quali nomi di file dovrebbero attivare questo modulo. |
|
||||
| `style` | `'bold #FFAFF3'` | Lo stile per il modulo. |
|
||||
| `disabled` | `false` | Disables the `gleam` module. |
|
||||
|
||||
### Variables
|
||||
|
||||
| Variable | Esempio | Descrizione |
|
||||
| --------- | -------- | ------------------------------------ |
|
||||
| version | `v1.0.0` | The version of `gleam` |
|
||||
| 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
|
||||
|
||||
### Esempio
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
[gleam]
|
||||
format = 'via [⭐ $version](bold red) '
|
||||
```
|
||||
|
||||
## Go
|
||||
|
||||
The `golang` module shows the currently installed version of [Go](https://golang.org/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2444,7 +2484,7 @@ Displays the current [Kubernetes context](https://kubernetes.io/docs/concepts/co
|
||||
|
||||
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
|
||||
|
||||
When the module is enabled it will always be active, unless any of `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions.
|
||||
When the module is enabled it will always be active, unless any of `detect_env_vars`, `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions or one of the environmatal variable has been set.
|
||||
|
||||
:::
|
||||
|
||||
@ -2466,6 +2506,7 @@ The `context_aliases` and `user_aliases` options are deprecated. Use `contexts`
|
||||
| `detect_extensions` | `[]` | Quali estensioni dovrebbero attivare questo modulo. |
|
||||
| `detect_files` | `[]` | Quali nomi di file dovrebbero attivare questo modulo. |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this modules. |
|
||||
| `detect_env_vars` | `[]` | Which environmental variables should trigger this module |
|
||||
| `contexts` | `[]` | Customized styles and symbols for specific contexts. |
|
||||
| `disabled` | `true` | Disables the `kubernetes` module. |
|
||||
|
||||
@ -2768,6 +2809,35 @@ truncation_length = 4
|
||||
truncation_symbol = ''
|
||||
```
|
||||
|
||||
## NATS
|
||||
|
||||
The `nats` module shows the name of the current [NATS](https://nats.io) context.
|
||||
|
||||
### Opzioni
|
||||
|
||||
| Opzione | Default | Descrizione |
|
||||
| ---------- | -------------------------- | ------------------------------------------------------------ |
|
||||
| `symbol` | `'✉️ '` | The symbol used before the NATS context (defaults to empty). |
|
||||
| `style` | `'bold purple'` | Lo stile per il modulo. |
|
||||
| `format` | `'[$symbol$name]($style)'` | The format for the module. |
|
||||
| `disabled` | `false` | Disables the `nats` module. |
|
||||
|
||||
### Variables
|
||||
|
||||
| Variable | Esempio | Descrizione |
|
||||
| --------- | ----------- | ------------------------------------ |
|
||||
| name | `localhost` | The name of the NATS context |
|
||||
| symbol | | Mirrors the value of option `symbol` |
|
||||
| style\* | | Mirrors the value of option `style` |
|
||||
|
||||
### Esempio
|
||||
|
||||
```toml
|
||||
[nats]
|
||||
format = '[$symbol]($style)'
|
||||
style = 'bold purple'
|
||||
```
|
||||
|
||||
## Nim
|
||||
|
||||
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2943,6 +3013,43 @@ The `ocaml` module shows the currently installed version of [OCaml](https://ocam
|
||||
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.
|
||||
|
||||
### Opzioni
|
||||
|
||||
| Opzione | Default | Descrizione |
|
||||
| ------------------- | ------------------------------------ | ----------------------------------------------------- |
|
||||
| `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'` | Lo stile per il modulo. |
|
||||
| `disabled` | `false` | Disables the `odin` module. |
|
||||
| `detect_extensions` | `['odin']` | Quali estensioni dovrebbero attivare questo modulo. |
|
||||
| `detect_files` | `[]` | Quali nomi di file dovrebbero attivare questo modulo. |
|
||||
| `detect_folders` | `[]` | Quali cartelle dovrebbero attivare questo modulo. |
|
||||
|
||||
### Variables
|
||||
|
||||
| Variable | Esempio | Descrizione |
|
||||
| --------- | ------------- | ------------------------------------ |
|
||||
| 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
|
||||
|
||||
### Esempio
|
||||
|
||||
```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. By default the module will be shown if the current directory contains a `.rego` file.
|
||||
@ -3811,7 +3918,7 @@ format = '$shlvl level(s) down'
|
||||
threshold = 3
|
||||
```
|
||||
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceeding characters are provided by `shlvl`.
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceding characters are provided by `shlvl`.
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
@ -4241,6 +4348,7 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
|
||||
| `format` | `'[$user]($style) in '` | The format for the module. |
|
||||
| `show_always` | `false` | Always shows the `username` module. |
|
||||
| `disabled` | `false` | Disables the `username` module. |
|
||||
| `aliases` | `{}` | Translate system usernames to something else |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -4262,6 +4370,7 @@ style_root = 'black bold'
|
||||
format = 'user: [$user]($style) '
|
||||
disabled = false
|
||||
show_always = true
|
||||
aliases = { "corpuser034g" = "matchai" }
|
||||
```
|
||||
|
||||
#### Hide the hostname in remote tmux sessions
|
||||
|
||||
@ -123,7 +123,7 @@ sh -c 'rm "$(command -v 'starship')"'
|
||||
|
||||
## How do I install Starship without `sudo`?
|
||||
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation directory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
|
||||
For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
|
||||
|
||||
|
||||
@ -431,6 +431,8 @@ Ti invito di controllare questi lavori precedenti che hanno contribuito a ispira
|
||||
|
||||
Support this project by [becoming a sponsor](https://github.com/sponsors/starship). Your name or logo will show up here with a link to your website.
|
||||
|
||||
- Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org)
|
||||
|
||||
<p align="center">
|
||||
<br>
|
||||
<img width="100" src="https://raw.githubusercontent.com/starship/starship/master/media/icon.png" alt="Starship rocket icon">
|
||||
|
||||
@ -45,7 +45,7 @@ On Funtoo Linux, starship can be installed from [core-kit](https://github.com/fu
|
||||
emerge app-shells/starship
|
||||
```
|
||||
|
||||
## [Nix](https://nixos.wiki/wiki/Nix)
|
||||
## [Nix](https://wiki.nixos.org/wiki/Nix)
|
||||
|
||||
### Ottenere il Binario
|
||||
|
||||
|
||||
@ -25,6 +25,20 @@ metaTitle: "Starship: Cross-Shell Prompt"
|
||||
description: Starship はミニマルで、非常に高速で、カスタマイズ性の高い、あらゆるシェルのためのプロンプトです！ ミニマルかつ洗練された形で、あなたに必要な情報を表示します。 Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, PowerShellで簡単に利用できます。
|
||||
---
|
||||
|
||||
<script setup>
|
||||
import { onMounted } from 'vue'
|
||||
|
||||
onMounted(() => {
|
||||
const urlParams = new URLSearchParams(window.location.search)
|
||||
if (urlParams.has('uwu') || urlParams.has('kawaii')) {
|
||||
const img = document.querySelector('.VPHero .VPImage.image-src')
|
||||
img.classList.add('uwu')
|
||||
img.src = '/logo-uwu.png'
|
||||
img.alt = 'Kawaii Starship Logo by @sawaratsuki1004'
|
||||
}
|
||||
})
|
||||
</script>
|
||||
|
||||
<video class="demo-video" muted autoplay loop playsinline>
|
||||
<source src="/demo.webm" type="video/webm">
|
||||
<source src="/demo.mp4" type="video/mp4">
|
||||
|
||||
@ -10,7 +10,7 @@ Starship は汎用性の高いシェルですが、時には特定の処理を
|
||||
|
||||
## PowerShell の TransientPrompt
|
||||
|
||||
過去に出力されたプロンプトを置き換えることができます。 全ての情報が必要では無い時に役に立ちます。 有効にするには、 `Enable-TransientPrompt` をシェルで実行してください。 `$PROFILE` に追記することによって常時有効にすることが出来ます。 また、 `Disable-TransientPrompt` によっていつでも無効化することが出来ます。
|
||||
直前に出力されたプロンプトを置き換えることができます。 プロンプトの内容全てが常に必要ではない時に役立ちます。 有効にするには、 `Enable-TransientPrompt` をシェルで実行してください。 `$PROFILE` に追記することによって常時有効にすることが出来ます。 また、 `Disable-TransientPrompt` によっていつでも無効化することが出来ます。
|
||||
|
||||
デフォルトでは、入力した文字列の左側を `>` で置換します。 カスタマイズするには、関数を `Invoke-Starship-TransientFunction` という名前で定義してください。 Starshipの `character` モジュールを表示する場合はこのようにします：
|
||||
|
||||
@ -56,11 +56,11 @@ load(io.popen('starship init cmd'):read("*a"))()
|
||||
|
||||
## Fish の TransientPrompt と TransientRightPrompt
|
||||
|
||||
過去に出力されたプロンプトを置き換えることができます。 全ての情報が必要では無い時に役に立ちます。 To enable this, run `enable_transience` in the shell session. To make it permanent, put this statement in your `~/.config/fish/config.fish`. Transience can be disabled on-the-fly with `disable_transience`.
|
||||
直前に出力されたプロンプトを指定の内容で置き換えることができます。 プロンプトの内容全てが常に必要ではない時に役立ちます。 有効にするには、 `enable_transience` を現在のシェルセッションで実行してください。 設定を永続化するにはこのコマンドを `~/.config/fish/config.fish` に記述してください。 また、 `disable_transience` を実行することでいつでも無効化できます。
|
||||
|
||||
Note that in case of Fish, the transient prompt is only printed if the commandline is non-empty, and syntactically correct.
|
||||
※Fishの場合は、コマンドラインが空ではなく構文的に正しい場合にのみ、transient プロンプトが出力されます。
|
||||
|
||||
- By default, the left side of input gets replaced with a bold-green `❯`. カスタマイズするには、新しい関数 `starship_transient_prompt_func` を定義します。 Starshipの `character` モジュールを表示する場合はこのようにします：
|
||||
- デフォルトでは入力した文字列の左側が太字・緑色の `❯` に置き換えられます。 カスタマイズするには、新しい関数 `starship_transient_prompt_func` を定義します。 Starshipの `character` モジュールを表示する場合はこのようにします：
|
||||
|
||||
```fish
|
||||
function starship_transient_prompt_func
|
||||
@ -80,31 +80,31 @@ starship init fish | source
|
||||
enable_transience
|
||||
```
|
||||
|
||||
## TransientPrompt and TransientRightPrompt in Bash
|
||||
## Bash の TransientPrompt と TransientRightPrompt
|
||||
|
||||
The [Ble.sh](https://github.com/akinomyoga/ble.sh) framework at v0.4 or higher allows you to replace the previous-printed prompt with custom strings. This is useful in cases where all the prompt information is not always needed. To enable this, put this in `~/.bashrc` `bleopt prompt_ps1_transient=<value>`:
|
||||
バージョン 0.4 以降の [ble.sh](https://github.com/akinomyoga/ble.sh) の枠組みを用いると、直前に表示されたプロンプトを指定の文字列に置き換えることができます。 プロンプトの内容全てが常に必要ではない時に役立ちます。 有効にするには、 `~/.bashrc` に `bleopt prompt_ps1_transient=<value>` を記述してください。
|
||||
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and this option has a non-empty value, the prompt specified by `PS1` is erased on leaving the current command line. If the value contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in the value and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
\<value\> は `always`、 `same-dir` 、 `trim` からなるコロン区切りのリストです。 設定 `prompt_ps1_final` が空でかつ設定 `prompt_ps1_transient` が非空の \<value\> を持つ場合、 `PS1` に基づくプロンプトは現在のコマンドラインを去るときに消去されます。 \<value\> が `trim` を含む場合、複数行 `PS1` の最後の行だけを残して他の行は消去されます。 それ以外の場合は、あたかも `PS1=` が指定されたかのようにコマンドラインが再描画されます。 \<value\> が項目 `same-dir` を含む時に現在のワーキングディレクトリが前のコマンドラインの最終的なワーキングディレクトリと異なる場合、設定 `prompt_ps1_transient` は無視されます。
|
||||
|
||||
Make the following changes to your `~/.bashrc` to customize what gets displayed on the left and on the right:
|
||||
左側や右側に transient プロンプトとして出力する文字列を変更するには、以下の変更を `~/.blerc` (または `~/.config/blesh/init.sh`) に適用してください。
|
||||
|
||||
- To customize what the left side of input gets replaced with, configure the `prompt_ps1_final` Ble.sh option. For example, to display Starship's `character` module here, you would do
|
||||
- 入力文字列の左側を何に置き換えるか変更するには、 ble.sh 設定 `prompt_ps1_final` を設定します。 例えば Starship の `character` モジュールをここに表示するには、次のようにします。
|
||||
|
||||
```bash
|
||||
bleopt prompt_ps1_final="$(starship module character)"
|
||||
bleopt prompt_ps1_final='$(starship module character)'
|
||||
```
|
||||
|
||||
- To customize what the right side of input gets replaced with, configure the `prompt_rps1_final` Ble.sh option. 例えば、直前のコマンドを実行した時刻を表示するには次のようにします。
|
||||
- 入力文字列の右側を何に置き換えるか変更するには、 ble.sh 設定 `prompt_rps1_final` を設定します。 例えば、直前のコマンドを実行した時刻を表示するには次のようにします。
|
||||
|
||||
```bash
|
||||
bleopt prompt_rps1_final="$(starship module time)"
|
||||
bleopt prompt_rps1_final='$(starship module time)'
|
||||
```
|
||||
|
||||
## Cmdのカスタムの事前プロンプトおよび事前実行コマンド
|
||||
|
||||
Clinkはプロンプト表示前と実行前にCmd shellコマンドを実行するための非常に柔軟なAPIを提供します。 It is fairly simple to use with Starship. Make the following changes to your `starship.lua` file as per your requirements:
|
||||
Clinkはプロンプト表示前と実行前にCmd shellコマンドを実行するための非常に柔軟なAPIを提供します。 Starshipからこれを利用するのはとても簡単です。 好みに従って `starship.lua` を以下のように変更してください。
|
||||
|
||||
- To run a custom function right before the prompt is drawn, define a new function called `starship_preprompt_user_func`. This function receives the current prompt as a string that you can utilize. For example, to draw a rocket before the prompt, you would do
|
||||
- プロンプトが描画される直前に好みの関数を実行するには、 `starship_preprompt_user_func` という名前で新しい関数を定義してください。 この関数は現在のプロンプトを再利用できる文字列で受け取ります。 例として、ロケットをプロンプトの前に表示するには、以下のようにします。
|
||||
|
||||
```lua
|
||||
function starship_preprompt_user_func(prompt)
|
||||
@ -114,7 +114,7 @@ end
|
||||
load(io.popen('starship init cmd'):read("*a")()
|
||||
```
|
||||
|
||||
- To run a custom function right before a command is executed, define a new function called `starship_precmd_user_func`. This function receives the current commandline as a string that you can utilize. For example, to print the command that's about to be executed, you would do
|
||||
- コマンドが実行される直前に好みの関数を実行するには、 `starship_precmd_user_func` という名前で新しい関数を定義してください。 この関数は現在のコマンドライン文字列を再利用できる文字列で受け取ります。 例えば、これから実行されるコマンドを出力するには、以下のようにします。
|
||||
|
||||
```lua
|
||||
function starship_precmd_user_func(line)
|
||||
@ -137,7 +137,7 @@ function blastoff(){
|
||||
starship_precmd_user_func="blastoff"
|
||||
```
|
||||
|
||||
- コマンドの直前に関数を実行するために、[`DEBUG` トラップの仕組み](https://jichu4n.com/posts/debug-trap-and-prompt_command-in-bash/)を使うことができます。 However, you **must** trap the DEBUG signal _before_ initializing Starship! Starship は DEBUGトラップの値を保護できますが、 starship の起動後にトラップが上書きされると、いくつかの機能は壊れてしまうでしょう。
|
||||
- コマンドの直前に関数を実行するために、[`DEBUG` トラップの仕組み](https://jichu4n.com/posts/debug-trap-and-prompt_command-in-bash/)を使うことができます。 ただし、Starship を初期化する_前_に DEBUG シグナルをトラップ**しなければいけません**! Starship は DEBUGトラップの値を保護できますが、 starship の起動後にトラップが上書きされると、いくつかの機能は壊れてしまうでしょう。
|
||||
|
||||
```bash
|
||||
function blastoff(){
|
||||
@ -149,11 +149,11 @@ eval $(starship init bash)
|
||||
set +o functrace
|
||||
```
|
||||
|
||||
## Custom pre-prompt and pre-execution Commands in PowerShell
|
||||
## PowerShell のカスタム事前プロンプトおよび事前実行コマンド
|
||||
|
||||
PowerShell does not have a formal preexec/precmd framework like most other shells. そのため、`powershell`で完全にカスタマイズ可能なフックを提供することは困難です。 ただし、Starship はプロンプトを描画する一連の流れに、限定的に独自の関数を挿入することができます。
|
||||
PowerShell は、他のほとんどのシェルと違い、正式な preexec/precmd の枠組みを持ちません。 そのため、`powershell`で完全にカスタマイズ可能なフックを提供することは困難です。 ただし、Starship はプロンプトを描画する一連の流れに、限定的に独自の関数を挿入することができます。
|
||||
|
||||
Create a function named `Invoke-Starship-PreCommand`
|
||||
`Invoke-Starship-PreCommand` という名前の関数を作成してください。
|
||||
|
||||
```powershell
|
||||
function Invoke-Starship-PreCommand {
|
||||
@ -161,9 +161,9 @@ function Invoke-Starship-PreCommand {
|
||||
}
|
||||
```
|
||||
|
||||
## ウィンドウのタイトルの変更
|
||||
## ウィンドウタイトルの変更
|
||||
|
||||
いくつかのシェルプロンプトはあなたのためにウィンドウのタイトルを自動的に変更します(例えば、カレントディレクトリを反映するために)。 特に Fish はデフォルトで変更を行います。 Starship does not do this, but it's fairly straightforward to add this functionality to `bash`, `zsh`, `cmd` or `powershell`.
|
||||
いくつかのシェルプロンプトはあなたのためにウィンドウのタイトルを自動的に変更します(例えば、カレントディレクトリを反映するために)。 特に Fish はデフォルトで変更を行います。 Starship はこれに対応しませんが、この機能を `bash`, `zsh`, `cmd`, `powershell` に追加することは簡単です。
|
||||
|
||||
まず、ウィンドウのタイトルを変更する関数を定義してください（ bash も zsh も同様に）
|
||||
|
||||
@ -198,7 +198,7 @@ function set_win_title(){
|
||||
starship_precmd_user_func="set_win_title"
|
||||
```
|
||||
|
||||
For Cmd, you can change the window title using the `starship_preprompt_user_func` function.
|
||||
Cmd では、 `starship_preprompt_user_func` 関数を使用してウィンドウのタイトルを変更できます。
|
||||
|
||||
```lua
|
||||
function starship_preprompt_user_func(prompt)
|
||||
@ -208,7 +208,7 @@ end
|
||||
load(io.popen('starship init cmd'):read("*a"))()
|
||||
```
|
||||
|
||||
You can also set a similar output with PowerShell by creating a function named `Invoke-Starship-PreCommand`.
|
||||
PowerShell でも `Invoke-Starship-PreCommand` という名前の関数を作成することで、同様の出力を設定できます。
|
||||
|
||||
```powershell
|
||||
# edit $PROFILE
|
||||
@ -223,21 +223,21 @@ Invoke-Expression (&starship init powershell)
|
||||
|
||||
シェルによっては、入力と同じ行にレンダリングされる右プロンプトをサポートしています。 Starship では `right_format` オプションを使って右プロンプトの内容を設定できます。 `format`で使用できるモジュールはすべて`right_format`でも使用できます。 変数`$all`には、`format`や`right_format`で明示的に使用されていないモジュールのみが格納されます。
|
||||
|
||||
注意: 右プロンプトは入力の場所に続く単一の行です。 To right align modules above the input line in a multi-line prompt, see the [`fill` module](../config/#fill).
|
||||
注意: 右プロンプトは入力の場所に続く単一の行です。 複数行プロンプトで入力行の上にあるモジュールを右寄せしたいときは、 [`fill` module](../config/#fill) を参照してください。
|
||||
|
||||
`right_format` is currently supported for the following shells: elvish, fish, zsh, xonsh, cmd, nushell, bash.
|
||||
`right_format` は現在、次のシェルでサポートされています: elvish, fish, zsh, xonsh, cmd, nushell, bash
|
||||
|
||||
Note: The [Ble.sh](https://github.com/akinomyoga/ble.sh) framework v0.4 or higher should be installed in order to use right prompt in bash.
|
||||
注意: 右プロンプトを Bash で利用するには [ble.sh](https://github.com/akinomyoga/ble.sh) のバージョン 0.4 以降をインストールする必要があります。
|
||||
|
||||
### 設定例
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
# A minimal left prompt
|
||||
# 最低限の左プロンプト
|
||||
format = """$character"""
|
||||
|
||||
# move the rest of the prompt to the right
|
||||
# 残りのプロンプトの内容を右に寄せる
|
||||
right_format = """$all"""
|
||||
```
|
||||
|
||||
@ -247,15 +247,15 @@ right_format = """$all"""
|
||||
▶ starship on rprompt [!] is 📦 v0.57.0 via 🦀 v1.54.0 took 17s
|
||||
```
|
||||
|
||||
## Continuation Prompt
|
||||
## 継続プロンプト (Continuation Prompt)
|
||||
|
||||
Some shells support a continuation prompt along with the normal prompt. This prompt is rendered instead of the normal prompt when the user has entered an incomplete statement (such as a single left parenthesis or quote).
|
||||
一部のシェルは、通常のプロンプトの他に継続プロンプトをサポートしています。 このプロンプトは、ユーザーが不完全な文 (単一の左括弧や引用符など) を確定したときに通常のプロンプトの代わりに表示されます。
|
||||
|
||||
Starship can set the continuation prompt using the `continuation_prompt` option. The default prompt is `'[∙](bright-black) '`.
|
||||
Starship では、 `contination_prompt` オプションを使用して継続プロンプトを設定できます。 既定の継続プロンプトは `'[・](bright-black) '` です。
|
||||
|
||||
Note: `continuation_prompt` should be set to a literal string without any variables.
|
||||
注意: `contination_prompt` には変数を含まないそのまま文字列を設定する必要があります。
|
||||
|
||||
Note: Continuation prompts are only available in the following shells:
|
||||
注意: 継続プロンプトは次のシェルでのみ使用できます。
|
||||
|
||||
- `bash`
|
||||
- `zsh`
|
||||
@ -266,7 +266,7 @@ Note: Continuation prompts are only available in the following shells:
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
# A continuation prompt that displays two filled in arrows
|
||||
# 2つの塗りつぶし右三角を表示する継続プロンプト
|
||||
continuation_prompt = '▶▶ '
|
||||
```
|
||||
|
||||
@ -299,8 +299,8 @@ continuation_prompt = '▶▶ '
|
||||
|
||||
複数の色が文字色/背景色に指定された際には、最後の指定が優先して選ばれます。
|
||||
|
||||
Not every style string will be displayed correctly by every terminal. In particular, the following known quirks exist:
|
||||
すべてのスタイル文字列がすべての端末で正しく表示できるわけではありません。 特に、端末の変な動作として以下のようなものが知られています。
|
||||
|
||||
- Many terminals disable support for `blink` by default
|
||||
- `hidden` is [not supported on iTerm](https://gitlab.com/gnachman/iterm2/-/issues/4564).
|
||||
- `strikethrough` is not supported by the default macOS Terminal.app
|
||||
- 多くの端末はデフォルトで `bink` のサポートを無効にしています。
|
||||
- `hidden` は [iTerm ではサポートされていません](https://gitlab.com/gnachman/iterm2/-/issues/4564)。
|
||||
- `strikethrough` は、macOS 既定の Terminal.app ではサポートされていません。
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@ -58,7 +58,7 @@ curl -sS https://starship.rs/install.sh | sh -s -- --platform unknown-linux-musl
|
||||
|
||||
## どうして`Executing command "..." timed out.`という警告が出てくるのでしょうか?
|
||||
|
||||
Starship executes different commands to get information to display in the prompt, for example the version of a program or the current git status. To make sure starship doesn't hang while trying to execute these commands we set a time limit, if a command takes longer than this limit starship will stop the execution of the command and output the above warning, this is expected behaviour. This time limit is configurable using the [`command_timeout`key](../config/#prompt) so if you want you can increase the time limit. You can also follow the debugging steps below to see which command is being slow and see if you can optimise it. Finally you can set the `STARSHIP_LOG` env var to `error` to hide these warnings.
|
||||
Starship は、プロンプトに表示する情報 (例えば、プログラムのバージョンや現在の git ステータス) を取得するために、異なるコマンドを実行します。 これらのコマンドの実行中に Starship の応答がなくなるのを防ぐためにタイムリミットが設定されています。コマンド実行にタイムリミットよりも長い時間がかかった時、コマンド実行がキャンセルされ上記の警告が表示されます。これは意図的な動作です。 タイムリミットは [`command_timeout`key](../config/#prompt) を用いて変更可能ですので、お望みであればタイムリミットを長くできます。 更に以下のデバッグ手順によって、どのコマンドの実行に時間がかかっているかや、それを高速化できるかについて確認できます。 最終手段として、環境変数 `STARSHIP_LOG` に `error` を設定することでこれらの警告を非表示にできます。
|
||||
|
||||
## よくわからない記号を見つけました。これはどういった意味ですか？
|
||||
|
||||
@ -66,21 +66,21 @@ Starship executes different commands to get information to display in the prompt
|
||||
|
||||
## Starshipがなにか想定外の挙動をしているとき、どのようにデバッグすればよいですか？
|
||||
|
||||
You can enable the debug logs by using the `STARSHIP_LOG` env var. These logs can be very verbose so it is often useful to use the `module` command if you are trying to debug a particular module, for example, if you are trying to debug the `rust` module you could run the following command to get the trace logs and output from the module.
|
||||
環境変数 `STARSHIP_LOG` を使用してデバッグログを有効にできます。 特定のモジュールをデバグしようとしているとき、デバッグログが過度に冗長になることがありますが、その場合は `module` コマンドが役立ちます。例えば、`rust` モジュールをデバグしようとしているとき、以下のコマンドを用いてこのモジュールからのログと出力を取得できます。
|
||||
|
||||
```sh
|
||||
env STARSHIP_LOG=trace starship module rust
|
||||
```
|
||||
|
||||
If starship is being slow you can try using the `timings` command to see if there is a particular module or command that is to blame.
|
||||
Starship が遅い場合は、 `timings` コマンドを使って特定のモジュールまたはコマンドが悪さをしているか確認できます。
|
||||
|
||||
```sh
|
||||
env STARSHIP_LOG=trace starship timings
|
||||
```
|
||||
|
||||
This will output the trace log and a breakdown of all modules that either took more than 1ms to execute or produced some output.
|
||||
トレースログおよび、実行に 1 ミリ秒以上かかったか何か出力をした全てのモジュールの個別解析を出力します。
|
||||
|
||||
Finally if you find a bug you can use the `bug-report` command to create a GitHub issue.
|
||||
バグを見つけた場合は、 `bug-report` コマンドを用いて GitHub の問題を作成できます。
|
||||
|
||||
```sh
|
||||
starship bug-report
|
||||
@ -121,10 +121,10 @@ Starship をインストールスクリプトを使用してインストール
|
||||
sh -c 'rm "$(command -v 'starship')"'
|
||||
```
|
||||
|
||||
## How do I install Starship without `sudo`?
|
||||
## `sudo` を使わずに Starship をインストールするにはどうすればいいですか?
|
||||
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
インストールシェルスクリプト (`https://starship.rs/install.sh`) はインストール先のディレクトリが現在のユーザによって書き込みできない時に限り `sudo` の使用を試みます。 既定のインストールディレクトリは、 `$BIN_DIR` 環境変数の値、または`$BIN_DIR` が設定されていない場合は `/usr/local/bin` です。 インストールディレクトリを現在のユーザが書き込みできるディレクトリに設定すれば、 `sudo` なしで Starship をインストールできます。 例えば `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` は、インストールスクリプトにコマンドラインオプション `-b` を指定してインストールディレクトリを `~/.local/bin` に設定します。
|
||||
|
||||
For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
|
||||
Starship の非対話形式でのインストールでは、確認をスキップするために `-y` オプションを追加することを忘れないでください。 対応しているオプションの一覧についてはインストールスクリプトのソースをご確認ください。
|
||||
|
||||
When using a package manager, see the documentation for your package manager about installing with or without `sudo`.
|
||||
パッケージマネージャーを使う時は、 `sudo` を使ったまたは使わないインストールに関して、パッケージマネージャーのドキュメントを参照してください。
|
||||
|
||||
@ -35,7 +35,7 @@
|
||||
<a href="https://stand-with-ukraine.pp.ua"
|
||||
><img
|
||||
src="https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/badges/StandWithUkraineFlat.svg"
|
||||
alt="Stand With Ukraine"
|
||||
alt="ウクライナと共に歩む"
|
||||
/></a>
|
||||
</p>
|
||||
|
||||
@ -161,7 +161,7 @@
|
||||
align="right"
|
||||
/>
|
||||
|
||||
**シェル用の最小限の、非常に高速で、無限にカスタマイズ可能なプロンプトです！**
|
||||
**最小限の、非常に高速で、無限にカスタマイズ可能なシェル用のプロンプトです！**
|
||||
|
||||
- **高速:** _本当に_ 高速です！ 🚀
|
||||
- **カスタマイズ可能:** プロンプトのあらゆる側面を構成します。
|
||||
@ -431,6 +431,8 @@ Starshipのさらなるカスタマイズを目指すなら以下を参考にし
|
||||
|
||||
[スポンサーになることで](https://github.com/sponsors/starship)このプロジェクトをサポートできます。 名前やロゴがあなたのホームページへのリンクとともに表示されます。
|
||||
|
||||
- Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org)
|
||||
|
||||
<p align="center">
|
||||
<br>
|
||||
<img width="100" src="https://raw.githubusercontent.com/starship/starship/master/media/icon.png" alt="Starship rocket icon">
|
||||
|
||||
@ -5,7 +5,7 @@ Starship をインストールするには、以下の2つのことを行う必
|
||||
1. ** starship ** のバイナリをコンピューター上に取得する
|
||||
1. Init スクリプトを修正することで、Starship バイナリをプロンプトとして使用するようシェルに指示する
|
||||
|
||||
For most users, the instructions on [the main page](../guide/#🚀-installation) will work great. しかし、より特殊なプラットフォームでは、別の操作が必要になることがあります。
|
||||
ほとんどの場合、[メインページ](../guide/#🚀-installation)の指示に従えば問題なく動作します。 しかし、より特殊なプラットフォームでは、別の操作が必要になることがあります。
|
||||
|
||||
プラットフォームは無数に存在するため、メインの README.md ファイルには書ききれません。そこで、このページでは、コミュニティにより提供された他のプラットフォーム向けのインストール方法について紹介します。 あなたが使用しているプラットフォームが見当たりませんか？ その場合は是非、見つけた方法をここに追加してください。
|
||||
|
||||
@ -45,7 +45,7 @@ Funtoo Linuxでは、Portageの[core-kit](https://github.com/funtoo/core-kit/tre
|
||||
emerge app-shells/starship
|
||||
```
|
||||
|
||||
## [Nix](https://nixos.wiki/wiki/Nix)
|
||||
## [Nix](https://wiki.nixos.org/wiki/Nix)
|
||||
|
||||
### バイナリの取得
|
||||
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
# v0.45への移行
|
||||
# v0.45.0への移行
|
||||
|
||||
Starship v0.45.0は、v1.0.0の準備として互換性の無い変更を含むリリースになります。 私たちはより多くのカスタマイズを可能にするために、プロンプトでの設定方法にいくつかの大きな変更を加えました。
|
||||
|
||||
|
||||
@ -12,15 +12,15 @@
|
||||
|
||||
## [No Nerd Fonts](./no-nerd-font.md)
|
||||
|
||||
This preset changes the symbols for several modules so that no Nerd Font symbols are used anywhere in the prompt.
|
||||
このプリセットは一部のモジュールで使われるシンボルを変更して、Nerd Font シンボルをどこにも使わないようにします。
|
||||
|
||||
::: tip
|
||||
|
||||
This preset will become the default preset [in a future release of starship](https://github.com/starship/starship/pull/3544).
|
||||
このプリセットは [Starship の将来のリリース](https://github.com/starship/starship/pull/3544) でデフォルトのプリセットになります。
|
||||
|
||||
:::
|
||||
|
||||
[Click to view No Nerd Font preset](./no-nerd-font)
|
||||
[No Nerd Font プリセットを表示するにはクリックしてください。](./no-nerd-font)
|
||||
|
||||
## [Bracketed Segments](./bracketed-segments.md)
|
||||
|
||||
@ -42,7 +42,7 @@ This preset will become the default preset [in a future release of starship](htt
|
||||
|
||||
## [No Empty Icons](./no-empty-icons.md)
|
||||
|
||||
This preset does not show icons if the toolset is not found.
|
||||
ツールセットが見つからない場合、このプリセットはアイコンを表示しません。
|
||||
|
||||
[](./no-empty-icons.md)
|
||||
|
||||
@ -62,16 +62,16 @@ This preset does not show icons if the toolset is not found.
|
||||
|
||||
このプリセットは[tokyo-night-vscode-theme](https://github.com/enkia/tokyo-night-vscode-theme)を参考にしています。
|
||||
|
||||
[](./tokyo-night)
|
||||
[](./tokyo-night)
|
||||
|
||||
## [Gruvbox Rainbow](./gruvbox-rainbow.md)
|
||||
|
||||
This preset is heavily inspired by [Pastel Powerline](./pastel-powerline.md), and [Tokyo Night](./tokyo-night.md).
|
||||
このプリセットは [Pastel Powerline](./pastel-powerline.md) と [Tokyo Night](./tokyo-night.md) に強くインスパイアされています。
|
||||
|
||||
[](./gruvbox-rainbow)
|
||||
[](./gruvbox-rainbow)
|
||||
|
||||
## [Jetpack](./jetpack.md)
|
||||
|
||||
This is a pseudo minimalist preset inspired by the [geometry](https://github.com/geometry-zsh/geometry) and [spaceship](https://github.com/spaceship-prompt/spaceship-prompt) prompts.
|
||||
[geometry](https://github.com/geometry-zsh/geometry) と [spaceship](https://github.com/spaceship-prompt/spaceship-prompt) のプロンプトにインスパイアされた擬似ミニマリストプリセットです。
|
||||
|
||||
[](./jetpack)
|
||||
[](./jetpack)
|
||||
|
||||
@ -1,12 +1,12 @@
|
||||
[プリセット一覧に戻る](./#gruvbox-rainbow)
|
||||
|
||||
# Gruvbox Rainbow Preset
|
||||
# Gruvbox Rainbow プリセット
|
||||
|
||||
This preset is heavily inspired by [Pastel Powerline](./pastel-powerline.md), and [Tokyo Night](./tokyo-night.md).
|
||||
このプリセットは [Pastel Powerline](./pastel-powerline.md) と [Tokyo Night](./tokyo-night.md) に強くインスパイアされています。
|
||||
|
||||
|
||||
|
||||
|
||||
### 必要なもの
|
||||
### 前提条件
|
||||
|
||||
- [Nerd Font](https://www.nerdfonts.com/)のインストールとターミナルでの有効化
|
||||
|
||||
|
||||
@ -1,17 +1,17 @@
|
||||
[プリセット一覧に戻る](./#jetpack)
|
||||
|
||||
# Jetpack Preset
|
||||
# Jetpack プリセット
|
||||
|
||||
This is a pseudo minimalist preset inspired by the [geometry](https://github.com/geometry-zsh/geometry) and [spaceship](https://github.com/spaceship-prompt/spaceship-prompt) prompts.
|
||||
[geometry](https://github.com/geometry-zsh/geometry) と [spaceship](https://github.com/spaceship-prompt/spaceship-prompt) のプロンプトにインスパイアされた擬似ミニマリストプリセットです。
|
||||
|
||||
> Jetpack uses the terminal's color theme.
|
||||
> Jetpack はターミナルのカラーテーマを使用します。
|
||||
|
||||
|
||||
|
||||
|
||||
### Prerequisite
|
||||
### 前提条件
|
||||
|
||||
- Requires a shell with [`right-prompt`](https://starship.rs/advanced-config/#enable-right-prompt) support.
|
||||
- [Jetbrains Mono](https://www.jetbrains.com/lp/mono/) is recommended.
|
||||
- [`右プロンプト`](https://starship.rs/advanced-config/#enable-right-prompt) に対応したシェルが必要です。
|
||||
- [Jetbrain Mono](https://www.jetbrains.com/lp/mono/) が推奨されます。
|
||||
|
||||
### 設定
|
||||
|
||||
|
||||
@ -2,7 +2,7 @@
|
||||
|
||||
# No Empty Icons プリセット
|
||||
|
||||
If toolset files are identified the toolset icon is displayed. If the toolset is not found to determine its version number, it is not displayed. This preset changes the behavior to display the icon only if the toolset information can be determined.
|
||||
ツールセットファイルが特定できたときに、ツールセットアイコンを表示します。 ツールセットが見つかってバージョン番号を特定できない限りは、アイコンは表示されません。 このプリセットは、ツールセット情報が特定できる場合にのみアイコンを表示するように動作を変更します。
|
||||
|
||||
|
||||
|
||||
|
||||
@ -2,11 +2,11 @@
|
||||
|
||||
# No Nerd Fonts プリセット
|
||||
|
||||
This preset restricts the use of symbols to those from emoji and powerline sets.
|
||||
このプリセットは使用するシンボルを絵文字や powerline のセットに制限します。
|
||||
|
||||
This means that even without a Nerd Font installed, you should be able to view all module symbols.
|
||||
つまり Nerd Font をインストールしなくても、すべてのモジュールのシンボルを正しく表示できます。
|
||||
|
||||
This preset will become the default preset in a future release of starship.
|
||||
このプリセットは、将来の Starship のリリースで既定のプリセットになります。
|
||||
|
||||
### 設定
|
||||
|
||||
|
||||
@ -25,6 +25,20 @@ metaTitle: "Starship: 크로스-셸 프롬프트"
|
||||
description: Starship은 아무 셸에나 적용할 수 있는 작고, 매우 빠르며, 무한히 커스텀 가능한 프롬프트입니다! 필요한 정보를 깔끔하고 간략하게 표시합니다. Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, 및 PowerShell에 빠르게 설치할 수 있습니다.
|
||||
---
|
||||
|
||||
<script setup>
|
||||
import { onMounted } from 'vue'
|
||||
|
||||
onMounted(() => {
|
||||
const urlParams = new URLSearchParams(window.location.search)
|
||||
if (urlParams.has('uwu') || urlParams.has('kawaii')) {
|
||||
const img = document.querySelector('.VPHero .VPImage.image-src')
|
||||
img.classList.add('uwu')
|
||||
img.src = '/logo-uwu.png'
|
||||
img.alt = 'Kawaii Starship Logo by @sawaratsuki1004'
|
||||
}
|
||||
})
|
||||
</script>
|
||||
|
||||
<video class="demo-video" muted autoplay loop playsinline>
|
||||
<source src="/demo.webm" type="video/webm">
|
||||
<source src="/demo.mp4" type="video/mp4">
|
||||
|
||||
@ -84,20 +84,20 @@ enable_transience
|
||||
|
||||
The [Ble.sh](https://github.com/akinomyoga/ble.sh) framework at v0.4 or higher allows you to replace the previous-printed prompt with custom strings. This is useful in cases where all the prompt information is not always needed. To enable this, put this in `~/.bashrc` `bleopt prompt_ps1_transient=<value>`:
|
||||
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and this option has a non-empty value, the prompt specified by `PS1` is erased on leaving the current command line. If the value contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in the value and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and the option `prompt_ps1_transient` has a non-empty \<value\>, the prompt specified by `PS1` is erased on leaving the current command line. If \<value\> contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in \<value\> and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
|
||||
Make the following changes to your `~/.bashrc` to customize what gets displayed on the left and on the right:
|
||||
Make the following changes to your `~/.blerc` (or in `~/.config/blesh/init.sh`) to customize what gets displayed on the left and on the right:
|
||||
|
||||
- To customize what the left side of input gets replaced with, configure the `prompt_ps1_final` Ble.sh option. For example, to display Starship's `character` module here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_ps1_final="$(starship module character)"
|
||||
bleopt prompt_ps1_final='$(starship module character)'
|
||||
```
|
||||
|
||||
- To customize what the right side of input gets replaced with, configure the `prompt_rps1_final` Ble.sh option. For example, to display the time at which the last command was started here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_rps1_final="$(starship module time)"
|
||||
bleopt prompt_rps1_final='$(starship module time)'
|
||||
```
|
||||
|
||||
## Custom pre-prompt and pre-execution Commands in Cmd
|
||||
@ -266,7 +266,7 @@ Note: Continuation prompts are only available in the following shells:
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
# A continuation prompt that displays two filled in arrows
|
||||
# A continuation prompt that displays two filled-in arrows
|
||||
continuation_prompt = '▶▶ '
|
||||
```
|
||||
|
||||
@ -301,6 +301,6 @@ If multiple colors are specified for foreground/background, the last one in the
|
||||
|
||||
Not every style string will be displayed correctly by every terminal. In particular, the following known quirks exist:
|
||||
|
||||
- Many terminals disable support for `blink` by default
|
||||
- Many terminals disable support for `blink` by default.
|
||||
- `hidden` is [not supported on iTerm](https://gitlab.com/gnachman/iterm2/-/issues/4564).
|
||||
- `strikethrough` is not supported by the default macOS Terminal.app
|
||||
- `strikethrough` is not supported by the default macOS Terminal.app.
|
||||
|
||||
@ -281,6 +281,7 @@ $elixir\
|
||||
$elm\
|
||||
$erlang\
|
||||
$fennel\
|
||||
$gleam\
|
||||
$golang\
|
||||
$guix_shell\
|
||||
$haskell\
|
||||
@ -324,6 +325,7 @@ $aws\
|
||||
$gcloud\
|
||||
$openstack\
|
||||
$azure\
|
||||
$nats\
|
||||
$direnv\
|
||||
$env_var\
|
||||
$crystal\
|
||||
@ -601,7 +603,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
|
||||
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | The format for the module. |
|
||||
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
|
||||
| `기호` | `'🍞 '` | A format string representing the symbol of Bun. |
|
||||
| `기호` | `'🥟 '` | A format string representing the symbol of Bun. |
|
||||
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['bun.lockb', 'bunfig.toml']` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this module. |
|
||||
@ -1966,6 +1968,44 @@ Use Windows Starship executable on Windows paths in WSL
|
||||
windows_starship = '/mnt/c/Users/username/scoop/apps/starship/current/starship.exe'
|
||||
```
|
||||
|
||||
## Gleam
|
||||
|
||||
The `gleam` module shows the currently installed version of [Gleam](https://gleam.run/). By default the module will be shown if any of the following conditions are met:
|
||||
|
||||
- The current directory contains a `gleam.toml` file
|
||||
- The current directory contains a file with the `.gleam` extension
|
||||
|
||||
### Options
|
||||
|
||||
| Option | Default | Description |
|
||||
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | The format for the module. |
|
||||
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
|
||||
| `기호` | `'⭐ '` | A format string representing the symbol of Go. |
|
||||
| `detect_extensions` | `['gleam']` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['gleam.toml']` | Which filenames should trigger this module. |
|
||||
| `style` | `'bold #FFAFF3'` | The style for the module. |
|
||||
| `disabled` | `false` | Disables the `gleam` module. |
|
||||
|
||||
### Variables
|
||||
|
||||
| Variable | 예시 | Description |
|
||||
| --------- | -------- | ------------------------------------ |
|
||||
| version | `v1.0.0` | The version of `gleam` |
|
||||
| 기호 | | 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
|
||||
|
||||
### 예시
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
[gleam]
|
||||
format = 'via [⭐ $version](bold red) '
|
||||
```
|
||||
|
||||
## Go
|
||||
|
||||
The `golang` module shows the currently installed version of [Go](https://golang.org/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2444,7 +2484,7 @@ Displays the current [Kubernetes context](https://kubernetes.io/docs/concepts/co
|
||||
|
||||
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
|
||||
|
||||
When the module is enabled it will always be active, unless any of `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions.
|
||||
When the module is enabled it will always be active, unless any of `detect_env_vars`, `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions or one of the environmatal variable has been set.
|
||||
|
||||
:::
|
||||
|
||||
@ -2466,6 +2506,7 @@ The `context_aliases` and `user_aliases` options are deprecated. Use `contexts`
|
||||
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `[]` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this modules. |
|
||||
| `detect_env_vars` | `[]` | Which environmental variables should trigger this module |
|
||||
| `contexts` | `[]` | Customized styles and symbols for specific contexts. |
|
||||
| `disabled` | `true` | Disables the `kubernetes` module. |
|
||||
|
||||
@ -2768,6 +2809,35 @@ truncation_length = 4
|
||||
truncation_symbol = ''
|
||||
```
|
||||
|
||||
## NATS
|
||||
|
||||
The `nats` module shows the name of the current [NATS](https://nats.io) context.
|
||||
|
||||
### Options
|
||||
|
||||
| Option | Default | Description |
|
||||
| ---------- | -------------------------- | ------------------------------------------------------------ |
|
||||
| `기호` | `'✉️ '` | The symbol used before the NATS context (defaults to empty). |
|
||||
| `style` | `'bold purple'` | The style for the module. |
|
||||
| `format` | `'[$symbol$name]($style)'` | The format for the module. |
|
||||
| `disabled` | `false` | Disables the `nats` module. |
|
||||
|
||||
### Variables
|
||||
|
||||
| Variable | 예시 | Description |
|
||||
| --------- | ----------- | ------------------------------------ |
|
||||
| name | `localhost` | The name of the NATS context |
|
||||
| 기호 | | Mirrors the value of option `symbol` |
|
||||
| style\* | | Mirrors the value of option `style` |
|
||||
|
||||
### 예시
|
||||
|
||||
```toml
|
||||
[nats]
|
||||
format = '[$symbol]($style)'
|
||||
style = 'bold purple'
|
||||
```
|
||||
|
||||
## Nim
|
||||
|
||||
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2943,6 +3013,43 @@ The `ocaml` module shows the currently installed version of [OCaml](https://ocam
|
||||
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. |
|
||||
| `기호` | `'Ø '` | 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 | 예시 | Description |
|
||||
| --------- | ------------- | ------------------------------------ |
|
||||
| version | `dev-2024-03` | The version of `odin` |
|
||||
| 기호 | | 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
|
||||
|
||||
### 예시
|
||||
|
||||
```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. By default the module will be shown if the current directory contains a `.rego` file.
|
||||
@ -3811,7 +3918,7 @@ format = '$shlvl level(s) down'
|
||||
threshold = 3
|
||||
```
|
||||
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceeding characters are provided by `shlvl`.
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceding characters are provided by `shlvl`.
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
@ -4241,6 +4348,7 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
|
||||
| `format` | `'[$user]($style) in '` | The format for the module. |
|
||||
| `show_always` | `false` | Always shows the `username` module. |
|
||||
| `disabled` | `false` | Disables the `username` module. |
|
||||
| `aliases` | `{}` | Translate system usernames to something else |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -4262,6 +4370,7 @@ style_root = 'black bold'
|
||||
format = 'user: [$user]($style) '
|
||||
disabled = false
|
||||
show_always = true
|
||||
aliases = { "corpuser034g" = "matchai" }
|
||||
```
|
||||
|
||||
#### Hide the hostname in remote tmux sessions
|
||||
|
||||
@ -123,7 +123,7 @@ sh -c 'rm "$(command -v 'starship')"'
|
||||
|
||||
## How do I install Starship without `sudo`?
|
||||
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation directory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
|
||||
For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
|
||||
|
||||
|
||||
@ -431,6 +431,8 @@ Starship 을 만드는 데에 영감이 되었던 이전 작업들도 살펴보
|
||||
|
||||
이 [프로젝트를 후원](https://github.com/sponsors/starship)하여 프로젝트를 지원해 주세요. 여러분의 웹사이트로 이동하는 링크가 걸린 이름 혹은 로고가 여기에 걸립니다.
|
||||
|
||||
- Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org)
|
||||
|
||||
<p align="center">
|
||||
<br>
|
||||
<img width="100" src="https://raw.githubusercontent.com/starship/starship/master/media/icon.png" alt="Starship 로켓 아이콘">
|
||||
|
||||
@ -45,7 +45,7 @@ On Funtoo Linux, starship can be installed from [core-kit](https://github.com/fu
|
||||
emerge app-shells/starship
|
||||
```
|
||||
|
||||
## [Nix](https://nixos.wiki/wiki/Nix)
|
||||
## [Nix](https://wiki.nixos.org/wiki/Nix)
|
||||
|
||||
### Getting the Binary
|
||||
|
||||
|
||||
@ -25,6 +25,20 @@ metaTitle: "Starship: Cross-Shell Prompt"
|
||||
description: Starship is the minimal, blazing fast, and extremely customizable prompt for any shell! Shows the information you need, while staying sleek and minimal. Quick installation available for Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, and PowerShell.
|
||||
---
|
||||
|
||||
<script setup>
|
||||
import { onMounted } from 'vue'
|
||||
|
||||
onMounted(() => {
|
||||
const urlParams = new URLSearchParams(window.location.search)
|
||||
if (urlParams.has('uwu') || urlParams.has('kawaii')) {
|
||||
const img = document.querySelector('.VPHero .VPImage.image-src')
|
||||
img.classList.add('uwu')
|
||||
img.src = '/logo-uwu.png'
|
||||
img.alt = 'Kawaii Starship Logo by @sawaratsuki1004'
|
||||
}
|
||||
})
|
||||
</script>
|
||||
|
||||
<video class="demo-video" muted autoplay loop playsinline>
|
||||
<source src="/demo.webm" type="video/webm">
|
||||
<source src="/demo.mp4" type="video/mp4">
|
||||
|
||||
@ -84,20 +84,20 @@ enable_transience
|
||||
|
||||
The [Ble.sh](https://github.com/akinomyoga/ble.sh) framework at v0.4 or higher allows you to replace the previous-printed prompt with custom strings. This is useful in cases where all the prompt information is not always needed. To enable this, put this in `~/.bashrc` `bleopt prompt_ps1_transient=<value>`:
|
||||
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and this option has a non-empty value, the prompt specified by `PS1` is erased on leaving the current command line. If the value contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in the value and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and the option `prompt_ps1_transient` has a non-empty \<value\>, the prompt specified by `PS1` is erased on leaving the current command line. If \<value\> contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in \<value\> and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
|
||||
Make the following changes to your `~/.bashrc` to customize what gets displayed on the left and on the right:
|
||||
Make the following changes to your `~/.blerc` (or in `~/.config/blesh/init.sh`) to customize what gets displayed on the left and on the right:
|
||||
|
||||
- To customize what the left side of input gets replaced with, configure the `prompt_ps1_final` Ble.sh option. For example, to display Starship's `character` module here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_ps1_final="$(starship module character)"
|
||||
bleopt prompt_ps1_final='$(starship module character)'
|
||||
```
|
||||
|
||||
- To customize what the right side of input gets replaced with, configure the `prompt_rps1_final` Ble.sh option. For example, to display the time at which the last command was started here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_rps1_final="$(starship module time)"
|
||||
bleopt prompt_rps1_final='$(starship module time)'
|
||||
```
|
||||
|
||||
## Custom pre-prompt and pre-execution Commands in Cmd
|
||||
@ -266,7 +266,7 @@ Note: Continuation prompts are only available in the following shells:
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
# A continuation prompt that displays two filled in arrows
|
||||
# A continuation prompt that displays two filled-in arrows
|
||||
continuation_prompt = '▶▶ '
|
||||
```
|
||||
|
||||
@ -301,6 +301,6 @@ If multiple colors are specified for foreground/background, the last one in the
|
||||
|
||||
Not every style string will be displayed correctly by every terminal. In particular, the following known quirks exist:
|
||||
|
||||
- Many terminals disable support for `blink` by default
|
||||
- Many terminals disable support for `blink` by default.
|
||||
- `hidden` is [not supported on iTerm](https://gitlab.com/gnachman/iterm2/-/issues/4564).
|
||||
- `strikethrough` is not supported by the default macOS Terminal.app
|
||||
- `strikethrough` is not supported by the default macOS Terminal.app.
|
||||
|
||||
@ -281,6 +281,7 @@ $elixir\
|
||||
$elm\
|
||||
$erlang\
|
||||
$fennel\
|
||||
$gleam\
|
||||
$golang\
|
||||
$guix_shell\
|
||||
$haskell\
|
||||
@ -324,6 +325,7 @@ $aws\
|
||||
$gcloud\
|
||||
$openstack\
|
||||
$azure\
|
||||
$nats\
|
||||
$direnv\
|
||||
$env_var\
|
||||
$crystal\
|
||||
@ -601,7 +603,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
|
||||
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | The format for the module. |
|
||||
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'🍞 '` | A format string representing the symbol of Bun. |
|
||||
| `symbol` | `'🥟 '` | A format string representing the symbol of Bun. |
|
||||
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['bun.lockb', 'bunfig.toml']` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this module. |
|
||||
@ -1966,6 +1968,44 @@ Use Windows Starship executable on Windows paths in WSL
|
||||
windows_starship = '/mnt/c/Users/username/scoop/apps/starship/current/starship.exe'
|
||||
```
|
||||
|
||||
## Gleam
|
||||
|
||||
The `gleam` module shows the currently installed version of [Gleam](https://gleam.run/). By default the module will be shown if any of the following conditions are met:
|
||||
|
||||
- The current directory contains a `gleam.toml` file
|
||||
- The current directory contains a file with the `.gleam` extension
|
||||
|
||||
### Options
|
||||
|
||||
| Option | Default | Description |
|
||||
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | The format for the module. |
|
||||
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'⭐ '` | A format string representing the symbol of Go. |
|
||||
| `detect_extensions` | `['gleam']` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['gleam.toml']` | Which filenames should trigger this module. |
|
||||
| `style` | `'bold #FFAFF3'` | The style for the module. |
|
||||
| `disabled` | `false` | Disables the `gleam` module. |
|
||||
|
||||
### Variables
|
||||
|
||||
| Variable | Example | Description |
|
||||
| --------- | -------- | ------------------------------------ |
|
||||
| version | `v1.0.0` | The version of `gleam` |
|
||||
| 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
|
||||
|
||||
[gleam]
|
||||
format = 'via [⭐ $version](bold red) '
|
||||
```
|
||||
|
||||
## Go
|
||||
|
||||
The `golang` module shows the currently installed version of [Go](https://golang.org/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2444,7 +2484,7 @@ Displays the current [Kubernetes context](https://kubernetes.io/docs/concepts/co
|
||||
|
||||
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
|
||||
|
||||
When the module is enabled it will always be active, unless any of `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions.
|
||||
When the module is enabled it will always be active, unless any of `detect_env_vars`, `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions or one of the environmatal variable has been set.
|
||||
|
||||
:::
|
||||
|
||||
@ -2466,6 +2506,7 @@ The `context_aliases` and `user_aliases` options are deprecated. Use `contexts`
|
||||
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `[]` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this modules. |
|
||||
| `detect_env_vars` | `[]` | Which environmental variables should trigger this module |
|
||||
| `contexts` | `[]` | Customized styles and symbols for specific contexts. |
|
||||
| `disabled` | `true` | Disables the `kubernetes` module. |
|
||||
|
||||
@ -2768,6 +2809,35 @@ truncation_length = 4
|
||||
truncation_symbol = ''
|
||||
```
|
||||
|
||||
## NATS
|
||||
|
||||
The `nats` module shows the name of the current [NATS](https://nats.io) context.
|
||||
|
||||
### Options
|
||||
|
||||
| Option | Default | Description |
|
||||
| ---------- | -------------------------- | ------------------------------------------------------------ |
|
||||
| `symbol` | `'✉️ '` | The symbol used before the NATS context (defaults to empty). |
|
||||
| `style` | `'bold purple'` | The style for the module. |
|
||||
| `format` | `'[$symbol$name]($style)'` | The format for the module. |
|
||||
| `disabled` | `false` | Disables the `nats` module. |
|
||||
|
||||
### Variables
|
||||
|
||||
| Variable | Example | Description |
|
||||
| --------- | ----------- | ------------------------------------ |
|
||||
| name | `localhost` | The name of the NATS context |
|
||||
| symbol | | Mirrors the value of option `symbol` |
|
||||
| style\* | | Mirrors the value of option `style` |
|
||||
|
||||
### Example
|
||||
|
||||
```toml
|
||||
[nats]
|
||||
format = '[$symbol]($style)'
|
||||
style = 'bold purple'
|
||||
```
|
||||
|
||||
## Nim
|
||||
|
||||
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2943,6 +3013,43 @@ The `ocaml` module shows the currently installed version of [OCaml](https://ocam
|
||||
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. By default the module will be shown if the current directory contains a `.rego` file.
|
||||
@ -3811,7 +3918,7 @@ format = '$shlvl level(s) down'
|
||||
threshold = 3
|
||||
```
|
||||
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceeding characters are provided by `shlvl`.
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceding characters are provided by `shlvl`.
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
@ -4241,6 +4348,7 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
|
||||
| `format` | `'[$user]($style) in '` | The format for the module. |
|
||||
| `show_always` | `false` | Always shows the `username` module. |
|
||||
| `disabled` | `false` | Disables the `username` module. |
|
||||
| `aliases` | `{}` | Translate system usernames to something else |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -4262,6 +4370,7 @@ style_root = 'black bold'
|
||||
format = 'user: [$user]($style) '
|
||||
disabled = false
|
||||
show_always = true
|
||||
aliases = { "corpuser034g" = "matchai" }
|
||||
```
|
||||
|
||||
#### Hide the hostname in remote tmux sessions
|
||||
|
||||
@ -123,7 +123,7 @@ sh -c 'rm "$(command -v 'starship')"'
|
||||
|
||||
## How do I install Starship without `sudo`?
|
||||
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation directory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
|
||||
For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
|
||||
|
||||
|
||||
@ -431,6 +431,8 @@ Please check out these previous works that helped inspire the creation of starsh
|
||||
|
||||
Support this project by [becoming a sponsor](https://github.com/sponsors/starship). Your name or logo will show up here with a link to your website.
|
||||
|
||||
- Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org)
|
||||
|
||||
<p align="center">
|
||||
<br>
|
||||
<img width="100" src="https://raw.githubusercontent.com/starship/starship/master/media/icon.png" alt="Starship rocket icon">
|
||||
|
||||
@ -45,7 +45,7 @@ On Funtoo Linux, starship can be installed from [core-kit](https://github.com/fu
|
||||
emerge app-shells/starship
|
||||
```
|
||||
|
||||
## [Nix](https://nixos.wiki/wiki/Nix)
|
||||
## [Nix](https://wiki.nixos.org/wiki/Nix)
|
||||
|
||||
### Getting the Binary
|
||||
|
||||
|
||||
@ -25,6 +25,20 @@ metaTitle: "Starship: Cross-Shell Prompt"
|
||||
description: Starship is the minimal, blazing fast, and extremely customizable prompt for any shell! Shows the information you need, while staying sleek and minimal. Quick installation available for Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, and PowerShell.
|
||||
---
|
||||
|
||||
<script setup>
|
||||
import { onMounted } from 'vue'
|
||||
|
||||
onMounted(() => {
|
||||
const urlParams = new URLSearchParams(window.location.search)
|
||||
if (urlParams.has('uwu') || urlParams.has('kawaii')) {
|
||||
const img = document.querySelector('.VPHero .VPImage.image-src')
|
||||
img.classList.add('uwu')
|
||||
img.src = '/logo-uwu.png'
|
||||
img.alt = 'Kawaii Starship Logo by @sawaratsuki1004'
|
||||
}
|
||||
})
|
||||
</script>
|
||||
|
||||
<video class="demo-video" muted autoplay loop playsinline>
|
||||
<source src="/demo.webm" type="video/webm">
|
||||
<source src="/demo.mp4" type="video/mp4">
|
||||
|
||||
@ -84,20 +84,20 @@ enable_transience
|
||||
|
||||
The [Ble.sh](https://github.com/akinomyoga/ble.sh) framework at v0.4 or higher allows you to replace the previous-printed prompt with custom strings. This is useful in cases where all the prompt information is not always needed. To enable this, put this in `~/.bashrc` `bleopt prompt_ps1_transient=<value>`:
|
||||
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and this option has a non-empty value, the prompt specified by `PS1` is erased on leaving the current command line. If the value contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in the value and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and the option `prompt_ps1_transient` has a non-empty \<value\>, the prompt specified by `PS1` is erased on leaving the current command line. If \<value\> contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in \<value\> and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
|
||||
Make the following changes to your `~/.bashrc` to customize what gets displayed on the left and on the right:
|
||||
Make the following changes to your `~/.blerc` (or in `~/.config/blesh/init.sh`) to customize what gets displayed on the left and on the right:
|
||||
|
||||
- To customize what the left side of input gets replaced with, configure the `prompt_ps1_final` Ble.sh option. For example, to display Starship's `character` module here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_ps1_final="$(starship module character)"
|
||||
bleopt prompt_ps1_final='$(starship module character)'
|
||||
```
|
||||
|
||||
- To customize what the right side of input gets replaced with, configure the `prompt_rps1_final` Ble.sh option. For example, to display the time at which the last command was started here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_rps1_final="$(starship module time)"
|
||||
bleopt prompt_rps1_final='$(starship module time)'
|
||||
```
|
||||
|
||||
## Custom pre-prompt and pre-execution Commands in Cmd
|
||||
@ -266,7 +266,7 @@ Note: Continuation prompts are only available in the following shells:
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
# A continuation prompt that displays two filled in arrows
|
||||
# A continuation prompt that displays two filled-in arrows
|
||||
continuation_prompt = '▶▶ '
|
||||
```
|
||||
|
||||
@ -301,6 +301,6 @@ If multiple colors are specified for foreground/background, the last one in the
|
||||
|
||||
Not every style string will be displayed correctly by every terminal. In particular, the following known quirks exist:
|
||||
|
||||
- Many terminals disable support for `blink` by default
|
||||
- Many terminals disable support for `blink` by default.
|
||||
- `hidden` is [not supported on iTerm](https://gitlab.com/gnachman/iterm2/-/issues/4564).
|
||||
- `strikethrough` is not supported by the default macOS Terminal.app
|
||||
- `strikethrough` is not supported by the default macOS Terminal.app.
|
||||
|
||||
@ -281,6 +281,7 @@ $elixir\
|
||||
$elm\
|
||||
$erlang\
|
||||
$fennel\
|
||||
$gleam\
|
||||
$golang\
|
||||
$guix_shell\
|
||||
$haskell\
|
||||
@ -324,6 +325,7 @@ $aws\
|
||||
$gcloud\
|
||||
$openstack\
|
||||
$azure\
|
||||
$nats\
|
||||
$direnv\
|
||||
$env_var\
|
||||
$crystal\
|
||||
@ -601,7 +603,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
|
||||
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | The format for the module. |
|
||||
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'🍞 '` | A format string representing the symbol of Bun. |
|
||||
| `symbol` | `'🥟 '` | A format string representing the symbol of Bun. |
|
||||
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['bun.lockb', 'bunfig.toml']` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this module. |
|
||||
@ -1966,6 +1968,44 @@ Use Windows Starship executable on Windows paths in WSL
|
||||
windows_starship = '/mnt/c/Users/username/scoop/apps/starship/current/starship.exe'
|
||||
```
|
||||
|
||||
## Gleam
|
||||
|
||||
The `gleam` module shows the currently installed version of [Gleam](https://gleam.run/). By default the module will be shown if any of the following conditions are met:
|
||||
|
||||
- The current directory contains a `gleam.toml` file
|
||||
- The current directory contains a file with the `.gleam` extension
|
||||
|
||||
### Options
|
||||
|
||||
| Option | Default | Description |
|
||||
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | The format for the module. |
|
||||
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'⭐ '` | A format string representing the symbol of Go. |
|
||||
| `detect_extensions` | `['gleam']` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['gleam.toml']` | Which filenames should trigger this module. |
|
||||
| `style` | `'bold #FFAFF3'` | The style for the module. |
|
||||
| `disabled` | `false` | Disables the `gleam` module. |
|
||||
|
||||
### Variables
|
||||
|
||||
| Variable | Example | Description |
|
||||
| --------- | -------- | ------------------------------------ |
|
||||
| version | `v1.0.0` | The version of `gleam` |
|
||||
| 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
|
||||
|
||||
[gleam]
|
||||
format = 'via [⭐ $version](bold red) '
|
||||
```
|
||||
|
||||
## Go
|
||||
|
||||
The `golang` module shows the currently installed version of [Go](https://golang.org/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2444,7 +2484,7 @@ Displays the current [Kubernetes context](https://kubernetes.io/docs/concepts/co
|
||||
|
||||
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
|
||||
|
||||
When the module is enabled it will always be active, unless any of `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions.
|
||||
When the module is enabled it will always be active, unless any of `detect_env_vars`, `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions or one of the environmatal variable has been set.
|
||||
|
||||
:::
|
||||
|
||||
@ -2466,6 +2506,7 @@ The `context_aliases` and `user_aliases` options are deprecated. Use `contexts`
|
||||
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `[]` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this modules. |
|
||||
| `detect_env_vars` | `[]` | Which environmental variables should trigger this module |
|
||||
| `contexts` | `[]` | Customized styles and symbols for specific contexts. |
|
||||
| `disabled` | `true` | Disables the `kubernetes` module. |
|
||||
|
||||
@ -2768,6 +2809,35 @@ truncation_length = 4
|
||||
truncation_symbol = ''
|
||||
```
|
||||
|
||||
## NATS
|
||||
|
||||
The `nats` module shows the name of the current [NATS](https://nats.io) context.
|
||||
|
||||
### Options
|
||||
|
||||
| Option | Default | Description |
|
||||
| ---------- | -------------------------- | ------------------------------------------------------------ |
|
||||
| `symbol` | `'✉️ '` | The symbol used before the NATS context (defaults to empty). |
|
||||
| `style` | `'bold purple'` | The style for the module. |
|
||||
| `format` | `'[$symbol$name]($style)'` | The format for the module. |
|
||||
| `disabled` | `false` | Disables the `nats` module. |
|
||||
|
||||
### Variables
|
||||
|
||||
| Variable | Example | Description |
|
||||
| --------- | ----------- | ------------------------------------ |
|
||||
| name | `localhost` | The name of the NATS context |
|
||||
| symbol | | Mirrors the value of option `symbol` |
|
||||
| style\* | | Mirrors the value of option `style` |
|
||||
|
||||
### Example
|
||||
|
||||
```toml
|
||||
[nats]
|
||||
format = '[$symbol]($style)'
|
||||
style = 'bold purple'
|
||||
```
|
||||
|
||||
## Nim
|
||||
|
||||
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2943,6 +3013,43 @@ The `ocaml` module shows the currently installed version of [OCaml](https://ocam
|
||||
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. By default the module will be shown if the current directory contains a `.rego` file.
|
||||
@ -3811,7 +3918,7 @@ format = '$shlvl level(s) down'
|
||||
threshold = 3
|
||||
```
|
||||
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceeding characters are provided by `shlvl`.
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceding characters are provided by `shlvl`.
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
@ -4241,6 +4348,7 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
|
||||
| `format` | `'[$user]($style) in '` | The format for the module. |
|
||||
| `show_always` | `false` | Always shows the `username` module. |
|
||||
| `disabled` | `false` | Disables the `username` module. |
|
||||
| `aliases` | `{}` | Translate system usernames to something else |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -4262,6 +4370,7 @@ style_root = 'black bold'
|
||||
format = 'user: [$user]($style) '
|
||||
disabled = false
|
||||
show_always = true
|
||||
aliases = { "corpuser034g" = "matchai" }
|
||||
```
|
||||
|
||||
#### Hide the hostname in remote tmux sessions
|
||||
|
||||
@ -123,7 +123,7 @@ sh -c 'rm "$(command -v 'starship')"'
|
||||
|
||||
## How do I install Starship without `sudo`?
|
||||
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation directory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
|
||||
For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
|
||||
|
||||
|
||||
@ -431,6 +431,8 @@ Please check out these previous works that helped inspire the creation of starsh
|
||||
|
||||
Support this project by [becoming a sponsor](https://github.com/sponsors/starship). Your name or logo will show up here with a link to your website.
|
||||
|
||||
- Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org)
|
||||
|
||||
<p align="center">
|
||||
<br>
|
||||
<img width="100" src="https://raw.githubusercontent.com/starship/starship/master/media/icon.png" alt="Starship rocket icon">
|
||||
|
||||
@ -45,7 +45,7 @@ On Funtoo Linux, starship can be installed from [core-kit](https://github.com/fu
|
||||
emerge app-shells/starship
|
||||
```
|
||||
|
||||
## [Nix](https://nixos.wiki/wiki/Nix)
|
||||
## [Nix](https://wiki.nixos.org/wiki/Nix)
|
||||
|
||||
### Getting the Binary
|
||||
|
||||
|
||||
@ -25,6 +25,20 @@ metaTitle: "Starship: Wiersz poleceń dla dowolnej powłoki"
|
||||
description: Starship to minimalny, szybki i ekstremalnie konfigurowalny wiersz poleceń dla każdej powłoki! Pokazuje informacje których potrzebujesz, pozostając elegancki i minimalny. Szybka instalacja dostępna dla powłok Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd i PowerShell.
|
||||
---
|
||||
|
||||
<script setup>
|
||||
import { onMounted } from 'vue'
|
||||
|
||||
onMounted(() => {
|
||||
const urlParams = new URLSearchParams(window.location.search)
|
||||
if (urlParams.has('uwu') || urlParams.has('kawaii')) {
|
||||
const img = document.querySelector('.VPHero .VPImage.image-src')
|
||||
img.classList.add('uwu')
|
||||
img.src = '/logo-uwu.png'
|
||||
img.alt = 'Kawaii Starship Logo by @sawaratsuki1004'
|
||||
}
|
||||
})
|
||||
</script>
|
||||
|
||||
<video class="demo-video" muted autoplay loop playsinline>
|
||||
<source src="/demo.webm" type="video/webm">
|
||||
<source src="/demo.mp4" type="video/mp4">
|
||||
|
||||
@ -84,20 +84,20 @@ enable_transience
|
||||
|
||||
The [Ble.sh](https://github.com/akinomyoga/ble.sh) framework at v0.4 or higher allows you to replace the previous-printed prompt with custom strings. This is useful in cases where all the prompt information is not always needed. To enable this, put this in `~/.bashrc` `bleopt prompt_ps1_transient=<value>`:
|
||||
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and this option has a non-empty value, the prompt specified by `PS1` is erased on leaving the current command line. If the value contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in the value and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and the option `prompt_ps1_transient` has a non-empty \<value\>, the prompt specified by `PS1` is erased on leaving the current command line. If \<value\> contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in \<value\> and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
|
||||
Make the following changes to your `~/.bashrc` to customize what gets displayed on the left and on the right:
|
||||
Make the following changes to your `~/.blerc` (or in `~/.config/blesh/init.sh`) to customize what gets displayed on the left and on the right:
|
||||
|
||||
- To customize what the left side of input gets replaced with, configure the `prompt_ps1_final` Ble.sh option. For example, to display Starship's `character` module here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_ps1_final="$(starship module character)"
|
||||
bleopt prompt_ps1_final='$(starship module character)'
|
||||
```
|
||||
|
||||
- To customize what the right side of input gets replaced with, configure the `prompt_rps1_final` Ble.sh option. For example, to display the time at which the last command was started here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_rps1_final="$(starship module time)"
|
||||
bleopt prompt_rps1_final='$(starship module time)'
|
||||
```
|
||||
|
||||
## Custom pre-prompt and pre-execution Commands in Cmd
|
||||
@ -266,7 +266,7 @@ Note: Continuation prompts are only available in the following shells:
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
# A continuation prompt that displays two filled in arrows
|
||||
# A continuation prompt that displays two filled-in arrows
|
||||
continuation_prompt = '▶▶ '
|
||||
```
|
||||
|
||||
@ -301,6 +301,6 @@ If multiple colors are specified for foreground/background, the last one in the
|
||||
|
||||
Not every style string will be displayed correctly by every terminal. In particular, the following known quirks exist:
|
||||
|
||||
- Many terminals disable support for `blink` by default
|
||||
- Many terminals disable support for `blink` by default.
|
||||
- `hidden` is [not supported on iTerm](https://gitlab.com/gnachman/iterm2/-/issues/4564).
|
||||
- `strikethrough` is not supported by the default macOS Terminal.app
|
||||
- `strikethrough` is not supported by the default macOS Terminal.app.
|
||||
|
||||
@ -281,6 +281,7 @@ $elixir\
|
||||
$elm\
|
||||
$erlang\
|
||||
$fennel\
|
||||
$gleam\
|
||||
$golang\
|
||||
$guix_shell\
|
||||
$haskell\
|
||||
@ -324,6 +325,7 @@ $aws\
|
||||
$gcloud\
|
||||
$openstack\
|
||||
$azure\
|
||||
$nats\
|
||||
$direnv\
|
||||
$env_var\
|
||||
$crystal\
|
||||
@ -601,7 +603,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
|
||||
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | The format for the module. |
|
||||
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'🍞 '` | A format string representing the symbol of Bun. |
|
||||
| `symbol` | `'🥟 '` | A format string representing the symbol of Bun. |
|
||||
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['bun.lockb', 'bunfig.toml']` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this module. |
|
||||
@ -1966,6 +1968,44 @@ Use Windows Starship executable on Windows paths in WSL
|
||||
windows_starship = '/mnt/c/Users/username/scoop/apps/starship/current/starship.exe'
|
||||
```
|
||||
|
||||
## Gleam
|
||||
|
||||
The `gleam` module shows the currently installed version of [Gleam](https://gleam.run/). By default the module will be shown if any of the following conditions are met:
|
||||
|
||||
- The current directory contains a `gleam.toml` file
|
||||
- The current directory contains a file with the `.gleam` extension
|
||||
|
||||
### Options
|
||||
|
||||
| Option | Default | Description |
|
||||
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | The format for the module. |
|
||||
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'⭐ '` | A format string representing the symbol of Go. |
|
||||
| `detect_extensions` | `['gleam']` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['gleam.toml']` | Which filenames should trigger this module. |
|
||||
| `style` | `'bold #FFAFF3'` | The style for the module. |
|
||||
| `disabled` | `false` | Disables the `gleam` module. |
|
||||
|
||||
### Variables
|
||||
|
||||
| Zmienne | Example | Description |
|
||||
| --------- | -------- | ------------------------------------ |
|
||||
| version | `v1.0.0` | The version of `gleam` |
|
||||
| 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
|
||||
|
||||
[gleam]
|
||||
format = 'via [⭐ $version](bold red) '
|
||||
```
|
||||
|
||||
## Go
|
||||
|
||||
The `golang` module shows the currently installed version of [Go](https://golang.org/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2444,7 +2484,7 @@ Displays the current [Kubernetes context](https://kubernetes.io/docs/concepts/co
|
||||
|
||||
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
|
||||
|
||||
When the module is enabled it will always be active, unless any of `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions.
|
||||
When the module is enabled it will always be active, unless any of `detect_env_vars`, `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions or one of the environmatal variable has been set.
|
||||
|
||||
:::
|
||||
|
||||
@ -2466,6 +2506,7 @@ The `context_aliases` and `user_aliases` options are deprecated. Use `contexts`
|
||||
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `[]` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this modules. |
|
||||
| `detect_env_vars` | `[]` | Which environmental variables should trigger this module |
|
||||
| `contexts` | `[]` | Customized styles and symbols for specific contexts. |
|
||||
| `disabled` | `true` | Disables the `kubernetes` module. |
|
||||
|
||||
@ -2768,6 +2809,35 @@ truncation_length = 4
|
||||
truncation_symbol = ''
|
||||
```
|
||||
|
||||
## NATS
|
||||
|
||||
The `nats` module shows the name of the current [NATS](https://nats.io) context.
|
||||
|
||||
### Options
|
||||
|
||||
| Option | Default | Description |
|
||||
| ---------- | -------------------------- | ------------------------------------------------------------ |
|
||||
| `symbol` | `'✉️ '` | The symbol used before the NATS context (defaults to empty). |
|
||||
| `style` | `'bold purple'` | The style for the module. |
|
||||
| `format` | `'[$symbol$name]($style)'` | The format for the module. |
|
||||
| `disabled` | `false` | Disables the `nats` module. |
|
||||
|
||||
### Variables
|
||||
|
||||
| Zmienne | Example | Description |
|
||||
| --------- | ----------- | ------------------------------------ |
|
||||
| name | `localhost` | The name of the NATS context |
|
||||
| symbol | | Mirrors the value of option `symbol` |
|
||||
| style\* | | Mirrors the value of option `style` |
|
||||
|
||||
### Example
|
||||
|
||||
```toml
|
||||
[nats]
|
||||
format = '[$symbol]($style)'
|
||||
style = 'bold purple'
|
||||
```
|
||||
|
||||
## Nim
|
||||
|
||||
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2943,6 +3013,43 @@ The `ocaml` module shows the currently installed version of [OCaml](https://ocam
|
||||
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
|
||||
|
||||
| Zmienne | 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. By default the module will be shown if the current directory contains a `.rego` file.
|
||||
@ -3811,7 +3918,7 @@ format = '$shlvl level(s) down'
|
||||
threshold = 3
|
||||
```
|
||||
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceeding characters are provided by `shlvl`.
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceding characters are provided by `shlvl`.
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
@ -4241,6 +4348,7 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
|
||||
| `format` | `'[$user]($style) in '` | The format for the module. |
|
||||
| `show_always` | `false` | Always shows the `username` module. |
|
||||
| `disabled` | `false` | Disables the `username` module. |
|
||||
| `aliases` | `{}` | Translate system usernames to something else |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -4262,6 +4370,7 @@ style_root = 'black bold'
|
||||
format = 'user: [$user]($style) '
|
||||
disabled = false
|
||||
show_always = true
|
||||
aliases = { "corpuser034g" = "matchai" }
|
||||
```
|
||||
|
||||
#### Hide the hostname in remote tmux sessions
|
||||
|
||||
@ -123,7 +123,7 @@ sh -c 'rm "$(command -v 'starship')"'
|
||||
|
||||
## How do I install Starship without `sudo`?
|
||||
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation directory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
|
||||
For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
|
||||
|
||||
|
||||
@ -431,6 +431,8 @@ Zapoznaj się z wcześniejszymi projektami, które zainspirowały nas do stworze
|
||||
|
||||
Wspomóż ten projekt [stając się sponsorem](https://github.com/sponsors/starship). Twoja nazwa bądź logo pojawi się tutaj wraz z linkiem do Twojej witryny.
|
||||
|
||||
- Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org)
|
||||
|
||||
<p align="center">
|
||||
<br>
|
||||
<img width="100" src="https://raw.githubusercontent.com/starship/starship/master/media/icon.png" alt="Starship rocket icon">
|
||||
|
||||
@ -45,7 +45,7 @@ Na Funtoo Linux, starship może być zainstalowany przez Portage z [core-kit](ht
|
||||
emerge app-shells/starship
|
||||
```
|
||||
|
||||
## [Nix](https://nixos.wiki/wiki/Nix)
|
||||
## [Nix](https://wiki.nixos.org/wiki/Nix)
|
||||
|
||||
### Getting the Binary
|
||||
|
||||
|
||||
@ -25,6 +25,20 @@ metaTitle: "Starship: Cross-Shell Prompt"
|
||||
description: O Starship é o prompt minimalista, extremamente rápido e extremamente personalizável para qualquer shell! Mostra as informações que você precisa, mantendo-se elegante e minimalista. Instalação rápida disponível para Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd e PowerShell.
|
||||
---
|
||||
|
||||
<script setup>
|
||||
import { onMounted } from 'vue'
|
||||
|
||||
onMounted(() => {
|
||||
const urlParams = new URLSearchParams(window.location.search)
|
||||
if (urlParams.has('uwu') || urlParams.has('kawaii')) {
|
||||
const img = document.querySelector('.VPHero .VPImage.image-src')
|
||||
img.classList.add('uwu')
|
||||
img.src = '/logo-uwu.png'
|
||||
img.alt = 'Kawaii Starship Logo by @sawaratsuki1004'
|
||||
}
|
||||
})
|
||||
</script>
|
||||
|
||||
<video class="demo-video" muted autoplay loop playsinline>
|
||||
<source src="/demo.webm" type="video/webm">
|
||||
<source src="/demo.mp4" type="video/mp4">
|
||||
|
||||
@ -84,20 +84,20 @@ enable_transience
|
||||
|
||||
The [Ble.sh](https://github.com/akinomyoga/ble.sh) framework at v0.4 or higher allows you to replace the previous-printed prompt with custom strings. Isso é útil em casos onde nem sempre todas as informações do prompt são necessárias. Para habilitar isso, coloque em `~/.bashrc` `bleopt prompt_ps1_transient=<value>`:
|
||||
|
||||
O \<value\> aqui é uma lista separada por dois pontos de `always`, `same-dir` e `trim`. Quando `prompt_ps1_final` está vazio e esta opção tem um valor não-vazio, o prompt especificado pelo `PS1` é apagado ao sair da linha de comando atual. Se o valor contém um campo `trim`, apenas a última linha de multilinha `PS1` é preservada e as outras linhas são apagadas. Caso contrário, a linha de comando será redesenhada como se `PS1=` fosse especificado. Quando um campo `same-dir` está contido no valor e o diretório de trabalho atual difere do diretório final da linha de comando anterior, esta opção `prompt_ps1_transient` é ignorada.
|
||||
O \<value\> aqui é uma lista separada por dois pontos de `always`, `same-dir` e `trim`. When `prompt_ps1_final` is empty and the option `prompt_ps1_transient` has a non-empty \<value\>, the prompt specified by `PS1` is erased on leaving the current command line. If \<value\> contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Caso contrário, a linha de comando será redesenhada como se `PS1=` fosse especificado. When a field `same-dir` is contained in \<value\> and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
|
||||
Faça as seguintes alterações no seu `~/.bashrc` para personalizar o que é exibido à esquerda e à direita:
|
||||
Make the following changes to your `~/.blerc` (or in `~/.config/blesh/init.sh`) to customize what gets displayed on the left and on the right:
|
||||
|
||||
- Para personalizar o que o lado esquerdo do valor de entrada é substituído, configure a opção `prompt_ps1_final` Ble.sh. Por exemplo, para exibir o caractere da `Starship` aqui, você faria
|
||||
|
||||
```bash
|
||||
bleopt prompt_ps1_final="$(starship module character)"
|
||||
bleopt prompt_ps1_final='$(starship module character)'
|
||||
```
|
||||
|
||||
- Para personalizar o que o lado direito de entrada é substituído, configure a opção `prompt_rps1_final` Ble.sh. Por exemplo, para exibir o momento em que o último comando foi iniciado, você faria
|
||||
|
||||
```bash
|
||||
bleopt prompt_rps1_final="$(starship module time)"
|
||||
bleopt prompt_rps1_final='$(starship module time)'
|
||||
```
|
||||
|
||||
## Comandos personalizados de pré-prompt e pré-execução no Cmd
|
||||
@ -266,7 +266,7 @@ Nota: os prompts de continuação estão disponíveis apenas nos seguintes shell
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
# Um prompt de continuação que exibe duas setas preenchidas
|
||||
# A continuation prompt that displays two filled-in arrows
|
||||
continuation_prompt = '▶▶ '
|
||||
```
|
||||
|
||||
@ -301,6 +301,6 @@ Se várias cores forem especificadas para primeiro plano/plano de fundo, a últi
|
||||
|
||||
Nem todas os estilos de string serão exibidos corretamente em todos terminais. Em particular, existem os seguintes erros conhecidos:
|
||||
|
||||
- Muitos terminais desabilitam por padrão o suporte ao `blink`
|
||||
- Muitos terminais desabilitam por padrão o suporte ao `blink`.
|
||||
- `hidden` não é [ suportado no iTerm](https://gitlab.com/gnachman/iterm2/-/issues/4564).
|
||||
- `strikethrough` não é suportado por padrão no aplicativo de terminal do macOS
|
||||
- `strikethrough` não é suportado por padrão no aplicativo de terminal do macOS.
|
||||
|
||||
@ -281,6 +281,7 @@ $elixir\
|
||||
$elm\
|
||||
$erlang\
|
||||
$fennel\
|
||||
$gleam\
|
||||
$golang\
|
||||
$guix_shell\
|
||||
$haskell\
|
||||
@ -324,6 +325,7 @@ $aws\
|
||||
$gcloud\
|
||||
$openstack\
|
||||
$azure\
|
||||
$nats\
|
||||
$direnv\
|
||||
$env_var\
|
||||
$crystal\
|
||||
@ -601,7 +603,7 @@ O módulo `bun` mostra a versão atualmente instalada do [bun](https://bun.sh) r
|
||||
| ------------------- | ------------------------------------ | ----------------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | O formato do módulo. |
|
||||
| `version_format` | `'v${raw}'` | A versão formatada. As variáveis disponíveis são `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'🍞 '` | Uma string de formato que representa o símbolo do Bun. |
|
||||
| `symbol` | `'🥟 '` | Uma string de formato que representa o símbolo do Bun. |
|
||||
| `detect_extensions` | `[]` | Quais extensões devem ativar este módulo. |
|
||||
| `detect_files` | `['bun.lockb', 'bunfig.toml']` | Quais nomes de arquivos devem ativar este módulo. |
|
||||
| `detect_folders` | `[]` | Quais pastas devem ativar este módulo. |
|
||||
@ -1966,6 +1968,44 @@ Use o executável do Windows Starship em caminhos do Windows em WSL
|
||||
windows_starship = '/mnt/c/Users/nomedousuario/scoop/apps/starship/current/starship.exe'
|
||||
```
|
||||
|
||||
## Gleam
|
||||
|
||||
The `gleam` module shows the currently installed version of [Gleam](https://gleam.run/). Por padrão o módulo vai exibir se uma das condições a seguir for atendida:
|
||||
|
||||
- The current directory contains a `gleam.toml` file
|
||||
- The current directory contains a file with the `.gleam` extension
|
||||
|
||||
### Opções
|
||||
|
||||
| Opções | Padrão | Descrição |
|
||||
| ------------------- | ------------------------------------ | ----------------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | O formato do módulo. |
|
||||
| `version_format` | `'v${raw}'` | A versão formatada. As variáveis disponíveis são `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'⭐ '` | O formato da string que representa o simbolo do Go. |
|
||||
| `detect_extensions` | `['gleam']` | Quais extensões devem ativar este módulo. |
|
||||
| `detect_files` | `['gleam.toml']` | Quais nomes de arquivos devem ativar este módulo. |
|
||||
| `style` | `'bold #FFAFF3'` | O estilo do módulo. |
|
||||
| `disabled` | `false` | Disables the `gleam` module. |
|
||||
|
||||
### Variáveis
|
||||
|
||||
| Variável | Exemplo | Descrição |
|
||||
| --------- | -------- | --------------------------------- |
|
||||
| version | `v1.0.0` | The version of `gleam` |
|
||||
| symbol | | Espelha o valor da opção `symbol` |
|
||||
| style\* | | Espelha o valor da opção `style` |
|
||||
|
||||
*: Esta variável só pode ser usada como parte de uma string de estilo
|
||||
|
||||
### Exemplo
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
[gleam]
|
||||
format = 'via [⭐ $version](bold red) '
|
||||
```
|
||||
|
||||
## Go
|
||||
|
||||
O módulo `golang` exibe a versão instalada atual do [Go](https://golang.org/). Por padrão o módulo vai exibir se uma das condições a seguir for atendida:
|
||||
@ -2444,7 +2484,7 @@ Exibe o nome atual do [Kubernetes context](https://kubernetes.io/docs/concepts/c
|
||||
|
||||
Este módulo é desabilitado por padrão. Para habilitar, defina `disabled` para `false` no seu arquivo de configuração.
|
||||
|
||||
When the module is enabled it will always be active, unless any of `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions.
|
||||
When the module is enabled it will always be active, unless any of `detect_env_vars`, `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions or one of the environmatal variable has been set.
|
||||
|
||||
:::
|
||||
|
||||
@ -2466,6 +2506,7 @@ The `context_aliases` and `user_aliases` options are deprecated. Use `contexts`
|
||||
| `detect_extensions` | `[]` | Quais extensões devem ativar este módulo. |
|
||||
| `detect_files` | `[]` | Quais nomes de arquivos devem ativar este módulo. |
|
||||
| `detect_folders` | `[]` | Quais pastas devem ativar este módulo. |
|
||||
| `detect_env_vars` | `[]` | Which environmental variables should trigger this module |
|
||||
| `contexts` | `[]` | Customized styles and symbols for specific contexts. |
|
||||
| `disabled` | `true` | Desabilita o módulo `kubernetes`. |
|
||||
|
||||
@ -2768,6 +2809,35 @@ truncation_length = 4
|
||||
truncation_symbol = ''
|
||||
```
|
||||
|
||||
## NATS
|
||||
|
||||
The `nats` module shows the name of the current [NATS](https://nats.io) context.
|
||||
|
||||
### Opções
|
||||
|
||||
| Opções | Padrão | Descrição |
|
||||
| ---------- | -------------------------- | ------------------------------------------------------------ |
|
||||
| `symbol` | `'✉️ '` | The symbol used before the NATS context (defaults to empty). |
|
||||
| `style` | `'bold purple'` | O estilo do módulo. |
|
||||
| `format` | `'[$symbol$name]($style)'` | O formato do módulo. |
|
||||
| `disabled` | `false` | Disables the `nats` module. |
|
||||
|
||||
### Variáveis
|
||||
|
||||
| Variável | Exemplo | Descrição |
|
||||
| --------- | ----------- | --------------------------------- |
|
||||
| name | `localhost` | The name of the NATS context |
|
||||
| symbol | | Espelha o valor da opção `symbol` |
|
||||
| style\* | | Espelha o valor da opção `style` |
|
||||
|
||||
### Exemplo
|
||||
|
||||
```toml
|
||||
[nats]
|
||||
format = '[$symbol]($style)'
|
||||
style = 'bold purple'
|
||||
```
|
||||
|
||||
## Nim
|
||||
|
||||
O módulo `nim` exibe a versão atual instalada do [Nim](https://nim-lang.org/). Por padrão o módulo vai exibir se uma das condições a seguir for atendida:
|
||||
@ -2943,6 +3013,43 @@ O módulo `ocaml` exibe a versão atual instalada do [OCaml](https://ocaml.org/)
|
||||
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.
|
||||
|
||||
### Opções
|
||||
|
||||
| Opções | Padrão | Descrição |
|
||||
| ------------------- | ------------------------------------ | ------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | O formato do módulo. |
|
||||
| `show_commit` | `false` | Shows the commit as part of the version. |
|
||||
| `symbol` | `'Ø '` | O símbolo usado antes de exibir a versão do Zig. |
|
||||
| `style` | `'bold bright-blue'` | O estilo do módulo. |
|
||||
| `disabled` | `false` | Disables the `odin` module. |
|
||||
| `detect_extensions` | `['odin']` | Quais extensões devem ativar este módulo. |
|
||||
| `detect_files` | `[]` | Quais nomes de arquivos devem ativar este módulo. |
|
||||
| `detect_folders` | `[]` | Quais pastas devem ativar este módulo. |
|
||||
|
||||
### Variáveis
|
||||
|
||||
| Variável | Exemplo | Descrição |
|
||||
| --------- | ------------- | --------------------------------- |
|
||||
| version | `dev-2024-03` | The version of `odin` |
|
||||
| symbol | | Espelha o valor da opção `symbol` |
|
||||
| style\* | | Espelha o valor da opção `style` |
|
||||
|
||||
*: Esta variável só pode ser usada como parte de uma string de estilo
|
||||
|
||||
### Exemplo
|
||||
|
||||
```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. By default the module will be shown if the current directory contains a `.rego` file.
|
||||
@ -3811,7 +3918,7 @@ format = '$shlvl level(s) down'
|
||||
threshold = 3
|
||||
```
|
||||
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceeding characters are provided by `shlvl`.
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceding characters are provided by `shlvl`.
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
@ -4241,6 +4348,7 @@ Conexões SSH são detectadas checando as variáveis de ambiente `SSH_CONNECTION
|
||||
| `format` | `'[$user]($style) in '` | O formato do módulo. |
|
||||
| `show_always` | `false` | Sempre exibe o módulo `username`. |
|
||||
| `disabled` | `false` | Desabilita o módulo `username`. |
|
||||
| `aliases` | `{}` | Translate system usernames to something else |
|
||||
|
||||
### Variáveis
|
||||
|
||||
@ -4262,6 +4370,7 @@ style_root = 'black bold'
|
||||
format = 'user: [$user]($style) '
|
||||
disabled = false
|
||||
show_always = true
|
||||
aliases = { "corpuser034g" = "matchai" }
|
||||
```
|
||||
|
||||
#### Hide the hostname in remote tmux sessions
|
||||
|
||||
@ -123,7 +123,7 @@ sh -c 'rm "$(command -v 'starship')"'
|
||||
|
||||
## How do I install Starship without `sudo`?
|
||||
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation directory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
|
||||
For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
|
||||
|
||||
|
||||
@ -431,6 +431,8 @@ Por favor, confira esses trabalhos anteriores que ajudaram a inspirar a criaçã
|
||||
|
||||
Apoie este projeto [tornando-se um patrocinador](https://github.com/sponsors/starship). O seu nome ou logotipo aparecerá aqui com um link para o seu site.
|
||||
|
||||
- Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org)
|
||||
|
||||
<p align="center">
|
||||
<br>
|
||||
<img width="100" src="https://raw.githubusercontent.com/starship/starship/master/media/icon.png" alt="Ícone de foguete do Starship">
|
||||
|
||||
@ -45,7 +45,7 @@ No Funtoo Linux, o starship pode ser instalado a partir do [core-kit](https://gi
|
||||
emerge app-shells/starship
|
||||
```
|
||||
|
||||
## [Nix](https://nixos.wiki/wiki/Nix)
|
||||
## [Nix](https://wiki.nixos.org/wiki/Nix)
|
||||
|
||||
### Obtendo o Binário
|
||||
|
||||
|
||||
@ -25,6 +25,20 @@ metaTitle: "Starship: Cross-Shell Prompt"
|
||||
description: Starship is the minimal, blazing fast, and extremely customizable prompt for any shell! Shows the information you need, while staying sleek and minimal. Quick installation available for Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, and PowerShell.
|
||||
---
|
||||
|
||||
<script setup>
|
||||
import { onMounted } from 'vue'
|
||||
|
||||
onMounted(() => {
|
||||
const urlParams = new URLSearchParams(window.location.search)
|
||||
if (urlParams.has('uwu') || urlParams.has('kawaii')) {
|
||||
const img = document.querySelector('.VPHero .VPImage.image-src')
|
||||
img.classList.add('uwu')
|
||||
img.src = '/logo-uwu.png'
|
||||
img.alt = 'Kawaii Starship Logo by @sawaratsuki1004'
|
||||
}
|
||||
})
|
||||
</script>
|
||||
|
||||
<video class="demo-video" muted autoplay loop playsinline>
|
||||
<source src="/demo.webm" type="video/webm">
|
||||
<source src="/demo.mp4" type="video/mp4">
|
||||
|
||||
@ -84,20 +84,20 @@ enable_transience
|
||||
|
||||
The [Ble.sh](https://github.com/akinomyoga/ble.sh) framework at v0.4 or higher allows you to replace the previous-printed prompt with custom strings. This is useful in cases where all the prompt information is not always needed. To enable this, put this in `~/.bashrc` `bleopt prompt_ps1_transient=<value>`:
|
||||
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and this option has a non-empty value, the prompt specified by `PS1` is erased on leaving the current command line. If the value contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in the value and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and the option `prompt_ps1_transient` has a non-empty \<value\>, the prompt specified by `PS1` is erased on leaving the current command line. If \<value\> contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in \<value\> and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
|
||||
Make the following changes to your `~/.bashrc` to customize what gets displayed on the left and on the right:
|
||||
Make the following changes to your `~/.blerc` (or in `~/.config/blesh/init.sh`) to customize what gets displayed on the left and on the right:
|
||||
|
||||
- To customize what the left side of input gets replaced with, configure the `prompt_ps1_final` Ble.sh option. For example, to display Starship's `character` module here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_ps1_final="$(starship module character)"
|
||||
bleopt prompt_ps1_final='$(starship module character)'
|
||||
```
|
||||
|
||||
- To customize what the right side of input gets replaced with, configure the `prompt_rps1_final` Ble.sh option. For example, to display the time at which the last command was started here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_rps1_final="$(starship module time)"
|
||||
bleopt prompt_rps1_final='$(starship module time)'
|
||||
```
|
||||
|
||||
## Custom pre-prompt and pre-execution Commands in Cmd
|
||||
@ -266,7 +266,7 @@ Note: Continuation prompts are only available in the following shells:
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
# A continuation prompt that displays two filled in arrows
|
||||
# A continuation prompt that displays two filled-in arrows
|
||||
continuation_prompt = '▶▶ '
|
||||
```
|
||||
|
||||
@ -301,6 +301,6 @@ If multiple colors are specified for foreground/background, the last one in the
|
||||
|
||||
Not every style string will be displayed correctly by every terminal. In particular, the following known quirks exist:
|
||||
|
||||
- Many terminals disable support for `blink` by default
|
||||
- Many terminals disable support for `blink` by default.
|
||||
- `hidden` is [not supported on iTerm](https://gitlab.com/gnachman/iterm2/-/issues/4564).
|
||||
- `strikethrough` is not supported by the default macOS Terminal.app
|
||||
- `strikethrough` is not supported by the default macOS Terminal.app.
|
||||
|
||||
@ -281,6 +281,7 @@ $elixir\
|
||||
$elm\
|
||||
$erlang\
|
||||
$fennel\
|
||||
$gleam\
|
||||
$golang\
|
||||
$guix_shell\
|
||||
$haskell\
|
||||
@ -324,6 +325,7 @@ $aws\
|
||||
$gcloud\
|
||||
$openstack\
|
||||
$azure\
|
||||
$nats\
|
||||
$direnv\
|
||||
$env_var\
|
||||
$crystal\
|
||||
@ -601,7 +603,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
|
||||
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | The format for the module. |
|
||||
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'🍞 '` | A format string representing the symbol of Bun. |
|
||||
| `symbol` | `'🥟 '` | A format string representing the symbol of Bun. |
|
||||
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['bun.lockb', 'bunfig.toml']` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this module. |
|
||||
@ -1966,6 +1968,44 @@ Use Windows Starship executable on Windows paths in WSL
|
||||
windows_starship = '/mnt/c/Users/username/scoop/apps/starship/current/starship.exe'
|
||||
```
|
||||
|
||||
## Gleam
|
||||
|
||||
The `gleam` module shows the currently installed version of [Gleam](https://gleam.run/). By default the module will be shown if any of the following conditions are met:
|
||||
|
||||
- The current directory contains a `gleam.toml` file
|
||||
- The current directory contains a file with the `.gleam` extension
|
||||
|
||||
### Options
|
||||
|
||||
| Option | Default | Description |
|
||||
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | The format for the module. |
|
||||
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'⭐ '` | A format string representing the symbol of Go. |
|
||||
| `detect_extensions` | `['gleam']` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['gleam.toml']` | Which filenames should trigger this module. |
|
||||
| `style` | `'bold #FFAFF3'` | The style for the module. |
|
||||
| `disabled` | `false` | Disables the `gleam` module. |
|
||||
|
||||
### Variables
|
||||
|
||||
| Variable | Example | Description |
|
||||
| --------- | -------- | ------------------------------------ |
|
||||
| version | `v1.0.0` | The version of `gleam` |
|
||||
| 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
|
||||
|
||||
[gleam]
|
||||
format = 'via [⭐ $version](bold red) '
|
||||
```
|
||||
|
||||
## Go
|
||||
|
||||
The `golang` module shows the currently installed version of [Go](https://golang.org/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2444,7 +2484,7 @@ Displays the current [Kubernetes context](https://kubernetes.io/docs/concepts/co
|
||||
|
||||
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
|
||||
|
||||
When the module is enabled it will always be active, unless any of `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions.
|
||||
When the module is enabled it will always be active, unless any of `detect_env_vars`, `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions or one of the environmatal variable has been set.
|
||||
|
||||
:::
|
||||
|
||||
@ -2466,6 +2506,7 @@ The `context_aliases` and `user_aliases` options are deprecated. Use `contexts`
|
||||
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `[]` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this modules. |
|
||||
| `detect_env_vars` | `[]` | Which environmental variables should trigger this module |
|
||||
| `contexts` | `[]` | Customized styles and symbols for specific contexts. |
|
||||
| `disabled` | `true` | Disables the `kubernetes` module. |
|
||||
|
||||
@ -2768,6 +2809,35 @@ truncation_length = 4
|
||||
truncation_symbol = ''
|
||||
```
|
||||
|
||||
## NATS
|
||||
|
||||
The `nats` module shows the name of the current [NATS](https://nats.io) context.
|
||||
|
||||
### Options
|
||||
|
||||
| Option | Default | Description |
|
||||
| ---------- | -------------------------- | ------------------------------------------------------------ |
|
||||
| `symbol` | `'✉️ '` | The symbol used before the NATS context (defaults to empty). |
|
||||
| `style` | `'bold purple'` | The style for the module. |
|
||||
| `format` | `'[$symbol$name]($style)'` | The format for the module. |
|
||||
| `disabled` | `false` | Disables the `nats` module. |
|
||||
|
||||
### Variables
|
||||
|
||||
| Variable | Example | Description |
|
||||
| --------- | ----------- | ------------------------------------ |
|
||||
| name | `localhost` | The name of the NATS context |
|
||||
| symbol | | Mirrors the value of option `symbol` |
|
||||
| style\* | | Mirrors the value of option `style` |
|
||||
|
||||
### Example
|
||||
|
||||
```toml
|
||||
[nats]
|
||||
format = '[$symbol]($style)'
|
||||
style = 'bold purple'
|
||||
```
|
||||
|
||||
## Nim
|
||||
|
||||
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2943,6 +3013,43 @@ The `ocaml` module shows the currently installed version of [OCaml](https://ocam
|
||||
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. By default the module will be shown if the current directory contains a `.rego` file.
|
||||
@ -3811,7 +3918,7 @@ format = '$shlvl level(s) down'
|
||||
threshold = 3
|
||||
```
|
||||
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceeding characters are provided by `shlvl`.
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceding characters are provided by `shlvl`.
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
@ -4241,6 +4348,7 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
|
||||
| `format` | `'[$user]($style) in '` | The format for the module. |
|
||||
| `show_always` | `false` | Always shows the `username` module. |
|
||||
| `disabled` | `false` | Disables the `username` module. |
|
||||
| `aliases` | `{}` | Translate system usernames to something else |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -4262,6 +4370,7 @@ style_root = 'black bold'
|
||||
format = 'user: [$user]($style) '
|
||||
disabled = false
|
||||
show_always = true
|
||||
aliases = { "corpuser034g" = "matchai" }
|
||||
```
|
||||
|
||||
#### Hide the hostname in remote tmux sessions
|
||||
|
||||
@ -123,7 +123,7 @@ sh -c 'rm "$(command -v 'starship')"'
|
||||
|
||||
## How do I install Starship without `sudo`?
|
||||
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation diretory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
The shell install script (`https://starship.rs/install.sh`) only attempts to use `sudo` if the target installation directory is not writable by the current user. The default installation directory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without `sudo`. For example, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` uses the `-b` command line option of the install script to set the installation directory to `~/.local/bin`.
|
||||
|
||||
For a non-interactive installation of Starship, don't forget to add the `-y` option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.
|
||||
|
||||
|
||||
@ -431,6 +431,8 @@ Please check out these previous works that helped inspire the creation of starsh
|
||||
|
||||
Support this project by [becoming a sponsor](https://github.com/sponsors/starship). Your name or logo will show up here with a link to your website.
|
||||
|
||||
- Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org)
|
||||
|
||||
<p align="center">
|
||||
<br>
|
||||
<img width="100" src="https://raw.githubusercontent.com/starship/starship/master/media/icon.png" alt="Starship rocket icon">
|
||||
|
||||
@ -45,7 +45,7 @@ On Funtoo Linux, starship can be installed from [core-kit](https://github.com/fu
|
||||
emerge app-shells/starship
|
||||
```
|
||||
|
||||
## [Nix](https://nixos.wiki/wiki/Nix)
|
||||
## [Nix](https://wiki.nixos.org/wiki/Nix)
|
||||
|
||||
### Getting the Binary
|
||||
|
||||
|
||||
@ -25,6 +25,20 @@ metaTitle: "Starship: Cross-Shell Prompt"
|
||||
description: Starship - минимальная, быстрая и бесконечная настраиваемая командная строка для любой оболочки! Показывает нужную вам информацию, оставаясь красивой и минималистичной. Быстрая установка доступна для Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, и PowerShell.
|
||||
---
|
||||
|
||||
<script setup>
|
||||
import { onMounted } from 'vue'
|
||||
|
||||
onMounted(() => {
|
||||
const urlParams = new URLSearchParams(window.location.search)
|
||||
if (urlParams.has('uwu') || urlParams.has('kawaii')) {
|
||||
const img = document.querySelector('.VPHero .VPImage.image-src')
|
||||
img.classList.add('uwu')
|
||||
img.src = '/logo-uwu.png'
|
||||
img.alt = 'Kawaii Starship Logo by @sawaratsuki1004'
|
||||
}
|
||||
})
|
||||
</script>
|
||||
|
||||
<video class="demo-video" muted autoplay loop playsinline>
|
||||
<source src="/demo.webm" type="video/webm">
|
||||
<source src="/demo.mp4" type="video/mp4">
|
||||
|
||||
@ -84,20 +84,20 @@ enable_transience
|
||||
|
||||
The [Ble.sh](https://github.com/akinomyoga/ble.sh) framework at v0.4 or higher allows you to replace the previous-printed prompt with custom strings. This is useful in cases where all the prompt information is not always needed. To enable this, put this in `~/.bashrc` `bleopt prompt_ps1_transient=<value>`:
|
||||
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and this option has a non-empty value, the prompt specified by `PS1` is erased on leaving the current command line. If the value contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in the value and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`. When `prompt_ps1_final` is empty and the option `prompt_ps1_transient` has a non-empty \<value\>, the prompt specified by `PS1` is erased on leaving the current command line. If \<value\> contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Otherwise, the command line will be redrawn as if `PS1=` is specified. When a field `same-dir` is contained in \<value\> and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored.
|
||||
|
||||
Make the following changes to your `~/.bashrc` to customize what gets displayed on the left and on the right:
|
||||
Make the following changes to your `~/.blerc` (or in `~/.config/blesh/init.sh`) to customize what gets displayed on the left and on the right:
|
||||
|
||||
- To customize what the left side of input gets replaced with, configure the `prompt_ps1_final` Ble.sh option. For example, to display Starship's `character` module here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_ps1_final="$(starship module character)"
|
||||
bleopt prompt_ps1_final='$(starship module character)'
|
||||
```
|
||||
|
||||
- To customize what the right side of input gets replaced with, configure the `prompt_rps1_final` Ble.sh option. For example, to display the time at which the last command was started here, you would do
|
||||
|
||||
```bash
|
||||
bleopt prompt_rps1_final="$(starship module time)"
|
||||
bleopt prompt_rps1_final='$(starship module time)'
|
||||
```
|
||||
|
||||
## Custom pre-prompt and pre-execution Commands in Cmd
|
||||
@ -266,7 +266,7 @@ Note: Continuation prompts are only available in the following shells:
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
# A continuation prompt that displays two filled in arrows
|
||||
# A continuation prompt that displays two filled-in arrows
|
||||
continuation_prompt = '▶▶ '
|
||||
```
|
||||
|
||||
@ -301,6 +301,6 @@ continuation_prompt = '▶▶ '
|
||||
|
||||
Не все строки стиля будут корректно отображаться в терминале. В частности, существуют следующие известные ошибки:
|
||||
|
||||
- Во многих терминалах по умолчанию отключена поддержка `blink`
|
||||
- Во многих терминалах по умолчанию отключена поддержка `blink`.
|
||||
- `hidden` [не поддерживается в iTerm](https://gitlab.com/gnachman/iterm2/-/issues/4564).
|
||||
- `strikethrough` по умолчанию не поддерживается в macOS Terminal.app
|
||||
- `strikethrough` по умолчанию не поддерживается в macOS Terminal.app.
|
||||
|
||||
@ -281,6 +281,7 @@ $elixir\
|
||||
$elm\
|
||||
$erlang\
|
||||
$fennel\
|
||||
$gleam\
|
||||
$golang\
|
||||
$guix_shell\
|
||||
$haskell\
|
||||
@ -324,6 +325,7 @@ $aws\
|
||||
$gcloud\
|
||||
$openstack\
|
||||
$azure\
|
||||
$nats\
|
||||
$direnv\
|
||||
$env_var\
|
||||
$crystal\
|
||||
@ -601,7 +603,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
|
||||
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | Формат модуля. |
|
||||
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'🍞 '` | A format string representing the symbol of Bun. |
|
||||
| `symbol` | `'🥟 '` | A format string representing the symbol of Bun. |
|
||||
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['bun.lockb', 'bunfig.toml']` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this module. |
|
||||
@ -1966,6 +1968,44 @@ Use Windows Starship executable on Windows paths in WSL
|
||||
windows_starship = '/mnt/c/Users/username/scoop/apps/starship/current/starship.exe'
|
||||
```
|
||||
|
||||
## Gleam
|
||||
|
||||
The `gleam` module shows the currently installed version of [Gleam](https://gleam.run/). By default the module will be shown if any of the following conditions are met:
|
||||
|
||||
- The current directory contains a `gleam.toml` file
|
||||
- The current directory contains a file with the `.gleam` extension
|
||||
|
||||
### Опции
|
||||
|
||||
| Параметр | По умолчанию | Описание |
|
||||
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | Формат модуля. |
|
||||
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
|
||||
| `symbol` | `'⭐ '` | A format string representing the symbol of Go. |
|
||||
| `detect_extensions` | `['gleam']` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['gleam.toml']` | Which filenames should trigger this module. |
|
||||
| `style` | `'bold #FFAFF3'` | Стиль модуля. |
|
||||
| `disabled` | `false` | Disables the `gleam` module. |
|
||||
|
||||
### Переменные
|
||||
|
||||
| Переменная | Пример | Описание |
|
||||
| ---------- | -------- | ------------------------------------ |
|
||||
| version | `v1.0.0` | The version of `gleam` |
|
||||
| symbol | | Отражает значение параметра `symbol` |
|
||||
| style\* | | Отражает значение параметра `style` |
|
||||
|
||||
*: Эта переменная может использоваться только в качестве части строки style
|
||||
|
||||
### Пример
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
[gleam]
|
||||
format = 'via [⭐ $version](bold red) '
|
||||
```
|
||||
|
||||
## Go
|
||||
|
||||
The `golang` module shows the currently installed version of [Go](https://golang.org/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2444,7 +2484,7 @@ Displays the current [Kubernetes context](https://kubernetes.io/docs/concepts/co
|
||||
|
||||
По умолчанию этот модуль отключен. Чтобы включить его, установите `disabled` на `false` в файле конфигурации.
|
||||
|
||||
When the module is enabled it will always be active, unless any of `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions.
|
||||
When the module is enabled it will always be active, unless any of `detect_env_vars`, `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions or one of the environmatal variable has been set.
|
||||
|
||||
:::
|
||||
|
||||
@ -2466,6 +2506,7 @@ The `context_aliases` and `user_aliases` options are deprecated. Use `contexts`
|
||||
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `[]` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this modules. |
|
||||
| `detect_env_vars` | `[]` | Which environmental variables should trigger this module |
|
||||
| `contexts` | `[]` | Customized styles and symbols for specific contexts. |
|
||||
| `disabled` | `true` | Отключает модуль `kubernetes`. |
|
||||
|
||||
@ -2768,6 +2809,35 @@ truncation_length = 4
|
||||
truncation_symbol = ''
|
||||
```
|
||||
|
||||
## NATS
|
||||
|
||||
The `nats` module shows the name of the current [NATS](https://nats.io) context.
|
||||
|
||||
### Опции
|
||||
|
||||
| Параметр | По умолчанию | Описание |
|
||||
| ---------- | -------------------------- | ------------------------------------------------------------ |
|
||||
| `symbol` | `'✉️ '` | The symbol used before the NATS context (defaults to empty). |
|
||||
| `style` | `'bold purple'` | Стиль модуля. |
|
||||
| `format` | `'[$symbol$name]($style)'` | Формат модуля. |
|
||||
| `disabled` | `false` | Disables the `nats` module. |
|
||||
|
||||
### Переменные
|
||||
|
||||
| Переменная | Пример | Описание |
|
||||
| ---------- | ----------- | ------------------------------------ |
|
||||
| name | `localhost` | The name of the NATS context |
|
||||
| symbol | | Отражает значение параметра `symbol` |
|
||||
| style\* | | Отражает значение параметра `style` |
|
||||
|
||||
### Пример
|
||||
|
||||
```toml
|
||||
[nats]
|
||||
format = '[$symbol]($style)'
|
||||
style = 'bold purple'
|
||||
```
|
||||
|
||||
## Nim
|
||||
|
||||
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2943,6 +3013,43 @@ The `ocaml` module shows the currently installed version of [OCaml](https://ocam
|
||||
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.
|
||||
|
||||
### Опции
|
||||
|
||||
| Параметр | По умолчанию | Описание |
|
||||
| ------------------- | ------------------------------------ | ----------------------------------------------------- |
|
||||
| `format` | `'via [$symbol($version )]($style)'` | Формат модуля. |
|
||||
| `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'` | Стиль модуля. |
|
||||
| `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. |
|
||||
|
||||
### Переменные
|
||||
|
||||
| Переменная | Пример | Описание |
|
||||
| ---------- | ------------- | ------------------------------------ |
|
||||
| version | `dev-2024-03` | The version of `odin` |
|
||||
| symbol | | Отражает значение параметра `symbol` |
|
||||
| style\* | | Отражает значение параметра `style` |
|
||||
|
||||
*: Эта переменная может использоваться только в качестве части строки style
|
||||
|
||||
### Пример
|
||||
|
||||
```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. By default the module will be shown if the current directory contains a `.rego` file.
|
||||
@ -3811,7 +3918,7 @@ format = '$shlvl level(s) down'
|
||||
threshold = 3
|
||||
```
|
||||
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceeding characters are provided by `shlvl`.
|
||||
Using `repeat` and `repeat_offset` along with `character` module, one can get prompt like `❯❯❯` where last character is colored appropriately for return status code and preceding characters are provided by `shlvl`.
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
@ -4241,6 +4348,7 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
|
||||
| `format` | `'[$user]($style) in '` | Формат модуля. |
|
||||
| `show_always` | `false` | Всегда показывать модуль `username`. |
|
||||
| `disabled` | `false` | Отключает модуль `username`. |
|
||||
| `aliases` | `{}` | Translate system usernames to something else |
|
||||
|
||||
### Переменные
|
||||
|
||||
@ -4262,6 +4370,7 @@ style_root = 'black bold'
|
||||
format = 'user: [$user]($style) '
|
||||
disabled = false
|
||||
show_always = true
|
||||
aliases = { "corpuser034g" = "matchai" }
|
||||
```
|
||||
|
||||
#### Hide the hostname in remote tmux sessions
|
||||
|
||||
@ -123,7 +123,7 @@ sh -c 'rm "$(command -v 'starship')"'
|
||||
|
||||
## Как Starship без `sudo`?
|
||||
|
||||
Скрипт установки (`https://starship.rs/install. h`) использует `sudo` только если директория установки недоступна для записи текущим пользователем. Директория установки по умолчанию это значение переменной окружения `$BIN_DIR` или `/usr/local/bin`, если `$BIN_DIR` не установлен. Если вместо этого выбрать директорию установки, которая доступна для записи пользователем, вы можете установить starship без `sudo`. Например, в `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` флаг `-b` установочного скрипта используется, чтобы задать директорию установки на `~/.local/bin`.
|
||||
Скрипт установки (`https://starship.rs/install. h`) использует `sudo` только если директория установки недоступна для записи текущим пользователем. The default installation directory is the value of the `$BIN_DIR` environment variable or `/usr/local/bin` if `$BIN_DIR` is not set. Если вместо этого выбрать директорию установки, которая доступна для записи пользователем, вы можете установить starship без `sudo`. Например, в `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` флаг `-b` установочного скрипта используется, чтобы задать директорию установки на `~/.local/bin`.
|
||||
|
||||
Для неинтерактивной установки Starship не забудьте добавить опцию `-y` чтобы пропустить подтверждение. Проверьте исходник установочного скрипта, чтобы получить список всех поддерживаемых параметров установки.
|
||||
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue
Block a user