diff --git a/docs/ar-SA/config/README.md b/docs/ar-SA/config/README.md index 9c12e216..0af60883 100644 --- a/docs/ar-SA/config/README.md +++ b/docs/ar-SA/config/README.md @@ -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,20 +1047,20 @@ 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_folders` | `[]` | Which folders should trigger this module. | -| `style` | `'green bold'` | The style for the module. | -| `disabled` | `false` | Disables the `deno` module. | +| 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', '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. | ### Variables @@ -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 @@ -1759,7 +1756,7 @@ The `git_commit` module shows the current commit hash and also the tag (if any) | `only_detached` | `true` | Only show git commit hash when in detached `HEAD` state | | `tag_disabled` | `true` | Disables showing tag info in `git_commit` module. | | `tag_max_candidates` | `0` | How many commits to consider for tag display. The default only allows exact matches. | -| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | +| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | | `disabled` | `false` | Disables the `git_commit` module. | ### Variables @@ -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. @@ -2934,17 +2975,17 @@ 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_folders` | `['node_modules']` | Which folders should trigger this module. | -| `style` | `'bold green'` | The style for the module. | -| `disabled` | `false` | Disables the `nodejs` module. | -| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | +| 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', '.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. | +| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | ### Variables @@ -3492,24 +3533,26 @@ 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 | -| `style` | `'yellow bold'` | The style for the module. | -| `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_folders` | `[]` | Which folders should trigger this module | -| `disabled` | `false` | Disables the `python` module. | +| 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 | +| `style` | `'yellow bold'` | The style for the module. | +| `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', '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. | ::: tip @@ -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) | | `الوصف` | `''` | 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. diff --git a/docs/ar-SA/guide/README.md b/docs/ar-SA/guide/README.md index 941f4b9b..a9370938 100644 --- a/docs/ar-SA/guide/README.md +++ b/docs/ar-SA/guide/README.md @@ -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.


diff --git a/docs/ar-SA/presets/bracketed-segments.md b/docs/ar-SA/presets/bracketed-segments.md index 579d789e..35d956bf 100644 --- a/docs/ar-SA/presets/bracketed-segments.md +++ b/docs/ar-SA/presets/bracketed-segments.md @@ -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 diff --git a/docs/ar-SA/presets/gruvbox-rainbow.md b/docs/ar-SA/presets/gruvbox-rainbow.md index 73dd1e01..4bdc32bc 100644 --- a/docs/ar-SA/presets/gruvbox-rainbow.md +++ b/docs/ar-SA/presets/gruvbox-rainbow.md @@ -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 diff --git a/docs/ar-SA/presets/jetpack.md b/docs/ar-SA/presets/jetpack.md index c247b97f..8117adce 100644 --- a/docs/ar-SA/presets/jetpack.md +++ b/docs/ar-SA/presets/jetpack.md @@ -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 diff --git a/docs/ar-SA/presets/nerd-font.md b/docs/ar-SA/presets/nerd-font.md index dd349175..17e3be61 100644 --- a/docs/ar-SA/presets/nerd-font.md +++ b/docs/ar-SA/presets/nerd-font.md @@ -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 diff --git a/docs/ar-SA/presets/no-empty-icons.md b/docs/ar-SA/presets/no-empty-icons.md index 2d262cdd..03bb1f38 100644 --- a/docs/ar-SA/presets/no-empty-icons.md +++ b/docs/ar-SA/presets/no-empty-icons.md @@ -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 diff --git a/docs/ar-SA/presets/no-nerd-font.md b/docs/ar-SA/presets/no-nerd-font.md index c3fb3636..c1542a62 100644 --- a/docs/ar-SA/presets/no-nerd-font.md +++ b/docs/ar-SA/presets/no-nerd-font.md @@ -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 diff --git a/docs/ar-SA/presets/no-runtimes.md b/docs/ar-SA/presets/no-runtimes.md index 218d1ae1..5cf87ff1 100644 --- a/docs/ar-SA/presets/no-runtimes.md +++ b/docs/ar-SA/presets/no-runtimes.md @@ -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 diff --git a/docs/ar-SA/presets/pastel-powerline.md b/docs/ar-SA/presets/pastel-powerline.md index 29481c8b..78ab5bbe 100644 --- a/docs/ar-SA/presets/pastel-powerline.md +++ b/docs/ar-SA/presets/pastel-powerline.md @@ -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 diff --git a/docs/ar-SA/presets/plain-text.md b/docs/ar-SA/presets/plain-text.md index 2a075171..686b3e06 100644 --- a/docs/ar-SA/presets/plain-text.md +++ b/docs/ar-SA/presets/plain-text.md @@ -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 diff --git a/docs/ar-SA/presets/pure-preset.md b/docs/ar-SA/presets/pure-preset.md index 68b7b49d..b27468de 100644 --- a/docs/ar-SA/presets/pure-preset.md +++ b/docs/ar-SA/presets/pure-preset.md @@ -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 diff --git a/docs/ar-SA/presets/tokyo-night.md b/docs/ar-SA/presets/tokyo-night.md index ee7443a7..398b3c78 100644 --- a/docs/ar-SA/presets/tokyo-night.md +++ b/docs/ar-SA/presets/tokyo-night.md @@ -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 diff --git a/docs/bn-BD/config/README.md b/docs/bn-BD/config/README.md index 399853b5..b420d788 100644 --- a/docs/bn-BD/config/README.md +++ b/docs/bn-BD/config/README.md @@ -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,20 +1047,20 @@ 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_folders` | `[]` | Which folders should trigger this module. | -| `style` | `'green bold'` | The style for the module. | -| `disabled` | `false` | Disables the `deno` module. | +| 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', '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. | ### Variables @@ -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 @@ -1759,7 +1756,7 @@ The `git_commit` module shows the current commit hash and also the tag (if any) | `only_detached` | `true` | Only show git commit hash when in detached `HEAD` state | | `tag_disabled` | `true` | Disables showing tag info in `git_commit` module. | | `tag_max_candidates` | `0` | How many commits to consider for tag display. The default only allows exact matches. | -| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | +| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | | `disabled` | `false` | Disables the `git_commit` module. | ### Variables @@ -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. @@ -2934,17 +2975,17 @@ 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_folders` | `['node_modules']` | Which folders should trigger this module. | -| `style` | `'bold green'` | The style for the module. | -| `disabled` | `false` | Disables the `nodejs` module. | -| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | +| 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', '.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. | +| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | ### Variables @@ -3492,24 +3533,26 @@ 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 | -| `style` | `'yellow bold'` | The style for the module. | -| `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_folders` | `[]` | Which folders should trigger this module | -| `disabled` | `false` | Disables the `python` module. | +| 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 | +| `style` | `'yellow bold'` | The style for the module. | +| `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', '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. | ::: tip @@ -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` | `''` | 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. diff --git a/docs/bn-BD/guide/README.md b/docs/bn-BD/guide/README.md index 14a7e859..3c48e712 100644 --- a/docs/bn-BD/guide/README.md +++ b/docs/bn-BD/guide/README.md @@ -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.


diff --git a/docs/bn-BD/presets/bracketed-segments.md b/docs/bn-BD/presets/bracketed-segments.md index 579d789e..35d956bf 100644 --- a/docs/bn-BD/presets/bracketed-segments.md +++ b/docs/bn-BD/presets/bracketed-segments.md @@ -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 diff --git a/docs/bn-BD/presets/gruvbox-rainbow.md b/docs/bn-BD/presets/gruvbox-rainbow.md index 6b21ee71..d83ad594 100644 --- a/docs/bn-BD/presets/gruvbox-rainbow.md +++ b/docs/bn-BD/presets/gruvbox-rainbow.md @@ -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 diff --git a/docs/bn-BD/presets/jetpack.md b/docs/bn-BD/presets/jetpack.md index c247b97f..8117adce 100644 --- a/docs/bn-BD/presets/jetpack.md +++ b/docs/bn-BD/presets/jetpack.md @@ -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 diff --git a/docs/bn-BD/presets/nerd-font.md b/docs/bn-BD/presets/nerd-font.md index c139da2f..41668dc1 100644 --- a/docs/bn-BD/presets/nerd-font.md +++ b/docs/bn-BD/presets/nerd-font.md @@ -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 diff --git a/docs/bn-BD/presets/no-empty-icons.md b/docs/bn-BD/presets/no-empty-icons.md index 2d262cdd..03bb1f38 100644 --- a/docs/bn-BD/presets/no-empty-icons.md +++ b/docs/bn-BD/presets/no-empty-icons.md @@ -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 diff --git a/docs/bn-BD/presets/no-nerd-font.md b/docs/bn-BD/presets/no-nerd-font.md index c3fb3636..c1542a62 100644 --- a/docs/bn-BD/presets/no-nerd-font.md +++ b/docs/bn-BD/presets/no-nerd-font.md @@ -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 diff --git a/docs/bn-BD/presets/no-runtimes.md b/docs/bn-BD/presets/no-runtimes.md index 218d1ae1..5cf87ff1 100644 --- a/docs/bn-BD/presets/no-runtimes.md +++ b/docs/bn-BD/presets/no-runtimes.md @@ -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 diff --git a/docs/bn-BD/presets/pastel-powerline.md b/docs/bn-BD/presets/pastel-powerline.md index a718dbdc..5ea947e1 100644 --- a/docs/bn-BD/presets/pastel-powerline.md +++ b/docs/bn-BD/presets/pastel-powerline.md @@ -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 diff --git a/docs/bn-BD/presets/plain-text.md b/docs/bn-BD/presets/plain-text.md index 2a075171..686b3e06 100644 --- a/docs/bn-BD/presets/plain-text.md +++ b/docs/bn-BD/presets/plain-text.md @@ -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 diff --git a/docs/bn-BD/presets/pure-preset.md b/docs/bn-BD/presets/pure-preset.md index 68b7b49d..b27468de 100644 --- a/docs/bn-BD/presets/pure-preset.md +++ b/docs/bn-BD/presets/pure-preset.md @@ -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 diff --git a/docs/bn-BD/presets/tokyo-night.md b/docs/bn-BD/presets/tokyo-night.md index 5f944be3..59d8f2ca 100644 --- a/docs/bn-BD/presets/tokyo-night.md +++ b/docs/bn-BD/presets/tokyo-night.md @@ -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 diff --git a/docs/ckb-IR/config/README.md b/docs/ckb-IR/config/README.md index 0040f0a7..496c2498 100644 --- a/docs/ckb-IR/config/README.md +++ b/docs/ckb-IR/config/README.md @@ -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,20 +1047,20 @@ 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_folders` | `[]` | Which folders should trigger this module. | -| `style` | `'green bold'` | The style for the module. | -| `disabled` | `false` | Disables the `deno` module. | +| 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', '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. | ### Variables @@ -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 @@ -1759,7 +1756,7 @@ The `git_commit` module shows the current commit hash and also the tag (if any) | `only_detached` | `true` | Only show git commit hash when in detached `HEAD` state | | `tag_disabled` | `true` | Disables showing tag info in `git_commit` module. | | `tag_max_candidates` | `0` | How many commits to consider for tag display. The default only allows exact matches. | -| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | +| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | | `disabled` | `false` | Disables the `git_commit` module. | ### Variables @@ -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. @@ -2934,17 +2975,17 @@ 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_folders` | `['node_modules']` | Which folders should trigger this module. | -| `style` | `'bold green'` | The style for the module. | -| `disabled` | `false` | Disables the `nodejs` module. | -| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | +| 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', '.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. | +| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | ### Variables @@ -3492,24 +3533,26 @@ 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 | -| `style` | `'yellow bold'` | The style for the module. | -| `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_folders` | `[]` | Which folders should trigger this module | -| `disabled` | `false` | Disables the `python` module. | +| 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 | +| `style` | `'yellow bold'` | The style for the module. | +| `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', '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. | ::: tip @@ -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` | `''` | 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. diff --git a/docs/ckb-IR/guide/README.md b/docs/ckb-IR/guide/README.md index f1755ecb..d8632c11 100644 --- a/docs/ckb-IR/guide/README.md +++ b/docs/ckb-IR/guide/README.md @@ -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.


diff --git a/docs/ckb-IR/presets/bracketed-segments.md b/docs/ckb-IR/presets/bracketed-segments.md index f8f51347..2cf79c72 100644 --- a/docs/ckb-IR/presets/bracketed-segments.md +++ b/docs/ckb-IR/presets/bracketed-segments.md @@ -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 diff --git a/docs/ckb-IR/presets/gruvbox-rainbow.md b/docs/ckb-IR/presets/gruvbox-rainbow.md index 291e778e..75bf5b99 100644 --- a/docs/ckb-IR/presets/gruvbox-rainbow.md +++ b/docs/ckb-IR/presets/gruvbox-rainbow.md @@ -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 diff --git a/docs/ckb-IR/presets/jetpack.md b/docs/ckb-IR/presets/jetpack.md index 2bae183f..1822218e 100644 --- a/docs/ckb-IR/presets/jetpack.md +++ b/docs/ckb-IR/presets/jetpack.md @@ -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 diff --git a/docs/ckb-IR/presets/nerd-font.md b/docs/ckb-IR/presets/nerd-font.md index 00e541d9..62a00856 100644 --- a/docs/ckb-IR/presets/nerd-font.md +++ b/docs/ckb-IR/presets/nerd-font.md @@ -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 diff --git a/docs/ckb-IR/presets/no-empty-icons.md b/docs/ckb-IR/presets/no-empty-icons.md index d6ed61f2..96ed1963 100644 --- a/docs/ckb-IR/presets/no-empty-icons.md +++ b/docs/ckb-IR/presets/no-empty-icons.md @@ -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 diff --git a/docs/ckb-IR/presets/no-nerd-font.md b/docs/ckb-IR/presets/no-nerd-font.md index 979d0450..82ab6f22 100644 --- a/docs/ckb-IR/presets/no-nerd-font.md +++ b/docs/ckb-IR/presets/no-nerd-font.md @@ -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 diff --git a/docs/ckb-IR/presets/no-runtimes.md b/docs/ckb-IR/presets/no-runtimes.md index b7b1eff4..dc434fae 100644 --- a/docs/ckb-IR/presets/no-runtimes.md +++ b/docs/ckb-IR/presets/no-runtimes.md @@ -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 diff --git a/docs/ckb-IR/presets/pastel-powerline.md b/docs/ckb-IR/presets/pastel-powerline.md index c761940d..cfde0389 100644 --- a/docs/ckb-IR/presets/pastel-powerline.md +++ b/docs/ckb-IR/presets/pastel-powerline.md @@ -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 diff --git a/docs/ckb-IR/presets/plain-text.md b/docs/ckb-IR/presets/plain-text.md index 2522cf84..517e5bf5 100644 --- a/docs/ckb-IR/presets/plain-text.md +++ b/docs/ckb-IR/presets/plain-text.md @@ -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 diff --git a/docs/ckb-IR/presets/pure-preset.md b/docs/ckb-IR/presets/pure-preset.md index 178e4b7d..48f2bb3f 100644 --- a/docs/ckb-IR/presets/pure-preset.md +++ b/docs/ckb-IR/presets/pure-preset.md @@ -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 diff --git a/docs/ckb-IR/presets/tokyo-night.md b/docs/ckb-IR/presets/tokyo-night.md index ae91768d..8e4247ac 100644 --- a/docs/ckb-IR/presets/tokyo-night.md +++ b/docs/ckb-IR/presets/tokyo-night.md @@ -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 diff --git a/docs/de-DE/config/README.md b/docs/de-DE/config/README.md index 77ab7709..60273552 100644 --- a/docs/de-DE/config/README.md +++ b/docs/de-DE/config/README.md @@ -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,20 +1048,20 @@ 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_folders` | `[]` | Which folders should trigger this module. | -| `style` | `'green bold'` | Stil für dieses Modul. | -| `disabled` | `false` | Disables the `deno` module. | +| 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', '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. | ### Variables @@ -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 @@ -1760,7 +1757,7 @@ The `git_commit` module shows the current commit hash and also the tag (if any) | `only_detached` | `true` | Only show git commit hash when in detached `HEAD` state | | `tag_disabled` | `true` | Disables showing tag info in `git_commit` module. | | `tag_max_candidates` | `0` | How many commits to consider for tag display. The default only allows exact matches. | -| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | +| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | | `disabled` | `false` | Disables the `git_commit` module. | ### Variables @@ -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. @@ -2935,17 +2976,17 @@ 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_folders` | `['node_modules']` | Which folders should trigger this module. | -| `style` | `'bold green'` | Stil für dieses Modul. | -| `disabled` | `false` | Deaktiviert das `nodejs`-Modul. | -| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | +| 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', '.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. | +| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | ### Variables @@ -3493,24 +3534,26 @@ 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 | -| `style` | `'yellow bold'` | Stil für dieses Modul. | -| `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_folders` | `[]` | Which folders should trigger this module | -| `disabled` | `false` | Deaktiviert das `python`-Modul. | +| 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 | +| `style` | `'yellow bold'` | Stil für dieses Modul. | +| `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', '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. | ::: tip @@ -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` | `''` | 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. diff --git a/docs/de-DE/guide/README.md b/docs/de-DE/guide/README.md index ca54da23..a4beaf21 100644 --- a/docs/de-DE/guide/README.md +++ b/docs/de-DE/guide/README.md @@ -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.


diff --git a/docs/de-DE/presets/bracketed-segments.md b/docs/de-DE/presets/bracketed-segments.md index e54eee4c..bcecd0c8 100644 --- a/docs/de-DE/presets/bracketed-segments.md +++ b/docs/de-DE/presets/bracketed-segments.md @@ -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 diff --git a/docs/de-DE/presets/gruvbox-rainbow.md b/docs/de-DE/presets/gruvbox-rainbow.md index 7acbf530..7c089695 100644 --- a/docs/de-DE/presets/gruvbox-rainbow.md +++ b/docs/de-DE/presets/gruvbox-rainbow.md @@ -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 diff --git a/docs/de-DE/presets/jetpack.md b/docs/de-DE/presets/jetpack.md index f494e74f..fce9cb13 100644 --- a/docs/de-DE/presets/jetpack.md +++ b/docs/de-DE/presets/jetpack.md @@ -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 diff --git a/docs/de-DE/presets/nerd-font.md b/docs/de-DE/presets/nerd-font.md index 84e7d068..e4a361c0 100644 --- a/docs/de-DE/presets/nerd-font.md +++ b/docs/de-DE/presets/nerd-font.md @@ -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 diff --git a/docs/de-DE/presets/no-empty-icons.md b/docs/de-DE/presets/no-empty-icons.md index 34fde4ea..712ef9db 100644 --- a/docs/de-DE/presets/no-empty-icons.md +++ b/docs/de-DE/presets/no-empty-icons.md @@ -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 diff --git a/docs/de-DE/presets/no-nerd-font.md b/docs/de-DE/presets/no-nerd-font.md index 48afd9ca..d6967f19 100644 --- a/docs/de-DE/presets/no-nerd-font.md +++ b/docs/de-DE/presets/no-nerd-font.md @@ -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 diff --git a/docs/de-DE/presets/no-runtimes.md b/docs/de-DE/presets/no-runtimes.md index dd77cd6b..b826d66a 100644 --- a/docs/de-DE/presets/no-runtimes.md +++ b/docs/de-DE/presets/no-runtimes.md @@ -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 diff --git a/docs/de-DE/presets/pastel-powerline.md b/docs/de-DE/presets/pastel-powerline.md index 85cc15f7..953be304 100644 --- a/docs/de-DE/presets/pastel-powerline.md +++ b/docs/de-DE/presets/pastel-powerline.md @@ -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 diff --git a/docs/de-DE/presets/plain-text.md b/docs/de-DE/presets/plain-text.md index 51a9e1d8..2c10aec0 100644 --- a/docs/de-DE/presets/plain-text.md +++ b/docs/de-DE/presets/plain-text.md @@ -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 diff --git a/docs/de-DE/presets/pure-preset.md b/docs/de-DE/presets/pure-preset.md index d3b0b213..68a28a1b 100644 --- a/docs/de-DE/presets/pure-preset.md +++ b/docs/de-DE/presets/pure-preset.md @@ -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 diff --git a/docs/de-DE/presets/tokyo-night.md b/docs/de-DE/presets/tokyo-night.md index 1c98b43b..bf9dfb25 100644 --- a/docs/de-DE/presets/tokyo-night.md +++ b/docs/de-DE/presets/tokyo-night.md @@ -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 diff --git a/docs/es-ES/config/README.md b/docs/es-ES/config/README.md index 28925a62..1a2602a1 100644 --- a/docs/es-ES/config/README.md +++ b/docs/es-ES/config/README.md @@ -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,20 +1047,20 @@ 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_folders` | `[]` | Qué carpetas deberían activar este módulo. | -| `style` | `'green bold'` | El estilo del módulo. | -| `disabled` | `false` | Deshabilita el módulo `deno`. | +| 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', '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`. | ### Variables @@ -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 @@ -1759,7 +1756,7 @@ El módulo `git_commit` muestra el hash de la confirmación actual y también la | `only_detached` | `true` | Mostrar solo el hash de la confirmación de git cuando esté en estado "detached `HEAD`" | | `tag_disabled` | `true` | Deshabilita mostrar información de etiquetas en el módulo `git_commit`. | | `tag_max_candidates` | `0` | How many commits to consider for tag display. El valor por defecto sólo permite coincidencias exactas. | -| `tag_symbol` | `' 🏷 '` | Símbolo de etiqueta prefijando la información mostrada | +| `tag_symbol` | `' 🏷 '` | Símbolo de etiqueta prefijando la información mostrada | | `disabled` | `false` | Deshabilita el módulo `git_commit`. | ### Variables @@ -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. @@ -2934,17 +2975,17 @@ 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_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`. | -| `not_capable_style` | `'bold red'` | El estilo para el módulo cuando una propiedad de motores en package.json no coincide con la versión de Node.js. | +| 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', '.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`. | +| `not_capable_style` | `'bold red'` | El estilo para el módulo cuando una propiedad de motores en package.json no coincide con la versión de Node.js. | ### Variables @@ -3492,24 +3533,26 @@ 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 | -| `style` | `'yellow bold'` | El estilo del módulo. | -| `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_folders` | `[]` | Qué carpetas deben activar este módulo | -| `disabled` | `false` | Deshabilita el módulo `python`. | +| 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 | +| `style` | `'yellow bold'` | El estilo del módulo. | +| `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', '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`. | ::: tip @@ -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` | `''` | La descripción del módulo que se muestra al ejecutar `starship explain`. | @@ -4591,11 +4623,11 @@ 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` | -| symbol | Refleja el valor de la opción `symbol` | -| style\* | Refleja el valor de la opción `style` | +| Variable | Descripción | +| --------- | -------------------------------------- | +| 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` | *: Esta variable solamente puede ser usada como parte de una cadena de caracteres de estilo @@ -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. diff --git a/docs/es-ES/guide/README.md b/docs/es-ES/guide/README.md index d1934100..5875d8cb 100644 --- a/docs/es-ES/guide/README.md +++ b/docs/es-ES/guide/README.md @@ -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.


diff --git a/docs/es-ES/presets/bracketed-segments.md b/docs/es-ES/presets/bracketed-segments.md index a04c381d..7aab834f 100644 --- a/docs/es-ES/presets/bracketed-segments.md +++ b/docs/es-ES/presets/bracketed-segments.md @@ -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 diff --git a/docs/es-ES/presets/gruvbox-rainbow.md b/docs/es-ES/presets/gruvbox-rainbow.md index 9bbef49d..6e8f542d 100644 --- a/docs/es-ES/presets/gruvbox-rainbow.md +++ b/docs/es-ES/presets/gruvbox-rainbow.md @@ -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 diff --git a/docs/es-ES/presets/jetpack.md b/docs/es-ES/presets/jetpack.md index 764ef8fd..0c77acfe 100644 --- a/docs/es-ES/presets/jetpack.md +++ b/docs/es-ES/presets/jetpack.md @@ -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 diff --git a/docs/es-ES/presets/nerd-font.md b/docs/es-ES/presets/nerd-font.md index 619f58ac..024061d4 100644 --- a/docs/es-ES/presets/nerd-font.md +++ b/docs/es-ES/presets/nerd-font.md @@ -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 diff --git a/docs/es-ES/presets/no-empty-icons.md b/docs/es-ES/presets/no-empty-icons.md index ea09599c..fcd6ba39 100644 --- a/docs/es-ES/presets/no-empty-icons.md +++ b/docs/es-ES/presets/no-empty-icons.md @@ -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 diff --git a/docs/es-ES/presets/no-nerd-font.md b/docs/es-ES/presets/no-nerd-font.md index 9bb9a88c..dd551611 100644 --- a/docs/es-ES/presets/no-nerd-font.md +++ b/docs/es-ES/presets/no-nerd-font.md @@ -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 diff --git a/docs/es-ES/presets/no-runtimes.md b/docs/es-ES/presets/no-runtimes.md index b126d98d..687bffda 100644 --- a/docs/es-ES/presets/no-runtimes.md +++ b/docs/es-ES/presets/no-runtimes.md @@ -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 diff --git a/docs/es-ES/presets/pastel-powerline.md b/docs/es-ES/presets/pastel-powerline.md index 29cdbc39..a0f28552 100644 --- a/docs/es-ES/presets/pastel-powerline.md +++ b/docs/es-ES/presets/pastel-powerline.md @@ -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 diff --git a/docs/es-ES/presets/plain-text.md b/docs/es-ES/presets/plain-text.md index b2d97672..6667ac5d 100644 --- a/docs/es-ES/presets/plain-text.md +++ b/docs/es-ES/presets/plain-text.md @@ -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 diff --git a/docs/es-ES/presets/pure-preset.md b/docs/es-ES/presets/pure-preset.md index 081a5af4..d877434f 100644 --- a/docs/es-ES/presets/pure-preset.md +++ b/docs/es-ES/presets/pure-preset.md @@ -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 diff --git a/docs/es-ES/presets/tokyo-night.md b/docs/es-ES/presets/tokyo-night.md index af6ec4e3..6b999b67 100644 --- a/docs/es-ES/presets/tokyo-night.md +++ b/docs/es-ES/presets/tokyo-night.md @@ -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 diff --git a/docs/fr-FR/config/README.md b/docs/fr-FR/config/README.md index 6aa14db0..91277061 100644 --- a/docs/fr-FR/config/README.md +++ b/docs/fr-FR/config/README.md @@ -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,20 +1047,20 @@ 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_folders` | `[]` | Les dossiers qui activent ce module. | -| `style` | `'green bold'` | Le style pour le module. | -| `disabled` | `false` | Désactive le module `deno`. | +| 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', '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`. | ### Variables @@ -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 @@ -1759,7 +1756,7 @@ Le module `git_commit` affiche le hash du commit courant et l’étiquette (s’ | `only_detached` | `true` | Ne montrer le hash du commit qu'en mode `HEAD` détachée. | | `tag_disabled` | `true` | Désactive l'affichage des informations du tag dans le module `git_commit`. | | `tag_max_candidates` | `0` | How many commits to consider for tag display. The default only allows exact matches. | -| `tag_symbol` | `' 🏷 '` | Symbole préfixant les informations affichées concernant le tag | +| `tag_symbol` | `' 🏷 '` | Symbole préfixant les informations affichées concernant le tag | | `disabled` | `false` | Désactive le module `git_commit`. | ### Variables @@ -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. @@ -2934,17 +2975,17 @@ 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_folders` | `['node_modules']` | Les dossiers qui activent ce module. | -| `style` | `'bold green'` | Le style pour le module. | -| `disabled` | `false` | Désactive le module `nodejs`. | -| `not_capable_style` | `'bold red'` | Le style du module quand une propriété engines dans le package.json ne correspond pas à la version Node.js. | +| 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', '.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`. | +| `not_capable_style` | `'bold red'` | Le style du module quand une propriété engines dans le package.json ne correspond pas à la version Node.js. | ### Variables @@ -3492,24 +3533,26 @@ 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 | -| `style` | `'yellow bold'` | Le style pour le module. | -| `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_folders` | `[]` | Quels dossiers devraient activer ce module | -| `disabled` | `false` | Désactive le module `python`. | +| 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 | +| `style` | `'yellow bold'` | Le style pour le module. | +| `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', '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`. | ::: tip @@ -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` | `''` | La description du module qui est affichée lors de l’exécution de `starship explain`. | @@ -4591,11 +4623,11 @@ 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` | -| symbole | Reflète la valeur de l'option `symbol` | -| style\* | Reflète la valeur de l'option `style` | +| Variable | Description | +| --------- | -------------------------------------- | +| 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` | *: Cette variable peut uniquement être utilisée dans une chaine de 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. diff --git a/docs/fr-FR/guide/README.md b/docs/fr-FR/guide/README.md index 077d2fbb..b4f57f66 100644 --- a/docs/fr-FR/guide/README.md +++ b/docs/fr-FR/guide/README.md @@ -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.


