mirror of
https://github.com/Llewellynvdm/starship.git
synced 2024-12-04 10:58:36 +00:00
docs(i18n): new Crowdin updates (#6141)
* New translations gruvbox-rainbow.md (Dutch) * New translations jetpack.md (Dutch) * New translations readme.md (Norwegian) * New translations bracketed-segments.md (Norwegian) * New translations nerd-font.md (Norwegian) * New translations no-runtimes.md (Norwegian) * New translations plain-text.md (Norwegian) * New translations pure-preset.md (Norwegian) * New translations pastel-powerline.md (Norwegian) * New translations no-nerd-font.md (Norwegian) * New translations no-empty-icons.md (Norwegian) * New translations tokyo-night.md (Norwegian) * New translations gruvbox-rainbow.md (Norwegian) * New translations jetpack.md (Norwegian) * New translations readme.md (Polish) * New translations bracketed-segments.md (Polish) * New translations nerd-font.md (Polish) * New translations no-runtimes.md (Polish) * New translations plain-text.md (Polish) * New translations pure-preset.md (Polish) * New translations pastel-powerline.md (Polish) * New translations no-nerd-font.md (Polish) * New translations no-empty-icons.md (Polish) * New translations tokyo-night.md (Polish) * New translations gruvbox-rainbow.md (Polish) * New translations jetpack.md (Polish) * New translations readme.md (Portuguese) * New translations bracketed-segments.md (Portuguese) * New translations nerd-font.md (Portuguese) * New translations no-runtimes.md (Portuguese) * New translations plain-text.md (Portuguese) * New translations pure-preset.md (Portuguese) * New translations pastel-powerline.md (Portuguese) * New translations no-nerd-font.md (Portuguese) * New translations no-empty-icons.md (Portuguese) * New translations tokyo-night.md (Portuguese) * New translations gruvbox-rainbow.md (Portuguese) * New translations jetpack.md (Portuguese) * New translations readme.md (Russian) * New translations bracketed-segments.md (Russian) * New translations nerd-font.md (Russian) * New translations no-runtimes.md (Russian) * New translations plain-text.md (Russian) * New translations pure-preset.md (Russian) * New translations pastel-powerline.md (Russian) * New translations no-nerd-font.md (Russian) * New translations no-empty-icons.md (Russian) * New translations tokyo-night.md (Russian) * New translations gruvbox-rainbow.md (Russian) * New translations jetpack.md (Russian) * New translations readme.md (Turkish) * New translations bracketed-segments.md (Turkish) * New translations nerd-font.md (Turkish) * New translations no-runtimes.md (Turkish) * New translations plain-text.md (Turkish) * New translations pure-preset.md (Turkish) * New translations pastel-powerline.md (Turkish) * New translations no-nerd-font.md (Turkish) * New translations no-empty-icons.md (Turkish) * New translations tokyo-night.md (Turkish) * New translations gruvbox-rainbow.md (Turkish) * New translations jetpack.md (Turkish) * New translations readme.md (Ukrainian) * New translations bracketed-segments.md (Ukrainian) * New translations nerd-font.md (Ukrainian) * New translations no-runtimes.md (Ukrainian) * New translations plain-text.md (Ukrainian) * New translations pure-preset.md (Ukrainian) * New translations pastel-powerline.md (Ukrainian) * New translations no-nerd-font.md (Ukrainian) * New translations no-empty-icons.md (Ukrainian) * New translations tokyo-night.md (Ukrainian) * New translations gruvbox-rainbow.md (Ukrainian) * New translations jetpack.md (Ukrainian) * New translations readme.md (Chinese Simplified) * New translations bracketed-segments.md (Chinese Simplified) * New translations nerd-font.md (Chinese Simplified) * New translations no-runtimes.md (Chinese Simplified) * New translations plain-text.md (Chinese Simplified) * New translations pure-preset.md (Chinese Simplified) * New translations pastel-powerline.md (Chinese Simplified) * New translations no-nerd-font.md (Chinese Simplified) * New translations no-empty-icons.md (Chinese Simplified) * New translations tokyo-night.md (Chinese Simplified) * New translations gruvbox-rainbow.md (Chinese Simplified) * New translations jetpack.md (Chinese Simplified) * New translations readme.md (Chinese Traditional) * New translations bracketed-segments.md (Chinese Traditional) * New translations nerd-font.md (Chinese Traditional) * New translations no-runtimes.md (Chinese Traditional) * New translations plain-text.md (Chinese Traditional) * New translations pure-preset.md (Chinese Traditional) * New translations pastel-powerline.md (Chinese Traditional) * New translations no-nerd-font.md (Chinese Traditional) * New translations no-empty-icons.md (Chinese Traditional) * New translations tokyo-night.md (Chinese Traditional) * New translations gruvbox-rainbow.md (Chinese Traditional) * New translations jetpack.md (Chinese Traditional) * New translations readme.md (Vietnamese) * New translations bracketed-segments.md (Vietnamese) * New translations nerd-font.md (Vietnamese) * New translations no-runtimes.md (Vietnamese) * New translations plain-text.md (Vietnamese) * New translations pure-preset.md (Vietnamese) * New translations pastel-powerline.md (Vietnamese) * New translations no-nerd-font.md (Vietnamese) * New translations no-empty-icons.md (Vietnamese) * New translations tokyo-night.md (Vietnamese) * New translations gruvbox-rainbow.md (Vietnamese) * New translations jetpack.md (Vietnamese) * New translations readme.md (Portuguese, Brazilian) * New translations bracketed-segments.md (Portuguese, Brazilian) * New translations nerd-font.md (Portuguese, Brazilian) * New translations no-runtimes.md (Portuguese, Brazilian) * New translations plain-text.md (Portuguese, Brazilian) * New translations pure-preset.md (Portuguese, Brazilian) * New translations pastel-powerline.md (Portuguese, Brazilian) * New translations no-nerd-font.md (Portuguese, Brazilian) * New translations no-empty-icons.md (Portuguese, Brazilian) * New translations tokyo-night.md (Portuguese, Brazilian) * New translations gruvbox-rainbow.md (Portuguese, Brazilian) * New translations jetpack.md (Portuguese, Brazilian) * New translations readme.md (Indonesian) * New translations bracketed-segments.md (Indonesian) * New translations nerd-font.md (Indonesian) * New translations no-runtimes.md (Indonesian) * New translations plain-text.md (Indonesian) * New translations pure-preset.md (Indonesian) * New translations pastel-powerline.md (Indonesian) * New translations no-nerd-font.md (Indonesian) * New translations no-empty-icons.md (Indonesian) * New translations tokyo-night.md (Indonesian) * New translations gruvbox-rainbow.md (Indonesian) * New translations jetpack.md (Indonesian) * New translations readme.md (Bengali) * New translations bracketed-segments.md (Bengali) * New translations nerd-font.md (Bengali) * New translations no-runtimes.md (Bengali) * New translations plain-text.md (Bengali) * New translations pure-preset.md (Bengali) * New translations pastel-powerline.md (Bengali) * New translations no-nerd-font.md (Bengali) * New translations no-empty-icons.md (Bengali) * New translations tokyo-night.md (Bengali) * New translations gruvbox-rainbow.md (Bengali) * New translations jetpack.md (Bengali) * New translations readme.md (Sorani (Kurdish)) * New translations bracketed-segments.md (Sorani (Kurdish)) * New translations nerd-font.md (Sorani (Kurdish)) * New translations no-runtimes.md (Sorani (Kurdish)) * New translations plain-text.md (Sorani (Kurdish)) * New translations pure-preset.md (Sorani (Kurdish)) * New translations pastel-powerline.md (Sorani (Kurdish)) * New translations no-nerd-font.md (Sorani (Kurdish)) * New translations no-empty-icons.md (Sorani (Kurdish)) * New translations tokyo-night.md (Sorani (Kurdish)) * New translations gruvbox-rainbow.md (Sorani (Kurdish)) * New translations jetpack.md (Sorani (Kurdish)) * New translations bracketed-segments.md (Ukrainian) * New translations nerd-font.md (Ukrainian) * New translations no-runtimes.md (Ukrainian) * New translations plain-text.md (Ukrainian) * New translations pure-preset.md (Ukrainian) * New translations pastel-powerline.md (Ukrainian) * New translations no-nerd-font.md (Ukrainian) * New translations no-empty-icons.md (Ukrainian) * New translations tokyo-night.md (Ukrainian) * New translations gruvbox-rainbow.md (Ukrainian) * New translations jetpack.md (Ukrainian) * New translations readme.md (Portuguese, Brazilian) * New translations readme.md (Portuguese, Brazilian) * 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 (Ukrainian) * New translations readme.md (French) * New translations readme.md (Spanish) * New translations readme.md (German) * New translations readme.md (Japanese) * New translations readme.md (Russian) * 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 (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * 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 (Turkish) * 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))
This commit is contained in:
Matan Kushner
GitHub
parent
2125e432ab
commit
6555778471
@ -553,10 +553,7 @@ discharging_symbol = '💦 '
|
||||
|
||||
## Buf
|
||||
|
||||
The `buf` module shows the currently installed version of [Buf](https://buf.build). By default, the module is shown if all of the following conditions are met:
|
||||
|
||||
- The [`buf`](https://github.com/bufbuild/buf) CLI is installed.
|
||||
- The current directory contains a [`buf.yaml`](https://docs.buf.build/configuration/v1/buf-yaml), [`buf.gen.yaml`](https://docs.buf.build/configuration/v1/buf-gen-yaml), or [`buf.work.yaml`](https://docs.buf.build/configuration/v1/buf-work-yaml) configuration file.
|
||||
The `buf` module shows the currently installed version of [Buf](https://buf.build). By default, the module is shown if the current directory contains a [`buf.yaml`](https://docs.buf.build/configuration/v1/buf-yaml), [`buf.gen.yaml`](https://docs.buf.build/configuration/v1/buf-gen-yaml), or [`buf.work.yaml`](https://docs.buf.build/configuration/v1/buf-work-yaml) configuration file.
|
||||
|
||||
### Options
|
||||
|
||||
@ -635,7 +632,7 @@ format = 'via [🍔 $version](bold green) '
|
||||
|
||||
You can override the `detect_files` property of [the nodejs module](#nodejs) in your config so as to only show the bun runtime:
|
||||
|
||||
```
|
||||
```toml
|
||||
[nodejs]
|
||||
detect_files = ['package.json', '.node-version', '!bunfig.toml', '!bun.lockb']
|
||||
```
|
||||
@ -863,7 +860,7 @@ The `conda` module shows the current [Conda](https://docs.conda.io/en/latest/) e
|
||||
|
||||
::: tip
|
||||
|
||||
This does not suppress conda's own prompt modifier, you may want to run `conda config --set changeps1 False`.
|
||||
This does not suppress conda's own prompt modifier, you may want to run `conda config --set changeps1 False`. If you use [pixi](https://pixi.sh), you can disable pixi's prompt modifier by running `pixi config set change-ps1 false`.
|
||||
|
||||
:::
|
||||
|
||||
@ -1050,17 +1047,17 @@ format = 'via [🔰 $version](bold red) '
|
||||
|
||||
The `deno` module shows you your currently installed version of [Deno](https://deno.land/). By default the module will be shown if any of the following conditions are met:
|
||||
|
||||
- The current directory contains a `deno.json`, `deno.jsonc`, `mod.ts`, `mod.js`, `deps.ts` or `deps.js` file
|
||||
- The current directory contains a `deno.json`, `deno.jsonc`, `deno.lock`, `mod.ts`, `mod.js`, `deps.ts` or `deps.js` file
|
||||
|
||||
### 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 Deno |
|
||||
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['deno.json', 'deno.jsonc', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | Which filenames should trigger this module. |
|
||||
| `detect_files` | `['deno.json', 'deno.jsonc', 'deno.lock', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this module. |
|
||||
| `style` | `'green bold'` | The style for the module. |
|
||||
| `disabled` | `false` | Disables the `deno` module. |
|
||||
@ -1117,7 +1114,7 @@ For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, an
|
||||
| `fish_style_pwd_dir_length` | `0` | The number of characters to use when applying fish shell pwd path logic. |
|
||||
| `use_logical_path` | `true` | If `true` render the logical path sourced from the shell via `PWD` or `--logical-path`. If `false` instead render the physical filesystem path with symlinks resolved. |
|
||||
|
||||
`substitutions` allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories (i.e. Java). Note that this will disable the fish style PWD.
|
||||
`substitutions` allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories of Java. Note that this will disable the fish style PWD.
|
||||
|
||||
```toml
|
||||
[directory.substitutions]
|
||||
@ -1207,7 +1204,7 @@ disabled = false
|
||||
|
||||
## Docker Context
|
||||
|
||||
The `docker_context` module shows the currently active [Docker context](https://docs.docker.com/engine/context/working-with-contexts/) if it's not set to `default` or if the `DOCKER_MACHINE_NAME`, `DOCKER_HOST` or `DOCKER_CONTEXT` environment variables are set (as they are meant to override the context in use).
|
||||
The `docker_context` module shows the currently active [Docker context](https://docs.docker.com/engine/context/working-with-contexts/) if it's not set to `default` or `desktop-linux`, or if the `DOCKER_MACHINE_NAME`, `DOCKER_HOST` or `DOCKER_CONTEXT` environment variables are set (as they are meant to override the context in use).
|
||||
|
||||
### Options
|
||||
|
||||
@ -1890,7 +1887,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
|
||||
| `staged` | `'+'` | The format of `staged` |
|
||||
| `renamed` | `'»'` | The format of `renamed` |
|
||||
| `deleted` | `'✘'` | The format of `deleted` |
|
||||
| `typechanged` | `""` | The format of `typechange` |
|
||||
| `typechanged` | `""` | The format of `typechanged` |
|
||||
| `style` | `'bold red'` | The style for the module. |
|
||||
| `ignore_submodules` | `false` | Ignore changes to submodules. |
|
||||
| `disabled` | `false` | Disables the `git_status` module. |
|
||||
@ -1911,7 +1908,7 @@ The following variables can be used in `format`:
|
||||
| `staged` | Displays `staged` when a new file has been added to the staging area. |
|
||||
| `renamed` | Displays `renamed` when a renamed file has been added to the staging area. |
|
||||
| `deleted` | Displays `deleted` when a file's deletion has been added to the staging area. |
|
||||
| `typechanged` | Displays `typechange` when a file's type has been changed in the staging area. |
|
||||
| `typechanged` | Displays `typechanged` when a file's type has been changed in the staging area. |
|
||||
| style\* | Mirrors the value of option `style` |
|
||||
|
||||
*: This variable can only be used as a part of a style string
|
||||
@ -2257,6 +2254,7 @@ The `hostname` module shows the system hostname.
|
||||
| `format` | `'[$ssh_symbol$hostname]($style) in '` | The format for the module. |
|
||||
| `style` | `'bold dimmed green'` | The style for the module. |
|
||||
| `disabled` | `false` | Disables the `hostname` module. |
|
||||
| `aliases` | `{}` | Translate system hostnames to something else. If `trim_at` is specified, only the first part will be matched and replaced. |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -2293,6 +2291,14 @@ detect_env_vars = ['!TMUX', 'SSH_CONNECTION']
|
||||
disabled = false
|
||||
```
|
||||
|
||||
#### Replace the hostname with a nickname
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
[hostname]
|
||||
aliases = { "Max's MacBook Pro" = "home" }
|
||||
```
|
||||
|
||||
## Java
|
||||
|
||||
The `java` module shows the currently installed version of [Java](https://www.oracle.com/java/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2809,6 +2815,41 @@ truncation_length = 4
|
||||
truncation_symbol = ''
|
||||
```
|
||||
|
||||
## Mojo
|
||||
|
||||
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
|
||||
|
||||
### Options
|
||||
|
||||
| Option | الافتراضي | الوصف |
|
||||
| ------------------- | ------------------------------------- | ------------------------------------------------------ |
|
||||
| `format` | `'with [$symbol($version )]($style)'` | The format for the module. |
|
||||
| `symbol` | `'🔥 '` | The symbol used before displaying the version of Mojo. |
|
||||
| `style` | `'bold 208'` | The style for the module. |
|
||||
| `disabled` | `false` | Disables the `mojo` module. |
|
||||
| `detect_extensions` | `['mojo', '🔥']` | 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 | `24.4.0` | The version of `mojo` |
|
||||
| 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
|
||||
|
||||
[mojo]
|
||||
format = 'via [mojo ($version )($hash )]($style)'
|
||||
```
|
||||
|
||||
## NATS
|
||||
|
||||
The `nats` module shows the name of the current [NATS](https://nats.io) context.
|
||||
@ -2935,12 +2976,12 @@ The `nodejs` module shows the currently installed version of [Node.js](https://n
|
||||
### 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 Node.js. |
|
||||
| `detect_extensions` | `['js', 'mjs', 'cjs', 'ts', 'mts', 'cts']` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['package.json', '.node-version']` | Which filenames should trigger this module. |
|
||||
| `detect_files` | `['package.json', '.node-version', '.nvmrc']` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `['node_modules']` | Which folders should trigger this module. |
|
||||
| `style` | `'bold green'` | The style for the module. |
|
||||
| `disabled` | `false` | Disables the `nodejs` module. |
|
||||
@ -3492,13 +3533,15 @@ By default, the module will be shown if any of the following conditions are met:
|
||||
- The current directory contains a `requirements.txt` file
|
||||
- The current directory contains a `setup.py` file
|
||||
- The current directory contains a `tox.ini` file
|
||||
- The current directory contains a `pixi.toml` file
|
||||
- The current directory contains a file with the `.py` extension.
|
||||
- The current directory contains a file with the `.ipynb` extension.
|
||||
- A virtual environment is currently activated
|
||||
|
||||
### Options
|
||||
|
||||
| Option | الافتراضي | الوصف |
|
||||
| -------------------- | ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- |
|
||||
| -------------------- | ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
|
||||
| `format` | `'via [${symbol}${pyenv_prefix}(${version} )(\($virtualenv\) )]($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 Python |
|
||||
@ -3506,8 +3549,8 @@ By default, the module will be shown if any of the following conditions are met:
|
||||
| `pyenv_version_name` | `false` | Use pyenv to get Python version |
|
||||
| `pyenv_prefix` | `'pyenv'` | Prefix before pyenv version display, only used if pyenv is used |
|
||||
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should executes when getting the version. |
|
||||
| `detect_extensions` | `['py']` | Which extensions should trigger this module |
|
||||
| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini']` | Which filenames should trigger this module |
|
||||
| `detect_extensions` | `['py', 'ipynb']` | Which extensions should trigger this module |
|
||||
| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini', 'pixi.toml']` | Which filenames should trigger this module |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this module |
|
||||
| `disabled` | `false` | Disables the `python` module. |
|
||||
|
||||
@ -4350,7 +4393,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 |
|
||||
| `aliases` | `{}` | Translate system usernames to something else. |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -4361,7 +4404,7 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
|
||||
|
||||
### مثال
|
||||
|
||||
#### Always show the hostname
|
||||
#### Always show the username
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
@ -4375,17 +4418,6 @@ show_always = true
|
||||
aliases = { "corpuser034g" = "matchai" }
|
||||
```
|
||||
|
||||
#### Hide the hostname in remote tmux sessions
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
[hostname]
|
||||
ssh_only = false
|
||||
detect_env_vars = ['!TMUX', 'SSH_CONNECTION']
|
||||
disabled = false
|
||||
```
|
||||
|
||||
## Vagrant
|
||||
|
||||
The `vagrant` module shows the currently installed version of [Vagrant](https://www.vagrantup.com/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -4573,7 +4605,7 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt
|
||||
| Option | الافتراضي | الوصف |
|
||||
| ------------------- | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `command` | `''` | The command whose output should be printed. The command will be passed on stdin to the shell. |
|
||||
| `when` | `false` | Either a boolean value (`true` or `false`, without quotes) or a string shell command used as a condition to show the module. In case of a string, the module will be shown if the command returns a `0` status code. |
|
||||
| `when` | `false` | Either a boolean value (`true` or `false`, without quotes) or a string shell command used as a condition to show the module. In case of a string, the module will be shown if the `shell` returns a `0` status code from executing it. |
|
||||
| `require_repo` | `false` | If `true`, the module will only be shown in paths containing a (git) repository. This option alone is not sufficient display condition in absence of other options. |
|
||||
| `shell` | | [See below](#custom-command-shell) |
|
||||
| `الوصف` | `'<custom module>'` | The description of the module that is shown when running `starship explain`. |
|
||||
@ -4593,7 +4625,7 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt
|
||||
|
||||
| Variable | الوصف |
|
||||
| --------- | -------------------------------------- |
|
||||
| output | The output of shell command in `shell` |
|
||||
| output | The output of `command` run in `shell` |
|
||||
| symbol | Mirrors the value of option `symbol` |
|
||||
| style\* | Mirrors the value of option `style` |
|
||||
|
||||
@ -4608,7 +4640,7 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt
|
||||
|
||||
If unset, it will fallback to STARSHIP_SHELL and then to 'sh' on Linux, and 'cmd /C' on Windows.
|
||||
|
||||
The `command` will be passed in on stdin.
|
||||
The `command` (and `when`, if applicable) will be passed in on stdin.
|
||||
|
||||
If `shell` is not given or only contains one element and Starship detects PowerShell will be used, the following arguments will automatically be added: `-NoProfile -Command -`. If `shell` is not given or only contains one element and Starship detects Cmd will be used, the following argument will automatically be added: `/C` and `stdin` will be set to `false`. If `shell` is not given or only contains one element and Starship detects Nushell will be used, the following arguments will automatically be added: `-c` and `stdin` will be set to `false`. This behavior can be avoided by explicitly passing arguments to the shell, e.g.
|
||||
|
||||
|
||||
@ -431,7 +431,16 @@ 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)
|
||||
## 🔒 Code Signing Policy
|
||||
|
||||
Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org).
|
||||
|
||||
Code Signing Roles:
|
||||
|
||||
- Reviewers: [Astronauts](https://github.com/orgs/starship/teams/astronauts)
|
||||
- Approvers and Authors: [Mission Control](https://github.com/orgs/starship/teams/mission-control)
|
||||
|
||||
This program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it.
|
||||
|
||||
<p align="center">
|
||||
<br>
|
||||
|
||||
@ -12,6 +12,6 @@ This preset changes the format of all the built-in modules to show their segment
|
||||
starship preset bracketed-segments -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/bracketed-segments.toml)
|
||||
[Click to download TOML](/presets/toml/bracketed-segments.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/bracketed-segments.toml
|
||||
|
||||
@ -16,6 +16,6 @@ This preset is heavily inspired by [Pastel Powerline](./pastel-powerline.md), an
|
||||
starship preset gruvbox-rainbow -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/gruvbox-rainbow.toml)
|
||||
[Click to download TOML](/presets/toml/gruvbox-rainbow.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/gruvbox-rainbow.toml
|
||||
|
||||
@ -19,6 +19,6 @@ This is a pseudo minimalist preset inspired by the [geometry](https://github.com
|
||||
starship preset jetpack -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/jetpack.toml)
|
||||
[Click to download TOML](/presets/toml/jetpack.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/jetpack.toml
|
||||
|
||||
@ -16,6 +16,6 @@ This preset changes the symbols for each module to use Nerd Font symbols.
|
||||
starship preset nerd-font-symbols -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/nerd-font-symbols.toml)
|
||||
[Click to download TOML](/presets/toml/nerd-font-symbols.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/nerd-font-symbols.toml
|
||||
|
||||
@ -12,6 +12,6 @@ If toolset files are identified the toolset icon is displayed. If the toolset is
|
||||
starship preset no-empty-icons -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/no-empty-icons.toml)
|
||||
[Click to download TOML](/presets/toml/no-empty-icons.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/no-empty-icons.toml
|
||||
|
||||
@ -14,6 +14,6 @@ This preset will become the default preset in a future release of starship.
|
||||
starship preset no-nerd-font -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/no-nerd-font.toml)
|
||||
[Click to download TOML](/presets/toml/no-nerd-font.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/no-nerd-font.toml
|
||||
|
||||
@ -12,6 +12,6 @@ This preset hides the version of language runtimes. If you work in containers or
|
||||
starship preset no-runtime-versions -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/no-runtime-versions.toml)
|
||||
[Click to download TOML](/presets/toml/no-runtime-versions.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/no-runtime-versions.toml
|
||||
|
||||
@ -16,6 +16,6 @@ This preset is inspired by [M365Princess](https://github.com/JanDeDobbeleer/oh-m
|
||||
starship preset pastel-powerline -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/pastel-powerline.toml)
|
||||
[Click to download TOML](/presets/toml/pastel-powerline.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/pastel-powerline.toml
|
||||
|
||||
@ -12,6 +12,6 @@ This preset changes the symbols for each module into plain text. Great if you do
|
||||
starship preset plain-text-symbols -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/plain-text-symbols.toml)
|
||||
[Click to download TOML](/presets/toml/plain-text-symbols.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/plain-text-symbols.toml
|
||||
|
||||
@ -12,6 +12,6 @@ This preset emulates the look and behavior of [Pure](https://github.com/sindreso
|
||||
starship preset pure-preset -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/pure-preset.toml)
|
||||
[Click to download TOML](/presets/toml/pure-preset.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/pure-preset.toml
|
||||
|
||||
@ -16,6 +16,6 @@ This preset is inspired by [tokyo-night-vscode-theme](https://github.com/enkia/t
|
||||
starship preset tokyo-night -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/tokyo-night.toml)
|
||||
[Click to download TOML](/presets/toml/tokyo-night.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/tokyo-night.toml
|
||||
|
||||
@ -553,10 +553,7 @@ discharging_symbol = '💦 '
|
||||
|
||||
## Buf
|
||||
|
||||
The `buf` module shows the currently installed version of [Buf](https://buf.build). By default, the module is shown if all of the following conditions are met:
|
||||
|
||||
- The [`buf`](https://github.com/bufbuild/buf) CLI is installed.
|
||||
- The current directory contains a [`buf.yaml`](https://docs.buf.build/configuration/v1/buf-yaml), [`buf.gen.yaml`](https://docs.buf.build/configuration/v1/buf-gen-yaml), or [`buf.work.yaml`](https://docs.buf.build/configuration/v1/buf-work-yaml) configuration file.
|
||||
The `buf` module shows the currently installed version of [Buf](https://buf.build). By default, the module is shown if the current directory contains a [`buf.yaml`](https://docs.buf.build/configuration/v1/buf-yaml), [`buf.gen.yaml`](https://docs.buf.build/configuration/v1/buf-gen-yaml), or [`buf.work.yaml`](https://docs.buf.build/configuration/v1/buf-work-yaml) configuration file.
|
||||
|
||||
### Options
|
||||
|
||||
@ -635,7 +632,7 @@ format = 'via [🍔 $version](bold green) '
|
||||
|
||||
You can override the `detect_files` property of [the nodejs module](#nodejs) in your config so as to only show the bun runtime:
|
||||
|
||||
```
|
||||
```toml
|
||||
[nodejs]
|
||||
detect_files = ['package.json', '.node-version', '!bunfig.toml', '!bun.lockb']
|
||||
```
|
||||
@ -863,7 +860,7 @@ The `conda` module shows the current [Conda](https://docs.conda.io/en/latest/) e
|
||||
|
||||
::: tip
|
||||
|
||||
This does not suppress conda's own prompt modifier, you may want to run `conda config --set changeps1 False`.
|
||||
This does not suppress conda's own prompt modifier, you may want to run `conda config --set changeps1 False`. If you use [pixi](https://pixi.sh), you can disable pixi's prompt modifier by running `pixi config set change-ps1 false`.
|
||||
|
||||
:::
|
||||
|
||||
@ -1050,17 +1047,17 @@ format = 'via [🔰 $version](bold red) '
|
||||
|
||||
The `deno` module shows you your currently installed version of [Deno](https://deno.land/). By default the module will be shown if any of the following conditions are met:
|
||||
|
||||
- The current directory contains a `deno.json`, `deno.jsonc`, `mod.ts`, `mod.js`, `deps.ts` or `deps.js` file
|
||||
- The current directory contains a `deno.json`, `deno.jsonc`, `deno.lock`, `mod.ts`, `mod.js`, `deps.ts` or `deps.js` file
|
||||
|
||||
### 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 Deno |
|
||||
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['deno.json', 'deno.jsonc', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | Which filenames should trigger this module. |
|
||||
| `detect_files` | `['deno.json', 'deno.jsonc', 'deno.lock', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this module. |
|
||||
| `style` | `'green bold'` | The style for the module. |
|
||||
| `disabled` | `false` | Disables the `deno` module. |
|
||||
@ -1117,7 +1114,7 @@ For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, an
|
||||
| `fish_style_pwd_dir_length` | `0` | The number of characters to use when applying fish shell pwd path logic. |
|
||||
| `use_logical_path` | `true` | If `true` render the logical path sourced from the shell via `PWD` or `--logical-path`. If `false` instead render the physical filesystem path with symlinks resolved. |
|
||||
|
||||
`substitutions` allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories (i.e. Java). Note that this will disable the fish style PWD.
|
||||
`substitutions` allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories of Java. Note that this will disable the fish style PWD.
|
||||
|
||||
```toml
|
||||
[directory.substitutions]
|
||||
@ -1207,7 +1204,7 @@ disabled = false
|
||||
|
||||
## Docker Context
|
||||
|
||||
The `docker_context` module shows the currently active [Docker context](https://docs.docker.com/engine/context/working-with-contexts/) if it's not set to `default` or if the `DOCKER_MACHINE_NAME`, `DOCKER_HOST` or `DOCKER_CONTEXT` environment variables are set (as they are meant to override the context in use).
|
||||
The `docker_context` module shows the currently active [Docker context](https://docs.docker.com/engine/context/working-with-contexts/) if it's not set to `default` or `desktop-linux`, or if the `DOCKER_MACHINE_NAME`, `DOCKER_HOST` or `DOCKER_CONTEXT` environment variables are set (as they are meant to override the context in use).
|
||||
|
||||
### Options
|
||||
|
||||
@ -1890,7 +1887,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
|
||||
| `staged` | `'+'` | The format of `staged` |
|
||||
| `renamed` | `'»'` | The format of `renamed` |
|
||||
| `deleted` | `'✘'` | The format of `deleted` |
|
||||
| `typechanged` | `""` | The format of `typechange` |
|
||||
| `typechanged` | `""` | The format of `typechanged` |
|
||||
| `style` | `'bold red'` | The style for the module. |
|
||||
| `ignore_submodules` | `false` | Ignore changes to submodules. |
|
||||
| `disabled` | `false` | Disables the `git_status` module. |
|
||||
@ -1911,7 +1908,7 @@ The following variables can be used in `format`:
|
||||
| `staged` | Displays `staged` when a new file has been added to the staging area. |
|
||||
| `renamed` | Displays `renamed` when a renamed file has been added to the staging area. |
|
||||
| `deleted` | Displays `deleted` when a file's deletion has been added to the staging area. |
|
||||
| `typechanged` | Displays `typechange` when a file's type has been changed in the staging area. |
|
||||
| `typechanged` | Displays `typechanged` when a file's type has been changed in the staging area. |
|
||||
| style\* | Mirrors the value of option `style` |
|
||||
|
||||
*: This variable can only be used as a part of a style string
|
||||
@ -2257,6 +2254,7 @@ The `hostname` module shows the system hostname.
|
||||
| `format` | `'[$ssh_symbol$hostname]($style) in '` | The format for the module. |
|
||||
| `style` | `'bold dimmed green'` | The style for the module. |
|
||||
| `disabled` | `false` | Disables the `hostname` module. |
|
||||
| `aliases` | `{}` | Translate system hostnames to something else. If `trim_at` is specified, only the first part will be matched and replaced. |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -2293,6 +2291,14 @@ detect_env_vars = ['!TMUX', 'SSH_CONNECTION']
|
||||
disabled = false
|
||||
```
|
||||
|
||||
#### Replace the hostname with a nickname
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
[hostname]
|
||||
aliases = { "Max's MacBook Pro" = "home" }
|
||||
```
|
||||
|
||||
## Java
|
||||
|
||||
The `java` module shows the currently installed version of [Java](https://www.oracle.com/java/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2809,6 +2815,41 @@ truncation_length = 4
|
||||
truncation_symbol = ''
|
||||
```
|
||||
|
||||
## Mojo
|
||||
|
||||
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
|
||||
|
||||
### Options
|
||||
|
||||
| Option | Default | Description |
|
||||
| ------------------- | ------------------------------------- | ------------------------------------------------------ |
|
||||
| `format` | `'with [$symbol($version )]($style)'` | The format for the module. |
|
||||
| `symbol` | `'🔥 '` | The symbol used before displaying the version of Mojo. |
|
||||
| `style` | `'bold 208'` | The style for the module. |
|
||||
| `disabled` | `false` | Disables the `mojo` module. |
|
||||
| `detect_extensions` | `['mojo', '🔥']` | 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 | `24.4.0` | The version of `mojo` |
|
||||
| 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
|
||||
|
||||
[mojo]
|
||||
format = 'via [mojo ($version )($hash )]($style)'
|
||||
```
|
||||
|
||||
## NATS
|
||||
|
||||
The `nats` module shows the name of the current [NATS](https://nats.io) context.
|
||||
@ -2935,12 +2976,12 @@ The `nodejs` module shows the currently installed version of [Node.js](https://n
|
||||
### 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 Node.js. |
|
||||
| `detect_extensions` | `['js', 'mjs', 'cjs', 'ts', 'mts', 'cts']` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['package.json', '.node-version']` | Which filenames should trigger this module. |
|
||||
| `detect_files` | `['package.json', '.node-version', '.nvmrc']` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `['node_modules']` | Which folders should trigger this module. |
|
||||
| `style` | `'bold green'` | The style for the module. |
|
||||
| `disabled` | `false` | Disables the `nodejs` module. |
|
||||
@ -3492,13 +3533,15 @@ By default, the module will be shown if any of the following conditions are met:
|
||||
- The current directory contains a `requirements.txt` file
|
||||
- The current directory contains a `setup.py` file
|
||||
- The current directory contains a `tox.ini` file
|
||||
- The current directory contains a `pixi.toml` file
|
||||
- The current directory contains a file with the `.py` extension.
|
||||
- The current directory contains a file with the `.ipynb` extension.
|
||||
- A virtual environment is currently activated
|
||||
|
||||
### Options
|
||||
|
||||
| Option | Default | Description |
|
||||
| -------------------- | ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- |
|
||||
| -------------------- | ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
|
||||
| `format` | `'via [${symbol}${pyenv_prefix}(${version} )(\($virtualenv\) )]($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 Python |
|
||||
@ -3506,8 +3549,8 @@ By default, the module will be shown if any of the following conditions are met:
|
||||
| `pyenv_version_name` | `false` | Use pyenv to get Python version |
|
||||
| `pyenv_prefix` | `'pyenv'` | Prefix before pyenv version display, only used if pyenv is used |
|
||||
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should executes when getting the version. |
|
||||
| `detect_extensions` | `['py']` | Which extensions should trigger this module |
|
||||
| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini']` | Which filenames should trigger this module |
|
||||
| `detect_extensions` | `['py', 'ipynb']` | Which extensions should trigger this module |
|
||||
| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini', 'pixi.toml']` | Which filenames should trigger this module |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this module |
|
||||
| `disabled` | `false` | Disables the `python` module. |
|
||||
|
||||
@ -4350,7 +4393,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 |
|
||||
| `aliases` | `{}` | Translate system usernames to something else. |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -4361,7 +4404,7 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
|
||||
|
||||
### Example
|
||||
|
||||
#### Always show the hostname
|
||||
#### Always show the username
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
@ -4375,17 +4418,6 @@ show_always = true
|
||||
aliases = { "corpuser034g" = "matchai" }
|
||||
```
|
||||
|
||||
#### Hide the hostname in remote tmux sessions
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
[hostname]
|
||||
ssh_only = false
|
||||
detect_env_vars = ['!TMUX', 'SSH_CONNECTION']
|
||||
disabled = false
|
||||
```
|
||||
|
||||
## Vagrant
|
||||
|
||||
The `vagrant` module shows the currently installed version of [Vagrant](https://www.vagrantup.com/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -4573,7 +4605,7 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt
|
||||
| Option | Default | Description |
|
||||
| ------------------- | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `command` | `''` | The command whose output should be printed. The command will be passed on stdin to the shell. |
|
||||
| `when` | `false` | Either a boolean value (`true` or `false`, without quotes) or a string shell command used as a condition to show the module. In case of a string, the module will be shown if the command returns a `0` status code. |
|
||||
| `when` | `false` | Either a boolean value (`true` or `false`, without quotes) or a string shell command used as a condition to show the module. In case of a string, the module will be shown if the `shell` returns a `0` status code from executing it. |
|
||||
| `require_repo` | `false` | If `true`, the module will only be shown in paths containing a (git) repository. This option alone is not sufficient display condition in absence of other options. |
|
||||
| `shell` | | [See below](#custom-command-shell) |
|
||||
| `description` | `'<custom module>'` | The description of the module that is shown when running `starship explain`. |
|
||||
@ -4593,7 +4625,7 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt
|
||||
|
||||
| Variable | Description |
|
||||
| --------- | -------------------------------------- |
|
||||
| output | The output of shell command in `shell` |
|
||||
| output | The output of `command` run in `shell` |
|
||||
| symbol | Mirrors the value of option `symbol` |
|
||||
| style\* | Mirrors the value of option `style` |
|
||||
|
||||
@ -4608,7 +4640,7 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt
|
||||
|
||||
If unset, it will fallback to STARSHIP_SHELL and then to 'sh' on Linux, and 'cmd /C' on Windows.
|
||||
|
||||
The `command` will be passed in on stdin.
|
||||
The `command` (and `when`, if applicable) will be passed in on stdin.
|
||||
|
||||
If `shell` is not given or only contains one element and Starship detects PowerShell will be used, the following arguments will automatically be added: `-NoProfile -Command -`. If `shell` is not given or only contains one element and Starship detects Cmd will be used, the following argument will automatically be added: `/C` and `stdin` will be set to `false`. If `shell` is not given or only contains one element and Starship detects Nushell will be used, the following arguments will automatically be added: `-c` and `stdin` will be set to `false`. This behavior can be avoided by explicitly passing arguments to the shell, e.g.
|
||||
|
||||
|
||||
@ -431,7 +431,16 @@ 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)
|
||||
## 🔒 Code Signing Policy
|
||||
|
||||
Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org).
|
||||
|
||||
Code Signing Roles:
|
||||
|
||||
- Reviewers: [Astronauts](https://github.com/orgs/starship/teams/astronauts)
|
||||
- Approvers and Authors: [Mission Control](https://github.com/orgs/starship/teams/mission-control)
|
||||
|
||||
This program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it.
|
||||
|
||||
<p align="center">
|
||||
<br>
|
||||
|
||||
@ -12,6 +12,6 @@ This preset changes the format of all the built-in modules to show their segment
|
||||
starship preset bracketed-segments -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/bracketed-segments.toml)
|
||||
[Click to download TOML](/presets/toml/bracketed-segments.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/bracketed-segments.toml
|
||||
|
||||
@ -16,6 +16,6 @@ This preset is heavily inspired by [Pastel Powerline](./pastel-powerline.md), an
|
||||
starship preset gruvbox-rainbow -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/gruvbox-rainbow.toml)
|
||||
[Click to download TOML](/presets/toml/gruvbox-rainbow.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/gruvbox-rainbow.toml
|
||||
|
||||
@ -19,6 +19,6 @@ This is a pseudo minimalist preset inspired by the [geometry](https://github.com
|
||||
starship preset jetpack -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/jetpack.toml)
|
||||
[Click to download TOML](/presets/toml/jetpack.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/jetpack.toml
|
||||
|
||||
@ -16,6 +16,6 @@ This preset changes the symbols for each module to use Nerd Font symbols.
|
||||
starship preset nerd-font-symbols -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/nerd-font-symbols.toml)
|
||||
[Click to download TOML](/presets/toml/nerd-font-symbols.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/nerd-font-symbols.toml
|
||||
|
||||
@ -12,6 +12,6 @@ If toolset files are identified the toolset icon is displayed. If the toolset is
|
||||
starship preset no-empty-icons -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/no-empty-icons.toml)
|
||||
[Click to download TOML](/presets/toml/no-empty-icons.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/no-empty-icons.toml
|
||||
|
||||
@ -14,6 +14,6 @@ This preset will become the default preset in a future release of starship.
|
||||
starship preset no-nerd-font -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/no-nerd-font.toml)
|
||||
[Click to download TOML](/presets/toml/no-nerd-font.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/no-nerd-font.toml
|
||||
|
||||
@ -12,6 +12,6 @@ This preset hides the version of language runtimes. If you work in containers or
|
||||
starship preset no-runtime-versions -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/no-runtime-versions.toml)
|
||||
[Click to download TOML](/presets/toml/no-runtime-versions.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/no-runtime-versions.toml
|
||||
|
||||
@ -16,6 +16,6 @@ This preset is inspired by [M365Princess](https://github.com/JanDeDobbeleer/oh-m
|
||||
starship preset pastel-powerline -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/pastel-powerline.toml)
|
||||
[Click to download TOML](/presets/toml/pastel-powerline.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/pastel-powerline.toml
|
||||
|
||||
@ -12,6 +12,6 @@ This preset changes the symbols for each module into plain text. Great if you do
|
||||
starship preset plain-text-symbols -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/plain-text-symbols.toml)
|
||||
[Click to download TOML](/presets/toml/plain-text-symbols.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/plain-text-symbols.toml
|
||||
|
||||
@ -12,6 +12,6 @@ This preset emulates the look and behavior of [Pure](https://github.com/sindreso
|
||||
starship preset pure-preset -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/pure-preset.toml)
|
||||
[Click to download TOML](/presets/toml/pure-preset.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/pure-preset.toml
|
||||
|
||||
@ -16,6 +16,6 @@ This preset is inspired by [tokyo-night-vscode-theme](https://github.com/enkia/t
|
||||
starship preset tokyo-night -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/tokyo-night.toml)
|
||||
[Click to download TOML](/presets/toml/tokyo-night.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/tokyo-night.toml
|
||||
|
||||
@ -553,10 +553,7 @@ discharging_symbol = '💦 '
|
||||
|
||||
## Buf
|
||||
|
||||
The `buf` module shows the currently installed version of [Buf](https://buf.build). By default, the module is shown if all of the following conditions are met:
|
||||
|
||||
- The [`buf`](https://github.com/bufbuild/buf) CLI is installed.
|
||||
- The current directory contains a [`buf.yaml`](https://docs.buf.build/configuration/v1/buf-yaml), [`buf.gen.yaml`](https://docs.buf.build/configuration/v1/buf-gen-yaml), or [`buf.work.yaml`](https://docs.buf.build/configuration/v1/buf-work-yaml) configuration file.
|
||||
The `buf` module shows the currently installed version of [Buf](https://buf.build). By default, the module is shown if the current directory contains a [`buf.yaml`](https://docs.buf.build/configuration/v1/buf-yaml), [`buf.gen.yaml`](https://docs.buf.build/configuration/v1/buf-gen-yaml), or [`buf.work.yaml`](https://docs.buf.build/configuration/v1/buf-work-yaml) configuration file.
|
||||
|
||||
### Options
|
||||
|
||||
@ -635,7 +632,7 @@ format = 'via [🍔 $version](bold green) '
|
||||
|
||||
You can override the `detect_files` property of [the nodejs module](#nodejs) in your config so as to only show the bun runtime:
|
||||
|
||||
```
|
||||
```toml
|
||||
[nodejs]
|
||||
detect_files = ['package.json', '.node-version', '!bunfig.toml', '!bun.lockb']
|
||||
```
|
||||
@ -863,7 +860,7 @@ The `conda` module shows the current [Conda](https://docs.conda.io/en/latest/) e
|
||||
|
||||
::: tip
|
||||
|
||||
This does not suppress conda's own prompt modifier, you may want to run `conda config --set changeps1 False`.
|
||||
This does not suppress conda's own prompt modifier, you may want to run `conda config --set changeps1 False`. If you use [pixi](https://pixi.sh), you can disable pixi's prompt modifier by running `pixi config set change-ps1 false`.
|
||||
|
||||
:::
|
||||
|
||||
@ -1050,17 +1047,17 @@ format = 'via [🔰 $version](bold red) '
|
||||
|
||||
The `deno` module shows you your currently installed version of [Deno](https://deno.land/). By default the module will be shown if any of the following conditions are met:
|
||||
|
||||
- The current directory contains a `deno.json`, `deno.jsonc`, `mod.ts`, `mod.js`, `deps.ts` or `deps.js` file
|
||||
- The current directory contains a `deno.json`, `deno.jsonc`, `deno.lock`, `mod.ts`, `mod.js`, `deps.ts` or `deps.js` file
|
||||
|
||||
### 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 Deno |
|
||||
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['deno.json', 'deno.jsonc', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | Which filenames should trigger this module. |
|
||||
| `detect_files` | `['deno.json', 'deno.jsonc', 'deno.lock', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this module. |
|
||||
| `style` | `'green bold'` | The style for the module. |
|
||||
| `disabled` | `false` | Disables the `deno` module. |
|
||||
@ -1117,7 +1114,7 @@ For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, an
|
||||
| `fish_style_pwd_dir_length` | `0` | The number of characters to use when applying fish shell pwd path logic. |
|
||||
| `use_logical_path` | `true` | If `true` render the logical path sourced from the shell via `PWD` or `--logical-path`. If `false` instead render the physical filesystem path with symlinks resolved. |
|
||||
|
||||
`substitutions` allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories (i.e. Java). Note that this will disable the fish style PWD.
|
||||
`substitutions` allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories of Java. Note that this will disable the fish style PWD.
|
||||
|
||||
```toml
|
||||
[directory.substitutions]
|
||||
@ -1207,7 +1204,7 @@ disabled = false
|
||||
|
||||
## Docker Context
|
||||
|
||||
The `docker_context` module shows the currently active [Docker context](https://docs.docker.com/engine/context/working-with-contexts/) if it's not set to `default` or if the `DOCKER_MACHINE_NAME`, `DOCKER_HOST` or `DOCKER_CONTEXT` environment variables are set (as they are meant to override the context in use).
|
||||
The `docker_context` module shows the currently active [Docker context](https://docs.docker.com/engine/context/working-with-contexts/) if it's not set to `default` or `desktop-linux`, or if the `DOCKER_MACHINE_NAME`, `DOCKER_HOST` or `DOCKER_CONTEXT` environment variables are set (as they are meant to override the context in use).
|
||||
|
||||
### Options
|
||||
|
||||
@ -1890,7 +1887,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
|
||||
| `staged` | `'+'` | The format of `staged` |
|
||||
| `renamed` | `'»'` | The format of `renamed` |
|
||||
| `deleted` | `'✘'` | The format of `deleted` |
|
||||
| `typechanged` | `""` | The format of `typechange` |
|
||||
| `typechanged` | `""` | The format of `typechanged` |
|
||||
| `style` | `'bold red'` | The style for the module. |
|
||||
| `ignore_submodules` | `false` | Ignore changes to submodules. |
|
||||
| `disabled` | `false` | Disables the `git_status` module. |
|
||||
@ -1911,7 +1908,7 @@ The following variables can be used in `format`:
|
||||
| `staged` | Displays `staged` when a new file has been added to the staging area. |
|
||||
| `renamed` | Displays `renamed` when a renamed file has been added to the staging area. |
|
||||
| `deleted` | Displays `deleted` when a file's deletion has been added to the staging area. |
|
||||
| `typechanged` | Displays `typechange` when a file's type has been changed in the staging area. |
|
||||
| `typechanged` | Displays `typechanged` when a file's type has been changed in the staging area. |
|
||||
| style\* | Mirrors the value of option `style` |
|
||||
|
||||
*: This variable can only be used as a part of a style string
|
||||
@ -2257,6 +2254,7 @@ The `hostname` module shows the system hostname.
|
||||
| `format` | `'[$ssh_symbol$hostname]($style) in '` | The format for the module. |
|
||||
| `style` | `'bold dimmed green'` | The style for the module. |
|
||||
| `disabled` | `false` | Disables the `hostname` module. |
|
||||
| `aliases` | `{}` | Translate system hostnames to something else. If `trim_at` is specified, only the first part will be matched and replaced. |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -2293,6 +2291,14 @@ detect_env_vars = ['!TMUX', 'SSH_CONNECTION']
|
||||
disabled = false
|
||||
```
|
||||
|
||||
#### Replace the hostname with a nickname
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
[hostname]
|
||||
aliases = { "Max's MacBook Pro" = "home" }
|
||||
```
|
||||
|
||||
## Java
|
||||
|
||||
The `java` module shows the currently installed version of [Java](https://www.oracle.com/java/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2809,6 +2815,41 @@ truncation_length = 4
|
||||
truncation_symbol = ''
|
||||
```
|
||||
|
||||
## Mojo
|
||||
|
||||
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
|
||||
|
||||
### Options
|
||||
|
||||
| Option | Default | Description |
|
||||
| ------------------- | ------------------------------------- | ------------------------------------------------------ |
|
||||
| `format` | `'with [$symbol($version )]($style)'` | The format for the module. |
|
||||
| `symbol` | `'🔥 '` | The symbol used before displaying the version of Mojo. |
|
||||
| `style` | `'bold 208'` | The style for the module. |
|
||||
| `disabled` | `false` | Disables the `mojo` module. |
|
||||
| `detect_extensions` | `['mojo', '🔥']` | 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 | `24.4.0` | The version of `mojo` |
|
||||
| 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
|
||||
|
||||
[mojo]
|
||||
format = 'via [mojo ($version )($hash )]($style)'
|
||||
```
|
||||
|
||||
## NATS
|
||||
|
||||
The `nats` module shows the name of the current [NATS](https://nats.io) context.
|
||||
@ -2935,12 +2976,12 @@ The `nodejs` module shows the currently installed version of [Node.js](https://n
|
||||
### 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 Node.js. |
|
||||
| `detect_extensions` | `['js', 'mjs', 'cjs', 'ts', 'mts', 'cts']` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['package.json', '.node-version']` | Which filenames should trigger this module. |
|
||||
| `detect_files` | `['package.json', '.node-version', '.nvmrc']` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `['node_modules']` | Which folders should trigger this module. |
|
||||
| `style` | `'bold green'` | The style for the module. |
|
||||
| `disabled` | `false` | Disables the `nodejs` module. |
|
||||
@ -3492,13 +3533,15 @@ By default, the module will be shown if any of the following conditions are met:
|
||||
- The current directory contains a `requirements.txt` file
|
||||
- The current directory contains a `setup.py` file
|
||||
- The current directory contains a `tox.ini` file
|
||||
- The current directory contains a `pixi.toml` file
|
||||
- The current directory contains a file with the `.py` extension.
|
||||
- The current directory contains a file with the `.ipynb` extension.
|
||||
- A virtual environment is currently activated
|
||||
|
||||
### Options
|
||||
|
||||
| Option | Default | Description |
|
||||
| -------------------- | ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- |
|
||||
| -------------------- | ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
|
||||
| `format` | `'via [${symbol}${pyenv_prefix}(${version} )(\($virtualenv\) )]($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 Python |
|
||||
@ -3506,8 +3549,8 @@ By default, the module will be shown if any of the following conditions are met:
|
||||
| `pyenv_version_name` | `false` | Use pyenv to get Python version |
|
||||
| `pyenv_prefix` | `'pyenv'` | Prefix before pyenv version display, only used if pyenv is used |
|
||||
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should executes when getting the version. |
|
||||
| `detect_extensions` | `['py']` | Which extensions should trigger this module |
|
||||
| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini']` | Which filenames should trigger this module |
|
||||
| `detect_extensions` | `['py', 'ipynb']` | Which extensions should trigger this module |
|
||||
| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini', 'pixi.toml']` | Which filenames should trigger this module |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this module |
|
||||
| `disabled` | `false` | Disables the `python` module. |
|
||||
|
||||
@ -4350,7 +4393,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 |
|
||||
| `aliases` | `{}` | Translate system usernames to something else. |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -4361,7 +4404,7 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
|
||||
|
||||
### نموونە
|
||||
|
||||
#### Always show the hostname
|
||||
#### Always show the username
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
@ -4375,17 +4418,6 @@ show_always = true
|
||||
aliases = { "corpuser034g" = "matchai" }
|
||||
```
|
||||
|
||||
#### Hide the hostname in remote tmux sessions
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
[hostname]
|
||||
ssh_only = false
|
||||
detect_env_vars = ['!TMUX', 'SSH_CONNECTION']
|
||||
disabled = false
|
||||
```
|
||||
|
||||
## Vagrant
|
||||
|
||||
The `vagrant` module shows the currently installed version of [Vagrant](https://www.vagrantup.com/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -4573,7 +4605,7 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt
|
||||
| Option | Default | Description |
|
||||
| ------------------- | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `command` | `''` | The command whose output should be printed. The command will be passed on stdin to the shell. |
|
||||
| `when` | `false` | Either a boolean value (`true` or `false`, without quotes) or a string shell command used as a condition to show the module. In case of a string, the module will be shown if the command returns a `0` status code. |
|
||||
| `when` | `false` | Either a boolean value (`true` or `false`, without quotes) or a string shell command used as a condition to show the module. In case of a string, the module will be shown if the `shell` returns a `0` status code from executing it. |
|
||||
| `require_repo` | `false` | If `true`, the module will only be shown in paths containing a (git) repository. This option alone is not sufficient display condition in absence of other options. |
|
||||
| `shell` | | [See below](#custom-command-shell) |
|
||||
| `description` | `'<custom module>'` | The description of the module that is shown when running `starship explain`. |
|
||||
@ -4593,7 +4625,7 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt
|
||||
|
||||
| گۆڕاو | Description |
|
||||
| --------- | -------------------------------------- |
|
||||
| output | The output of shell command in `shell` |
|
||||
| output | The output of `command` run in `shell` |
|
||||
| symbol | Mirrors the value of option `symbol` |
|
||||
| style\* | Mirrors the value of option `style` |
|
||||
|
||||
@ -4608,7 +4640,7 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt
|
||||
|
||||
If unset, it will fallback to STARSHIP_SHELL and then to 'sh' on Linux, and 'cmd /C' on Windows.
|
||||
|
||||
The `command` will be passed in on stdin.
|
||||
The `command` (and `when`, if applicable) will be passed in on stdin.
|
||||
|
||||
If `shell` is not given or only contains one element and Starship detects PowerShell will be used, the following arguments will automatically be added: `-NoProfile -Command -`. If `shell` is not given or only contains one element and Starship detects Cmd will be used, the following argument will automatically be added: `/C` and `stdin` will be set to `false`. If `shell` is not given or only contains one element and Starship detects Nushell will be used, the following arguments will automatically be added: `-c` and `stdin` will be set to `false`. This behavior can be avoided by explicitly passing arguments to the shell, e.g.
|
||||
|
||||
|
||||
@ -427,7 +427,16 @@ 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)
|
||||
## 🔒 Code Signing Policy
|
||||
|
||||
Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org).
|
||||
|
||||
Code Signing Roles:
|
||||
|
||||
- Reviewers: [Astronauts](https://github.com/orgs/starship/teams/astronauts)
|
||||
- Approvers and Authors: [Mission Control](https://github.com/orgs/starship/teams/mission-control)
|
||||
|
||||
This program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it.
|
||||
|
||||
<p align="center">
|
||||
<br>
|
||||
|
||||
@ -12,6 +12,6 @@ This preset changes the format of all the built-in modules to show their segment
|
||||
starship preset bracketed-segments -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/bracketed-segments.toml)
|
||||
[Click to download TOML](/presets/toml/bracketed-segments.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/bracketed-segments.toml
|
||||
|
||||
@ -16,6 +16,6 @@ This preset is heavily inspired by [Pastel Powerline](./pastel-powerline.md), an
|
||||
starship preset gruvbox-rainbow -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/gruvbox-rainbow.toml)
|
||||
[Click to download TOML](/presets/toml/gruvbox-rainbow.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/gruvbox-rainbow.toml
|
||||
|
||||
@ -19,6 +19,6 @@ This is a pseudo minimalist preset inspired by the [geometry](https://github.com
|
||||
starship preset jetpack -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/jetpack.toml)
|
||||
[Click to download TOML](/presets/toml/jetpack.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/jetpack.toml
|
||||
|
||||
@ -16,6 +16,6 @@ This preset changes the symbols for each module to use Nerd Font symbols.
|
||||
starship preset nerd-font-symbols -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/nerd-font-symbols.toml)
|
||||
[Click to download TOML](/presets/toml/nerd-font-symbols.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/nerd-font-symbols.toml
|
||||
|
||||
@ -12,6 +12,6 @@ If toolset files are identified the toolset icon is displayed. If the toolset is
|
||||
starship preset no-empty-icons -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/no-empty-icons.toml)
|
||||
[Click to download TOML](/presets/toml/no-empty-icons.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/no-empty-icons.toml
|
||||
|
||||
@ -14,6 +14,6 @@ This preset will become the default preset in a future release of starship.
|
||||
starship preset no-nerd-font -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/no-nerd-font.toml)
|
||||
[Click to download TOML](/presets/toml/no-nerd-font.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/no-nerd-font.toml
|
||||
|
||||
@ -12,6 +12,6 @@
|
||||
starship preset no-runtime-versions -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/no-runtime-versions.toml)
|
||||
[Click to download TOML](/presets/toml/no-runtime-versions.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/no-runtime-versions.toml
|
||||
|
||||
@ -16,6 +16,6 @@ This preset is inspired by [M365Princess](https://github.com/JanDeDobbeleer/oh-m
|
||||
starship preset pastel-powerline -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/pastel-powerline.toml)
|
||||
[Click to download TOML](/presets/toml/pastel-powerline.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/pastel-powerline.toml
|
||||
|
||||
@ -12,6 +12,6 @@ This preset changes the symbols for each module into plain text. Great if you do
|
||||
starship preset plain-text-symbols -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/plain-text-symbols.toml)
|
||||
[Click to download TOML](/presets/toml/plain-text-symbols.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/plain-text-symbols.toml
|
||||
|
||||
@ -12,6 +12,6 @@
|
||||
starship preset pure-preset -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/pure-preset.toml)
|
||||
[Click to download TOML](/presets/toml/pure-preset.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/pure-preset.toml
|
||||
|
||||
@ -16,6 +16,6 @@ This preset is inspired by [tokyo-night-vscode-theme](https://github.com/enkia/t
|
||||
starship preset tokyo-night -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/tokyo-night.toml)
|
||||
[Click to download TOML](/presets/toml/tokyo-night.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/tokyo-night.toml
|
||||
|
||||
@ -554,10 +554,7 @@ discharging_symbol = '💦 '
|
||||
|
||||
## Buf
|
||||
|
||||
The `buf` module shows the currently installed version of [Buf](https://buf.build). By default, the module is shown if all of the following conditions are met:
|
||||
|
||||
- The [`buf`](https://github.com/bufbuild/buf) CLI is installed.
|
||||
- The current directory contains a [`buf.yaml`](https://docs.buf.build/configuration/v1/buf-yaml), [`buf.gen.yaml`](https://docs.buf.build/configuration/v1/buf-gen-yaml), or [`buf.work.yaml`](https://docs.buf.build/configuration/v1/buf-work-yaml) configuration file.
|
||||
The `buf` module shows the currently installed version of [Buf](https://buf.build). By default, the module is shown if the current directory contains a [`buf.yaml`](https://docs.buf.build/configuration/v1/buf-yaml), [`buf.gen.yaml`](https://docs.buf.build/configuration/v1/buf-gen-yaml), or [`buf.work.yaml`](https://docs.buf.build/configuration/v1/buf-work-yaml) configuration file.
|
||||
|
||||
### Optionen
|
||||
|
||||
@ -636,7 +633,7 @@ format = 'via [🍔 $version](bold green) '
|
||||
|
||||
You can override the `detect_files` property of [the nodejs module](#nodejs) in your config so as to only show the bun runtime:
|
||||
|
||||
```
|
||||
```toml
|
||||
[nodejs]
|
||||
detect_files = ['package.json', '.node-version', '!bunfig.toml', '!bun.lockb']
|
||||
```
|
||||
@ -864,7 +861,7 @@ The `conda` module shows the current [Conda](https://docs.conda.io/en/latest/) e
|
||||
|
||||
::: tip
|
||||
|
||||
Hinweis: Dies unterdrückt nicht conda's eigenen Prompt-Modifikator, sie können jedoch conda mit `conda config --set changeps1 False` konfigurieren, um die Ausgabe von conda selbst auszuschalten.
|
||||
Hinweis: Dies unterdrückt nicht conda's eigenen Prompt-Modifikator, sie können jedoch conda mit `conda config --set changeps1 False` konfigurieren, um die Ausgabe von conda selbst auszuschalten. If you use [pixi](https://pixi.sh), you can disable pixi's prompt modifier by running `pixi config set change-ps1 false`.
|
||||
|
||||
:::
|
||||
|
||||
@ -1051,17 +1048,17 @@ format = 'via [🔰 $version](bold red) '
|
||||
|
||||
The `deno` module shows you your currently installed version of [Deno](https://deno.land/). By default the module will be shown if any of the following conditions are met:
|
||||
|
||||
- The current directory contains a `deno.json`, `deno.jsonc`, `mod.ts`, `mod.js`, `deps.ts` or `deps.js` file
|
||||
- The current directory contains a `deno.json`, `deno.jsonc`, `deno.lock`, `mod.ts`, `mod.js`, `deps.ts` or `deps.js` file
|
||||
|
||||
### 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 Deno |
|
||||
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['deno.json', 'deno.jsonc', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | Which filenames should trigger this module. |
|
||||
| `detect_files` | `['deno.json', 'deno.jsonc', 'deno.lock', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this module. |
|
||||
| `style` | `'green bold'` | Stil für dieses Modul. |
|
||||
| `disabled` | `false` | Disables the `deno` module. |
|
||||
@ -1118,7 +1115,7 @@ For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, an
|
||||
| `fish_style_pwd_dir_length` | `0` | The number of characters to use when applying fish shell pwd path logic. |
|
||||
| `use_logical_path` | `true` | If `true` render the logical path sourced from the shell via `PWD` or `--logical-path`. If `false` instead render the physical filesystem path with symlinks resolved. |
|
||||
|
||||
`substitutions` allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories (i.e. Java). Note that this will disable the fish style PWD.
|
||||
`substitutions` allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories of Java. Note that this will disable the fish style PWD.
|
||||
|
||||
```toml
|
||||
[directory.substitutions]
|
||||
@ -1208,7 +1205,7 @@ disabled = false
|
||||
|
||||
## Docker Context
|
||||
|
||||
The `docker_context` module shows the currently active [Docker context](https://docs.docker.com/engine/context/working-with-contexts/) if it's not set to `default` or if the `DOCKER_MACHINE_NAME`, `DOCKER_HOST` or `DOCKER_CONTEXT` environment variables are set (as they are meant to override the context in use).
|
||||
The `docker_context` module shows the currently active [Docker context](https://docs.docker.com/engine/context/working-with-contexts/) if it's not set to `default` or `desktop-linux`, or if the `DOCKER_MACHINE_NAME`, `DOCKER_HOST` or `DOCKER_CONTEXT` environment variables are set (as they are meant to override the context in use).
|
||||
|
||||
### Optionen
|
||||
|
||||
@ -1891,7 +1888,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
|
||||
| `staged` | `'+'` | The format of `staged` |
|
||||
| `renamed` | `'»'` | The format of `renamed` |
|
||||
| `deleted` | `'✘'` | The format of `deleted` |
|
||||
| `typechanged` | `""` | The format of `typechange` |
|
||||
| `typechanged` | `""` | The format of `typechanged` |
|
||||
| `style` | `'bold red'` | Stil für dieses Modul. |
|
||||
| `ignore_submodules` | `false` | Ignore changes to submodules. |
|
||||
| `disabled` | `false` | Deaktiviert das `git_status`-Modul. |
|
||||
@ -1912,7 +1909,7 @@ The following variables can be used in `format`:
|
||||
| `staged` | Displays `staged` when a new file has been added to the staging area. |
|
||||
| `renamed` | Displays `renamed` when a renamed file has been added to the staging area. |
|
||||
| `deleted` | Displays `deleted` when a file's deletion has been added to the staging area. |
|
||||
| `typechanged` | Displays `typechange` when a file's type has been changed in the staging area. |
|
||||
| `typechanged` | Displays `typechanged` when a file's type has been changed in the staging area. |
|
||||
| style\* | Spiegelt den Wert der Option `style` |
|
||||
|
||||
*: This variable can only be used as a part of a style string
|
||||
@ -2258,6 +2255,7 @@ Das `hostname`-Modul zeigt den Hostnamen des Systems an.
|
||||
| `format` | `'[$ssh_symbol$hostname]($style) in '` | Das Format für das Modul. |
|
||||
| `style` | `'bold dimmed green'` | Stil für dieses Modul. |
|
||||
| `disabled` | `false` | Deaktiviert das `hostname`-Modul. |
|
||||
| `aliases` | `{}` | Translate system hostnames to something else. If `trim_at` is specified, only the first part will be matched and replaced. |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -2294,6 +2292,14 @@ detect_env_vars = ['!TMUX', 'SSH_CONNECTION']
|
||||
disabled = false
|
||||
```
|
||||
|
||||
#### Replace the hostname with a nickname
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
[hostname]
|
||||
aliases = { "Max's MacBook Pro" = "home" }
|
||||
```
|
||||
|
||||
## Java
|
||||
|
||||
The `java` module shows the currently installed version of [Java](https://www.oracle.com/java/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2810,6 +2816,41 @@ truncation_length = 4
|
||||
truncation_symbol = ''
|
||||
```
|
||||
|
||||
## Mojo
|
||||
|
||||
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
|
||||
|
||||
### Optionen
|
||||
|
||||
| Option | Standartwert | Beschreibung |
|
||||
| ------------------- | ------------------------------------- | ------------------------------------------------------ |
|
||||
| `format` | `'with [$symbol($version )]($style)'` | Das Format für das Modul. |
|
||||
| `symbol` | `'🔥 '` | The symbol used before displaying the version of Mojo. |
|
||||
| `style` | `'bold 208'` | Stil für dieses Modul. |
|
||||
| `disabled` | `false` | Disables the `mojo` module. |
|
||||
| `detect_extensions` | `['mojo', '🔥']` | 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 | `24.4.0` | The version of `mojo` |
|
||||
| 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
|
||||
|
||||
[mojo]
|
||||
format = 'via [mojo ($version )($hash )]($style)'
|
||||
```
|
||||
|
||||
## NATS
|
||||
|
||||
The `nats` module shows the name of the current [NATS](https://nats.io) context.
|
||||
@ -2936,12 +2977,12 @@ The `nodejs` module shows the currently installed version of [Node.js](https://n
|
||||
### 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 Node.js. |
|
||||
| `detect_extensions` | `['js', 'mjs', 'cjs', 'ts', 'mts', 'cts']` | Which extensions should trigger this module. |
|
||||
| `detect_files` | `['package.json', '.node-version']` | Which filenames should trigger this module. |
|
||||
| `detect_files` | `['package.json', '.node-version', '.nvmrc']` | Which filenames should trigger this module. |
|
||||
| `detect_folders` | `['node_modules']` | Which folders should trigger this module. |
|
||||
| `style` | `'bold green'` | Stil für dieses Modul. |
|
||||
| `disabled` | `false` | Deaktiviert das `nodejs`-Modul. |
|
||||
@ -3493,13 +3534,15 @@ By default, the module will be shown if any of the following conditions are met:
|
||||
- Das aktuelle Verzeichnis enthält eine `requirements.txt`-Datei
|
||||
- Das aktuelle Verzeichnis enthält eine `setup.py`-Datei
|
||||
- Das aktuelle Verzeichnis enthält eine `tox.ini`-Datei
|
||||
- Das aktuelle Verzeichnis enthält eine `pixi.toml`-Datei
|
||||
- Das aktuelle Verzeichnis enthält eine Datei mit der `.py`-Erweiterung.
|
||||
- The current directory contains a file with the `.ipynb` extension.
|
||||
- Ein virtualenv ist momentan aktiv
|
||||
|
||||
### Optionen
|
||||
|
||||
| Option | Standartwert | Beschreibung |
|
||||
| -------------------- | ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- |
|
||||
| -------------------- | ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
|
||||
| `format` | `'via [${symbol}${pyenv_prefix}(${version} )(\($virtualenv\) )]($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 Python |
|
||||
@ -3507,8 +3550,8 @@ By default, the module will be shown if any of the following conditions are met:
|
||||
| `pyenv_version_name` | `false` | Verwende `pyenv` um die Python-Versionzu beziehen. |
|
||||
| `pyenv_prefix` | `'pyenv'` | Prefix before pyenv version display, only used if pyenv is used |
|
||||
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should executes when getting the version. |
|
||||
| `detect_extensions` | `['py']` | Which extensions should trigger this module |
|
||||
| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini']` | Which filenames should trigger this module |
|
||||
| `detect_extensions` | `['py', 'ipynb']` | Which extensions should trigger this module |
|
||||
| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini', 'pixi.toml']` | Which filenames should trigger this module |
|
||||
| `detect_folders` | `[]` | Which folders should trigger this module |
|
||||
| `disabled` | `false` | Deaktiviert das `python`-Modul. |
|
||||
|
||||
@ -4351,7 +4394,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 |
|
||||
| `aliases` | `{}` | Translate system usernames to something else. |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -4362,7 +4405,7 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
|
||||
|
||||
### Beispiel
|
||||
|
||||
#### Always show the hostname
|
||||
#### Always show the username
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
@ -4376,17 +4419,6 @@ show_always = true
|
||||
aliases = { "corpuser034g" = "matchai" }
|
||||
```
|
||||
|
||||
#### Hide the hostname in remote tmux sessions
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
[hostname]
|
||||
ssh_only = false
|
||||
detect_env_vars = ['!TMUX', 'SSH_CONNECTION']
|
||||
disabled = false
|
||||
```
|
||||
|
||||
## Vagrant
|
||||
|
||||
The `vagrant` module shows the currently installed version of [Vagrant](https://www.vagrantup.com/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -4574,7 +4606,7 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt
|
||||
| Option | Standartwert | Beschreibung |
|
||||
| ------------------- | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `command` | `''` | The command whose output should be printed. The command will be passed on stdin to the shell. |
|
||||
| `when` | `false` | Either a boolean value (`true` or `false`, without quotes) or a string shell command used as a condition to show the module. In case of a string, the module will be shown if the command returns a `0` status code. |
|
||||
| `when` | `false` | Either a boolean value (`true` or `false`, without quotes) or a string shell command used as a condition to show the module. In case of a string, the module will be shown if the `shell` returns a `0` status code from executing it. |
|
||||
| `require_repo` | `false` | If `true`, the module will only be shown in paths containing a (git) repository. This option alone is not sufficient display condition in absence of other options. |
|
||||
| `shell` | | [See below](#custom-command-shell) |
|
||||
| `beschreibung` | `'<custom module>'` | The description of the module that is shown when running `starship explain`. |
|
||||
@ -4594,7 +4626,7 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt
|
||||
|
||||
| Variable | Beschreibung |
|
||||
| --------- | -------------------------------------- |
|
||||
| output | The output of shell command in `shell` |
|
||||
| output | The output of `command` run in `shell` |
|
||||
| symbol | Spiegelt den Wert der Option `symbol` |
|
||||
| style\* | Spiegelt den Wert der Option `style` |
|
||||
|
||||
@ -4609,7 +4641,7 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt
|
||||
|
||||
If unset, it will fallback to STARSHIP_SHELL and then to 'sh' on Linux, and 'cmd /C' on Windows.
|
||||
|
||||
The `command` will be passed in on stdin.
|
||||
The `command` (and `when`, if applicable) will be passed in on stdin.
|
||||
|
||||
If `shell` is not given or only contains one element and Starship detects PowerShell will be used, the following arguments will automatically be added: `-NoProfile -Command -`. If `shell` is not given or only contains one element and Starship detects Cmd will be used, the following argument will automatically be added: `/C` and `stdin` will be set to `false`. If `shell` is not given or only contains one element and Starship detects Nushell will be used, the following arguments will automatically be added: `-c` and `stdin` will be set to `false`. This behavior can be avoided by explicitly passing arguments to the shell, e.g.
|
||||
|
||||
|
||||
@ -431,7 +431,16 @@ 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)
|
||||
## 🔒 Code Signing Policy
|
||||
|
||||
Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org).
|
||||
|
||||
Code Signing Roles:
|
||||
|
||||
- Reviewers: [Astronauts](https://github.com/orgs/starship/teams/astronauts)
|
||||
- Approvers and Authors: [Mission Control](https://github.com/orgs/starship/teams/mission-control)
|
||||
|
||||
This program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it.
|
||||
|
||||
<p align="center">
|
||||
<br>
|
||||
|
||||
@ -12,6 +12,6 @@ This preset changes the format of all the built-in modules to show their segment
|
||||
starship preset bracketed-segments -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Zum Herunterladen der TOML Datei klicken](/presets/toml/bracketed-segments.toml)
|
||||
[Click to download TOML](/presets/toml/bracketed-segments.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/bracketed-segments.toml
|
||||
|
||||
@ -16,6 +16,6 @@ Diese Voreinstellung ist stark inspiriert von [Pastel Powerline](./pastel-powerl
|
||||
starship preset gruvbox-rainbow -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Zum Herunterladen der TOML Datei klicken](/presets/toml/gruvbox-rainbow.toml)
|
||||
[Click to download TOML](/presets/toml/gruvbox-rainbow.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/gruvbox-rainbow.toml
|
||||
|
||||
@ -19,6 +19,6 @@ This is a pseudo minimalist preset inspired by the [geometry](https://github.com
|
||||
starship preset jetpack -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Zum Herunterladen der TOML Datei klicken](/presets/toml/jetpack.toml)
|
||||
[Click to download TOML](/presets/toml/jetpack.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/jetpack.toml
|
||||
|
||||
@ -16,6 +16,6 @@ This preset changes the symbols for each module to use Nerd Font symbols.
|
||||
starship preset nerd-font-symbols -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Zum Herunterladen der TOML Datei klicken](/presets/toml/nerd-font-symbols.toml)
|
||||
[Click to download TOML](/presets/toml/nerd-font-symbols.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/nerd-font-symbols.toml
|
||||
|
||||
@ -12,6 +12,6 @@ If toolset files are identified the toolset icon is displayed. If the toolset is
|
||||
starship preset no-empty-icons -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Zum Herunterladen der TOML Datei klicken](/presets/toml/no-empty-icons.toml)
|
||||
[Click to download TOML](/presets/toml/no-empty-icons.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/no-empty-icons.toml
|
||||
|
||||
@ -14,6 +14,6 @@ This preset will become the default preset in a future release of starship.
|
||||
starship preset no-nerd-font -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Zum Herunterladen der TOML Datei klicken](/presets/toml/no-nerd-font.toml)
|
||||
[Click to download TOML](/presets/toml/no-nerd-font.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/no-nerd-font.toml
|
||||
|
||||
@ -12,6 +12,6 @@ This preset hides the version of language runtimes. If you work in containers or
|
||||
starship preset no-runtime-versions -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Zum Herunterladen der TOML Datei klicken](/presets/toml/no-runtime-versions.toml)
|
||||
[Click to download TOML](/presets/toml/no-runtime-versions.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/no-runtime-versions.toml
|
||||
|
||||
@ -16,6 +16,6 @@ This preset is inspired by [M365Princess](https://github.com/JanDeDobbeleer/oh-m
|
||||
starship preset pastel-powerline -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Zum Herunterladen der TOML Datei klicken](/presets/toml/pastel-powerline.toml)
|
||||
[Click to download TOML](/presets/toml/pastel-powerline.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/pastel-powerline.toml
|
||||
|
||||
@ -12,6 +12,6 @@ This preset changes the symbols for each module into plain text. Great if you do
|
||||
starship preset plain-text-symbols -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Zum Herunterladen der TOML Datei klicken](/presets/toml/plain-text-symbols.toml)
|
||||
[Click to download TOML](/presets/toml/plain-text-symbols.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/plain-text-symbols.toml
|
||||
|
||||
@ -12,6 +12,6 @@ Diese Voreinstellung emuliert das Aussehen und das Verhalten von [Pure](https://
|
||||
starship preset pure-preset -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Zum Herunterladen der TOML Datei klicken](/presets/toml/pure-preset.toml)
|
||||
[Click to download TOML](/presets/toml/pure-preset.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/pure-preset.toml
|
||||
|
||||
@ -16,6 +16,6 @@ This preset is inspired by [tokyo-night-vscode-theme](https://github.com/enkia/t
|
||||
starship preset tokyo-night -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Zum Herunterladen der TOML Datei klicken](/presets/toml/tokyo-night.toml)
|
||||
[Click to download TOML](/presets/toml/tokyo-night.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/tokyo-night.toml
|
||||
|
||||
@ -553,10 +553,7 @@ discharging_symbol = '💦 '
|
||||
|
||||
## Buf
|
||||
|
||||
El módulo `buf` muestra la versión instalada de [Buf](https://buf.build). Por defecto, el módulo se mostrará si se cumplen cualquiera de las siguientes condiciones:
|
||||
|
||||
- La CLI de [`buf`](https://github.com/bufbuild/buf) está instalada.
|
||||
- El directorio actual contiene un archivo de configuración [`buf.yaml`](https://docs.buf.build/configuration/v1/buf-yaml), [`buf.gen.yaml`](https://docs.buf.build/configuration/v1/buf-gen-yaml), o [`buf.work.yaml`](https://docs.buf.build/configuration/v1/buf-work-yaml).
|
||||
El módulo `buf` muestra la versión instalada de [Buf](https://buf.build). By default, the module is shown if the current directory contains a [`buf.yaml`](https://docs.buf.build/configuration/v1/buf-yaml), [`buf.gen.yaml`](https://docs.buf.build/configuration/v1/buf-gen-yaml), or [`buf.work.yaml`](https://docs.buf.build/configuration/v1/buf-work-yaml) configuration file.
|
||||
|
||||
### Opciones
|
||||
|
||||
@ -635,7 +632,7 @@ format = 'via [🍔 $version](bold green) '
|
||||
|
||||
You can override the `detect_files` property of [the nodejs module](#nodejs) in your config so as to only show the bun runtime:
|
||||
|
||||
```
|
||||
```toml
|
||||
[nodejs]
|
||||
detect_files = ['package.json', '.node-version', '!bunfig.toml', '!bun.lockb']
|
||||
```
|
||||
@ -863,7 +860,7 @@ El módulo `conda` muestra el entorno actual [Conda](https://docs.conda.io/en/la
|
||||
|
||||
::: tip
|
||||
|
||||
Esto no modifica el propio símbolo de sistema de Conda. En caso de querer suprimirlo, ejecuta `conda config --set changeps1 False`.
|
||||
Esto no modifica el propio símbolo de sistema de Conda. En caso de querer suprimirlo, ejecuta `conda config --set changeps1 False`. If you use [pixi](https://pixi.sh), you can disable pixi's prompt modifier by running `pixi config set change-ps1 false`.
|
||||
|
||||
:::
|
||||
|
||||
@ -1050,17 +1047,17 @@ format = 'via [🔰 $version](bold red) '
|
||||
|
||||
El módulo `deno` le muestra la versión instalada de [Deno](https://deno.land/). Por defecto, el módulo se mostrará si se cumplen cualquiera de las siguientes condiciones:
|
||||
|
||||
- El directorio actual contiene un archivo `deno.json`, `deno.jsonc`, `mod.ts`, `mod.js`, `deps.ts` o `deps.js`
|
||||
- The current directory contains a `deno.json`, `deno.jsonc`, `deno.lock`, `mod.ts`, `mod.js`, `deps.ts` or `deps.js` file
|
||||
|
||||
### 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 Deno |
|
||||
| `detect_extensions` | `[]` | Qué extensiones deberían activar este módulo. |
|
||||
| `detect_files` | `['deno.json', 'deno.jsonc', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | Qué nombres de archivo deberían activar este módulo. |
|
||||
| `detect_files` | `['deno.json', 'deno.jsonc', 'deno.lock', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | Qué nombres de archivo deberían activar este módulo. |
|
||||
| `detect_folders` | `[]` | Qué carpetas deberían activar este módulo. |
|
||||
| `style` | `'green bold'` | El estilo del módulo. |
|
||||
| `disabled` | `false` | Deshabilita el módulo `deno`. |
|
||||
@ -1117,7 +1114,7 @@ Por ejemplo, dado `~/Dev/Nix/nixpkgs/pkgs` donde `nixpkgs` es la raíz del repos
|
||||
| `fish_style_pwd_dir_length` | `0` | El número de caracteres a usar al aplicar la lógica de ruta pwd del intérprete de comandos de Fish. |
|
||||
| `use_logical_path` | `true` | Si `true` renderiza la ruta lógica originada desde el intérprete de comandos a través de `PWD` o `--logical-path`. Si `false` en su lugar renderiza la ruta física del sistema de archivos con enlaces simbólicos resueltos. |
|
||||
|
||||
`substitutions` permite definir reemplazos arbitrarios para cadenas literales que ocurren en la ruta, por ejemplo prefijos largos de red o directorios de desarrollo (p. ej. Java). Ten en cuenta que esto desactivará el estilo PWD de fish.
|
||||
`substitutions` allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories of Java. Ten en cuenta que esto desactivará el estilo PWD de fish.
|
||||
|
||||
```toml
|
||||
[directory.substitutions]
|
||||
@ -1207,7 +1204,7 @@ disabled = false
|
||||
|
||||
## Contexto de Docker
|
||||
|
||||
El módulo `docker_context` muestra el [contexto de Docker](https://docs.docker.com/engine/context/working-with-contexts/) actualmente activo si no está definido en `default` o si las variables de entorno `DOCKER_MACHINE_NAME`, `DOCKER_HOST` o `DOCKER_CONTEXT` están definidas (como se entiende para sobrescribir el contexto en uso).
|
||||
The `docker_context` module shows the currently active [Docker context](https://docs.docker.com/engine/context/working-with-contexts/) if it's not set to `default` or `desktop-linux`, or if the `DOCKER_MACHINE_NAME`, `DOCKER_HOST` or `DOCKER_CONTEXT` environment variables are set (as they are meant to override the context in use).
|
||||
|
||||
### Opciones
|
||||
|
||||
@ -1890,7 +1887,7 @@ El módulo Git Status es muy lento en los directorios de Windows (por ejemplo ba
|
||||
| `staged` | `'+'` | El formato de `staged` |
|
||||
| `renamed` | `'»'` | El formato de `renamed` |
|
||||
| `eliminado` | `'✘'` | El formato de `deleted` |
|
||||
| `typechanged` | `""` | The format of `typechange` |
|
||||
| `typechanged` | `""` | The format of `typechanged` |
|
||||
| `style` | `'bold red'` | El estilo del módulo. |
|
||||
| `ignore_submodules` | `false` | Ignorar cambios a los submódulos. |
|
||||
| `disabled` | `false` | Deshabilita el módulo `git_status`. |
|
||||
@ -1911,7 +1908,7 @@ Las siguientes variables se pueden utilizar en `format`:
|
||||
| `staged` | Muestra `staged` cuando se ha añadido un nuevo archivo al área de preparación. |
|
||||
| `renamed` | Muestra `renamed` cuando un archivo renombrado ha sido añadido al área de preparación. |
|
||||
| `eliminado` | Muestra `deleted` cuando un archivo ha sido añadido al área de preparación. |
|
||||
| `typechanged` | Displays `typechange` when a file's type has been changed in the staging area. |
|
||||
| `typechanged` | Displays `typechanged` when a file's type has been changed in the staging area. |
|
||||
| style\* | Refleja el valor de la opción `style` |
|
||||
|
||||
*: Esta variable solamente puede ser usada como parte de una cadena de caracteres de estilo
|
||||
@ -2257,6 +2254,7 @@ El módulo `hostname` muestra el nombre de host del sistema.
|
||||
| `format` | `'[$ssh_symbol$hostname]($style) in '` | El formato del módulo. |
|
||||
| `style` | `'negrita oscurecida verde'` | El estilo del módulo. |
|
||||
| `disabled` | `false` | Deshabilita el módulo `hostname`. |
|
||||
| `aliases` | `{}` | Translate system hostnames to something else. If `trim_at` is specified, only the first part will be matched and replaced. |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -2293,6 +2291,14 @@ detect_env_vars = ['!TMUX', 'SSH_CONNECTION']
|
||||
disabled = false
|
||||
```
|
||||
|
||||
#### Replace the hostname with a nickname
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
[hostname]
|
||||
aliases = { "Max's MacBook Pro" = "home" }
|
||||
```
|
||||
|
||||
## Java
|
||||
|
||||
El módulo `java` muestra la versión instalada de [Java](https://www.oracle.com/java/). Por defecto, el módulo se mostrará si se cumplen cualquiera de las siguientes condiciones:
|
||||
@ -2809,6 +2815,41 @@ truncation_length = 4
|
||||
truncation_symbol = ''
|
||||
```
|
||||
|
||||
## Mojo
|
||||
|
||||
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
|
||||
|
||||
### Opciones
|
||||
|
||||
| Opción | Predeterminado | Descripción |
|
||||
| ------------------- | ------------------------------------- | ------------------------------------------------------ |
|
||||
| `format` | `'with [$symbol($version )]($style)'` | El formato del módulo. |
|
||||
| `symbol` | `'🔥 '` | The symbol used before displaying the version of Mojo. |
|
||||
| `style` | `'bold 208'` | El estilo del módulo. |
|
||||
| `disabled` | `false` | Disables the `mojo` module. |
|
||||
| `detect_extensions` | `['mojo', '🔥']` | 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 | `24.4.0` | The version of `mojo` |
|
||||
| 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
|
||||
|
||||
[mojo]
|
||||
format = 'via [mojo ($version )($hash )]($style)'
|
||||
```
|
||||
|
||||
## NATS
|
||||
|
||||
The `nats` module shows the name of the current [NATS](https://nats.io) context.
|
||||
@ -2935,12 +2976,12 @@ El módulo `nodejs` muestra la versión instalada de [Node.js](https://nodejs.or
|
||||
### 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 Node.js. |
|
||||
| `detect_extensions` | `['js', 'mjs', 'cjs', 'ts', 'mts', 'cts']` | Qué extensiones deberían activar este módulo. |
|
||||
| `detect_files` | `['package.json', '.node-version']` | Qué nombres de archivo deberían activar este módulo. |
|
||||
| `detect_files` | `['package.json', '.node-version', '.nvmrc']` | Qué nombres de archivo deberían activar este módulo. |
|
||||
| `detect_folders` | `['node_modules']` | Qué carpetas deberían activar este módulo. |
|
||||
| `style` | `'bold green'` | El estilo del módulo. |
|
||||
| `disabled` | `false` | Deshabilita el módulo `nodejs`. |
|
||||
@ -3492,13 +3533,15 @@ Por defecto, el módulo se mostrará si se cumplen cualquiera de las siguientes
|
||||
- El directorio actual contiene un archivo `requirements.txt`
|
||||
- El directorio actual contiene un archivo `setup.py`
|
||||
- El directorio actual contiene un archivo `tox.ini`
|
||||
- El directorio actual contiene un archivo `pixi.toml`
|
||||
- El directorio actual contiene un archivo con la extensión `.py`.
|
||||
- The current directory contains a file with the `.ipynb` extension.
|
||||
- Un entorno virtual está activado actualmente
|
||||
|
||||
### Opciones
|
||||
|
||||
| Opción | Predeterminado | Descripción |
|
||||
| -------------------- | ------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------- |
|
||||
| -------------------- | ------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
|
||||
| `format` | `'via [${symbol}${pyenv_prefix}(${version} )(\($virtualenv\) )]($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 Python |
|
||||
@ -3506,8 +3549,8 @@ Por defecto, el módulo se mostrará si se cumplen cualquiera de las siguientes
|
||||
| `pyenv_version_name` | `false` | Usar pyenv para obtener la versión de Python |
|
||||
| `pyenv_prefix` | `'pyenv'` | Prefijo antes de mostrar la versión de pyenv sólo se utiliza si se utiliza pyenv |
|
||||
| `python_binary` | `['python', 'python3', 'python2']` | Configura los binarios de python que Starship debería ejecutar al obtener la versión. |
|
||||
| `detect_extensions` | `['py']` | Qué extensiones deben activar este módulo |
|
||||
| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini']` | Qué nombres de archivo deben activar este módulo |
|
||||
| `detect_extensions` | `['py', 'ipynb']` | Qué extensiones deben activar este módulo |
|
||||
| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini', 'pixi.toml']` | Qué nombres de archivo deben activar este módulo |
|
||||
| `detect_folders` | `[]` | Qué carpetas deben activar este módulo |
|
||||
| `disabled` | `false` | Deshabilita el módulo `python`. |
|
||||
|
||||
@ -4350,7 +4393,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 |
|
||||
| `aliases` | `{}` | Translate system usernames to something else. |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -4361,7 +4404,7 @@ La conexión SSH se detecta comprobando las variables de entorno `SSH_CONNECTION
|
||||
|
||||
### Ejemplo
|
||||
|
||||
#### Mostrar siempre el nombre del host
|
||||
#### Always show the username
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
@ -4375,17 +4418,6 @@ show_always = true
|
||||
aliases = { "corpuser034g" = "matchai" }
|
||||
```
|
||||
|
||||
#### Ocultar el nombre de host en sesiones remotas de tmux
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
[hostname]
|
||||
ssh_only = false
|
||||
detect_env_vars = ['!TMUX', 'SSH_CONNECTION']
|
||||
disabled = false
|
||||
```
|
||||
|
||||
## Vagrant
|
||||
|
||||
El módulo `vagrant` muestra la versión instalada de [Vagrant](https://www.vagrantup.com/). Por defecto, el módulo se mostrará si se cumplen cualquiera de las siguientes condiciones:
|
||||
@ -4573,7 +4605,7 @@ Las cadenas de formato también pueden contener secuencias específicas del int
|
||||
| Opción | Predeterminado | Descripción |
|
||||
| ------------------- | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `comando` | `''` | El comando cuya salida debe ser impresa. El comando se pasará en stdin al intérprete de comandos. |
|
||||
| `cuando` | `false` | Valor booleano (`true` o `false`, sin comillas) o un comando de shell usado como una condición para mostrar el módulo. En caso de una cadena, el módulo se mostrará si el comando devuelve un código de estado `0`. |
|
||||
| `cuando` | `false` | Valor booleano (`true` o `false`, sin comillas) o un comando de shell usado como una condición para mostrar el módulo. In case of a string, the module will be shown if the `shell` returns a `0` status code from executing it. |
|
||||
| `require_repo` | `false` | If `true`, the module will only be shown in paths containing a (git) repository. This option alone is not sufficient display condition in absence of other options. |
|
||||
| `shell` | | [Ver a continuación](#custom-command-shell) |
|
||||
| `description` | `'<módulo personalizado>'` | La descripción del módulo que se muestra al ejecutar `starship explain`. |
|
||||
@ -4592,8 +4624,8 @@ Las cadenas de formato también pueden contener secuencias específicas del int
|
||||
### Variables
|
||||
|
||||
| Variable | Descripción |
|
||||
| --------- | ----------------------------------------------------------- |
|
||||
| salida | La salida del comando del intérprete de comandos en `shell` |
|
||||
| --------- | -------------------------------------- |
|
||||
| salida | The output of `command` run in `shell` |
|
||||
| symbol | Refleja el valor de la opción `symbol` |
|
||||
| style\* | Refleja el valor de la opción `style` |
|
||||
|
||||
@ -4608,7 +4640,7 @@ Las cadenas de formato también pueden contener secuencias específicas del int
|
||||
|
||||
If unset, it will fallback to STARSHIP_SHELL and then to 'sh' on Linux, and 'cmd /C' on Windows.
|
||||
|
||||
El `comando` será pasado en stdin.
|
||||
The `command` (and `when`, if applicable) will be passed in on stdin.
|
||||
|
||||
Si no se da el `shell` o solo contiene un elemento y Starship detecta PowerShell los siguientes argumentos se añadirán automáticamente: `-NoProfile -Command -`. If `shell` is not given or only contains one element and Starship detects Cmd will be used, the following argument will automatically be added: `/C` and `stdin` will be set to `false`. If `shell` is not given or only contains one element and Starship detects Nushell will be used, the following arguments will automatically be added: `-c` and `stdin` will be set to `false`. Este comportamiento puede evitarse pasando explícitamente argumentos al intérprete de comandos, p.ej.
|
||||
|
||||
|
||||
@ -431,7 +431,16 @@ 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)
|
||||
## 🔒 Code Signing Policy
|
||||
|
||||
Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org).
|
||||
|
||||
Code Signing Roles:
|
||||
|
||||
- Reviewers: [Astronauts](https://github.com/orgs/starship/teams/astronauts)
|
||||
- Approvers and Authors: [Mission Control](https://github.com/orgs/starship/teams/mission-control)
|
||||
|
||||
This program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it.
|
||||
|
||||
<p align="center">
|
||||
<br>
|
||||
|
||||
@ -12,6 +12,6 @@ Este preajuste cambia el formato de todos los módulos incorporados para mostrar
|
||||
starship preset bracketed-segments -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Clic para descargar TOML](/presets/toml/bracketed-segments.toml)
|
||||
[Click to download TOML](/presets/toml/bracketed-segments.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/bracketed-segments.toml
|
||||
|
||||
@ -16,6 +16,6 @@ Este preajuste está muy inspirado en [Pastel Powerline](./pastel-powerline.md)
|
||||
starship preset gruvbox-rainbow -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Clic para descargar TOML](/presets/toml/gruvbox-rainbow.toml)
|
||||
[Click to download TOML](/presets/toml/gruvbox-rainbow.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/gruvbox-rainbow.toml
|
||||
|
||||
@ -19,6 +19,6 @@ Este es un preajuste pseudominimalista inspirado en las indicaciones [geometría
|
||||
starship preset jetpack -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Clic para descargar TOML](/presets/toml/jetpack.toml)
|
||||
[Click to download TOML](/presets/toml/jetpack.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/jetpack.toml
|
||||
|
||||
@ -16,6 +16,6 @@ Este preajuste cambia los símbolos de cada módulo para usar símbolos Nerd Fon
|
||||
starship preset nerd-font-symbols -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Clic para descargar TOML](/presets/toml/nerd-font-symbols.toml)
|
||||
[Click to download TOML](/presets/toml/nerd-font-symbols.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/nerd-font-symbols.toml
|
||||
|
||||
@ -12,6 +12,6 @@ Si se identifican archivos del conjunto de herramientas, entonces se mostrara el
|
||||
starship preset no-empty-icons -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Clic para descargar TOML](/presets/toml/no-empty-icons.toml)
|
||||
[Click to download TOML](/presets/toml/no-empty-icons.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/no-empty-icons.toml
|
||||
|
||||
@ -14,6 +14,6 @@ Este preset será el predeterminado en una futura versión de starship.
|
||||
starship preset no-nerd-font -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Clic para descargar TOML](/presets/toml/no-nerd-font.toml)
|
||||
[Click to download TOML](/presets/toml/no-nerd-font.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/no-nerd-font.toml
|
||||
|
||||
@ -12,6 +12,6 @@ Este preajuste oculta la versión de los tiempos de ejecución del idioma. Si tr
|
||||
starship preset no-runtime-versions -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Clic para descargar TOML](/presets/toml/no-runtime-versions.toml)
|
||||
[Click to download TOML](/presets/toml/no-runtime-versions.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/no-runtime-versions.toml
|
||||
|
||||
@ -16,6 +16,6 @@ Este preajuste está inspirado en [M365Princess](https://github.com/JanDeDobbele
|
||||
starship preset pastel-powerline -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Clic para descargar TOML](/presets/toml/pastel-powerline.toml)
|
||||
[Click to download TOML](/presets/toml/pastel-powerline.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/pastel-powerline.toml
|
||||
|
||||
@ -12,6 +12,6 @@ Este preajuste cambia los símbolos a texto sin formato. Bueno si usted no tiene
|
||||
starship preset plain-text-symbols -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Clic para descargar TOML](/presets/toml/plain-text-symbols.toml)
|
||||
[Click to download TOML](/presets/toml/plain-text-symbols.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/plain-text-symbols.toml
|
||||
|
||||
@ -12,6 +12,6 @@ Esta preajuste emula la apariencia y el comportamiento de [Pure](https://github.
|
||||
starship preset pure-preset -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Clic para descargar TOML](/presets/toml/pure-preset.toml)
|
||||
[Click to download TOML](/presets/toml/pure-preset.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/pure-preset.toml
|
||||
|
||||
@ -16,6 +16,6 @@ Este preset está inspirado en [tokyo-night-vscode-theme](https://github.com/enk
|
||||
starship preset tokyo-night -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Clic para descargar TOML](/presets/toml/tokyo-night.toml)
|
||||
[Click to download TOML](/presets/toml/tokyo-night.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/tokyo-night.toml
|
||||
|
||||
@ -553,10 +553,7 @@ discharging_symbol = '💦 '
|
||||
|
||||
## Buf
|
||||
|
||||
Le module `buf` affiche la version de [Buf](https://buf.build) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
|
||||
|
||||
- La commande [`buf`](https://github.com/bufbuild/buf) est installée.
|
||||
- Le dossier actuel contient un fichier de configuration [`buf.yaml`](https://docs.buf.build/configuration/v1/buf-yaml), [`buf.gen.yaml`](https://docs.buf.build/configuration/v1/buf-gen-yaml) ou [`buf.work.yaml`](https://docs.buf.build/configuration/v1/buf-work-yaml).
|
||||
Le module `buf` affiche la version de [Buf](https://buf.build) installée. By default, the module is shown if the current directory contains a [`buf.yaml`](https://docs.buf.build/configuration/v1/buf-yaml), [`buf.gen.yaml`](https://docs.buf.build/configuration/v1/buf-gen-yaml), or [`buf.work.yaml`](https://docs.buf.build/configuration/v1/buf-work-yaml) configuration file.
|
||||
|
||||
### Options
|
||||
|
||||
@ -635,7 +632,7 @@ format = 'via [🍔 $version](bold green) '
|
||||
|
||||
You can override the `detect_files` property of [the nodejs module](#nodejs) in your config so as to only show the bun runtime:
|
||||
|
||||
```
|
||||
```toml
|
||||
[nodejs]
|
||||
detect_files = ['package.json', '.node-version', '!bunfig.toml', '!bun.lockb']
|
||||
```
|
||||
@ -863,7 +860,7 @@ Le module `conda` affiche l’environnement [Conda](https://docs.conda.io/en/lat
|
||||
|
||||
::: tip
|
||||
|
||||
Cela ne supprime pas le modificateur d'invite de conda, vous pourriez vouloir exécuter `conda config --set changeps1 False` pour le désactiver.
|
||||
Cela ne supprime pas le modificateur d'invite de conda, vous pourriez vouloir exécuter `conda config --set changeps1 False` pour le désactiver. If you use [pixi](https://pixi.sh), you can disable pixi's prompt modifier by running `pixi config set change-ps1 false`.
|
||||
|
||||
:::
|
||||
|
||||
@ -1050,17 +1047,17 @@ format = 'via [🔰 $version](bold red) '
|
||||
|
||||
Le module `deno` affiche la version de [Deno](https://deno.land/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
|
||||
|
||||
- Le dossier courant contient un fichier `deno.json`, `deno.jsonc`, `mod.ts`, `mod.js`, `deps.ts` ou `deps.js`
|
||||
- The current directory contains a `deno.json`, `deno.jsonc`, `deno.lock`, `mod.ts`, `mod.js`, `deps.ts` or `deps.js` file
|
||||
|
||||
### 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 Deno |
|
||||
| `detect_extensionsdetect_extensions` | `[]` | Les extensions qui déclenchent ce module. |
|
||||
| `detect_files` | `['deno.json', 'deno.jsonc', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | Les fichiers qui activent ce module. |
|
||||
| `detect_files` | `['deno.json', 'deno.jsonc', 'deno.lock', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | Les fichiers qui activent ce module. |
|
||||
| `detect_folders` | `[]` | Les dossiers qui activent ce module. |
|
||||
| `style` | `'green bold'` | Le style pour le module. |
|
||||
| `disabled` | `false` | Désactive le module `deno`. |
|
||||
@ -1117,7 +1114,7 @@ Par exemple, `~/Dev/Nix/nixpkgs/pkgs` où `nixpkgs` est la racine du repo, et l'
|
||||
| `fish_style_pwd_dir_length` | `0` | Le nombre de caractères à utiliser lors de l'application de la logique de troncature du pwd de fish. |
|
||||
| `use_logical_path` | `true` | Si `true` affiche le chemin logique issu du shell via `PWD` ou `--logical-path`. Si `false` renvoie plutôt le chemin du système de fichiers physique avec les liens symboliques résolus. |
|
||||
|
||||
`substitutions` vous permet de définir des remplacements arbitraires pour les chaînes littérales qui apparaissent dans le chemin, par exemple pour de longs préfixes de réseau ou des répertoires de développement (ex. Java). Notez que cela désactivera la PWD de style fish.
|
||||
`substitutions` allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories of Java. Notez que cela désactivera la PWD de style fish.
|
||||
|
||||
```toml
|
||||
[directory.substitutions]
|
||||
@ -1207,7 +1204,7 @@ disabled = false
|
||||
|
||||
## Contexte Docker
|
||||
|
||||
Le module `docker_context` affiche le [context Docker](https://docs.docker.com/engine/context/working-with-contexts/) actif, si sa valeur est différente de `default` ou si les variables d’environnement `DOCKER_MACHINE_NAME`, `DOCKER_HOST` ou `DOCKER_CONTEXT` sont définies (puisqu’elles sont utilisées pour changer le contexte utilisé).
|
||||
The `docker_context` module shows the currently active [Docker context](https://docs.docker.com/engine/context/working-with-contexts/) if it's not set to `default` or `desktop-linux`, or if the `DOCKER_MACHINE_NAME`, `DOCKER_HOST` or `DOCKER_CONTEXT` environment variables are set (as they are meant to override the context in use).
|
||||
|
||||
### Options
|
||||
|
||||
@ -1890,7 +1887,7 @@ Le module Statut Git est très lent dans les dossiers Windows (par exemple sous
|
||||
| `staged` | `'+'` | Le format de `staged` |
|
||||
| `renamed` | `'»'` | Le format de `renamed` |
|
||||
| `deleted` | `'✘'` | Le format de `deleted` |
|
||||
| `typechanged` | `""` | The format of `typechange` |
|
||||
| `typechanged` | `""` | The format of `typechanged` |
|
||||
| `style` | `'bold red'` | Le style pour le module. |
|
||||
| `ignore_submodules` | `false` | Ignorer les changements des sous-modules. |
|
||||
| `disabled` | `false` | Désactive le module `git_status`. |
|
||||
@ -1911,7 +1908,7 @@ Les variables suivantes peuvent être utilisées pour la valeur de `format`:
|
||||
| `staged` | Affiche `staged` lorsqu'un nouveau fichier a été ajouté à la zone de validation. |
|
||||
| `renamed` | Affiche `renamed` lorsqu'un fichier renommé a été ajouté à la zone de validation. |
|
||||
| `deleted` | Affiche `deleted` lorsque la suppression d'un fichier a été ajoutée à la zone de validation. |
|
||||
| `typechanged` | Displays `typechange` when a file's type has been changed in the staging area. |
|
||||
| `typechanged` | Displays `typechanged` when a file's type has been changed in the staging area. |
|
||||
| style\* | Reflète la valeur de l'option `style` |
|
||||
|
||||
*: Cette variable peut uniquement être utilisée dans une chaine de style
|
||||
@ -2257,6 +2254,7 @@ Le module `hostname` affiche le nom d’hôte du système system.
|
||||
| `format` | `'[$ssh_symbol$hostname]($style) in '` | Format du module. |
|
||||
| `style` | `'bold dimmed green'` | Le style pour le module. |
|
||||
| `disabled` | `false` | Désactive le module `hostname`. |
|
||||
| `aliases` | `{}` | Translate system hostnames to something else. If `trim_at` is specified, only the first part will be matched and replaced. |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -2293,6 +2291,14 @@ detect_env_vars = ['!TMUX', 'SSH_CONNECTION']
|
||||
disabled = false
|
||||
```
|
||||
|
||||
#### Replace the hostname with a nickname
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
[hostname]
|
||||
aliases = { "Max's MacBook Pro" = "home" }
|
||||
```
|
||||
|
||||
## Java
|
||||
|
||||
Le module `java` affiche la version de [Java](https://www.oracle.com/java/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
|
||||
@ -2809,6 +2815,41 @@ truncation_length = 4
|
||||
truncation_symbol = ''
|
||||
```
|
||||
|
||||
## Mojo
|
||||
|
||||
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
|
||||
|
||||
### Options
|
||||
|
||||
| Option | Défaut | Description |
|
||||
| ------------------------------------ | ------------------------------------- | ------------------------------------------------------ |
|
||||
| `format` | `'with [$symbol($version )]($style)'` | Format du module. |
|
||||
| `symbole` | `'🔥 '` | The symbol used before displaying the version of Mojo. |
|
||||
| `style` | `'bold 208'` | Le style pour le module. |
|
||||
| `disabled` | `false` | Disables the `mojo` module. |
|
||||
| `detect_extensionsdetect_extensions` | `['mojo', '🔥']` | 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 | `24.4.0` | The version of `mojo` |
|
||||
| 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
|
||||
|
||||
[mojo]
|
||||
format = 'via [mojo ($version )($hash )]($style)'
|
||||
```
|
||||
|
||||
## NATS
|
||||
|
||||
The `nats` module shows the name of the current [NATS](https://nats.io) context.
|
||||
@ -2935,12 +2976,12 @@ Le module `nodejs` affiche la version de [Node.js](https://nodejs.org/) install
|
||||
### 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 Node.js. |
|
||||
| `detect_extensionsdetect_extensions` | `['js', 'mjs', 'cjs', 'ts', 'mts', 'cts']` | Les extensions qui déclenchent ce module. |
|
||||
| `detect_files` | `['package.json', '.node-version']` | Les fichiers qui activent ce module. |
|
||||
| `detect_files` | `['package.json', '.node-version', '.nvmrc']` | Les fichiers qui activent ce module. |
|
||||
| `detect_folders` | `['node_modules']` | Les dossiers qui activent ce module. |
|
||||
| `style` | `'bold green'` | Le style pour le module. |
|
||||
| `disabled` | `false` | Désactive le module `nodejs`. |
|
||||
@ -3492,13 +3533,15 @@ Par défaut, le module sera affiché si l’une de ces conditions est remplie:
|
||||
- Le dossier courant contient un fichier `requirements.txt`
|
||||
- Le dossier courant contient un fichier `setup.py`
|
||||
- Le dossier courant contient un fichier `tox.ini`
|
||||
- Le dossier courant contient un fichier `pixi.toml`
|
||||
- Le dossier courant contient un fichier avec l’extension `.py`.
|
||||
- The current directory contains a file with the `.ipynb` extension.
|
||||
- Un environnement virtuel est actuellement activé
|
||||
|
||||
### Options
|
||||
|
||||
| Option | Défaut | Description |
|
||||
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ |
|
||||
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
|
||||
| `format` | `'via [${symbol}${pyenv_prefix}(${version} )(\($virtualenv\) )]($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 Python |
|
||||
@ -3506,8 +3549,8 @@ Par défaut, le module sera affiché si l’une de ces conditions est remplie:
|
||||
| `pyenv_version_name` | `false` | Utiliser pyenv pour obtenir la version de Python |
|
||||
| `pyenv_prefix` | `'pyenv'` | Prefix before pyenv version display, only used if pyenv is used |
|
||||
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should executes when getting the version. |
|
||||
| `detect_extensionsdetect_extensions` | `['py']` | Les extensions qui déclenchent ce module |
|
||||
| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini']` | Quels fichiers devraient activer ce module |
|
||||
| `detect_extensionsdetect_extensions` | `['py', 'ipynb']` | Les extensions qui déclenchent ce module |
|
||||
| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini', 'pixi.toml']` | Quels fichiers devraient activer ce module |
|
||||
| `detect_folders` | `[]` | Quels dossiers devraient activer ce module |
|
||||
| `disabled` | `false` | Désactive le module `python`. |
|
||||
|
||||
@ -4350,7 +4393,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 |
|
||||
| `aliases` | `{}` | Translate system usernames to something else. |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -4361,7 +4404,7 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
|
||||
|
||||
### Exemple
|
||||
|
||||
#### Always show the hostname
|
||||
#### Always show the username
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
@ -4375,17 +4418,6 @@ show_always = true
|
||||
aliases = { "corpuser034g" = "matchai" }
|
||||
```
|
||||
|
||||
#### Hide the hostname in remote tmux sessions
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
[hostname]
|
||||
ssh_only = false
|
||||
detect_env_vars = ['!TMUX', 'SSH_CONNECTION']
|
||||
disabled = false
|
||||
```
|
||||
|
||||
## Vagrant
|
||||
|
||||
Le module `vagrant` affiche la version de [Vagrant](https://www.vagrantup.com/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
|
||||
@ -4573,7 +4605,7 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt
|
||||
| Option | Défaut | Description |
|
||||
| ------------------------------------ | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `command` | `''` | La commande dont la sortie doit être affichée. La commande sera transmise au shell sur l’entrée standard. |
|
||||
| `when` | `false` | Soit une valeur booléenne (`true` ou `false`, sans guillemets) ou une commande shell utilisée comme condition pour afficher le module. Dans le cas d’une chaine, le module sera affiché si la commande renvoie un code de statut `0`. |
|
||||
| `when` | `false` | Soit une valeur booléenne (`true` ou `false`, sans guillemets) ou une commande shell utilisée comme condition pour afficher le module. In case of a string, the module will be shown if the `shell` returns a `0` status code from executing it. |
|
||||
| `require_repo` | `false` | If `true`, the module will only be shown in paths containing a (git) repository. This option alone is not sufficient display condition in absence of other options. |
|
||||
| `shell` | | [Voir plus bas](#custom-command-shell) |
|
||||
| `description` | `'<custom module>'` | La description du module qui est affichée lors de l’exécution de `starship explain`. |
|
||||
@ -4592,8 +4624,8 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt
|
||||
### Variables
|
||||
|
||||
| Variable | Description |
|
||||
| --------- | ------------------------------------------- |
|
||||
| output | La sortie de la commande shell dans `shell` |
|
||||
| --------- | -------------------------------------- |
|
||||
| output | The output of `command` run in `shell` |
|
||||
| symbole | Reflète la valeur de l'option `symbol` |
|
||||
| style\* | Reflète la valeur de l'option `style` |
|
||||
|
||||
@ -4608,7 +4640,7 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt
|
||||
|
||||
If unset, it will fallback to STARSHIP_SHELL and then to 'sh' on Linux, and 'cmd /C' on Windows.
|
||||
|
||||
The `command` will be passed in on stdin.
|
||||
The `command` (and `when`, if applicable) will be passed in on stdin.
|
||||
|
||||
If `shell` is not given or only contains one element and Starship detects PowerShell will be used, the following arguments will automatically be added: `-NoProfile -Command -`. If `shell` is not given or only contains one element and Starship detects Cmd will be used, the following argument will automatically be added: `/C` and `stdin` will be set to `false`. If `shell` is not given or only contains one element and Starship detects Nushell will be used, the following arguments will automatically be added: `-c` and `stdin` will be set to `false`. This behavior can be avoided by explicitly passing arguments to the shell, e.g.
|
||||
|
||||
|
||||
@ -431,7 +431,16 @@ 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)
|
||||
## 🔒 Code Signing Policy
|
||||
|
||||
Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org).
|
||||
|
||||
Code Signing Roles:
|
||||
|
||||
- Reviewers: [Astronauts](https://github.com/orgs/starship/teams/astronauts)
|
||||
- Approvers and Authors: [Mission Control](https://github.com/orgs/starship/teams/mission-control)
|
||||
|
||||
This program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it.
|
||||
|
||||
<p align="center">
|
||||
<br>
|
||||
|
||||
@ -12,6 +12,6 @@ Ce préréglage modifie le format de tous les modules intégrés pour afficher l
|
||||
starship preset bracketed-segments -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Cliquez pour télécharger le TOML](/presets/toml/bracketed-segments.toml)
|
||||
[Click to download TOML](/presets/toml/bracketed-segments.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/bracketed-segments.toml
|
||||
|
||||
@ -16,6 +16,6 @@ This preset is heavily inspired by [Pastel Powerline](./pastel-powerline.md), an
|
||||
starship preset gruvbox-rainbow -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Cliquez pour télécharger le TOML](/presets/toml/gruvbox-rainbow.toml)
|
||||
[Click to download TOML](/presets/toml/gruvbox-rainbow.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/gruvbox-rainbow.toml
|
||||
|
||||
@ -19,6 +19,6 @@ This is a pseudo minimalist preset inspired by the [geometry](https://github.com
|
||||
starship preset jetpack -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Cliquez pour télécharger le TOML](/presets/toml/jetpack.toml)
|
||||
[Click to download TOML](/presets/toml/jetpack.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/jetpack.toml
|
||||
|
||||
@ -16,6 +16,6 @@ Ce préréglage change les symboles de chaque module pour utiliser les symboles
|
||||
starship preset nerd-font-symbols -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Cliquez pour télécharger le TOML](/presets/toml/nerd-font-symbols.toml)
|
||||
[Click to download TOML](/presets/toml/nerd-font-symbols.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/nerd-font-symbols.toml
|
||||
|
||||
@ -12,6 +12,6 @@ If toolset files are identified the toolset icon is displayed. If the toolset is
|
||||
starship preset no-empty-icons -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Cliquez pour télécharger le TOML](/presets/toml/no-empty-icons.toml)
|
||||
[Click to download TOML](/presets/toml/no-empty-icons.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/no-empty-icons.toml
|
||||
|
||||
@ -14,6 +14,6 @@ This preset will become the default preset in a future release of starship.
|
||||
starship preset no-nerd-font -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Cliquez pour télécharger le TOML](/presets/toml/no-nerd-font.toml)
|
||||
[Click to download TOML](/presets/toml/no-nerd-font.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/no-nerd-font.toml
|
||||
|
||||
@ -12,6 +12,6 @@ Ce préréglage masque la version des environnements. Si vous travaillez dans de
|
||||
starship preset no-runtime-versions -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Cliquez pour télécharger le TOML](/presets/toml/no-runtime-versions.toml)
|
||||
[Click to download TOML](/presets/toml/no-runtime-versions.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/no-runtime-versions.toml
|
||||
|
||||
@ -16,6 +16,6 @@ Ce préréglage s'inspire de [M365Princess](https://github.com/JanDeDobbeleer/oh
|
||||
starship preset pastel-powerline -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Cliquez pour télécharger le TOML](/presets/toml/pastel-powerline.toml)
|
||||
[Click to download TOML](/presets/toml/pastel-powerline.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/pastel-powerline.toml
|
||||
|
||||
@ -12,6 +12,6 @@ Ce préréglage change les symboles de chaque module en texte brut. Idéal si vo
|
||||
starship preset plain-text-symbols -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Cliquez pour télécharger le TOML](/presets/toml/plain-text-symbols.toml)
|
||||
[Click to download TOML](/presets/toml/plain-text-symbols.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/plain-text-symbols.toml
|
||||
|
||||
@ -12,6 +12,6 @@ Ce préréglage émule l'apparence et le comportement de [Pure](https://github.c
|
||||
starship preset pure-preset -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Cliquez pour télécharger le TOML](/presets/toml/pure-preset.toml)
|
||||
[Click to download TOML](/presets/toml/pure-preset.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/pure-preset.toml
|
||||
|
||||
@ -16,6 +16,6 @@ This preset is inspired by [tokyo-night-vscode-theme](https://github.com/enkia/t
|
||||
starship preset tokyo-night -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Cliquez pour télécharger le TOML](/presets/toml/tokyo-night.toml)
|
||||
[Click to download TOML](/presets/toml/tokyo-night.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/tokyo-night.toml
|
||||
|
||||
@ -553,10 +553,7 @@ discharging_symbol = '💦 '
|
||||
|
||||
## Buf
|
||||
|
||||
The `buf` module shows the currently installed version of [Buf](https://buf.build). By default, the module is shown if all of the following conditions are met:
|
||||
|
||||
- The [`buf`](https://github.com/bufbuild/buf) CLI is installed.
|
||||
- The current directory contains a [`buf.yaml`](https://docs.buf.build/configuration/v1/buf-yaml), [`buf.gen.yaml`](https://docs.buf.build/configuration/v1/buf-gen-yaml), or [`buf.work.yaml`](https://docs.buf.build/configuration/v1/buf-work-yaml) configuration file.
|
||||
The `buf` module shows the currently installed version of [Buf](https://buf.build). By default, the module is shown if the current directory contains a [`buf.yaml`](https://docs.buf.build/configuration/v1/buf-yaml), [`buf.gen.yaml`](https://docs.buf.build/configuration/v1/buf-gen-yaml), or [`buf.work.yaml`](https://docs.buf.build/configuration/v1/buf-work-yaml) configuration file.
|
||||
|
||||
### Opsi
|
||||
|
||||
@ -635,7 +632,7 @@ format = 'via [🍔 $version](bold green) '
|
||||
|
||||
You can override the `detect_files` property of [the nodejs module](#nodejs) in your config so as to only show the bun runtime:
|
||||
|
||||
```
|
||||
```toml
|
||||
[nodejs]
|
||||
detect_files = ['package.json', '.node-version', '!bunfig.toml', '!bun.lockb']
|
||||
```
|
||||
@ -863,7 +860,7 @@ The `conda` module shows the current [Conda](https://docs.conda.io/en/latest/) e
|
||||
|
||||
::: tip
|
||||
|
||||
Hal ini tidak menahan pengubah (modifier) prompt dari conda sendiri, kamu mungkin bisa menjalankan `conda config --set changeps1 False`.
|
||||
Hal ini tidak menahan pengubah (modifier) prompt dari conda sendiri, kamu mungkin bisa menjalankan `conda config --set changeps1 False`. If you use [pixi](https://pixi.sh), you can disable pixi's prompt modifier by running `pixi config set change-ps1 false`.
|
||||
|
||||
:::
|
||||
|
||||
@ -1050,17 +1047,17 @@ format = 'via [🔰 $version](bold red) '
|
||||
|
||||
Modul `deno` menampilkan versi terkini dari [Deno](https://deno.land/) yang terpasang. Secara bawaan, modul akan aktif jika beberapa syarat berikut telah terpenuhi:
|
||||
|
||||
- The current directory contains a `deno.json`, `deno.jsonc`, `mod.ts`, `mod.js`, `deps.ts` or `deps.js` file
|
||||
- The current directory contains a `deno.json`, `deno.jsonc`, `deno.lock`, `mod.ts`, `mod.js`, `deps.ts` or `deps.js` file
|
||||
|
||||
### 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` | `'🦕 '` | Sebuah format string yang melambangkan simbol Deno |
|
||||
| `detect_extensions` | `[]` | Ekstensi mana yang sebaiknya memicu modul ini. |
|
||||
| `detect_files` | `['deno.json', 'deno.jsonc', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | filenames mana yang sebaiknya memicu modul ini. |
|
||||
| `detect_files` | `['deno.json', 'deno.jsonc', 'deno.lock', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | filenames mana yang sebaiknya memicu modul ini. |
|
||||
| `detect_folders` | `[]` | Folder mana yang sebaiknya memicul modul ini. |
|
||||
| `style` | `'green bold'` | Gaya penataan untuk modul. |
|
||||
| `disabled` | `false` | Menonaktifkan modul `deno`. |
|
||||
@ -1117,7 +1114,7 @@ Sebagai contoh, untuk `~/Dev/Nix/nixpkgs/pkgs` dimana `nixpkgs` merupakan root r
|
||||
| `fish_style_pwd_dir_length` | `0` | The number of characters to use when applying fish shell pwd path logic. |
|
||||
| `use_logical_path` | `true` | If `true` render the logical path sourced from the shell via `PWD` or `--logical-path`. If `false` instead render the physical filesystem path with symlinks resolved. |
|
||||
|
||||
`substitutions` allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories (i.e. Java). Note that this will disable the fish style PWD.
|
||||
`substitutions` allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories of Java. Note that this will disable the fish style PWD.
|
||||
|
||||
```toml
|
||||
[directory.substitutions]
|
||||
@ -1207,7 +1204,7 @@ disabled = false
|
||||
|
||||
## Docker Context
|
||||
|
||||
The `docker_context` module shows the currently active [Docker context](https://docs.docker.com/engine/context/working-with-contexts/) if it's not set to `default` or if the `DOCKER_MACHINE_NAME`, `DOCKER_HOST` or `DOCKER_CONTEXT` environment variables are set (as they are meant to override the context in use).
|
||||
The `docker_context` module shows the currently active [Docker context](https://docs.docker.com/engine/context/working-with-contexts/) if it's not set to `default` or `desktop-linux`, or if the `DOCKER_MACHINE_NAME`, `DOCKER_HOST` or `DOCKER_CONTEXT` environment variables are set (as they are meant to override the context in use).
|
||||
|
||||
### Opsi
|
||||
|
||||
@ -1890,7 +1887,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
|
||||
| `staged` | `'+'` | The format of `staged` |
|
||||
| `renamed` | `'»'` | The format of `renamed` |
|
||||
| `deleted` | `'✘'` | The format of `deleted` |
|
||||
| `typechanged` | `""` | The format of `typechange` |
|
||||
| `typechanged` | `""` | The format of `typechanged` |
|
||||
| `style` | `'bold red'` | Gaya penataan untuk modul. |
|
||||
| `ignore_submodules` | `false` | Ignore changes to submodules. |
|
||||
| `disabled` | `false` | Disables the `git_status` module. |
|
||||
@ -1911,7 +1908,7 @@ The following variables can be used in `format`:
|
||||
| `staged` | Displays `staged` when a new file has been added to the staging area. |
|
||||
| `renamed` | Displays `renamed` when a renamed file has been added to the staging area. |
|
||||
| `deleted` | Displays `deleted` when a file's deletion has been added to the staging area. |
|
||||
| `typechanged` | Displays `typechange` when a file's type has been changed in the staging area. |
|
||||
| `typechanged` | Displays `typechanged` when a file's type has been changed in the staging area. |
|
||||
| style\* | Menyalin nilai dari opsi `style` |
|
||||
|
||||
*: Variabel tersebut hanya dapat digunakan sebagai bagian dari penataan string
|
||||
@ -2257,6 +2254,7 @@ The `hostname` module shows the system hostname.
|
||||
| `fromat` | `'[$ssh_symbol$hostname]($style) in '` | Format dari modul. |
|
||||
| `style` | `'bold dimmed green'` | Gaya penataan untuk modul. |
|
||||
| `disabled` | `false` | Disables the `hostname` module. |
|
||||
| `aliases` | `{}` | Translate system hostnames to something else. If `trim_at` is specified, only the first part will be matched and replaced. |
|
||||
|
||||
### Variabel
|
||||
|
||||
@ -2293,6 +2291,14 @@ detect_env_vars = ['!TMUX', 'SSH_CONNECTION']
|
||||
disabled = false
|
||||
```
|
||||
|
||||
#### Replace the hostname with a nickname
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
[hostname]
|
||||
aliases = { "Max's MacBook Pro" = "home" }
|
||||
```
|
||||
|
||||
## Java
|
||||
|
||||
The `java` module shows the currently installed version of [Java](https://www.oracle.com/java/). Secara bawaan, modul akan aktif jika beberapa syarat berikut telah terpenuhi:
|
||||
@ -2809,6 +2815,41 @@ truncation_length = 4
|
||||
truncation_symbol = ''
|
||||
```
|
||||
|
||||
## Mojo
|
||||
|
||||
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
|
||||
|
||||
### Opsi
|
||||
|
||||
| Opsi | Bawaan | Deskripsi |
|
||||
| ------------------- | ------------------------------------- | ------------------------------------------------------ |
|
||||
| `fromat` | `'with [$symbol($version )]($style)'` | Format dari modul. |
|
||||
| `symbol` | `'🔥 '` | The symbol used before displaying the version of Mojo. |
|
||||
| `style` | `'bold 208'` | Gaya penataan untuk modul. |
|
||||
| `disabled` | `false` | Disables the `mojo` module. |
|
||||
| `detect_extensions` | `['mojo', '🔥']` | 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 | `24.4.0` | The version of `mojo` |
|
||||
| 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
|
||||
|
||||
[mojo]
|
||||
format = 'via [mojo ($version )($hash )]($style)'
|
||||
```
|
||||
|
||||
## NATS
|
||||
|
||||
The `nats` module shows the name of the current [NATS](https://nats.io) context.
|
||||
@ -2935,12 +2976,12 @@ The `nodejs` module shows the currently installed version of [Node.js](https://n
|
||||
### Opsi
|
||||
|
||||
| Opsi | Bawaan | Deskripsi |
|
||||
| ------------------- | ------------------------------------------ | ----------------------------------------------------------------------------------------------------- |
|
||||
| ------------------- | --------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
|
||||
| `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 Node.js. |
|
||||
| `detect_extensions` | `['js', 'mjs', 'cjs', 'ts', 'mts', 'cts']` | Ekstensi mana yang sebaiknya memicu modul ini. |
|
||||
| `detect_files` | `['package.json', '.node-version']` | filenames mana yang sebaiknya memicu modul ini. |
|
||||
| `detect_files` | `['package.json', '.node-version', '.nvmrc']` | filenames mana yang sebaiknya memicu modul ini. |
|
||||
| `detect_folders` | `['node_modules']` | Folder mana yang sebaiknya memicul modul ini. |
|
||||
| `style` | `'bold green'` | Gaya penataan untuk modul. |
|
||||
| `disabled` | `false` | Disables the `nodejs` module. |
|
||||
@ -3492,13 +3533,15 @@ By default, the module will be shown if any of the following conditions are met:
|
||||
- Direktori ini memiliki berkas `requirements.txt`
|
||||
- Direktori ini memiliki berkas `setup.py`
|
||||
- Direktori ini memiliki berkas `tox.ini`
|
||||
- Direktori ini memiliki berkas `pixi.toml`
|
||||
- The current directory contains a file with the `.py` extension.
|
||||
- The current directory contains a file with the `.ipynb` extension.
|
||||
- A virtual environment is currently activated
|
||||
|
||||
### Opsi
|
||||
|
||||
| Opsi | Bawaan | Deskripsi |
|
||||
| -------------------- | ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- |
|
||||
| -------------------- | ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
|
||||
| `fromat` | `'via [${symbol}${pyenv_prefix}(${version} )(\($virtualenv\) )]($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 Python |
|
||||
@ -3506,8 +3549,8 @@ By default, the module will be shown if any of the following conditions are met:
|
||||
| `pyenv_version_name` | `false` | Use pyenv to get Python version |
|
||||
| `pyenv_prefix` | `'pyenv'` | Prefix before pyenv version display, only used if pyenv is used |
|
||||
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should executes when getting the version. |
|
||||
| `detect_extensions` | `['py']` | Ekstensi mana yang sebaiknya memicu modul ini |
|
||||
| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini']` | filenames mana yang sebaiknya memicu modul ini |
|
||||
| `detect_extensions` | `['py', 'ipynb']` | Ekstensi mana yang sebaiknya memicu modul ini |
|
||||
| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini', 'pixi.toml']` | filenames mana yang sebaiknya memicu modul ini |
|
||||
| `detect_folders` | `[]` | Folder mana yang sebaiknya memicul modul ini |
|
||||
| `disabled` | `false` | Disables the `python` module. |
|
||||
|
||||
@ -4350,7 +4393,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 |
|
||||
| `aliases` | `{}` | Translate system usernames to something else. |
|
||||
|
||||
### Variabel
|
||||
|
||||
@ -4361,7 +4404,7 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
|
||||
|
||||
### Contoh
|
||||
|
||||
#### Always show the hostname
|
||||
#### Always show the username
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
@ -4375,17 +4418,6 @@ show_always = true
|
||||
aliases = { "corpuser034g" = "matchai" }
|
||||
```
|
||||
|
||||
#### Hide the hostname in remote tmux sessions
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
[hostname]
|
||||
ssh_only = false
|
||||
detect_env_vars = ['!TMUX', 'SSH_CONNECTION']
|
||||
disabled = false
|
||||
```
|
||||
|
||||
## Vagrant
|
||||
|
||||
The `vagrant` module shows the currently installed version of [Vagrant](https://www.vagrantup.com/). Secara bawaan, modul akan aktif jika beberapa syarat berikut telah terpenuhi:
|
||||
@ -4573,7 +4605,7 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt
|
||||
| Opsi | Bawaan | Deskripsi |
|
||||
| ------------------- | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `command` | `''` | The command whose output should be printed. The command will be passed on stdin to the shell. |
|
||||
| `when` | `false` | Either a boolean value (`true` or `false`, without quotes) or a string shell command used as a condition to show the module. In case of a string, the module will be shown if the command returns a `0` status code. |
|
||||
| `when` | `false` | Either a boolean value (`true` or `false`, without quotes) or a string shell command used as a condition to show the module. In case of a string, the module will be shown if the `shell` returns a `0` status code from executing it. |
|
||||
| `require_repo` | `false` | If `true`, the module will only be shown in paths containing a (git) repository. This option alone is not sufficient display condition in absence of other options. |
|
||||
| `shell` | | [See below](#custom-command-shell) |
|
||||
| `deskripsi` | `'<custom module>'` | The description of the module that is shown when running `starship explain`. |
|
||||
@ -4593,7 +4625,7 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt
|
||||
|
||||
| Variabel | Deskripsi |
|
||||
| --------- | -------------------------------------- |
|
||||
| output | The output of shell command in `shell` |
|
||||
| output | The output of `command` run in `shell` |
|
||||
| symbol | Menyalin nilai dari opsi `symbol` |
|
||||
| style\* | Menyalin nilai dari opsi `style` |
|
||||
|
||||
@ -4608,7 +4640,7 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt
|
||||
|
||||
If unset, it will fallback to STARSHIP_SHELL and then to 'sh' on Linux, and 'cmd /C' on Windows.
|
||||
|
||||
The `command` will be passed in on stdin.
|
||||
The `command` (and `when`, if applicable) will be passed in on stdin.
|
||||
|
||||
If `shell` is not given or only contains one element and Starship detects PowerShell will be used, the following arguments will automatically be added: `-NoProfile -Command -`. If `shell` is not given or only contains one element and Starship detects Cmd will be used, the following argument will automatically be added: `/C` and `stdin` will be set to `false`. If `shell` is not given or only contains one element and Starship detects Nushell will be used, the following arguments will automatically be added: `-c` and `stdin` will be set to `false`. This behavior can be avoided by explicitly passing arguments to the shell, e.g.
|
||||
|
||||
|
||||
@ -431,7 +431,16 @@ 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)
|
||||
## 🔒 Code Signing Policy
|
||||
|
||||
Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org).
|
||||
|
||||
Code Signing Roles:
|
||||
|
||||
- Reviewers: [Astronauts](https://github.com/orgs/starship/teams/astronauts)
|
||||
- Approvers and Authors: [Mission Control](https://github.com/orgs/starship/teams/mission-control)
|
||||
|
||||
This program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it.
|
||||
|
||||
<p align="center">
|
||||
<br>
|
||||
|
||||
@ -12,6 +12,6 @@ Konfigurasi prasetel berikut mengubah format dari seluruh modul bawaan untuk men
|
||||
starship preset bracketed-segments -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/bracketed-segments.toml)
|
||||
[Click to download TOML](/presets/toml/bracketed-segments.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/bracketed-segments.toml
|
||||
|
||||
@ -16,6 +16,6 @@ This preset is heavily inspired by [Pastel Powerline](./pastel-powerline.md), an
|
||||
starship preset gruvbox-rainbow -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/gruvbox-rainbow.toml)
|
||||
[Click to download TOML](/presets/toml/gruvbox-rainbow.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/gruvbox-rainbow.toml
|
||||
|
||||
@ -19,6 +19,6 @@ This is a pseudo minimalist preset inspired by the [geometry](https://github.com
|
||||
starship preset jetpack -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/jetpack.toml)
|
||||
[Click to download TOML](/presets/toml/jetpack.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/jetpack.toml
|
||||
|
||||
@ -16,6 +16,6 @@ This preset changes the symbols for each module to use Nerd Font symbols.
|
||||
starship preset nerd-font-symbols -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/nerd-font-symbols.toml)
|
||||
[Click to download TOML](/presets/toml/nerd-font-symbols.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/nerd-font-symbols.toml
|
||||
|
||||
@ -12,6 +12,6 @@ If toolset files are identified the toolset icon is displayed. If the toolset is
|
||||
starship preset no-empty-icons -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/no-empty-icons.toml)
|
||||
[Click to download TOML](/presets/toml/no-empty-icons.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/no-empty-icons.toml
|
||||
|
||||
@ -14,6 +14,6 @@ This preset will become the default preset in a future release of starship.
|
||||
starship preset no-nerd-font -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/no-nerd-font.toml)
|
||||
[Click to download TOML](/presets/toml/no-nerd-font.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/no-nerd-font.toml
|
||||
|
||||
@ -12,6 +12,6 @@ Konfigurasi prasetel berikut menyembunyikan versi language runtimes. Jika kamu b
|
||||
starship preset no-runtime-versions -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/no-runtime-versions.toml)
|
||||
[Click to download TOML](/presets/toml/no-runtime-versions.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/no-runtime-versions.toml
|
||||
|
||||
@ -16,6 +16,6 @@ This preset is inspired by [M365Princess](https://github.com/JanDeDobbeleer/oh-m
|
||||
starship preset pastel-powerline -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/pastel-powerline.toml)
|
||||
[Click to download TOML](/presets/toml/pastel-powerline.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/pastel-powerline.toml
|
||||
|
||||
@ -12,6 +12,6 @@ This preset changes the symbols for each module into plain text. Great if you do
|
||||
starship preset plain-text-symbols -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/plain-text-symbols.toml)
|
||||
[Click to download TOML](/presets/toml/plain-text-symbols.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/plain-text-symbols.toml
|
||||
|
||||
@ -12,6 +12,6 @@ This preset emulates the look and behavior of [Pure](https://github.com/sindreso
|
||||
starship preset pure-preset -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/pure-preset.toml)
|
||||
[Click to download TOML](/presets/toml/pure-preset.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/pure-preset.toml
|
||||
|
||||
@ -16,6 +16,6 @@ This preset is inspired by [tokyo-night-vscode-theme](https://github.com/enkia/t
|
||||
starship preset tokyo-night -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/tokyo-night.toml)
|
||||
[Click to download TOML](/presets/toml/tokyo-night.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/tokyo-night.toml
|
||||
|
||||
@ -553,10 +553,7 @@ discharging_symbol = '💦 '
|
||||
|
||||
## Buf
|
||||
|
||||
The `buf` module shows the currently installed version of [Buf](https://buf.build). By default, the module is shown if all of the following conditions are met:
|
||||
|
||||
- The [`buf`](https://github.com/bufbuild/buf) CLI is installed.
|
||||
- The current directory contains a [`buf.yaml`](https://docs.buf.build/configuration/v1/buf-yaml), [`buf.gen.yaml`](https://docs.buf.build/configuration/v1/buf-gen-yaml), or [`buf.work.yaml`](https://docs.buf.build/configuration/v1/buf-work-yaml) configuration file.
|
||||
The `buf` module shows the currently installed version of [Buf](https://buf.build). By default, the module is shown if the current directory contains a [`buf.yaml`](https://docs.buf.build/configuration/v1/buf-yaml), [`buf.gen.yaml`](https://docs.buf.build/configuration/v1/buf-gen-yaml), or [`buf.work.yaml`](https://docs.buf.build/configuration/v1/buf-work-yaml) configuration file.
|
||||
|
||||
### Opzioni
|
||||
|
||||
@ -635,7 +632,7 @@ format = 'via [🍔 $version](bold green) '
|
||||
|
||||
You can override the `detect_files` property of [the nodejs module](#nodejs) in your config so as to only show the bun runtime:
|
||||
|
||||
```
|
||||
```toml
|
||||
[nodejs]
|
||||
detect_files = ['package.json', '.node-version', '!bunfig.toml', '!bun.lockb']
|
||||
```
|
||||
@ -863,7 +860,7 @@ The `conda` module shows the current [Conda](https://docs.conda.io/en/latest/) e
|
||||
|
||||
::: tip
|
||||
|
||||
This does not suppress conda's own prompt modifier, you may want to run `conda config --set changeps1 False`.
|
||||
This does not suppress conda's own prompt modifier, you may want to run `conda config --set changeps1 False`. If you use [pixi](https://pixi.sh), you can disable pixi's prompt modifier by running `pixi config set change-ps1 false`.
|
||||
|
||||
:::
|
||||
|
||||
@ -1050,17 +1047,17 @@ format = 'via [🔰 $version](bold red) '
|
||||
|
||||
The `deno` module shows you your currently installed version of [Deno](https://deno.land/). By default the module will be shown if any of the following conditions are met:
|
||||
|
||||
- The current directory contains a `deno.json`, `deno.jsonc`, `mod.ts`, `mod.js`, `deps.ts` or `deps.js` file
|
||||
- The current directory contains a `deno.json`, `deno.jsonc`, `deno.lock`, `mod.ts`, `mod.js`, `deps.ts` or `deps.js` file
|
||||
|
||||
### 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 Deno |
|
||||
| `detect_extensions` | `[]` | Quali estensioni dovrebbero attivare questo modulo. |
|
||||
| `detect_files` | `['deno.json', 'deno.jsonc', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | Quali nomi di file dovrebbero attivare questo modulo. |
|
||||
| `detect_files` | `['deno.json', 'deno.jsonc', 'deno.lock', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | Quali nomi di file dovrebbero attivare questo modulo. |
|
||||
| `detect_folders` | `[]` | Quali cartelle dovrebbero attivare questo modulo. |
|
||||
| `style` | `'green bold'` | Lo stile per il modulo. |
|
||||
| `disabled` | `false` | Disables the `deno` module. |
|
||||
@ -1117,7 +1114,7 @@ For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, an
|
||||
| `fish_style_pwd_dir_length` | `0` | The number of characters to use when applying fish shell pwd path logic. |
|
||||
| `use_logical_path` | `true` | If `true` render the logical path sourced from the shell via `PWD` or `--logical-path`. If `false` instead render the physical filesystem path with symlinks resolved. |
|
||||
|
||||
`substitutions` allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories (i.e. Java). Note that this will disable the fish style PWD.
|
||||
`substitutions` allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories of Java. Note that this will disable the fish style PWD.
|
||||
|
||||
```toml
|
||||
[directory.substitutions]
|
||||
@ -1207,7 +1204,7 @@ disabled = false
|
||||
|
||||
## Docker Context
|
||||
|
||||
The `docker_context` module shows the currently active [Docker context](https://docs.docker.com/engine/context/working-with-contexts/) if it's not set to `default` or if the `DOCKER_MACHINE_NAME`, `DOCKER_HOST` or `DOCKER_CONTEXT` environment variables are set (as they are meant to override the context in use).
|
||||
The `docker_context` module shows the currently active [Docker context](https://docs.docker.com/engine/context/working-with-contexts/) if it's not set to `default` or `desktop-linux`, or if the `DOCKER_MACHINE_NAME`, `DOCKER_HOST` or `DOCKER_CONTEXT` environment variables are set (as they are meant to override the context in use).
|
||||
|
||||
### Opzioni
|
||||
|
||||
@ -1890,7 +1887,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
|
||||
| `staged` | `'+'` | The format of `staged` |
|
||||
| `renamed` | `'»'` | The format of `renamed` |
|
||||
| `deleted` | `'✘'` | The format of `deleted` |
|
||||
| `typechanged` | `""` | The format of `typechange` |
|
||||
| `typechanged` | `""` | The format of `typechanged` |
|
||||
| `style` | `'bold red'` | Lo stile per il modulo. |
|
||||
| `ignore_submodules` | `false` | Ignore changes to submodules. |
|
||||
| `disabled` | `false` | Disables the `git_status` module. |
|
||||
@ -1911,7 +1908,7 @@ The following variables can be used in `format`:
|
||||
| `staged` | Displays `staged` when a new file has been added to the staging area. |
|
||||
| `renamed` | Displays `renamed` when a renamed file has been added to the staging area. |
|
||||
| `deleted` | Displays `deleted` when a file's deletion has been added to the staging area. |
|
||||
| `typechanged` | Displays `typechange` when a file's type has been changed in the staging area. |
|
||||
| `typechanged` | Displays `typechanged` when a file's type has been changed in the staging area. |
|
||||
| style\* | Mirrors the value of option `style` |
|
||||
|
||||
*: This variable can only be used as a part of a style string
|
||||
@ -2257,6 +2254,7 @@ The `hostname` module shows the system hostname.
|
||||
| `format` | `'[$ssh_symbol$hostname]($style) in '` | The format for the module. |
|
||||
| `style` | `'bold dimmed green'` | Lo stile per il modulo. |
|
||||
| `disabled` | `false` | Disables the `hostname` module. |
|
||||
| `aliases` | `{}` | Translate system hostnames to something else. If `trim_at` is specified, only the first part will be matched and replaced. |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -2293,6 +2291,14 @@ detect_env_vars = ['!TMUX', 'SSH_CONNECTION']
|
||||
disabled = false
|
||||
```
|
||||
|
||||
#### Replace the hostname with a nickname
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
[hostname]
|
||||
aliases = { "Max's MacBook Pro" = "home" }
|
||||
```
|
||||
|
||||
## Java
|
||||
|
||||
The `java` module shows the currently installed version of [Java](https://www.oracle.com/java/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -2809,6 +2815,41 @@ truncation_length = 4
|
||||
truncation_symbol = ''
|
||||
```
|
||||
|
||||
## Mojo
|
||||
|
||||
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
|
||||
|
||||
### Opzioni
|
||||
|
||||
| Opzione | Default | Descrizione |
|
||||
| ------------------- | ------------------------------------- | ------------------------------------------------------ |
|
||||
| `format` | `'with [$symbol($version )]($style)'` | The format for the module. |
|
||||
| `symbol` | `'🔥 '` | The symbol used before displaying the version of Mojo. |
|
||||
| `style` | `'bold 208'` | Lo stile per il modulo. |
|
||||
| `disabled` | `false` | Disables the `mojo` module. |
|
||||
| `detect_extensions` | `['mojo', '🔥']` | 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 | `24.4.0` | The version of `mojo` |
|
||||
| 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
|
||||
|
||||
[mojo]
|
||||
format = 'via [mojo ($version )($hash )]($style)'
|
||||
```
|
||||
|
||||
## NATS
|
||||
|
||||
The `nats` module shows the name of the current [NATS](https://nats.io) context.
|
||||
@ -2935,12 +2976,12 @@ The `nodejs` module shows the currently installed version of [Node.js](https://n
|
||||
### 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 Node.js. |
|
||||
| `detect_extensions` | `['js', 'mjs', 'cjs', 'ts', 'mts', 'cts']` | Quali estensioni dovrebbero attivare questo modulo. |
|
||||
| `detect_files` | `['package.json', '.node-version']` | Quali nomi di file dovrebbero attivare questo modulo. |
|
||||
| `detect_files` | `['package.json', '.node-version', '.nvmrc']` | Quali nomi di file dovrebbero attivare questo modulo. |
|
||||
| `detect_folders` | `['node_modules']` | Quali cartelle dovrebbero attivare questo modulo. |
|
||||
| `style` | `'bold green'` | Lo stile per il modulo. |
|
||||
| `disabled` | `false` | Disables the `nodejs` module. |
|
||||
@ -3492,13 +3533,15 @@ By default, the module will be shown if any of the following conditions are met:
|
||||
- The current directory contains a `requirements.txt` file
|
||||
- The current directory contains a `setup.py` file
|
||||
- The current directory contains a `tox.ini` file
|
||||
- The current directory contains a `pixi.toml` file
|
||||
- The current directory contains a file with the `.py` extension.
|
||||
- The current directory contains a file with the `.ipynb` extension.
|
||||
- A virtual environment is currently activated
|
||||
|
||||
### Opzioni
|
||||
|
||||
| Opzione | Default | Descrizione |
|
||||
| -------------------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------- |
|
||||
| -------------------- | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
|
||||
| `format` | `'via [${symbol}${pyenv_prefix}(${version} )(\($virtualenv\) )]($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 Python |
|
||||
@ -3506,8 +3549,8 @@ By default, the module will be shown if any of the following conditions are met:
|
||||
| `pyenv_version_name` | `false` | Use pyenv to get Python version |
|
||||
| `pyenv_prefix` | `'pyenv'` | Prefix before pyenv version display, only used if pyenv is used |
|
||||
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should executes when getting the version. |
|
||||
| `detect_extensions` | `['py']` | Quali estensioni dovrebbero attivare questo modulo |
|
||||
| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini']` | Quali nomi di file dovrebbero attivare questo modulo |
|
||||
| `detect_extensions` | `['py', 'ipynb']` | Quali estensioni dovrebbero attivare questo modulo |
|
||||
| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini', 'pixi.toml']` | Quali nomi di file dovrebbero attivare questo modulo |
|
||||
| `detect_folders` | `[]` | Quali cartelle dovrebbero attivare questo modulo |
|
||||
| `disabled` | `false` | Disables the `python` module. |
|
||||
|
||||
@ -4350,7 +4393,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 |
|
||||
| `aliases` | `{}` | Translate system usernames to something else. |
|
||||
|
||||
### Variables
|
||||
|
||||
@ -4361,7 +4404,7 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
|
||||
|
||||
### Esempio
|
||||
|
||||
#### Always show the hostname
|
||||
#### Always show the username
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
@ -4375,17 +4418,6 @@ show_always = true
|
||||
aliases = { "corpuser034g" = "matchai" }
|
||||
```
|
||||
|
||||
#### Hide the hostname in remote tmux sessions
|
||||
|
||||
```toml
|
||||
# ~/.config/starship.toml
|
||||
|
||||
[hostname]
|
||||
ssh_only = false
|
||||
detect_env_vars = ['!TMUX', 'SSH_CONNECTION']
|
||||
disabled = false
|
||||
```
|
||||
|
||||
## Vagrant
|
||||
|
||||
The `vagrant` module shows the currently installed version of [Vagrant](https://www.vagrantup.com/). By default the module will be shown if any of the following conditions are met:
|
||||
@ -4573,7 +4605,7 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt
|
||||
| Opzione | Default | Descrizione |
|
||||
| ------------------- | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `command` | `''` | The command whose output should be printed. The command will be passed on stdin to the shell. |
|
||||
| `when` | `false` | Either a boolean value (`true` or `false`, without quotes) or a string shell command used as a condition to show the module. In case of a string, the module will be shown if the command returns a `0` status code. |
|
||||
| `when` | `false` | Either a boolean value (`true` or `false`, without quotes) or a string shell command used as a condition to show the module. In case of a string, the module will be shown if the `shell` returns a `0` status code from executing it. |
|
||||
| `require_repo` | `false` | If `true`, the module will only be shown in paths containing a (git) repository. This option alone is not sufficient display condition in absence of other options. |
|
||||
| `shell` | | [See below](#custom-command-shell) |
|
||||
| `descrizione` | `'<custom module>'` | The description of the module that is shown when running `starship explain`. |
|
||||
@ -4593,7 +4625,7 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt
|
||||
|
||||
| Variable | Descrizione |
|
||||
| --------- | -------------------------------------- |
|
||||
| output | The output of shell command in `shell` |
|
||||
| output | The output of `command` run in `shell` |
|
||||
| symbol | Mirrors the value of option `symbol` |
|
||||
| style\* | Mirrors the value of option `style` |
|
||||
|
||||
@ -4608,7 +4640,7 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt
|
||||
|
||||
If unset, it will fallback to STARSHIP_SHELL and then to 'sh' on Linux, and 'cmd /C' on Windows.
|
||||
|
||||
The `command` will be passed in on stdin.
|
||||
The `command` (and `when`, if applicable) will be passed in on stdin.
|
||||
|
||||
If `shell` is not given or only contains one element and Starship detects PowerShell will be used, the following arguments will automatically be added: `-NoProfile -Command -`. If `shell` is not given or only contains one element and Starship detects Cmd will be used, the following argument will automatically be added: `/C` and `stdin` will be set to `false`. If `shell` is not given or only contains one element and Starship detects Nushell will be used, the following arguments will automatically be added: `-c` and `stdin` will be set to `false`. This behavior can be avoided by explicitly passing arguments to the shell, e.g.
|
||||
|
||||
|
||||
@ -431,7 +431,16 @@ 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)
|
||||
## 🔒 Code Signing Policy
|
||||
|
||||
Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org).
|
||||
|
||||
Code Signing Roles:
|
||||
|
||||
- Reviewers: [Astronauts](https://github.com/orgs/starship/teams/astronauts)
|
||||
- Approvers and Authors: [Mission Control](https://github.com/orgs/starship/teams/mission-control)
|
||||
|
||||
This program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it.
|
||||
|
||||
<p align="center">
|
||||
<br>
|
||||
|
||||
@ -12,6 +12,6 @@ This preset changes the format of all the built-in modules to show their segment
|
||||
starship preset bracketed-segments -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/bracketed-segments.toml)
|
||||
[Click to download TOML](/presets/toml/bracketed-segments.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/bracketed-segments.toml
|
||||
|
||||
@ -16,6 +16,6 @@ This preset is heavily inspired by [Pastel Powerline](./pastel-powerline.md), an
|
||||
starship preset gruvbox-rainbow -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/gruvbox-rainbow.toml)
|
||||
[Click to download TOML](/presets/toml/gruvbox-rainbow.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/gruvbox-rainbow.toml
|
||||
|
||||
@ -19,6 +19,6 @@ This is a pseudo minimalist preset inspired by the [geometry](https://github.com
|
||||
starship preset jetpack -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/jetpack.toml)
|
||||
[Click to download TOML](/presets/toml/jetpack.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/jetpack.toml
|
||||
|
||||
@ -16,6 +16,6 @@ This preset changes the symbols for each module to use Nerd Font symbols.
|
||||
starship preset nerd-font-symbols -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/nerd-font-symbols.toml)
|
||||
[Click to download TOML](/presets/toml/nerd-font-symbols.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/nerd-font-symbols.toml
|
||||
|
||||
@ -12,6 +12,6 @@ If toolset files are identified the toolset icon is displayed. If the toolset is
|
||||
starship preset no-empty-icons -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/no-empty-icons.toml)
|
||||
[Click to download TOML](/presets/toml/no-empty-icons.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/no-empty-icons.toml
|
||||
|
||||
@ -14,6 +14,6 @@ This preset will become the default preset in a future release of starship.
|
||||
starship preset no-nerd-font -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/no-nerd-font.toml)
|
||||
[Click to download TOML](/presets/toml/no-nerd-font.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/no-nerd-font.toml
|
||||
|
||||
@ -12,6 +12,6 @@ This preset hides the version of language runtimes. If you work in containers or
|
||||
starship preset no-runtime-versions -o ~/.config/starship.toml
|
||||
```
|
||||
|
||||
[Click to download TOML](/presets/toml/no-runtime-versions.toml)
|
||||
[Click to download TOML](/presets/toml/no-runtime-versions.toml){download}
|
||||
|
||||
<<< @/public/presets/toml/no-runtime-versions.toml
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue
Block a user