diff --git a/docs/fr-FR/presets/bracketed-segments.md b/docs/fr-FR/presets/bracketed-segments.md index 5c42b115..f7448ce3 100644 --- a/docs/fr-FR/presets/bracketed-segments.md +++ b/docs/fr-FR/presets/bracketed-segments.md @@ -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 diff --git a/docs/fr-FR/presets/gruvbox-rainbow.md b/docs/fr-FR/presets/gruvbox-rainbow.md index 80bc96dc..2a8a4aaf 100644 --- a/docs/fr-FR/presets/gruvbox-rainbow.md +++ b/docs/fr-FR/presets/gruvbox-rainbow.md @@ -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 diff --git a/docs/fr-FR/presets/jetpack.md b/docs/fr-FR/presets/jetpack.md index 9f1144bb..0fd625f5 100644 --- a/docs/fr-FR/presets/jetpack.md +++ b/docs/fr-FR/presets/jetpack.md @@ -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 diff --git a/docs/fr-FR/presets/nerd-font.md b/docs/fr-FR/presets/nerd-font.md index d3713b2c..9bfd1067 100644 --- a/docs/fr-FR/presets/nerd-font.md +++ b/docs/fr-FR/presets/nerd-font.md @@ -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 diff --git a/docs/fr-FR/presets/no-empty-icons.md b/docs/fr-FR/presets/no-empty-icons.md index de83a7f1..5fa22051 100644 --- a/docs/fr-FR/presets/no-empty-icons.md +++ b/docs/fr-FR/presets/no-empty-icons.md @@ -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 diff --git a/docs/fr-FR/presets/no-nerd-font.md b/docs/fr-FR/presets/no-nerd-font.md index 4fc71532..d74f2536 100644 --- a/docs/fr-FR/presets/no-nerd-font.md +++ b/docs/fr-FR/presets/no-nerd-font.md @@ -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 diff --git a/docs/fr-FR/presets/no-runtimes.md b/docs/fr-FR/presets/no-runtimes.md index c1ef40d1..79544c1d 100644 --- a/docs/fr-FR/presets/no-runtimes.md +++ b/docs/fr-FR/presets/no-runtimes.md @@ -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 diff --git a/docs/fr-FR/presets/pastel-powerline.md b/docs/fr-FR/presets/pastel-powerline.md index 2731c9d2..8c7c6956 100644 --- a/docs/fr-FR/presets/pastel-powerline.md +++ b/docs/fr-FR/presets/pastel-powerline.md @@ -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 diff --git a/docs/fr-FR/presets/plain-text.md b/docs/fr-FR/presets/plain-text.md index bec80676..86d9fee6 100644 --- a/docs/fr-FR/presets/plain-text.md +++ b/docs/fr-FR/presets/plain-text.md @@ -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 diff --git a/docs/fr-FR/presets/pure-preset.md b/docs/fr-FR/presets/pure-preset.md index 7b1e4029..848d78bf 100644 --- a/docs/fr-FR/presets/pure-preset.md +++ b/docs/fr-FR/presets/pure-preset.md @@ -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 diff --git a/docs/fr-FR/presets/tokyo-night.md b/docs/fr-FR/presets/tokyo-night.md index c3b6bd4e..29f47ced 100644 --- a/docs/fr-FR/presets/tokyo-night.md +++ b/docs/fr-FR/presets/tokyo-night.md @@ -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 diff --git a/docs/id-ID/config/README.md b/docs/id-ID/config/README.md index ef0dc512..4333d686 100644 --- a/docs/id-ID/config/README.md +++ b/docs/id-ID/config/README.md @@ -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,20 +1047,20 @@ 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_folders` | `[]` | Folder mana yang sebaiknya memicul modul ini. | -| `style` | `'green bold'` | Gaya penataan untuk modul. | -| `disabled` | `false` | Menonaktifkan modul `deno`. | +| 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', '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`. | ### Variabel @@ -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 @@ -1759,7 +1756,7 @@ The `git_commit` module shows the current commit hash and also the tag (if any) | `only_detached` | `true` | Only show git commit hash when in detached `HEAD` state | | `tag_disabled` | `true` | Disables showing tag info in `git_commit` module. | | `tag_max_candidates` | `0` | How many commits to consider for tag display. The default only allows exact matches. | -| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | +| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | | `disabled` | `false` | Disables the `git_commit` module. | ### Variabel @@ -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. @@ -2934,17 +2975,17 @@ 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_folders` | `['node_modules']` | Folder mana yang sebaiknya memicul modul ini. | -| `style` | `'bold green'` | Gaya penataan untuk modul. | -| `disabled` | `false` | Disables the `nodejs` module. | -| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | +| 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', '.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. | +| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | ### Variabel @@ -3492,24 +3533,26 @@ 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 | -| `style` | `'yellow bold'` | Gaya penataan untuk modul. | -| `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_folders` | `[]` | Folder mana yang sebaiknya memicul modul ini | -| `disabled` | `false` | Disables the `python` module. | +| 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 | +| `style` | `'yellow bold'` | Gaya penataan untuk modul. | +| `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', '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. | ::: tip @@ -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` | `''` | 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. diff --git a/docs/id-ID/guide/README.md b/docs/id-ID/guide/README.md index bf9e3ad9..100f2124 100644 --- a/docs/id-ID/guide/README.md +++ b/docs/id-ID/guide/README.md @@ -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.


diff --git a/docs/id-ID/presets/bracketed-segments.md b/docs/id-ID/presets/bracketed-segments.md index 59536d22..08cd8938 100644 --- a/docs/id-ID/presets/bracketed-segments.md +++ b/docs/id-ID/presets/bracketed-segments.md @@ -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 diff --git a/docs/id-ID/presets/gruvbox-rainbow.md b/docs/id-ID/presets/gruvbox-rainbow.md index 3de9ecf5..81c1f2a3 100644 --- a/docs/id-ID/presets/gruvbox-rainbow.md +++ b/docs/id-ID/presets/gruvbox-rainbow.md @@ -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 diff --git a/docs/id-ID/presets/jetpack.md b/docs/id-ID/presets/jetpack.md index 569fe0a9..0a1b4ff5 100644 --- a/docs/id-ID/presets/jetpack.md +++ b/docs/id-ID/presets/jetpack.md @@ -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 diff --git a/docs/id-ID/presets/nerd-font.md b/docs/id-ID/presets/nerd-font.md index b8db7af6..80df5630 100644 --- a/docs/id-ID/presets/nerd-font.md +++ b/docs/id-ID/presets/nerd-font.md @@ -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 diff --git a/docs/id-ID/presets/no-empty-icons.md b/docs/id-ID/presets/no-empty-icons.md index 53c8e211..1c96192d 100644 --- a/docs/id-ID/presets/no-empty-icons.md +++ b/docs/id-ID/presets/no-empty-icons.md @@ -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 diff --git a/docs/id-ID/presets/no-nerd-font.md b/docs/id-ID/presets/no-nerd-font.md index d536df84..982a1a74 100644 --- a/docs/id-ID/presets/no-nerd-font.md +++ b/docs/id-ID/presets/no-nerd-font.md @@ -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 diff --git a/docs/id-ID/presets/no-runtimes.md b/docs/id-ID/presets/no-runtimes.md index 60eb7a0c..c4447a6a 100644 --- a/docs/id-ID/presets/no-runtimes.md +++ b/docs/id-ID/presets/no-runtimes.md @@ -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 diff --git a/docs/id-ID/presets/pastel-powerline.md b/docs/id-ID/presets/pastel-powerline.md index bb83d2f7..12bf036b 100644 --- a/docs/id-ID/presets/pastel-powerline.md +++ b/docs/id-ID/presets/pastel-powerline.md @@ -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 diff --git a/docs/id-ID/presets/plain-text.md b/docs/id-ID/presets/plain-text.md index 018589ae..f9de9b28 100644 --- a/docs/id-ID/presets/plain-text.md +++ b/docs/id-ID/presets/plain-text.md @@ -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 diff --git a/docs/id-ID/presets/pure-preset.md b/docs/id-ID/presets/pure-preset.md index c6bc781b..eeb1a8da 100644 --- a/docs/id-ID/presets/pure-preset.md +++ b/docs/id-ID/presets/pure-preset.md @@ -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 diff --git a/docs/id-ID/presets/tokyo-night.md b/docs/id-ID/presets/tokyo-night.md index ae45ba6c..b82d4bcf 100644 --- a/docs/id-ID/presets/tokyo-night.md +++ b/docs/id-ID/presets/tokyo-night.md @@ -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 diff --git a/docs/it-IT/config/README.md b/docs/it-IT/config/README.md index 7cf268b6..357fbbbf 100644 --- a/docs/it-IT/config/README.md +++ b/docs/it-IT/config/README.md @@ -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,20 +1047,20 @@ 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_folders` | `[]` | Quali cartelle dovrebbero attivare questo modulo. | -| `style` | `'green bold'` | Lo stile per il modulo. | -| `disabled` | `false` | Disables the `deno` module. | +| 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', '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. | ### Variables @@ -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 @@ -1759,7 +1756,7 @@ The `git_commit` module shows the current commit hash and also the tag (if any) | `only_detached` | `true` | Only show git commit hash when in detached `HEAD` state | | `tag_disabled` | `true` | Disables showing tag info in `git_commit` module. | | `tag_max_candidates` | `0` | How many commits to consider for tag display. The default only allows exact matches. | -| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | +| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | | `disabled` | `false` | Disables the `git_commit` module. | ### Variables @@ -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. @@ -2934,17 +2975,17 @@ 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_folders` | `['node_modules']` | Quali cartelle dovrebbero attivare questo modulo. | -| `style` | `'bold green'` | Lo stile per il modulo. | -| `disabled` | `false` | Disables the `nodejs` module. | -| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | +| 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', '.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. | +| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | ### Variables @@ -3492,24 +3533,26 @@ 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 | -| `style` | `'yellow bold'` | Lo stile per il modulo. | -| `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_folders` | `[]` | Quali cartelle dovrebbero attivare questo modulo | -| `disabled` | `false` | Disables the `python` module. | +| 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 | +| `style` | `'yellow bold'` | Lo stile per il modulo. | +| `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', '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. | ::: tip @@ -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` | `''` | 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. diff --git a/docs/it-IT/guide/README.md b/docs/it-IT/guide/README.md index 2fa7cb57..65c8e683 100644 --- a/docs/it-IT/guide/README.md +++ b/docs/it-IT/guide/README.md @@ -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.


diff --git a/docs/it-IT/presets/bracketed-segments.md b/docs/it-IT/presets/bracketed-segments.md index 95599a8a..6501a907 100644 --- a/docs/it-IT/presets/bracketed-segments.md +++ b/docs/it-IT/presets/bracketed-segments.md @@ -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 diff --git a/docs/it-IT/presets/gruvbox-rainbow.md b/docs/it-IT/presets/gruvbox-rainbow.md index fd186452..393b5e20 100644 --- a/docs/it-IT/presets/gruvbox-rainbow.md +++ b/docs/it-IT/presets/gruvbox-rainbow.md @@ -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 diff --git a/docs/it-IT/presets/jetpack.md b/docs/it-IT/presets/jetpack.md index 6c0ee038..3f558396 100644 --- a/docs/it-IT/presets/jetpack.md +++ b/docs/it-IT/presets/jetpack.md @@ -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 diff --git a/docs/it-IT/presets/nerd-font.md b/docs/it-IT/presets/nerd-font.md index fd671f29..bc3669f5 100644 --- a/docs/it-IT/presets/nerd-font.md +++ b/docs/it-IT/presets/nerd-font.md @@ -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 diff --git a/docs/it-IT/presets/no-empty-icons.md b/docs/it-IT/presets/no-empty-icons.md index c09604d7..76a02682 100644 --- a/docs/it-IT/presets/no-empty-icons.md +++ b/docs/it-IT/presets/no-empty-icons.md @@ -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 diff --git a/docs/it-IT/presets/no-nerd-font.md b/docs/it-IT/presets/no-nerd-font.md index 6cb719dd..8cf63083 100644 --- a/docs/it-IT/presets/no-nerd-font.md +++ b/docs/it-IT/presets/no-nerd-font.md @@ -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 diff --git a/docs/it-IT/presets/no-runtimes.md b/docs/it-IT/presets/no-runtimes.md index 8747a717..cf474256 100644 --- a/docs/it-IT/presets/no-runtimes.md +++ b/docs/it-IT/presets/no-runtimes.md @@ -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 diff --git a/docs/it-IT/presets/pastel-powerline.md b/docs/it-IT/presets/pastel-powerline.md index 066bb7c9..0a6c7faf 100644 --- a/docs/it-IT/presets/pastel-powerline.md +++ b/docs/it-IT/presets/pastel-powerline.md @@ -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 diff --git a/docs/it-IT/presets/plain-text.md b/docs/it-IT/presets/plain-text.md index 4caff370..7cf95de9 100644 --- a/docs/it-IT/presets/plain-text.md +++ b/docs/it-IT/presets/plain-text.md @@ -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 diff --git a/docs/it-IT/presets/pure-preset.md b/docs/it-IT/presets/pure-preset.md index 327213e2..11f25e69 100644 --- a/docs/it-IT/presets/pure-preset.md +++ b/docs/it-IT/presets/pure-preset.md @@ -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 diff --git a/docs/it-IT/presets/tokyo-night.md b/docs/it-IT/presets/tokyo-night.md index 30de82d3..4a89be96 100644 --- a/docs/it-IT/presets/tokyo-night.md +++ b/docs/it-IT/presets/tokyo-night.md @@ -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 diff --git a/docs/ja-JP/advanced-config/README.md b/docs/ja-JP/advanced-config/README.md index 308127f3..1829cab4 100644 --- a/docs/ja-JP/advanced-config/README.md +++ b/docs/ja-JP/advanced-config/README.md @@ -301,6 +301,6 @@ continuation_prompt = '▶▶ ' すべてのスタイル文字列がすべての端末で正しく表示できるわけではありません。 特に、端末の変な動作として以下のようなものが知られています。 -- 多くの端末はデフォルトで `bink` のサポートを無効にしています。 +- 多くの端末はデフォルトで `blink` のサポートを無効にしています。 - `hidden` は [iTerm ではサポートされていません](https://gitlab.com/gnachman/iterm2/-/issues/4564)。 - `strikethrough` は、macOS 既定の Terminal.app ではサポートされていません。 diff --git a/docs/ja-JP/config/README.md b/docs/ja-JP/config/README.md index 13bccff6..50a96e43 100644 --- a/docs/ja-JP/config/README.md +++ b/docs/ja-JP/config/README.md @@ -553,10 +553,7 @@ discharging_symbol = '💦 ' ## Buf -`buf`モジュールは、現在インストールされている[Buf](https://buf.build)のバージョンを表示します。 デフォルトでは次のすべての条件が満たされると、モジュールが表示されます。 - -- [`buf`](https://github.com/bufbuild/buf)CLI がインストールされている -- カレントディレクトリに、[`buf.yaml`](https://docs.buf.build/configuration/v1/buf-yaml)、[`buf.gen.yaml`](https://docs.buf.build/configuration/v1/buf-gen-yaml)または[`buf.work.yaml`](https://docs.buf.build/configuration/v1/buf-work-yaml)が含まれている +`buf`モジュールは、現在インストールされている[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. ### オプション @@ -635,7 +632,7 @@ format = 'via [🍔 $version](bold green) ' Bun ランタイムだけが表示されるように、設定中の [nodejs モジュール](#nodejs) の `detect_files` プロパティを上書きできます。 -``` +```toml [nodejs] detect_files = ['package.json', '.node-version', '!bunfig.toml', '!bun.lockb'] ``` @@ -863,7 +860,7 @@ format = 'underwent [$duration](bold yellow)' ::: tip -Note: これはconda自身の プロンプト修飾子 を抑制しません。`conda config --set changeps1 False` で実行することができます。 +Note: これはconda自身の プロンプト修飾子 を抑制しません。`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,20 +1047,20 @@ format = 'via [🔰 $version](bold red) ' `deno`モジュールは、現在インストールされている[Deno](https://deno.land/)のバージョンを表示します。 デフォルトでは次の条件のいずれかが満たされると、モジュールが表示されます。 -- カレントディレクトリに`deno.json`、`deno.jsonc`、`mod.ts`、`mod.js`、`deps.ts`もしくは`deps.js`が含まれている +- The current directory contains a `deno.json`, `deno.jsonc`, `deno.lock`, `mod.ts`, `mod.js`, `deps.ts` or `deps.js` file ### オプション -| オプション | デフォルト | 説明 | -| ------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------ | -| `format` | `'via [$symbol($version )]($style)'` | module のフォーマットです。 | -| `version_format` | `'v${raw}'` | バージョンのフォーマット。 使用可能な変数は`raw`、`major`、`minor`と`patch`です。 | -| `symbol` | `'🦕 '` | Dart のシンボルを表すフォーマット文字列 | -| `detect_extensions` | `[]` | どの拡張子がこのモジュールをアクティブにするか | -| `detect_files` | `['deno.json', 'deno.jsonc', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | どのファイル名がこのモジュールをアクティブにするか | -| `detect_folders` | `[]` | どのフォルダーがこのモジュールをアクティブにするか | -| `style` | `'green bold'` | モジュールのスタイルです。 | -| `disabled` | `false` | `deno`モジュールを無効化します。 | +| オプション | デフォルト | 説明 | +| ------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------ | +| `format` | `'via [$symbol($version )]($style)'` | module のフォーマットです。 | +| `version_format` | `'v${raw}'` | バージョンのフォーマット。 使用可能な変数は`raw`、`major`、`minor`と`patch`です。 | +| `symbol` | `'🦕 '` | Deno のシンボルを表すフォーマット文字列 | +| `detect_extensions` | `[]` | どの拡張子がこのモジュールをアクティブにするか | +| `detect_files` | `['deno.json', 'deno.jsonc', 'deno.lock', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | どのファイル名がこのモジュールをアクティブにするか | +| `detect_folders` | `[]` | どのフォルダーがこのモジュールをアクティブにするか | +| `style` | `'green bold'` | モジュールのスタイルです。 | +| `disabled` | `false` | `deno`モジュールを無効化します。 | ### 変数 @@ -1117,7 +1114,7 @@ format = 'via [🦕 $version](green bold) ' | `fish_style_pwd_dir_length` | `0` | fish shellのpwdパスロジックを適用するときに使用する文字数です。 | | `use_logical_path` | `true` | `true` の場合、シェルによって `PWD` または `--logical-path` を通して指定される起点からの論理パスを表示します。 `false` の場合、代わりにシンボリックリンクを解決したファイルシステム上の物理パスを表示します。 | -`substitutions` によってパスに含まれる固定文字列に対する任意の置換を定義できます。固定文字列の例として、長いネットワークプレフィックスや (Java の) 開発ディレクトリが考えられます。 ※これは fish 形式の 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. ※これは fish 形式の PWD を無効化します。 ```toml [directory.substitutions] @@ -1207,7 +1204,7 @@ disabled = false ## Docker Context -`docker_context`モジュールは、`default`に設定されていない場合、または環境変数`DOCKER_MACHINE_NAME`、`DOCKER_HOST`または`DOCKER_CONTEXT`が設定されている場合 (使用中のコンテキストを上書きするため)、現在アクティブな[Docker context](https://docs.docker.com/engine/context/working-with-contexts/)を表示します。 +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). ### オプション @@ -1568,7 +1565,7 @@ AA -------------------------------------------- BB ----------------------------- | `symbol` | `' '` | 現在のディレクトリのチェックアウトのブランチ名の前に使用されるシンボルです。 | | `style` | `'bold purple'` | モジュールのスタイルです。 | | `truncation_length` | `2^63 - 1` | Fossil のブランチ名を `N` 書記素までで切り捨てます。 | -| `truncation_symbol` | `'…'` | ブランチ名切り捨てられていることを示すための記号です。 `''` で記号なしにできます。 | +| `truncation_symbol` | `'…'` | ブランチ名が切り捨てられていることを示すための記号です。 `''` で記号なしにできます。 | | `disabled` | `true` | `fossil_branch` モジュールを無効にします。 | ### 変数 @@ -1716,7 +1713,7 @@ very-long-project-name = 'vlpn' | `symbol` | `' '` | gitブランチのシンボルを表すフォーマット文字列。 | | `style` | `'bold purple'` | モジュールのスタイルです。 | | `truncation_length` | `2^63 - 1` | gitブランチ名を `N` 書記素までで切り捨てます。 | -| `truncation_symbol` | `'…'` | ブランチ名切り捨てられていることを示すための記号です。 `''` で記号なしにできます。 | +| `truncation_symbol` | `'…'` | ブランチ名が切り捨てられていることを示すための記号です。 `''` で記号なしにできます。 | | `only_attached` | `false` | デタッチ `HEAD` 状態にない時はブランチ名のみ表示します。 | | `ignore_branches` | `[]` | 表示しない名前のリスト。 'master' や 'main' に対して有用です。 | | `disabled` | `false` | `git_branch`モジュールを無効にします。 | @@ -1759,7 +1756,7 @@ ignore_branches = ['master', 'main'] | `only_detached` | `true` | detached `HEAD` 状態のときのみ git コミットハッシュを表示する | | `tag_disabled` | `true` | `git_commit` モジュールのタグ情報の表示を無効にする。 | | `tag_max_candidates` | `0` | タグ表示で考慮するコミットの数。 既定では完全一致のみ許可します。 | -| `tag_symbol` | `' 🏷 '` | 表示される情報の前に追加されるタグシンボル | +| `tag_symbol` | `' 🏷 '` | 表示される情報の前に追加されるタグシンボル | | `disabled` | `false` | `git_commit` モジュールを無効にします。 | ### 変数 @@ -1890,7 +1887,7 @@ WSL環境のWindowsディレクトリ(例: `/mnt/c/`以下) では、Git Status | `staged` | `'+'` | `staged`のフォーマット | | `renamed` | `'»'` | `renamed`のフォーマット | | `deleted` | `'✘'` | `deleted`のフォーマット | -| `typechanged` | `""` | `typechange` のフォーマット | +| `typechanged` | `""` | The format of `typechanged` | | `style` | `'bold red'` | モジュールのスタイルです。 | | `ignore_submodules` | `false` | サブモジュールの変更を無視します。 | | `disabled` | `false` | `git_status`モジュールを無効にします。 | @@ -1911,7 +1908,7 @@ WSL環境のWindowsディレクトリ(例: `/mnt/c/`以下) では、Git Status | `staged` | インデックスに新しく追加されたファイルがあるときに、 `staged` を表示します。 | | `renamed` | インデックスに名前が変更されたファイルがあるときに、 `renamed` を表示します。 | | `deleted` | インデックスに削除されたファイルがあるときに、 `deleted` を表示します。 | -| `typechanged` | インデックスにファイルタイプの変更があるときに、 `typechange` を表示します。 | +| `typechanged` | Displays `typechanged` when a file's type has been changed in the staging area. | | style\* | オプション `style` の値をミラーする | *: この変数は、スタイル文字列の一部としてのみ使用することができます。 @@ -2248,15 +2245,16 @@ format = 'via [⎈ $version](bold white) ' ### オプション -| オプション | デフォルト | 説明 | -| ----------------- | -------------------------------------- | ------------------------------------------------------------------------------------ | -| `ssh_only` | `true` | SSHセッションに接続されている場合にのみホスト名を表示します。 | -| `ssh_symbol` | `'🌐 '` | SSH セッションに接続しているときのシンボルを表すフォーマット文字列。 | -| `trim_at` | `'.'` | この文字が最初にマッチするまでをホスト名と認識します。 `'.'` は最初の . 以降の文字列を切り捨てます。 `''`を指定した場合、文字列の切り捨ては行われません。 | -| `detect_env_vars` | `[]` | このモジュールを活性化する環境変数。 | -| `format` | `'[$ssh_symbol$hostname]($style) in '` | module のフォーマットです。 | -| `style` | `'bold dimmed green'` | モジュールのスタイルです。 | -| `disabled` | `false` | `hostname`モジュールを無効にします。 | +| オプション | デフォルト | 説明 | +| ----------------- | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | +| `ssh_only` | `true` | SSHセッションに接続されている場合にのみホスト名を表示します。 | +| `ssh_symbol` | `'🌐 '` | SSH セッションに接続しているときのシンボルを表すフォーマット文字列。 | +| `trim_at` | `'.'` | この文字が最初にマッチするまでをホスト名と認識します。 `'.'` は最初の . 以降の文字列を切り捨てます。 `''`を指定した場合、文字列の切り捨ては行われません。 | +| `detect_env_vars` | `[]` | このモジュールを活性化する環境変数。 | +| `format` | `'[$ssh_symbol$hostname]($style) in '` | module のフォーマットです。 | +| `style` | `'bold dimmed green'` | モジュールのスタイルです。 | +| `disabled` | `false` | `hostname`モジュールを無効にします。 | +| `aliases` | `{}` | Translate system hostnames to something else. If `trim_at` is specified, only the first part will be matched and replaced. | ### 変数 @@ -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 `Java`モジュールは、現在インストールされている[Java](https://www.oracle.com/java/)のバージョンを表示します。 デフォルトでは次の条件のいずれかが満たされると、モジュールが表示されます。 @@ -2784,7 +2790,7 @@ The `hg_branch` module shows the active branch and topic of the repo in your cur | `style` | `'bold purple'` | モジュールのスタイルです。 | | `format` | `'on [$symbol$branch(:$topic)]($style) '` | module のフォーマットです。 | | `truncation_length` | `2^63 - 1` | Truncates the hg branch / topic name to `N` graphemes | -| `truncation_symbol` | `'…'` | ブランチ名切り捨てられていることを示すための記号です。 | +| `truncation_symbol` | `'…'` | ブランチ名が切り捨てられていることを示すための記号です。 | | `disabled` | `true` | Disables the `hg_branch` module. | ### 変数 @@ -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 + +### オプション + +| オプション | デフォルト | 説明 | +| ------------------- | ------------------------------------- | ------------------------------------------------------ | +| `format` | `'with [$symbol($version )]($style)'` | module のフォーマットです。 | +| `symbol` | `'🔥 '` | The symbol used before displaying the version of Mojo. | +| `style` | `'bold 208'` | モジュールのスタイルです。 | +| `disabled` | `false` | Disables the `mojo` module. | +| `detect_extensions` | `['mojo', '🔥']` | どの拡張子がこのモジュールをアクティブにするか | +| `detect_files` | `[]` | どのファイル名がこのモジュールをアクティブにするか | +| `detect_folders` | `[]` | どのフォルダーがこのモジュールをアクティブにするか | + +### 変数 + +| 変数 | 設定例 | 説明 | +| --------- | -------- | ----------------------- | +| version | `24.4.0` | The version of `mojo` | +| symbol | | オプション `symbol` の値をミラーする | +| style\* | | オプション `style` の値をミラーする | + +*: この変数は、スタイル文字列の一部としてのみ使用することができます。 + +### 設定例 + +```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. @@ -2934,17 +2975,17 @@ format = 'via [☃️ $state( \($name\))](bold blue) ' ### オプション -| オプション | デフォルト | 説明 | -| ------------------- | ------------------------------------------ | ----------------------------------------------------------------------------------------------------- | -| `format` | `'via [$symbol($version )]($style)'` | module のフォーマットです。 | -| `version_format` | `'v${raw}'` | バージョンのフォーマット。 使用可能な変数は`raw`、`major`、`minor`と`patch`です。 | -| `symbol` | `' '` | A format string representing the symbol of Node.js. | -| `detect_extensions` | `['js', 'mjs', 'cjs', 'ts', 'mts', 'cts']` | どの拡張子がこのモジュールをアクティブにするか | -| `detect_files` | `['package.json', '.node-version']` | どのファイル名がこのモジュールをアクティブにするか | -| `detect_folders` | `['node_modules']` | どのフォルダーがこのモジュールをアクティブにするか | -| `style` | `'bold green'` | モジュールのスタイルです。 | -| `disabled` | `false` | `nodejs`モジュールを無効にします。 | -| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | +| オプション | デフォルト | 説明 | +| ------------------- | --------------------------------------------- | ----------------------------------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | module のフォーマットです。 | +| `version_format` | `'v${raw}'` | バージョンのフォーマット。 使用可能な変数は`raw`、`major`、`minor`と`patch`です。 | +| `symbol` | `' '` | A format string representing the symbol of Node.js. | +| `detect_extensions` | `['js', 'mjs', 'cjs', 'ts', 'mts', 'cts']` | どの拡張子がこのモジュールをアクティブにするか | +| `detect_files` | `['package.json', '.node-version', '.nvmrc']` | どのファイル名がこのモジュールをアクティブにするか | +| `detect_folders` | `['node_modules']` | どのフォルダーがこのモジュールをアクティブにするか | +| `style` | `'bold green'` | モジュールのスタイルです。 | +| `disabled` | `false` | `nodejs`モジュールを無効にします。 | +| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | ### 変数 @@ -3375,7 +3416,7 @@ The `pijul_channel` module shows the active channel of the repo in your current | `style` | `'bold purple'` | モジュールのスタイルです。 | | `format` | `'on [$symbol$channel]($style) '` | module のフォーマットです。 | | `truncation_length` | `2^63 - 1` | Truncates the pijul channel name to `N` graphemes | -| `truncation_symbol` | `'…'` | ブランチ名切り捨てられていることを示すための記号です。 | +| `truncation_symbol` | `'…'` | ブランチ名が切り捨てられていることを示すための記号です。 | | `disabled` | `true` | Disables the `pijul` module. | ## Pulumi @@ -3492,24 +3533,26 @@ The `python` module shows the currently installed version of [Python](https://ww - カレントディレクトリに`requirements.txt`ファイルが含まれている - カレントディレクトリに`setup.py`ファイルが含まれている - カレントディレクトリに`tox.ini`ファイルが含まれている +- 現在のディレクトリに`pixi.toml`ファイルが含まれている - カレントディレクトリに`.py`の拡張子のファイルが含まれている. +- The current directory contains a file with the `.ipynb` extension. - 仮想環境がアクティブである ### オプション -| オプション | デフォルト | 説明 | -| -------------------- | ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- | -| `format` | `'via [${symbol}${pyenv_prefix}(${version} )(\($virtualenv\) )]($style)'` | module のフォーマットです。 | -| `version_format` | `'v${raw}'` | バージョンのフォーマット。 使用可能な変数は`raw`、`major`、`minor`と`patch`です。 | -| `symbol` | `'🐍 '` | A format string representing the symbol of Python | -| `style` | `'yellow bold'` | モジュールのスタイルです。 | -| `pyenv_version_name` | `false` | pyenvを使用して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_extensions` | `['py']` | どの拡張子がこのモジュールをアクティブにするか | -| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini']` | どのファイル名がこのモジュールをアクティブにするか | -| `detect_folders` | `[]` | どのフォルダーがこのモジュールをアクティブにするか | -| `disabled` | `false` | `python`モジュールを無効にします。 | +| オプション | デフォルト | 説明 | +| -------------------- | ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | +| `format` | `'via [${symbol}${pyenv_prefix}(${version} )(\($virtualenv\) )]($style)'` | module のフォーマットです。 | +| `version_format` | `'v${raw}'` | バージョンのフォーマット。 使用可能な変数は`raw`、`major`、`minor`と`patch`です。 | +| `symbol` | `'🐍 '` | A format string representing the symbol of Python | +| `style` | `'yellow bold'` | モジュールのスタイルです。 | +| `pyenv_version_name` | `false` | pyenvを使用して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_extensions` | `['py', 'ipynb']` | どの拡張子がこのモジュールをアクティブにするか | +| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini', 'pixi.toml']` | どのファイル名がこのモジュールをアクティブにするか | +| `detect_folders` | `[]` | どのフォルダーがこのモジュールをアクティブにするか | +| `disabled` | `false` | `python`モジュールを無効にします。 | ::: tip @@ -4169,11 +4212,11 @@ disabled = false ### 変数 -| 変数 | 設定例 | 説明 | -| --------- | -------- | ----------------------- | -| version | `v5.2.4` | `swift` のバージョン | -| symbol | | オプション `symbol` の値をミラーする | -| style\* | | オプション `style` の値をミラーする | +| 変数 | 設定例 | 説明 | +| --------- | -------- | ------------------------ | +| version | `v5.2.4` | `swift` のバージョン | +| symbol | | オプション `symbol` の値をミラーします | +| style\* | | オプション `style` の値をミラーする | *: この変数は、スタイル文字列の一部としてのみ使用することができます。 @@ -4216,12 +4259,12 @@ Terraformのバージョンはデフォルトでは表示されません。多 ### 変数 -| 変数 | 設定例 | 説明 | -| --------- | ---------- | ------------------------ | -| version | `v0.12.24` | `terraform` のバージョン | -| workspace | `default` | 現在のTerraformワークスペース | -| symbol | | オプション `symbol` の値をミラーします | -| style\* | | オプション `style` の値をミラーする | +| 変数 | 設定例 | 説明 | +| --------- | ---------- | ----------------------- | +| version | `v0.12.24` | `terraform` のバージョン | +| workspace | `default` | 現在のTerraformワークスペース | +| symbol | | オプション `symbol` の値をミラーする | +| style\* | | オプション `style` の値をミラーします | *: この変数は、スタイル文字列の一部としてのみ使用することができます。 @@ -4271,10 +4314,10 @@ format = '[🏎💨 $workspace]($style) ' ### 変数 -| 変数 | 設定例 | 説明 | -| --------- | ---------- | ----------------------- | -| time | `13:08:10` | 現在時刻 | -| style\* | | オプション `style` の値をミラーします | +| 変数 | 設定例 | 説明 | +| --------- | ---------- | ---------------------- | +| time | `13:08:10` | 現在時刻 | +| style\* | | オプション `style` の値をミラーする | *: この変数は、スタイル文字列の一部としてのみ使用することができます。 @@ -4342,15 +4385,15 @@ SSH接続は、環境変数 `SSH_CONNECTION`、 `SSH_CLIENT`、および `SSH_TT ### オプション -| オプション | デフォルト | 説明 | -| ----------------- | ----------------------- | --------------------------------- | -| `style_root` | `'bold red'` | ユーザーが root/admin のときに使用されるスタイルです。 | -| `style_user` | `'bold yellow'` | 非rootユーザーに使用されるスタイルです。 | -| `detect_env_vars` | `[]` | このモジュールを活性化する環境変数。 | -| `format` | `'[$user]($style) in '` | module のフォーマットです。 | -| `show_always` | `false` | `username` モジュールを常に表示します。 | -| `disabled` | `false` | `username` モジュールを無効にします。 | -| `aliases` | `{}` | システムユーザー名を別のものに置換します。 | +| オプション | デフォルト | 説明 | +| ----------------- | ----------------------- | --------------------------------------------- | +| `style_root` | `'bold red'` | ユーザーが root/admin のときに使用されるスタイルです。 | +| `style_user` | `'bold yellow'` | 非rootユーザーに使用されるスタイルです。 | +| `detect_env_vars` | `[]` | このモジュールを活性化する環境変数。 | +| `format` | `'[$user]($style) in '` | module のフォーマットです。 | +| `show_always` | `false` | `username` モジュールを常に表示します。 | +| `disabled` | `false` | `username` モジュールを無効にします。 | +| `aliases` | `{}` | Translate system usernames to something else. | ### 変数 @@ -4361,7 +4404,7 @@ SSH接続は、環境変数 `SSH_CONNECTION`、 `SSH_CLIENT`、および `SSH_TT ### 設定例 -#### ホスト名を常に表示する +#### Always show the username ```toml # ~/.config/starship.toml @@ -4375,17 +4418,6 @@ show_always = true aliases = { "corpuser034g" = "matchai" } ``` -#### リモートのtmuxセッションでホスト名を非表示にする - -```toml -# ~/.config/starship.toml - -[hostname] -ssh_only = false -detect_env_vars = ['!TMUX', 'SSH_CONNECTION'] -disabled = false -``` - ## Vagrant `vagrant`モジュールは、現在インストールされている[Vagrant](https://www.vagrantup.com/)のバージョンを表示します。 デフォルトでは次の条件のいずれかが満たされると、モジュールが表示されます。 @@ -4570,32 +4602,32 @@ symbol = '⚡️ ' ### オプション -| オプション | デフォルト | 説明 | -| ------------------- | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | -| `command` | `''` | その出力が表示されるコマンド。 コマンドはシェルの標準入力に渡されます。 | -| `when` | `false` | ブール値 (クォートなしの `true` または `false`) かモジュールを表示する条件として使用されるシェルコマンド文字列。 文字列の場合、コマンドが終了ステータス `0` を返したときにモジュールが表示されます。 | -| `require_repo` | `false` | `true`の場合、モジュールは (Git の) リポジトリを含むパスにのみ表示されます。 他のオプションが指定されていない場合、このオプション単体では表示条件として不十分です。 | -| `shell` | | [この表の下を参照してください](#custom-command-shell) | -| `説明` | `''` | `starship explain` 実行の際に表示されるモジュールの説明。 | -| `unsafe_no_escape` | `false` | When set, command output is not escaped of characters that could be interpreted by the shell. | -| `detect_files` | `[]` | 表示条件として確認する作業ディレクトリ内のファイル名を指定します。 | -| `detect_folders` | `[]` | 表示条件として確認する作業ディレクトリ内のディレクトリ名を指定します。 | -| `detect_extensions` | `[]` | 表示条件として確認する作業ディレクトリ内のファイルの拡張子を指定します。 | -| `symbol` | `''` | コマンド出力の前に表示される記号です。 | -| `style` | `'bold green'` | モジュールのスタイルです。 | -| `format` | `'[$symbol($output )]($style)'` | module のフォーマットです。 | -| `disabled` | `false` | `custom` モジュールを無効にします。 | -| `os` | | モジュールが表示されるオペレーティングシステムの名前 (unix, linux, macos, windows, ...)。 [利用可能な値](https://doc.rust-lang.org/std/env/consts/constant.OS.html) を参照してください。 | -| `use_stdin` | | シェルに対してコマンドを標準出力を介して指定するか引数を介して指定するかの振る舞い上書きするおまけの boolen 値の設定です。 指定がない場合、(cmd, nushell などのようにシェルのサポート外でない限り) 標準入力が既定で使われます。 設定するとシェル固有の引数処理を無効にします。 | -| `ignore_timeout` | `false` | グローバルな `command_timeout` 設定を無視して、いくら時間がかかっても外部コマンド実行を継続します。 | +| オプション | デフォルト | 説明 | +| ------------------- | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `command` | `''` | その出力が表示されるコマンド。 コマンドはシェルの標準入力に渡されます。 | +| `when` | `false` | ブール値 (クォートなしの `true` または `false`) かモジュールを表示する条件として使用されるシェルコマンド文字列。 In case of a string, the module will be shown if the `shell` returns a `0` status code from executing it. | +| `require_repo` | `false` | `true`の場合、モジュールは (Git の) リポジトリを含むパスにのみ表示されます。 他のオプションが指定されていない場合、このオプション単体では表示条件として不十分です。 | +| `shell` | | [この表の下を参照してください](#custom-command-shell) | +| `説明` | `''` | `starship explain` 実行の際に表示されるモジュールの説明。 | +| `unsafe_no_escape` | `false` | When set, command output is not escaped of characters that could be interpreted by the shell. | +| `detect_files` | `[]` | 表示条件として確認する作業ディレクトリ内のファイル名を指定します。 | +| `detect_folders` | `[]` | 表示条件として確認する作業ディレクトリ内のディレクトリ名を指定します。 | +| `detect_extensions` | `[]` | 表示条件として確認する作業ディレクトリ内のファイルの拡張子を指定します。 | +| `symbol` | `''` | コマンド出力の前に表示される記号です。 | +| `style` | `'bold green'` | モジュールのスタイルです。 | +| `format` | `'[$symbol($output )]($style)'` | module のフォーマットです。 | +| `disabled` | `false` | `custom` モジュールを無効にします。 | +| `os` | | モジュールが表示されるオペレーティングシステムの名前 (unix, linux, macos, windows, ...)。 [利用可能な値](https://doc.rust-lang.org/std/env/consts/constant.OS.html) を参照してください。 | +| `use_stdin` | | シェルに対してコマンドを標準出力を介して指定するか引数を介して指定するかの振る舞い上書きするおまけの boolen 値の設定です。 指定がない場合、(cmd, nushell などのようにシェルのサポート外でない限り) 標準入力が既定で使われます。 設定するとシェル固有の引数処理を無効にします。 | +| `ignore_timeout` | `false` | グローバルな `command_timeout` 設定を無視して、いくら時間がかかっても外部コマンド実行を継続します。 | ### 変数 -| 変数 | 説明 | -| --------- | ------------------------- | -| output | `shell` におけるシェルコマンドの出力結果。 | -| symbol | オプション `symbol` の値をミラーする | -| style\* | オプション `style` の値をミラーする | +| 変数 | 説明 | +| --------- | -------------------------------------- | +| output | The output of `command` run in `shell` | +| symbol | オプション `symbol` の値をミラーする | +| style\* | オプション `style` の値をミラーする | *: この変数は、スタイル文字列の一部としてのみ使用することができます。 @@ -4608,7 +4640,7 @@ symbol = '⚡️ ' 未設定の場合は、最初に STARSHIP_SHELL に対して、そして Linux では 'sh' に、Windowsでは 'cmd / C' に対してフォールバックが試みられます。 -`command` は stdin に渡されます。 +The `command` (and `when`, if applicable) will be passed in on stdin. `shell` が指定されていないか要素の数が1つでかつ Starship が PowerShell が使われると判定した場合、次の引数が自動的に付加されます: `-NoProfile -Command -`。 `shell` が指定されていないか要素の数が1つでかつ Starship が Cmd が使われると判定した場合、引数 `/C` が自動的に付加され、`stdin` が `false` に設定されます。 `shell` が指定されていないか要素の数が1つでかつ Starship が Nushell が使われると判定した場合、引数 `-c` が自動的に付加され、`stdin` が `false` に設定されます。 この動作は、シェルに明示的に引数を渡すことで回避できます。例: diff --git a/docs/ja-JP/guide/README.md b/docs/ja-JP/guide/README.md index 42e7aa1c..5b1fe796 100644 --- a/docs/ja-JP/guide/README.md +++ b/docs/ja-JP/guide/README.md @@ -358,7 +358,7 @@ use ~/.cache/starship/init.nu

PowerShell -そして、Nushellの設定ファイルの最後に以下を追加してください（ `$PROFILE.config-path` を実行してください）: +PowerShellの設定ファイルの最後に以下を追加してください（ `$PROFILE` を実行してください）: ```powershell Invoke-Expression (&starship init powershell) @@ -431,7 +431,16 @@ Starshipのさらなるカスタマイズを目指すなら以下を参考にし [スポンサーになることで](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.


diff --git a/docs/ja-JP/presets/bracketed-segments.md b/docs/ja-JP/presets/bracketed-segments.md index 3e04952b..0edc6db8 100644 --- a/docs/ja-JP/presets/bracketed-segments.md +++ b/docs/ja-JP/presets/bracketed-segments.md @@ -12,6 +12,6 @@ starship preset bracketed-segments -o ~/.config/starship.toml ``` -[クリックしてTOMLをダウンロード](/presets/toml/bracketed-segments.toml) +[Click to download TOML](/presets/toml/bracketed-segments.toml){download} <<< @/public/presets/toml/bracketed-segments.toml diff --git a/docs/ja-JP/presets/gruvbox-rainbow.md b/docs/ja-JP/presets/gruvbox-rainbow.md index 6fd3ed0d..2d6a87ab 100644 --- a/docs/ja-JP/presets/gruvbox-rainbow.md +++ b/docs/ja-JP/presets/gruvbox-rainbow.md @@ -16,6 +16,6 @@ starship preset gruvbox-rainbow -o ~/.config/starship.toml ``` -[クリックしてTOMLをダウンロード](/presets/toml/gruvbox-rainbow.toml) +[Click to download TOML](/presets/toml/gruvbox-rainbow.toml){download} <<< @/public/presets/toml/gruvbox-rainbow.toml diff --git a/docs/ja-JP/presets/jetpack.md b/docs/ja-JP/presets/jetpack.md index 2263c6f6..a6cced67 100644 --- a/docs/ja-JP/presets/jetpack.md +++ b/docs/ja-JP/presets/jetpack.md @@ -19,6 +19,6 @@ starship preset jetpack -o ~/.config/starship.toml ``` -[クリックしてTOMLをダウンロード](/presets/toml/jetpack.toml) +[Click to download TOML](/presets/toml/jetpack.toml){download} <<< @/public/presets/toml/jetpack.toml diff --git a/docs/ja-JP/presets/nerd-font.md b/docs/ja-JP/presets/nerd-font.md index 43fdeec0..d60a7317 100644 --- a/docs/ja-JP/presets/nerd-font.md +++ b/docs/ja-JP/presets/nerd-font.md @@ -16,6 +16,6 @@ starship preset nerd-font-symbols -o ~/.config/starship.toml ``` -[クリックして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 diff --git a/docs/ja-JP/presets/no-empty-icons.md b/docs/ja-JP/presets/no-empty-icons.md index 99941c46..0bbe15f6 100644 --- a/docs/ja-JP/presets/no-empty-icons.md +++ b/docs/ja-JP/presets/no-empty-icons.md @@ -12,6 +12,6 @@ starship preset no-empty-icons -o ~/.config/starship.toml ``` -[クリックして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 diff --git a/docs/ja-JP/presets/no-nerd-font.md b/docs/ja-JP/presets/no-nerd-font.md index d7d3af6c..8b3299c0 100644 --- a/docs/ja-JP/presets/no-nerd-font.md +++ b/docs/ja-JP/presets/no-nerd-font.md @@ -14,6 +14,6 @@ starship preset no-nerd-font -o ~/.config/starship.toml ``` -[クリックして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 diff --git a/docs/ja-JP/presets/no-runtimes.md b/docs/ja-JP/presets/no-runtimes.md index 40ff1d8f..b1b535ae 100644 --- a/docs/ja-JP/presets/no-runtimes.md +++ b/docs/ja-JP/presets/no-runtimes.md @@ -12,6 +12,6 @@ starship preset no-runtime-versions -o ~/.config/starship.toml ``` -[クリックして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 diff --git a/docs/ja-JP/presets/pastel-powerline.md b/docs/ja-JP/presets/pastel-powerline.md index 5ecccc76..ffc0de9b 100644 --- a/docs/ja-JP/presets/pastel-powerline.md +++ b/docs/ja-JP/presets/pastel-powerline.md @@ -16,6 +16,6 @@ starship preset pastel-powerline -o ~/.config/starship.toml ``` -[クリックしてTOMLをダウンロード](/presets/toml/pastel-powerline.toml) +[Click to download TOML](/presets/toml/pastel-powerline.toml){download} <<< @/public/presets/toml/pastel-powerline.toml diff --git a/docs/ja-JP/presets/plain-text.md b/docs/ja-JP/presets/plain-text.md index dee59e86..6e0b593c 100644 --- a/docs/ja-JP/presets/plain-text.md +++ b/docs/ja-JP/presets/plain-text.md @@ -12,6 +12,6 @@ starship preset plain-text-symbols -o ~/.config/starship.toml ``` -[クリックして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 diff --git a/docs/ja-JP/presets/pure-preset.md b/docs/ja-JP/presets/pure-preset.md index 4294d2c7..ce7277b4 100644 --- a/docs/ja-JP/presets/pure-preset.md +++ b/docs/ja-JP/presets/pure-preset.md @@ -12,6 +12,6 @@ starship preset pure-preset -o ~/.config/starship.toml ``` -[クリックしてTOMLをダウンロード](/presets/toml/pure-preset.toml) +[Click to download TOML](/presets/toml/pure-preset.toml){download} <<< @/public/presets/toml/pure-preset.toml diff --git a/docs/ja-JP/presets/tokyo-night.md b/docs/ja-JP/presets/tokyo-night.md index f6235e4f..a95f4657 100644 --- a/docs/ja-JP/presets/tokyo-night.md +++ b/docs/ja-JP/presets/tokyo-night.md @@ -16,6 +16,6 @@ starship preset tokyo-night -o ~/.config/starship.toml ``` -[クリックしてTOMLをダウンロード](/presets/toml/tokyo-night.toml) +[Click to download TOML](/presets/toml/tokyo-night.toml){download} <<< @/public/presets/toml/tokyo-night.toml diff --git a/docs/ko-KR/config/README.md b/docs/ko-KR/config/README.md index dee323ea..60cd10f7 100644 --- a/docs/ko-KR/config/README.md +++ b/docs/ko-KR/config/README.md @@ -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,20 +1047,20 @@ 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` | -| `기호` | `'🦕 '` | 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_folders` | `[]` | Which folders should trigger this module. | -| `style` | `'green bold'` | The style for the module. | -| `disabled` | `false` | Disables the `deno` module. | +| Option | Default | Description | +| ------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | The format for the module. | +| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | +| `기호` | `'🦕 '` | A format string representing the symbol of Deno | +| `detect_extensions` | `[]` | Which extensions 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. | ### Variables @@ -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 @@ -1759,7 +1756,7 @@ The `git_commit` module shows the current commit hash and also the tag (if any) | `only_detached` | `true` | Only show git commit hash when in detached `HEAD` state | | `tag_disabled` | `true` | Disables showing tag info in `git_commit` module. | | `tag_max_candidates` | `0` | How many commits to consider for tag display. The default only allows exact matches. | -| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | +| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | | `disabled` | `false` | Disables the `git_commit` module. | ### Variables @@ -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. | +| `기호` | `'🔥 '` | 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 | 예시 | Description | +| --------- | -------- | ------------------------------------ | +| version | `24.4.0` | The version of `mojo` | +| 기호 | | 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. @@ -2934,17 +2975,17 @@ 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` | -| `기호` | `' '` | 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_folders` | `['node_modules']` | Which folders should trigger this module. | -| `style` | `'bold green'` | The style for the module. | -| `disabled` | `false` | Disables the `nodejs` module. | -| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | +| Option | Default | Description | +| ------------------- | --------------------------------------------- | ----------------------------------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | The format for the module. | +| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | +| `기호` | `' '` | A format string representing the symbol of Node.js. | +| `detect_extensions` | `['js', 'mjs', 'cjs', 'ts', 'mts', 'cts']` | Which extensions 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. | +| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | ### Variables @@ -3492,24 +3533,26 @@ 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` | -| `기호` | `'🐍 '` | A format string representing the symbol of Python | -| `style` | `'yellow bold'` | The style for the module. | -| `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_folders` | `[]` | Which folders should trigger this module | -| `disabled` | `false` | Disables the `python` module. | +| 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` | +| `기호` | `'🐍 '` | A format string representing the symbol of Python | +| `style` | `'yellow bold'` | The style for the module. | +| `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', '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. | ::: tip @@ -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` | `''` | 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` | | 기호 | 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. diff --git a/docs/ko-KR/guide/README.md b/docs/ko-KR/guide/README.md index cee1ccd2..12f931db 100644 --- a/docs/ko-KR/guide/README.md +++ b/docs/ko-KR/guide/README.md @@ -431,7 +431,16 @@ Starship 을 만드는 데에 영감이 되었던 이전 작업들도 살펴보 이 [프로젝트를 후원](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.


diff --git a/docs/ko-KR/presets/bracketed-segments.md b/docs/ko-KR/presets/bracketed-segments.md index 51b10c89..4f338887 100644 --- a/docs/ko-KR/presets/bracketed-segments.md +++ b/docs/ko-KR/presets/bracketed-segments.md @@ -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 ``` -[클릭하여 TOML 다운로드](/presets/toml/bracketed-segments.toml) +[Click to download TOML](/presets/toml/bracketed-segments.toml){download} <<< @/public/presets/toml/bracketed-segments.toml diff --git a/docs/ko-KR/presets/gruvbox-rainbow.md b/docs/ko-KR/presets/gruvbox-rainbow.md index e1b00f80..d7a6496c 100644 --- a/docs/ko-KR/presets/gruvbox-rainbow.md +++ b/docs/ko-KR/presets/gruvbox-rainbow.md @@ -16,6 +16,6 @@ starship preset gruvbox-rainbow -o ~/.config/starship.toml ``` -[클릭하여 TOML 다운로드](/presets/toml/gruvbox-rainbow.toml) +[Click to download TOML](/presets/toml/gruvbox-rainbow.toml){download} <<< @/public/presets/toml/gruvbox-rainbow.toml diff --git a/docs/ko-KR/presets/jetpack.md b/docs/ko-KR/presets/jetpack.md index 89da2fdb..e585c7dc 100644 --- a/docs/ko-KR/presets/jetpack.md +++ b/docs/ko-KR/presets/jetpack.md @@ -19,6 +19,6 @@ This is a pseudo minimalist preset inspired by the [geometry](https://github.com starship preset jetpack -o ~/.config/starship.toml ``` -[클릭하여 TOML 다운로드](/presets/toml/jetpack.toml) +[Click to download TOML](/presets/toml/jetpack.toml){download} <<< @/public/presets/toml/jetpack.toml diff --git a/docs/ko-KR/presets/nerd-font.md b/docs/ko-KR/presets/nerd-font.md index 41823093..62b1e356 100644 --- a/docs/ko-KR/presets/nerd-font.md +++ b/docs/ko-KR/presets/nerd-font.md @@ -16,6 +16,6 @@ starship preset nerd-font-symbols -o ~/.config/starship.toml ``` -[클릭하여 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 diff --git a/docs/ko-KR/presets/no-empty-icons.md b/docs/ko-KR/presets/no-empty-icons.md index 6ef76185..a857906d 100644 --- a/docs/ko-KR/presets/no-empty-icons.md +++ b/docs/ko-KR/presets/no-empty-icons.md @@ -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 ``` -[클릭하여 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 diff --git a/docs/ko-KR/presets/no-nerd-font.md b/docs/ko-KR/presets/no-nerd-font.md index 15af82c4..aba0b8c0 100644 --- a/docs/ko-KR/presets/no-nerd-font.md +++ b/docs/ko-KR/presets/no-nerd-font.md @@ -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 ``` -[클릭하여 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 diff --git a/docs/ko-KR/presets/no-runtimes.md b/docs/ko-KR/presets/no-runtimes.md index e692b986..35e1fae9 100644 --- a/docs/ko-KR/presets/no-runtimes.md +++ b/docs/ko-KR/presets/no-runtimes.md @@ -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 ``` -[클릭하여 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 diff --git a/docs/ko-KR/presets/pastel-powerline.md b/docs/ko-KR/presets/pastel-powerline.md index 4034c30d..5860e67e 100644 --- a/docs/ko-KR/presets/pastel-powerline.md +++ b/docs/ko-KR/presets/pastel-powerline.md @@ -16,6 +16,6 @@ This preset is inspired by [M365Princess](https://github.com/JanDeDobbeleer/oh-m starship preset pastel-powerline -o ~/.config/starship.toml ``` -[클릭하여 TOML 다운로드](/presets/toml/pastel-powerline.toml) +[Click to download TOML](/presets/toml/pastel-powerline.toml){download} <<< @/public/presets/toml/pastel-powerline.toml diff --git a/docs/ko-KR/presets/plain-text.md b/docs/ko-KR/presets/plain-text.md index 08cde790..0d5baf26 100644 --- a/docs/ko-KR/presets/plain-text.md +++ b/docs/ko-KR/presets/plain-text.md @@ -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 ``` -[클릭하여 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 diff --git a/docs/ko-KR/presets/pure-preset.md b/docs/ko-KR/presets/pure-preset.md index 123b67ce..ad40be9f 100644 --- a/docs/ko-KR/presets/pure-preset.md +++ b/docs/ko-KR/presets/pure-preset.md @@ -12,6 +12,6 @@ starship preset pure-preset -o ~/.config/starship.toml ``` -[클릭하여 TOML 다운로드](/presets/toml/pure-preset.toml) +[Click to download TOML](/presets/toml/pure-preset.toml){download} <<< @/public/presets/toml/pure-preset.toml diff --git a/docs/ko-KR/presets/tokyo-night.md b/docs/ko-KR/presets/tokyo-night.md index 963636ed..b52fdf48 100644 --- a/docs/ko-KR/presets/tokyo-night.md +++ b/docs/ko-KR/presets/tokyo-night.md @@ -16,6 +16,6 @@ starship preset tokyo-night -o ~/.config/starship.toml ``` -[클릭하여 TOML 다운로드](/presets/toml/tokyo-night.toml) +[Click to download TOML](/presets/toml/tokyo-night.toml){download} <<< @/public/presets/toml/tokyo-night.toml diff --git a/docs/nl-NL/config/README.md b/docs/nl-NL/config/README.md index 399853b5..b420d788 100644 --- a/docs/nl-NL/config/README.md +++ b/docs/nl-NL/config/README.md @@ -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,20 +1047,20 @@ 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_folders` | `[]` | Which folders should trigger this module. | -| `style` | `'green bold'` | The style for the module. | -| `disabled` | `false` | Disables the `deno` module. | +| 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', '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. | ### Variables @@ -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 @@ -1759,7 +1756,7 @@ The `git_commit` module shows the current commit hash and also the tag (if any) | `only_detached` | `true` | Only show git commit hash when in detached `HEAD` state | | `tag_disabled` | `true` | Disables showing tag info in `git_commit` module. | | `tag_max_candidates` | `0` | How many commits to consider for tag display. The default only allows exact matches. | -| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | +| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | | `disabled` | `false` | Disables the `git_commit` module. | ### Variables @@ -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. @@ -2934,17 +2975,17 @@ 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_folders` | `['node_modules']` | Which folders should trigger this module. | -| `style` | `'bold green'` | The style for the module. | -| `disabled` | `false` | Disables the `nodejs` module. | -| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | +| 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', '.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. | +| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | ### Variables @@ -3492,24 +3533,26 @@ 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 | -| `style` | `'yellow bold'` | The style for the module. | -| `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_folders` | `[]` | Which folders should trigger this module | -| `disabled` | `false` | Disables the `python` module. | +| 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 | +| `style` | `'yellow bold'` | The style for the module. | +| `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', '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. | ::: tip @@ -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` | `''` | 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. diff --git a/docs/nl-NL/guide/README.md b/docs/nl-NL/guide/README.md index a4ebad35..1a707667 100644 --- a/docs/nl-NL/guide/README.md +++ b/docs/nl-NL/guide/README.md @@ -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.


diff --git a/docs/nl-NL/presets/bracketed-segments.md b/docs/nl-NL/presets/bracketed-segments.md index 579d789e..35d956bf 100644 --- a/docs/nl-NL/presets/bracketed-segments.md +++ b/docs/nl-NL/presets/bracketed-segments.md @@ -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 diff --git a/docs/nl-NL/presets/gruvbox-rainbow.md b/docs/nl-NL/presets/gruvbox-rainbow.md index 674ccecb..03c6e14c 100644 --- a/docs/nl-NL/presets/gruvbox-rainbow.md +++ b/docs/nl-NL/presets/gruvbox-rainbow.md @@ -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 diff --git a/docs/nl-NL/presets/jetpack.md b/docs/nl-NL/presets/jetpack.md index c247b97f..8117adce 100644 --- a/docs/nl-NL/presets/jetpack.md +++ b/docs/nl-NL/presets/jetpack.md @@ -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 diff --git a/docs/nl-NL/presets/nerd-font.md b/docs/nl-NL/presets/nerd-font.md index 2da23ca4..f9977768 100644 --- a/docs/nl-NL/presets/nerd-font.md +++ b/docs/nl-NL/presets/nerd-font.md @@ -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 diff --git a/docs/nl-NL/presets/no-empty-icons.md b/docs/nl-NL/presets/no-empty-icons.md index 2d262cdd..03bb1f38 100644 --- a/docs/nl-NL/presets/no-empty-icons.md +++ b/docs/nl-NL/presets/no-empty-icons.md @@ -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 diff --git a/docs/nl-NL/presets/no-nerd-font.md b/docs/nl-NL/presets/no-nerd-font.md index c3fb3636..c1542a62 100644 --- a/docs/nl-NL/presets/no-nerd-font.md +++ b/docs/nl-NL/presets/no-nerd-font.md @@ -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 diff --git a/docs/nl-NL/presets/no-runtimes.md b/docs/nl-NL/presets/no-runtimes.md index 218d1ae1..5cf87ff1 100644 --- a/docs/nl-NL/presets/no-runtimes.md +++ b/docs/nl-NL/presets/no-runtimes.md @@ -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 diff --git a/docs/nl-NL/presets/pastel-powerline.md b/docs/nl-NL/presets/pastel-powerline.md index 07c42e7c..84a80f7f 100644 --- a/docs/nl-NL/presets/pastel-powerline.md +++ b/docs/nl-NL/presets/pastel-powerline.md @@ -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 diff --git a/docs/nl-NL/presets/plain-text.md b/docs/nl-NL/presets/plain-text.md index 2a075171..686b3e06 100644 --- a/docs/nl-NL/presets/plain-text.md +++ b/docs/nl-NL/presets/plain-text.md @@ -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 diff --git a/docs/nl-NL/presets/pure-preset.md b/docs/nl-NL/presets/pure-preset.md index 68b7b49d..b27468de 100644 --- a/docs/nl-NL/presets/pure-preset.md +++ b/docs/nl-NL/presets/pure-preset.md @@ -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 diff --git a/docs/nl-NL/presets/tokyo-night.md b/docs/nl-NL/presets/tokyo-night.md index f7c14aff..db5cec78 100644 --- a/docs/nl-NL/presets/tokyo-night.md +++ b/docs/nl-NL/presets/tokyo-night.md @@ -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 diff --git a/docs/no-NO/config/README.md b/docs/no-NO/config/README.md index 399853b5..b420d788 100644 --- a/docs/no-NO/config/README.md +++ b/docs/no-NO/config/README.md @@ -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,20 +1047,20 @@ 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_folders` | `[]` | Which folders should trigger this module. | -| `style` | `'green bold'` | The style for the module. | -| `disabled` | `false` | Disables the `deno` module. | +| 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', '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. | ### Variables @@ -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 @@ -1759,7 +1756,7 @@ The `git_commit` module shows the current commit hash and also the tag (if any) | `only_detached` | `true` | Only show git commit hash when in detached `HEAD` state | | `tag_disabled` | `true` | Disables showing tag info in `git_commit` module. | | `tag_max_candidates` | `0` | How many commits to consider for tag display. The default only allows exact matches. | -| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | +| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | | `disabled` | `false` | Disables the `git_commit` module. | ### Variables @@ -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. @@ -2934,17 +2975,17 @@ 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_folders` | `['node_modules']` | Which folders should trigger this module. | -| `style` | `'bold green'` | The style for the module. | -| `disabled` | `false` | Disables the `nodejs` module. | -| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | +| 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', '.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. | +| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | ### Variables @@ -3492,24 +3533,26 @@ 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 | -| `style` | `'yellow bold'` | The style for the module. | -| `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_folders` | `[]` | Which folders should trigger this module | -| `disabled` | `false` | Disables the `python` module. | +| 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 | +| `style` | `'yellow bold'` | The style for the module. | +| `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', '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. | ::: tip @@ -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` | `''` | 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. diff --git a/docs/no-NO/guide/README.md b/docs/no-NO/guide/README.md index d75e67c0..a4127e36 100644 --- a/docs/no-NO/guide/README.md +++ b/docs/no-NO/guide/README.md @@ -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.


diff --git a/docs/no-NO/presets/bracketed-segments.md b/docs/no-NO/presets/bracketed-segments.md index 579d789e..35d956bf 100644 --- a/docs/no-NO/presets/bracketed-segments.md +++ b/docs/no-NO/presets/bracketed-segments.md @@ -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 diff --git a/docs/no-NO/presets/gruvbox-rainbow.md b/docs/no-NO/presets/gruvbox-rainbow.md index 7fd686a6..c6629f38 100644 --- a/docs/no-NO/presets/gruvbox-rainbow.md +++ b/docs/no-NO/presets/gruvbox-rainbow.md @@ -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 diff --git a/docs/no-NO/presets/jetpack.md b/docs/no-NO/presets/jetpack.md index c247b97f..8117adce 100644 --- a/docs/no-NO/presets/jetpack.md +++ b/docs/no-NO/presets/jetpack.md @@ -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 diff --git a/docs/no-NO/presets/nerd-font.md b/docs/no-NO/presets/nerd-font.md index fadcb516..30d11a81 100644 --- a/docs/no-NO/presets/nerd-font.md +++ b/docs/no-NO/presets/nerd-font.md @@ -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 diff --git a/docs/no-NO/presets/no-empty-icons.md b/docs/no-NO/presets/no-empty-icons.md index 2d262cdd..03bb1f38 100644 --- a/docs/no-NO/presets/no-empty-icons.md +++ b/docs/no-NO/presets/no-empty-icons.md @@ -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 diff --git a/docs/no-NO/presets/no-nerd-font.md b/docs/no-NO/presets/no-nerd-font.md index c3fb3636..c1542a62 100644 --- a/docs/no-NO/presets/no-nerd-font.md +++ b/docs/no-NO/presets/no-nerd-font.md @@ -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 diff --git a/docs/no-NO/presets/no-runtimes.md b/docs/no-NO/presets/no-runtimes.md index 218d1ae1..5cf87ff1 100644 --- a/docs/no-NO/presets/no-runtimes.md +++ b/docs/no-NO/presets/no-runtimes.md @@ -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 diff --git a/docs/no-NO/presets/pastel-powerline.md b/docs/no-NO/presets/pastel-powerline.md index dfb1a515..e372f10e 100644 --- a/docs/no-NO/presets/pastel-powerline.md +++ b/docs/no-NO/presets/pastel-powerline.md @@ -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 diff --git a/docs/no-NO/presets/plain-text.md b/docs/no-NO/presets/plain-text.md index 2a075171..686b3e06 100644 --- a/docs/no-NO/presets/plain-text.md +++ b/docs/no-NO/presets/plain-text.md @@ -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 diff --git a/docs/no-NO/presets/pure-preset.md b/docs/no-NO/presets/pure-preset.md index 68b7b49d..b27468de 100644 --- a/docs/no-NO/presets/pure-preset.md +++ b/docs/no-NO/presets/pure-preset.md @@ -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 diff --git a/docs/no-NO/presets/tokyo-night.md b/docs/no-NO/presets/tokyo-night.md index 0522ecc2..e49a2168 100644 --- a/docs/no-NO/presets/tokyo-night.md +++ b/docs/no-NO/presets/tokyo-night.md @@ -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 diff --git a/docs/pl-PL/config/README.md b/docs/pl-PL/config/README.md index 6740093a..c0873076 100644 --- a/docs/pl-PL/config/README.md +++ b/docs/pl-PL/config/README.md @@ -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 ::: porada -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,20 +1047,20 @@ 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_folders` | `[]` | Which folders should trigger this module. | -| `style` | `'green bold'` | The style for the module. | -| `disabled` | `false` | Disables the `deno` module. | +| 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', '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. | ### Variables @@ -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 @@ -1759,7 +1756,7 @@ The `git_commit` module shows the current commit hash and also the tag (if any) | `only_detached` | `true` | Only show git commit hash when in detached `HEAD` state | | `tag_disabled` | `true` | Disables showing tag info in `git_commit` module. | | `tag_max_candidates` | `0` | How many commits to consider for tag display. The default only allows exact matches. | -| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | +| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | | `disabled` | `false` | Disables the `git_commit` module. | ### Variables @@ -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 + +| Zmienne | 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. @@ -2934,17 +2975,17 @@ 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_folders` | `['node_modules']` | Which folders should trigger this module. | -| `style` | `'bold green'` | The style for the module. | -| `disabled` | `false` | Disables the `nodejs` module. | -| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | +| 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', '.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. | +| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | ### Variables @@ -3492,24 +3533,26 @@ 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 | -| `style` | `'yellow bold'` | The style for the module. | -| `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_folders` | `[]` | Which folders should trigger this module | -| `disabled` | `false` | Disables the `python` module. | +| 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 | +| `style` | `'yellow bold'` | The style for the module. | +| `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', '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. | ::: porada @@ -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` | `''` | 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 | Zmienne | 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. diff --git a/docs/pl-PL/faq/README.md b/docs/pl-PL/faq/README.md index 63f32f75..f13cdf3f 100644 --- a/docs/pl-PL/faq/README.md +++ b/docs/pl-PL/faq/README.md @@ -46,7 +46,7 @@ For a list of all flags accepted by `starship prompt`, use the following command starship prompt --help ``` -The prompt will use as much context as is provided, but no flags are "required". +Wiersza użyje tyle kontekstu, ile dostaje, ale żadna flaga nie jest "wymagana". ## Jak uruchomić Starship na dystrybucjach systemu Linux ze starszymi wersjami glibc? diff --git a/docs/pl-PL/guide/README.md b/docs/pl-PL/guide/README.md index 49c8562a..e0816476 100644 --- a/docs/pl-PL/guide/README.md +++ b/docs/pl-PL/guide/README.md @@ -431,7 +431,16 @@ Zapoznaj się z wcześniejszymi projektami, które zainspirowały nas do stworze Wspomóż ten projekt [stając się sponsorem](https://github.com/sponsors/starship). Twoja nazwa bądź logo pojawi się tutaj wraz z linkiem do Twojej witryny. -- Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org) +## 🔒 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.


diff --git a/docs/pl-PL/presets/bracketed-segments.md b/docs/pl-PL/presets/bracketed-segments.md index 6bcef1f4..d0643028 100644 --- a/docs/pl-PL/presets/bracketed-segments.md +++ b/docs/pl-PL/presets/bracketed-segments.md @@ -12,6 +12,6 @@ Ta konfiguracja zmienia format wyświetlania wbudowanych modułów - zamiast dom starship preset bracketed-segments -o ~/.config/starship.toml ``` -[Kliknij, aby pobrać TOML](/presets/toml/bracketed-segments.toml) +[Click to download TOML](/presets/toml/bracketed-segments.toml){download} <<< @/public/presets/toml/bracketed-segments.toml diff --git a/docs/pl-PL/presets/gruvbox-rainbow.md b/docs/pl-PL/presets/gruvbox-rainbow.md index dd4ba2ce..5a56dc21 100644 --- a/docs/pl-PL/presets/gruvbox-rainbow.md +++ b/docs/pl-PL/presets/gruvbox-rainbow.md @@ -16,6 +16,6 @@ Zestaw mocno inspirowany przez [Pastel Powerline](./pastel-powerline.md) i [Toky starship preset gruvbox-rainbow -o ~/.config/starship.toml ``` -[Kliknij, aby pobrać TOML](/presets/toml/gruvbox-rainbow.toml) +[Click to download TOML](/presets/toml/gruvbox-rainbow.toml){download} <<< @/public/presets/toml/gruvbox-rainbow.toml diff --git a/docs/pl-PL/presets/jetpack.md b/docs/pl-PL/presets/jetpack.md index 73e032cb..1ff487d6 100644 --- a/docs/pl-PL/presets/jetpack.md +++ b/docs/pl-PL/presets/jetpack.md @@ -19,6 +19,6 @@ This is a pseudo minimalist preset inspired by the [geometry](https://github.com starship preset jetpack -o ~/.config/starship.toml ``` -[Kliknij, aby pobrać TOML](/presets/toml/jetpack.toml) +[Click to download TOML](/presets/toml/jetpack.toml){download} <<< @/public/presets/toml/jetpack.toml diff --git a/docs/pl-PL/presets/nerd-font.md b/docs/pl-PL/presets/nerd-font.md index 449311f2..e036eeae 100644 --- a/docs/pl-PL/presets/nerd-font.md +++ b/docs/pl-PL/presets/nerd-font.md @@ -16,6 +16,6 @@ Ten zestaw ustawień zmienia symbole dla każdego modułu tak, by wykorzystywał starship preset nerd-font-symbols -o ~/.config/starship.toml ``` -[Kliknij, aby pobrać 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 diff --git a/docs/pl-PL/presets/no-empty-icons.md b/docs/pl-PL/presets/no-empty-icons.md index 4f22fed7..48ffc8b7 100644 --- a/docs/pl-PL/presets/no-empty-icons.md +++ b/docs/pl-PL/presets/no-empty-icons.md @@ -12,6 +12,6 @@ Ikony zestawów narzędzi będą wyświetlane dla zidentyfikowanych plików zest starship preset no-empty-icons -o ~/.config/starship.toml ``` -[Kliknij, aby pobrać 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 diff --git a/docs/pl-PL/presets/no-nerd-font.md b/docs/pl-PL/presets/no-nerd-font.md index c047d2cd..083df915 100644 --- a/docs/pl-PL/presets/no-nerd-font.md +++ b/docs/pl-PL/presets/no-nerd-font.md @@ -14,6 +14,6 @@ Ten zestaw ustawień stanie się domyślny w przyszłych wersjach starship. starship preset no-nerd-font -o ~/.config/starship.toml ``` -[Kliknij, aby pobrać 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 diff --git a/docs/pl-PL/presets/no-runtimes.md b/docs/pl-PL/presets/no-runtimes.md index a6d2adeb..48e2dc7c 100644 --- a/docs/pl-PL/presets/no-runtimes.md +++ b/docs/pl-PL/presets/no-runtimes.md @@ -12,6 +12,6 @@ Ten zestaw ustawień ukrywa wersję środowiska wykonawczego. Jeśli pracujesz starship preset no-runtime-versions -o ~/.config/starship.toml ``` -[Kliknij, aby pobrać 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 diff --git a/docs/pl-PL/presets/pastel-powerline.md b/docs/pl-PL/presets/pastel-powerline.md index 652ff606..97242e14 100644 --- a/docs/pl-PL/presets/pastel-powerline.md +++ b/docs/pl-PL/presets/pastel-powerline.md @@ -16,6 +16,6 @@ Ten zestaw ustawień jest inspirowany [M365Princess](https://github.com/JanDeDo starship preset pastel-powerline -o ~/.config/starship.toml ``` -[Kliknij, aby pobrać TOML](/presets/toml/pastel-powerline.toml) +[Click to download TOML](/presets/toml/pastel-powerline.toml){download} <<< @/public/presets/toml/pastel-powerline.toml diff --git a/docs/pl-PL/presets/plain-text.md b/docs/pl-PL/presets/plain-text.md index cdb4fd9f..fba236c0 100644 --- a/docs/pl-PL/presets/plain-text.md +++ b/docs/pl-PL/presets/plain-text.md @@ -12,6 +12,6 @@ Ten zestaw ustawień zmienia symbole w zwykły tekst dla każdego modułu. Świe starship preset plain-text-symbols -o ~/.config/starship.toml ``` -[Kliknij, aby pobrać 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 diff --git a/docs/pl-PL/presets/pure-preset.md b/docs/pl-PL/presets/pure-preset.md index 53207ae5..81ba0642 100644 --- a/docs/pl-PL/presets/pure-preset.md +++ b/docs/pl-PL/presets/pure-preset.md @@ -12,6 +12,6 @@ Ten zestaw ustawień naśladuje wygląd i zachowanie [Pure](https://github.com/ starship preset pure-preset -o ~/.config/starship.toml ``` -[Kliknij, aby pobrać TOML](/presets/toml/pure-preset.toml) +[Click to download TOML](/presets/toml/pure-preset.toml){download} <<< @/public/presets/toml/pure-preset.toml diff --git a/docs/pl-PL/presets/tokyo-night.md b/docs/pl-PL/presets/tokyo-night.md index 7f513998..69b3d941 100644 --- a/docs/pl-PL/presets/tokyo-night.md +++ b/docs/pl-PL/presets/tokyo-night.md @@ -16,6 +16,6 @@ Ten zestaw ustawień jest inspirowany [tokyo-night-vscode-theme](https://github. starship preset tokyo-night -o ~/.config/starship.toml ``` -[Kliknij, aby pobrać TOML](/presets/toml/tokyo-night.toml) +[Click to download TOML](/presets/toml/tokyo-night.toml){download} <<< @/public/presets/toml/tokyo-night.toml diff --git a/docs/pt-BR/advanced-config/README.md b/docs/pt-BR/advanced-config/README.md index b9972edc..2a6f3af4 100644 --- a/docs/pt-BR/advanced-config/README.md +++ b/docs/pt-BR/advanced-config/README.md @@ -1,6 +1,6 @@ # Configuração avançada -Ainda que Starship seja um shell versátil, às vezes você precisará fazer algumas outras coisas além de editar o arquivo `starship.toml`. Esta página detalha algumas das técnicas de configuração avançadas utilizadas no starship. +Embora o Starship seja um shell versátil, às vezes é necessário fazer mais do que editar o `starship.toml` para que ele realize certas funções. Esta página detalha algumas das técnicas de configuração avançadas utilizadas no starship. ::: atenção @@ -82,19 +82,19 @@ enable_transience ## TransientPrompt e TransientRightPrompt em Bash -The [Ble.sh](https://github.com/akinomyoga/ble.sh) framework at v0.4 or higher allows you to replace the previous-printed prompt with custom strings. Isso é útil em casos onde nem sempre todas as informações do prompt são necessárias. Para habilitar isso, coloque em `~/.bashrc` `bleopt prompt_ps1_transient=`: +O framework [Ble.sh](https://github.com/akinomyoga/ble.sh) na versão 0.4 ou superior permite substituir o prompt exibido anteriormente por strings personalizadas. Isso é útil em casos onde todas as informações do prompt não são sempre necessárias. Para habilitar isso, coloque em `~/.bashrc` `bleopt prompt_ps1_transient=`: -O \ aqui é uma lista separada por dois pontos de `always`, `same-dir` e `trim`. When `prompt_ps1_final` is empty and the option `prompt_ps1_transient` has a non-empty \, the prompt specified by `PS1` is erased on leaving the current command line. If \ contains a field `trim`, only the last line of multiline `PS1` is preserved and the other lines are erased. Caso contrário, a linha de comando será redesenhada como se `PS1=` fosse especificado. When a field `same-dir` is contained in \ and the current working directory is different from the final directory of the previous command line, this option `prompt_ps1_transient` is ignored. +O \ aqui é uma lista separada por dois pontos de `always`, `same-dir` e `trim`. Quando `prompt_ps1_final` está vazio e a opção `prompt_ps1_transient` tem um \ não vazio , o prompt especificado por `PS1` é apagado ao sair da linha de comando atual. Se \ contiver um campo `trim`, apenas a última linha da multilinha `PS1` será preservada e as outras linhas serão apagadas. Caso contrário, a linha de comando será redesenhada como se `PS1=` fosse especificado. Quando um campo `same-dir` está contido em \ e o diretório atual é diferente do diretório final da linha de comando anterior, esta opção `prompt_ps1_transient` é ignorada. -Make the following changes to your `~/.blerc` (or in `~/.config/blesh/init.sh`) to customize what gets displayed on the left and on the right: +Faça as seguintes alterações no seu `~/.blerc` (ou em `~/.config/blesh/init.sh`) para personalizar o que é exibido à esquerda e à direita: -- Para personalizar o que o lado esquerdo do valor de entrada é substituído, configure a opção `prompt_ps1_final` Ble.sh. Por exemplo, para exibir o caractere da `Starship` aqui, você faria +- Para personalizar o que o lado esquerdo da entrada será substituído, configure a opção `prompt_ps1_final` Ble.sh. Por exemplo, para exibir o módulo `caractere` do Starship aqui, você deve fazer ```bash bleopt prompt_ps1_final='$(starship module character)' ``` -- Para personalizar o que o lado direito de entrada é substituído, configure a opção `prompt_rps1_final` Ble.sh. Por exemplo, para exibir o momento em que o último comando foi iniciado, você faria +- Para personalizar o que o lado direito de entrada será substituído, configure a opção `prompt_rps1_final` Ble.sh. Por exemplo, para exibir o momento em que o último comando foi iniciado, você deve fazer ```bash bleopt prompt_rps1_final='$(starship module time)' @@ -223,11 +223,11 @@ Invoke-Expression (&starship init powershell) Alguns shells suportam um prompt direito que é renderizado na mesma linha que a entrada. Starship pode definir o conteúdo do prompt correto usando a opção `right_format`. Qualquer módulo que pode ser usado no `format` também é compatível com `right_format`. A variável `$all` conterá apenas módulos não usado explicitamente em `format` ou `right_format`. -Nota: O prompt direito é uma única linha após o local de entrada. To right align modules above the input line in a multi-line prompt, see the [`fill` module](../config/#fill). +Nota: O prompt direito é uma única linha após o local de entrada. Para alinhar à direita os módulos acima da linha de entrada em um prompt de várias linhas, consulte o [módulo`fill`](../config/#fill). -`right_format` is currently supported for the following shells: elvish, fish, zsh, xonsh, cmd, nushell, bash. +`right_format` é atualmente suportado para os seguintes shells: elvish, fish, zsh, xonsh, cmd, nushell, bash. -Note: The [Ble.sh](https://github.com/akinomyoga/ble.sh) framework v0.4 or higher should be installed in order to use right prompt in bash. +Nota: O framework [Ble.sh](https://github.com/akinomyoga/ble.sh) na versão 0.4 ou superior deve estar instalado para utilizar o prompt direito no bash. ### Exemplo @@ -266,7 +266,7 @@ Nota: os prompts de continuação estão disponíveis apenas nos seguintes shell ```toml # ~/.config/starship.toml -# A continuation prompt that displays two filled-in arrows +# Um prompt de continuação que exibe duas setas preenchidas continuation_prompt = '▶▶ ' ``` @@ -287,7 +287,7 @@ As strings de estilo são uma lista de palavras, separadas por espaços em branc - `` - `none` -onde `` é um especificador de cor (discutido abaixo). `fg:` e `` atualmente fazem a mesma coisa, embora isso possa mudar no futuro. `` can also be set to `prev_fg` or `prev_bg` which evaluates to the previous item's foreground or background color respectively if available or `none` otherwise. `inverted` troca as cores de fundo e primeiro plano. A ordem das palavras na string não importa. +onde `` é um especificador de cor (discutido abaixo). `fg:` e `` atualmente fazem a mesma coisa, embora isso possa mudar no futuro. `` também pode ser configurado para `prev_fg` ou `prev_bg`, que avaliam a cor de primeiro plano ou de fundo do item anterior, respectivamente, se disponível, ou `none` caso contrário. `inverted` troca as cores de fundo e primeiro plano. A ordem das palavras na string não importa. O token `none` substitui todos os outros tokens em uma string se não fizer parte de um especificador `bg:`, de modo que, ex., `fg:red none fg:blue` ainda criará uma string sem estilo. `bg:none` define o plano de fundo para a cor padrão para que `fg:red bg:none` seja equivalente a `red` ou `fg:red` e `bg:green fg:red bg:none` também é equivalente a `fg:red` ou `red`. Pode ser um erro usar `none` em conjunto com outros tokens no futuro. diff --git a/docs/pt-BR/config/README.md b/docs/pt-BR/config/README.md index 2b2cbb74..4efc0f2b 100644 --- a/docs/pt-BR/config/README.md +++ b/docs/pt-BR/config/README.md @@ -158,7 +158,7 @@ Por exemplo: #### Estilo dos textos -A maioria dos módulos no starship permite que você configure seus estilos de exibição. Isso é feito com uma entrada (normalmente chamada de `estilo`) que é uma string especificando a configuração. Aqui estão alguns exemplos de strings de estilo junto com o que elas fazem. For details on the full syntax, consult the [advanced config guide](../advanced-config/). +A maioria dos módulos no starship permite que você configure seus estilos de exibição. Isso é feito com uma entrada (normalmente chamada de `estilo`) que é uma string especificando a configuração. Aqui estão alguns exemplos de strings de estilo junto com o que elas fazem. Para detalhes da sintaxe completa, consulte o [ guia de configurações avançadas ](../advanced-config/). - `"fg:green bg:blue"` define o texto para verde e o fundo azul - `"bg:blue fg:bright-green"` define o texto para verde brilhante e o fundo azul @@ -553,10 +553,7 @@ discharging_symbol = '💦 ' ## Buf -O módulo `buf` mostra a versão instalada do [Buf](https://buf.build). Por padrão, o módulo é mostrado se todas as seguintes condições forem atendidas: - -- A CLI [`buf`](https://github.com/bufbuild/buf) está instalada. -- O atual diretório contém um [`buf.yaml`](https://docs.buf.build/configuration/v1/buf-yaml), [`buf.gen.yaml`](https://docs.buf.build/configuration/v1/buf-gen-yaml) ou arquivo de configuração [`buf.work.yaml`](https://docs.buf.build/configuration/v1/buf-work-yaml). +O módulo `buf` mostra a versão instalada do [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. ### Opções @@ -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 @@ O módulo `conda` exibe o ambiente atual do [Conda](https://docs.conda.io/en/lat ::: tip -Isso não suprime o modificador de prompt do conda, você pode executar `conda config --set changeps1 False`. +Isso não suprime o modificador de prompt do conda, você pode executar `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,20 +1047,20 @@ format = 'via [🔰 $version](bold red) ' O módulo `deno` exibe a versão instalada atual do [Deno](https://deno.land/). Por padrão o módulo vai exibir se uma das condições a seguir for atendida: -- O diretório atual tenha um arquivo `deno.json`, `deno.jsonc`, `mod.ts`, `mod.js`, `deps.ts` or `deps.js` +- The current directory contains a `deno.json`, `deno.jsonc`, `deno.lock`, `mod.ts`, `mod.js`, `deps.ts` or `deps.js` file ### Opções -| Opções | Padrão | Descrição | -| ------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | -| `format` | `'via [$symbol($version )]($style)'` | O formato do módulo. | -| `version_format` | `'v${raw}'` | O formato da versão. As variáveis disponíveis são `raw`, `major`, `minor`, & `patch` | -| `symbol` | `'🦕 '` | Um formato de string que representa o simbolo do Deno | -| `detect_extensions` | `[]` | Quais extensões devem ativar este módulo. | -| `detect_files` | `['deno.json', 'deno.jsonc', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | Quais nomes de arquivos devem ativar este módulo. | -| `detect_folders` | `[]` | Quais pastas devem ativar este módulo. | -| `style` | `'green bold'` | O estilo do módulo. | -| `disabled` | `false` | Desabilita o módulo `deno`. | +| Opções | Padrão | Descrição | +| ------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------ | +| `format` | `'via [$symbol($version )]($style)'` | O formato do módulo. | +| `version_format` | `'v${raw}'` | O formato da versão. As variáveis disponíveis são `raw`, `major`, `minor`, & `patch` | +| `symbol` | `'🦕 '` | Um formato de string que representa o simbolo do Deno | +| `detect_extensions` | `[]` | Quais extensões devem ativar este módulo. | +| `detect_files` | `['deno.json', 'deno.jsonc', 'deno.lock', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | Quais nomes de arquivos devem ativar este módulo. | +| `detect_folders` | `[]` | Quais pastas devem ativar este módulo. | +| `style` | `'green bold'` | O estilo do módulo. | +| `disabled` | `false` | Desabilita o módulo `deno`. | ### Variáveis @@ -1117,7 +1114,7 @@ Por exemplo, dado `~/Dev/Nix/nixpkgs/pkgs` onde `nixpkgs` é o repositório raiz | `fish_style_pwd_dir_length` | `0` | O número de caracteres para usar quando aplicado no path logico do fish shell pwd. | | `use_logical_path` | `true` | Se `true` exibe um caminho lógico originado do shell via `PWD` ou`--logical-path`. Se `false` em vez disso, exibe o caminho do filesystem com os symlinks resolvidos. | -`substitutions` aceita você definir substituições arbitrarias para strings literais que ocorra no path, por exemplo prefixos de rede longos ou diretórios de desenvolvimento (ex:. Java). Note isto irá desabilita o estilo PWD do 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. Note isto irá desabilita o estilo PWD do fish. ```toml [directory.substitutions] @@ -1207,7 +1204,7 @@ disabled = false ## Docker Context -O módulo `docker_context` exibe o [Docker context](https://docs.docker.com/engine/context/working-with-contexts/) ativo atualmente se não estiver definido como `default` ou se as variáveis de ambiente `DOCKER_MACHINE_NAME`, `DOCKER_HOST` ou `DOCKER_CONTEXT` estiverem definidas (iram sobrescrever o contexto atual). +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). ### Opções @@ -1759,7 +1756,7 @@ O módulo `git_commit` exibe o hash do comiit atual e também a tag (se existir) | `only_detached` | `true` | Apenas exibe o git commit hash quando o estado for detached `HEAD` | | `tag_disabled` | `true` | Desabilita a exibição da informação da tag no módulo `git_commit`. | | `tag_max_candidates` | `0` | How many commits to consider for tag display. The default only allows exact matches. | -| `tag_symbol` | `' 🏷 '` | Simbolo da tag prefixado na informação a ser exibida | +| `tag_symbol` | `' 🏷 '` | Simbolo da tag prefixado na informação a ser exibida | | `disabled` | `false` | Desabilita o módulo `git_commit`. | ### Variáveis @@ -1890,7 +1887,7 @@ O módulo Git Status é muito lento nos diretórios do Windows (por exemplo, em | `staged` | `'+'` | O formato do `staged` | | `renamed` | `'»'` | O formato do `renamed` | | `deleted` | `'✘'` | O formato do `deleted` | -| `typechanged` | `""` | The format of `typechange` | +| `typechanged` | `""` | The format of `typechanged` | | `style` | `'bold red'` | O estilo do módulo. | | `ignore_submodules` | `false` | Ignora as alterações de submódulos. | | `disabled` | `false` | Desabilita o módulo `git_status`. | @@ -1911,7 +1908,7 @@ As variáveis a seguir podem ser usadas no `format`: | `staged` | Exibe `staged` quando um arquivo novo for adicionado na área de staging. | | `renamed` | Exibe `renamed` quando um arquivo renomeado for adicionado na área de staging. | | `deleted` | Exibe `deleted` quando um arquivo deletado for adicionado na área de staging. | -| `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\* | Espelha o valor da opção `style` | *: Esta variável só pode ser usada como parte de uma string de estilo @@ -2257,6 +2254,7 @@ O módulo `hostname` exibe o nome do hostname. | `format` | `'[$ssh_symbol$hostname]($style) in '` | O formato do módulo. | | `style` | `'bold dimmed green'` | O estilo do módulo. | | `disabled` | `false` | Desabilita o módulo `hostname`. | +| `aliases` | `{}` | Translate system hostnames to something else. If `trim_at` is specified, only the first part will be matched and replaced. | ### Variáveis @@ -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 O módulo `java` exibe o versão atual instalada do [Java](https://www.oracle.com/java/). Por padrão o módulo vai exibir se uma das condições a seguir for atendida: @@ -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 + +### Opções + +| Opções | Padrão | Descrição | +| ------------------- | ------------------------------------- | ------------------------------------------------------ | +| `format` | `'with [$symbol($version )]($style)'` | O formato do módulo. | +| `symbol` | `'🔥 '` | The symbol used before displaying the version of Mojo. | +| `style` | `'bold 208'` | O estilo do módulo. | +| `disabled` | `false` | Disables the `mojo` module. | +| `detect_extensions` | `['mojo', '🔥']` | Quais extensões devem ativar este módulo. | +| `detect_files` | `[]` | Quais nomes de arquivos devem ativar este módulo. | +| `detect_folders` | `[]` | Quais pastas devem ativar este módulo. | + +### Variáveis + +| Variável | Exemplo | Descrição | +| --------- | -------- | --------------------------------- | +| version | `24.4.0` | The version of `mojo` | +| symbol | | Espelha o valor da opção `symbol` | +| style\* | | Espelha o valor da opção `style` | + +*: Esta variável só pode ser usada como parte de uma string de estilo + +### Exemplo + +```toml +# ~/.config/starship.toml + +[mojo] +format = 'via [mojo ($version )($hash )]($style)' +``` + ## NATS The `nats` module shows the name of the current [NATS](https://nats.io) context. @@ -2934,17 +2975,17 @@ O módulo `nodejs` exibe a versão atual instalada do [Node.js](https://nodejs.o ### Opções -| Opções | Padrão | Descrição | -| ------------------- | ------------------------------------------ | -------------------------------------------------------------------------------------------------------- | -| `format` | `'via [$symbol($version )]($style)'` | O formato do módulo. | -| `version_format` | `'v${raw}'` | A versão formatada. As variáveis disponíveis são `raw`, `major`, `minor`, & `patch` | -| `symbol` | `' '` | Uma string que representa o simbolo do Node.js. | -| `detect_extensions` | `['js', 'mjs', 'cjs', 'ts', 'mts', 'cts']` | Quais extensões devem ativar este módulo. | -| `detect_files` | `['package.json', '.node-version']` | Quais nomes de arquivos devem ativar este módulo. | -| `detect_folders` | `['node_modules']` | Quais pastas devem ativar este módulo. | -| `style` | `'bold green'` | O estilo do módulo. | -| `disabled` | `false` | Desabilita o módulo `nodejs`. | -| `not_capable_style` | `'bold red'` | O estilo para o módulo quando a propriedade engine no package.json não coincide com a versão do Node.js. | +| Opções | Padrão | Descrição | +| ------------------- | --------------------------------------------- | -------------------------------------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | O formato do módulo. | +| `version_format` | `'v${raw}'` | A versão formatada. As variáveis disponíveis são `raw`, `major`, `minor`, & `patch` | +| `symbol` | `' '` | Uma string que representa o simbolo do Node.js. | +| `detect_extensions` | `['js', 'mjs', 'cjs', 'ts', 'mts', 'cts']` | Quais extensões devem ativar este módulo. | +| `detect_files` | `['package.json', '.node-version', '.nvmrc']` | Quais nomes de arquivos devem ativar este módulo. | +| `detect_folders` | `['node_modules']` | Quais pastas devem ativar este módulo. | +| `style` | `'bold green'` | O estilo do módulo. | +| `disabled` | `false` | Desabilita o módulo `nodejs`. | +| `not_capable_style` | `'bold red'` | O estilo para o módulo quando a propriedade engine no package.json não coincide com a versão do Node.js. | ### Variáveis @@ -3492,24 +3533,26 @@ Por padrão, o módulo será exibido se qualquer das seguintes condições for a - O diretório atual conter um arquivo `requirements.txt` - O diretório atual conter um arquivo `setup.py` - O diretório atual conter um arquivo `tox.ini` +- O diretório atual conter um arquivo `pixi.toml` - O diretório atual tenha um arquivo com a extensão `.py`. +- The current directory contains a file with the `.ipynb` extension. - Um ambiente virtual está atualmente ativo ### Opções -| Opções | Padrão | Descrição | -| -------------------- | ------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------- | -| `format` | `'via [${symbol}${pyenv_prefix}(${version} )(\($virtualenv\) )]($style)'` | O formato do módulo. | -| `version_format` | `'v${raw}'` | A versão formatada. As variáveis disponíveis são `raw`, `major`, `minor`, & `patch` | -| `symbol` | `'🐍 '` | Uma string que representa o simbolo do Python | -| `style` | `'yellow bold'` | O estilo do módulo. | -| `pyenv_version_name` | `false` | Usa pyenv para pegar a versão do Python | -| `pyenv_prefix` | `'pyenv'` | Prefixo antes da versão do pyenv, apenas usado se pyenv for usado | -| `python_binary` | `['python', 'python3', 'python2']` | Configura o binário python que o Starship vai executar para obter a versão. | -| `detect_extensions` | `['py']` | Quais extensões devem acionar este módulo | -| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini']` | [] | -| `detect_folders` | `[]` | Quais pastas devem ativar este módulo | -| `disabled` | `false` | Desabilita o módulo `python`. | +| Opções | Padrão | Descrição | +| -------------------- | ------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | +| `format` | `'via [${symbol}${pyenv_prefix}(${version} )(\($virtualenv\) )]($style)'` | O formato do módulo. | +| `version_format` | `'v${raw}'` | A versão formatada. As variáveis disponíveis são `raw`, `major`, `minor`, & `patch` | +| `symbol` | `'🐍 '` | Uma string que representa o simbolo do Python | +| `style` | `'yellow bold'` | O estilo do módulo. | +| `pyenv_version_name` | `false` | Usa pyenv para pegar a versão do Python | +| `pyenv_prefix` | `'pyenv'` | Prefixo antes da versão do pyenv, apenas usado se pyenv for usado | +| `python_binary` | `['python', 'python3', 'python2']` | Configura o binário python que o Starship vai executar para obter a versão. | +| `detect_extensions` | `['py', 'ipynb']` | Quais extensões devem acionar este módulo | +| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini', 'pixi.toml']` | [] | +| `detect_folders` | `[]` | Quais pastas devem ativar este módulo | +| `disabled` | `false` | Desabilita o módulo `python`. | ::: tip @@ -4350,7 +4393,7 @@ Conexões SSH são detectadas checando as variáveis de ambiente `SSH_CONNECTION | `format` | `'[$user]($style) in '` | O formato do módulo. | | `show_always` | `false` | Sempre exibe o módulo `username`. | | `disabled` | `false` | Desabilita o módulo `username`. | -| `aliases` | `{}` | Translate system usernames to something else | +| `aliases` | `{}` | Translate system usernames to something else. | ### Variáveis @@ -4361,7 +4404,7 @@ Conexões SSH são detectadas checando as variáveis de ambiente `SSH_CONNECTION ### Exemplo -#### 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 O módulo `vagrant` exibe a versão atual instalada do [Vagrant](https://www.vagrantup.com/). Por padrão o módulo vai exibir se uma das condições a seguir for atendida: @@ -4573,7 +4605,7 @@ Strings de formatação também podem conter sequencias de prompt especificas de | Opções | Padrão | Descrição | | ------------------- | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `command` | `''` | O comando cuja a saída deve ser exibida. O comando será passado no stdin para o shell. | -| `when` | `false` | Ou um valor booleano (`true` ou `false`, sem aspas) ou um comando shell de string usado como condição para mostrar o módulo. No caso de uma string, o módulo será mostrado se o comando retornar um código de status `0`. | +| `when` | `false` | Ou um valor booleano (`true` ou `false`, sem aspas) ou um comando shell de string usado como condição para mostrar o 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` | Se `true`, o módulo será exibido apenas em caminhos que contenham um repositório (git). Esta opção, por si só, não é uma condição de exibição suficiente na ausência de outras opções. | | `shell` | | [Veja abaixo](#custom-command-shell) | | `description` | `''` | A descrição do módulo, isto será exibido quando executar `starship explain`. | @@ -4591,11 +4623,11 @@ Strings de formatação também podem conter sequencias de prompt especificas de ### Variáveis -| Variável | Descrição | -| --------- | --------------------------------- | -| output | A saída do comando no `shell` | -| symbol | Espelha o valor da opção `symbol` | -| style\* | Espelha o valor da opção `style` | +| Variável | Descrição | +| --------- | -------------------------------------- | +| output | The output of `command` run in `shell` | +| symbol | Espelha o valor da opção `symbol` | +| style\* | Espelha o valor da opção `style` | *: Esta variável só pode ser usada como parte de uma string de estilo @@ -4608,7 +4640,7 @@ Strings de formatação também podem conter sequencias de prompt especificas de If unset, it will fallback to STARSHIP_SHELL and then to 'sh' on Linux, and 'cmd /C' on Windows. -O `command` será passado no stdin. +The `command` (and `when`, if applicable) will be passed in on stdin. Se o `shell` não for dado ou apenas conter um elemento e o Starship detectar PowerShell ele será usado, os seguintes argumentos serão automaticamente adicionados: `-NoProfile -Command -`. Se `shell` não for fornecido ou contiver apenas um elemento e o Starship detectar que o Cmd será usado, o seguinte argumento será adicionado automaticamente: `/C` e `stdin` serão definidos como `false`. Se `shell` não for fornecido ou contiver apenas um elemento e o Starship detectar que o Nushell será usado, os seguintes argumentos serão adicionados automaticamente: `-c` e `stdin` serão definidos como `false`. Este comportamento pode ser evitado passando explicitamente argumento para o shell, ex. diff --git a/docs/pt-BR/guide/README.md b/docs/pt-BR/guide/README.md index ca89927d..b25e6d2f 100644 --- a/docs/pt-BR/guide/README.md +++ b/docs/pt-BR/guide/README.md @@ -35,7 +35,7 @@ Stand With Ukraine

@@ -431,7 +431,16 @@ Por favor, confira esses trabalhos anteriores que ajudaram a inspirar a criaçã Apoie este projeto [tornando-se um patrocinador](https://github.com/sponsors/starship). O seu nome ou logotipo aparecerá aqui com um link para o seu site. -- Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org) +## 🔒 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.


diff --git a/docs/pt-BR/installing/README.md b/docs/pt-BR/installing/README.md index b288853b..e1215274 100644 --- a/docs/pt-BR/installing/README.md +++ b/docs/pt-BR/installing/README.md @@ -2,12 +2,12 @@ Para instalar o starship, você precisa de duas coisas: -1. O binário do **Starship** em seu computador -1. Altere seu shell para usar o binário do starship como seu prompt alterando os scripts init +1. Colocar o binário do **starship** no seu computador +1. Dizer ao seu shell para usar o binário do starship como seu prompt alterando os scripts init -For most users, the instructions on [the main page](../guide/#🚀-installation) will work great. No entanto para algumas plataformas mais especificas, instruções diferentes são necessárias. +Para a maioria dos usuários, as instruções na [página principal](../guide/#🚀-installation) funcionarão muito bem. Entretanto, para algumas plataformas mais especializadas, diferentes instruções são necessárias. -Existem tantas plataformas que elas não cabem no arquivo README.md principal, então aqui estão algumas instruções de instalação para outras plataformas da comunidade. A sua não está aqui? Por favor, adicione-o aqui se você descobrir! +Existem tantas plataformas que elas não caberiam no arquivo README.md principal, então aqui estão algumas instruções de instalação para outras plataformas, fornecidas pela comunidade. A sua não está aqui? Por favor, adicione-a aqui se você descobrir! ## [Chocolatey](https://chocolatey.org) diff --git a/docs/pt-BR/presets/bracketed-segments.md b/docs/pt-BR/presets/bracketed-segments.md index 89d14731..e5934f55 100644 --- a/docs/pt-BR/presets/bracketed-segments.md +++ b/docs/pt-BR/presets/bracketed-segments.md @@ -12,6 +12,6 @@ Está personalização altera o formato de todos os módulos integrados para que starship preset bracketed-segments -o ~/.config/starship.toml ``` -[Clique para baixar o TOML](/presets/toml/bracketed-segments.toml) +[Click to download TOML](/presets/toml/bracketed-segments.toml){download} <<< @/public/presets/toml/bracketed-segments.toml diff --git a/docs/pt-BR/presets/gruvbox-rainbow.md b/docs/pt-BR/presets/gruvbox-rainbow.md index f30cbc2a..87fdd014 100644 --- a/docs/pt-BR/presets/gruvbox-rainbow.md +++ b/docs/pt-BR/presets/gruvbox-rainbow.md @@ -16,6 +16,6 @@ This preset is heavily inspired by [Pastel Powerline](./pastel-powerline.md), an starship preset gruvbox-rainbow -o ~/.config/starship.toml ``` -[Clique para baixar o TOML](/presets/toml/gruvbox-rainbow.toml) +[Click to download TOML](/presets/toml/gruvbox-rainbow.toml){download} <<< @/public/presets/toml/gruvbox-rainbow.toml diff --git a/docs/pt-BR/presets/jetpack.md b/docs/pt-BR/presets/jetpack.md index 9496e9ad..884be353 100644 --- a/docs/pt-BR/presets/jetpack.md +++ b/docs/pt-BR/presets/jetpack.md @@ -19,6 +19,6 @@ This is a pseudo minimalist preset inspired by the [geometry](https://github.com starship preset jetpack -o ~/.config/starship.toml ``` -[Clique para baixar o TOML](/presets/toml/jetpack.toml) +[Click to download TOML](/presets/toml/jetpack.toml){download} <<< @/public/presets/toml/jetpack.toml diff --git a/docs/pt-BR/presets/nerd-font.md b/docs/pt-BR/presets/nerd-font.md index 6e8781bd..8d29d238 100644 --- a/docs/pt-BR/presets/nerd-font.md +++ b/docs/pt-BR/presets/nerd-font.md @@ -16,6 +16,6 @@ Essa personalização altera os símbolos para cada módulo usar Nerd Font. starship preset nerd-font-symbols -o ~/.config/starship.toml ``` -[Clique para baixar o 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 diff --git a/docs/pt-BR/presets/no-empty-icons.md b/docs/pt-BR/presets/no-empty-icons.md index 137e7ccb..28adf5b1 100644 --- a/docs/pt-BR/presets/no-empty-icons.md +++ b/docs/pt-BR/presets/no-empty-icons.md @@ -12,6 +12,6 @@ Se os arquivos de toolset forem encontrados o ícone do toolset será exibido. S starship preset no-empty-icons -o ~/.config/starship.toml ``` -[Clique para baixar o 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 diff --git a/docs/pt-BR/presets/no-nerd-font.md b/docs/pt-BR/presets/no-nerd-font.md index a8d01d64..228c5501 100644 --- a/docs/pt-BR/presets/no-nerd-font.md +++ b/docs/pt-BR/presets/no-nerd-font.md @@ -14,6 +14,6 @@ Esta predefinição será padrão em uma futrura release do starship. starship preset no-nerd-font -o ~/.config/starship.toml ``` -[Clique para baixar o 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 diff --git a/docs/pt-BR/presets/no-runtimes.md b/docs/pt-BR/presets/no-runtimes.md index e556eb61..79fff80b 100644 --- a/docs/pt-BR/presets/no-runtimes.md +++ b/docs/pt-BR/presets/no-runtimes.md @@ -12,6 +12,6 @@ Esta predefinição oculta a versão do runtime da linguagem. Se você trabalha starship preset no-runtime-versions -o ~/.config/starship.toml ``` -[Clique para baixar o 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 diff --git a/docs/pt-BR/presets/pastel-powerline.md b/docs/pt-BR/presets/pastel-powerline.md index 8ce14f37..0404d245 100644 --- a/docs/pt-BR/presets/pastel-powerline.md +++ b/docs/pt-BR/presets/pastel-powerline.md @@ -16,6 +16,6 @@ Esta personalização é inspirada em [M365Princess](https://github.com/JanDeDob starship preset pastel-powerline -o ~/.config/starship.toml ``` -[Clique para baixar o TOML](/presets/toml/pastel-powerline.toml) +[Click to download TOML](/presets/toml/pastel-powerline.toml){download} <<< @/public/presets/toml/pastel-powerline.toml diff --git a/docs/pt-BR/presets/plain-text.md b/docs/pt-BR/presets/plain-text.md index 66497101..cc89ebb8 100644 --- a/docs/pt-BR/presets/plain-text.md +++ b/docs/pt-BR/presets/plain-text.md @@ -12,6 +12,6 @@ Essa personalização converte os símbolos para cada módulo em texto simples. starship preset plain-text-symbols -o ~/.config/starship.toml ``` -[Clique para baixar o 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 diff --git a/docs/pt-BR/presets/pure-preset.md b/docs/pt-BR/presets/pure-preset.md index c78cefcc..1293d811 100644 --- a/docs/pt-BR/presets/pure-preset.md +++ b/docs/pt-BR/presets/pure-preset.md @@ -12,6 +12,6 @@ Essa personalização simula a aparência e o comportamento do [Pure](https://gi starship preset pure-preset -o ~/.config/starship.toml ``` -[Clique para baixar o TOML](/presets/toml/pure-preset.toml) +[Click to download TOML](/presets/toml/pure-preset.toml){download} <<< @/public/presets/toml/pure-preset.toml diff --git a/docs/pt-BR/presets/tokyo-night.md b/docs/pt-BR/presets/tokyo-night.md index b29051c3..94ffd2df 100644 --- a/docs/pt-BR/presets/tokyo-night.md +++ b/docs/pt-BR/presets/tokyo-night.md @@ -16,6 +16,6 @@ Esta predefinição é inspirado por [tokyo-night-vscode-theme](https://github.c starship preset tokyo-night -o ~/.config/starship.toml ``` -[Clique para baixar o TOML](/presets/toml/tokyo-night.toml) +[Click to download TOML](/presets/toml/tokyo-night.toml){download} <<< @/public/presets/toml/tokyo-night.toml diff --git a/docs/pt-PT/config/README.md b/docs/pt-PT/config/README.md index 399853b5..b420d788 100644 --- a/docs/pt-PT/config/README.md +++ b/docs/pt-PT/config/README.md @@ -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,20 +1047,20 @@ 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_folders` | `[]` | Which folders should trigger this module. | -| `style` | `'green bold'` | The style for the module. | -| `disabled` | `false` | Disables the `deno` module. | +| 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', '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. | ### Variables @@ -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 @@ -1759,7 +1756,7 @@ The `git_commit` module shows the current commit hash and also the tag (if any) | `only_detached` | `true` | Only show git commit hash when in detached `HEAD` state | | `tag_disabled` | `true` | Disables showing tag info in `git_commit` module. | | `tag_max_candidates` | `0` | How many commits to consider for tag display. The default only allows exact matches. | -| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | +| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | | `disabled` | `false` | Disables the `git_commit` module. | ### Variables @@ -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. @@ -2934,17 +2975,17 @@ 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_folders` | `['node_modules']` | Which folders should trigger this module. | -| `style` | `'bold green'` | The style for the module. | -| `disabled` | `false` | Disables the `nodejs` module. | -| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | +| 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', '.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. | +| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | ### Variables @@ -3492,24 +3533,26 @@ 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 | -| `style` | `'yellow bold'` | The style for the module. | -| `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_folders` | `[]` | Which folders should trigger this module | -| `disabled` | `false` | Disables the `python` module. | +| 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 | +| `style` | `'yellow bold'` | The style for the module. | +| `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', '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. | ::: tip @@ -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` | `''` | 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. diff --git a/docs/pt-PT/guide/README.md b/docs/pt-PT/guide/README.md index 3485191d..6c6b751d 100644 --- a/docs/pt-PT/guide/README.md +++ b/docs/pt-PT/guide/README.md @@ -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.


diff --git a/docs/pt-PT/presets/bracketed-segments.md b/docs/pt-PT/presets/bracketed-segments.md index 579d789e..35d956bf 100644 --- a/docs/pt-PT/presets/bracketed-segments.md +++ b/docs/pt-PT/presets/bracketed-segments.md @@ -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 diff --git a/docs/pt-PT/presets/gruvbox-rainbow.md b/docs/pt-PT/presets/gruvbox-rainbow.md index 37ca1373..f2e1143a 100644 --- a/docs/pt-PT/presets/gruvbox-rainbow.md +++ b/docs/pt-PT/presets/gruvbox-rainbow.md @@ -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 diff --git a/docs/pt-PT/presets/jetpack.md b/docs/pt-PT/presets/jetpack.md index c247b97f..8117adce 100644 --- a/docs/pt-PT/presets/jetpack.md +++ b/docs/pt-PT/presets/jetpack.md @@ -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 diff --git a/docs/pt-PT/presets/nerd-font.md b/docs/pt-PT/presets/nerd-font.md index 131f21c4..84820fc3 100644 --- a/docs/pt-PT/presets/nerd-font.md +++ b/docs/pt-PT/presets/nerd-font.md @@ -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 diff --git a/docs/pt-PT/presets/no-empty-icons.md b/docs/pt-PT/presets/no-empty-icons.md index 2d262cdd..03bb1f38 100644 --- a/docs/pt-PT/presets/no-empty-icons.md +++ b/docs/pt-PT/presets/no-empty-icons.md @@ -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 diff --git a/docs/pt-PT/presets/no-nerd-font.md b/docs/pt-PT/presets/no-nerd-font.md index c3fb3636..c1542a62 100644 --- a/docs/pt-PT/presets/no-nerd-font.md +++ b/docs/pt-PT/presets/no-nerd-font.md @@ -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 diff --git a/docs/pt-PT/presets/no-runtimes.md b/docs/pt-PT/presets/no-runtimes.md index 218d1ae1..5cf87ff1 100644 --- a/docs/pt-PT/presets/no-runtimes.md +++ b/docs/pt-PT/presets/no-runtimes.md @@ -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 diff --git a/docs/pt-PT/presets/pastel-powerline.md b/docs/pt-PT/presets/pastel-powerline.md index 1feb9e1a..0d5c99a5 100644 --- a/docs/pt-PT/presets/pastel-powerline.md +++ b/docs/pt-PT/presets/pastel-powerline.md @@ -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 diff --git a/docs/pt-PT/presets/plain-text.md b/docs/pt-PT/presets/plain-text.md index 2a075171..686b3e06 100644 --- a/docs/pt-PT/presets/plain-text.md +++ b/docs/pt-PT/presets/plain-text.md @@ -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 diff --git a/docs/pt-PT/presets/pure-preset.md b/docs/pt-PT/presets/pure-preset.md index 68b7b49d..b27468de 100644 --- a/docs/pt-PT/presets/pure-preset.md +++ b/docs/pt-PT/presets/pure-preset.md @@ -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 diff --git a/docs/pt-PT/presets/tokyo-night.md b/docs/pt-PT/presets/tokyo-night.md index 7897c8e8..fbb8020f 100644 --- a/docs/pt-PT/presets/tokyo-night.md +++ b/docs/pt-PT/presets/tokyo-night.md @@ -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 diff --git a/docs/ru-RU/config/README.md b/docs/ru-RU/config/README.md index 274cb339..c266b877 100644 --- a/docs/ru-RU/config/README.md +++ b/docs/ru-RU/config/README.md @@ -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. ### Опции @@ -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 -Это не подавляет модификатор командной строки самой conda. Возможно, вы захотите запустить `conda config --set changeps1 False`. +Это не подавляет модификатор командной строки самой conda. Возможно, вы захотите запустить `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,20 +1047,20 @@ 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 ### Опции -| Параметр | По умолчанию | Описание | -| ------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------- | -| `format` | `'via [$symbol($version )]($style)'` | Формат модуля. | -| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | -| `symbol` | `'🦕 '` | A format string representing the symbol of 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_folders` | `[]` | Which folders should trigger this module. | -| `style` | `'green bold'` | Стиль модуля. | -| `disabled` | `false` | Disables the `deno` module. | +| Параметр | По умолчанию | Описание | +| ------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | Формат модуля. | +| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | +| `symbol` | `'🦕 '` | A format string representing the symbol of Deno | +| `detect_extensions` | `[]` | Which extensions 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'` | Стиль модуля. | +| `disabled` | `false` | Disables the `deno` module. | ### Переменные @@ -1117,7 +1114,7 @@ When using the `fish_style_pwd_dir_length` option, instead of hiding the path th | `fish_style_pwd_dir_length` | `0` | Количество символов, используемых при использовании логики создания пути из fish. | | `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 -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). ### Опции @@ -1759,7 +1756,7 @@ The `git_commit` module shows the current commit hash and also the tag (if any) | `only_detached` | `true` | Only show git commit hash when in detached `HEAD` state | | `tag_disabled` | `true` | Disables showing tag info in `git_commit` module. | | `tag_max_candidates` | `0` | How many commits to consider for tag display. The default only allows exact matches. | -| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | +| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | | `disabled` | `false` | Отключает модуль `git_commit`. | ### Переменные @@ -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'` | Стиль модуля. | | `ignore_submodules` | `false` | Ignore changes to submodules. | | `disabled` | `false` | Отключает модуль `git_status`. | @@ -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\* | Отражает значение параметра `style` | *: Эта переменная может использоваться только в качестве части строки style @@ -2257,6 +2254,7 @@ format = 'via [⎈ $version](bold white) ' | `format` | `'[$ssh_symbol$hostname]($style) in '` | Формат модуля. | | `style` | `'bold dimmed green'` | Стиль модуля. | | `disabled` | `false` | Отключает модуль `hostname`. | +| `aliases` | `{}` | Translate system hostnames to something else. If `trim_at` is specified, only the first part will be matched and replaced. | ### Переменные @@ -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 + +### Опции + +| Параметр | По умолчанию | Описание | +| ------------------- | ------------------------------------- | ------------------------------------------------------ | +| `format` | `'with [$symbol($version )]($style)'` | Формат модуля. | +| `symbol` | `'🔥 '` | The symbol used before displaying the version of Mojo. | +| `style` | `'bold 208'` | Стиль модуля. | +| `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. | + +### Переменные + +| Переменная | Пример | Описание | +| ---------- | -------- | ------------------------------------ | +| version | `24.4.0` | The version of `mojo` | +| symbol | | Отражает значение параметра `symbol` | +| style\* | | Отражает значение параметра `style` | + +*: Эта переменная может использоваться только в качестве части строки style + +### Пример + +```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. @@ -2934,17 +2975,17 @@ The `nodejs` module shows the currently installed version of [Node.js](https://n ### Опции -| Параметр | По умолчанию | Описание | -| ------------------- | ------------------------------------------ | ----------------------------------------------------------------------------------------------------- | -| `format` | `'via [$symbol($version )]($style)'` | Формат модуля. | -| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | -| `symbol` | `' '` | A format string representing the symbol of 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_folders` | `['node_modules']` | Which folders should trigger this module. | -| `style` | `'bold green'` | Стиль модуля. | -| `disabled` | `false` | Отключает модуль `nodejs`. | -| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | +| Параметр | По умолчанию | Описание | +| ------------------- | --------------------------------------------- | ----------------------------------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | Формат модуля. | +| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | +| `symbol` | `' '` | A format string representing the symbol of Node.js. | +| `detect_extensions` | `['js', 'mjs', 'cjs', 'ts', 'mts', 'cts']` | Which extensions 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'` | Стиль модуля. | +| `disabled` | `false` | Отключает модуль `nodejs`. | +| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | ### Переменные @@ -3492,24 +3533,26 @@ By default, the module will be shown if any of the following conditions are met: - Текущий каталог содержит файл `requirements.txt` - Текущий каталог содержит файл `setup.py` - Текущий каталог содержит файл `tox.ini` +- Текущий каталог содержит файл `pixi.toml` - Текущий каталог содержит файл с расширением `.py`. +- The current directory contains a file with the `.ipynb` extension. - Виртуальная среда в данный момент активирована ### Опции -| Параметр | По умолчанию | Описание | -| -------------------- | ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- | -| `format` | `'via [${symbol}${pyenv_prefix}(${version} )(\($virtualenv\) )]($style)'` | Формат модуля. | -| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | -| `symbol` | `'🐍 '` | A format string representing the symbol of Python | -| `style` | `'yellow bold'` | Стиль модуля. | -| `pyenv_version_name` | `false` | Использовать pyenv для получения версии 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_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_folders` | `[]` | Which folders should trigger this module | -| `disabled` | `false` | Disables the `python` module. | +| Параметр | По умолчанию | Описание | +| -------------------- | ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | +| `format` | `'via [${symbol}${pyenv_prefix}(${version} )(\($virtualenv\) )]($style)'` | Формат модуля. | +| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | +| `symbol` | `'🐍 '` | A format string representing the symbol of Python | +| `style` | `'yellow bold'` | Стиль модуля. | +| `pyenv_version_name` | `false` | Использовать pyenv для получения версии 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_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. | ::: tip @@ -4350,7 +4393,7 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` | `format` | `'[$user]($style) in '` | Формат модуля. | | `show_always` | `false` | Всегда показывать модуль `username`. | | `disabled` | `false` | Отключает модуль `username`. | -| `aliases` | `{}` | Translate system usernames to something else | +| `aliases` | `{}` | Translate system usernames to something else. | ### Переменные @@ -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 | Параметр | По умолчанию | Описание | | ------------------- | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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) | | `описание` | `''` | 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 | Переменная | Описание | | ---------- | -------------------------------------- | -| output | The output of shell command in `shell` | +| output | The output of `command` run in `shell` | | symbol | Отражает значение параметра `symbol` | | style\* | Отражает значение параметра `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. diff --git a/docs/ru-RU/guide/README.md b/docs/ru-RU/guide/README.md index 201f4baa..fe1d3825 100644 --- a/docs/ru-RU/guide/README.md +++ b/docs/ru-RU/guide/README.md @@ -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.


diff --git a/docs/ru-RU/presets/bracketed-segments.md b/docs/ru-RU/presets/bracketed-segments.md index f1203497..2490b737 100644 --- a/docs/ru-RU/presets/bracketed-segments.md +++ b/docs/ru-RU/presets/bracketed-segments.md @@ -12,6 +12,6 @@ starship preset bracketed-segments -o ~/.config/starship.toml ``` -[Нажмите, чтобы загрузить TOML](/presets/toml/bracketed-segments.toml) +[Click to download TOML](/presets/toml/bracketed-segments.toml){download} <<< @/public/presets/toml/bracketed-segments.toml diff --git a/docs/ru-RU/presets/gruvbox-rainbow.md b/docs/ru-RU/presets/gruvbox-rainbow.md index 7a34d430..f4a3a8a8 100644 --- a/docs/ru-RU/presets/gruvbox-rainbow.md +++ b/docs/ru-RU/presets/gruvbox-rainbow.md @@ -16,6 +16,6 @@ starship preset gruvbox-rainbow -o ~/.config/starship.toml ``` -[Нажмите, чтобы загрузить TOML](/presets/toml/gruvbox-rainbow.toml) +[Click to download TOML](/presets/toml/gruvbox-rainbow.toml){download} <<< @/public/presets/toml/gruvbox-rainbow.toml diff --git a/docs/ru-RU/presets/jetpack.md b/docs/ru-RU/presets/jetpack.md index 321ac6e8..63cc273b 100644 --- a/docs/ru-RU/presets/jetpack.md +++ b/docs/ru-RU/presets/jetpack.md @@ -19,6 +19,6 @@ starship preset jetpack -o ~/.config/starship.toml ``` -[Нажмите, чтобы загрузить TOML](/presets/toml/jetpack.toml) +[Click to download TOML](/presets/toml/jetpack.toml){download} <<< @/public/presets/toml/jetpack.toml diff --git a/docs/ru-RU/presets/nerd-font.md b/docs/ru-RU/presets/nerd-font.md index 021c9b20..3a4cbac2 100644 --- a/docs/ru-RU/presets/nerd-font.md +++ b/docs/ru-RU/presets/nerd-font.md @@ -16,6 +16,6 @@ starship preset nerd-font-symbols -o ~/.config/starship.toml ``` -[Нажмите, чтобы загрузить 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 diff --git a/docs/ru-RU/presets/no-empty-icons.md b/docs/ru-RU/presets/no-empty-icons.md index bfb354ac..e34dc6d0 100644 --- a/docs/ru-RU/presets/no-empty-icons.md +++ b/docs/ru-RU/presets/no-empty-icons.md @@ -12,6 +12,6 @@ starship preset no-empty-icons -o ~/.config/starship.toml ``` -[Нажмите, чтобы загрузить 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 diff --git a/docs/ru-RU/presets/no-nerd-font.md b/docs/ru-RU/presets/no-nerd-font.md index 80d30114..cdd969e9 100644 --- a/docs/ru-RU/presets/no-nerd-font.md +++ b/docs/ru-RU/presets/no-nerd-font.md @@ -14,6 +14,6 @@ starship preset no-nerd-font -o ~/.config/starship.toml ``` -[Нажмите, чтобы загрузить 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 diff --git a/docs/ru-RU/presets/no-runtimes.md b/docs/ru-RU/presets/no-runtimes.md index f0e9a664..43aefdd9 100644 --- a/docs/ru-RU/presets/no-runtimes.md +++ b/docs/ru-RU/presets/no-runtimes.md @@ -12,6 +12,6 @@ starship preset no-runtime-versions -o ~/.config/starship.toml ``` -[Нажмите, чтобы загрузить 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 diff --git a/docs/ru-RU/presets/pastel-powerline.md b/docs/ru-RU/presets/pastel-powerline.md index c7f10a62..4e6adb78 100644 --- a/docs/ru-RU/presets/pastel-powerline.md +++ b/docs/ru-RU/presets/pastel-powerline.md @@ -16,6 +16,6 @@ starship preset pastel-powerline -o ~/.config/starship.toml ``` -[Нажмите, чтобы загрузить TOML](/presets/toml/pastel-powerline.toml) +[Click to download TOML](/presets/toml/pastel-powerline.toml){download} <<< @/public/presets/toml/pastel-powerline.toml diff --git a/docs/ru-RU/presets/plain-text.md b/docs/ru-RU/presets/plain-text.md index f1a86ee3..317e8680 100644 --- a/docs/ru-RU/presets/plain-text.md +++ b/docs/ru-RU/presets/plain-text.md @@ -12,6 +12,6 @@ starship preset plain-text-symbols -o ~/.config/starship.toml ``` -[Нажмите, чтобы загрузить 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 diff --git a/docs/ru-RU/presets/pure-preset.md b/docs/ru-RU/presets/pure-preset.md index 044d1cd3..3a622be9 100644 --- a/docs/ru-RU/presets/pure-preset.md +++ b/docs/ru-RU/presets/pure-preset.md @@ -12,6 +12,6 @@ starship preset pure-preset -o ~/.config/starship.toml ``` -[Нажмите, чтобы загрузить TOML](/presets/toml/pure-preset.toml) +[Click to download TOML](/presets/toml/pure-preset.toml){download} <<< @/public/presets/toml/pure-preset.toml diff --git a/docs/ru-RU/presets/tokyo-night.md b/docs/ru-RU/presets/tokyo-night.md index 5af21c00..6a4de9bd 100644 --- a/docs/ru-RU/presets/tokyo-night.md +++ b/docs/ru-RU/presets/tokyo-night.md @@ -16,6 +16,6 @@ starship preset tokyo-night -o ~/.config/starship.toml ``` -[Нажмите, чтобы загрузить TOML](/presets/toml/tokyo-night.toml) +[Click to download TOML](/presets/toml/tokyo-night.toml){download} <<< @/public/presets/toml/tokyo-night.toml diff --git a/docs/tr-TR/config/README.md b/docs/tr-TR/config/README.md index ced7bffb..42d9a5f8 100644 --- a/docs/tr-TR/config/README.md +++ b/docs/tr-TR/config/README.md @@ -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,20 +1047,20 @@ 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_folders` | `[]` | Which folders should trigger this module. | -| `stil` | `'green bold'` | The style for the module. | -| `disabled` | `false` | Disables the `deno` module. | +| 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', 'deno.lock', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | Which filenames should trigger this module. | +| `detect_folders` | `[]` | Which folders should trigger this module. | +| `stil` | `'green bold'` | The style for the module. | +| `disabled` | `false` | Disables the `deno` module. | ### Variables @@ -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 @@ -1759,7 +1756,7 @@ The `git_commit` module shows the current commit hash and also the tag (if any) | `only_detached` | `true` | Only show git commit hash when in detached `HEAD` state | | `tag_disabled` | `true` | Disables showing tag info in `git_commit` module. | | `tag_max_candidates` | `0` | How many commits to consider for tag display. The default only allows exact matches. | -| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | +| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | | `disabled` | `false` | Disables the `git_commit` module. | ### Variables @@ -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` | | `stil` | `'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. | | `stil` | `'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. | +| `stil` | `'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. @@ -2934,17 +2975,17 @@ 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_folders` | `['node_modules']` | Which folders should trigger this module. | -| `stil` | `'bold green'` | The style for the module. | -| `disabled` | `false` | Disables the `nodejs` module. | -| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | +| 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', '.nvmrc']` | Which filenames should trigger this module. | +| `detect_folders` | `['node_modules']` | Which folders should trigger this module. | +| `stil` | `'bold green'` | The style for the module. | +| `disabled` | `false` | Disables the `nodejs` module. | +| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | ### Variables @@ -3492,24 +3533,26 @@ 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 | -| `stil` | `'yellow bold'` | The style for the module. | -| `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_folders` | `[]` | Which folders should trigger this module | -| `disabled` | `false` | Disables the `python` module. | +| 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 | +| `stil` | `'yellow bold'` | The style for the module. | +| `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', '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. | ::: tip @@ -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` | `''` | 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. diff --git a/docs/tr-TR/guide/README.md b/docs/tr-TR/guide/README.md index 37ddd363..26fc4add 100644 --- a/docs/tr-TR/guide/README.md +++ b/docs/tr-TR/guide/README.md @@ -431,7 +431,16 @@ Lütfen starship'in oluşmasında ilham kaynağı olan çalışmalara da göz at [Bir sponsor olarak](https://github.com/sponsors/starship) bu projeye destek ver. İsminiz veya logonuz bağlantınız ile beraber burda görünecek. -- Ücretsiz kod imzalama [SignPath.io](https://signpath.io) tarafından sağlanmıştır, sertifika [SignPath Foundation](https://signpath.org) tarafından sağlanmıştır +## 🔒 Code Signing Policy + +Ücretsiz kod imzalama [SignPath.io](https://signpath.io) tarafından sağlanmıştır, sertifika [SignPath Foundation](https://signpath.org) tarafından sağlanmıştır. + +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.


diff --git a/docs/tr-TR/presets/bracketed-segments.md b/docs/tr-TR/presets/bracketed-segments.md index bfbee2d4..1f6dfeeb 100644 --- a/docs/tr-TR/presets/bracketed-segments.md +++ b/docs/tr-TR/presets/bracketed-segments.md @@ -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 diff --git a/docs/tr-TR/presets/gruvbox-rainbow.md b/docs/tr-TR/presets/gruvbox-rainbow.md index bff50ffe..da410612 100644 --- a/docs/tr-TR/presets/gruvbox-rainbow.md +++ b/docs/tr-TR/presets/gruvbox-rainbow.md @@ -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 diff --git a/docs/tr-TR/presets/jetpack.md b/docs/tr-TR/presets/jetpack.md index 131daff8..40067ba4 100644 --- a/docs/tr-TR/presets/jetpack.md +++ b/docs/tr-TR/presets/jetpack.md @@ -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 diff --git a/docs/tr-TR/presets/nerd-font.md b/docs/tr-TR/presets/nerd-font.md index ba0fbc1d..db0bab53 100644 --- a/docs/tr-TR/presets/nerd-font.md +++ b/docs/tr-TR/presets/nerd-font.md @@ -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 diff --git a/docs/tr-TR/presets/no-empty-icons.md b/docs/tr-TR/presets/no-empty-icons.md index 69e4f152..fdd5d3bd 100644 --- a/docs/tr-TR/presets/no-empty-icons.md +++ b/docs/tr-TR/presets/no-empty-icons.md @@ -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 diff --git a/docs/tr-TR/presets/no-nerd-font.md b/docs/tr-TR/presets/no-nerd-font.md index fd54855b..235e53b4 100644 --- a/docs/tr-TR/presets/no-nerd-font.md +++ b/docs/tr-TR/presets/no-nerd-font.md @@ -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 diff --git a/docs/tr-TR/presets/no-runtimes.md b/docs/tr-TR/presets/no-runtimes.md index a8d96386..898c34b1 100644 --- a/docs/tr-TR/presets/no-runtimes.md +++ b/docs/tr-TR/presets/no-runtimes.md @@ -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 diff --git a/docs/tr-TR/presets/pastel-powerline.md b/docs/tr-TR/presets/pastel-powerline.md index c14441f5..5f097961 100644 --- a/docs/tr-TR/presets/pastel-powerline.md +++ b/docs/tr-TR/presets/pastel-powerline.md @@ -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 diff --git a/docs/tr-TR/presets/plain-text.md b/docs/tr-TR/presets/plain-text.md index de41e9f3..7eb6cfe7 100644 --- a/docs/tr-TR/presets/plain-text.md +++ b/docs/tr-TR/presets/plain-text.md @@ -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 diff --git a/docs/tr-TR/presets/pure-preset.md b/docs/tr-TR/presets/pure-preset.md index 5fd6819d..299cc23b 100644 --- a/docs/tr-TR/presets/pure-preset.md +++ b/docs/tr-TR/presets/pure-preset.md @@ -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 diff --git a/docs/tr-TR/presets/tokyo-night.md b/docs/tr-TR/presets/tokyo-night.md index d28d6412..7d0359db 100644 --- a/docs/tr-TR/presets/tokyo-night.md +++ b/docs/tr-TR/presets/tokyo-night.md @@ -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 diff --git a/docs/uk-UA/advanced-config/README.md b/docs/uk-UA/advanced-config/README.md index 51e63793..a9bb1337 100644 --- a/docs/uk-UA/advanced-config/README.md +++ b/docs/uk-UA/advanced-config/README.md @@ -287,7 +287,7 @@ continuation_prompt = '▶▶ ' - `` - `none` -де `` є специфікацією кольору (обговорюється нижче). `fg:` та `` на цей час роблять те саме, хоча це може змінитися в майбутньому. `` can also be set to `prev_fg` or `prev_bg` which evaluates to the previous item's foreground or background color respectively if available or `none` otherwise. `inverted` замінює кольори тла і тексту. Порядок слів у рядку не має значення. +де `` є специфікацією кольору (обговорюється нижче). `fg:` та `` на цей час роблять те саме, хоча це може змінитися в майбутньому. `` може також мати значення `prev_fg` або `prev_bg`, які обчислюють колір тексту або фону попереднього елемента відповідно, якщо він доступний, або `none` у протилежному випадку. `inverted` замінює кольори тла і тексту. Порядок слів у рядку не має значення. Токен `none` перевизначає всі інші токени у рядку, якщо він не є частиною `bg:`, так `fg:red none fg:blue` все одно створить рядок без стилізування. `bg:none` встановлює типовий колір фону, таким чином, `fg:red bg:none` еквівалентно `red` або `fg:red`, а `bg:green fg:red fg:none` також еквівалентно `fg:red` або `red`. Використання `none` у поєднанні з іншими токенами в майбутньому може стати помилкою. diff --git a/docs/uk-UA/config/README.md b/docs/uk-UA/config/README.md index d1f93d04..3b060167 100644 --- a/docs/uk-UA/config/README.md +++ b/docs/uk-UA/config/README.md @@ -553,10 +553,7 @@ discharging_symbol = '💦' ## Buf -Модуль `buf` показує поточну встановлену версію [Buf](https://buf.build). Типово, модуль показується, якщо всі наступні умови виконуються: - -- Встановлено [`buf`](https://github.com/bufbuild/buf) CLI. -- Поточна тека містить файли налаштувань [`buf.yaml`](https://docs.buf.build/configuration/v1/buf-yaml), [`buf.gen.yaml`](https://docs.buf.build/configuration/v1/buf-gen-yaml), чи [`buf.work.yaml`](https://docs.buf.build/configuration/v1/buf-work-yaml). +Модуль `buf` показує поточну встановлену версію [Buf](https://buf.build). Стандартно, модуль показується якщо поточна тека містить [`buf.yaml`](https://docs.buf.build/configuration/v1/buf-yaml), [`buf.gen.yaml`](https://docs.buf.build/configuration/v1/buf-gen-yaml) або конфігураційний файл [`buf.work.yaml`](https://docs.buf.build/configuration/v1/buf-work-yaml). ### Параметри @@ -635,7 +632,7 @@ format = 'via [🍔 $version](bold green) ' Ви можете перевизначити параметр `detect_files` властивості [модуля nodejs](#nodejs) у вашій конфігурації, щоб показати середу виконання bun: -``` +```toml [nodejs] detect_files = ['package.json', '.node-version', '!bunfig.toml', '!bun.lockb'] ``` @@ -863,7 +860,7 @@ format = 'underwent [$duration](bold yellow)' ::: tip -Це не призводить до вимикання власного модифікатора командного рядка в conda. Можливо, вам доведеться виконати `conda config --set changeps1 False`. +Це не призводить до вимикання власного модифікатора командного рядка в conda. Можливо, вам доведеться виконати `conda config --set changeps1 False`. Якщо ви використовуєте [pixi](https://pixi.sh), ви можете відключити модифікатор запиту pixi, запустивши `pixi config set change-ps1 false`. ::: @@ -1050,20 +1047,20 @@ format = 'via [🔰 $version](bold red) ' Модуль `deno` показує поточну встановлену версію [Deno](https://deno.land/). Типово, модуль показується, якщо виконується будь-яка з наступних умов: -- Поточна тека містить файли `deno.json`, `deno.jsonc`, `mod.ts`, `mod.js`, `deps.ts` чи `deps.js` +- The current directory contains a `deno.json`, `deno.jsonc`, `deno.lock`, `mod.ts`, `mod.js`, `deps.ts` or `deps.js` file ### Параметри -| Параметр | Стандартно | Опис | -| ------------------- | ----------------------------------------------------------------------- | ----------------------------------------------------------------- | -| `format` | `'via [$symbol($version )]($style)'` | Формат модуля. | -| `version_format` | `'v${raw}'` | Формат версії. Доступні змінні `raw`, `major`, `minor` та `patch` | -| `symbol` | `'🦕 '` | Формат рядка, що представляє символ Deno | -| `detect_extensions` | `[]` | Які розширення повинні запускати цей модуль. | -| `detect_files` | `['deno.json', 'deno.jsonc', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | Які імена файлів мають запускати цей модуль. | -| `detect_folders` | `[]` | В яких теках цей модуль має запускатись. | -| `style` | `'green bold'` | Стиль модуля. | -| `disabled` | `false` | Вимикає модуль `deno`. | +| Параметр | Стандартно | Опис | +| ------------------- | ------------------------------------------------------------------------------------ | ----------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | Формат модуля. | +| `version_format` | `'v${raw}'` | Формат версії. Доступні змінні `raw`, `major`, `minor` та `patch` | +| `symbol` | `'🦕 '` | Формат рядка, що представляє символ Deno | +| `detect_extensions` | `[]` | Які розширення повинні запускати цей модуль. | +| `detect_files` | `['deno.json', 'deno.jsonc', 'deno.lock', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | Які імена файлів мають запускати цей модуль. | +| `detect_folders` | `[]` | В яких теках цей модуль має запускатись. | +| `style` | `'green bold'` | Стиль модуля. | +| `disabled` | `false` | Вимикає модуль `deno`. | ### Змінні @@ -1117,7 +1114,7 @@ format = 'via [🦕 $version](green bold) ' | `fish_style_pwd_dir_length` | `0` | Кількість символів, які використовуються при застосуванні логіки шляху fish shell pwd. | | `use_logical_path` | `true` | Якщо `true` показувати логічний шлях оболонки через `PWD` або `--logical-path`. Якщо `false` – показувати шлях фізичної файлової системи з розвʼязанням шляхів для символічних посилань. | -`substitutions` дозволяє визначити довільні заміни літер рядків, що зустрічаються в шляху, наприклад, довгі префікси мережі або теки розробки (в Java). Зауважте, що це відключить стиль fish у PWD. +`substitutions` дозволяє визначити довільні заміни літеральних рядків, що зустрічаються в шляху, наприклад, довгі префікси мережі або теки розробки в Java. Зауважте, що це відключить стиль fish у PWD. ```toml [directory.substitutions] @@ -1207,7 +1204,7 @@ disabled = false ## Docker Context -Модуль `docker_context` показує поточний [Docker context](https://docs.docker.com/engine/context/working-with-contexts/) якщо його не встановлено у `default`, або якщо змінні середовища `DOCKER_MACHINE_NAME`, `DOCKER_HOST` або `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 `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). ### Параметри @@ -1759,7 +1756,7 @@ ignore_branches = ['master', 'main'] | `only_detached` | `true` | Показувати хеш коміту тільки коли `HEAD` у відʼєднаному стані | | `tag_disabled` | `true` | Вимикає показ теґів в модулі `git_commit`. | | `tag_max_candidates` | `0` | Впродовж скількох комітів показувати теґ. Стандартно дозволяється тільки безпосередній збіг. | -| `tag_symbol` | `' 🏷 '` | Символ теґу | +| `tag_symbol` | `' 🏷 '` | Символ теґу | | `disabled` | `false` | Вимикає модуль `git_commit`. | ### Змінні @@ -1890,7 +1887,7 @@ format = '[+$added]($added_style)/[-$deleted]($deleted_style) ' | `staged` | `'+'` | Формат `staged` | | `renamed` | `'»'` | Формат `renamed` | | `deleted` | `'✘'` | Формат `deleted` | -| `typechanged` | `""` | Формат `typechange` | +| `typechanged` | `""` | Формат `typechanged` | | `style` | `'bold red'` | Стиль модуля. | | `ignore_submodules` | `false` | Ігнорувати зміни в субмодулях. | | `disabled` | `false` | Вимикає модуль `git_status`. | @@ -1911,7 +1908,7 @@ format = '[+$added]($added_style)/[-$deleted]($deleted_style) ' | `staged` | Показує `staged`, коли нові фали були додані до простору staging. | | `renamed` | Показує `renamed` коли перейменовані файли було додано до простору staging. | | `deleted` | Показує `deleted` коли інформація про видалення файлів була додана до простору staging. | -| `typechanged` | Показує `typechange` коли інформація про файл була змінена у просторі staging. | +| `typechanged` | Показує `typechanged` коли інформація про файл була змінена у просторі staging. | | style\* | Віддзеркалює значення параметра `style` | *: Ця змінна може бути використана лише як частина стилю рядка @@ -2257,6 +2254,7 @@ format = 'via [⎈ $version](bold white) ' | `format` | `'[$ssh_symbol$hostname]($style) in '` | Формат модуля. | | `style` | `'bold dimmed green'` | Стиль модуля. | | `disabled` | `false` | Вимикає модуль `hostname`. | +| `aliases` | `{}` | Переводить системні імена хостів у щось інше. Якщо задано `trim_at`, то лише перша частина буде перевірена та замінена. | ### Змінні @@ -2293,6 +2291,14 @@ detect_env_vars = ['!TMUX', 'SSH_CONNECTION'] disabled = false ``` +#### Замінити імʼя хосту псевдонімом + +```toml +# ~/.config/starship.toml +[hostname] +aliases = { "Max's MacBook Pro" = "home" } +``` + ## Java Модуль `java` показує поточну встановлену версію [Java](https://www.oracle.com/java/). Типово, модуль показується, якщо виконується будь-яка з наступних умов: @@ -2809,6 +2815,41 @@ truncation_length = 4 truncation_symbol = '' ``` +## Mojo + +Модуль `mojo` показує поточну версію встановленої мови програмування [Mojo](https://www.modular.com/mojo) + +### Параметри + +| Параметр | Стандартно | Опис | +| ------------------- | ------------------------------------- | -------------------------------------------- | +| `format` | `'with [$symbol($version )]($style)'` | Формат модуля. | +| `symbol` | `'🔥 '` | Символ, який знаходиться перед версією Mojo. | +| `style` | `'bold 208'` | Стиль модуля. | +| `disabled` | `false` | Вимикає модуль `mojo`. | +| `detect_extensions` | `['mojo', '🔥']` | Які розширення повинні запускати цей модуль. | +| `detect_files` | `[]` | Які імена файлів мають запускати цей модуль. | +| `detect_folders` | `[]` | В яких теках цей модуль має запускатись. | + +### Змінні + +| Змінна | Приклад | Опис | +| --------- | -------- | ---------------------------------------- | +| version | `24.4.0` | Версія `mojo` | +| symbol | | Віддзеркалює значення параметра `symbol` | +| style\* | | Віддзеркалює значення параметра `style` | + +*: Ця змінна може бути використана лише як частина стилю рядка + +### Приклад + +```toml +# ~/.config/starship.toml + +[mojo] +format = 'via [mojo ($version )($hash )]($style)' +``` + ## NATS Модуль `nats` показує назву поточного контексту[NATS](https://nats.io). @@ -2934,17 +2975,17 @@ format = 'via [☃️ $state( \($name\))](bold blue) ' ### Параметри -| Параметр | Стандартно | Опис | -| ------------------- | ------------------------------------------ | -------------------------------------------------------------------------------- | -| `format` | `'via [$symbol($version )]($style)'` | Формат модуля. | -| `version_format` | `'v${raw}'` | Формат версії. Доступні змінні `raw`, `major`, `minor` та `patch` | -| `symbol` | `' '` | Формат рядка, що представляє символ Node.js. | -| `detect_extensions` | `['js', 'mjs', 'cjs', 'ts', 'mts', 'cts']` | Які розширення повинні запускати цей модуль. | -| `detect_files` | `['package.json', '.node-version']` | Які імена файлів мають запускати цей модуль. | -| `detect_folders` | `['node_modules']` | В яких теках цей модуль має запускатись. | -| `style` | `'bold green'` | Стиль модуля. | -| `disabled` | `false` | Вимикає модуль `nodejs`. | -| `not_capable_style` | `'bold red'` | Стиль для модуля, коли версія рушія у package.json не відповідає версії Node.js. | +| Параметр | Стандартно | Опис | +| ------------------- | --------------------------------------------- | -------------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | Формат модуля. | +| `version_format` | `'v${raw}'` | Формат версії. Доступні змінні `raw`, `major`, `minor` та `patch` | +| `symbol` | `' '` | Формат рядка, що представляє символ Node.js. | +| `detect_extensions` | `['js', 'mjs', 'cjs', 'ts', 'mts', 'cts']` | Які розширення повинні запускати цей модуль. | +| `detect_files` | `['package.json', '.node-version', '.nvmrc']` | Які імена файлів мають запускати цей модуль. | +| `detect_folders` | `['node_modules']` | В яких теках цей модуль має запускатись. | +| `style` | `'bold green'` | Стиль модуля. | +| `disabled` | `false` | Вимикає модуль `nodejs`. | +| `not_capable_style` | `'bold red'` | Стиль для модуля, коли версія рушія у package.json не відповідає версії Node.js. | ### Змінні @@ -3492,24 +3533,26 @@ format = 'via [$symbol$version](bold white)' - Поточна тека містить файл `requirements.txt` - Поточна тека містить файл `setup.py` - Поточна тека містить файл `tox.ini` +- Поточна тека містить файл `pixi.toml` - Поточна тека містить файл `.py`. +- Поточна тека містить файли з розширенням `.ipynb`. - Віртуальне середовище активовано ### Параметри -| Параметр | Стандартно | Опис | -| -------------------- | ------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------- | -| `format` | `'via [${symbol}${pyenv_prefix}(${version} )(\($virtualenv\) )]($style)'` | Формат модуля. | -| `version_format` | `'v${raw}'` | Формат версії. Доступні змінні `raw`, `major`, `minor` та `patch` | -| `symbol` | `'🐍 '` | Формат рядка, що представляє символ Python | -| `style` | `'yellow bold'` | Стиль модуля. | -| `pyenv_version_name` | `false` | Використовувати pyenv для отримання версії Python | -| `pyenv_prefix` | `'pyenv'` | Префікс перед версією pyenv, показується якщо pyenv використовується | -| `python_binary` | `['python', 'python3', 'python2']` | Налаштовує бінарні файли python, який Starship буде використовувати для отримання версії. | -| `detect_extensions` | `['py']` | Які розширення повинні запускати цей модуль | -| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini']` | Назви файлів, які активують модуль | -| `detect_folders` | `[]` | Назви тек, що активують модуль | -| `disabled` | `false` | Вимикає модуль `python`. | +| Параметр | Стандартно | Опис | +| -------------------- | ------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | +| `format` | `'via [${symbol}${pyenv_prefix}(${version} )(\($virtualenv\) )]($style)'` | Формат модуля. | +| `version_format` | `'v${raw}'` | Формат версії. Доступні змінні `raw`, `major`, `minor` та `patch` | +| `symbol` | `'🐍 '` | Формат рядка, що представляє символ Python | +| `style` | `'yellow bold'` | Стиль модуля. | +| `pyenv_version_name` | `false` | Використовувати pyenv для отримання версії Python | +| `pyenv_prefix` | `'pyenv'` | Префікс перед версією pyenv, показується якщо pyenv використовується | +| `python_binary` | `['python', 'python3', 'python2']` | Налаштовує бінарні файли python, який Starship буде використовувати для отримання версії. | +| `detect_extensions` | `['py', 'ipynb']` | Які розширення повинні запускати цей модуль | +| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini', 'pixi.toml']` | Назви файлів, які активують модуль | +| `detect_folders` | `[]` | Назви тек, що активують модуль | +| `disabled` | `false` | Вимикає модуль `python`. | ::: tip @@ -4350,7 +4393,7 @@ time_range = '10:00:00-14:00:00' | `format` | `'[$user]($style) in '` | Формат модуля. | | `show_always` | `false` | Завжди показувати модуль `username`. | | `disabled` | `false` | Вимикає модуль `username`. | -| `aliases` | `{}` | Переводить системні імена користувачів у щось інше | +| `aliases` | `{}` | Переводить системні імена користувачів у щось інше. | ### Змінні @@ -4361,7 +4404,7 @@ time_range = '10:00:00-14:00:00' ### Приклад -#### Завжди показувати hostname +#### Завжди показувати username ```toml # ~/.config/starship.toml @@ -4375,17 +4418,6 @@ show_always = true aliases = { "corpuser034g" = "matchai" } ``` -#### Приховувати hostname для віддалених сеансів tmux - -```toml -# ~/.config/starship.toml - -[hostname] -ssh_only = false -detect_env_vars = ['!TMUX', 'SSH_CONNECTION'] -disabled = false -``` - ## Vagrant Модуль `vagrant` показує поточну встановлену версію [Vagrant](https://www.vagrantup.com/). Типово, модуль показується, якщо виконується будь-яка з наступних умов: @@ -4560,9 +4592,9 @@ symbol = '⚡️ ' ::: -::: warning If `unsafe_no_escape` is enabled or prior to starship v1.20 command output is printed unescaped to the prompt. +::: warning Якщо увімкнено `unsafe_no_escape` або до версії starship v1.20 вивід команди буде виведено без екранування. -Незалежно від результату, який генерує команда, він виводиться в командний рядок у незміненому вигляді. This means if the output contains shell-specific interpretable sequences, they could be interpreted on display. Depending on the shell, this can mean that e.g. strings enclosed by backticks are executed by the shell. Such sequences are usually shell specific, e.g. you can write a command module that writes bash sequences, e.g. `\h`, but this module will not work in a fish or zsh shell. +Незалежно від результату, який генерує команда, він виводиться в командний рядок у незміненому вигляді. Це означає, що якщо вивід містить специфічні для оболонки інтерпретовані послідовності, вони можуть бути інтерпретовані безпосередньо під час виведення на екран. Залежно від оболонки, це може означати, що, наприклад, рядки, у зворотніх лапках, виконуються оболонкою. Такі послідовності зазвичай залежать від оболонки, наприклад, ви можете написати командний модуль, який пише послідовності для bash, наприклад, `\h`, але цей модуль не працюватиме в оболонці fish або zsh. Рядок формату також може містити специфічні послідовності командного рядка, наприклад [Bash](https://www.gnu.org/software/bash/manual/html_node/Controlling-the-Prompt.html), [Zsh](https://zsh.sourceforge.io/Doc/Release/Prompt-Expansion.html). @@ -4573,11 +4605,11 @@ symbol = '⚡️ ' | Параметр | Стандартно | Опис | | ------------------- | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `command` | `''` | Команда, вивід якої потрібно показувати. Команду буде передано до оболонки через stdin. | -| `when` | `false` | Або булеве значення (`true` чи `false`, без лапок) або команди shell, що використовуються як умова для показу модуля. У випадку рядка команди, модуль буде показаний, якщо команда повертає код завершення `0`. | +| `when` | `false` | Або булеве значення (`true` чи `false`, без лапок) або команди shell, що використовуються як умова для показу модуля. In case of a string, the module will be shown if the `shell` returns a `0` status code from executing it. | | `require_repo` | `false` | Якщо `true`, модуль буде показано лише в шляхах, що містять репозиторій (git). Цей параметр сам по собі не є достатньою умовою для показу модуля за відсутності інших варіантів. | | `shell` | | [Дивіться нижче](#custom-command-shell) | | `description` | `''` | Опис модуля, який показується під час запуску `starship explain`. | -| `unsafe_no_escape` | `false` | When set, command output is not escaped of characters that could be interpreted by the shell. | +| `unsafe_no_escape` | `false` | Якщо встановлено, виведення команд не екранується від символів, які можуть бути інтерпретовані оболонкою. | | `detect_files` | `[]` | Файли, які треба шукати у робочій теці для отримання збігу. | | `detect_folders` | `[]` | Теки, які треба шукати у робочій теці для отримання збігу. | | `detect_extensions` | `[]` | Розширення файлів, які треба шукати у робочій теці для отримання збігу. | @@ -4593,7 +4625,7 @@ symbol = '⚡️ ' | Змінна | Опис | | --------- | ---------------------------------------- | -| output | Вивід команд в `shell` | +| output | The output of `command` run in `shell` | | symbol | Віддзеркалює значення параметра `symbol` | | style\* | Віддзеркалює значення параметра `style` | @@ -4608,7 +4640,7 @@ symbol = '⚡️ ' Якщо не налаштовано, модуль повертатиметься до STARSHIP_SHELL, а потім до «sh» у Linux і «cmd /C» у Windows. -Команда `command` буде передана до stdin. +The `command` (and `when`, if applicable) will be passed in on stdin. Якщо `shell` не вказано або містить тільки один елемент і Starship виявить, що буде використано PowerShell, наступні аргументи будуть автоматично додані: `-Noprofile -Command -`. Якщо `shell` не вказано або міститься лише один елемент і Starship виявить, що буде використано Cmd, аргумент`/C` буде автоматично додано, а `stdin` буде встановлено у `false`. Якщо `shell` не вказано або міститься лише один елемент і Starship виявить, що буде використано Nushell, аргумент`c` буде автоматично додано, а `stdin` буде встановлено у `false`. Такої поведінки можна уникнути шляхом явного передавання аргументів до оболонки, наприклад, diff --git a/docs/uk-UA/guide/README.md b/docs/uk-UA/guide/README.md index 5d25260e..bc057788 100644 --- a/docs/uk-UA/guide/README.md +++ b/docs/uk-UA/guide/README.md @@ -431,7 +431,16 @@ eval "$(starship init zsh)" Підтримайте цей проєкт [ставши спонсором](https://github.com/sponsors/starship). Ваше імʼя або логотип показуватимуться тут з посиланням на ваш сайт. -- Безкоштовний підпис похідного коду надано [SignPath.io](https://signpath.io), сертифікат надано [SignPath Foundation](https://signpath.org) +## 🔒 Code Signing Policy + +Безкоштовний підпис похідного коду надано [SignPath.io](https://signpath.io), сертифікат надано [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.


diff --git a/docs/uk-UA/presets/bracketed-segments.md b/docs/uk-UA/presets/bracketed-segments.md index 6ebb13b0..70e5b3d5 100644 --- a/docs/uk-UA/presets/bracketed-segments.md +++ b/docs/uk-UA/presets/bracketed-segments.md @@ -12,6 +12,6 @@ starship preset bracketed-segments -o ~/.config/starship.toml ``` -[Натисніть, щоб завантажити TOML](/presets/toml/bracketed-segments.toml) +[Натисніть, щоб завантажити TOML](/presets/toml/bracketed-segments.toml){download} <<< @/public/presets/toml/bracketed-segments.toml diff --git a/docs/uk-UA/presets/gruvbox-rainbow.md b/docs/uk-UA/presets/gruvbox-rainbow.md index 3e74c354..bfb6e4d1 100644 --- a/docs/uk-UA/presets/gruvbox-rainbow.md +++ b/docs/uk-UA/presets/gruvbox-rainbow.md @@ -16,6 +16,6 @@ starship preset gruvbox-rainbow -o ~/.config/starship.toml ``` -[Натисніть, щоб завантажити TOML](/presets/toml/gruvbox-rainbow.toml) +[Натисніть, щоб завантажити TOML](/presets/toml/gruvbox-rainbow.toml){download} <<< @/public/presets/toml/gruvbox-rainbow.toml diff --git a/docs/uk-UA/presets/jetpack.md b/docs/uk-UA/presets/jetpack.md index 230c27da..507ce6c0 100644 --- a/docs/uk-UA/presets/jetpack.md +++ b/docs/uk-UA/presets/jetpack.md @@ -19,6 +19,6 @@ starship preset jetpack -o ~/.config/starship.toml ``` -[Натисніть, щоб завантажити TOML](/presets/toml/jetpack.toml) +[Натисніть, щоб завантажити TOML](/presets/toml/jetpack.toml){download} <<< @/public/presets/toml/jetpack.toml diff --git a/docs/uk-UA/presets/nerd-font.md b/docs/uk-UA/presets/nerd-font.md index 2693d35c..349cdccf 100644 --- a/docs/uk-UA/presets/nerd-font.md +++ b/docs/uk-UA/presets/nerd-font.md @@ -16,6 +16,6 @@ starship preset nerd-font-symbols -o ~/.config/starship.toml ``` -[Натисніть, щоб завантажити TOML](/presets/toml/nerd-font-symbols.toml) +[Натисніть, щоб завантажити TOML](/presets/toml/nerd-font-symbols.toml){download} <<< @/public/presets/toml/nerd-font-symbols.toml diff --git a/docs/uk-UA/presets/no-empty-icons.md b/docs/uk-UA/presets/no-empty-icons.md index b3982b9d..8667e3cd 100644 --- a/docs/uk-UA/presets/no-empty-icons.md +++ b/docs/uk-UA/presets/no-empty-icons.md @@ -12,6 +12,6 @@ starship preset no-empty-icons -o ~/.config/starship.toml ``` -[Натисніть, щоб завантажити TOML](/presets/toml/no-empty-icons.toml) +[Натисніть, щоб завантажити TOML](/presets/toml/no-empty-icons.toml){download} <<< @/public/presets/toml/no-empty-icons.toml diff --git a/docs/uk-UA/presets/no-nerd-font.md b/docs/uk-UA/presets/no-nerd-font.md index 72e6eac1..19d1cf01 100644 --- a/docs/uk-UA/presets/no-nerd-font.md +++ b/docs/uk-UA/presets/no-nerd-font.md @@ -14,6 +14,6 @@ starship preset no-nerd-font -o ~/.config/starship.toml ``` -[Натисніть, щоб завантажити TOML](/presets/toml/no-nerd-font.toml) +[Натисніть, щоб завантажити TOML](/presets/toml/no-nerd-font.toml){download} <<< @/public/presets/toml/no-nerd-font.toml diff --git a/docs/uk-UA/presets/no-runtimes.md b/docs/uk-UA/presets/no-runtimes.md index c60560b1..aec2b7bc 100644 --- a/docs/uk-UA/presets/no-runtimes.md +++ b/docs/uk-UA/presets/no-runtimes.md @@ -12,6 +12,6 @@ starship preset no-runtime-versions -o ~/.config/starship.toml ``` -[Натисніть, щоб завантажити TOML](/presets/toml/no-runtime-versions.toml) +[Натисніть, щоб завантажити TOML](/presets/toml/no-runtime-versions.toml){download} <<< @/public/presets/toml/no-runtime-versions.toml diff --git a/docs/uk-UA/presets/pastel-powerline.md b/docs/uk-UA/presets/pastel-powerline.md index 7f05b69a..4b27b276 100644 --- a/docs/uk-UA/presets/pastel-powerline.md +++ b/docs/uk-UA/presets/pastel-powerline.md @@ -16,6 +16,6 @@ starship preset pastel-powerline -o ~/.config/starship.toml ``` -[Натисніть, щоб завантажити TOML](/presets/toml/pastel-powerline.toml) +[Натисніть, щоб завантажити TOML](/presets/toml/pastel-powerline.toml){download} <<< @/public/presets/toml/pastel-powerline.toml diff --git a/docs/uk-UA/presets/plain-text.md b/docs/uk-UA/presets/plain-text.md index 921f019a..9652d83b 100644 --- a/docs/uk-UA/presets/plain-text.md +++ b/docs/uk-UA/presets/plain-text.md @@ -12,6 +12,6 @@ starship preset plain-text-symbols -o ~/.config/starship.toml ``` -[Натисніть, щоб завантажити TOML](/presets/toml/plain-text-symbols.toml) +[Натисніть, щоб завантажити TOML](/presets/toml/plain-text-symbols.toml){download} <<< @/public/presets/toml/plain-text-symbols.toml diff --git a/docs/uk-UA/presets/pure-preset.md b/docs/uk-UA/presets/pure-preset.md index 9a889ca5..3b90840b 100644 --- a/docs/uk-UA/presets/pure-preset.md +++ b/docs/uk-UA/presets/pure-preset.md @@ -12,6 +12,6 @@ starship preset pure-preset -o ~/.config/starship.toml ``` -[Натисніть, щоб завантажити TOML](/presets/toml/pure-preset.toml) +[Натисніть, щоб завантажити TOML](/presets/toml/pure-preset.toml){download} <<< @/public/presets/toml/pure-preset.toml diff --git a/docs/uk-UA/presets/tokyo-night.md b/docs/uk-UA/presets/tokyo-night.md index deb9ab9e..d0a1c076 100644 --- a/docs/uk-UA/presets/tokyo-night.md +++ b/docs/uk-UA/presets/tokyo-night.md @@ -16,6 +16,6 @@ starship preset tokyo-night -o ~/.config/starship.toml ``` -[Натисніть, щоб завантажити TOML](/presets/toml/tokyo-night.toml) +[Натисніть, щоб завантажити TOML](/presets/toml/tokyo-night.toml){download} <<< @/public/presets/toml/tokyo-night.toml diff --git a/docs/vi-VN/config/README.md b/docs/vi-VN/config/README.md index 2a96d8c8..8b8ed68f 100644 --- a/docs/vi-VN/config/README.md +++ b/docs/vi-VN/config/README.md @@ -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. ### Các tuỳ chọn @@ -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 -Cái này không loại bỏ conda's prompt mà nó sở hữu, bạn có thể muốn chạy `conda config --set changeps1 False`. +Cái này không loại bỏ conda's prompt mà nó sở hữu, bạn có thể muốn chạy `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,20 +1047,20 @@ format = 'via [🔰 $version](bold red) ' The `deno` module shows you your currently installed version of [Deno](https://deno.land/). Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn: -- 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 -| Tuỳ chọn | Mặc định | Mô tả | -| ------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------- | -| `format` | `'via [$symbol($version )]($style)'` | Định dạng cho 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` | `[]` | Những tiện ích mở rộng nào sẽ kích hoạt mô-đun này. | -| `detect_files` | `['deno.json', 'deno.jsonc', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | Những tên tệp nào sẽ kích hoạt mô-đun này. | -| `detect_folders` | `[]` | Những thư mục nào sẽ kích hoạt mô-đun này. | -| `style` | `'green bold'` | Kiểu cho module. | -| `disabled` | `false` | Disables the `deno` module. | +| Tuỳ chọn | Mặc định | Mô tả | +| ------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | Định dạng cho 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` | `[]` | Những tiện ích mở rộng nào sẽ kích hoạt mô-đun này. | +| `detect_files` | `['deno.json', 'deno.jsonc', 'deno.lock', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | Những tên tệp nào sẽ kích hoạt mô-đun này. | +| `detect_folders` | `[]` | Những thư mục nào sẽ kích hoạt mô-đun này. | +| `style` | `'green bold'` | Kiểu cho module. | +| `disabled` | `false` | Disables the `deno` module. | ### Các biến @@ -1117,7 +1114,7 @@ Cho ví dụ, `~/Dev/Nix/nixpkgs/pkgs` nơi `nixpkgs` là gốc của repo, và | `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 @@ -1759,7 +1756,7 @@ Mô đun `git_commit` hiển thị hash commit hiện tại và tag (nếu có) | `only_detached` | `true` | Only show git commit hash when in detached `HEAD` state | | `tag_disabled` | `true` | Vô hiệu hiển thị thông tin tag trong mô đun `git_commit`. | | `tag_max_candidates` | `0` | How many commits to consider for tag display. The default only allows exact matches. | -| `tag_symbol` | `' 🏷 '` | Biểu tượng tag trước thông tin được hiển thị | +| `tag_symbol` | `' 🏷 '` | Biểu tượng tag trước thông tin được hiển thị | | `disabled` | `false` | Vô hiệu mô đun `git_commit`. | ### Các biến @@ -1890,7 +1887,7 @@ The Git Status module is very slow in Windows directories (for example under `/m | `staged` | `'+'` | Định dạng của `modified` | | `renamed` | `'»'` | Định dạng của `renamed` | | `deleted` | `'✘'` | Định dạng của `deleted` | -| `typechanged` | `""` | The format of `typechange` | +| `typechanged` | `""` | The format of `typechanged` | | `style` | `'bold red'` | Kiểu cho module. | | `ignore_submodules` | `false` | Ignore changes to submodules. | | `disabled` | `false` | Vô hiệu `git_status` module. | @@ -1911,7 +1908,7 @@ Các biến dưới đây có thể được sử dụng trong `format`: | `staged` | Hiển thị `staged` khi một tệp tin mới được thêm vào staging area. | | `renamed` | Hiển thị `renamed` khi một tệp tin đổi tên đã được thêm vào staging area. | | `deleted` | Hiển thị `deleted` khi một tệp tin bị xóa đã được thêm vào 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\* | Giá trị ghi đè của `style` | *: Biến này có thể chỉ được sử dụng như một phần của style string @@ -2257,6 +2254,7 @@ Mô đun `hostname` hiển thị hostnam hệ thống. | `format` | `'[$ssh_symbol$hostname]($style) in '` | Định dạng cho module. | | `style` | `'bold dimmed green'` | Kiểu cho module. | | `disabled` | `false` | Vô hiệu `hastname` module. | +| `aliases` | `{}` | Translate system hostnames to something else. If `trim_at` is specified, only the first part will be matched and replaced. | ### Các biến @@ -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/). Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn: @@ -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 + +### Các tuỳ chọn + +| Tuỳ chọn | Mặc định | Mô tả | +| ------------------- | ------------------------------------- | ------------------------------------------------------ | +| `format` | `'with [$symbol($version )]($style)'` | Định dạng cho module. | +| `symbol` | `'🔥 '` | The symbol used before displaying the version of Mojo. | +| `style` | `'bold 208'` | Kiểu cho module. | +| `disabled` | `false` | Disables the `mojo` module. | +| `detect_extensions` | `['mojo', '🔥']` | Những tiện ích mở rộng nào sẽ kích hoạt mô-đun này. | +| `detect_files` | `[]` | Những tên tệp nào sẽ kích hoạt mô-đun này. | +| `detect_folders` | `[]` | Những thư mục nào sẽ kích hoạt mô-đun này. | + +### Các biến + +| Biến | Ví dụ | Mô tả | +| --------- | -------- | -------------------------------- | +| version | `24.4.0` | The version of `mojo` | +| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | +| style\* | | Giá trị ghi đè của `style` | + +*: Biến này có thể chỉ được sử dụng như một phần của style string + +### Ví dụ + +```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. @@ -2934,17 +2975,17 @@ The `nodejs` module shows the currently installed version of [Node.js](https://n ### Các tuỳ chọn -| Tuỳ chọn | Mặc định | Mô tả | -| ------------------- | ------------------------------------------ | ----------------------------------------------------------------------------------------------------- | -| `format` | `'via [$symbol($version )]($style)'` | Định dạng cho 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']` | Những tiện ích mở rộng nào sẽ kích hoạt mô-đun này. | -| `detect_files` | `['package.json', '.node-version']` | Những tên tệp nào sẽ kích hoạt mô-đun này. | -| `detect_folders` | `['node_modules']` | Những thư mục nào sẽ kích hoạt mô-đun này. | -| `style` | `'bold green'` | Kiểu cho module. | -| `disabled` | `false` | Disables the `nodejs` module. | -| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | +| Tuỳ chọn | Mặc định | Mô tả | +| ------------------- | --------------------------------------------- | ----------------------------------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | Định dạng cho 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']` | Những tiện ích mở rộng nào sẽ kích hoạt mô-đun này. | +| `detect_files` | `['package.json', '.node-version', '.nvmrc']` | Những tên tệp nào sẽ kích hoạt mô-đun này. | +| `detect_folders` | `['node_modules']` | Những thư mục nào sẽ kích hoạt mô-đun này. | +| `style` | `'bold green'` | Kiểu cho module. | +| `disabled` | `false` | Disables the `nodejs` module. | +| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | ### Các biến @@ -3492,24 +3533,26 @@ By default, the module will be shown if any of the following conditions are met: - Thư mục hiện tại chứa một tập tin `requirements.txt` - Thư mục hiện tại chứa một tập tin `setup.py` - Thư mục hiện tại chứa một tập tin `tox.ini` +- Thư mục hiện tại chứa một tập tin `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 ### Các tuỳ chọn -| Tuỳ chọn | Mặc định | Mô tả | -| -------------------- | ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- | -| `format` | `'via [${symbol}${pyenv_prefix}(${version} )(\($virtualenv\) )]($style)'` | Định dạng cho module. | -| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | -| `symbol` | `'🐍 '` | A format string representing the symbol of Python | -| `style` | `'yellow bold'` | Kiểu cho module. | -| `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']` | Những tiện ích mở rộng nào sẽ kích hoạt mô-đun này | -| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini']` | Tên tệp nào sẽ kích hoạt mô-đun này | -| `detect_folders` | `[]` | Thư mục nào sẽ kích hoạt mô-đun này | -| `disabled` | `false` | Disables the `python` module. | +| Tuỳ chọn | Mặc định | Mô tả | +| -------------------- | ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | +| `format` | `'via [${symbol}${pyenv_prefix}(${version} )(\($virtualenv\) )]($style)'` | Định dạng cho module. | +| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | +| `symbol` | `'🐍 '` | A format string representing the symbol of Python | +| `style` | `'yellow bold'` | Kiểu cho module. | +| `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', 'ipynb']` | Những tiện ích mở rộng nào sẽ kích hoạt mô-đun này | +| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini', 'pixi.toml']` | Tên tệp nào sẽ kích hoạt mô-đun này | +| `detect_folders` | `[]` | Thư mục nào sẽ kích hoạt mô-đun này | +| `disabled` | `false` | Disables the `python` module. | ::: tip @@ -4350,7 +4393,7 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` | `format` | `'[$user]($style) in '` | Định dạng cho 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. | ### Các biến @@ -4361,7 +4404,7 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Ví dụ -#### 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/). Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn: @@ -4573,7 +4605,7 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt | Tuỳ chọn | Mặc định | Mô tả | | ------------------- | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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) | | `mô tả` | `''` | 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 | Biến | Mô tả | | --------- | -------------------------------------- | -| output | The output of shell command in `shell` | +| output | The output of `command` run in `shell` | | symbol | Giá trị ghi đè tuỳ chọn `symbol` | | style\* | Giá trị ghi đè của `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. diff --git a/docs/vi-VN/guide/README.md b/docs/vi-VN/guide/README.md index e737c65d..dd7772b1 100644 --- a/docs/vi-VN/guide/README.md +++ b/docs/vi-VN/guide/README.md @@ -431,7 +431,16 @@ Xin hãy xem qua những công việc này trước đây, những thứ đã gi Hỗ trợ project này bằng việc [trở thành nhà tài trợ](https://github.com/sponsors/starship). Tên hoặc logo của nhà tài trợ sẽ được hiển thị với một liên kết dẫn tới trang web của họ. -- 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.


diff --git a/docs/vi-VN/presets/bracketed-segments.md b/docs/vi-VN/presets/bracketed-segments.md index 9dbb9706..1a4d23a5 100644 --- a/docs/vi-VN/presets/bracketed-segments.md +++ b/docs/vi-VN/presets/bracketed-segments.md @@ -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 ``` -[Nhấn vào đây để tải tệp tin TOML](/presets/toml/bracketed-segments.toml) +[Click to download TOML](/presets/toml/bracketed-segments.toml){download} <<< @/public/presets/toml/bracketed-segments.toml diff --git a/docs/vi-VN/presets/gruvbox-rainbow.md b/docs/vi-VN/presets/gruvbox-rainbow.md index ff793eec..7d8ca1da 100644 --- a/docs/vi-VN/presets/gruvbox-rainbow.md +++ b/docs/vi-VN/presets/gruvbox-rainbow.md @@ -16,6 +16,6 @@ This preset is heavily inspired by [Pastel Powerline](./pastel-powerline.md), an starship preset gruvbox-rainbow -o ~/.config/starship.toml ``` -[Nhấn vào đây để tải tệp tin TOML](/presets/toml/gruvbox-rainbow.toml) +[Click to download TOML](/presets/toml/gruvbox-rainbow.toml){download} <<< @/public/presets/toml/gruvbox-rainbow.toml diff --git a/docs/vi-VN/presets/jetpack.md b/docs/vi-VN/presets/jetpack.md index a80bbb1c..b18b8a89 100644 --- a/docs/vi-VN/presets/jetpack.md +++ b/docs/vi-VN/presets/jetpack.md @@ -19,6 +19,6 @@ This is a pseudo minimalist preset inspired by the [geometry](https://github.com starship preset jetpack -o ~/.config/starship.toml ``` -[Nhấn vào đây để tải tệp tin TOML](/presets/toml/jetpack.toml) +[Click to download TOML](/presets/toml/jetpack.toml){download} <<< @/public/presets/toml/jetpack.toml diff --git a/docs/vi-VN/presets/nerd-font.md b/docs/vi-VN/presets/nerd-font.md index ff4019dd..c63c2104 100644 --- a/docs/vi-VN/presets/nerd-font.md +++ b/docs/vi-VN/presets/nerd-font.md @@ -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 ``` -[Nhấn vào đây để tải tệp tin 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 diff --git a/docs/vi-VN/presets/no-empty-icons.md b/docs/vi-VN/presets/no-empty-icons.md index 721c9e15..c746f314 100644 --- a/docs/vi-VN/presets/no-empty-icons.md +++ b/docs/vi-VN/presets/no-empty-icons.md @@ -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 ``` -[Nhấn vào đây để tải tệp tin 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 diff --git a/docs/vi-VN/presets/no-nerd-font.md b/docs/vi-VN/presets/no-nerd-font.md index d789e1e6..a7a66a9f 100644 --- a/docs/vi-VN/presets/no-nerd-font.md +++ b/docs/vi-VN/presets/no-nerd-font.md @@ -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 ``` -[Nhấn vào đây để tải tệp tin 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 diff --git a/docs/vi-VN/presets/no-runtimes.md b/docs/vi-VN/presets/no-runtimes.md index cf79d339..5ba4a306 100644 --- a/docs/vi-VN/presets/no-runtimes.md +++ b/docs/vi-VN/presets/no-runtimes.md @@ -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 ``` -[Nhấn vào đây để tải tệp tin 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 diff --git a/docs/vi-VN/presets/pastel-powerline.md b/docs/vi-VN/presets/pastel-powerline.md index dc00c671..88f65435 100644 --- a/docs/vi-VN/presets/pastel-powerline.md +++ b/docs/vi-VN/presets/pastel-powerline.md @@ -16,6 +16,6 @@ This preset is inspired by [M365Princess](https://github.com/JanDeDobbeleer/oh-m starship preset pastel-powerline -o ~/.config/starship.toml ``` -[Nhấn vào đây để tải tệp tin TOML](/presets/toml/pastel-powerline.toml) +[Click to download TOML](/presets/toml/pastel-powerline.toml){download} <<< @/public/presets/toml/pastel-powerline.toml diff --git a/docs/vi-VN/presets/plain-text.md b/docs/vi-VN/presets/plain-text.md index 7191cb6f..bbaae91e 100644 --- a/docs/vi-VN/presets/plain-text.md +++ b/docs/vi-VN/presets/plain-text.md @@ -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 ``` -[Nhấn vào đây để tải tệp tin 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 diff --git a/docs/vi-VN/presets/pure-preset.md b/docs/vi-VN/presets/pure-preset.md index 1406009a..77b36f9f 100644 --- a/docs/vi-VN/presets/pure-preset.md +++ b/docs/vi-VN/presets/pure-preset.md @@ -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 ``` -[Nhấn vào đây để tải tệp tin TOML](/presets/toml/pure-preset.toml) +[Click to download TOML](/presets/toml/pure-preset.toml){download} <<< @/public/presets/toml/pure-preset.toml diff --git a/docs/vi-VN/presets/tokyo-night.md b/docs/vi-VN/presets/tokyo-night.md index 793779d7..af86cdc0 100644 --- a/docs/vi-VN/presets/tokyo-night.md +++ b/docs/vi-VN/presets/tokyo-night.md @@ -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 ``` -[Nhấn vào đây để tải tệp tin TOML](/presets/toml/tokyo-night.toml) +[Click to download TOML](/presets/toml/tokyo-night.toml){download} <<< @/public/presets/toml/tokyo-night.toml diff --git a/docs/zh-CN/config/README.md b/docs/zh-CN/config/README.md index 96e55874..2e68d35e 100644 --- a/docs/zh-CN/config/README.md +++ b/docs/zh-CN/config/README.md @@ -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. ### 配置项 @@ -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 提示 -此组件没有禁用 conda 自带的提示符修改，您可能需要执行 `conda config --set changeps1 False`。 +此组件没有禁用 conda 自带的提示符修改，您可能需要执行 `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,20 +1047,20 @@ format = 'via [🔰 $version](bold red) ' `deno` 组件显示当前安装的 [Deno](https://deno.land/) 版本。 默认情况下，此组件将在满足以下任意条件时显示： -- 当前目录包含 `deno.json`、`deno.jsonc`、`mod.ts`、`mod.js`、`deps.ts` 或 `deps.js` 文件 +- The current directory contains a `deno.json`, `deno.jsonc`, `deno.lock`, `mod.ts`, `mod.js`, `deps.ts` or `deps.js` file ### 配置项 -| 选项 | 默认值 | 描述 | -| ------------------- | ----------------------------------------------------------------------- | ------------------------------------------- | -| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 | -| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor` 和 `patch` | -| `symbol` | `'🦕 '` | 用于表示 Deno 的格式化字符串 | -| `detect_extensions` | `[]` | 触发此组件的扩展名 | -| `detect_files` | `['deno.json', 'deno.jsonc', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | 触发此组件的文件名 | -| `detect_folders` | `[]` | 触发此组件的文件夹 | -| `style` | `'green bold'` | 此组件的样式。 | -| `disabled` | `false` | 禁用 `deno` 组件 | +| 选项 | 默认值 | 描述 | +| ------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 | +| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor` 和 `patch` | +| `symbol` | `'🦕 '` | 用于表示 Deno 的格式化字符串 | +| `detect_extensions` | `[]` | 触发此组件的扩展名 | +| `detect_files` | `['deno.json', 'deno.jsonc', 'deno.lock', 'mod.ts', 'mod.js', 'deps.ts', 'deps.js']` | 触发此组件的文件名 | +| `detect_folders` | `[]` | 触发此组件的文件夹 | +| `style` | `'green bold'` | 此组件的样式。 | +| `disabled` | `false` | 禁用 `deno` 组件 | ### 变量 @@ -1117,7 +1114,7 @@ When using the `fish_style_pwd_dir_length` option, instead of hiding the path th | `fish_style_pwd_dir_length` | `0` | 使用 fish shell 当前目录路径逻辑时每个省略目录名使用的字符数。 | | `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). ### 配置项 @@ -1759,7 +1756,7 @@ The `git_commit` module shows the current commit hash and also the tag (if any) | `only_detached` | `true` | Only show git commit hash when in detached `HEAD` state | | `tag_disabled` | `true` | Disables showing tag info in `git_commit` module. | | `tag_max_candidates` | `0` | How many commits to consider for tag display. The default only allows exact matches. | -| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | +| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | | `disabled` | `false` | 禁用 `git_commit` 组件。 | ### 变量 @@ -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'` | 此组件的样式。 | | `忽略子组件` | `false` | 忽略子模块的更改. | | `disabled` | `false` | 禁用 `git_status` 组件。 | @@ -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\* | `style`对应值 | *: 此变量只能作为样式字符串的一部分使用 @@ -2248,15 +2245,16 @@ format = 'via [⎈ $version](bold white) ' ### 配置项 -| 选项 | 默认值 | 描述 | -| ----------------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------ | -| `ssh_only` | `true` | 仅在连接到 SSH 会话时显示主机名。 | -| `ssh_symbol` | `'🌐 '` | A format string representing the symbol when connected to SSH session. | -| `trim_at` | `'.'` | 当主机名过长被截断时，会截断成第一次匹配该字符串之前的主机名。 `'.'` will stop after the first dot. `''` will disable any truncation. | -| `detect_env_vars` | `[]` | Which environment variable(s) should trigger this module. | -| `format` | `'[$ssh_symbol$hostname]($style) in '` | 组件格式化模板。 | -| `style` | `'bold dimmed green'` | 此组件的样式。 | -| `disabled` | `false` | 禁用 `hostname` 组件。 | +| 选项 | 默认值 | 描述 | +| ----------------- | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | +| `ssh_only` | `true` | 仅在连接到 SSH 会话时显示主机名。 | +| `ssh_symbol` | `'🌐 '` | A format string representing the symbol when connected to SSH session. | +| `trim_at` | `'.'` | 当主机名过长被截断时，会截断成第一次匹配该字符串之前的主机名。 `'.'` will stop after the first dot. `''` will disable any truncation. | +| `detect_env_vars` | `[]` | Which environment variable(s) should trigger this module. | +| `format` | `'[$ssh_symbol$hostname]($style) in '` | 组件格式化模板。 | +| `style` | `'bold dimmed green'` | 此组件的样式。 | +| `disabled` | `false` | 禁用 `hostname` 组件。 | +| `aliases` | `{}` | Translate system hostnames to something else. If `trim_at` is specified, only the first part will be matched and replaced. | ### 变量 @@ -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 `java` 组件显示当前安装的 [Java](https://www.oracle.com/java/) 版本。 默认情况下，此组件将在满足以下任意条件时显示： @@ -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 + +### 配置项 + +| 选项 | 默认值 | 描述 | +| ------------------- | ------------------------------------- | ------------------------------------------------------ | +| `format` | `'with [$symbol($version )]($style)'` | 组件格式化模板。 | +| `symbol` | `'🔥 '` | The symbol used before displaying the version of Mojo. | +| `style` | `'bold 208'` | 此组件的样式。 | +| `disabled` | `false` | Disables the `mojo` module. | +| `detect_extensions` | `['mojo', '🔥']` | 触发此组件的扩展名 | +| `detect_files` | `[]` | 触发此组件的文件名 | +| `detect_folders` | `[]` | 触发此组件的文件夹 | + +### 变量 + +| 字段 | 示例 | 描述 | +| --------- | -------- | --------------------- | +| version | `24.4.0` | The version of `mojo` | +| symbol | | `symbol`对应值 | +| style\* | | `style`对应值 | + +*: 此变量只能作为样式字符串的一部分使用 + +### 示例 + +```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. @@ -2934,17 +2975,17 @@ The `nodejs` module shows the currently installed version of [Node.js](https://n ### 配置项 -| 选项 | 默认值 | 描述 | -| ------------------- | ------------------------------------------ | ----------------------------------------------------------------------------------------------------- | -| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 | -| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor` 和 `patch` | -| `symbol` | `' '` | A format string representing the symbol of Node.js. | -| `detect_extensions` | `['js', 'mjs', 'cjs', 'ts', 'mts', 'cts']` | 触发此组件的扩展名 | -| `detect_files` | `['package.json', '.node-version']` | 触发此组件的文件名 | -| `detect_folders` | `['node_modules']` | 触发此组件的文件夹 | -| `style` | `'bold green'` | 此组件的样式。 | -| `disabled` | `false` | 禁用 `nodejs` 组件。 | -| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | +| 选项 | 默认值 | 描述 | +| ------------------- | --------------------------------------------- | ----------------------------------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 | +| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor` 和 `patch` | +| `symbol` | `' '` | A format string representing the symbol of Node.js. | +| `detect_extensions` | `['js', 'mjs', 'cjs', 'ts', 'mts', 'cts']` | 触发此组件的扩展名 | +| `detect_files` | `['package.json', '.node-version', '.nvmrc']` | 触发此组件的文件名 | +| `detect_folders` | `['node_modules']` | 触发此组件的文件夹 | +| `style` | `'bold green'` | 此组件的样式。 | +| `disabled` | `false` | 禁用 `nodejs` 组件。 | +| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | ### 变量 @@ -3492,24 +3533,26 @@ By default, the module will be shown if any of the following conditions are met: - 当前目录包含 `requirements.txt` 文件 - 当前目录包含一个 `setup.py` 文件 - 当前目录包含一个 `tox.ini` 文件 +- 当前目录包含 `pixi.toml` 文件 - 当前目录包含一个使用 `.py` 扩展名的文件. +- The current directory contains a file with the `.ipynb` extension. - 当前处于一个活跃的 python 虚拟环境中 ### 配置项 -| 选项 | 默认值 | 描述 | -| -------------------- | ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- | -| `format` | `'via [${symbol}${pyenv_prefix}(${version} )(\($virtualenv\) )]($style)'` | 组件格式化模板。 | -| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor` 和 `patch` | -| `symbol` | `'🐍 '` | 用于表示Python的格式化字符串。 | -| `style` | `'yellow bold'` | 此组件的样式。 | -| `pyenv_version_name` | `false` | 使用 pyenv 获取 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_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_folders` | `[]` | Which folders should trigger this module | -| `disabled` | `false` | 禁用 `python` 组件。 | +| 选项 | 默认值 | 描述 | +| -------------------- | ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | +| `format` | `'via [${symbol}${pyenv_prefix}(${version} )(\($virtualenv\) )]($style)'` | 组件格式化模板。 | +| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor` 和 `patch` | +| `symbol` | `'🐍 '` | 用于表示Python的格式化字符串。 | +| `style` | `'yellow bold'` | 此组件的样式。 | +| `pyenv_version_name` | `false` | 使用 pyenv 获取 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_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` | 禁用 `python` 组件。 | ::: tip 提示 @@ -4350,7 +4393,7 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` | `format` | `'[$user]($style) in '` | 组件格式化模板。 | | `show_always` | `false` | 总是显示 `username` 组件。 | | `disabled` | `false` | 禁用 `username` 组件。 | -| `aliases` | `{}` | Translate system usernames to something else | +| `aliases` | `{}` | Translate system usernames to something else. | ### 变量 @@ -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/). 默认情况下，此组件将在满足以下任意条件时显示： @@ -4573,7 +4605,7 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt | 选项 | 默认值 | 描述 | | ------------------- | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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) | | `描述` | `''` | The description of the module that is shown when running `starship explain`. | @@ -4591,11 +4623,11 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt ### 变量 -| 字段 | 描述 | -| --------- | -------------- | -| output | `shell` 中命令的输出 | -| symbol | `symbol`对应值 | -| style\* | `style`对应值 | +| 字段 | 描述 | +| --------- | -------------------------------------- | +| output | The output of `command` run in `shell` | +| symbol | `symbol`对应值 | +| style\* | `style`对应值 | *: 此变量只能作为样式字符串的一部分使用 @@ -4608,7 +4640,7 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt 如果未设置，它将回退到 STARSHIP_SHELL，然后回退到 Linux 上的 "sh" 命令，在 Windows 上则是 "cmd /C"。 -`command` 将会被传递给标准输入。 +The `command` (and `when`, if applicable) will be passed in on stdin. 如果 `shell` 未设置或仅包含一个元素，并且 Starship 检测到正在使用 PowerShell，则会自动添加 `-NoProfile -Command -` 参数。 如果 `shell` 未设置或仅包含一个元素，并且 Starship 检测到正在使用 Cmd，则会自动添加 `/C` 参数，并且将 `stdin` 设置为 `false`。 如果 `shell` 未设置或仅包含一个元素，并且 Starship 检测到正在使用 Cmd，则会自动添加 `-C` 参数，并且将 `stdin` 设置为 `false`。 可以通过将参数显式传递给 shell 来避免这种行为，例如： diff --git a/docs/zh-CN/guide/README.md b/docs/zh-CN/guide/README.md index 112ee7eb..dee795e9 100644 --- a/docs/zh-CN/guide/README.md +++ b/docs/zh-CN/guide/README.md @@ -431,7 +431,16 @@ eval "$(starship init zsh)" 通过 [成为赞助商 ](https://github.com/sponsors/starship)来支持这个项目。 您的名字或 LOGO 将在此处显示，并链接到您的网站。 -- 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.


diff --git a/docs/zh-CN/presets/README.md b/docs/zh-CN/presets/README.md index a88bf176..448a95a6 100644 --- a/docs/zh-CN/presets/README.md +++ b/docs/zh-CN/presets/README.md @@ -16,11 +16,11 @@ This preset changes the symbols for several modules so that no Nerd Font symbols ::: tip 提示 -This preset will become the default preset [in a future release of starship](https://github.com/starship/starship/pull/3544). +在[未来的starship release](https://github.com/starship/starship/pull/3544)中，这一预设将成为默认预设。 ::: -[Click to view No Nerd Font preset](./no-nerd-font) +[点击查看No Nerd Fonts预设](./no-nerd-font) ## [Bracketed Segments](./bracketed-segments.md) @@ -44,7 +44,7 @@ This preset will become the default preset [in a future release of starship](htt This preset does not show icons if the toolset is not found. -[![Screenshot of No Empty Icons preset](/presets/img/no-empty-icons.png "Click to view No Runtime Versions preset")](./no-empty-icons.md) +[![No Empty Icons预设的截图](/presets/img/no-empty-icons.png "Click to view No Runtime Versions preset")](./no-empty-icons.md) ## [Pure Prompt](./pure-preset.md) @@ -72,6 +72,6 @@ This preset is heavily inspired by [Pastel Powerline](./pastel-powerline.md), an ## [Jetpack](./jetpack.md) -This is a pseudo minimalist preset inspired by the [geometry](https://github.com/geometry-zsh/geometry) and [spaceship](https://github.com/spaceship-prompt/spaceship-prompt) prompts. +这是一个伪最简的预设，灵感来自 [geometry](https://github.com/geometry-zsh/geometry) 和 [spaceship](https://github.com/spaceship-prompt/spaceship-prompt)。 [![Screenshot of Jetpack preset](/presets/img/jetpack.png "Click to view Jetpack preset")](./jetpack) diff --git a/docs/zh-CN/presets/bracketed-segments.md b/docs/zh-CN/presets/bracketed-segments.md index ca6c4358..5f7abc4e 100644 --- a/docs/zh-CN/presets/bracketed-segments.md +++ b/docs/zh-CN/presets/bracketed-segments.md @@ -12,6 +12,6 @@ starship preset bracketed-segments -o ~/.config/starship.toml ``` -[点击下载 TOML 文件](/presets/toml/bracketed-segments.toml) +[Click to download TOML](/presets/toml/bracketed-segments.toml){download} <<< @/public/presets/toml/bracketed-segments.toml diff --git a/docs/zh-CN/presets/gruvbox-rainbow.md b/docs/zh-CN/presets/gruvbox-rainbow.md index 4ab3c76e..315bcf90 100644 --- a/docs/zh-CN/presets/gruvbox-rainbow.md +++ b/docs/zh-CN/presets/gruvbox-rainbow.md @@ -16,6 +16,6 @@ This preset is heavily inspired by [Pastel Powerline](./pastel-powerline.md), an starship preset gruvbox-rainbow -o ~/.config/starship.toml ``` -[点击下载 TOML 文件](/presets/toml/gruvbox-rainbow.toml) +[Click to download TOML](/presets/toml/gruvbox-rainbow.toml){download} <<< @/public/presets/toml/gruvbox-rainbow.toml diff --git a/docs/zh-CN/presets/jetpack.md b/docs/zh-CN/presets/jetpack.md index e865ecf5..82fa1097 100644 --- a/docs/zh-CN/presets/jetpack.md +++ b/docs/zh-CN/presets/jetpack.md @@ -2,7 +2,7 @@ # Jetpack Preset -This is a pseudo minimalist preset inspired by the [geometry](https://github.com/geometry-zsh/geometry) and [spaceship](https://github.com/spaceship-prompt/spaceship-prompt) prompts. +这是一个伪最简的预设，灵感来自 [geometry](https://github.com/geometry-zsh/geometry) 和 [spaceship](https://github.com/spaceship-prompt/spaceship-prompt)。 > Jetpack uses the terminal's color theme. @@ -10,7 +10,7 @@ This is a pseudo minimalist preset inspired by the [geometry](https://github.com ### Prerequisite -- Requires a shell with [`right-prompt`](https://starship.rs/advanced-config/#enable-right-prompt) support. +- 需要一个 支持[`右提示词`](https://starship.rs/advanced-config/#enable-right-prompt)的shell。 - [Jetbrains Mono](https://www.jetbrains.com/lp/mono/) is recommended. ### 配置 @@ -19,6 +19,6 @@ This is a pseudo minimalist preset inspired by the [geometry](https://github.com starship preset jetpack -o ~/.config/starship.toml ``` -[点击下载 TOML 文件](/presets/toml/jetpack.toml) +[Click to download TOML](/presets/toml/jetpack.toml){download} <<< @/public/presets/toml/jetpack.toml diff --git a/docs/zh-CN/presets/nerd-font.md b/docs/zh-CN/presets/nerd-font.md index 5b4beba4..ef087c7e 100644 --- a/docs/zh-CN/presets/nerd-font.md +++ b/docs/zh-CN/presets/nerd-font.md @@ -16,6 +16,6 @@ starship preset nerd-font-symbols -o ~/.config/starship.toml ``` -[点击下载 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 diff --git a/docs/zh-CN/presets/no-empty-icons.md b/docs/zh-CN/presets/no-empty-icons.md index 521cc9da..9befb89f 100644 --- a/docs/zh-CN/presets/no-empty-icons.md +++ b/docs/zh-CN/presets/no-empty-icons.md @@ -2,9 +2,9 @@ # No Empty Icons Preset -If toolset files are identified the toolset icon is displayed. If the toolset is not found to determine its version number, it is not displayed. This preset changes the behavior to display the icon only if the toolset information can be determined. +只有确认toolset文件后才显示toolset图标。 如果没有找到toolset的版本号，就不会显示toolset。 本预设改变了图标的显示条件：只有找到toolset信息时显示。 -![Screenshot of No Empty Icons preset](/presets/img/no-empty-icons.png) +![No Empty Icons预设的截图](/presets/img/no-empty-icons.png) ### 配置 @@ -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 ``` -[点击下载 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 diff --git a/docs/zh-CN/presets/no-nerd-font.md b/docs/zh-CN/presets/no-nerd-font.md index 8d876d3b..1c5f96b4 100644 --- a/docs/zh-CN/presets/no-nerd-font.md +++ b/docs/zh-CN/presets/no-nerd-font.md @@ -2,11 +2,11 @@ # No Nerd Fonts Preset -This preset restricts the use of symbols to those from emoji and powerline sets. +此预设谨慎的使用了来自emoji和powerline的符号。 -This means that even without a Nerd Font installed, you should be able to view all module symbols. +这意味着即使没有安装Nerd Font，您也应该看到所有的模块符号。 -This preset will become the default preset in a future release of starship. +在未来的starship release中，此预设将成为默认预设。 ### 配置 @@ -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 ``` -[点击下载 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 diff --git a/docs/zh-CN/presets/no-runtimes.md b/docs/zh-CN/presets/no-runtimes.md index f1320a01..5df249af 100644 --- a/docs/zh-CN/presets/no-runtimes.md +++ b/docs/zh-CN/presets/no-runtimes.md @@ -12,6 +12,6 @@ starship preset no-runtime-versions -o ~/.config/starship.toml ``` -[点击下载 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 diff --git a/docs/zh-CN/presets/pastel-powerline.md b/docs/zh-CN/presets/pastel-powerline.md index e01ffac7..bf0c5608 100644 --- a/docs/zh-CN/presets/pastel-powerline.md +++ b/docs/zh-CN/presets/pastel-powerline.md @@ -8,7 +8,7 @@ ### 前置要求 -- A [Nerd Font](https://www.nerdfonts.com/) installed and enabled in your terminal (the example uses Caskaydia Cove Nerd Font) +- 在终端中安装并使用 [Nerd Font](https://www.nerdfonts.com/)字体（本示例使用Caskaydia Cove Nerd Font）。 ### 配置 @@ -16,6 +16,6 @@ starship preset pastel-powerline -o ~/.config/starship.toml ``` -[点击下载 TOML 文件](/presets/toml/pastel-powerline.toml) +[Click to download TOML](/presets/toml/pastel-powerline.toml){download} <<< @/public/presets/toml/pastel-powerline.toml diff --git a/docs/zh-CN/presets/plain-text.md b/docs/zh-CN/presets/plain-text.md index dadef457..4693f050 100644 --- a/docs/zh-CN/presets/plain-text.md +++ b/docs/zh-CN/presets/plain-text.md @@ -12,6 +12,6 @@ starship preset plain-text-symbols -o ~/.config/starship.toml ``` -[点击下载 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 diff --git a/docs/zh-CN/presets/pure-preset.md b/docs/zh-CN/presets/pure-preset.md index d03dcef2..33778ff7 100644 --- a/docs/zh-CN/presets/pure-preset.md +++ b/docs/zh-CN/presets/pure-preset.md @@ -12,6 +12,6 @@ starship preset pure-preset -o ~/.config/starship.toml ``` -[点击下载 TOML 文件](/presets/toml/pure-preset.toml) +[Click to download TOML](/presets/toml/pure-preset.toml){download} <<< @/public/presets/toml/pure-preset.toml diff --git a/docs/zh-CN/presets/tokyo-night.md b/docs/zh-CN/presets/tokyo-night.md index 042bb1cc..cc873ccf 100644 --- a/docs/zh-CN/presets/tokyo-night.md +++ b/docs/zh-CN/presets/tokyo-night.md @@ -16,6 +16,6 @@ starship preset tokyo-night -o ~/.config/starship.toml ``` -[点击下载 TOML 文件](/presets/toml/tokyo-night.toml) +[Click to download TOML](/presets/toml/tokyo-night.toml){download} <<< @/public/presets/toml/tokyo-night.toml diff --git a/docs/zh-TW/config/README.md b/docs/zh-TW/config/README.md index 968c9afb..9562abd6 100644 --- a/docs/zh-TW/config/README.md +++ b/docs/zh-TW/config/README.md @@ -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. ### 選項 @@ -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,20 +1047,20 @@ 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 ### 選項 -| 選項 | 預設 | 說明 | -| ------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------- | -| `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_folders` | `[]` | Which folders should trigger this module. | -| `style` | `'green bold'` | 這個模組的風格。 | -| `disabled` | `false` | Disables the `deno` module. | +| 選項 | 預設 | 說明 | +| ------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------- | +| `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', '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'` | 這個模組的風格。 | +| `disabled` | `false` | Disables the `deno` module. | ### 變數 @@ -1117,7 +1114,7 @@ When using the `fish_style_pwd_dir_length` option, instead of hiding the path th | `fish_style_pwd_dir_length` | `0` | 當使用 fish shell 的 pwd 路徑邏輯時使用的字元數量。 | | `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). ### 選項 @@ -1759,7 +1756,7 @@ The `git_commit` module shows the current commit hash and also the tag (if any) | `only_detached` | `true` | Only show git commit hash when in detached `HEAD` state | | `tag_disabled` | `true` | Disables showing tag info in `git_commit` module. | | `tag_max_candidates` | `0` | How many commits to consider for tag display. The default only allows exact matches. | -| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | +| `tag_symbol` | `' 🏷 '` | Tag symbol prefixing the info shown | | `disabled` | `false` | Disables the `git_commit` module. | ### 變數 @@ -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'` | 這個模組的風格。 | | `ignore_submodules` | `false` | Ignore changes to submodules. | | `disabled` | `false` | 停用 `git_status` 模組。 | @@ -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 @@ -2248,15 +2245,16 @@ format = 'via [⎈ $version](bold white) ' ### 選項 -| 選項 | 預設 | 說明 | -| ----------------- | -------------------------------------- | -------------------------------------------------------------------------------------------- | -| `ssh_only` | `true` | 只在連接到一個 SSH session 時顯示主機名稱。 | -| `ssh_symbol` | `'🌐 '` | A format string representing the symbol when connected to SSH session. | -| `trim_at` | `'.'` | 擷取出主機名稱的斷點，以第一個符合的為準。 `'.'` will stop after the first dot. `''` will disable any truncation. | -| `detect_env_vars` | `[]` | Which environment variable(s) should trigger this module. | -| `format` | `'[$ssh_symbol$hostname]($style) in '` | The format for the module. | -| `style` | `'bold dimmed green'` | 這個模組的風格。 | -| `disabled` | `false` | 停用 `hostname` 模組。 | +| 選項 | 預設 | 說明 | +| ----------------- | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | +| `ssh_only` | `true` | 只在連接到一個 SSH session 時顯示主機名稱。 | +| `ssh_symbol` | `'🌐 '` | A format string representing the symbol when connected to SSH session. | +| `trim_at` | `'.'` | 擷取出主機名稱的斷點，以第一個符合的為準。 `'.'` will stop after the first dot. `''` will disable any truncation. | +| `detect_env_vars` | `[]` | Which environment variable(s) should trigger this module. | +| `format` | `'[$ssh_symbol$hostname]($style) in '` | The format for the module. | +| `style` | `'bold dimmed green'` | 這個模組的風格。 | +| `disabled` | `false` | 停用 `hostname` 模組。 | +| `aliases` | `{}` | Translate system hostnames to something else. If `trim_at` is specified, only the first part will be matched and replaced. | ### 變數 @@ -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 + +### 選項 + +| 選項 | 預設 | 說明 | +| ------------------- | ------------------------------------- | ------------------------------------------------------ | +| `format` | `'with [$symbol($version )]($style)'` | The format for the module. | +| `symbol` | `'🔥 '` | The symbol used before displaying the version of Mojo. | +| `style` | `'bold 208'` | 這個模組的風格。 | +| `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. | + +### 變數 + +| 變數 | 範例 | 說明 | +| --------- | -------- | ------------------------------------ | +| 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. @@ -2934,17 +2975,17 @@ The `nodejs` module shows the currently installed version of [Node.js](https://n ### 選項 -| 選項 | 預設 | 說明 | -| ------------------- | ------------------------------------------ | ----------------------------------------------------------------------------------------------------- | -| `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_folders` | `['node_modules']` | Which folders should trigger this module. | -| `style` | `'bold green'` | 這個模組的風格。 | -| `disabled` | `false` | 停用 `nodejs` 模組。 | -| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | +| 選項 | 預設 | 說明 | +| ------------------- | --------------------------------------------- | ----------------------------------------------------------------------------------------------------- | +| `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', '.nvmrc']` | Which filenames should trigger this module. | +| `detect_folders` | `['node_modules']` | Which folders should trigger this module. | +| `style` | `'bold green'` | 這個模組的風格。 | +| `disabled` | `false` | 停用 `nodejs` 模組。 | +| `not_capable_style` | `'bold red'` | The style for the module when an engines property in package.json does not match the Node.js version. | ### 變數 @@ -3492,24 +3533,26 @@ By default, the module will be shown if any of the following conditions are met: - 目前資料夾中有一個 `requirements.txt` 檔案 - 目前資料夾中有一個 `setup.py` 檔案 - 目前資料夾中有一個 `tox.ini` 檔案 +- 目前資料夾中有一個 `pixi.toml` 檔案 - 目前資料夾中有一個 `.py` 副檔名的檔案. +- The current directory contains a file with the `.ipynb` extension. - A virtual environment is currently activated ### 選項 -| 選項 | 預設 | 說明 | -| -------------------- | ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- | -| `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 | -| `style` | `'yellow bold'` | 這個模組的風格。 | -| `pyenv_version_name` | `false` | 使用 pyenv 取得 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_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_folders` | `[]` | Which folders should trigger this module | -| `disabled` | `false` | 停用 `python` 模組。 | +| 選項 | 預設 | 說明 | +| -------------------- | ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | +| `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 | +| `style` | `'yellow bold'` | 這個模組的風格。 | +| `pyenv_version_name` | `false` | 使用 pyenv 取得 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_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` | 停用 `python` 模組。 | ::: tip @@ -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` | 總是顯示 `username` 模組。 | | `disabled` | `false` | 停用 `username` 模組。 | -| `aliases` | `{}` | Translate system usernames to something else | +| `aliases` | `{}` | Translate system usernames to something else. | ### 變數 @@ -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 | 選項 | 預設 | 說明 | | ------------------- | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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) | | `說明` | `''` | 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 | 變數 | 說明 | | --------- | -------------------------------------- | -| 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. diff --git a/docs/zh-TW/guide/README.md b/docs/zh-TW/guide/README.md index f6734841..ba2e17c2 100644 --- a/docs/zh-TW/guide/README.md +++ b/docs/zh-TW/guide/README.md @@ -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.


diff --git a/docs/zh-TW/presets/bracketed-segments.md b/docs/zh-TW/presets/bracketed-segments.md index 2e607e84..50710c44 100644 --- a/docs/zh-TW/presets/bracketed-segments.md +++ b/docs/zh-TW/presets/bracketed-segments.md @@ -12,6 +12,6 @@ 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 diff --git a/docs/zh-TW/presets/gruvbox-rainbow.md b/docs/zh-TW/presets/gruvbox-rainbow.md index 868e12e0..5792a9b7 100644 --- a/docs/zh-TW/presets/gruvbox-rainbow.md +++ b/docs/zh-TW/presets/gruvbox-rainbow.md @@ -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 diff --git a/docs/zh-TW/presets/jetpack.md b/docs/zh-TW/presets/jetpack.md index 9100e44d..7c9f5bb5 100644 --- a/docs/zh-TW/presets/jetpack.md +++ b/docs/zh-TW/presets/jetpack.md @@ -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 diff --git a/docs/zh-TW/presets/nerd-font.md b/docs/zh-TW/presets/nerd-font.md index c19ed7d5..6c19abf9 100644 --- a/docs/zh-TW/presets/nerd-font.md +++ b/docs/zh-TW/presets/nerd-font.md @@ -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 diff --git a/docs/zh-TW/presets/no-empty-icons.md b/docs/zh-TW/presets/no-empty-icons.md index b1a264ed..ff9ab3e4 100644 --- a/docs/zh-TW/presets/no-empty-icons.md +++ b/docs/zh-TW/presets/no-empty-icons.md @@ -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 diff --git a/docs/zh-TW/presets/no-nerd-font.md b/docs/zh-TW/presets/no-nerd-font.md index f9a6872a..b87666ca 100644 --- a/docs/zh-TW/presets/no-nerd-font.md +++ b/docs/zh-TW/presets/no-nerd-font.md @@ -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 diff --git a/docs/zh-TW/presets/no-runtimes.md b/docs/zh-TW/presets/no-runtimes.md index 0acb751a..4a270b08 100644 --- a/docs/zh-TW/presets/no-runtimes.md +++ b/docs/zh-TW/presets/no-runtimes.md @@ -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 diff --git a/docs/zh-TW/presets/pastel-powerline.md b/docs/zh-TW/presets/pastel-powerline.md index 451344c9..099d4528 100644 --- a/docs/zh-TW/presets/pastel-powerline.md +++ b/docs/zh-TW/presets/pastel-powerline.md @@ -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 diff --git a/docs/zh-TW/presets/plain-text.md b/docs/zh-TW/presets/plain-text.md index 23b058dc..2b966677 100644 --- a/docs/zh-TW/presets/plain-text.md +++ b/docs/zh-TW/presets/plain-text.md @@ -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 diff --git a/docs/zh-TW/presets/pure-preset.md b/docs/zh-TW/presets/pure-preset.md index b8e1730a..e34b5043 100644 --- a/docs/zh-TW/presets/pure-preset.md +++ b/docs/zh-TW/presets/pure-preset.md @@ -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 diff --git a/docs/zh-TW/presets/tokyo-night.md b/docs/zh-TW/presets/tokyo-night.md index 5d582c6a..3b211ee9 100644 --- a/docs/zh-TW/presets/tokyo-night.md +++ b/docs/zh-TW/presets/tokyo-night.md @@ -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