docs(i18n): new Crowdin updates (#6492)

* New translations readme.md (Russian)

* New translations readme.md (French)

* New translations readme.md (French)

* New translations readme.md (Spanish)

* New translations readme.md (Spanish)

* New translations readme.md (Spanish)

* New translations readme.md (German)

* New translations readme.md (German)

* New translations readme.md (German)

* New translations readme.md (Japanese)

* New translations readme.md (Japanese)

* New translations readme.md (Korean)

* New translations readme.md (Korean)

* New translations readme.md (Norwegian)

* New translations readme.md (Polish)

* New translations readme.md (Polish)

* New translations readme.md (Russian)

* New translations readme.md (Turkish)

* New translations readme.md (Ukrainian)

* New translations readme.md (Ukrainian)

* New translations readme.md (Chinese Simplified)

* New translations readme.md (Chinese Simplified)

* New translations readme.md (Chinese Simplified)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Vietnamese)

* New translations readme.md (Vietnamese)

* New translations readme.md (Vietnamese)

* New translations readme.md (Portuguese, Brazilian)

* New translations readme.md (Portuguese, Brazilian)

* New translations readme.md (Portuguese, Brazilian)

* New translations readme.md (Indonesian)

* New translations readme.md (Indonesian)

* New translations readme.md (French)

* New translations readme.md (Bengali)

* New translations readme.md (Russian)

* New translations readme.md (Russian)

* New translations readme.md (Russian)

* New translations readme.md (Ukrainian)

* New translations readme.md (Ukrainian)

* New translations readme.md (Spanish)

* New translations readme.md (Arabic)

* New translations readme.md (German)

* New translations readme.md (Italian)

* New translations readme.md (Japanese)

* New translations readme.md (Korean)

* New translations readme.md (Dutch)

* New translations readme.md (Norwegian)

* New translations readme.md (Polish)

* New translations readme.md (Portuguese)

* New translations readme.md (Russian)

* New translations readme.md (Turkish)

* New translations readme.md (Ukrainian)

* New translations readme.md (Chinese Simplified)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Vietnamese)

* New translations readme.md (Portuguese, Brazilian)

* New translations readme.md (Indonesian)

* New translations readme.md (Bengali)

* New translations readme.md (Sorani (Kurdish))

* New translations readme.md (French)

* New translations readme.md (Russian)

* New translations readme.md (Russian)

* New translations readme.md (Portuguese, Brazilian)

* New translations readme.md (Portuguese, Brazilian)

* New translations readme.md (Chinese Simplified)

* New translations readme.md (Chinese Simplified)

* New translations readme.md (Chinese Simplified)

* New translations readme.md (Chinese Simplified)

* New translations readme.md (Chinese Simplified)

* New translations jetpack.md (Chinese Simplified)

* New translations readme.md (Chinese Simplified)

* New translations bracketed-segments.md (Chinese Simplified)

* New translations nerd-font.md (Chinese Simplified)

* New translations no-runtimes.md (Chinese Simplified)

* New translations plain-text.md (Chinese Simplified)

* New translations pure-preset.md (Chinese Simplified)

* New translations pastel-powerline.md (Chinese Simplified)

* New translations no-nerd-font.md (Chinese Simplified)

* New translations no-empty-icons.md (Chinese Simplified)

* New translations tokyo-night.md (Chinese Simplified)

* New translations gruvbox-rainbow.md (Chinese Simplified)

* New translations readme.md (French)

* New translations readme.md (Spanish)

* New translations readme.md (Arabic)

* New translations readme.md (German)

* New translations readme.md (Italian)

* New translations readme.md (Japanese)

* New translations readme.md (Korean)

* New translations readme.md (Dutch)

* New translations readme.md (Norwegian)

* New translations readme.md (Polish)

* New translations readme.md (Portuguese)

* New translations readme.md (Russian)

* New translations readme.md (Turkish)

* New translations readme.md (Ukrainian)

* New translations readme.md (Chinese Simplified)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Vietnamese)

* New translations readme.md (Portuguese, Brazilian)

* New translations readme.md (Indonesian)

* New translations readme.md (Bengali)

* New translations readme.md (Sorani (Kurdish))

* New translations readme.md (French)

* New translations readme.md (Spanish)

* New translations readme.md (Arabic)

* New translations readme.md (German)

* New translations readme.md (Italian)

* New translations readme.md (Japanese)

* New translations readme.md (Korean)

* New translations readme.md (Dutch)

* New translations readme.md (Norwegian)

* New translations readme.md (Polish)

* New translations readme.md (Portuguese)

* New translations readme.md (Russian)

* New translations readme.md (Turkish)

* New translations readme.md (Ukrainian)

* New translations readme.md (Chinese Simplified)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Vietnamese)

* New translations readme.md (Portuguese, Brazilian)

* New translations readme.md (Indonesian)

* New translations readme.md (Bengali)

* New translations readme.md (Sorani (Kurdish))

* New translations catppuccin-powerline.md (French)

* New translations catppuccin-powerline.md (Spanish)

* New translations catppuccin-powerline.md (Arabic)

* New translations catppuccin-powerline.md (German)

* New translations catppuccin-powerline.md (Italian)

* New translations catppuccin-powerline.md (Japanese)

* New translations catppuccin-powerline.md (Korean)

* New translations catppuccin-powerline.md (Dutch)

* New translations catppuccin-powerline.md (Norwegian)

* New translations catppuccin-powerline.md (Polish)

* New translations catppuccin-powerline.md (Portuguese)

* New translations catppuccin-powerline.md (Russian)

* New translations catppuccin-powerline.md (Turkish)

* New translations catppuccin-powerline.md (Ukrainian)

* New translations catppuccin-powerline.md (Chinese Simplified)

* New translations catppuccin-powerline.md (Chinese Traditional)

* New translations catppuccin-powerline.md (Vietnamese)

* New translations catppuccin-powerline.md (Portuguese, Brazilian)

* New translations catppuccin-powerline.md (Indonesian)

* New translations catppuccin-powerline.md (Bengali)

* New translations catppuccin-powerline.md (Sorani (Kurdish))

* New translations readme.md (Ukrainian)

* New translations catppuccin-powerline.md (Ukrainian)

* New translations readme.md (Ukrainian)

* New translations readme.md (French)

* New translations readme.md (Spanish)

* New translations readme.md (Arabic)

* New translations readme.md (German)

* New translations readme.md (Italian)

* New translations readme.md (Japanese)

* New translations readme.md (Korean)

* New translations readme.md (Dutch)

* New translations readme.md (Norwegian)

* New translations readme.md (Polish)

* New translations readme.md (Portuguese)

* New translations readme.md (Russian)

* New translations readme.md (Turkish)

* New translations readme.md (Ukrainian)

* New translations readme.md (Chinese Simplified)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Vietnamese)

* New translations readme.md (Portuguese, Brazilian)

* New translations readme.md (Indonesian)

* New translations readme.md (Bengali)

* New translations readme.md (Sorani (Kurdish))

* New translations readme.md (French)

* New translations readme.md (Spanish)

* New translations readme.md (Arabic)

* New translations readme.md (German)

* New translations readme.md (Italian)

* New translations readme.md (Japanese)

* New translations readme.md (Korean)

* New translations readme.md (Dutch)

* New translations readme.md (Norwegian)

* New translations readme.md (Polish)

* New translations readme.md (Portuguese)

* New translations readme.md (Russian)

* New translations readme.md (Turkish)

* New translations readme.md (Ukrainian)

* New translations readme.md (Chinese Simplified)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Vietnamese)

* New translations readme.md (Portuguese, Brazilian)

* New translations readme.md (Indonesian)

* New translations readme.md (Bengali)

* New translations readme.md (Sorani (Kurdish))

* New translations readme.md (French)

* New translations readme.md (Spanish)

* New translations readme.md (Japanese)

* New translations readme.md (Ukrainian)

* New translations readme.md (Portuguese, Brazilian)

* New translations readme.md (Ukrainian)

* New translations readme.md (Chinese Simplified)

* New translations readme.md (Chinese Simplified)

* New translations readme.md (Chinese Simplified)

* New translations readme.md (Chinese Simplified)

* New translations readme.md (Vietnamese)

* New translations readme.md (French)

* New translations readme.md (Spanish)

* New translations readme.md (Arabic)

* New translations readme.md (German)

* New translations readme.md (Italian)

* New translations readme.md (Japanese)

* New translations readme.md (Korean)

* New translations readme.md (Dutch)

* New translations readme.md (Norwegian)

* New translations readme.md (Polish)

* New translations readme.md (Portuguese)

* New translations readme.md (Russian)

* New translations readme.md (Turkish)

* New translations readme.md (Ukrainian)

* New translations readme.md (Chinese Simplified)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Vietnamese)

* New translations readme.md (Portuguese, Brazilian)

* New translations readme.md (Indonesian)

* New translations readme.md (Bengali)

* New translations readme.md (Sorani (Kurdish))

* New translations readme.md (French)

* New translations readme.md (Spanish)

* New translations readme.md (Arabic)

* New translations readme.md (German)

* New translations readme.md (Italian)

* New translations readme.md (Japanese)

* New translations readme.md (Korean)

* New translations readme.md (Dutch)

* New translations readme.md (Norwegian)

* New translations readme.md (Polish)

* New translations readme.md (Portuguese)

* New translations readme.md (Russian)

* New translations readme.md (Turkish)

* New translations readme.md (Ukrainian)

* New translations readme.md (Chinese Simplified)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Vietnamese)

* New translations readme.md (Portuguese, Brazilian)

* New translations readme.md (Indonesian)

* New translations readme.md (Bengali)

* New translations readme.md (Sorani (Kurdish))

* New translations readme.md (Japanese)

* New translations bracketed-segments.md (Japanese)

* New translations catppuccin-powerline.md (Japanese)

* New translations readme.md (Japanese)

* New translations readme.md (Ukrainian)
This commit is contained in:
Matan Kushner
2025-04-28 00:53:07 +09:00
committed by GitHub
parent 661c8a2c1c
commit ed87dc5750
114 changed files with 5257 additions and 1288 deletions
+168 -15
View File
@@ -328,6 +328,7 @@ $azure\
$nats\
$direnv\
$env_var\
$mise\
$crystal\
$custom\
$sudo\
@@ -339,6 +340,7 @@ $time\
$status\
$os\
$container\
$netns\
$shell\
$character"""
```
@@ -618,7 +620,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
*: This variable can only be used as a part of a style string
### Examples
### مثال
#### Customize the format
@@ -629,15 +631,6 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
format = 'via [🍔 $version](bold green) '
```
#### Replace Node.js
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']
```
## C
The `c` module shows some information about your C compiler. By default the module will be shown if the current directory contains a `.c` or `.h` file.
@@ -684,6 +677,53 @@ If a C compiler is not supported by this module, you can request it by [raising
format = 'via [$name $version]($style)'
```
## CPP
The `cpp` module shows some information about your `C++` compiler. By default, the module will be shown if the current directory contains a `.cpp`, `.hpp`, or other `C++`-related files.
### Options
| Option | الافتراضي | الوصف |
| ------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version(-$name) )]($style)'` | The format string for the module. |
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
| `symbol` | `'C++ '` | The symbol used before displaying the compiler details |
| `detect_extensions` | `['cpp', 'cc', 'cxx', 'c++', 'hpp', 'hh', 'hxx', 'h++', 'tcc']` | Which extensions should trigger this module. |
| `detect_files` | `[]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. |
| `commands` | `[ [ 'c++', '--version' ], [ 'g++', '--version' ], [ 'clang++', '--version' ] ]` | How to detect what the compiler is |
| `style` | `'bold 149'` | The style for the module. |
| `disabled` | `true` | Disables the `cpp` module. |
### Variables
| Variable | مثال | الوصف |
| -------- | ------- | ------------------------------------ |
| name | clang++ | The name of the compiler |
| version | 13.0.0 | The version of the compiler |
| symbol | | Mirrors the value of option `symbol` |
| style | | Mirrors the value of option `style` |
NB that `version` is not in the default format.
### Commands
The `commands` option accepts a list of commands to determine the compiler version and name.
Each command is represented as a list of the executable name, followed by its arguments, usually something like `['mycpp', '--version']`. Starship will try executing each command until it gets a result on STDOUT.
If a C++ compiler is not supported by this module, you can request it by [raising an issue on GitHub](https://github.com/starship/starship/).
### مثال
```toml
# ~/.config/starship.toml
[cpp]
disabled = false
format = 'via [$name $version]($style)'
```
## Character
The `character` module shows a character (usually an arrow) beside where the text is entered in your terminal.
@@ -874,6 +914,7 @@ This does not suppress conda's own prompt modifier, you may want to run `conda c
| `style` | `'bold green'` | The style for the module. |
| `format` | `'via [$symbol$environment]($style) '` | The format for the module. |
| `ignore_base` | `true` | Ignores `base` environment when activated. |
| `detect_env_vars` | `["!PIXI_ENVIRONMENT_NAME"]` | Which environment variable(s) should trigger this module. If it's a pixi environment, this module is not being triggered by default. |
| `disabled` | `false` | Disables the `conda` module. |
### Variables
@@ -1876,7 +1917,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
### Options
| Option | الافتراضي | الوصف |
| ------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| -------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | The default format for `git_status` |
| `conflicted` | `'='` | This branch has merge conflicts. |
| `ahead` | `'⇡'` | The format of `ahead` |
@@ -1894,6 +1935,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
| `ignore_submodules` | `false` | Ignore changes to submodules. |
| `disabled` | `false` | Disables the `git_status` module. |
| `windows_starship` | | Use this (Linux) path to a Windows Starship executable to render `git_status` when on Windows paths in WSL. |
| `use_git_executable` | `false` | Do not use `gitoxide` for computing the status, but use the `git` executable instead. |
### Variables
@@ -2817,6 +2859,40 @@ truncation_length = 4
truncation_symbol = ''
```
## Mise
The `mise` module shows the current mise health as reported by running `mise doctor`.
### Options
| Option | الافتراضي | الوصف |
| ------------------ | -------------------------------- | ------------------------------------------------ |
| `symbol` | `'mise '` | The symbol used before displaying _mise_ health. |
| `style` | `'bold purple'` | The style for the module. |
| `format` | `'on [$symbol$health]($style) '` | The format for the module. |
| `healthy_symbol` | `healthy` | The message displayed when _mise_ is healthy. |
| `unhealthy_symbol` | `unhealthy` | The message displayed when _mise_ is unhealthy. |
| `disabled` | `true` | Disables the `mise` module. |
### Variables
| Variable | مثال | الوصف |
| --------- | --------- | ------------------------------------ |
| health | `healthy` | The health of _mise_ |
| 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
[mise]
health = 'ready'
```
## Mojo
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
@@ -2881,6 +2957,37 @@ format = '[$symbol]($style)'
style = 'bold purple'
```
## Network Namespace
The `netns` module shows the current network namespace. This uses `ip netns identify` to get the network namespace, so only network namespaces mounted at `/var/run/netns` will be detected.
### Options
| Option | الافتراضي | الوصف |
| ---------- | --------------------------------- | ----------------------------------------------------------------- |
| `format` | `'[$symbol \[$name\]]($style)'` | The format for the module. |
| `symbol` | `'🛜 '` | The symbol used before the network namespace (defaults to empty). |
| `style` | `'blue bold dimmed'` | The style for the module. |
| `disabled` | `false` | Disables the `netns` module. |
### Variables
| Variable | مثال | الوصف |
| --------- | ---------- | ----------------------------------------- |
| name | `my-netns` | The name of the current network namespace |
| symbol | | Mirrors the value of option `symbol` |
| style\* | | Mirrors the value of option `style` |
### مثال
```toml
# ~/.config/starship.toml
[netns]
style = 'bold yellow'
symbol = '🌐 '
```
## Nim
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). By default the module will be shown if any of the following conditions are met:
@@ -2975,6 +3082,8 @@ The `nodejs` module shows the currently installed version of [Node.js](https://n
- The current directory contains a file with the `.js`, `.mjs` or `.cjs` extension
- The current directory contains a file with the `.ts`, `.mts` or `.cts` extension
Additionally, the module will be hidden by default if the directory contains a `bunfig.toml`, `bun.lock`, or `bun.lockb` file, overriding the above conditions.
### Options
| Option | الافتراضي | الوصف |
@@ -3202,6 +3311,7 @@ Amazon = "🙂 "
Android = "🤖 "
Arch = "🎗️ "
Artix = "🎗️ "
Bluefin = "🐟 "
CachyOS = "🎗️ "
CentOS = "💠 "
Debian = "🌀 "
@@ -3280,6 +3390,7 @@ Arch = "Arch is the best! "
The `package` module is shown when the current directory is the repository for a package, and shows its current version. The module currently supports `npm`, `nimble`, `cargo`, `poetry`, `python`, `composer`, `gradle`, `julia`, `mix`, `helm`, `shards`, `daml` and `dart` packages.
- [**npm**](https://docs.npmjs.com/cli/commands/npm) The `npm` package version is extracted from the `package.json` present in the current directory
- [**JSR**](https://jsr.io/) The `jsr` package version is extracted from the `jsr.json`/`jsr.jsonc` or `deno.json`/`deno.jsonc` present in the current directory
- [**Cargo**](https://doc.rust-lang.org/cargo/) The `cargo` package version is extracted from the `Cargo.toml` present in the current directory
- [**Nimble**](https://github.com/nim-lang/nimble) - The `nimble` package version is extracted from the `*.nimble` file present in the current directory with the `nimble dump` command
- [**Poetry**](https://python-poetry.org/) The `poetry` package version is extracted from the `pyproject.toml` present in the current directory
@@ -3424,6 +3535,49 @@ The `pijul_channel` module shows the active channel of the repo in your current
| `truncation_symbol` | `'…'` | The symbol used to indicate a branch name was truncated. |
| `disabled` | `true` | Disables the `pijul` module. |
## Pixi
The `pixi` module shows the installed [pixi](https://pixi.sh) version as well as the activated environment, if `$PIXI_ENVIRONMENT_NAME` is set.
::: tip
This does not suppress pixi's own prompt modifier, you may want to run `pixi config set change-ps1 false`.
:::
### Options
| Option | الافتراضي | الوصف |
| -------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )(\($environment\) )]($style)'` | The format for the module. |
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch`. |
| `symbol` | `'🧚 '` | The symbol used before the environment name. |
| `style` | `'yellow bold' | The style for the module. |
| `show_default_environment` | `true` | Whether to indicate that the `default` environment of your project is activated. |
| `pixi_binary` | `['pixi']` | Configures the pixi binary that Starship should execute when getting the version. |
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
| `detect_files` | `['pixi.toml']` | Which filenames should trigger this module. |
| `detect_folders` | `['.pixi']` | Which folders should trigger this module. |
| `disabled` | `false` | Disables the `pixi` module. |
### Variables
| Variable | مثال | الوصف |
| ----------- | --------- | ------------------------------------ |
| version | `v0.33.0` | The version of `pixi` |
| environment | `py311` | The current pixi environment |
| symbol | | Mirrors the value of option `symbol` |
| style | | Mirrors the value of option `style` |
### مثال
```toml
# ~/.config/starship.toml
[pixi]
format = '[$symbol$environment](yellow) '
```
## Pulumi
The `pulumi` module shows the current username, selected [Pulumi Stack](https://www.pulumi.com/docs/intro/concepts/stack/), and version.
@@ -3538,7 +3692,6 @@ 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
@@ -3546,16 +3699,16 @@ By default, the module will be shown if any of the following conditions are met:
### 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. |
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should execute 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_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. |
+2
View File
@@ -229,10 +229,12 @@ curl -sS https://starship.rs/install.sh | sh
| Alpine Linux 3.13+ | [Alpine Linux Packages](https://pkgs.alpinelinux.org/packages?name=starship) | `apk add starship` |
| Arch Linux | [Arch Linux Extra](https://archlinux.org/packages/extra/x86_64/starship) | `pacman -S starship` |
| CentOS +7 | [Copr](https://copr.fedorainfracloud.org/coprs/atim/starship) | `dnf copr enable atim/starship` <br /> `dnf install starship` |
| Debian 13+ | [Debian Main](https://sources.debian.org/src/starship/1.22.1-1/) | `apt install starship` |
| Gentoo | [Gentoo Packages](https://packages.gentoo.org/packages/app-shells/starship) | `emerge app-shells/starship` |
| Manjaro | | `pacman -S starship` |
| NixOS | [nixpkgs](https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/misc/starship/default.nix) | `nix-env -iA nixpkgs.starship` |
| openSUSE | [OSS](https://software.opensuse.org/package/starship) | `zypper in starship` |
| Ubuntu 25.04+ | [Ubuntu Universe](https://packages.ubuntu.com/source/plucky/starship) | `apt install starship` |
| Void Linux | [Void Linux Packages](https://github.com/void-linux/void-packages/tree/master/srcpkgs/starship) | `xbps-install -S starship` |
</details>
+6
View File
@@ -75,3 +75,9 @@ This preset is heavily inspired by [Pastel Powerline](./pastel-powerline.md), an
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.
[![Screenshot of Jetpack preset](/presets/img/jetpack.png "Click to view Jetpack preset")](./jetpack)
## [Catppuccin Powerline](./catppuccin-powerline.md)
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
[![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png "Click to view Catppuccin Powerline preset")](./catppuccin-powerline)
@@ -0,0 +1,28 @@
[Return to Presets](./README.md#catppuccin-powerline)
# Catppuccin Powerline Preset
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png)
### المتطلبات الأساسية
- A [Nerd Font](https://www.nerdfonts.com/) installed and enabled in your terminal
### Configuration
```sh
starship preset catppuccin-powerline -o ~/.config/starship.toml
```
By default this preset uses the Mocha flavour of Catppucin, but you can specify any of the flavours by modifying the value of `palette`:
- `catppuccin_mocha`
- `catppuccin_frappe`
- `catppuccin_macchiato`
- `catppucin_latte`
[Click to download TOML](/presets/toml/catppuccin-powerline.toml)
<<< @/public/presets/toml/catppuccin-powerline.toml
+168 -15
View File
@@ -328,6 +328,7 @@ $azure\
$nats\
$direnv\
$env_var\
$mise\
$crystal\
$custom\
$sudo\
@@ -339,6 +340,7 @@ $time\
$status\
$os\
$container\
$netns\
$shell\
$character"""
```
@@ -618,7 +620,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
*: This variable can only be used as a part of a style string
### Examples
### Example
#### Customize the format
@@ -629,15 +631,6 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
format = 'via [🍔 $version](bold green) '
```
#### Replace Node.js
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']
```
## C
The `c` module shows some information about your C compiler. By default the module will be shown if the current directory contains a `.c` or `.h` file.
@@ -684,6 +677,53 @@ If a C compiler is not supported by this module, you can request it by [raising
format = 'via [$name $version]($style)'
```
## CPP
The `cpp` module shows some information about your `C++` compiler. By default, the module will be shown if the current directory contains a `.cpp`, `.hpp`, or other `C++`-related files.
### Options
| Option | Default | Description |
| ------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version(-$name) )]($style)'` | The format string for the module. |
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
| `symbol` | `'C++ '` | The symbol used before displaying the compiler details |
| `detect_extensions` | `['cpp', 'cc', 'cxx', 'c++', 'hpp', 'hh', 'hxx', 'h++', 'tcc']` | Which extensions should trigger this module. |
| `detect_files` | `[]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. |
| `commands` | `[ [ 'c++', '--version' ], [ 'g++', '--version' ], [ 'clang++', '--version' ] ]` | How to detect what the compiler is |
| `style` | `'bold 149'` | The style for the module. |
| `disabled` | `true` | Disables the `cpp` module. |
### Variables
| Variable | Example | Description |
| -------- | ------- | ------------------------------------ |
| name | clang++ | The name of the compiler |
| version | 13.0.0 | The version of the compiler |
| symbol | | Mirrors the value of option `symbol` |
| style | | Mirrors the value of option `style` |
NB that `version` is not in the default format.
### Commands
The `commands` option accepts a list of commands to determine the compiler version and name.
Each command is represented as a list of the executable name, followed by its arguments, usually something like `['mycpp', '--version']`. Starship will try executing each command until it gets a result on STDOUT.
If a C++ compiler is not supported by this module, you can request it by [raising an issue on GitHub](https://github.com/starship/starship/).
### Example
```toml
# ~/.config/starship.toml
[cpp]
disabled = false
format = 'via [$name $version]($style)'
```
## Character
The `character` module shows a character (usually an arrow) beside where the text is entered in your terminal.
@@ -874,6 +914,7 @@ This does not suppress conda's own prompt modifier, you may want to run `conda c
| `style` | `'bold green'` | The style for the module. |
| `format` | `'via [$symbol$environment]($style) '` | The format for the module. |
| `ignore_base` | `true` | Ignores `base` environment when activated. |
| `detect_env_vars` | `["!PIXI_ENVIRONMENT_NAME"]` | Which environment variable(s) should trigger this module. If it's a pixi environment, this module is not being triggered by default. |
| `disabled` | `false` | Disables the `conda` module. |
### Variables
@@ -1876,7 +1917,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
### Options
| Option | Default | Description |
| ------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| -------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | The default format for `git_status` |
| `conflicted` | `'='` | This branch has merge conflicts. |
| `ahead` | `'⇡'` | The format of `ahead` |
@@ -1894,6 +1935,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
| `ignore_submodules` | `false` | Ignore changes to submodules. |
| `disabled` | `false` | Disables the `git_status` module. |
| `windows_starship` | | Use this (Linux) path to a Windows Starship executable to render `git_status` when on Windows paths in WSL. |
| `use_git_executable` | `false` | Do not use `gitoxide` for computing the status, but use the `git` executable instead. |
### Variables
@@ -2817,6 +2859,40 @@ truncation_length = 4
truncation_symbol = ''
```
## Mise
The `mise` module shows the current mise health as reported by running `mise doctor`.
### Options
| Option | Default | Description |
| ------------------ | -------------------------------- | ------------------------------------------------ |
| `symbol` | `'mise '` | The symbol used before displaying _mise_ health. |
| `style` | `'bold purple'` | The style for the module. |
| `format` | `'on [$symbol$health]($style) '` | The format for the module. |
| `healthy_symbol` | `healthy` | The message displayed when _mise_ is healthy. |
| `unhealthy_symbol` | `unhealthy` | The message displayed when _mise_ is unhealthy. |
| `disabled` | `true` | Disables the `mise` module. |
### Variables
| Variable | Example | Description |
| --------- | --------- | ------------------------------------ |
| health | `healthy` | The health of _mise_ |
| 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
[mise]
health = 'ready'
```
## Mojo
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
@@ -2881,6 +2957,37 @@ format = '[$symbol]($style)'
style = 'bold purple'
```
## Network Namespace
The `netns` module shows the current network namespace. This uses `ip netns identify` to get the network namespace, so only network namespaces mounted at `/var/run/netns` will be detected.
### Options
| Option | Default | Description |
| ---------- | --------------------------------- | ----------------------------------------------------------------- |
| `format` | `'[$symbol \[$name\]]($style)'` | The format for the module. |
| `symbol` | `'🛜 '` | The symbol used before the network namespace (defaults to empty). |
| `style` | `'blue bold dimmed'` | The style for the module. |
| `disabled` | `false` | Disables the `netns` module. |
### Variables
| Variable | Example | Description |
| --------- | ---------- | ----------------------------------------- |
| name | `my-netns` | The name of the current network namespace |
| symbol | | Mirrors the value of option `symbol` |
| style\* | | Mirrors the value of option `style` |
### Example
```toml
# ~/.config/starship.toml
[netns]
style = 'bold yellow'
symbol = '🌐 '
```
## Nim
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). By default the module will be shown if any of the following conditions are met:
@@ -2975,6 +3082,8 @@ The `nodejs` module shows the currently installed version of [Node.js](https://n
- The current directory contains a file with the `.js`, `.mjs` or `.cjs` extension
- The current directory contains a file with the `.ts`, `.mts` or `.cts` extension
Additionally, the module will be hidden by default if the directory contains a `bunfig.toml`, `bun.lock`, or `bun.lockb` file, overriding the above conditions.
### Options
| Option | Default | Description |
@@ -3202,6 +3311,7 @@ Amazon = "🙂 "
Android = "🤖 "
Arch = "🎗️ "
Artix = "🎗️ "
Bluefin = "🐟 "
CachyOS = "🎗️ "
CentOS = "💠 "
Debian = "🌀 "
@@ -3280,6 +3390,7 @@ Arch = "Arch is the best! "
The `package` module is shown when the current directory is the repository for a package, and shows its current version. The module currently supports `npm`, `nimble`, `cargo`, `poetry`, `python`, `composer`, `gradle`, `julia`, `mix`, `helm`, `shards`, `daml` and `dart` packages.
- [**npm**](https://docs.npmjs.com/cli/commands/npm) The `npm` package version is extracted from the `package.json` present in the current directory
- [**JSR**](https://jsr.io/) The `jsr` package version is extracted from the `jsr.json`/`jsr.jsonc` or `deno.json`/`deno.jsonc` present in the current directory
- [**Cargo**](https://doc.rust-lang.org/cargo/) The `cargo` package version is extracted from the `Cargo.toml` present in the current directory
- [**Nimble**](https://github.com/nim-lang/nimble) - The `nimble` package version is extracted from the `*.nimble` file present in the current directory with the `nimble dump` command
- [**Poetry**](https://python-poetry.org/) The `poetry` package version is extracted from the `pyproject.toml` present in the current directory
@@ -3424,6 +3535,49 @@ The `pijul_channel` module shows the active channel of the repo in your current
| `truncation_symbol` | `'…'` | The symbol used to indicate a branch name was truncated. |
| `disabled` | `true` | Disables the `pijul` module. |
## Pixi
The `pixi` module shows the installed [pixi](https://pixi.sh) version as well as the activated environment, if `$PIXI_ENVIRONMENT_NAME` is set.
::: tip
This does not suppress pixi's own prompt modifier, you may want to run `pixi config set change-ps1 false`.
:::
### Options
| Option | Default | Description |
| -------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )(\($environment\) )]($style)'` | The format for the module. |
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch`. |
| `symbol` | `'🧚 '` | The symbol used before the environment name. |
| `style` | `'yellow bold' | The style for the module. |
| `show_default_environment` | `true` | Whether to indicate that the `default` environment of your project is activated. |
| `pixi_binary` | `['pixi']` | Configures the pixi binary that Starship should execute when getting the version. |
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
| `detect_files` | `['pixi.toml']` | Which filenames should trigger this module. |
| `detect_folders` | `['.pixi']` | Which folders should trigger this module. |
| `disabled` | `false` | Disables the `pixi` module. |
### Variables
| Variable | Example | Description |
| ----------- | --------- | ------------------------------------ |
| version | `v0.33.0` | The version of `pixi` |
| environment | `py311` | The current pixi environment |
| symbol | | Mirrors the value of option `symbol` |
| style | | Mirrors the value of option `style` |
### Example
```toml
# ~/.config/starship.toml
[pixi]
format = '[$symbol$environment](yellow) '
```
## Pulumi
The `pulumi` module shows the current username, selected [Pulumi Stack](https://www.pulumi.com/docs/intro/concepts/stack/), and version.
@@ -3538,7 +3692,6 @@ 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
@@ -3546,16 +3699,16 @@ By default, the module will be shown if any of the following conditions are met:
### 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. |
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should execute 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_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. |
+3 -1
View File
@@ -229,10 +229,12 @@ curl -sS https://starship.rs/install.sh | sh
| Alpine Linux 3.13+ | [Alpine Linux Packages](https://pkgs.alpinelinux.org/packages?name=starship) | `apk add starship` |
| Arch Linux | [Arch Linux Extra](https://archlinux.org/packages/extra/x86_64/starship) | `pacman -S starship` |
| CentOS 7+ | [Copr](https://copr.fedorainfracloud.org/coprs/atim/starship) | `dnf copr enable atim/starship` <br /> `dnf install starship` |
| Debian 13+ | [Debian Main](https://sources.debian.org/src/starship/1.22.1-1/) | `apt install starship` |
| Gentoo | [Gentoo Packages](https://packages.gentoo.org/packages/app-shells/starship) | `emerge app-shells/starship` |
| Manjaro | | `pacman -S starship` |
| NixOS | [nixpkgs](https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/misc/starship/default.nix) | `nix-env -iA nixpkgs.starship` |
| openSUSE | [OSS](https://software.opensuse.org/package/starship) | `zypper in starship` |
| Ubuntu 25.04+ | [Ubuntu Universe](https://packages.ubuntu.com/source/plucky/starship) | `apt install starship` |
| Void Linux | [Void Linux Packages](https://github.com/void-linux/void-packages/tree/master/srcpkgs/starship) | `xbps-install -S starship` |
</details>
@@ -345,7 +347,7 @@ mkdir ($nu.data-dir | path join "vendor/autoload")
starship init nu | save -f ($nu.data-dir | path join "vendor/autoload/starship.nu")
```
Note: Only Nushell v0.96+ is supported
বিঃদ্রঃ শুধুমাত্র Nushell v0.96+ কাজ করবে ।
</details>
+6
View File
@@ -75,3 +75,9 @@ This preset is heavily inspired by [Pastel Powerline](./pastel-powerline.md), an
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.
[![Screenshot of Jetpack preset](/presets/img/jetpack.png "Click to view Jetpack preset")](./jetpack)
## [Catppuccin Powerline](./catppuccin-powerline.md)
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
[![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png "Click to view Catppuccin Powerline preset")](./catppuccin-powerline)
@@ -0,0 +1,28 @@
[Return to Presets](./README.md#catppuccin-powerline)
# Catppuccin Powerline Preset
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png)
### পূর্বশর্ত
- A [Nerd Font](https://www.nerdfonts.com/) installed and enabled in your terminal
### Configuration
```sh
starship preset catppuccin-powerline -o ~/.config/starship.toml
```
By default this preset uses the Mocha flavour of Catppucin, but you can specify any of the flavours by modifying the value of `palette`:
- `catppuccin_mocha`
- `catppuccin_frappe`
- `catppuccin_macchiato`
- `catppucin_latte`
[Click to download TOML](/presets/toml/catppuccin-powerline.toml)
<<< @/public/presets/toml/catppuccin-powerline.toml
+168 -15
View File
@@ -328,6 +328,7 @@ $azure\
$nats\
$direnv\
$env_var\
$mise\
$crystal\
$custom\
$sudo\
@@ -339,6 +340,7 @@ $time\
$status\
$os\
$container\
$netns\
$shell\
$character"""
```
@@ -618,7 +620,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
*: This variable can only be used as a part of a style string
### Examples
### نموونە
#### Customize the format
@@ -629,15 +631,6 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
format = 'via [🍔 $version](bold green) '
```
#### Replace Node.js
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']
```
## C
The `c` module shows some information about your C compiler. By default the module will be shown if the current directory contains a `.c` or `.h` file.
@@ -684,6 +677,53 @@ If a C compiler is not supported by this module, you can request it by [raising
format = 'via [$name $version]($style)'
```
## CPP
The `cpp` module shows some information about your `C++` compiler. By default, the module will be shown if the current directory contains a `.cpp`, `.hpp`, or other `C++`-related files.
### Options
| Option | Default | Description |
| ------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version(-$name) )]($style)'` | The format string for the module. |
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
| `symbol` | `'C++ '` | The symbol used before displaying the compiler details |
| `detect_extensions` | `['cpp', 'cc', 'cxx', 'c++', 'hpp', 'hh', 'hxx', 'h++', 'tcc']` | Which extensions should trigger this module. |
| `detect_files` | `[]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. |
| `commands` | `[ [ 'c++', '--version' ], [ 'g++', '--version' ], [ 'clang++', '--version' ] ]` | How to detect what the compiler is |
| `style` | `'bold 149'` | The style for the module. |
| `disabled` | `true` | Disables the `cpp` module. |
### Variables
| گۆڕاو | نموونە | Description |
| ------- | ------- | ------------------------------------ |
| name | clang++ | The name of the compiler |
| version | 13.0.0 | The version of the compiler |
| symbol | | Mirrors the value of option `symbol` |
| style | | Mirrors the value of option `style` |
NB that `version` is not in the default format.
### Commands
The `commands` option accepts a list of commands to determine the compiler version and name.
Each command is represented as a list of the executable name, followed by its arguments, usually something like `['mycpp', '--version']`. Starship will try executing each command until it gets a result on STDOUT.
If a C++ compiler is not supported by this module, you can request it by [raising an issue on GitHub](https://github.com/starship/starship/).
### نموونە
```toml
# ~/.config/starship.toml
[cpp]
disabled = false
format = 'via [$name $version]($style)'
```
## Character
The `character` module shows a character (usually an arrow) beside where the text is entered in your terminal.
@@ -874,6 +914,7 @@ This does not suppress conda's own prompt modifier, you may want to run `conda c
| `style` | `'bold green'` | The style for the module. |
| `format` | `'via [$symbol$environment]($style) '` | The format for the module. |
| `ignore_base` | `true` | Ignores `base` environment when activated. |
| `detect_env_vars` | `["!PIXI_ENVIRONMENT_NAME"]` | Which environment variable(s) should trigger this module. If it's a pixi environment, this module is not being triggered by default. |
| `disabled` | `false` | Disables the `conda` module. |
### Variables
@@ -1876,7 +1917,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
### Options
| Option | Default | Description |
| ------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| -------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | The default format for `git_status` |
| `conflicted` | `'='` | This branch has merge conflicts. |
| `ahead` | `'⇡'` | The format of `ahead` |
@@ -1894,6 +1935,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
| `ignore_submodules` | `false` | Ignore changes to submodules. |
| `disabled` | `false` | Disables the `git_status` module. |
| `windows_starship` | | Use this (Linux) path to a Windows Starship executable to render `git_status` when on Windows paths in WSL. |
| `use_git_executable` | `false` | Do not use `gitoxide` for computing the status, but use the `git` executable instead. |
### Variables
@@ -2817,6 +2859,40 @@ truncation_length = 4
truncation_symbol = ''
```
## Mise
The `mise` module shows the current mise health as reported by running `mise doctor`.
### Options
| Option | Default | Description |
| ------------------ | -------------------------------- | ------------------------------------------------ |
| `symbol` | `'mise '` | The symbol used before displaying _mise_ health. |
| `style` | `'bold purple'` | The style for the module. |
| `format` | `'on [$symbol$health]($style) '` | The format for the module. |
| `healthy_symbol` | `healthy` | The message displayed when _mise_ is healthy. |
| `unhealthy_symbol` | `unhealthy` | The message displayed when _mise_ is unhealthy. |
| `disabled` | `true` | Disables the `mise` module. |
### Variables
| گۆڕاو | نموونە | Description |
| --------- | --------- | ------------------------------------ |
| health | `healthy` | The health of _mise_ |
| 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
[mise]
health = 'ready'
```
## Mojo
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
@@ -2881,6 +2957,37 @@ format = '[$symbol]($style)'
style = 'bold purple'
```
## Network Namespace
The `netns` module shows the current network namespace. This uses `ip netns identify` to get the network namespace, so only network namespaces mounted at `/var/run/netns` will be detected.
### Options
| Option | Default | Description |
| ---------- | --------------------------------- | ----------------------------------------------------------------- |
| `format` | `'[$symbol \[$name\]]($style)'` | The format for the module. |
| `symbol` | `'🛜 '` | The symbol used before the network namespace (defaults to empty). |
| `style` | `'blue bold dimmed'` | The style for the module. |
| `disabled` | `false` | Disables the `netns` module. |
### Variables
| گۆڕاو | نموونە | Description |
| --------- | ---------- | ----------------------------------------- |
| name | `my-netns` | The name of the current network namespace |
| symbol | | Mirrors the value of option `symbol` |
| style\* | | Mirrors the value of option `style` |
### نموونە
```toml
# ~/.config/starship.toml
[netns]
style = 'bold yellow'
symbol = '🌐 '
```
## Nim
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). By default the module will be shown if any of the following conditions are met:
@@ -2975,6 +3082,8 @@ The `nodejs` module shows the currently installed version of [Node.js](https://n
- The current directory contains a file with the `.js`, `.mjs` or `.cjs` extension
- The current directory contains a file with the `.ts`, `.mts` or `.cts` extension
Additionally, the module will be hidden by default if the directory contains a `bunfig.toml`, `bun.lock`, or `bun.lockb` file, overriding the above conditions.
### Options
| Option | Default | Description |
@@ -3202,6 +3311,7 @@ Amazon = "🙂 "
Android = "🤖 "
Arch = "🎗️ "
Artix = "🎗️ "
Bluefin = "🐟 "
CachyOS = "🎗️ "
CentOS = "💠 "
Debian = "🌀 "
@@ -3280,6 +3390,7 @@ Arch = "Arch is the best! "
The `package` module is shown when the current directory is the repository for a package, and shows its current version. The module currently supports `npm`, `nimble`, `cargo`, `poetry`, `python`, `composer`, `gradle`, `julia`, `mix`, `helm`, `shards`, `daml` and `dart` packages.
- [**npm**](https://docs.npmjs.com/cli/commands/npm) The `npm` package version is extracted from the `package.json` present in the current directory
- [**JSR**](https://jsr.io/) The `jsr` package version is extracted from the `jsr.json`/`jsr.jsonc` or `deno.json`/`deno.jsonc` present in the current directory
- [**Cargo**](https://doc.rust-lang.org/cargo/) The `cargo` package version is extracted from the `Cargo.toml` present in the current directory
- [**Nimble**](https://github.com/nim-lang/nimble) - The `nimble` package version is extracted from the `*.nimble` file present in the current directory with the `nimble dump` command
- [**Poetry**](https://python-poetry.org/) The `poetry` package version is extracted from the `pyproject.toml` present in the current directory
@@ -3424,6 +3535,49 @@ The `pijul_channel` module shows the active channel of the repo in your current
| `truncation_symbol` | `'…'` | The symbol used to indicate a branch name was truncated. |
| `disabled` | `true` | Disables the `pijul` module. |
## Pixi
The `pixi` module shows the installed [pixi](https://pixi.sh) version as well as the activated environment, if `$PIXI_ENVIRONMENT_NAME` is set.
::: tip
This does not suppress pixi's own prompt modifier, you may want to run `pixi config set change-ps1 false`.
:::
### Options
| Option | Default | Description |
| -------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )(\($environment\) )]($style)'` | The format for the module. |
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch`. |
| `symbol` | `'🧚 '` | The symbol used before the environment name. |
| `style` | `'yellow bold' | The style for the module. |
| `show_default_environment` | `true` | Whether to indicate that the `default` environment of your project is activated. |
| `pixi_binary` | `['pixi']` | Configures the pixi binary that Starship should execute when getting the version. |
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
| `detect_files` | `['pixi.toml']` | Which filenames should trigger this module. |
| `detect_folders` | `['.pixi']` | Which folders should trigger this module. |
| `disabled` | `false` | Disables the `pixi` module. |
### Variables
| گۆڕاو | نموونە | Description |
| ----------- | --------- | ------------------------------------ |
| version | `v0.33.0` | The version of `pixi` |
| environment | `py311` | The current pixi environment |
| symbol | | Mirrors the value of option `symbol` |
| style | | Mirrors the value of option `style` |
### نموونە
```toml
# ~/.config/starship.toml
[pixi]
format = '[$symbol$environment](yellow) '
```
## Pulumi
The `pulumi` module shows the current username, selected [Pulumi Stack](https://www.pulumi.com/docs/intro/concepts/stack/), and version.
@@ -3538,7 +3692,6 @@ 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
@@ -3546,16 +3699,16 @@ By default, the module will be shown if any of the following conditions are met:
### 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. |
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should execute 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_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. |
+2
View File
@@ -225,10 +225,12 @@ Alternatively, install Starship using any of the following package managers:
| Alpine Linux 3.13+ | [Alpine Linux Packages](https://pkgs.alpinelinux.org/packages?name=starship) | `apk add starship` |
| Arch Linux | [Arch Linux Extra](https://archlinux.org/packages/extra/x86_64/starship) | `pacman -S starship` |
| CentOS 7+ | [Copr](https://copr.fedorainfracloud.org/coprs/atim/starship) | `dnf copr enable atim/starship` <br /> `dnf install starship` |
| Debian 13+ | [Debian Main](https://sources.debian.org/src/starship/1.22.1-1/) | `apt install starship` |
| Gentoo | [Gentoo Packages](https://packages.gentoo.org/packages/app-shells/starship) | `emerge app-shells/starship` |
| Manjaro | | `pacman -S starship` |
| NixOS | [nixpkgs](https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/misc/starship/default.nix) | `nix-env -iA nixpkgs.starship` |
| openSUSE | [OSS](https://software.opensuse.org/package/starship) | `zypper in starship` |
| Ubuntu 25.04+ | [Ubuntu Universe](https://packages.ubuntu.com/source/plucky/starship) | `apt install starship` |
| Void Linux | [Void Linux Packages](https://github.com/void-linux/void-packages/tree/master/srcpkgs/starship) | `xbps-install -S starship` |
</details>
+6
View File
@@ -75,3 +75,9 @@ This preset is heavily inspired by [Pastel Powerline](./pastel-powerline.md), an
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.
[![Screenshot of Jetpack preset](/presets/img/jetpack.png "Click to view Jetpack preset")](./jetpack)
## [Catppuccin Powerline](./catppuccin-powerline.md)
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
[![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png "Click to view Catppuccin Powerline preset")](./catppuccin-powerline)
@@ -0,0 +1,28 @@
[Return to Presets](./README.md#catppuccin-powerline)
# Catppuccin Powerline Preset
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png)
### پێشمەرجەکان
- A [Nerd Font](https://www.nerdfonts.com/) installed and enabled in your terminal
### ڕێکخستن
```sh
starship preset catppuccin-powerline -o ~/.config/starship.toml
```
By default this preset uses the Mocha flavour of Catppucin, but you can specify any of the flavours by modifying the value of `palette`:
- `catppuccin_mocha`
- `catppuccin_frappe`
- `catppuccin_macchiato`
- `catppucin_latte`
[Click to download TOML](/presets/toml/catppuccin-powerline.toml)
<<< @/public/presets/toml/catppuccin-powerline.toml
+1 -1
View File
@@ -166,7 +166,7 @@ onMounted(() => {
::: warning
Das wird sich in Zukunft ändern. Only Nushell v0.96+ is supported.
Das wird sich in Zukunft ändern. Nur Nushell v0.96+ wird unterstützt.
:::
+170 -17
View File
@@ -329,6 +329,7 @@ $azure\
$nats\
$direnv\
$env_var\
$mise\
$crystal\
$custom\
$sudo\
@@ -340,6 +341,7 @@ $time\
$status\
$os\
$container\
$netns\
$shell\
$character"""
```
@@ -619,7 +621,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
*: This variable can only be used as a part of a style string
### Beispiele
### Beispiel
#### Customize the format
@@ -630,15 +632,6 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
format = 'via [🍔 $version](bold green) '
```
#### Replace Node.js
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']
```
## C
The `c` module shows some information about your C compiler. By default the module will be shown if the current directory contains a `.c` or `.h` file.
@@ -685,6 +678,53 @@ If a C compiler is not supported by this module, you can request it by [raising
format = 'via [$name $version]($style)'
```
## CPP
The `cpp` module shows some information about your `C++` compiler. By default, the module will be shown if the current directory contains a `.cpp`, `.hpp`, or other `C++`-related files.
### Optionen
| Option | Standardwert | Beschreibung |
| ------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version(-$name) )]($style)'` | The format string for the module. |
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
| `symbol` | `'C++ '` | The symbol used before displaying the compiler details |
| `detect_extensions` | `['cpp', 'cc', 'cxx', 'c++', 'hpp', 'hh', 'hxx', 'h++', 'tcc']` | Which extensions should trigger this module. |
| `detect_files` | `[]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. |
| `commands` | `[ [ 'c++', '--version' ], [ 'g++', '--version' ], [ 'clang++', '--version' ] ]` | How to detect what the compiler is |
| `style` | `'bold 149'` | Stil für dieses Modul. |
| `disabled` | `true` | Disables the `cpp` module. |
### Variables
| Variable | Beispiel | Beschreibung |
| -------- | -------- | ------------------------------------- |
| name | clang++ | The name of the compiler |
| version | 13.0.0 | The version of the compiler |
| symbol | | Spiegelt den Wert der Option `symbol` |
| style | | Spiegelt den Wert der Option `style` |
NB that `version` is not in the default format.
### Commands
The `commands` option accepts a list of commands to determine the compiler version and name.
Each command is represented as a list of the executable name, followed by its arguments, usually something like `['mycpp', '--version']`. Starship will try executing each command until it gets a result on STDOUT.
If a C++ compiler is not supported by this module, you can request it by [raising an issue on GitHub](https://github.com/starship/starship/).
### Beispiel
```toml
# ~/.config/starship.toml
[cpp]
disabled = false
format = 'via [$name $version]($style)'
```
## Zeichen
Das `character` Modul zeigt ein Zeichen ( meistens einen Pfeil "") vor der Texteingabe an.
@@ -875,6 +915,7 @@ Hinweis: Dies unterdrückt nicht conda's eigenen Prompt-Modifikator, sie können
| `style` | `'bold green'` | Stil für dieses Modul. |
| `format` | `'via [$symbol$environment]($style) '` | Das Format für das Modul. |
| `ignore_base` | `true` | Ignores `base` environment when activated. |
| `detect_env_vars` | `["!PIXI_ENVIRONMENT_NAME"]` | Which environment variable(s) should trigger this module. If it's a pixi environment, this module is not being triggered by default. |
| `disabled` | `false` | Deaktiviert das `conda`-Modul. |
### Variables
@@ -1015,7 +1056,7 @@ The `dart` module shows the currently installed version of [Dart](https://dart.d
### Optionen
| Option | Standardwert | Beschreibung |
| 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` |
@@ -1877,7 +1918,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
### Optionen
| Option | Standartwert | Beschreibung |
| ------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| -------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | The default format for `git_status` |
| `conflicted` | `'='` | This branch has merge conflicts. |
| `ahead` | `'⇡'` | The format of `ahead` |
@@ -1895,6 +1936,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
| `ignore_submodules` | `false` | Ignore changes to submodules. |
| `disabled` | `false` | Deaktiviert das `git_status`-Modul. |
| `windows_starship` | | Use this (Linux) path to a Windows Starship executable to render `git_status` when on Windows paths in WSL. |
| `use_git_executable` | `false` | Do not use `gitoxide` for computing the status, but use the `git` executable instead. |
### Variables
@@ -1972,7 +2014,7 @@ windows_starship = '/mnt/c/Users/username/scoop/apps/starship/current/starship.e
The `gleam` module shows the currently installed version of [Gleam](https://gleam.run/). By default the module will be shown if any of the following conditions are met:
- The current directory contains a `gleam.toml` file
- Das aktuelle Verzeichnis enthält eine `gleam.toml`-Datei
- The current directory contains a file with the `.gleam` extension
### Optionen
@@ -2818,6 +2860,40 @@ truncation_length = 4
truncation_symbol = ''
```
## Mise
The `mise` module shows the current mise health as reported by running `mise doctor`.
### Optionen
| Option | Standartwert | Beschreibung |
| ------------------ | -------------------------------- | ------------------------------------------------ |
| `symbol` | `'mise '` | The symbol used before displaying _mise_ health. |
| `style` | `'bold purple'` | Stil für dieses Modul. |
| `format` | `'on [$symbol$health]($style) '` | Das Format für das Modul. |
| `healthy_symbol` | `healthy` | The message displayed when _mise_ is healthy. |
| `unhealthy_symbol` | `unhealthy` | The message displayed when _mise_ is unhealthy. |
| `disabled` | `true` | Disables the `mise` module. |
### Variables
| Variable | Beispiel | Beschreibung |
| --------- | --------- | ------------------------------------- |
| health | `healthy` | The health of _mise_ |
| 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
[mise]
health = 'ready'
```
## Mojo
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
@@ -2882,6 +2958,37 @@ format = '[$symbol]($style)'
style = 'bold purple'
```
## Network Namespace
The `netns` module shows the current network namespace. This uses `ip netns identify` to get the network namespace, so only network namespaces mounted at `/var/run/netns` will be detected.
### Optionen
| Option | Standartwert | Beschreibung |
| ---------- | --------------------------------- | ----------------------------------------------------------------- |
| `format` | `'[$symbol \[$name\]]($style)'` | Das Format für das Modul. |
| `symbol` | `'🛜 '` | The symbol used before the network namespace (defaults to empty). |
| `style` | `'blue bold dimmed'` | Stil für dieses Modul. |
| `disabled` | `false` | Disables the `netns` module. |
### Variables
| Variable | Beispiel | Beschreibung |
| --------- | ---------- | ----------------------------------------- |
| name | `my-netns` | The name of the current network namespace |
| symbol | | Spiegelt den Wert der Option `symbol` |
| style\* | | Spiegelt den Wert der Option `style` |
### Beispiel
```toml
# ~/.config/starship.toml
[netns]
style = 'bold yellow'
symbol = '🌐 '
```
## Nim
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). By default the module will be shown if any of the following conditions are met:
@@ -2976,6 +3083,8 @@ The `nodejs` module shows the currently installed version of [Node.js](https://n
- The current directory contains a file with the `.js`, `.mjs` or `.cjs` extension
- The current directory contains a file with the `.ts`, `.mts` or `.cts` extension
Additionally, the module will be hidden by default if the directory contains a `bunfig.toml`, `bun.lock`, or `bun.lockb` file, overriding the above conditions.
### Optionen
| Option | Standartwert | Beschreibung |
@@ -3203,6 +3312,7 @@ Amazon = "🙂 "
Android = "🤖 "
Arch = "🎗️ "
Artix = "🎗️ "
Bluefin = "🐟 "
CachyOS = "🎗️ "
CentOS = "💠 "
Debian = "🌀 "
@@ -3281,6 +3391,7 @@ Arch = "Arch is the best! "
Das `Package` Modul wird angezeigt, wenn das aktuelle Verzeichnis das Repository für ein Paket ist, und zeigt dessen aktuelle Version an. The module currently supports `npm`, `nimble`, `cargo`, `poetry`, `python`, `composer`, `gradle`, `julia`, `mix`, `helm`, `shards`, `daml` and `dart` packages.
- [**npm**](https://docs.npmjs.com/cli/commands/npm) The `npm` package version is extracted from the `package.json` present in the current directory
- [**JSR**](https://jsr.io/) The `jsr` package version is extracted from the `jsr.json`/`jsr.jsonc` or `deno.json`/`deno.jsonc` present in the current directory
- [**Cargo**](https://doc.rust-lang.org/cargo/) The `cargo` package version is extracted from the `Cargo.toml` present in the current directory
- [**Nimble**](https://github.com/nim-lang/nimble) - The `nimble` package version is extracted from the `*.nimble` file present in the current directory with the `nimble dump` command
- [**Poetry**](https://python-poetry.org/) The `poetry` package version is extracted from the `pyproject.toml` present in the current directory
@@ -3425,6 +3536,49 @@ The `pijul_channel` module shows the active channel of the repo in your current
| `truncation_symbol` | `'…'` | The symbol used to indicate a branch name was truncated. |
| `disabled` | `true` | Disables the `pijul` module. |
## Pixi
The `pixi` module shows the installed [pixi](https://pixi.sh) version as well as the activated environment, if `$PIXI_ENVIRONMENT_NAME` is set.
::: tip
This does not suppress pixi's own prompt modifier, you may want to run `pixi config set change-ps1 false`.
:::
### Optionen
| Option | Standartwert | Beschreibung |
| -------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )(\($environment\) )]($style)'` | Das Format für das Modul. |
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch`. |
| `symbol` | `'🧚 '` | Symbol das vor dem Umgebungsnamen angezeigt wird. |
| `style` | `'yellow bold' | Stil für dieses Modul. |
| `show_default_environment` | `true` | Whether to indicate that the `default` environment of your project is activated. |
| `pixi_binary` | `['pixi']` | Configures the pixi binary that Starship should execute when getting the version. |
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
| `detect_files` | `['pixi.toml']` | Which filenames should trigger this module. |
| `detect_folders` | `['.pixi']` | Which folders should trigger this module. |
| `disabled` | `false` | Disables the `pixi` module. |
### Variables
| Variable | Beispiel | Beschreibung |
| ----------- | --------- | ------------------------------------- |
| version | `v0.33.0` | The version of `pixi` |
| environment | `py311` | The current pixi environment |
| symbol | | Spiegelt den Wert der Option `symbol` |
| style | | Spiegelt den Wert der Option `style` |
### Beispiel
```toml
# ~/.config/starship.toml
[pixi]
format = '[$symbol$environment](yellow) '
```
## Pulumi
The `pulumi` module shows the current username, selected [Pulumi Stack](https://www.pulumi.com/docs/intro/concepts/stack/), and version.
@@ -3539,7 +3693,6 @@ 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
@@ -3547,16 +3700,16 @@ By default, the module will be shown if any of the following conditions are met:
### 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. |
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should execute 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_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. |
+3 -1
View File
@@ -229,10 +229,12 @@ Alternatively, install Starship using any of the following package managers:
| Alpine Linux 3.13+ | [Alpine Linux Packages](https://pkgs.alpinelinux.org/packages?name=starship) | `apk add starship` |
| Arch Linux | [Arch Linux Extra](https://archlinux.org/packages/extra/x86_64/starship) | `pacman -S starship` |
| CentOS 7+ | [Copr](https://copr.fedorainfracloud.org/coprs/atim/starship) | `dnf copr enable atim/starship` <br /> `dnf install starship` |
| Debian 13+ | [Debian Main](https://sources.debian.org/src/starship/1.22.1-1/) | `apt install starship` |
| Gentoo | [Gentoo Packages](https://packages.gentoo.org/packages/app-shells/starship) | `emerge app-shells/starship` |
| Manjaro | | `pacman -S starship` |
| NixOS | [nixpkgs](https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/misc/starship/default.nix) | `nix-env -iA nixpkgs.starship` |
| openSUSE | [OSS](https://software.opensuse.org/package/starship) | `zypper in starship` |
| Ubuntu 25.04+ | [Ubuntu Universe](https://packages.ubuntu.com/source/plucky/starship) | `apt install starship` |
| Void Linux | [Void Linux Packages](https://github.com/void-linux/void-packages/tree/master/srcpkgs/starship) | `xbps-install -S starship` |
</details>
@@ -345,7 +347,7 @@ mkdir ($nu.data-dir | path join "vendor/autoload")
starship init nu | save -f ($nu.data-dir | path join "vendor/autoload/starship.nu")
```
Note: Only Nushell v0.96+ is supported
Beachte: Nushell wird erst ab v0.96+ unterstützt
</details>
+6
View File
@@ -75,3 +75,9 @@ Diese Voreinstellung ist stark inspiriert von [Pastel Powerline](./pastel-powerl
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.
[![Screenshot of Jetpack preset](/presets/img/jetpack.png "Click to view Jetpack preset")](./jetpack)
## [Catppuccin Powerline](./catppuccin-powerline.md)
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
[![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png "Click to view Catppuccin Powerline preset")](./catppuccin-powerline)
@@ -0,0 +1,28 @@
[Return to Presets](./README.md#catppuccin-powerline)
# Catppuccin Powerline Preset
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png)
### Voraussetzungen
- A [Nerd Font](https://www.nerdfonts.com/) installed and enabled in your terminal
### Konfiguration
```sh
starship preset catppuccin-powerline -o ~/.config/starship.toml
```
By default this preset uses the Mocha flavour of Catppucin, but you can specify any of the flavours by modifying the value of `palette`:
- `catppuccin_mocha`
- `catppuccin_frappe`
- `catppuccin_macchiato`
- `catppucin_latte`
[Click to download TOML](/presets/toml/catppuccin-powerline.toml)
<<< @/public/presets/toml/catppuccin-powerline.toml
+1 -1
View File
@@ -166,7 +166,7 @@ onMounted(() => {
::: warning
Esto cambiará en el futuro. Only Nushell v0.96+ is supported.
Esto cambiará en el futuro. Sólo se admite Nushell v0.96+.
:::
+169 -16
View File
@@ -328,6 +328,7 @@ $azure\
$nats\
$direnv\
$env_var\
$mise\
$crystal\
$custom\
$sudo\
@@ -339,6 +340,7 @@ $time\
$status\
$os\
$container\
$netns\
$shell\
$character"""
```
@@ -618,7 +620,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
*: Esta variable solamente puede ser usada como parte de una cadena de caracteres de estilo
### Ejemplos
### Ejemplo
#### Customize the format
@@ -629,15 +631,6 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
format = 'via [🍔 $version](bold green) '
```
#### Replace Node.js
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']
```
## C
El módulo `c` muestra información sobre su compilador de C. Por defecto el módulo se mostrará si el directorio actual contiene un archivo `.c` o `.h`.
@@ -684,6 +677,53 @@ Si un compilador C no es compatible con este módulo, puede solicitarlo [plantea
format = 'via [$name $version]($style)'
```
## CPP
The `cpp` module shows some information about your `C++` compiler. By default, the module will be shown if the current directory contains a `.cpp`, `.hpp`, or other `C++`-related files.
### Opciones
| Opción | Predeterminado | Descripción |
| ------------------- | -------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version(-$name) )]($style)'` | La cadena de formato para el módulo. |
| `version_format` | `'v${raw}'` | El formato de versión. Las variables disponibles son `raw`, `major`, `minor`, & `patch` |
| `symbol` | `'C++ '` | El símbolo usado antes de mostrar los detalles del compilador |
| `detect_extensions` | `['cpp', 'cc', 'cxx', 'c++', 'hpp', 'hh', 'hxx', 'h++', 'tcc']` | 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. |
| `commands` | `[ [ 'c++', '--version' ], [ 'g++', '--version' ], [ 'clang++', '--version' ] ]` | Cómo detectar cuál compilador es |
| `style` | `'bold 149'` | El estilo del módulo. |
| `disabled` | `true` | Disables the `cpp` module. |
### Variables
| Variable | Ejemplo | Descripción |
| -------- | ------- | -------------------------------------- |
| name | clang++ | El nombre del compilador |
| version | 13.0.0 | La versión del compilador |
| symbol | | Refleja el valor de la opción `symbol` |
| style | | Refleja el valor de la opción `style` |
NB que `versión` no está en el formato por defecto.
### Commands
La opción de `commands` acepta una lista de comandos para determinar la versión y el nombre del compilador.
Each command is represented as a list of the executable name, followed by its arguments, usually something like `['mycpp', '--version']`. Starship intentará ejecutar cada comando hasta que obtenga un resultado en STDOUT.
If a C++ compiler is not supported by this module, you can request it by [raising an issue on GitHub](https://github.com/starship/starship/).
### Ejemplo
```toml
# ~/.config/starship.toml
[cpp]
disabled = false
format = 'via [$name $version]($style)'
```
## Carácter
El módulo `character` muestra un carácter (normalmente una flecha) al lado del texto que introduces en la terminal.
@@ -874,6 +914,7 @@ Esto no modifica el propio símbolo de sistema de Conda. En caso de querer supri
| `style` | `'bold green'` | El estilo del módulo. |
| `format` | `'via [$symbol$environment]($style) '` | El formato del módulo. |
| `ignore_base` | `true` | Ignora el entorno `base` cuando se activa. |
| `detect_env_vars` | `["!PIXI_ENVIRONMENT_NAME"]` | Qué variable(s) de entorno deben activar este módulo. If it's a pixi environment, this module is not being triggered by default. |
| `disabled` | `false` | Deshabilita el módulo `conda`. |
### Variables
@@ -1876,7 +1917,7 @@ El módulo Git Status es muy lento en los directorios de Windows (por ejemplo ba
### Opciones
| Opción | Predeterminado | Descripción |
| ------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| -------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | El formato predeterminado para `git_status` |
| `conflicted` | `'='` | Esta rama tiene conflictos de fusión. |
| `ahead` | `'⇡'` | El formato de `ahead` |
@@ -1894,6 +1935,7 @@ El módulo Git Status es muy lento en los directorios de Windows (por ejemplo ba
| `ignore_submodules` | `false` | Ignorar cambios a los submódulos. |
| `disabled` | `false` | Deshabilita el módulo `git_status`. |
| `windows_starship` | | Utiliza esta ruta (Linux) a un ejecutable de Starship de Windows para renderizar `git_status` cuando está en las rutas de Windows en WSL. |
| `use_git_executable` | `false` | Do not use `gitoxide` for computing the status, but use the `git` executable instead. |
### Variables
@@ -1971,7 +2013,7 @@ windows_starship = '/mnt/c/Users/username/scoop/apps/starship/current/starship.e
The `gleam` module shows the currently installed version of [Gleam](https://gleam.run/). Por defecto, el módulo se mostrará si se cumplen cualquiera de las siguientes condiciones:
- The current directory contains a `gleam.toml` file
- El directorio actual contiene un archivo `gleam.toml`
- The current directory contains a file with the `.gleam` extension
### Opciones
@@ -2817,6 +2859,40 @@ truncation_length = 4
truncation_symbol = ''
```
## Mise
The `mise` module shows the current mise health as reported by running `mise doctor`.
### Opciones
| Opción | Predeterminado | Descripción |
| ------------------ | -------------------------------- | ------------------------------------------------ |
| `symbol` | `'mise '` | The symbol used before displaying _mise_ health. |
| `style` | `'bold purple'` | El estilo del módulo. |
| `format` | `'on [$symbol$health]($style) '` | El formato del módulo. |
| `healthy_symbol` | `healthy` | The message displayed when _mise_ is healthy. |
| `unhealthy_symbol` | `unhealthy` | The message displayed when _mise_ is unhealthy. |
| `disabled` | `true` | Disables the `mise` module. |
### Variables
| Variable | Ejemplo | Descripción |
| --------- | --------- | -------------------------------------- |
| health | `healthy` | The health of _mise_ |
| 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
[mise]
health = 'ready'
```
## Mojo
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
@@ -2881,6 +2957,37 @@ format = '[$symbol]($style)'
style = 'bold purple'
```
## Network Namespace
The `netns` module shows the current network namespace. This uses `ip netns identify` to get the network namespace, so only network namespaces mounted at `/var/run/netns` will be detected.
### Opciones
| Opción | Predeterminado | Descripción |
| ---------- | --------------------------------- | ----------------------------------------------------------------- |
| `format` | `'[$symbol \[$name\]]($style)'` | El formato del módulo. |
| `symbol` | `'🛜 '` | The symbol used before the network namespace (defaults to empty). |
| `style` | `'blue bold dimmed'` | El estilo del módulo. |
| `disabled` | `false` | Disables the `netns` module. |
### Variables
| Variable | Ejemplo | Descripción |
| --------- | ---------- | ----------------------------------------- |
| name | `my-netns` | The name of the current network namespace |
| symbol | | Refleja el valor de la opción `symbol` |
| style\* | | Refleja el valor de la opción `style` |
### Ejemplo
```toml
# ~/.config/starship.toml
[netns]
style = 'bold yellow'
symbol = '🌐 '
```
## Nim
El módulo `nim` muestra la versión instalada de [Nim](https://nim-lang.org/). Por defecto, el módulo se mostrará si se cumplen cualquiera de las siguientes condiciones:
@@ -2975,6 +3082,8 @@ El módulo `nodejs` muestra la versión instalada de [Node.js](https://nodejs.or
- El directorio actual contiene un archivo con la extensión `.js`, `.mjs` o `.cjs`
- El directorio actual contiene un archivo con la extensión `.ts`, `.mts` o `.cts`
Additionally, the module will be hidden by default if the directory contains a `bunfig.toml`, `bun.lock`, or `bun.lockb` file, overriding the above conditions.
### Opciones
| Opción | Predeterminado | Descripción |
@@ -3202,6 +3311,7 @@ Amazon = "🙂 "
Android = "🤖 "
Arch = "🎗️ "
Artix = "🎗️ "
Bluefin = "🐟 "
CachyOS = "🎗️ "
CentOS = "💠 "
Debian = "🌀 "
@@ -3280,6 +3390,7 @@ Arch = "Arch es lo mejor! "
El módulo `package` se muestra cuando el directorio actual es el repositorio de un paquete, y muestra su versión actual. The module currently supports `npm`, `nimble`, `cargo`, `poetry`, `python`, `composer`, `gradle`, `julia`, `mix`, `helm`, `shards`, `daml` and `dart` packages.
- [**npm**](https://docs.npmjs.com/cli/commands/npm) La versión del paquete `npm` se extrae del `package.json` presente en el directorio actual
- [**JSR**](https://jsr.io/) The `jsr` package version is extracted from the `jsr.json`/`jsr.jsonc` or `deno.json`/`deno.jsonc` present in the current directory
- [**Cargo**](https://doc.rust-lang.org/cargo/) La versión del paquete `cargo` se extrae del `Cargo.toml` presente en el directorio actual
- [**Nimble**](https://github.com/nim-lang/nimble) - La versión del paquete `nimble` se extrae del archivo `*.nimble` presente en el directorio actual con el comando `nimble dump`
- [**Poetry**](https://python-poetry.org/) La versión del paquete `poetry` se extrae del `pyproject.toml` presente en el directorio actual
@@ -3424,6 +3535,49 @@ The `pijul_channel` module shows the active channel of the repo in your current
| `truncation_symbol` | `'…'` | El símbolo usado para indicar que un nombre de rama fue truncado. |
| `disabled` | `true` | Disables the `pijul` module. |
## Pixi
The `pixi` module shows the installed [pixi](https://pixi.sh) version as well as the activated environment, if `$PIXI_ENVIRONMENT_NAME` is set.
::: tip
This does not suppress pixi's own prompt modifier, you may want to run `pixi config set change-ps1 false`.
:::
### Opciones
| Opción | Predeterminado | Descripción |
| -------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )(\($environment\) )]($style)'` | El formato del módulo. |
| `version_format` | `'v${raw}'` | El formato de versión. Available vars are `raw`, `major`, `minor`, & `patch`. |
| `symbol` | `'🧚 '` | El símbolo usado antes del nombre del entorno. |
| `style` | `'yellow bold' | El estilo del módulo. |
| `show_default_environment` | `true` | Whether to indicate that the `default` environment of your project is activated. |
| `pixi_binary` | `['pixi']` | Configures the pixi binary that Starship should execute when getting the version. |
| `detect_extensions` | `[]` | Qué extensiones deberían activar este módulo. |
| `detect_files` | `['pixi.toml']` | Qué nombres de archivo deberían activar este módulo. |
| `detect_folders` | `['.pixi']` | Qué carpetas deberían activar este módulo. |
| `disabled` | `false` | Disables the `pixi` module. |
### Variables
| Variable | Ejemplo | Descripción |
| ----------- | --------- | -------------------------------------- |
| version | `v0.33.0` | The version of `pixi` |
| environment | `py311` | The current pixi environment |
| symbol | | Refleja el valor de la opción `symbol` |
| style | | Refleja el valor de la opción `style` |
### Ejemplo
```toml
# ~/.config/starship.toml
[pixi]
format = '[$symbol$environment](yellow) '
```
## Pulumi
El módulo `pulumi` muestra el nombre de usuario actual, [Pulumi Stack](https://www.pulumi.com/docs/intro/concepts/stack/)seleccionado y la versión.
@@ -3538,7 +3692,6 @@ 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
@@ -3546,16 +3699,16 @@ Por defecto, el módulo se mostrará si se cumplen cualquiera de las siguientes
### 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. |
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should execute when getting the version. |
| `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_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`. |
+3 -1
View File
@@ -229,10 +229,12 @@ Alternativamente, instale Starship usando cualquiera de los siguientes gestores
| Alpine Linux 3.13+ | [Alpine Linux Packages](https://pkgs.alpinelinux.org/packages?name=starship) | `apk add starship` |
| Arch Linux | [Arch Linux Extra](https://archlinux.org/packages/extra/x86_64/starship) | `pacman -S starship` |
| CentOS 7+ | [Copr](https://copr.fedorainfracloud.org/coprs/atim/starship) | `dnf copr enable atim/starship` <br /> `dnf install starship` |
| Debian 13+ | [Debian Main](https://sources.debian.org/src/starship/1.22.1-1/) | `apt install starship` |
| Gentoo | [Paquetes Gentoo](https://packages.gentoo.org/packages/app-shells/starship) | `emerge app-shells/starship` |
| Manjaro | | `pacman -S starship` |
| NixOS | [nixpkgs](https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/misc/starship/default.nix) | `nix-env -iA nixpkgs.starship` |
| openSUSE | [OSS](https://software.opensuse.org/package/starship) | `zypper in starship` |
| Ubuntu 25.04+ | [Ubuntu Universe](https://packages.ubuntu.com/source/plucky/starship) | `apt install starship` |
| Void Linux | [Void Linux Packages](https://github.com/void-linux/void-packages/tree/master/srcpkgs/starship) | `xbps-install -S starship` |
</details>
@@ -345,7 +347,7 @@ mkdir ($nu.data-dir | path join "vendor/autoload")
starship init nu | save -f ($nu.data-dir | path join "vendor/autoload/starship.nu")
```
Note: Only Nushell v0.96+ is supported
Nota: Sólo se admite Nushell v0.96+
</details>
+6
View File
@@ -75,3 +75,9 @@ Este preajuste está muy inspirado en [Pastel Powerline](./pastel-powerline.md)
Este es un preajuste pseudominimalista inspirado en las indicaciones [geometría](https://github.com/geometry-zsh/geometry) y [nave espacial](https://github.com/spaceship-prompt/spaceship-prompt).
[![Captura de pantalla del preajuste Jetpack](/presets/img/jetpack.png "Click to view Jetpack preset")](./jetpack)
## [Catppuccin Powerline](./catppuccin-powerline.md)
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
[![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png "Click to view Catppuccin Powerline preset")](./catppuccin-powerline)
@@ -0,0 +1,28 @@
[Return to Presets](./README.md#catppuccin-powerline)
# Catppuccin Powerline Preset
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png)
### Prerequisitos
- A [Nerd Font](https://www.nerdfonts.com/) installed and enabled in your terminal
### Configuración
```sh
starship preset catppuccin-powerline -o ~/.config/starship.toml
```
By default this preset uses the Mocha flavour of Catppucin, but you can specify any of the flavours by modifying the value of `palette`:
- `catppuccin_mocha`
- `catppuccin_frappe`
- `catppuccin_macchiato`
- `catppucin_latte`
[Click to download TOML](/presets/toml/catppuccin-powerline.toml)
<<< @/public/presets/toml/catppuccin-powerline.toml
+1 -1
View File
@@ -166,7 +166,7 @@ onMounted(() => {
::: warning
Ceci va changer dans le futur. Only Nushell v0.96+ is supported.
Ceci va changer dans le futur. Seul Nushell v0.96+ est supporté.
:::
+169 -16
View File
@@ -328,6 +328,7 @@ $azure\
$nats\
$direnv\
$env_var\
$mise\
$crystal\
$custom\
$sudo\
@@ -339,6 +340,7 @@ $time\
$status\
$os\
$container\
$netns\
$shell\
$character"""
```
@@ -618,7 +620,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
*: Cette variable peut uniquement être utilisée dans une chaine de style
### Exemples
### Exemple
#### Customize the format
@@ -629,15 +631,6 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
format = 'via [🍔 $version](bold green) '
```
#### Replace Node.js
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']
```
## C
Le module `c` affiche des informations à propos de votre compilateur C. Par défaut, ce module sera affiché si le dossier courant contient un fichier `.c` ou `.h`.
@@ -684,6 +677,53 @@ Si un compilateur C nest pas supporté par ce module, vous pouvez demander so
format = 'via [$name $version]($style)'
```
## CPP
The `cpp` module shows some information about your `C++` compiler. By default, the module will be shown if the current directory contains a `.cpp`, `.hpp`, or other `C++`-related files.
### Options
| Option | Défaut | Description |
| ------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| `format` | `'via [$symbol($version(-$name) )]($style)'` | La chaîne de format pour le module. |
| `version_format` | `'v${raw}'` | Le format de la version. Les variables disponibles sont `raw`, `major`, `minor`, & `patch` |
| `symbole` | `'C++ '` | Le symbole utilisé avant dafficher les détails du compilateur |
| `detect_extensions` | `['cpp', 'cc', 'cxx', 'c++', 'hpp', 'hh', 'hxx', 'h++', 'tcc']` | Les extensions qui déclenchent ce module. |
| `detect_files` | `[]` | Les fichiers qui activent ce module. |
| `detect_folders` | `[]` | Les dossiers qui activent ce module. |
| `commands` | `[ [ 'c++', '--version' ], [ 'g++', '--version' ], [ 'clang++', '--version' ] ]` | Comment détecter quel est le compilateur |
| `style` | `'bold 149'` | Le style pour le module. |
| `disabled` | `true` | Disables the `cpp` module. |
### Variables
| Variable | Exemple | Description |
| -------- | ------- | -------------------------------------- |
| name | clang++ | Le nom du compilateur |
| version | 13.0.0 | La version du compilateur |
| symbole | | Reflète la valeur de l'option `symbol` |
| style | | Reflète la valeur de l'option `style` |
Notez que `version` nest pas dans le format par défaut.
### Commandes
Loption `commands` accepte une liste de commandes pour déterminer la version du compilateur et son nom.
Each command is represented as a list of the executable name, followed by its arguments, usually something like `['mycpp', '--version']`. Starship essayera d'exécuter chaque commande jusqu'à obtenir un résultat sur STDOUT.
If a C++ compiler is not supported by this module, you can request it by [raising an issue on GitHub](https://github.com/starship/starship/).
### Exemple
```toml
# ~/.config/starship.toml
[cpp]
disabled = false
format = 'via [$name $version]($style)'
```
## Caractère
Le module `character` affiche un caractère (en général une flèche) à côté de là où vous entrez le texte dans votre terminal.
@@ -874,6 +914,7 @@ Cela ne supprime pas le modificateur d'invite de conda, vous pourriez vouloir ex
| `style` | `'bold green'` | Le style pour le module. |
| `format` | `'via [$symbol$environment]($style) '` | Format du module. |
| `ignore_base` | `true` | Ignore l'environnement `base` lorsqu'il est activé. |
| `detect_env_vars` | `["!PIXI_ENVIRONMENT_NAME"]` | Which environment variable(s) should trigger this module. If it's a pixi environment, this module is not being triggered by default. |
| `disabled` | `false` | Désactive le module `conda`. |
### Variables
@@ -1876,7 +1917,7 @@ Le module Statut Git est très lent dans les dossiers Windows (par exemple sous
### Options
| Option | Défaut | Description |
| ------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| -------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | Le format par défaut du module `git_status` |
| `conflicted` | `'='` | Cette branche a des conflits de fusion. |
| `ahead` | `'⇡'` | Le format de `ahead` |
@@ -1894,6 +1935,7 @@ Le module Statut Git est très lent dans les dossiers Windows (par exemple sous
| `ignore_submodules` | `false` | Ignorer les changements des sous-modules. |
| `disabled` | `false` | Désactive le module `git_status`. |
| `windows_starship` | | Utiliser ce chemin (Linux) vers un exécutable Starship Windows pour afficher le `git_status` pour les chemins Windows dans WSL. |
| `use_git_executable` | `false` | Do not use `gitoxide` for computing the status, but use the `git` executable instead. |
### Variables
@@ -1971,7 +2013,7 @@ windows_starship = '/mnt/c/Users/username/scoop/apps/starship/current/starship.e
The `gleam` module shows the currently installed version of [Gleam](https://gleam.run/). Par défaut, le module sera affiché si lune de ces conditions est remplie:
- The current directory contains a `gleam.toml` file
- Le dossier courant contient un fichier `gleam.toml`
- The current directory contains a file with the `.gleam` extension
### Options
@@ -2817,6 +2859,40 @@ truncation_length = 4
truncation_symbol = ''
```
## Mise
The `mise` module shows the current mise health as reported by running `mise doctor`.
### Options
| Option | Défaut | Description |
| ------------------ | -------------------------------- | ------------------------------------------------ |
| `symbole` | `'mise '` | The symbol used before displaying _mise_ health. |
| `style` | `'bold purple'` | Le style pour le module. |
| `format` | `'on [$symbol$health]($style) '` | Format du module. |
| `healthy_symbol` | `healthy` | The message displayed when _mise_ is healthy. |
| `unhealthy_symbol` | `unhealthy` | The message displayed when _mise_ is unhealthy. |
| `disabled` | `true` | Disables the `mise` module. |
### Variables
| Variable | Exemple | Description |
| --------- | --------- | -------------------------------------- |
| health | `healthy` | The health of _mise_ |
| 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
[mise]
health = 'ready'
```
## Mojo
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
@@ -2881,6 +2957,37 @@ format = '[$symbol]($style)'
style = 'bold purple'
```
## Network Namespace
The `netns` module shows the current network namespace. This uses `ip netns identify` to get the network namespace, so only network namespaces mounted at `/var/run/netns` will be detected.
### Options
| Option | Défaut | Description |
| ---------- | --------------------------------- | ----------------------------------------------------------------- |
| `format` | `'[$symbol \[$name\]]($style)'` | Format du module. |
| `symbole` | `'🛜 '` | The symbol used before the network namespace (defaults to empty). |
| `style` | `'blue bold dimmed'` | Le style pour le module. |
| `disabled` | `false` | Disables the `netns` module. |
### Variables
| Variable | Exemple | Description |
| --------- | ---------- | ----------------------------------------- |
| name | `my-netns` | The name of the current network namespace |
| symbole | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` |
### Exemple
```toml
# ~/.config/starship.toml
[netns]
style = 'bold yellow'
symbol = '🌐 '
```
## Nim
Le module `nim` affiche la version de [Nim](https://nim-lang.org/) installée. Par défaut, le module sera affiché si lune de ces conditions est remplie:
@@ -2975,6 +3082,8 @@ Le module `nodejs` affiche la version de [Node.js](https://nodejs.org/) install
- Le dossier courant contient un fichier avec lextension `.js`, `.mjs` ou `.cjs`
- Le dossier courant contient un fichier avec lextension `.ts`, `.mts` ou `.cts`
Additionally, the module will be hidden by default if the directory contains a `bunfig.toml`, `bun.lock`, or `bun.lockb` file, overriding the above conditions.
### Options
| Option | Défaut | Description |
@@ -3202,6 +3311,7 @@ Amazon = "🙂 "
Android = "🤖 "
Arch = "🎗️ "
Artix = "🎗️ "
Bluefin = "🐟 "
CachyOS = "🎗️ "
CentOS = "💠 "
Debian = "🌀 "
@@ -3280,6 +3390,7 @@ Arch = "Arch is the best! "
The `package` module is shown when the current directory is the repository for a package, and shows its current version. The module currently supports `npm`, `nimble`, `cargo`, `poetry`, `python`, `composer`, `gradle`, `julia`, `mix`, `helm`, `shards`, `daml` and `dart` packages.
- [**npm**](https://docs.npmjs.com/cli/commands/npm) La version du paquet `npm` est extraite du `package.json` présent dans le répertoire courant
- [**JSR**](https://jsr.io/) The `jsr` package version is extracted from the `jsr.json`/`jsr.jsonc` or `deno.json`/`deno.jsonc` present in the current directory
- [**Cargo**](https://doc.rust-lang.org/cargo/) La version du paquet `cargo` est extraite du `Cargo.toml` présent dans le répertoire courant
- [**Nimble**](https://github.com/nim-lang/nimble) - La version du paquet `nimble` est extraite du fichier `*.nimble` dans le répertoire courant avec la commande `nimble dump`
- [**Poetry**](https://python-poetry.org/) La version du paquet `poetry` est extraite du `pyproject.toml` présent dans le répertoire courant
@@ -3424,6 +3535,49 @@ The `pijul_channel` module shows the active channel of the repo in your current
| `truncation_symbol` | `'…'` | Le symbole utilisé pour indiquer qu'un nom de branche a été tronqué. |
| `disabled` | `true` | Disables the `pijul` module. |
## Pixi
The `pixi` module shows the installed [pixi](https://pixi.sh) version as well as the activated environment, if `$PIXI_ENVIRONMENT_NAME` is set.
::: tip
This does not suppress pixi's own prompt modifier, you may want to run `pixi config set change-ps1 false`.
:::
### Options
| Option | Défaut | Description |
| -------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )(\($environment\) )]($style)'` | Format du module. |
| `version_format` | `'v${raw}'` | Le format de la version. Available vars are `raw`, `major`, `minor`, & `patch`. |
| `symbole` | `'🧚 '` | Le symbole utilisé avant le nom d'environnement. |
| `style` | `'yellow bold' | Le style pour le module. |
| `show_default_environment` | `true` | Whether to indicate that the `default` environment of your project is activated. |
| `pixi_binary` | `['pixi']` | Configures the pixi binary that Starship should execute when getting the version. |
| `detect_extensions` | `[]` | Les extensions qui déclenchent ce module. |
| `detect_files` | `['pixi.toml']` | Les fichiers qui activent ce module. |
| `detect_folders` | `['.pixi']` | Les dossiers qui activent ce module. |
| `disabled` | `false` | Disables the `pixi` module. |
### Variables
| Variable | Exemple | Description |
| ----------- | --------- | -------------------------------------- |
| version | `v0.33.0` | The version of `pixi` |
| environment | `py311` | The current pixi environment |
| symbole | | Reflète la valeur de l'option `symbol` |
| style | | Reflète la valeur de l'option `style` |
### Exemple
```toml
# ~/.config/starship.toml
[pixi]
format = '[$symbol$environment](yellow) '
```
## Pulumi
The `pulumi` module shows the current username, selected [Pulumi Stack](https://www.pulumi.com/docs/intro/concepts/stack/), and version.
@@ -3538,7 +3692,6 @@ Par défaut, le module sera affiché si lune 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 lextension `.py`.
- The current directory contains a file with the `.ipynb` extension.
- Un environnement virtuel est actuellement activé
@@ -3546,16 +3699,16 @@ Par défaut, le module sera affiché si lune de ces conditions est remplie:
### 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. |
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should execute when getting the version. |
| `detect_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_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`. |
+3 -1
View File
@@ -229,10 +229,12 @@ Vous pouvez aussi installer Starship en utilisant lun de ces gestionnaires de
| Alpine Linux 3.13+ | [Paquets Alpine Linux](https://pkgs.alpinelinux.org/packages?name=starship) | `apk add starship` |
| Arch Linux | [Arch Linux Extra](https://archlinux.org/packages/extra/x86_64/starship) | `pacman -S starship` |
| CentOS 7+ | [Copr](https://copr.fedorainfracloud.org/coprs/atim/starship) | `dnf copr enable atim/starship` <br /> `dnf install starship` |
| Debian 13+ | [Debian Main](https://sources.debian.org/src/starship/1.22.1-1/) | `apt install starship` |
| Gentoo | [Paquets Gentoo](https://packages.gentoo.org/packages/app-shells/starship) | `emerge app-shells/starship` |
| Manjaro | | `pacman -S starship` |
| NixOS | [nixpkgs](https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/misc/starship/default.nix) | `nix-env -iA nixpkgs.starship` |
| openSUSE | [OSS](https://software.opensuse.org/package/starship) | `zypper in starship` |
| Ubuntu 25.04+ | [Ubuntu Universe](https://packages.ubuntu.com/source/plucky/starship) | `apt install starship` |
| Void Linux | [Paquets Void Linux](https://github.com/void-linux/void-packages/tree/master/srcpkgs/starship) | `xbps-install -S starship` |
</details>
@@ -345,7 +347,7 @@ mkdir ($nu.data-dir | path join "vendor/autoload")
starship init nu | save -f ($nu.data-dir | path join "vendor/autoload/starship.nu")
```
Note: Only Nushell v0.96+ is supported
Note: Seul Nushell v0.96+ est supporté
</details>
+6
View File
@@ -75,3 +75,9 @@ This preset is heavily inspired by [Pastel Powerline](./pastel-powerline.md), an
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.
[![Screenshot of Jetpack preset](/presets/img/jetpack.png "Click to view Jetpack preset")](./jetpack)
## [Catppuccin Powerline](./catppuccin-powerline.md)
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
[![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png "Click to view Catppuccin Powerline preset")](./catppuccin-powerline)
@@ -0,0 +1,28 @@
[Return to Presets](./README.md#catppuccin-powerline)
# Catppuccin Powerline Preset
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png)
### Pré-requis
- A [Nerd Font](https://www.nerdfonts.com/) installed and enabled in your terminal
### Configuration
```sh
starship preset catppuccin-powerline -o ~/.config/starship.toml
```
By default this preset uses the Mocha flavour of Catppucin, but you can specify any of the flavours by modifying the value of `palette`:
- `catppuccin_mocha`
- `catppuccin_frappe`
- `catppuccin_macchiato`
- `catppucin_latte`
[Click to download TOML](/presets/toml/catppuccin-powerline.toml)
<<< @/public/presets/toml/catppuccin-powerline.toml
+1 -1
View File
@@ -166,7 +166,7 @@ onMounted(() => {
::: warning
Hal ini dapat berubah di kemudian hari. Only Nushell v0.96+ is supported.
Hal ini dapat berubah di kemudian hari. Hanya Nushell v0.96+ yang menerima dukungan.
:::
+171 -18
View File
@@ -328,6 +328,7 @@ $azure\
$nats\
$direnv\
$env_var\
$mise\
$crystal\
$custom\
$sudo\
@@ -339,6 +340,7 @@ $time\
$status\
$os\
$container\
$netns\
$shell\
$character"""
```
@@ -629,15 +631,6 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
format = 'via [🍔 $version](bold green) '
```
#### Replace Node.js
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']
```
## C
The `c` module shows some information about your C compiler. By default the module will be shown if the current directory contains a `.c` or `.h` file.
@@ -684,6 +677,53 @@ If a C compiler is not supported by this module, you can request it by [raising
format = 'via [$name $version]($style)'
```
## CPP
The `cpp` module shows some information about your `C++` compiler. By default, the module will be shown if the current directory contains a `.cpp`, `.hpp`, or other `C++`-related files.
### Opsi
| Opsi | Bawaan | Deskripsi |
| ------------------- | -------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version(-$name) )]($style)'` | The format string for the module. |
| `version_format` | `'v${raw}'` | Format dari versi. Variabel yang tersedia adalah `raw`, `major`, `minor`, & `patch` |
| `symbol` | `'C++ '` | The symbol used before displaying the compiler details |
| `detect_extensions` | `['cpp', 'cc', 'cxx', 'c++', 'hpp', 'hh', 'hxx', 'h++', 'tcc']` | 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. |
| `commands` | `[ [ 'c++', '--version' ], [ 'g++', '--version' ], [ 'clang++', '--version' ] ]` | How to detect what the compiler is |
| `style` | `'bold 149'` | Gaya penataan untuk modul. |
| `disabled` | `true` | Disables the `cpp` module. |
### Variabel
| Variabel | Contoh | Deskripsi |
| -------- | ------- | --------------------------------- |
| name | clang++ | The name of the compiler |
| version | 13.0.0 | The version of the compiler |
| symbol | | Menyalin nilai dari opsi `symbol` |
| style | | Menyalin nilai dari opsi `style` |
NB that `version` is not in the default format.
### Commands
The `commands` option accepts a list of commands to determine the compiler version and name.
Each command is represented as a list of the executable name, followed by its arguments, usually something like `['mycpp', '--version']`. Starship will try executing each command until it gets a result on STDOUT.
If a C++ compiler is not supported by this module, you can request it by [raising an issue on GitHub](https://github.com/starship/starship/).
### Contoh
```toml
# ~/.config/starship.toml
[cpp]
disabled = false
format = 'via [$name $version]($style)'
```
## Karakter
Modul `character` menampilkan sebuah karakter (biasanya anak panah) di samping teks pada terminalmu.
@@ -874,6 +914,7 @@ Hal ini tidak menahan pengubah (modifier) prompt dari conda sendiri, kamu mungki
| `style` | `'bold green'` | Gaya penataan untuk modul. |
| `format` | `'via [$symbol$environment]($style) '` | Format dari modul. |
| `ignore_base` | `true` | Mengabaikan `base` environment saat aktif. |
| `detect_env_vars` | `["!PIXI_ENVIRONMENT_NAME"]` | Which environment variable(s) should trigger this module. If it's a pixi environment, this module is not being triggered by default. |
| `disabled` | `false` | Menonaktifkan modul `conda`. |
### Variabel
@@ -1413,7 +1454,7 @@ default = 'unknown user'
| `symbol` | `""` | Simbol yang digunakan sebelum menampilkan nilai dari variabel. |
| `variabel` | | Variabel environment yang akan ditampilkan. |
| `bawaan` | | Nilai bawaan yang akan ditampilkan ketika variabel yang terpilih tidak didefinisikan. |
| `format` | `"with [$env_value]($style) "` | Format dari modul. |
| `fromat` | `"with [$env_value]($style) "` | Format dari modul. |
| `deskripsi` | `"<env_var module>"` | The description of the module that is shown when running `starship explain`. |
| `disabled` | `false` | Menonaktifkan modul `env_var`. |
@@ -1838,7 +1879,7 @@ This module is disabled by default. To enable it, set `disabled` to `false` in y
| `added_style` | `'bold green'` | The style for the added count. |
| `deleted_style` | `'bold red'` | The style for the deleted count. |
| `only_nonzero_diffs` | `true` | Render status only for changed items. |
| `fromat` | `'([+$added]($added_style) )([-$deleted]($deleted_style) )'` | Format dari modul. |
| `format` | `'([+$added]($added_style) )([-$deleted]($deleted_style) )'` | Format dari modul. |
| `disabled` | `true` | Disables the `git_metrics` module. |
| `ignore_submodules` | `false` | Ignore changes to submodules |
@@ -1876,7 +1917,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
### Opsi
| Opsi | Bawaan | Deskripsi |
| ------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| -------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | The default format for `git_status` |
| `conflicted` | `'='` | This branch has merge conflicts. |
| `ahead` | `'⇡'` | The format of `ahead` |
@@ -1894,6 +1935,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
| `ignore_submodules` | `false` | Ignore changes to submodules. |
| `disabled` | `false` | Disables the `git_status` module. |
| `windows_starship` | | Use this (Linux) path to a Windows Starship executable to render `git_status` when on Windows paths in WSL. |
| `use_git_executable` | `false` | Do not use `gitoxide` for computing the status, but use the `git` executable instead. |
### Variabel
@@ -1971,14 +2013,14 @@ windows_starship = '/mnt/c/Users/username/scoop/apps/starship/current/starship.e
The `gleam` module shows the currently installed version of [Gleam](https://gleam.run/). Secara bawaan, modul akan aktif jika beberapa syarat berikut telah terpenuhi:
- The current directory contains a `gleam.toml` file
- Direktori ini memiliki berkas `gleam.toml`
- The current directory contains a file with the `.gleam` extension
### Opsi
| Opsi | Bawaan | Deskripsi |
| ------------------- | ------------------------------------ | ----------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | Format dari modul. |
| `fromat` | `'via [$symbol($version )]($style)'` | Format dari modul. |
| `version_format` | `'v${raw}'` | Format dari versi. Variabel yang tersedia adalah `raw`, `major`, `minor`, & `patch` |
| `symbol` | `'⭐ '` | A format string representing the symbol of Gleam. |
| `detect_extensions` | `['gleam']` | Ekstensi mana yang sebaiknya memicu modul ini. |
@@ -2817,6 +2859,40 @@ truncation_length = 4
truncation_symbol = ''
```
## Mise
The `mise` module shows the current mise health as reported by running `mise doctor`.
### Opsi
| Opsi | Bawaan | Deskripsi |
| ------------------ | -------------------------------- | ------------------------------------------------ |
| `symbol` | `'mise '` | The symbol used before displaying _mise_ health. |
| `style` | `'bold purple'` | Gaya penataan untuk modul. |
| `fromat` | `'on [$symbol$health]($style) '` | Format dari modul. |
| `healthy_symbol` | `healthy` | The message displayed when _mise_ is healthy. |
| `unhealthy_symbol` | `unhealthy` | The message displayed when _mise_ is unhealthy. |
| `disabled` | `true` | Disables the `mise` module. |
### Variabel
| Variabel | Contoh | Deskripsi |
| --------- | --------- | --------------------------------- |
| health | `healthy` | The health of _mise_ |
| 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
[mise]
health = 'ready'
```
## Mojo
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
@@ -2881,6 +2957,37 @@ format = '[$symbol]($style)'
style = 'bold purple'
```
## Network Namespace
The `netns` module shows the current network namespace. This uses `ip netns identify` to get the network namespace, so only network namespaces mounted at `/var/run/netns` will be detected.
### Opsi
| Opsi | Bawaan | Deskripsi |
| ---------- | --------------------------------- | ----------------------------------------------------------------- |
| `fromat` | `'[$symbol \[$name\]]($style)'` | Format dari modul. |
| `symbol` | `'🛜 '` | The symbol used before the network namespace (defaults to empty). |
| `style` | `'blue bold dimmed'` | Gaya penataan untuk modul. |
| `disabled` | `false` | Disables the `netns` module. |
### Variabel
| Variabel | Contoh | Deskripsi |
| --------- | ---------- | ----------------------------------------- |
| name | `my-netns` | The name of the current network namespace |
| symbol | | Menyalin nilai dari opsi `symbol` |
| style\* | | Menyalin nilai dari opsi `style` |
### Contoh
```toml
# ~/.config/starship.toml
[netns]
style = 'bold yellow'
symbol = '🌐 '
```
## Nim
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). Secara bawaan, modul akan aktif jika beberapa syarat berikut telah terpenuhi:
@@ -2975,6 +3082,8 @@ The `nodejs` module shows the currently installed version of [Node.js](https://n
- The current directory contains a file with the `.js`, `.mjs` or `.cjs` extension
- The current directory contains a file with the `.ts`, `.mts` or `.cts` extension
Additionally, the module will be hidden by default if the directory contains a `bunfig.toml`, `bun.lock`, or `bun.lockb` file, overriding the above conditions.
### Opsi
| Opsi | Bawaan | Deskripsi |
@@ -3202,6 +3311,7 @@ Amazon = "🙂 "
Android = "🤖 "
Arch = "🎗️ "
Artix = "🎗️ "
Bluefin = "🐟 "
CachyOS = "🎗️ "
CentOS = "💠 "
Debian = "🌀 "
@@ -3280,6 +3390,7 @@ Arch = "Arch is the best! "
The `package` module is shown when the current directory is the repository for a package, and shows its current version. The module currently supports `npm`, `nimble`, `cargo`, `poetry`, `python`, `composer`, `gradle`, `julia`, `mix`, `helm`, `shards`, `daml` and `dart` packages.
- [**npm**](https://docs.npmjs.com/cli/commands/npm) The `npm` package version is extracted from the `package.json` present in the current directory
- [**JSR**](https://jsr.io/) The `jsr` package version is extracted from the `jsr.json`/`jsr.jsonc` or `deno.json`/`deno.jsonc` present in the current directory
- [**Cargo**](https://doc.rust-lang.org/cargo/) The `cargo` package version is extracted from the `Cargo.toml` present in the current directory
- [**Nimble**](https://github.com/nim-lang/nimble) - The `nimble` package version is extracted from the `*.nimble` file present in the current directory with the `nimble dump` command
- [**Poetry**](https://python-poetry.org/) The `poetry` package version is extracted from the `pyproject.toml` present in the current directory
@@ -3424,6 +3535,49 @@ The `pijul_channel` module shows the active channel of the repo in your current
| `truncation_symbol` | `'…'` | The symbol used to indicate a branch name was truncated. |
| `disabled` | `true` | Disables the `pijul` module. |
## Pixi
The `pixi` module shows the installed [pixi](https://pixi.sh) version as well as the activated environment, if `$PIXI_ENVIRONMENT_NAME` is set.
::: tip
This does not suppress pixi's own prompt modifier, you may want to run `pixi config set change-ps1 false`.
:::
### Opsi
| Opsi | Bawaan | Deskripsi |
| -------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `fromat` | `'via [$symbol($version )(\($environment\) )]($style)'` | Format dari modul. |
| `version_format` | `'v${raw}'` | Format dari versi. Available vars are `raw`, `major`, `minor`, & `patch`. |
| `symbol` | `'🧚 '` | Simbol yang digunakan sebelum nama environment. |
| `style` | `'yellow bold' | Gaya penataan untuk modul. |
| `show_default_environment` | `true` | Whether to indicate that the `default` environment of your project is activated. |
| `pixi_binary` | `['pixi']` | Configures the pixi binary that Starship should execute when getting the version. |
| `detect_extensions` | `[]` | Ekstensi mana yang sebaiknya memicu modul ini. |
| `detect_files` | `['pixi.toml']` | filenames mana yang sebaiknya memicu modul ini. |
| `detect_folders` | `['.pixi']` | Folder mana yang sebaiknya memicul modul ini. |
| `disabled` | `false` | Disables the `pixi` module. |
### Variabel
| Variabel | Contoh | Deskripsi |
| ----------- | --------- | --------------------------------- |
| version | `v0.33.0` | The version of `pixi` |
| environment | `py311` | The current pixi environment |
| symbol | | Menyalin nilai dari opsi `symbol` |
| style | | Menyalin nilai dari opsi `style` |
### Contoh
```toml
# ~/.config/starship.toml
[pixi]
format = '[$symbol$environment](yellow) '
```
## Pulumi
The `pulumi` module shows the current username, selected [Pulumi Stack](https://www.pulumi.com/docs/intro/concepts/stack/), and version.
@@ -3538,7 +3692,6 @@ 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
@@ -3546,16 +3699,16 @@ By default, the module will be shown if any of the following conditions are met:
### 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. |
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should execute 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_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. |
+2
View File
@@ -229,10 +229,12 @@ Alternatively, install Starship using any of the following package managers:
| Alpine Linux 3.13+ | [Alpine Linux Packages](https://pkgs.alpinelinux.org/packages?name=starship) | `apk add starship` |
| Arch Linux | [Arch Linux Extra](https://archlinux.org/packages/extra/x86_64/starship) | `pacman -S starship` |
| CentOS 7+ | [Copr](https://copr.fedorainfracloud.org/coprs/atim/starship) | `dnf copr enable atim/starship` <br /> `dnf install starship` |
| Debian 13+ | [Debian Main](https://sources.debian.org/src/starship/1.22.1-1/) | `apt install starship` |
| Gentoo | [Gentoo Packages](https://packages.gentoo.org/packages/app-shells/starship) | `emerge app-shells/starship` |
| Manjaro | | `pacman -S starship` |
| NixOS | [nixpkgs](https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/misc/starship/default.nix) | `nix-env -iA nixpkgs.starship` |
| openSUSE | [OSS](https://software.opensuse.org/package/starship) | `zypper in starship` |
| Ubuntu 25.04+ | [Ubuntu Universe](https://packages.ubuntu.com/source/plucky/starship) | `apt install starship` |
| Void Linux | [Void Linux Packages](https://github.com/void-linux/void-packages/tree/master/srcpkgs/starship) | `xbps-install -S starship` |
</details>
+6
View File
@@ -75,3 +75,9 @@ This preset is heavily inspired by [Pastel Powerline](./pastel-powerline.md), an
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.
[![Screenshot of Jetpack preset](/presets/img/jetpack.png "Click to view Jetpack preset")](./jetpack)
## [Catppuccin Powerline](./catppuccin-powerline.md)
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
[![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png "Click to view Catppuccin Powerline preset")](./catppuccin-powerline)
@@ -0,0 +1,28 @@
[Return to Presets](./README.md#catppuccin-powerline)
# Catppuccin Powerline Preset
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png)
### Prasyarat
- A [Nerd Font](https://www.nerdfonts.com/) installed and enabled in your terminal
### Konfigurasi
```sh
starship preset catppuccin-powerline -o ~/.config/starship.toml
```
By default this preset uses the Mocha flavour of Catppucin, but you can specify any of the flavours by modifying the value of `palette`:
- `catppuccin_mocha`
- `catppuccin_frappe`
- `catppuccin_macchiato`
- `catppucin_latte`
[Click to download TOML](/presets/toml/catppuccin-powerline.toml)
<<< @/public/presets/toml/catppuccin-powerline.toml
+168 -15
View File
@@ -328,6 +328,7 @@ $azure\
$nats\
$direnv\
$env_var\
$mise\
$crystal\
$custom\
$sudo\
@@ -339,6 +340,7 @@ $time\
$status\
$os\
$container\
$netns\
$shell\
$character"""
```
@@ -618,7 +620,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
*: This variable can only be used as a part of a style string
### Examples
### Esempio
#### Customize the format
@@ -629,15 +631,6 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
format = 'via [🍔 $version](bold green) '
```
#### Replace Node.js
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']
```
## C
The `c` module shows some information about your C compiler. By default the module will be shown if the current directory contains a `.c` or `.h` file.
@@ -684,6 +677,53 @@ If a C compiler is not supported by this module, you can request it by [raising
format = 'via [$name $version]($style)'
```
## CPP
The `cpp` module shows some information about your `C++` compiler. By default, the module will be shown if the current directory contains a `.cpp`, `.hpp`, or other `C++`-related files.
### Opzioni
| Opzione | Default | Descrizione |
| ------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version(-$name) )]($style)'` | The format string for the module. |
| `version_format` | `'v${raw}'` | Il formato della versione. Le variabili disponibili sono `raw`, `major`, `minor`, & `patch` |
| `symbol` | `'C++ '` | The symbol used before displaying the compiler details |
| `detect_extensions` | `['cpp', 'cc', 'cxx', 'c++', 'hpp', 'hh', 'hxx', 'h++', 'tcc']` | Quali estensioni dovrebbero attivare questo modulo. |
| `detect_files` | `[]` | Quali nomi di file dovrebbero attivare questo modulo. |
| `detect_folders` | `[]` | Quali cartelle dovrebbero attivare questo modulo. |
| `commands` | `[ [ 'c++', '--version' ], [ 'g++', '--version' ], [ 'clang++', '--version' ] ]` | How to detect what the compiler is |
| `style` | `'bold 149'` | Lo stile per il modulo. |
| `disabled` | `true` | Disables the `cpp` module. |
### Variables
| Variable | Esempio | Descrizione |
| -------- | ------- | ------------------------------------ |
| name | clang++ | The name of the compiler |
| version | 13.0.0 | The version of the compiler |
| symbol | | Mirrors the value of option `symbol` |
| style | | Mirrors the value of option `style` |
NB that `version` is not in the default format.
### Commands
The `commands` option accepts a list of commands to determine the compiler version and name.
Each command is represented as a list of the executable name, followed by its arguments, usually something like `['mycpp', '--version']`. Starship will try executing each command until it gets a result on STDOUT.
If a C++ compiler is not supported by this module, you can request it by [raising an issue on GitHub](https://github.com/starship/starship/).
### Esempio
```toml
# ~/.config/starship.toml
[cpp]
disabled = false
format = 'via [$name $version]($style)'
```
## Character
The `character` module shows a character (usually an arrow) beside where the text is entered in your terminal.
@@ -874,6 +914,7 @@ This does not suppress conda's own prompt modifier, you may want to run `conda c
| `style` | `'bold green'` | Lo stile per il modulo. |
| `format` | `'via [$symbol$environment]($style) '` | The format for the module. |
| `ignore_base` | `true` | Ignores `base` environment when activated. |
| `detect_env_vars` | `["!PIXI_ENVIRONMENT_NAME"]` | Which environment variable(s) should trigger this module. If it's a pixi environment, this module is not being triggered by default. |
| `disabled` | `false` | Disables the `conda` module. |
### Variables
@@ -1876,7 +1917,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
### Opzioni
| Opzione | Default | Descrizione |
| ------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| -------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | The default format for `git_status` |
| `conflicted` | `'='` | This branch has merge conflicts. |
| `ahead` | `'⇡'` | The format of `ahead` |
@@ -1894,6 +1935,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
| `ignore_submodules` | `false` | Ignore changes to submodules. |
| `disabled` | `false` | Disables the `git_status` module. |
| `windows_starship` | | Use this (Linux) path to a Windows Starship executable to render `git_status` when on Windows paths in WSL. |
| `use_git_executable` | `false` | Do not use `gitoxide` for computing the status, but use the `git` executable instead. |
### Variables
@@ -2817,6 +2859,40 @@ truncation_length = 4
truncation_symbol = ''
```
## Mise
The `mise` module shows the current mise health as reported by running `mise doctor`.
### Opzioni
| Opzione | Default | Descrizione |
| ------------------ | -------------------------------- | ------------------------------------------------ |
| `symbol` | `'mise '` | The symbol used before displaying _mise_ health. |
| `style` | `'bold purple'` | Lo stile per il modulo. |
| `format` | `'on [$symbol$health]($style) '` | The format for the module. |
| `healthy_symbol` | `healthy` | The message displayed when _mise_ is healthy. |
| `unhealthy_symbol` | `unhealthy` | The message displayed when _mise_ is unhealthy. |
| `disabled` | `true` | Disables the `mise` module. |
### Variables
| Variable | Esempio | Descrizione |
| --------- | --------- | ------------------------------------ |
| health | `healthy` | The health of _mise_ |
| 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
[mise]
health = 'ready'
```
## Mojo
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
@@ -2881,6 +2957,37 @@ format = '[$symbol]($style)'
style = 'bold purple'
```
## Network Namespace
The `netns` module shows the current network namespace. This uses `ip netns identify` to get the network namespace, so only network namespaces mounted at `/var/run/netns` will be detected.
### Opzioni
| Opzione | Default | Descrizione |
| ---------- | --------------------------------- | ----------------------------------------------------------------- |
| `format` | `'[$symbol \[$name\]]($style)'` | The format for the module. |
| `symbol` | `'🛜 '` | The symbol used before the network namespace (defaults to empty). |
| `style` | `'blue bold dimmed'` | Lo stile per il modulo. |
| `disabled` | `false` | Disables the `netns` module. |
### Variables
| Variable | Esempio | Descrizione |
| --------- | ---------- | ----------------------------------------- |
| name | `my-netns` | The name of the current network namespace |
| symbol | | Mirrors the value of option `symbol` |
| style\* | | Mirrors the value of option `style` |
### Esempio
```toml
# ~/.config/starship.toml
[netns]
style = 'bold yellow'
symbol = '🌐 '
```
## Nim
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). By default the module will be shown if any of the following conditions are met:
@@ -2975,6 +3082,8 @@ The `nodejs` module shows the currently installed version of [Node.js](https://n
- The current directory contains a file with the `.js`, `.mjs` or `.cjs` extension
- The current directory contains a file with the `.ts`, `.mts` or `.cts` extension
Additionally, the module will be hidden by default if the directory contains a `bunfig.toml`, `bun.lock`, or `bun.lockb` file, overriding the above conditions.
### Opzioni
| Opzione | Default | Descrizione |
@@ -3202,6 +3311,7 @@ Amazon = "🙂 "
Android = "🤖 "
Arch = "🎗️ "
Artix = "🎗️ "
Bluefin = "🐟 "
CachyOS = "🎗️ "
CentOS = "💠 "
Debian = "🌀 "
@@ -3280,6 +3390,7 @@ Arch = "Arch is the best! "
The `package` module is shown when the current directory is the repository for a package, and shows its current version. The module currently supports `npm`, `nimble`, `cargo`, `poetry`, `python`, `composer`, `gradle`, `julia`, `mix`, `helm`, `shards`, `daml` and `dart` packages.
- [**npm**](https://docs.npmjs.com/cli/commands/npm) The `npm` package version is extracted from the `package.json` present in the current directory
- [**JSR**](https://jsr.io/) The `jsr` package version is extracted from the `jsr.json`/`jsr.jsonc` or `deno.json`/`deno.jsonc` present in the current directory
- [**Cargo**](https://doc.rust-lang.org/cargo/) The `cargo` package version is extracted from the `Cargo.toml` present in the current directory
- [**Nimble**](https://github.com/nim-lang/nimble) - The `nimble` package version is extracted from the `*.nimble` file present in the current directory with the `nimble dump` command
- [**Poetry**](https://python-poetry.org/) The `poetry` package version is extracted from the `pyproject.toml` present in the current directory
@@ -3424,6 +3535,49 @@ The `pijul_channel` module shows the active channel of the repo in your current
| `truncation_symbol` | `'…'` | The symbol used to indicate a branch name was truncated. |
| `disabled` | `true` | Disables the `pijul` module. |
## Pixi
The `pixi` module shows the installed [pixi](https://pixi.sh) version as well as the activated environment, if `$PIXI_ENVIRONMENT_NAME` is set.
::: tip
This does not suppress pixi's own prompt modifier, you may want to run `pixi config set change-ps1 false`.
:::
### Opzioni
| Opzione | Default | Descrizione |
| -------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )(\($environment\) )]($style)'` | The format for the module. |
| `version_format` | `'v${raw}'` | Il formato della versione. Available vars are `raw`, `major`, `minor`, & `patch`. |
| `symbol` | `'🧚 '` | The symbol used before the environment name. |
| `style` | `'yellow bold' | Lo stile per il modulo. |
| `show_default_environment` | `true` | Whether to indicate that the `default` environment of your project is activated. |
| `pixi_binary` | `['pixi']` | Configures the pixi binary that Starship should execute when getting the version. |
| `detect_extensions` | `[]` | Quali estensioni dovrebbero attivare questo modulo. |
| `detect_files` | `['pixi.toml']` | Quali nomi di file dovrebbero attivare questo modulo. |
| `detect_folders` | `['.pixi']` | Quali cartelle dovrebbero attivare questo modulo. |
| `disabled` | `false` | Disables the `pixi` module. |
### Variables
| Variable | Esempio | Descrizione |
| ----------- | --------- | ------------------------------------ |
| version | `v0.33.0` | The version of `pixi` |
| environment | `py311` | The current pixi environment |
| symbol | | Mirrors the value of option `symbol` |
| style | | Mirrors the value of option `style` |
### Esempio
```toml
# ~/.config/starship.toml
[pixi]
format = '[$symbol$environment](yellow) '
```
## Pulumi
The `pulumi` module shows the current username, selected [Pulumi Stack](https://www.pulumi.com/docs/intro/concepts/stack/), and version.
@@ -3538,7 +3692,6 @@ 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
@@ -3546,16 +3699,16 @@ By default, the module will be shown if any of the following conditions are met:
### 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. |
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should execute 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_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. |
+2
View File
@@ -229,10 +229,12 @@ Alternatively, install Starship using any of the following package managers:
| Alpine Linux 3.13+ | [Alpine Linux Packages](https://pkgs.alpinelinux.org/packages?name=starship) | `apk add starship` |
| Arch Linux | [Arch Linux Extra](https://archlinux.org/packages/extra/x86_64/starship) | `pacman -S starship` |
| CentOS 7+ | [Copr](https://copr.fedorainfracloud.org/coprs/atim/starship) | `dnf copr enable atim/starship` <br /> `dnf install starship` |
| Debian 13+ | [Debian Main](https://sources.debian.org/src/starship/1.22.1-1/) | `apt install starship` |
| Gentoo | [Gentoo Packages](https://packages.gentoo.org/packages/app-shells/starship) | `emerge app-shells/starship` |
| Manjaro | | `pacman -S starship` |
| NixOS | [nixpkgs](https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/misc/starship/default.nix) | `nix-env -iA nixpkgs.starship` |
| openSUSE | [OSS](https://software.opensuse.org/package/starship) | `zypper in starship` |
| Ubuntu 25.04+ | [Ubuntu Universe](https://packages.ubuntu.com/source/plucky/starship) | `apt install starship` |
| Void Linux | [Void Linux Packages](https://github.com/void-linux/void-packages/tree/master/srcpkgs/starship) | `xbps-install -S starship` |
</details>
+6
View File
@@ -75,3 +75,9 @@ This preset is heavily inspired by [Pastel Powerline](./pastel-powerline.md), an
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.
[![Screenshot of Jetpack preset](/presets/img/jetpack.png "Click to view Jetpack preset")](./jetpack)
## [Catppuccin Powerline](./catppuccin-powerline.md)
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
[![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png "Click to view Catppuccin Powerline preset")](./catppuccin-powerline)
@@ -0,0 +1,28 @@
[Return to Presets](./README.md#catppuccin-powerline)
# Catppuccin Powerline Preset
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png)
### Prerequisiti
- A [Nerd Font](https://www.nerdfonts.com/) installed and enabled in your terminal
### Configurazione
```sh
starship preset catppuccin-powerline -o ~/.config/starship.toml
```
By default this preset uses the Mocha flavour of Catppucin, but you can specify any of the flavours by modifying the value of `palette`:
- `catppuccin_mocha`
- `catppuccin_frappe`
- `catppuccin_macchiato`
- `catppucin_latte`
[Click to download TOML](/presets/toml/catppuccin-powerline.toml)
<<< @/public/presets/toml/catppuccin-powerline.toml
+1 -1
View File
@@ -166,7 +166,7 @@ onMounted(() => {
::: warning
これは将来的に変更される可能性があります。 Only Nushell v0.96+ is supported.
これは将来的に変更される可能性があります。 Nushell v0.96+ のみサポートされています。
:::
+181 -28
View File
@@ -328,6 +328,7 @@ $azure\
$nats\
$direnv\
$env_var\
$mise\
$crystal\
$custom\
$sudo\
@@ -339,6 +340,7 @@ $time\
$status\
$os\
$container\
$netns\
$shell\
$character"""
```
@@ -629,15 +631,6 @@ symbol = '🦬 '
format = 'via [🍔 $version](bold green) '
```
#### Node.js を置き換える
Bun ランタイムだけが表示されるように、設定中の [nodejs モジュール](#nodejs) の `detect_files` プロパティを上書きできます。
```toml
[nodejs]
detect_files = ['package.json', '.node-version', '!bunfig.toml', '!bun.lockb']
```
## C
`c` モジュールは、利用しているCコンパイラに関するいくつかの情報を表示します。 デフォルトでは、カレントディレクトリに`.c`または`.h`ファイルが含まれている場合、モジュールが表示されます。
@@ -684,6 +677,53 @@ detect_files = ['package.json', '.node-version', '!bunfig.toml', '!bun.lockb']
format = 'via [$name $version]($style)'
```
## CPP
The `cpp` module shows some information about your `C++` compiler. By default, the module will be shown if the current directory contains a `.cpp`, `.hpp`, or other `C++`-related files.
### オプション
| オプション | デフォルト | 説明 |
| ------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------ |
| `format` | `'via [$symbol($version(-$name) )]($style)'` | モジュールのフォーマット文字列。 |
| `version_format` | `'v${raw}'` | バージョンのフォーマット。 使用可能な変数は`raw``major``minor``patch`です。 |
| `symbol` | `'C++ '` | コンパイラの詳細を表示する前に使用される記号です。 |
| `detect_extensions` | `['cpp', 'cc', 'cxx', 'c++', 'hpp', 'hh', 'hxx', 'h++', 'tcc']` | どの拡張子がこのモジュールをアクティブにするか |
| `detect_files` | `[]` | どのファイル名がこのモジュールをアクティブにするか |
| `detect_folders` | `[]` | どのフォルダーがこのモジュールをアクティブにするか |
| `commands` | `[ [ 'c++', '--version' ], [ 'g++', '--version' ], [ 'clang++', '--version' ] ]` | コンパイラを検出する方法 |
| `style` | `'bold 149'` | モジュールのスタイルです。 |
| `disabled` | `true` | Disables the `cpp` module. |
### 変数
| 変数 | 設定例 | 説明 |
| ------- | ------- | ----------------------- |
| name | clang++ | コンパイラ名 |
| version | 13.0.0 | コンパイラのバージョン |
| symbol | | オプション `symbol` の値をミラーする |
| style | | オプション `style` の値をミラーする |
`version`はデフォルトのフォーマットではないことに注意してください。
### Commands
`commands`オプションは、コンパイラのバージョンと名前を判別するためのコマンドのリストを受け入れます。
Each command is represented as a list of the executable name, followed by its arguments, usually something like `['mycpp', '--version']`. StarshipはSTDOUTから結果が得られるまで各コマンドを実行を試みます。
If a C++ compiler is not supported by this module, you can request it by [raising an issue on GitHub](https://github.com/starship/starship/).
### 設定例
```toml
# ~/.config/starship.toml
[cpp]
disabled = false
format = 'via [$name $version]($style)'
```
## Character
`character`モジュールは、端末でテキストが入力される場所の横に文字(通常は矢印)を表示します。
@@ -874,6 +914,7 @@ Note: これはconda自身の プロンプト修飾子 を抑制しません。`
| `style` | `'bold green'` | モジュールのスタイルです。 |
| `format` | `'via [$symbol$environment]($style) '` | module のフォーマットです。 |
| `ignore_base` | `true` | アクティブになった時、環境`base`を無視します。 |
| `detect_env_vars` | `["!PIXI_ENVIRONMENT_NAME"]` | このモジュールを活性化する環境変数。 If it's a pixi environment, this module is not being triggered by default. |
| `disabled` | `false` | `conda`モジュールを無効にします。 |
### 変数
@@ -1876,7 +1917,7 @@ WSL環境のWindowsディレクトリ(例: `/mnt/c/`以下) では、Git Status
### オプション
| オプション | デフォルト | 説明 |
| ------------------- | ----------------------------------------------- | ---------------------------------------------------------------------- |
| -------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------- |
| `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | `git_status` のデフォルトフォーマット |
| `conflicted` | `'='` | このブランチにはマージの競合があります。 |
| `ahead` | `'⇡'` | `ahead`のフォーマット |
@@ -1894,6 +1935,7 @@ WSL環境のWindowsディレクトリ(例: `/mnt/c/`以下) では、Git Status
| `ignore_submodules` | `false` | サブモジュールの変更を無視します。 |
| `disabled` | `false` | `git_status`モジュールを無効にします。 |
| `windows_starship` | | WSLでWindowsディレクトリの`git_status`で使用するWindows Starshipの実行ファイルのLinux上でのパス。 |
| `use_git_executable` | `false` | Do not use `gitoxide` for computing the status, but use the `git` executable instead. |
### 変数
@@ -2122,10 +2164,10 @@ format = 'via [🐂](yellow bold) '
### 変数
| 変数 | 設定例 | 説明 |
| ------- | -------- | ----------------------- |
| ------- | -------- | ------------------------- |
| version | `v7.5.1` | `gradle`のバージョン |
| symbol | | オプション `symbol` の値をミラーする |
| style* | | オプション `style` の値をミラーする |
| symbol | | オプション `symbol` の値をミラーします。 |
| style* | | オプション `style` の値をミラーします。 |
*: この変数は、スタイル文字列の一部としてのみ使用することができます。
@@ -2157,8 +2199,8 @@ format = 'via [🐂](yellow bold) '
| version | | 現在のプロジェクトが Stack プロジェクトかどうかに応じて `ghc_version` または `snapshot` を反映します。 |
| snapshot | `lts-18.12` | 現在選択されている Stack スナップショットです。 |
| ghc\_version | `9.2.1` | 現在インストールされている GHC バージョンです。 |
| symbol | | オプション `symbol` の値をミラーします。 |
| style\* | | オプション `style` の値をミラーします。 |
| symbol | | オプション `symbol` の値をミラーする |
| style\* | | オプション `style` の値をミラーする |
*: この変数は、スタイル文字列の一部としてのみ使用することができます。
@@ -2225,10 +2267,10 @@ format = "via [⌘ $version](bold fg:202) "
### 変数
| 変数 | 設定例 | 説明 |
| --------- | -------- | ----------------------- |
| --------- | -------- | ------------------------ |
| version | `v3.1.1` | `helm` のバージョン |
| symbol | | オプション `symbol` の値をミラーする |
| style\* | | オプション `style` の値をミラーする |
| style\* | | オプション `style` の値をミラーします。 |
*: この変数は、スタイル文字列の一部としてのみ使用することができます。
@@ -2263,7 +2305,7 @@ format = 'via [⎈ $version](bold white) '
| 変数 | 設定例 | 説明 |
| ---------- | ---------- | ------------------------ |
| hostname | `computer` | コンピュータのホスト名です。 |
| style\* | | オプション `style` の値をミラーします。 |
| style\* | | オプション `style` の値をミラーする |
| ssh_symbol | `'🌏 '` | SSHセッションに接続していることを表すシンボル |
*: この変数は、スタイル文字列の一部としてのみ使用することができます。
@@ -2817,6 +2859,40 @@ truncation_length = 4
truncation_symbol = ''
```
## Mise
The `mise` module shows the current mise health as reported by running `mise doctor`.
### オプション
| オプション | デフォルト | 説明 |
| ------------------ | -------------------------------- | ------------------------------------------------ |
| `symbol` | `'mise '` | The symbol used before displaying _mise_ health. |
| `style` | `'bold purple'` | モジュールのスタイルです。 |
| `format` | `'on [$symbol$health]($style) '` | module のフォーマットです。 |
| `healthy_symbol` | `healthy` | The message displayed when _mise_ is healthy. |
| `unhealthy_symbol` | `unhealthy` | The message displayed when _mise_ is unhealthy. |
| `disabled` | `true` | Disables the `mise` module. |
### 変数
| 変数 | 設定例 | 説明 |
| --------- | --------- | ----------------------- |
| health | `healthy` | The health of _mise_ |
| symbol | | オプション `symbol` の値をミラーする |
| style\* | | オプション `style` の値をミラーする |
*: この変数は、スタイル文字列の一部としてのみ使用することができます。
### 設定例
```toml
# ~/.config/starship.toml
[mise]
health = 'ready'
```
## Mojo
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
@@ -2881,6 +2957,37 @@ format = '[$symbol]($style)'
style = 'bold purple'
```
## Network Namespace
The `netns` module shows the current network namespace. This uses `ip netns identify` to get the network namespace, so only network namespaces mounted at `/var/run/netns` will be detected.
### オプション
| オプション | デフォルト | 説明 |
| ---------- | --------------------------------- | ----------------------------------------------------------------- |
| `format` | `'[$symbol \[$name\]]($style)'` | module のフォーマットです。 |
| `symbol` | `'🛜 '` | The symbol used before the network namespace (defaults to empty). |
| `style` | `'blue bold dimmed'` | モジュールのスタイルです。 |
| `disabled` | `false` | Disables the `netns` module. |
### 変数
| 変数 | 設定例 | 説明 |
| --------- | ---------- | ----------------------------------------- |
| name | `my-netns` | The name of the current network namespace |
| symbol | | オプション `symbol` の値をミラーする |
| style\* | | オプション `style` の値をミラーする |
### 設定例
```toml
# ~/.config/starship.toml
[netns]
style = 'bold yellow'
symbol = '🌐 '
```
## Nim
`nim`モジュールは、現在インストールされている[Nim](https://nim-lang.org/)のバージョンを表示します。 デフォルトでは次の条件のいずれかが満たされると、モジュールが表示されます。
@@ -2975,6 +3082,8 @@ format = 'via [☃️ $state( \($name\))](bold blue) '
- カレントディレクトリに拡張子が`.js``.mjs`または`.cjs`のファイルが含まれている
- カレントディレクトリに拡張子が`.ts``.mts`または`.cts`のファイルが含まれている
Additionally, the module will be hidden by default if the directory contains a `bunfig.toml`, `bun.lock`, or `bun.lockb` file, overriding the above conditions.
### オプション
| オプション | デフォルト | 説明 |
@@ -3202,6 +3311,7 @@ Amazon = "🙂 "
Android = "🤖 "
Arch = "🎗️ "
Artix = "🎗️ "
Bluefin = "🐟 "
CachyOS = "🎗️ "
CentOS = "💠 "
Debian = "🌀 "
@@ -3280,6 +3390,7 @@ Arch = "Arch is the best! "
`package` モジュールは、現在のディレクトリがパッケージのリポジトリである場合に表示され、現在のバージョンが表示されます。 The module currently supports `npm`, `nimble`, `cargo`, `poetry`, `python`, `composer`, `gradle`, `julia`, `mix`, `helm`, `shards`, `daml` and `dart` packages.
- [**npm**](https://docs.npmjs.com/cli/commands/npm) The `npm` package version is extracted from the `package.json` present in the current directory
- [**JSR**](https://jsr.io/) The `jsr` package version is extracted from the `jsr.json`/`jsr.jsonc` or `deno.json`/`deno.jsonc` present in the current directory
- [**Cargo**](https://doc.rust-lang.org/cargo/) The `cargo` package version is extracted from the `Cargo.toml` present in the current directory
- [**Nimble**](https://github.com/nim-lang/nimble) - The `nimble` package version is extracted from the `*.nimble` file present in the current directory with the `nimble dump` command
- [**Poetry**](https://python-poetry.org/) The `poetry` package version is extracted from the `pyproject.toml` present in the current directory
@@ -3424,6 +3535,49 @@ The `pijul_channel` module shows the active channel of the repo in your current
| `truncation_symbol` | `'…'` | ブランチ名が切り捨てられていることを示すための記号です。 |
| `disabled` | `true` | Disables the `pijul` module. |
## Pixi
The `pixi` module shows the installed [pixi](https://pixi.sh) version as well as the activated environment, if `$PIXI_ENVIRONMENT_NAME` is set.
::: tip
This does not suppress pixi's own prompt modifier, you may want to run `pixi config set change-ps1 false`.
:::
### オプション
| オプション | デフォルト | 説明 |
| -------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )(\($environment\) )]($style)'` | module のフォーマットです。 |
| `version_format` | `'v${raw}'` | バージョンのフォーマット。 Available vars are `raw`, `major`, `minor`, & `patch`. |
| `symbol` | `'🧚 '` | 環境名の直前に使用されるシンボルです。 |
| `style` | `'yellow bold' | モジュールのスタイルです。 |
| `show_default_environment` | `true` | Whether to indicate that the `default` environment of your project is activated. |
| `pixi_binary` | `['pixi']` | Configures the pixi binary that Starship should execute when getting the version. |
| `detect_extensions` | `[]` | どの拡張子がこのモジュールをアクティブにするか |
| `detect_files` | `['pixi.toml']` | どのファイル名がこのモジュールをアクティブにするか |
| `detect_folders` | `['.pixi']` | どのフォルダーがこのモジュールをアクティブにするか |
| `disabled` | `false` | Disables the `pixi` module. |
### 変数
| 変数 | 設定例 | 説明 |
| ----------- | --------- | ---------------------------- |
| version | `v0.33.0` | The version of `pixi` |
| environment | `py311` | The current pixi environment |
| symbol | | オプション `symbol` の値をミラーする |
| style | | オプション `style` の値をミラーする |
### 設定例
```toml
# ~/.config/starship.toml
[pixi]
format = '[$symbol$environment](yellow) '
```
## Pulumi
The `pulumi` module shows the current username, selected [Pulumi Stack](https://www.pulumi.com/docs/intro/concepts/stack/), and version.
@@ -3538,7 +3692,6 @@ 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.
- 仮想環境がアクティブである
@@ -3546,16 +3699,16 @@ The `python` module shows the currently installed version of [Python](https://ww
### オプション
| オプション | デフォルト | 説明 |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| -------------------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------- |
| `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. |
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should execute 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_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini']` | どのファイル名がこのモジュールをアクティブにするか |
| `detect_folders` | `[]` | どのフォルダーがこのモジュールをアクティブにするか |
| `disabled` | `false` | `python`モジュールを無効にします。 |
@@ -4039,7 +4192,7 @@ The `solidity` module shows the currently installed version of [Solidity](https:
| 変数 | 設定例 | 説明 |
| --------- | -------- | ------------------------- |
| version | `v0.8.1` | The version of `solidity` |
| symbol | | オプション `symbol` の値をミラーす |
| symbol | | オプション `symbol` の値をミラーします |
| style\* | | オプション `style` の値をミラーする |
*: この変数は、スタイル文字列の一部としてのみ使用することができます。
@@ -4072,7 +4225,7 @@ format = "via [S $version](blue bold)"
| ----------- | ------------ | ----------------------- |
| environment | `astronauts` | 現在の spack 環境 |
| symbol | | オプション `symbol` の値をミラーする |
| style\* | | オプション `style` の値をミラーす |
| style\* | | オプション `style` の値をミラーします |
*: この変数は、スタイル文字列の一部としてのみ使用することができます。
@@ -4220,9 +4373,9 @@ disabled = false
### 変数
| 変数 | 設定例 | 説明 |
| --------- | -------- | ------------------------ |
| --------- | -------- | ----------------------- |
| version | `v5.2.4` | `swift` のバージョン |
| symbol | | オプション `symbol` の値をミラーします |
| symbol | | オプション `symbol` の値をミラーす |
| style\* | | オプション `style` の値をミラーする |
*: この変数は、スタイル文字列の一部としてのみ使用することができます。
@@ -4322,9 +4475,9 @@ format = '[🏎💨 $workspace]($style) '
### 変数
| 変数 | 設定例 | 説明 |
| --------- | ---------- | ----------------------- |
| --------- | ---------- | ---------------------- |
| time | `13:08:10` | 現在時刻 |
| style\* | | オプション `style` の値をミラーします |
| style\* | | オプション `style` の値をミラーす |
*: この変数は、スタイル文字列の一部としてのみ使用することができます。
+1 -1
View File
@@ -80,7 +80,7 @@ env STARSHIP_LOG=trace starship timings
トレースログおよび、実行に 1 ミリ秒以上かかったか何か出力をした全てのモジュールの個別解析を出力します。
バグを見つけた場合は、 `bug-report` コマンドを用いて GitHub の問題を作成できます。
バグを見つけた場合は、 `bug-report` コマンドを用いて GitHub のissueを作成できます。
```sh
starship bug-report
+3 -1
View File
@@ -229,10 +229,12 @@ curl -sS https://starship.rs/install.sh | sh
| Alpine Linux 3.13+ | [Alpine Linux Packages](https://pkgs.alpinelinux.org/packages?name=starship) | `apk add starship` |
| Arch Linux | [Arch Linux Extra](https://archlinux.org/packages/extra/x86_64/starship) | `pacman -S starship` |
| CentOS 7+ | [Copr](https://copr.fedorainfracloud.org/coprs/atim/starship) | `dnf copr enable atim/starship` <br /> `dnf install starship` |
| Debian 13+ | [Debian Main](https://sources.debian.org/src/starship/1.22.1-1/) | `apt install starship` |
| Gentoo | [Gentoo Packages](https://packages.gentoo.org/packages/app-shells/starship) | `emerge app-shells/starship` |
| Manjaro | | `pacman -S starship` |
| NixOS | [nixpkgs](https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/misc/starship/default.nix) | `nix-env -iA nixpkgs.starship` |
| openSUSE | [OSS](https://software.opensuse.org/package/starship) | `zypper in starship` |
| Ubuntu 25.04+ | [Ubuntu Universe](https://packages.ubuntu.com/source/plucky/starship) | `apt install starship` |
| Void Linux | [Void Linux Packages](https://github.com/void-linux/void-packages/tree/master/srcpkgs/starship) | `xbps-install -S starship` |
</details>
@@ -345,7 +347,7 @@ mkdir ($nu.data-dir | path join "vendor/autoload")
starship init nu | save -f ($nu.data-dir | path join "vendor/autoload/starship.nu")
```
Note: Only Nushell v0.96+ is supported
注意: Nushell v0.96以降でサポートされています
</details>
+7 -1
View File
@@ -24,7 +24,7 @@
## [Bracketed Segments](./bracketed-segments.md)
このプリセットは付属のモジュール全てのフォーマットを変更し、デフォルトのStarshipの表示("via", "on", etc.)から、それぞれの情報を括弧で区分けするように変更します。
このプリセットは付属のモジュール全てのフォーマットを変更し、デフォルトのStarshipの表示("via", "on", etc.) から、それぞれの情報を括弧で区分けするように変更します。
[![Bracketed Segmentsプリセットのスクリーンショット](/presets/img/bracketed-segments.png "Bracketed Segmentsプリセットを表示するにはクリックしてください")](./bracketed-segments)
@@ -75,3 +75,9 @@
[geometry](https://github.com/geometry-zsh/geometry) と [spaceship](https://github.com/spaceship-prompt/spaceship-prompt) のプロンプトにインスパイアされた擬似ミニマリストプリセットです。
[![Jetpack プリセットのスクリーンショット](/presets/img/jetpack.png "Jetpack プリセットを表示するにはクリックしてください")](./jetpack)
## [Catppuccin Powerline](./catppuccin-powerline.md)
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
[![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png "Click to view Catppuccin Powerline preset")](./catppuccin-powerline)
+1 -1
View File
@@ -2,7 +2,7 @@
# Bracketed Segmentsプリセット
このプリセットは付属のモジュール全てのフォーマットを変更し、デフォルトのStarshipの表示("via", "on", etc.)から、それぞれの情報を括弧で区分けするように変更します。
このプリセットは付属のモジュール全てのフォーマットを変更し、デフォルトのStarshipの表示("via", "on", etc.) から、それぞれの情報を括弧で区分けするように変更します。
![Bracketed Segmentsプリセットのスクリーンショット](/presets/img/bracketed-segments.png)
@@ -0,0 +1,28 @@
[プリセット一覧に戻る](./README.md#catppuccin-powerline)
# Catppuccin Powerline プリセット
[Catppuccin](https://github.com/catppuccin/catppuccin) のテーマを利用して [Gruvbox Rainbow](./gruvbox-rainbow.md) に最小限の変更を加えたプリセットです。
![Catppuccin Powerline プリセットのスクリーンショット](/presets/img/catppuccin-powerline.png)
### 必要なもの
- [Nerd Font](https://www.nerdfonts.com/) をインストールし、ターミナルで有効化する
### 設定
```sh
starship preset catppuccin-powerline -o ~/.config/starship.toml
```
デフォルトでは、このプリセットは Catppuchin の Mocha テーマを使用します。 `palette` の値を変更することで、他のテーマを使用することができます:
- `catppuccin_mocha`
- `catppuccin_frappe`
- `catppuccin_macciato`
- `catppuccin_latte`
[クリックしてTOMLファイルをダウンロード](/presets/toml/catppuccin-powerline.toml)
<<< @/public/presets/toml/catppuccin-powerline.toml
+1 -1
View File
@@ -166,7 +166,7 @@ onMounted(() => {
::: warning
추후에 변경될 예정입니다. Only Nushell v0.96+ is supported.
추후에 변경될 예정입니다. Nushell v0.96 버전 이상에서만 지원됩니다.
:::
+167 -14
View File
@@ -328,6 +328,7 @@ $azure\
$nats\
$direnv\
$env_var\
$mise\
$crystal\
$custom\
$sudo\
@@ -339,6 +340,7 @@ $time\
$status\
$os\
$container\
$netns\
$shell\
$character"""
```
@@ -629,15 +631,6 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
format = 'via [🍔 $version](bold green) '
```
#### Replace Node.js
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']
```
## C
The `c` module shows some information about your C compiler. By default the module will be shown if the current directory contains a `.c` or `.h` file.
@@ -684,6 +677,53 @@ If a C compiler is not supported by this module, you can request it by [raising
format = 'via [$name $version]($style)'
```
## CPP
The `cpp` module shows some information about your `C++` compiler. By default, the module will be shown if the current directory contains a `.cpp`, `.hpp`, or other `C++`-related files.
### Options
| Option | Default | Description |
| ------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version(-$name) )]($style)'` | The format string for the module. |
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
| `기호` | `'C++ '` | The symbol used before displaying the compiler details |
| `detect_extensions` | `['cpp', 'cc', 'cxx', 'c++', 'hpp', 'hh', 'hxx', 'h++', 'tcc']` | Which extensions should trigger this module. |
| `detect_files` | `[]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. |
| `commands` | `[ [ 'c++', '--version' ], [ 'g++', '--version' ], [ 'clang++', '--version' ] ]` | How to detect what the compiler is |
| `style` | `'bold 149'` | The style for the module. |
| `disabled` | `true` | Disables the `cpp` module. |
### Variables
| Variable | 예시 | Description |
| -------- | ------- | ------------------------------------ |
| name | clang++ | The name of the compiler |
| version | 13.0.0 | The version of the compiler |
| 기호 | | Mirrors the value of option `symbol` |
| style | | Mirrors the value of option `style` |
NB that `version` is not in the default format.
### Commands
The `commands` option accepts a list of commands to determine the compiler version and name.
Each command is represented as a list of the executable name, followed by its arguments, usually something like `['mycpp', '--version']`. Starship will try executing each command until it gets a result on STDOUT.
If a C++ compiler is not supported by this module, you can request it by [raising an issue on GitHub](https://github.com/starship/starship/).
### 예시
```toml
# ~/.config/starship.toml
[cpp]
disabled = false
format = 'via [$name $version]($style)'
```
## Character
The `character` module shows a character (usually an arrow) beside where the text is entered in your terminal.
@@ -874,6 +914,7 @@ This does not suppress conda's own prompt modifier, you may want to run `conda c
| `style` | `'bold green'` | The style for the module. |
| `format` | `'via [$symbol$environment]($style) '` | The format for the module. |
| `ignore_base` | `true` | Ignores `base` environment when activated. |
| `detect_env_vars` | `["!PIXI_ENVIRONMENT_NAME"]` | Which environment variable(s) should trigger this module. If it's a pixi environment, this module is not being triggered by default. |
| `disabled` | `false` | Disables the `conda` module. |
### Variables
@@ -1876,7 +1917,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
### Options
| Option | Default | Description |
| ------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| -------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | The default format for `git_status` |
| `conflicted` | `'='` | This branch has merge conflicts. |
| `ahead` | `'⇡'` | The format of `ahead` |
@@ -1894,6 +1935,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
| `ignore_submodules` | `false` | Ignore changes to submodules. |
| `disabled` | `false` | Disables the `git_status` module. |
| `windows_starship` | | Use this (Linux) path to a Windows Starship executable to render `git_status` when on Windows paths in WSL. |
| `use_git_executable` | `false` | Do not use `gitoxide` for computing the status, but use the `git` executable instead. |
### Variables
@@ -2817,6 +2859,40 @@ truncation_length = 4
truncation_symbol = ''
```
## Mise
The `mise` module shows the current mise health as reported by running `mise doctor`.
### Options
| Option | Default | Description |
| ------------------ | -------------------------------- | ------------------------------------------------ |
| `기호` | `'mise '` | The symbol used before displaying _mise_ health. |
| `style` | `'bold purple'` | The style for the module. |
| `format` | `'on [$symbol$health]($style) '` | The format for the module. |
| `healthy_symbol` | `healthy` | The message displayed when _mise_ is healthy. |
| `unhealthy_symbol` | `unhealthy` | The message displayed when _mise_ is unhealthy. |
| `disabled` | `true` | Disables the `mise` module. |
### Variables
| Variable | 예시 | Description |
| --------- | --------- | ------------------------------------ |
| health | `healthy` | The health of _mise_ |
| 기호 | | 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
[mise]
health = 'ready'
```
## Mojo
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
@@ -2881,6 +2957,37 @@ format = '[$symbol]($style)'
style = 'bold purple'
```
## Network Namespace
The `netns` module shows the current network namespace. This uses `ip netns identify` to get the network namespace, so only network namespaces mounted at `/var/run/netns` will be detected.
### Options
| Option | Default | Description |
| ---------- | --------------------------------- | ----------------------------------------------------------------- |
| `format` | `'[$symbol \[$name\]]($style)'` | The format for the module. |
| `기호` | `'🛜 '` | The symbol used before the network namespace (defaults to empty). |
| `style` | `'blue bold dimmed'` | The style for the module. |
| `disabled` | `false` | Disables the `netns` module. |
### Variables
| Variable | 예시 | Description |
| --------- | ---------- | ----------------------------------------- |
| name | `my-netns` | The name of the current network namespace |
| 기호 | | Mirrors the value of option `symbol` |
| style\* | | Mirrors the value of option `style` |
### 예시
```toml
# ~/.config/starship.toml
[netns]
style = 'bold yellow'
symbol = '🌐 '
```
## Nim
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). By default the module will be shown if any of the following conditions are met:
@@ -2975,6 +3082,8 @@ The `nodejs` module shows the currently installed version of [Node.js](https://n
- The current directory contains a file with the `.js`, `.mjs` or `.cjs` extension
- The current directory contains a file with the `.ts`, `.mts` or `.cts` extension
Additionally, the module will be hidden by default if the directory contains a `bunfig.toml`, `bun.lock`, or `bun.lockb` file, overriding the above conditions.
### Options
| Option | Default | Description |
@@ -3202,6 +3311,7 @@ Amazon = "🙂 "
Android = "🤖 "
Arch = "🎗️ "
Artix = "🎗️ "
Bluefin = "🐟 "
CachyOS = "🎗️ "
CentOS = "💠 "
Debian = "🌀 "
@@ -3280,6 +3390,7 @@ Arch = "Arch is the best! "
The `package` module is shown when the current directory is the repository for a package, and shows its current version. The module currently supports `npm`, `nimble`, `cargo`, `poetry`, `python`, `composer`, `gradle`, `julia`, `mix`, `helm`, `shards`, `daml` and `dart` packages.
- [**npm**](https://docs.npmjs.com/cli/commands/npm) The `npm` package version is extracted from the `package.json` present in the current directory
- [**JSR**](https://jsr.io/) The `jsr` package version is extracted from the `jsr.json`/`jsr.jsonc` or `deno.json`/`deno.jsonc` present in the current directory
- [**Cargo**](https://doc.rust-lang.org/cargo/) The `cargo` package version is extracted from the `Cargo.toml` present in the current directory
- [**Nimble**](https://github.com/nim-lang/nimble) - The `nimble` package version is extracted from the `*.nimble` file present in the current directory with the `nimble dump` command
- [**Poetry**](https://python-poetry.org/) The `poetry` package version is extracted from the `pyproject.toml` present in the current directory
@@ -3424,6 +3535,49 @@ The `pijul_channel` module shows the active channel of the repo in your current
| `truncation_symbol` | `'…'` | The symbol used to indicate a branch name was truncated. |
| `disabled` | `true` | Disables the `pijul` module. |
## Pixi
The `pixi` module shows the installed [pixi](https://pixi.sh) version as well as the activated environment, if `$PIXI_ENVIRONMENT_NAME` is set.
::: tip
This does not suppress pixi's own prompt modifier, you may want to run `pixi config set change-ps1 false`.
:::
### Options
| Option | Default | Description |
| -------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )(\($environment\) )]($style)'` | The format for the module. |
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch`. |
| `기호` | `'🧚 '` | The symbol used before the environment name. |
| `style` | `'yellow bold' | The style for the module. |
| `show_default_environment` | `true` | Whether to indicate that the `default` environment of your project is activated. |
| `pixi_binary` | `['pixi']` | Configures the pixi binary that Starship should execute when getting the version. |
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
| `detect_files` | `['pixi.toml']` | Which filenames should trigger this module. |
| `detect_folders` | `['.pixi']` | Which folders should trigger this module. |
| `disabled` | `false` | Disables the `pixi` module. |
### Variables
| Variable | 예시 | Description |
| ----------- | --------- | ------------------------------------ |
| version | `v0.33.0` | The version of `pixi` |
| environment | `py311` | The current pixi environment |
| 기호 | | Mirrors the value of option `symbol` |
| style | | Mirrors the value of option `style` |
### 예시
```toml
# ~/.config/starship.toml
[pixi]
format = '[$symbol$environment](yellow) '
```
## Pulumi
The `pulumi` module shows the current username, selected [Pulumi Stack](https://www.pulumi.com/docs/intro/concepts/stack/), and version.
@@ -3538,7 +3692,6 @@ 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
@@ -3546,16 +3699,16 @@ By default, the module will be shown if any of the following conditions are met:
### 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. |
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should execute 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_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. |
+3 -1
View File
@@ -229,10 +229,12 @@ curl -sS https://starship.rs/install.sh | sh
| Alpine Linux 3.13+ | [Alpine Linux 패키지](https://pkgs.alpinelinux.org/packages?name=starship) | `apk add starship` |
| Arch Linux | [Arch Linux Extra](https://archlinux.org/packages/extra/x86_64/starship) | `pacman -S starship` |
| CentOS 7+ | [Copr](https://copr.fedorainfracloud.org/coprs/atim/starship) | `dnf copr enable atim/starship` <br /> `dnf install starship` |
| Debian 13+ | [Debian Main](https://sources.debian.org/src/starship/1.22.1-1/) | `apt install starship` |
| Gentoo | [Gentoo 패키지](https://packages.gentoo.org/packages/app-shells/starship) | `emerge app-shells/starship` |
| Manjaro | | `pacman -S starship` |
| NixOS | [nixpkgs](https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/misc/starship/default.nix) | `nix-env -iA nixpkgs.starship` |
| openSUSE | [OSS](https://software.opensuse.org/package/starship) | `zypper in starship` |
| Ubuntu 25.04+ | [Ubuntu Universe](https://packages.ubuntu.com/source/plucky/starship) | `apt install starship` |
| Void Linux | [Void Linux 패키지](https://github.com/void-linux/void-packages/tree/master/srcpkgs/starship) | `xbps-install -S starship` |
</details>
@@ -345,7 +347,7 @@ mkdir ($nu.data-dir | path join "vendor/autoload")
starship init nu | save -f ($nu.data-dir | path join "vendor/autoload/starship.nu")
```
Note: Only Nushell v0.96+ is supported
알림: Nushell v0.96 버전 이상에서만 지원됩니다.
</details>
+6
View File
@@ -75,3 +75,9 @@ This preset is inspired by [M365Princess](https://github.com/JanDeDobbeleer/oh-m
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.
[![Screenshot of Jetpack preset](/presets/img/jetpack.png "Click to view Jetpack preset")](./jetpack)
## [Catppuccin Powerline](./catppuccin-powerline.md)
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
[![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png "Click to view Catppuccin Powerline preset")](./catppuccin-powerline)
@@ -0,0 +1,28 @@
[Return to Presets](./README.md#catppuccin-powerline)
# Catppuccin Powerline Preset
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png)
### 준비 사항
- A [Nerd Font](https://www.nerdfonts.com/) installed and enabled in your terminal
### 설정
```sh
starship preset catppuccin-powerline -o ~/.config/starship.toml
```
By default this preset uses the Mocha flavour of Catppucin, but you can specify any of the flavours by modifying the value of `palette`:
- `catppuccin_mocha`
- `catppuccin_frappe`
- `catppuccin_macchiato`
- `catppucin_latte`
[Click to download TOML](/presets/toml/catppuccin-powerline.toml)
<<< @/public/presets/toml/catppuccin-powerline.toml
+168 -15
View File
@@ -328,6 +328,7 @@ $azure\
$nats\
$direnv\
$env_var\
$mise\
$crystal\
$custom\
$sudo\
@@ -339,6 +340,7 @@ $time\
$status\
$os\
$container\
$netns\
$shell\
$character"""
```
@@ -618,7 +620,7 @@ De `bun` module laat de huidige geïnstalleerde versie van de [bun](https://bun.
*: This variable can only be used as a part of a style string
### Examples
### Example
#### Customize the format
@@ -629,15 +631,6 @@ De `bun` module laat de huidige geïnstalleerde versie van de [bun](https://bun.
format = 'via [🍔 $version](bold green) '
```
#### Replace Node.js
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']
```
## C
The `c` module shows some information about your C compiler. By default the module will be shown if the current directory contains a `.c` or `.h` file.
@@ -684,6 +677,53 @@ If a C compiler is not supported by this module, you can request it by [raising
format = 'via [$name $version]($style)'
```
## CPP
The `cpp` module shows some information about your `C++` compiler. By default, the module will be shown if the current directory contains a `.cpp`, `.hpp`, or other `C++`-related files.
### Options
| Option | Default | Description |
| ------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version(-$name) )]($style)'` | The format string for the module. |
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
| `symbol` | `'C++ '` | The symbol used before displaying the compiler details |
| `detect_extensions` | `['cpp', 'cc', 'cxx', 'c++', 'hpp', 'hh', 'hxx', 'h++', 'tcc']` | Which extensions should trigger this module. |
| `detect_files` | `[]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. |
| `commands` | `[ [ 'c++', '--version' ], [ 'g++', '--version' ], [ 'clang++', '--version' ] ]` | How to detect what the compiler is |
| `style` | `'bold 149'` | The style for the module. |
| `disabled` | `true` | Disables the `cpp` module. |
### Variables
| Variable | Example | Description |
| -------- | ------- | ------------------------------------ |
| name | clang++ | The name of the compiler |
| version | 13.0.0 | The version of the compiler |
| symbol | | Mirrors the value of option `symbol` |
| style | | Mirrors the value of option `style` |
NB that `version` is not in the default format.
### Commands
The `commands` option accepts a list of commands to determine the compiler version and name.
Each command is represented as a list of the executable name, followed by its arguments, usually something like `['mycpp', '--version']`. Starship will try executing each command until it gets a result on STDOUT.
If a C++ compiler is not supported by this module, you can request it by [raising an issue on GitHub](https://github.com/starship/starship/).
### Example
```toml
# ~/.config/starship.toml
[cpp]
disabled = false
format = 'via [$name $version]($style)'
```
## Character
The `character` module shows a character (usually an arrow) beside where the text is entered in your terminal.
@@ -874,6 +914,7 @@ This does not suppress conda's own prompt modifier, you may want to run `conda c
| `style` | `'bold green'` | The style for the module. |
| `format` | `'via [$symbol$environment]($style) '` | The format for the module. |
| `ignore_base` | `true` | Ignores `base` environment when activated. |
| `detect_env_vars` | `["!PIXI_ENVIRONMENT_NAME"]` | Which environment variable(s) should trigger this module. If it's a pixi environment, this module is not being triggered by default. |
| `disabled` | `false` | Disables the `conda` module. |
### Variables
@@ -1876,7 +1917,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
### Options
| Option | Default | Description |
| ------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| -------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | The default format for `git_status` |
| `conflicted` | `'='` | This branch has merge conflicts. |
| `ahead` | `'⇡'` | The format of `ahead` |
@@ -1894,6 +1935,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
| `ignore_submodules` | `false` | Ignore changes to submodules. |
| `disabled` | `false` | Disables the `git_status` module. |
| `windows_starship` | | Use this (Linux) path to a Windows Starship executable to render `git_status` when on Windows paths in WSL. |
| `use_git_executable` | `false` | Do not use `gitoxide` for computing the status, but use the `git` executable instead. |
### Variables
@@ -2817,6 +2859,40 @@ truncation_length = 4
truncation_symbol = ''
```
## Mise
The `mise` module shows the current mise health as reported by running `mise doctor`.
### Options
| Option | Default | Description |
| ------------------ | -------------------------------- | ------------------------------------------------ |
| `symbol` | `'mise '` | The symbol used before displaying _mise_ health. |
| `style` | `'bold purple'` | The style for the module. |
| `format` | `'on [$symbol$health]($style) '` | The format for the module. |
| `healthy_symbol` | `healthy` | The message displayed when _mise_ is healthy. |
| `unhealthy_symbol` | `unhealthy` | The message displayed when _mise_ is unhealthy. |
| `disabled` | `true` | Disables the `mise` module. |
### Variables
| Variable | Example | Description |
| --------- | --------- | ------------------------------------ |
| health | `healthy` | The health of _mise_ |
| 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
[mise]
health = 'ready'
```
## Mojo
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
@@ -2881,6 +2957,37 @@ format = '[$symbol]($style)'
style = 'bold purple'
```
## Network Namespace
The `netns` module shows the current network namespace. This uses `ip netns identify` to get the network namespace, so only network namespaces mounted at `/var/run/netns` will be detected.
### Options
| Option | Default | Description |
| ---------- | --------------------------------- | ----------------------------------------------------------------- |
| `format` | `'[$symbol \[$name\]]($style)'` | The format for the module. |
| `symbol` | `'🛜 '` | The symbol used before the network namespace (defaults to empty). |
| `style` | `'blue bold dimmed'` | The style for the module. |
| `disabled` | `false` | Disables the `netns` module. |
### Variables
| Variable | Example | Description |
| --------- | ---------- | ----------------------------------------- |
| name | `my-netns` | The name of the current network namespace |
| symbol | | Mirrors the value of option `symbol` |
| style\* | | Mirrors the value of option `style` |
### Example
```toml
# ~/.config/starship.toml
[netns]
style = 'bold yellow'
symbol = '🌐 '
```
## Nim
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). By default the module will be shown if any of the following conditions are met:
@@ -2975,6 +3082,8 @@ The `nodejs` module shows the currently installed version of [Node.js](https://n
- The current directory contains a file with the `.js`, `.mjs` or `.cjs` extension
- The current directory contains a file with the `.ts`, `.mts` or `.cts` extension
Additionally, the module will be hidden by default if the directory contains a `bunfig.toml`, `bun.lock`, or `bun.lockb` file, overriding the above conditions.
### Options
| Option | Default | Description |
@@ -3202,6 +3311,7 @@ Amazon = "🙂 "
Android = "🤖 "
Arch = "🎗️ "
Artix = "🎗️ "
Bluefin = "🐟 "
CachyOS = "🎗️ "
CentOS = "💠 "
Debian = "🌀 "
@@ -3280,6 +3390,7 @@ Arch = "Arch is the best! "
The `package` module is shown when the current directory is the repository for a package, and shows its current version. The module currently supports `npm`, `nimble`, `cargo`, `poetry`, `python`, `composer`, `gradle`, `julia`, `mix`, `helm`, `shards`, `daml` and `dart` packages.
- [**npm**](https://docs.npmjs.com/cli/commands/npm) The `npm` package version is extracted from the `package.json` present in the current directory
- [**JSR**](https://jsr.io/) The `jsr` package version is extracted from the `jsr.json`/`jsr.jsonc` or `deno.json`/`deno.jsonc` present in the current directory
- [**Cargo**](https://doc.rust-lang.org/cargo/) The `cargo` package version is extracted from the `Cargo.toml` present in the current directory
- [**Nimble**](https://github.com/nim-lang/nimble) - The `nimble` package version is extracted from the `*.nimble` file present in the current directory with the `nimble dump` command
- [**Poetry**](https://python-poetry.org/) The `poetry` package version is extracted from the `pyproject.toml` present in the current directory
@@ -3424,6 +3535,49 @@ The `pijul_channel` module shows the active channel of the repo in your current
| `truncation_symbol` | `'…'` | The symbol used to indicate a branch name was truncated. |
| `disabled` | `true` | Disables the `pijul` module. |
## Pixi
The `pixi` module shows the installed [pixi](https://pixi.sh) version as well as the activated environment, if `$PIXI_ENVIRONMENT_NAME` is set.
::: tip
This does not suppress pixi's own prompt modifier, you may want to run `pixi config set change-ps1 false`.
:::
### Options
| Option | Default | Description |
| -------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )(\($environment\) )]($style)'` | The format for the module. |
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch`. |
| `symbol` | `'🧚 '` | The symbol used before the environment name. |
| `style` | `'yellow bold' | The style for the module. |
| `show_default_environment` | `true` | Whether to indicate that the `default` environment of your project is activated. |
| `pixi_binary` | `['pixi']` | Configures the pixi binary that Starship should execute when getting the version. |
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
| `detect_files` | `['pixi.toml']` | Which filenames should trigger this module. |
| `detect_folders` | `['.pixi']` | Which folders should trigger this module. |
| `disabled` | `false` | Disables the `pixi` module. |
### Variables
| Variable | Example | Description |
| ----------- | --------- | ------------------------------------ |
| version | `v0.33.0` | The version of `pixi` |
| environment | `py311` | The current pixi environment |
| symbol | | Mirrors the value of option `symbol` |
| style | | Mirrors the value of option `style` |
### Example
```toml
# ~/.config/starship.toml
[pixi]
format = '[$symbol$environment](yellow) '
```
## Pulumi
The `pulumi` module shows the current username, selected [Pulumi Stack](https://www.pulumi.com/docs/intro/concepts/stack/), and version.
@@ -3538,7 +3692,6 @@ 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
@@ -3546,16 +3699,16 @@ By default, the module will be shown if any of the following conditions are met:
### 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. |
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should execute 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_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. |
+2
View File
@@ -229,10 +229,12 @@ Als alternatief kan je Starship installeren met een van de volgende pakketbeheer
| Alpine Linux 3.13+ | [Alpine Linux Packages](https://pkgs.alpinelinux.org/packages?name=starship) | `apk add starship` |
| Arch Linux | [Arch Linux Extra](https://archlinux.org/packages/extra/x86_64/starship) | `pacman -S starship` |
| CentOS 7+ | [Copr](https://copr.fedorainfracloud.org/coprs/atim/starship) | `dnf copr enable atim/starship` <br /> `dnf install starship` |
| Debian 13+ | [Debian Main](https://sources.debian.org/src/starship/1.22.1-1/) | `apt install starship` |
| Gentoo | [Gentoo Packages](https://packages.gentoo.org/packages/app-shells/starship) | `emerge app-shells/starship` |
| Manjaro | | `pacman -S starship` |
| NixOS | [nixpkgs](https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/misc/starship/default.nix) | `nix-env -iA nixpkgs.starship` |
| openSUSE | [OSS](https://software.opensuse.org/package/starship) | `zypper in starship` |
| Ubuntu 25.04+ | [Ubuntu Universe](https://packages.ubuntu.com/source/plucky/starship) | `apt install starship` |
| Void Linux | [Void Linux Packages](https://github.com/void-linux/void-packages/tree/master/srcpkgs/starship) | `xbps-install -S starship` |
</details>
+6
View File
@@ -75,3 +75,9 @@ This preset is heavily inspired by [Pastel Powerline](./pastel-powerline.md), an
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.
[![Screenshot of Jetpack preset](/presets/img/jetpack.png "Click to view Jetpack preset")](./jetpack)
## [Catppuccin Powerline](./catppuccin-powerline.md)
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
[![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png "Click to view Catppuccin Powerline preset")](./catppuccin-powerline)
@@ -0,0 +1,28 @@
[Return to Presets](./README.md#catppuccin-powerline)
# Catppuccin Powerline Preset
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png)
### Benodigdheden
- A [Nerd Font](https://www.nerdfonts.com/) installed and enabled in your terminal
### Configuration
```sh
starship preset catppuccin-powerline -o ~/.config/starship.toml
```
By default this preset uses the Mocha flavour of Catppucin, but you can specify any of the flavours by modifying the value of `palette`:
- `catppuccin_mocha`
- `catppuccin_frappe`
- `catppuccin_macchiato`
- `catppucin_latte`
[Click to download TOML](/presets/toml/catppuccin-powerline.toml)
<<< @/public/presets/toml/catppuccin-powerline.toml
+168 -15
View File
@@ -328,6 +328,7 @@ $azure\
$nats\
$direnv\
$env_var\
$mise\
$crystal\
$custom\
$sudo\
@@ -339,6 +340,7 @@ $time\
$status\
$os\
$container\
$netns\
$shell\
$character"""
```
@@ -618,7 +620,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
*: This variable can only be used as a part of a style string
### Examples
### Example
#### Customize the format
@@ -629,15 +631,6 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
format = 'via [🍔 $version](bold green) '
```
#### Replace Node.js
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']
```
## C
The `c` module shows some information about your C compiler. By default the module will be shown if the current directory contains a `.c` or `.h` file.
@@ -684,6 +677,53 @@ If a C compiler is not supported by this module, you can request it by [raising
format = 'via [$name $version]($style)'
```
## CPP
The `cpp` module shows some information about your `C++` compiler. By default, the module will be shown if the current directory contains a `.cpp`, `.hpp`, or other `C++`-related files.
### Options
| Option | Default | Description |
| ------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version(-$name) )]($style)'` | The format string for the module. |
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
| `symbol` | `'C++ '` | The symbol used before displaying the compiler details |
| `detect_extensions` | `['cpp', 'cc', 'cxx', 'c++', 'hpp', 'hh', 'hxx', 'h++', 'tcc']` | Which extensions should trigger this module. |
| `detect_files` | `[]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. |
| `commands` | `[ [ 'c++', '--version' ], [ 'g++', '--version' ], [ 'clang++', '--version' ] ]` | How to detect what the compiler is |
| `style` | `'bold 149'` | The style for the module. |
| `disabled` | `true` | Disables the `cpp` module. |
### Variables
| Variable | Example | Description |
| -------- | ------- | ------------------------------------ |
| name | clang++ | The name of the compiler |
| version | 13.0.0 | The version of the compiler |
| symbol | | Mirrors the value of option `symbol` |
| style | | Mirrors the value of option `style` |
NB that `version` is not in the default format.
### Commands
The `commands` option accepts a list of commands to determine the compiler version and name.
Each command is represented as a list of the executable name, followed by its arguments, usually something like `['mycpp', '--version']`. Starship will try executing each command until it gets a result on STDOUT.
If a C++ compiler is not supported by this module, you can request it by [raising an issue on GitHub](https://github.com/starship/starship/).
### Example
```toml
# ~/.config/starship.toml
[cpp]
disabled = false
format = 'via [$name $version]($style)'
```
## Character
The `character` module shows a character (usually an arrow) beside where the text is entered in your terminal.
@@ -874,6 +914,7 @@ This does not suppress conda's own prompt modifier, you may want to run `conda c
| `style` | `'bold green'` | The style for the module. |
| `format` | `'via [$symbol$environment]($style) '` | The format for the module. |
| `ignore_base` | `true` | Ignores `base` environment when activated. |
| `detect_env_vars` | `["!PIXI_ENVIRONMENT_NAME"]` | Which environment variable(s) should trigger this module. If it's a pixi environment, this module is not being triggered by default. |
| `disabled` | `false` | Disables the `conda` module. |
### Variables
@@ -1876,7 +1917,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
### Options
| Option | Default | Description |
| ------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| -------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | The default format for `git_status` |
| `conflicted` | `'='` | This branch has merge conflicts. |
| `ahead` | `'⇡'` | The format of `ahead` |
@@ -1894,6 +1935,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
| `ignore_submodules` | `false` | Ignore changes to submodules. |
| `disabled` | `false` | Disables the `git_status` module. |
| `windows_starship` | | Use this (Linux) path to a Windows Starship executable to render `git_status` when on Windows paths in WSL. |
| `use_git_executable` | `false` | Do not use `gitoxide` for computing the status, but use the `git` executable instead. |
### Variables
@@ -2817,6 +2859,40 @@ truncation_length = 4
truncation_symbol = ''
```
## Mise
The `mise` module shows the current mise health as reported by running `mise doctor`.
### Options
| Option | Default | Description |
| ------------------ | -------------------------------- | ------------------------------------------------ |
| `symbol` | `'mise '` | The symbol used before displaying _mise_ health. |
| `style` | `'bold purple'` | The style for the module. |
| `format` | `'on [$symbol$health]($style) '` | The format for the module. |
| `healthy_symbol` | `healthy` | The message displayed when _mise_ is healthy. |
| `unhealthy_symbol` | `unhealthy` | The message displayed when _mise_ is unhealthy. |
| `disabled` | `true` | Disables the `mise` module. |
### Variables
| Variable | Example | Description |
| --------- | --------- | ------------------------------------ |
| health | `healthy` | The health of _mise_ |
| 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
[mise]
health = 'ready'
```
## Mojo
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
@@ -2881,6 +2957,37 @@ format = '[$symbol]($style)'
style = 'bold purple'
```
## Network Namespace
The `netns` module shows the current network namespace. This uses `ip netns identify` to get the network namespace, so only network namespaces mounted at `/var/run/netns` will be detected.
### Options
| Option | Default | Description |
| ---------- | --------------------------------- | ----------------------------------------------------------------- |
| `format` | `'[$symbol \[$name\]]($style)'` | The format for the module. |
| `symbol` | `'🛜 '` | The symbol used before the network namespace (defaults to empty). |
| `style` | `'blue bold dimmed'` | The style for the module. |
| `disabled` | `false` | Disables the `netns` module. |
### Variables
| Variable | Example | Description |
| --------- | ---------- | ----------------------------------------- |
| name | `my-netns` | The name of the current network namespace |
| symbol | | Mirrors the value of option `symbol` |
| style\* | | Mirrors the value of option `style` |
### Example
```toml
# ~/.config/starship.toml
[netns]
style = 'bold yellow'
symbol = '🌐 '
```
## Nim
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). By default the module will be shown if any of the following conditions are met:
@@ -2975,6 +3082,8 @@ The `nodejs` module shows the currently installed version of [Node.js](https://n
- The current directory contains a file with the `.js`, `.mjs` or `.cjs` extension
- The current directory contains a file with the `.ts`, `.mts` or `.cts` extension
Additionally, the module will be hidden by default if the directory contains a `bunfig.toml`, `bun.lock`, or `bun.lockb` file, overriding the above conditions.
### Options
| Option | Default | Description |
@@ -3202,6 +3311,7 @@ Amazon = "🙂 "
Android = "🤖 "
Arch = "🎗️ "
Artix = "🎗️ "
Bluefin = "🐟 "
CachyOS = "🎗️ "
CentOS = "💠 "
Debian = "🌀 "
@@ -3280,6 +3390,7 @@ Arch = "Arch is the best! "
The `package` module is shown when the current directory is the repository for a package, and shows its current version. The module currently supports `npm`, `nimble`, `cargo`, `poetry`, `python`, `composer`, `gradle`, `julia`, `mix`, `helm`, `shards`, `daml` and `dart` packages.
- [**npm**](https://docs.npmjs.com/cli/commands/npm) The `npm` package version is extracted from the `package.json` present in the current directory
- [**JSR**](https://jsr.io/) The `jsr` package version is extracted from the `jsr.json`/`jsr.jsonc` or `deno.json`/`deno.jsonc` present in the current directory
- [**Cargo**](https://doc.rust-lang.org/cargo/) The `cargo` package version is extracted from the `Cargo.toml` present in the current directory
- [**Nimble**](https://github.com/nim-lang/nimble) - The `nimble` package version is extracted from the `*.nimble` file present in the current directory with the `nimble dump` command
- [**Poetry**](https://python-poetry.org/) The `poetry` package version is extracted from the `pyproject.toml` present in the current directory
@@ -3424,6 +3535,49 @@ The `pijul_channel` module shows the active channel of the repo in your current
| `truncation_symbol` | `'…'` | The symbol used to indicate a branch name was truncated. |
| `disabled` | `true` | Disables the `pijul` module. |
## Pixi
The `pixi` module shows the installed [pixi](https://pixi.sh) version as well as the activated environment, if `$PIXI_ENVIRONMENT_NAME` is set.
::: tip
This does not suppress pixi's own prompt modifier, you may want to run `pixi config set change-ps1 false`.
:::
### Options
| Option | Default | Description |
| -------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )(\($environment\) )]($style)'` | The format for the module. |
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch`. |
| `symbol` | `'🧚 '` | The symbol used before the environment name. |
| `style` | `'yellow bold' | The style for the module. |
| `show_default_environment` | `true` | Whether to indicate that the `default` environment of your project is activated. |
| `pixi_binary` | `['pixi']` | Configures the pixi binary that Starship should execute when getting the version. |
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
| `detect_files` | `['pixi.toml']` | Which filenames should trigger this module. |
| `detect_folders` | `['.pixi']` | Which folders should trigger this module. |
| `disabled` | `false` | Disables the `pixi` module. |
### Variables
| Variable | Example | Description |
| ----------- | --------- | ------------------------------------ |
| version | `v0.33.0` | The version of `pixi` |
| environment | `py311` | The current pixi environment |
| symbol | | Mirrors the value of option `symbol` |
| style | | Mirrors the value of option `style` |
### Example
```toml
# ~/.config/starship.toml
[pixi]
format = '[$symbol$environment](yellow) '
```
## Pulumi
The `pulumi` module shows the current username, selected [Pulumi Stack](https://www.pulumi.com/docs/intro/concepts/stack/), and version.
@@ -3538,7 +3692,6 @@ 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
@@ -3546,16 +3699,16 @@ By default, the module will be shown if any of the following conditions are met:
### 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. |
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should execute 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_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. |
+3 -1
View File
@@ -229,10 +229,12 @@ Alternatively, install Starship using any of the following package managers:
| Alpine Linux 3.13+ | [Alpine Linux Packages](https://pkgs.alpinelinux.org/packages?name=starship) | `apk add starship` |
| Arch Linux | [Arch Linux Extra](https://archlinux.org/packages/extra/x86_64/starship) | `pacman -S starship` |
| CentOS 7+ | [Copr](https://copr.fedorainfracloud.org/coprs/atim/starship) | `dnf copr enable atim/starship` <br /> `dnf install starship` |
| Debian 13+ | [Debian Main](https://sources.debian.org/src/starship/1.22.1-1/) | `apt install starship` |
| Gentoo | [Gentoo Packages](https://packages.gentoo.org/packages/app-shells/starship) | `emerge app-shells/starship` |
| Manjaro | | `pacman -S starship` |
| NixOS | [nixpkgs](https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/misc/starship/default.nix) | `nix-env -iA nixpkgs.starship` |
| openSUSE | [OSS](https://software.opensuse.org/package/starship) | `zypper in starship` |
| Ubuntu 25.04+ | [Ubuntu Universe](https://packages.ubuntu.com/source/plucky/starship) | `apt install starship` |
| Void Linux | [Void Linux Packages](https://github.com/void-linux/void-packages/tree/master/srcpkgs/starship) | `xbps-install -S starship` |
</details>
@@ -345,7 +347,7 @@ mkdir ($nu.data-dir | path join "vendor/autoload")
starship init nu | save -f ($nu.data-dir | path join "vendor/autoload/starship.nu")
```
Note: Only Nushell v0.96+ is supported
Merk: Bare Nushell v0.96+ støttes
</details>
+6
View File
@@ -75,3 +75,9 @@ This preset is heavily inspired by [Pastel Powerline](./pastel-powerline.md), an
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.
[![Screenshot of Jetpack preset](/presets/img/jetpack.png "Click to view Jetpack preset")](./jetpack)
## [Catppuccin Powerline](./catppuccin-powerline.md)
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
[![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png "Click to view Catppuccin Powerline preset")](./catppuccin-powerline)
@@ -0,0 +1,28 @@
[Return to Presets](./README.md#catppuccin-powerline)
# Catppuccin Powerline Preset
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png)
### Nødvendig forutsetninger
- A [Nerd Font](https://www.nerdfonts.com/) installed and enabled in your terminal
### Configuration
```sh
starship preset catppuccin-powerline -o ~/.config/starship.toml
```
By default this preset uses the Mocha flavour of Catppucin, but you can specify any of the flavours by modifying the value of `palette`:
- `catppuccin_mocha`
- `catppuccin_frappe`
- `catppuccin_macchiato`
- `catppucin_latte`
[Click to download TOML](/presets/toml/catppuccin-powerline.toml)
<<< @/public/presets/toml/catppuccin-powerline.toml
+1 -1
View File
@@ -166,7 +166,7 @@ onMounted(() => {
::: warning
Ten sposób zmieni się w przyszłości. Only Nushell v0.96+ is supported.
Ten sposób zmieni się w przyszłości. Działa tylko na Nushell v0.96+.
:::
+168 -15
View File
@@ -328,6 +328,7 @@ $azure\
$nats\
$direnv\
$env_var\
$mise\
$crystal\
$custom\
$sudo\
@@ -339,6 +340,7 @@ $time\
$status\
$os\
$container\
$netns\
$shell\
$character"""
```
@@ -618,7 +620,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
*: This variable can only be used as a part of a style string
### Examples
### Example
#### Customize the format
@@ -629,15 +631,6 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
format = 'via [🍔 $version](bold green) '
```
#### Replace Node.js
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']
```
## C
The `c` module shows some information about your C compiler. By default the module will be shown if the current directory contains a `.c` or `.h` file.
@@ -684,6 +677,53 @@ If a C compiler is not supported by this module, you can request it by [raising
format = 'via [$name $version]($style)'
```
## CPP
The `cpp` module shows some information about your `C++` compiler. By default, the module will be shown if the current directory contains a `.cpp`, `.hpp`, or other `C++`-related files.
### Options
| Option | Default | Description |
| ------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version(-$name) )]($style)'` | The format string for the module. |
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
| `symbol` | `'C++ '` | The symbol used before displaying the compiler details |
| `detect_extensions` | `['cpp', 'cc', 'cxx', 'c++', 'hpp', 'hh', 'hxx', 'h++', 'tcc']` | Which extensions should trigger this module. |
| `detect_files` | `[]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. |
| `commands` | `[ [ 'c++', '--version' ], [ 'g++', '--version' ], [ 'clang++', '--version' ] ]` | How to detect what the compiler is |
| `style` | `'bold 149'` | The style for the module. |
| `disabled` | `true` | Disables the `cpp` module. |
### Variables
| Zmienne | Example | Description |
| ------- | ------- | ------------------------------------ |
| name | clang++ | The name of the compiler |
| version | 13.0.0 | The version of the compiler |
| symbol | | Mirrors the value of option `symbol` |
| style | | Mirrors the value of option `style` |
NB that `version` is not in the default format.
### Commands
The `commands` option accepts a list of commands to determine the compiler version and name.
Each command is represented as a list of the executable name, followed by its arguments, usually something like `['mycpp', '--version']`. Starship will try executing each command until it gets a result on STDOUT.
If a C++ compiler is not supported by this module, you can request it by [raising an issue on GitHub](https://github.com/starship/starship/).
### Example
```toml
# ~/.config/starship.toml
[cpp]
disabled = false
format = 'via [$name $version]($style)'
```
## Character
The `character` module shows a character (usually an arrow) beside where the text is entered in your terminal.
@@ -874,6 +914,7 @@ This does not suppress conda's own prompt modifier, you may want to run `conda c
| `style` | `'bold green'` | The style for the module. |
| `format` | `'via [$symbol$environment]($style) '` | The format for the module. |
| `ignore_base` | `true` | Ignores `base` environment when activated. |
| `detect_env_vars` | `["!PIXI_ENVIRONMENT_NAME"]` | Which environment variable(s) should trigger this module. If it's a pixi environment, this module is not being triggered by default. |
| `disabled` | `false` | Disables the `conda` module. |
### Variables
@@ -1876,7 +1917,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
### Options
| Option | Default | Description |
| ------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| -------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | The default format for `git_status` |
| `conflicted` | `'='` | This branch has merge conflicts. |
| `ahead` | `'⇡'` | The format of `ahead` |
@@ -1894,6 +1935,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
| `ignore_submodules` | `false` | Ignore changes to submodules. |
| `disabled` | `false` | Disables the `git_status` module. |
| `windows_starship` | | Use this (Linux) path to a Windows Starship executable to render `git_status` when on Windows paths in WSL. |
| `use_git_executable` | `false` | Do not use `gitoxide` for computing the status, but use the `git` executable instead. |
### Variables
@@ -2817,6 +2859,40 @@ truncation_length = 4
truncation_symbol = ''
```
## Mise
The `mise` module shows the current mise health as reported by running `mise doctor`.
### Options
| Option | Default | Description |
| ------------------ | -------------------------------- | ------------------------------------------------ |
| `symbol` | `'mise '` | The symbol used before displaying _mise_ health. |
| `style` | `'bold purple'` | The style for the module. |
| `format` | `'on [$symbol$health]($style) '` | The format for the module. |
| `healthy_symbol` | `healthy` | The message displayed when _mise_ is healthy. |
| `unhealthy_symbol` | `unhealthy` | The message displayed when _mise_ is unhealthy. |
| `disabled` | `true` | Disables the `mise` module. |
### Variables
| Zmienne | Example | Description |
| --------- | --------- | ------------------------------------ |
| health | `healthy` | The health of _mise_ |
| 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
[mise]
health = 'ready'
```
## Mojo
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
@@ -2881,6 +2957,37 @@ format = '[$symbol]($style)'
style = 'bold purple'
```
## Network Namespace
The `netns` module shows the current network namespace. This uses `ip netns identify` to get the network namespace, so only network namespaces mounted at `/var/run/netns` will be detected.
### Options
| Option | Default | Description |
| ---------- | --------------------------------- | ----------------------------------------------------------------- |
| `format` | `'[$symbol \[$name\]]($style)'` | The format for the module. |
| `symbol` | `'🛜 '` | The symbol used before the network namespace (defaults to empty). |
| `style` | `'blue bold dimmed'` | The style for the module. |
| `disabled` | `false` | Disables the `netns` module. |
### Variables
| Zmienne | Example | Description |
| --------- | ---------- | ----------------------------------------- |
| name | `my-netns` | The name of the current network namespace |
| symbol | | Mirrors the value of option `symbol` |
| style\* | | Mirrors the value of option `style` |
### Example
```toml
# ~/.config/starship.toml
[netns]
style = 'bold yellow'
symbol = '🌐 '
```
## Nim
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). By default the module will be shown if any of the following conditions are met:
@@ -2975,6 +3082,8 @@ The `nodejs` module shows the currently installed version of [Node.js](https://n
- The current directory contains a file with the `.js`, `.mjs` or `.cjs` extension
- The current directory contains a file with the `.ts`, `.mts` or `.cts` extension
Additionally, the module will be hidden by default if the directory contains a `bunfig.toml`, `bun.lock`, or `bun.lockb` file, overriding the above conditions.
### Options
| Option | Default | Description |
@@ -3202,6 +3311,7 @@ Amazon = "🙂 "
Android = "🤖 "
Arch = "🎗️ "
Artix = "🎗️ "
Bluefin = "🐟 "
CachyOS = "🎗️ "
CentOS = "💠 "
Debian = "🌀 "
@@ -3280,6 +3390,7 @@ Arch = "Arch is the best! "
The `package` module is shown when the current directory is the repository for a package, and shows its current version. The module currently supports `npm`, `nimble`, `cargo`, `poetry`, `python`, `composer`, `gradle`, `julia`, `mix`, `helm`, `shards`, `daml` and `dart` packages.
- [**npm**](https://docs.npmjs.com/cli/commands/npm) The `npm` package version is extracted from the `package.json` present in the current directory
- [**JSR**](https://jsr.io/) The `jsr` package version is extracted from the `jsr.json`/`jsr.jsonc` or `deno.json`/`deno.jsonc` present in the current directory
- [**Cargo**](https://doc.rust-lang.org/cargo/) The `cargo` package version is extracted from the `Cargo.toml` present in the current directory
- [**Nimble**](https://github.com/nim-lang/nimble) - The `nimble` package version is extracted from the `*.nimble` file present in the current directory with the `nimble dump` command
- [**Poetry**](https://python-poetry.org/) The `poetry` package version is extracted from the `pyproject.toml` present in the current directory
@@ -3424,6 +3535,49 @@ The `pijul_channel` module shows the active channel of the repo in your current
| `truncation_symbol` | `'…'` | The symbol used to indicate a branch name was truncated. |
| `disabled` | `true` | Disables the `pijul` module. |
## Pixi
The `pixi` module shows the installed [pixi](https://pixi.sh) version as well as the activated environment, if `$PIXI_ENVIRONMENT_NAME` is set.
::: porada
This does not suppress pixi's own prompt modifier, you may want to run `pixi config set change-ps1 false`.
:::
### Options
| Option | Default | Description |
| -------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )(\($environment\) )]($style)'` | The format for the module. |
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch`. |
| `symbol` | `'🧚 '` | The symbol used before the environment name. |
| `style` | `'yellow bold' | The style for the module. |
| `show_default_environment` | `true` | Whether to indicate that the `default` environment of your project is activated. |
| `pixi_binary` | `['pixi']` | Configures the pixi binary that Starship should execute when getting the version. |
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
| `detect_files` | `['pixi.toml']` | Which filenames should trigger this module. |
| `detect_folders` | `['.pixi']` | Which folders should trigger this module. |
| `disabled` | `false` | Disables the `pixi` module. |
### Variables
| Zmienne | Example | Description |
| ----------- | --------- | ------------------------------------ |
| version | `v0.33.0` | The version of `pixi` |
| environment | `py311` | The current pixi environment |
| symbol | | Mirrors the value of option `symbol` |
| style | | Mirrors the value of option `style` |
### Example
```toml
# ~/.config/starship.toml
[pixi]
format = '[$symbol$environment](yellow) '
```
## Pulumi
The `pulumi` module shows the current username, selected [Pulumi Stack](https://www.pulumi.com/docs/intro/concepts/stack/), and version.
@@ -3538,7 +3692,6 @@ 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
@@ -3546,16 +3699,16 @@ By default, the module will be shown if any of the following conditions are met:
### 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. |
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should execute 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_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. |
+3 -1
View File
@@ -229,10 +229,12 @@ Alternatywnie, zainstaluj Starship używając dowolnego z następujących mened
| Alpine Linux 3.13+ | [Alpine Linux Packages](https://pkgs.alpinelinux.org/packages?name=starship) | `apk dodaj starship` |
| Arch Linux | [Arch Linux Extra](https://archlinux.org/packages/extra/x86_64/starship) | `pacman -S starship` |
| CentOS 7+ | [Copr](https://copr.fedorainfracloud.org/coprs/atim/starship) | `dnf copr enable atim/starship` <br /> `dnf install starship` |
| Debian 13+ | [Debian Main](https://sources.debian.org/src/starship/1.22.1-1/) | `apt install starship` |
| Gentoo | [Gentoo Packages](https://packages.gentoo.org/packages/app-shells/starship) | `emerge app-shells/starship` |
| Manjaro | | `pacman -S starship` |
| NixOS | [nixpkgs](https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/misc/starship/default.nix) | `nix-env -iA nixpkgs.starship` |
| openSUSE | [OSS](https://software.opensuse.org/package/starship) | `zypper in starship` |
| Ubuntu 25.04+ | [Ubuntu Universe](https://packages.ubuntu.com/source/plucky/starship) | `apt install starship` |
| Void Linux | [Void Linux Packages](https://github.com/void-linux/void-packages/tree/master/srcpkgs/starship) | `xbps-install -S starship` |
</details>
@@ -345,7 +347,7 @@ mkdir ($nu.data-dir | path join "vendor/autoload")
starship init nu | save -f ($nu.data-dir | path join "vendor/autoload/starship.nu")
```
Note: Only Nushell v0.96+ is supported
Uwaga: Obsługiwany jest tylko Nushell w wersji v0.96 wzwyż
</details>
+6
View File
@@ -75,3 +75,9 @@ Zestaw mocno inspirowany przez [Pastel Powerline](./pastel-powerline.md) i [Toky
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.
[![Screenshot of Jetpack preset](/presets/img/jetpack.png "Click to view Jetpack preset")](./jetpack)
## [Catppuccin Powerline](./catppuccin-powerline.md)
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
[![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png "Click to view Catppuccin Powerline preset")](./catppuccin-powerline)
@@ -0,0 +1,28 @@
[Return to Presets](./README.md#catppuccin-powerline)
# Catppuccin Powerline Preset
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png)
### Wymagania wstępne
- A [Nerd Font](https://www.nerdfonts.com/) installed and enabled in your terminal
### Konfiguracja
```sh
starship preset catppuccin-powerline -o ~/.config/starship.toml
```
By default this preset uses the Mocha flavour of Catppucin, but you can specify any of the flavours by modifying the value of `palette`:
- `catppuccin_mocha`
- `catppuccin_frappe`
- `catppuccin_macchiato`
- `catppucin_latte`
[Click to download TOML](/presets/toml/catppuccin-powerline.toml)
<<< @/public/presets/toml/catppuccin-powerline.toml
+1 -1
View File
@@ -166,7 +166,7 @@ onMounted(() => {
::: warning
Isto irá mudar no futuro. Only Nushell v0.96+ is supported.
Isto irá mudar no futuro. Somente Nushell v0.96+ é suportado.
:::
+175 -22
View File
@@ -328,6 +328,7 @@ $azure\
$nats\
$direnv\
$env_var\
$mise\
$crystal\
$custom\
$sudo\
@@ -339,6 +340,7 @@ $time\
$status\
$os\
$container\
$netns\
$shell\
$character"""
```
@@ -618,7 +620,7 @@ O módulo `bun` mostra a versão atualmente instalada do [bun](https://bun.sh) r
*: Esta variável só pode ser usada como parte de uma string de estilo
### Exemplos
### Exemplo
#### Customize the format
@@ -629,15 +631,6 @@ O módulo `bun` mostra a versão atualmente instalada do [bun](https://bun.sh) r
format = 'via [🍔 $version](bold green) '
```
#### Replace Node.js
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']
```
## C
O módulo `c` mostra algumas informações sobre o seu compilador de C. Por padrão o módulo será exibido se o diretório atual contém um arquivo `.c` ou `.h`.
@@ -684,6 +677,53 @@ Se um compilador C não é suportado por este módulo, você pode solicitá-lo [
format = 'via [$name $version]($style)'
```
## CPP
The `cpp` module shows some information about your `C++` compiler. By default, the module will be shown if the current directory contains a `.cpp`, `.hpp`, or other `C++`-related files.
### Opções
| Opções | Padrão | Descrição |
| ------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| `format` | `'via [$symbol($version(-$name) )]($style)'` | A string de 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` | `'C++ '` | O símbolo utilizado antes de exibir os detalhes do compilador |
| `detect_extensions` | `['cpp', 'cc', 'cxx', 'c++', 'hpp', 'hh', 'hxx', 'h++', 'tcc']` | 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. |
| `commands` | `[ [ 'c++', '--version' ], [ 'g++', '--version' ], [ 'clang++', '--version' ] ]` | Como detectar qual é o compilador |
| `style` | `'bold 149'` | O estilo do módulo. |
| `disabled` | `true` | Disables the `cpp` module. |
### Variáveis
| Variável | Exemplo | Descrição |
| -------- | ------- | --------------------------------- |
| name | clang++ | O nome do compilador |
| version | 13.0.0 | A versão do compilador |
| symbol | | Espelha o valor da opção `symbol` |
| style | | Espelha o valor da opção `style` |
Note que `version` não está no formato padrão.
### Comandos
A opção `commands` aceita uma lista de comandos para determinar a versão e o nome do compilador.
Each command is represented as a list of the executable name, followed by its arguments, usually something like `['mycpp', '--version']`. Starship tentará executar cada comando até que obtenha um resultado no STDOUT.
If a C++ compiler is not supported by this module, you can request it by [raising an issue on GitHub](https://github.com/starship/starship/).
### Exemplo
```toml
# ~/.config/starship.toml
[cpp]
disabled = false
format = 'via [$name $version]($style)'
```
## Caractere
O módulo `character` exibe um caracter (normalmente uma seta) ao lado de onde o texto começa a ser inserido no terminal.
@@ -761,9 +801,9 @@ O módulo `cmake` exibe a versão instalada do [CMake](https://cmake.org/). Por
### 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` |
| `version_format` | `'v${raw}'` | A versão formatada. As variáveis disponíveis são `raw`, `major`, `minor`, & `patch` |
| `symbol` | `'△ '` | O simbolo usado antes da versão do cmake. |
| `detect_extensions` | `[]` | Quais extensões devem acionar este módulo |
| `detect_files` | `['CMakeLists.txt', 'CMakeCache.txt']` | [] |
@@ -874,6 +914,7 @@ Isso não suprime o modificador de prompt do conda, você pode executar `conda c
| `style` | `'bold green'` | O estilo do módulo. |
| `format` | `'via [$symbol$environment]($style) '` | O formato do módulo. |
| `ignore_base` | `true` | Ignora o environment `base` quando ativado. |
| `detect_env_vars` | `["!PIXI_ENVIRONMENT_NAME"]` | Which environment variable(s) should trigger this module. If it's a pixi environment, this module is not being triggered by default. |
| `disabled` | `false` | Desabilita o módulo `conda`. |
### Variáveis
@@ -937,10 +978,10 @@ O módulo `crystal` exibe a versão instalada atual do [Crystal](https://crystal
### Opções
| Opções | Padrão | Descrição |
| ------------------- | ------------------------------------ | ----------------------------------------------------------------------------------- |
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------------------ |
| `symbol` | `'🔮 '` | O símbolo usado antes de exibir a versão do crystal. |
| `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` |
| `version_format` | `'v${raw}'` | O formato da versão. As variáveis disponíveis são `raw`, `major`, `minor`, & `patch` |
| `style` | `'bold red'` | O estilo do módulo. |
| `detect_extensions` | `['cr']` | Quais extensões devem ativar este módulo. |
| `detect_files` | `['shard.yml']` | Quais nomes de arquivos devem ativar este módulo. |
@@ -1053,9 +1094,9 @@ O módulo `deno` exibe a versão instalada atual do [Deno](https://deno.land/).
### 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` |
| `version_format` | `'v${raw}'` | A versão formatada. 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. |
@@ -1876,7 +1917,7 @@ O módulo Git Status é muito lento nos diretórios do Windows (por exemplo, em
### Opções
| Opções | Padrão | Descrição |
| ------------------- | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| -------------------- | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | O formato padrão para `git_status` |
| `conflicted` | `'='` | Este braço tem conflitos. |
| `ahead` | `'⇡'` | O formato do `ahead` |
@@ -1894,6 +1935,7 @@ O módulo Git Status é muito lento nos diretórios do Windows (por exemplo, em
| `ignore_submodules` | `false` | Ignora as alterações de submódulos. |
| `disabled` | `false` | Desabilita o módulo `git_status`. |
| `windows_starship` | | Use este caminho (Linux) para um executável do Windows Starship renderizar o `git_status` quando estiver em caminhos do Windows no WSL. |
| `use_git_executable` | `false` | Do not use `gitoxide` for computing the status, but use the `git` executable instead. |
### Variáveis
@@ -1971,7 +2013,7 @@ windows_starship = '/mnt/c/Users/nomedousuario/scoop/apps/starship/current/stars
The `gleam` module shows the currently installed version of [Gleam](https://gleam.run/). Por padrão o módulo vai exibir se uma das condições a seguir for atendida:
- The current directory contains a `gleam.toml` file
- O diretório atual conter um arquivo `gleam.toml`
- The current directory contains a file with the `.gleam` extension
### Opções
@@ -2817,6 +2859,40 @@ truncation_length = 4
truncation_symbol = ''
```
## Mise
The `mise` module shows the current mise health as reported by running `mise doctor`.
### Opções
| Opções | Padrão | Descrição |
| ------------------ | -------------------------------- | ------------------------------------------------ |
| `symbol` | `'mise '` | The symbol used before displaying _mise_ health. |
| `style` | `'bold purple'` | O estilo do módulo. |
| `format` | `'on [$symbol$health]($style) '` | O formato do módulo. |
| `healthy_symbol` | `healthy` | The message displayed when _mise_ is healthy. |
| `unhealthy_symbol` | `unhealthy` | The message displayed when _mise_ is unhealthy. |
| `disabled` | `true` | Disables the `mise` module. |
### Variáveis
| Variável | Exemplo | Descrição |
| --------- | --------- | --------------------------------- |
| health | `healthy` | The health of _mise_ |
| 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
[mise]
health = 'ready'
```
## Mojo
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
@@ -2881,6 +2957,37 @@ format = '[$symbol]($style)'
style = 'bold purple'
```
## Network Namespace
The `netns` module shows the current network namespace. This uses `ip netns identify` to get the network namespace, so only network namespaces mounted at `/var/run/netns` will be detected.
### Opções
| Opções | Padrão | Descrição |
| ---------- | --------------------------------- | ----------------------------------------------------------------- |
| `format` | `'[$symbol \[$name\]]($style)'` | O formato do módulo. |
| `symbol` | `'🛜 '` | The symbol used before the network namespace (defaults to empty). |
| `style` | `'blue bold dimmed'` | O estilo do módulo. |
| `disabled` | `false` | Disables the `netns` module. |
### Variáveis
| Variável | Exemplo | Descrição |
| --------- | ---------- | ----------------------------------------- |
| name | `my-netns` | The name of the current network namespace |
| symbol | | Espelha o valor da opção `symbol` |
| style\* | | Espelha o valor da opção `style` |
### Exemplo
```toml
# ~/.config/starship.toml
[netns]
style = 'bold yellow'
symbol = '🌐 '
```
## Nim
O módulo `nim` exibe a versão atual instalada do [Nim](https://nim-lang.org/). Por padrão o módulo vai exibir se uma das condições a seguir for atendida:
@@ -2975,6 +3082,8 @@ O módulo `nodejs` exibe a versão atual instalada do [Node.js](https://nodejs.o
- O diretório atual tenha um arquivo com a extensão `.js`, `.mjs` or `.cjs`
- O diretório atual contém um arquivo com a extensão `.ts`, `.mts` ou `.cts`
Additionally, the module will be hidden by default if the directory contains a `bunfig.toml`, `bun.lock`, or `bun.lockb` file, overriding the above conditions.
### Opções
| Opções | Padrão | Descrição |
@@ -3202,6 +3311,7 @@ Amazon = "🙂 "
Android = "🤖 "
Arch = "🎗️ "
Artix = "🎗️ "
Bluefin = "🐟 "
CachyOS = "🎗️ "
CentOS = "💠 "
Debian = "🌀 "
@@ -3280,6 +3390,7 @@ Arch = "Arch is the best! "
O módulo `package` é mostrado quando o diretório atual é o repositório de um pacote e mostra sua versão atual. The module currently supports `npm`, `nimble`, `cargo`, `poetry`, `python`, `composer`, `gradle`, `julia`, `mix`, `helm`, `shards`, `daml` and `dart` packages.
- [**npm**](https://docs.npmjs.com/cli/commands/npm) O versionamento de pacotes `npm` é extraído do `package.json` presente no diretório atual
- [**JSR**](https://jsr.io/) The `jsr` package version is extracted from the `jsr.json`/`jsr.jsonc` or `deno.json`/`deno.jsonc` present in the current directory
- [**Cargo**](https://doc.rust-lang.org/cargo/) O versionamento de pacotes `cargo`é extraído do arquivo `Cargo.toml` presente no diretório atual
- [**Nimble**](https://github.com/nim-lang/nimble) - O versionamento de pacotes `nimble` é extraído do arquivo `*.nimble` presente no diretório atual com o comando`nimble dump`
- [**Poetry**](https://python-poetry.org/) O versionamento de pacotes `poetry` é extraído do arquivo `pyproject.toml` presente no diretório atual
@@ -3424,6 +3535,49 @@ The `pijul_channel` module shows the active channel of the repo in your current
| `truncation_symbol` | `'…'` | O simbolo usado para indicar que o nome braço foi truncado. |
| `disabled` | `true` | Disables the `pijul` module. |
## Pixi
The `pixi` module shows the installed [pixi](https://pixi.sh) version as well as the activated environment, if `$PIXI_ENVIRONMENT_NAME` is set.
::: tip
This does not suppress pixi's own prompt modifier, you may want to run `pixi config set change-ps1 false`.
:::
### Opções
| Opções | Padrão | Descrição |
| -------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )(\($environment\) )]($style)'` | O formato do módulo. |
| `version_format` | `'v${raw}'` | A versão formatada. Available vars are `raw`, `major`, `minor`, & `patch`. |
| `symbol` | `'🧚 '` | O simbolo usado antes do nome do environment. |
| `style` | `'yellow bold' | O estilo do módulo. |
| `show_default_environment` | `true` | Whether to indicate that the `default` environment of your project is activated. |
| `pixi_binary` | `['pixi']` | Configures the pixi binary that Starship should execute when getting the version. |
| `detect_extensions` | `[]` | Quais extensões devem ativar este módulo. |
| `detect_files` | `['pixi.toml']` | Quais nomes de arquivos devem ativar este módulo. |
| `detect_folders` | `['.pixi']` | Quais pastas devem ativar este módulo. |
| `disabled` | `false` | Disables the `pixi` module. |
### Variáveis
| Variável | Exemplo | Descrição |
| ----------- | --------- | --------------------------------- |
| version | `v0.33.0` | The version of `pixi` |
| environment | `py311` | The current pixi environment |
| symbol | | Espelha o valor da opção `symbol` |
| style | | Espelha o valor da opção `style` |
### Exemplo
```toml
# ~/.config/starship.toml
[pixi]
format = '[$symbol$environment](yellow) '
```
## Pulumi
O módulo `pulumi` mostra o nome de usuário atual, a [Pulumi Stack](https://www.pulumi.com/docs/intro/concepts/stack/) selcionada e a versão.
@@ -3538,7 +3692,6 @@ 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
@@ -3546,16 +3699,16 @@ Por padrão, o módulo será exibido se qualquer das seguintes condições for a
### 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. |
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should execute when getting the version. |
| `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_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`. |
+4 -2
View File
@@ -168,7 +168,7 @@
- **Universal:** Funciona em qualquer shell, em qualquer sistema operacional.
- **Inteligente:** Mostra informações relevantes rapidamente.
- **Muitos recursos:** Suporte para todas as suas ferramentas favoritas.
- **Fácil:**Instalação rápida comece a usar em minutos.
- **Fácil:** Instalação rápida comece a usar em minutos.
<p align="center">
<a href="https://starship.rs/config/"><strong>Consulte a documentação&nbsp;&nbsp;▶</strong></a>
@@ -229,10 +229,12 @@ Ou instale o Starship usando qualquer um dos seguintes gerenciadores de pacotes:
| Alpine Linux 3.13+ | [Alpine Linux Packages](https://pkgs.alpinelinux.org/packages?name=starship) | `apk add starship` |
| Arch Linux | [Arch Linux Extra](https://archlinux.org/packages/extra/x86_64/starship) | `pacman -S starship` |
| CentOS 7+ | [Copr](https://copr.fedorainfracloud.org/coprs/atim/starship) | `dnf copr enable atim/starship` <br /> `dnf install starship` |
| Debian 13+ | [Debian Main](https://sources.debian.org/src/starship/1.22.1-1/) | `apt install starship` |
| Gentoo | [Gentoo Packages](https://packages.gentoo.org/packages/app-shells/starship) | `emerge app-shells/starship` |
| Manjaro | | `pacman -S starship` |
| NixOS | [nixpkgs](https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/misc/starship/default.nix) | `nix-env -iA nixpkgs.starship` |
| openSUSE | [OSS](https://software.opensuse.org/package/starship) | `zypper in starship` |
| Ubuntu 25.04+ | [Ubuntu Universe](https://packages.ubuntu.com/source/plucky/starship) | `apt install starship` |
| Void Linux | [Void Linux Packages](https://github.com/void-linux/void-packages/tree/master/srcpkgs/starship) | `xbps-install -S starship` |
</details>
@@ -345,7 +347,7 @@ mkdir ($nu.data-dir | path join "vendor/autoload")
starship init nu | save -f ($nu.data-dir | path join "vendor/autoload/starship.nu")
```
Note: Only Nushell v0.96+ is supported
Nota: Somente o Nushell v0.96+ é suportado
</details>
+6
View File
@@ -75,3 +75,9 @@ This preset is heavily inspired by [Pastel Powerline](./pastel-powerline.md), an
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.
[![Screenshot of Jetpack preset](/presets/img/jetpack.png "Click to view Jetpack preset")](./jetpack)
## [Catppuccin Powerline](./catppuccin-powerline.md)
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
[![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png "Click to view Catppuccin Powerline preset")](./catppuccin-powerline)
@@ -0,0 +1,28 @@
[Return to Presets](./README.md#catppuccin-powerline)
# Catppuccin Powerline Preset
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png)
### Pré-requisitos
- A [Nerd Font](https://www.nerdfonts.com/) installed and enabled in your terminal
### Configuração
```sh
starship preset catppuccin-powerline -o ~/.config/starship.toml
```
By default this preset uses the Mocha flavour of Catppucin, but you can specify any of the flavours by modifying the value of `palette`:
- `catppuccin_mocha`
- `catppuccin_frappe`
- `catppuccin_macchiato`
- `catppucin_latte`
[Click to download TOML](/presets/toml/catppuccin-powerline.toml)
<<< @/public/presets/toml/catppuccin-powerline.toml
+168 -15
View File
@@ -328,6 +328,7 @@ $azure\
$nats\
$direnv\
$env_var\
$mise\
$crystal\
$custom\
$sudo\
@@ -339,6 +340,7 @@ $time\
$status\
$os\
$container\
$netns\
$shell\
$character"""
```
@@ -618,7 +620,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
*: This variable can only be used as a part of a style string
### Examples
### Example
#### Customize the format
@@ -629,15 +631,6 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
format = 'via [🍔 $version](bold green) '
```
#### Replace Node.js
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']
```
## C
The `c` module shows some information about your C compiler. By default the module will be shown if the current directory contains a `.c` or `.h` file.
@@ -684,6 +677,53 @@ If a C compiler is not supported by this module, you can request it by [raising
format = 'via [$name $version]($style)'
```
## CPP
The `cpp` module shows some information about your `C++` compiler. By default, the module will be shown if the current directory contains a `.cpp`, `.hpp`, or other `C++`-related files.
### Options
| Option | Default | Description |
| ------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version(-$name) )]($style)'` | The format string for the module. |
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
| `symbol` | `'C++ '` | The symbol used before displaying the compiler details |
| `detect_extensions` | `['cpp', 'cc', 'cxx', 'c++', 'hpp', 'hh', 'hxx', 'h++', 'tcc']` | Which extensions should trigger this module. |
| `detect_files` | `[]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. |
| `commands` | `[ [ 'c++', '--version' ], [ 'g++', '--version' ], [ 'clang++', '--version' ] ]` | How to detect what the compiler is |
| `style` | `'bold 149'` | The style for the module. |
| `disabled` | `true` | Disables the `cpp` module. |
### Variables
| Variable | Example | Description |
| -------- | ------- | ------------------------------------ |
| name | clang++ | The name of the compiler |
| version | 13.0.0 | The version of the compiler |
| symbol | | Mirrors the value of option `symbol` |
| style | | Mirrors the value of option `style` |
NB that `version` is not in the default format.
### Commands
The `commands` option accepts a list of commands to determine the compiler version and name.
Each command is represented as a list of the executable name, followed by its arguments, usually something like `['mycpp', '--version']`. Starship will try executing each command until it gets a result on STDOUT.
If a C++ compiler is not supported by this module, you can request it by [raising an issue on GitHub](https://github.com/starship/starship/).
### Example
```toml
# ~/.config/starship.toml
[cpp]
disabled = false
format = 'via [$name $version]($style)'
```
## Character
The `character` module shows a character (usually an arrow) beside where the text is entered in your terminal.
@@ -874,6 +914,7 @@ This does not suppress conda's own prompt modifier, you may want to run `conda c
| `style` | `'bold green'` | The style for the module. |
| `format` | `'via [$symbol$environment]($style) '` | The format for the module. |
| `ignore_base` | `true` | Ignores `base` environment when activated. |
| `detect_env_vars` | `["!PIXI_ENVIRONMENT_NAME"]` | Which environment variable(s) should trigger this module. If it's a pixi environment, this module is not being triggered by default. |
| `disabled` | `false` | Disables the `conda` module. |
### Variables
@@ -1876,7 +1917,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
### Options
| Option | Default | Description |
| ------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| -------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | The default format for `git_status` |
| `conflicted` | `'='` | This branch has merge conflicts. |
| `ahead` | `'⇡'` | The format of `ahead` |
@@ -1894,6 +1935,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
| `ignore_submodules` | `false` | Ignore changes to submodules. |
| `disabled` | `false` | Disables the `git_status` module. |
| `windows_starship` | | Use this (Linux) path to a Windows Starship executable to render `git_status` when on Windows paths in WSL. |
| `use_git_executable` | `false` | Do not use `gitoxide` for computing the status, but use the `git` executable instead. |
### Variables
@@ -2817,6 +2859,40 @@ truncation_length = 4
truncation_symbol = ''
```
## Mise
The `mise` module shows the current mise health as reported by running `mise doctor`.
### Options
| Option | Default | Description |
| ------------------ | -------------------------------- | ------------------------------------------------ |
| `symbol` | `'mise '` | The symbol used before displaying _mise_ health. |
| `style` | `'bold purple'` | The style for the module. |
| `format` | `'on [$symbol$health]($style) '` | The format for the module. |
| `healthy_symbol` | `healthy` | The message displayed when _mise_ is healthy. |
| `unhealthy_symbol` | `unhealthy` | The message displayed when _mise_ is unhealthy. |
| `disabled` | `true` | Disables the `mise` module. |
### Variables
| Variable | Example | Description |
| --------- | --------- | ------------------------------------ |
| health | `healthy` | The health of _mise_ |
| 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
[mise]
health = 'ready'
```
## Mojo
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
@@ -2881,6 +2957,37 @@ format = '[$symbol]($style)'
style = 'bold purple'
```
## Network Namespace
The `netns` module shows the current network namespace. This uses `ip netns identify` to get the network namespace, so only network namespaces mounted at `/var/run/netns` will be detected.
### Options
| Option | Default | Description |
| ---------- | --------------------------------- | ----------------------------------------------------------------- |
| `format` | `'[$symbol \[$name\]]($style)'` | The format for the module. |
| `symbol` | `'🛜 '` | The symbol used before the network namespace (defaults to empty). |
| `style` | `'blue bold dimmed'` | The style for the module. |
| `disabled` | `false` | Disables the `netns` module. |
### Variables
| Variable | Example | Description |
| --------- | ---------- | ----------------------------------------- |
| name | `my-netns` | The name of the current network namespace |
| symbol | | Mirrors the value of option `symbol` |
| style\* | | Mirrors the value of option `style` |
### Example
```toml
# ~/.config/starship.toml
[netns]
style = 'bold yellow'
symbol = '🌐 '
```
## Nim
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). By default the module will be shown if any of the following conditions are met:
@@ -2975,6 +3082,8 @@ The `nodejs` module shows the currently installed version of [Node.js](https://n
- The current directory contains a file with the `.js`, `.mjs` or `.cjs` extension
- The current directory contains a file with the `.ts`, `.mts` or `.cts` extension
Additionally, the module will be hidden by default if the directory contains a `bunfig.toml`, `bun.lock`, or `bun.lockb` file, overriding the above conditions.
### Options
| Option | Default | Description |
@@ -3202,6 +3311,7 @@ Amazon = "🙂 "
Android = "🤖 "
Arch = "🎗️ "
Artix = "🎗️ "
Bluefin = "🐟 "
CachyOS = "🎗️ "
CentOS = "💠 "
Debian = "🌀 "
@@ -3280,6 +3390,7 @@ Arch = "Arch is the best! "
The `package` module is shown when the current directory is the repository for a package, and shows its current version. The module currently supports `npm`, `nimble`, `cargo`, `poetry`, `python`, `composer`, `gradle`, `julia`, `mix`, `helm`, `shards`, `daml` and `dart` packages.
- [**npm**](https://docs.npmjs.com/cli/commands/npm) The `npm` package version is extracted from the `package.json` present in the current directory
- [**JSR**](https://jsr.io/) The `jsr` package version is extracted from the `jsr.json`/`jsr.jsonc` or `deno.json`/`deno.jsonc` present in the current directory
- [**Cargo**](https://doc.rust-lang.org/cargo/) The `cargo` package version is extracted from the `Cargo.toml` present in the current directory
- [**Nimble**](https://github.com/nim-lang/nimble) - The `nimble` package version is extracted from the `*.nimble` file present in the current directory with the `nimble dump` command
- [**Poetry**](https://python-poetry.org/) The `poetry` package version is extracted from the `pyproject.toml` present in the current directory
@@ -3424,6 +3535,49 @@ The `pijul_channel` module shows the active channel of the repo in your current
| `truncation_symbol` | `'…'` | The symbol used to indicate a branch name was truncated. |
| `disabled` | `true` | Disables the `pijul` module. |
## Pixi
The `pixi` module shows the installed [pixi](https://pixi.sh) version as well as the activated environment, if `$PIXI_ENVIRONMENT_NAME` is set.
::: tip
This does not suppress pixi's own prompt modifier, you may want to run `pixi config set change-ps1 false`.
:::
### Options
| Option | Default | Description |
| -------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )(\($environment\) )]($style)'` | The format for the module. |
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch`. |
| `symbol` | `'🧚 '` | The symbol used before the environment name. |
| `style` | `'yellow bold' | The style for the module. |
| `show_default_environment` | `true` | Whether to indicate that the `default` environment of your project is activated. |
| `pixi_binary` | `['pixi']` | Configures the pixi binary that Starship should execute when getting the version. |
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
| `detect_files` | `['pixi.toml']` | Which filenames should trigger this module. |
| `detect_folders` | `['.pixi']` | Which folders should trigger this module. |
| `disabled` | `false` | Disables the `pixi` module. |
### Variables
| Variable | Example | Description |
| ----------- | --------- | ------------------------------------ |
| version | `v0.33.0` | The version of `pixi` |
| environment | `py311` | The current pixi environment |
| symbol | | Mirrors the value of option `symbol` |
| style | | Mirrors the value of option `style` |
### Example
```toml
# ~/.config/starship.toml
[pixi]
format = '[$symbol$environment](yellow) '
```
## Pulumi
The `pulumi` module shows the current username, selected [Pulumi Stack](https://www.pulumi.com/docs/intro/concepts/stack/), and version.
@@ -3538,7 +3692,6 @@ 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
@@ -3546,16 +3699,16 @@ By default, the module will be shown if any of the following conditions are met:
### 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. |
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should execute 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_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. |
+2
View File
@@ -229,10 +229,12 @@ Alternatively, install Starship using any of the following package managers:
| Alpine Linux 3.13+ | [Alpine Linux Packages](https://pkgs.alpinelinux.org/packages?name=starship) | `apk add starship` |
| Arch Linux | [Arch Linux Extra](https://archlinux.org/packages/extra/x86_64/starship) | `pacman -S starship` |
| CentOS 7+ | [Copr](https://copr.fedorainfracloud.org/coprs/atim/starship) | `dnf copr enable atim/starship` <br /> `dnf install starship` |
| Debian 13+ | [Debian Main](https://sources.debian.org/src/starship/1.22.1-1/) | `apt install starship` |
| Gentoo | [Gentoo Packages](https://packages.gentoo.org/packages/app-shells/starship) | `emerge app-shells/starship` |
| Manjaro | | `pacman -S starship` |
| NixOS | [nixpkgs](https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/misc/starship/default.nix) | `nix-env -iA nixpkgs.starship` |
| openSUSE | [OSS](https://software.opensuse.org/package/starship) | `zypper in starship` |
| Ubuntu 25.04+ | [Ubuntu Universe](https://packages.ubuntu.com/source/plucky/starship) | `apt install starship` |
| Void Linux | [Void Linux Packages](https://github.com/void-linux/void-packages/tree/master/srcpkgs/starship) | `xbps-install -S starship` |
</details>
+6
View File
@@ -75,3 +75,9 @@ This preset is heavily inspired by [Pastel Powerline](./pastel-powerline.md), an
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.
[![Screenshot of Jetpack preset](/presets/img/jetpack.png "Click to view Jetpack preset")](./jetpack)
## [Catppuccin Powerline](./catppuccin-powerline.md)
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
[![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png "Click to view Catppuccin Powerline preset")](./catppuccin-powerline)
@@ -0,0 +1,28 @@
[Return to Presets](./README.md#catppuccin-powerline)
# Catppuccin Powerline Preset
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png)
### Prerequisites
- A [Nerd Font](https://www.nerdfonts.com/) installed and enabled in your terminal
### Configuration
```sh
starship preset catppuccin-powerline -o ~/.config/starship.toml
```
By default this preset uses the Mocha flavour of Catppucin, but you can specify any of the flavours by modifying the value of `palette`:
- `catppuccin_mocha`
- `catppuccin_frappe`
- `catppuccin_macchiato`
- `catppucin_latte`
[Click to download TOML](/presets/toml/catppuccin-powerline.toml)
<<< @/public/presets/toml/catppuccin-powerline.toml
+1 -1
View File
@@ -170,7 +170,7 @@ onMounted(() => {
:::
Добавьте следующее в конец вашей конфигурации Nutshell (найдите это, запустив `$nu.config-path` в Nutshell):
Добавьте следующее в конец вашей конфигурации Nushell (найдите это, запустив `$nu.config-path` в Nushell):
```sh
mkdir ($nu.data-dir | path join "vendor/autoload")
+5 -5
View File
@@ -280,16 +280,16 @@ continuation_prompt = '▶️▶️ '
- `italic`
- `underline`
- `dimmed`
- `инвертировано`
- `мерцать`
- `скрытый`
- `зачеркнуто`
- `inverted`
- `blink`
- `hidden`
- `strikethrough`
- `bg:<color>`
- `fg:<color>`
- `<color>`
- `none`
где `<color>` является цветовым спецификатором (обсуждается ниже). `fg:<color>` и `<color>` в настоящее время выполняет то же самое, хотя в будущем это может измениться. `<color>` также может быть установлено значение `prev_fg` или `prev_bg`, которое соответствует цвету переднего плана или фона предыдущего элемента соответственно, если доступно, или `нет` в противном случае. `инвертировано` меняет местами цвета фона и переднего плана. Порядок слов в строке не имеет значения.
где `<color>` является цветовым спецификатором (обсуждается ниже). `fg:<color>` и `<color>` в настоящее время выполняет то же самое, хотя в будущем это может измениться. `<color>` также может быть установлено значение `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 bg:none` также эквивалентно `fg:red` или `red`. Использование `none` в сочетании с другими токенами может стать ошибкой в будущем.
+184 -31
View File
@@ -328,6 +328,7 @@ $azure\
$nats\
$direnv\
$env_var\
$mise\
$crystal\
$custom\
$sudo\
@@ -339,6 +340,7 @@ $time\
$status\
$os\
$container\
$netns\
$shell\
$character"""
```
@@ -618,7 +620,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
*: Эта переменная может использоваться только в качестве части строки style
### Примеры
### Пример
#### Customize the format
@@ -629,15 +631,6 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
format = 'via [🍔 $version](bold green) '
```
#### Replace Node.js
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']
```
## C
The `c` module shows some information about your C compiler. By default the module will be shown if the current directory contains a `.c` or `.h` file.
@@ -684,6 +677,53 @@ If a C compiler is not supported by this module, you can request it by [raising
format = 'via [$name $version]($style)'
```
## CPP
The `cpp` module shows some information about your `C++` compiler. By default, the module will be shown if the current directory contains a `.cpp`, `.hpp`, or other `C++`-related files.
### Опции
| Параметр | По умолчанию | Описание |
| ------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version(-$name) )]($style)'` | The format string for the module. |
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
| `symbol` | `'C++ '` | The symbol used before displaying the compiler details |
| `detect_extensions` | `['cpp', 'cc', 'cxx', 'c++', 'hpp', 'hh', 'hxx', 'h++', 'tcc']` | Which extensions should trigger this module. |
| `detect_files` | `[]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. |
| `commands` | `[ [ 'c++', '--version' ], [ 'g++', '--version' ], [ 'clang++', '--version' ] ]` | How to detect what the compiler is |
| `style` | `'bold 149'` | Стиль модуля. |
| `disabled` | `true` | Disables the `cpp` module. |
### Переменные
| Переменная | Пример | Описание |
| ---------- | ------- | ------------------------------------ |
| name | clang++ | The name of the compiler |
| version | 13.0.0 | The version of the compiler |
| symbol | | Отражает значение параметра `symbol` |
| style | | Отражает значение параметра `style` |
NB that `version` is not in the default format.
### Commands
The `commands` option accepts a list of commands to determine the compiler version and name.
Each command is represented as a list of the executable name, followed by its arguments, usually something like `['mycpp', '--version']`. Starship will try executing each command until it gets a result on STDOUT.
If a C++ compiler is not supported by this module, you can request it by [raising an issue on GitHub](https://github.com/starship/starship/).
### Пример
```toml
# ~/.config/starship.toml
[cpp]
disabled = false
format = 'via [$name $version]($style)'
```
## Символ
Модуль `character` показывает символ (обычно, стрелка) рядом с вводимым текстом в терминале.
@@ -874,6 +914,7 @@ The `conda` module shows the current [Conda](https://docs.conda.io/en/latest/) e
| `style` | `'bold green'` | Стиль модуля. |
| `format` | `'via [$symbol$environment]($style) '` | Формат модуля. |
| `ignore_base` | `true` | Ignores `base` environment when activated. |
| `detect_env_vars` | `["!PIXI_ENVIRONMENT_NAME"]` | Which environment variable(s) should trigger this module. If it's a pixi environment, this module is not being triggered by default. |
| `disabled` | `false` | Отключает модуль `conda`. |
### Переменные
@@ -1876,7 +1917,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
### Опции
| Параметр | По умолчанию | Описание |
| ------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| -------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | The default format for `git_status` |
| `conflicted` | `'='` | Эта ветка имеет конфликты слияния. |
| `ahead` | `'⇡'` | The format of `ahead` |
@@ -1894,6 +1935,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
| `ignore_submodules` | `false` | Ignore changes to submodules. |
| `disabled` | `false` | Отключает модуль `git_status`. |
| `windows_starship` | | Use this (Linux) path to a Windows Starship executable to render `git_status` when on Windows paths in WSL. |
| `use_git_executable` | `false` | Do not use `gitoxide` for computing the status, but use the `git` executable instead. |
### Переменные
@@ -1971,7 +2013,7 @@ windows_starship = '/mnt/c/Users/username/scoop/apps/starship/current/starship.e
The `gleam` module shows the currently installed version of [Gleam](https://gleam.run/). By default the module will be shown if any of the following conditions are met:
- The current directory contains a `gleam.toml` file
- Текущий каталог содержит файл `gleam.toml`
- The current directory contains a file with the `.gleam` extension
### Опции
@@ -2817,6 +2859,40 @@ truncation_length = 4
truncation_symbol = ''
```
## Mise
The `mise` module shows the current mise health as reported by running `mise doctor`.
### Опции
| Параметр | По умолчанию | Описание |
| ------------------ | -------------------------------- | ------------------------------------------------ |
| `symbol` | `'mise '` | The symbol used before displaying _mise_ health. |
| `style` | `'bold purple'` | Стиль модуля. |
| `format` | `'on [$symbol$health]($style) '` | Формат модуля. |
| `healthy_symbol` | `healthy` | The message displayed when _mise_ is healthy. |
| `unhealthy_symbol` | `unhealthy` | The message displayed when _mise_ is unhealthy. |
| `disabled` | `true` | Disables the `mise` module. |
### Переменные
| Переменная | Пример | Описание |
| ---------- | --------- | ------------------------------------ |
| health | `healthy` | The health of _mise_ |
| symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` |
*: Эта переменная может использоваться только в качестве части строки style
### Пример
```toml
# ~/.config/starship.toml
[mise]
health = 'ready'
```
## Mojo
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
@@ -2881,6 +2957,37 @@ format = '[$symbol]($style)'
style = 'bold purple'
```
## Network Namespace
The `netns` module shows the current network namespace. This uses `ip netns identify` to get the network namespace, so only network namespaces mounted at `/var/run/netns` will be detected.
### Опции
| Параметр | По умолчанию | Описание |
| ---------- | --------------------------------- | ----------------------------------------------------------------- |
| `format` | `'[$symbol \[$name\]]($style)'` | Формат модуля. |
| `symbol` | `'🛜 '` | The symbol used before the network namespace (defaults to empty). |
| `style` | `'blue bold dimmed'` | Стиль модуля. |
| `disabled` | `false` | Disables the `netns` module. |
### Переменные
| Переменная | Пример | Описание |
| ---------- | ---------- | ----------------------------------------- |
| name | `my-netns` | The name of the current network namespace |
| symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` |
### Пример
```toml
# ~/.config/starship.toml
[netns]
style = 'bold yellow'
symbol = '🌐 '
```
## Nim
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). By default the module will be shown if any of the following conditions are met:
@@ -2975,6 +3082,8 @@ The `nodejs` module shows the currently installed version of [Node.js](https://n
- The current directory contains a file with the `.js`, `.mjs` or `.cjs` extension
- The current directory contains a file with the `.ts`, `.mts` or `.cts` extension
Additionally, the module will be hidden by default if the directory contains a `bunfig.toml`, `bun.lock`, or `bun.lockb` file, overriding the above conditions.
### Опции
| Параметр | По умолчанию | Описание |
@@ -3202,6 +3311,7 @@ Amazon = "🙂 "
Android = "🤖 "
Arch = "🎗️ "
Artix = "🎗️ "
Bluefin = "🐟 "
CachyOS = "🎗️ "
CentOS = "💠 "
Debian = "🌀 "
@@ -3280,6 +3390,7 @@ Arch = "Arch is the best! "
Модуль `package` отображается, когда текущий каталог является репозиторием для пакета и показывает его текущую версию. The module currently supports `npm`, `nimble`, `cargo`, `poetry`, `python`, `composer`, `gradle`, `julia`, `mix`, `helm`, `shards`, `daml` and `dart` packages.
- [**npm**](https://docs.npmjs.com/cli/commands/npm) The `npm` package version is extracted from the `package.json` present in the current directory
- [**JSR**](https://jsr.io/) The `jsr` package version is extracted from the `jsr.json`/`jsr.jsonc` or `deno.json`/`deno.jsonc` present in the current directory
- [**Cargo**](https://doc.rust-lang.org/cargo/) The `cargo` package version is extracted from the `Cargo.toml` present in the current directory
- [**Nimble**](https://github.com/nim-lang/nimble) - The `nimble` package version is extracted from the `*.nimble` file present in the current directory with the `nimble dump` command
- [**Poetry**](https://python-poetry.org/) The `poetry` package version is extracted from the `pyproject.toml` present in the current directory
@@ -3424,6 +3535,49 @@ The `pijul_channel` module shows the active channel of the repo in your current
| `truncation_symbol` | `'…'` | Символ, используемый для обозначения усечения названия ветки. |
| `disabled` | `true` | Disables the `pijul` module. |
## Pixi
The `pixi` module shows the installed [pixi](https://pixi.sh) version as well as the activated environment, if `$PIXI_ENVIRONMENT_NAME` is set.
::: tip
This does not suppress pixi's own prompt modifier, you may want to run `pixi config set change-ps1 false`.
:::
### Опции
| Параметр | По умолчанию | Описание |
| -------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )(\($environment\) )]($style)'` | Формат модуля. |
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch`. |
| `symbol` | `'🧚 '` | Символ перед названием окружения. |
| `style` | `'yellow bold' | Стиль модуля. |
| `show_default_environment` | `true` | Whether to indicate that the `default` environment of your project is activated. |
| `pixi_binary` | `['pixi']` | Configures the pixi binary that Starship should execute when getting the version. |
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
| `detect_files` | `['pixi.toml']` | Which filenames should trigger this module. |
| `detect_folders` | `['.pixi']` | Which folders should trigger this module. |
| `disabled` | `false` | Disables the `pixi` module. |
### Переменные
| Переменная | Пример | Описание |
| ----------- | --------- | ------------------------------------ |
| version | `v0.33.0` | The version of `pixi` |
| environment | `py311` | The current pixi environment |
| symbol | | Отражает значение параметра `symbol` |
| style | | Отражает значение параметра `style` |
### Пример
```toml
# ~/.config/starship.toml
[pixi]
format = '[$symbol$environment](yellow) '
```
## Pulumi
The `pulumi` module shows the current username, selected [Pulumi Stack](https://www.pulumi.com/docs/intro/concepts/stack/), and version.
@@ -3538,7 +3692,6 @@ 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.
- Виртуальная среда в данный момент активирована
@@ -3546,16 +3699,16 @@ By default, the module will be shown if any of the following conditions are met:
### Опции
| Параметр | По умолчанию | Описание |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| -------------------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------- |
| `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. |
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should execute 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_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. |
@@ -4631,39 +4784,39 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt
### Переменные
| Переменная | Описание |
| ---------- | -------------------------------------- |
| output | The output of `command` run in `shell` |
| ---------- | ------------------------------------ |
| output | Выводит `command` запустив в `shell` |
| symbol | Отражает значение параметра `symbol` |
| style\* | Отражает значение параметра `style` |
*: Эта переменная может использоваться только в качестве части строки style
#### Custom command shell
#### Пользовательские команды shell
`shell` accepts a non-empty list of strings, where:
- The first string is the path to the shell to use to execute the command.
- Other following arguments are passed to the shell.
If unset, it will fallback to STARSHIP_SHELL and then to 'sh' on Linux, and 'cmd /C' on Windows.
Если этот параметр не установлен, он вернется к STARSHIP_SHELL, а затем к 'sh' на Linux и 'cmd /C' на Windows.
The `command` (and `when`, if applicable) will be passed in on stdin.
Команда `command` (и `when`, если применимо) будет передана на 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.
Если `shell` не указан или содержит только один элемент и Starship обнаруживает, что будут использовать PowerShell, то автоматически будут добавлены следующие аргументы: `-NoProfile -Command -`. Если `shell` не указан или содержит только один элемент, и Starship будет использоваться обнаружив Cmd, cледующий аргумент будет автоматически добавлен: `/C` и `stdin` будет установлен на `false`. Если `shell` не указан или содержит только один элемент, Starship обнаружит, что будет использоваться Nushell, cледующие аргументы будут автоматически добавлены: `-c` и `stdin` будут установлены на `false`. Такого поведения можно избежать путем явного передачи аргументов в shell, например.
```toml
shell = ['pwsh', '-Command', '-']
```
::: warning Make sure your custom shell configuration exits gracefully
::: предупреждение Убедитесь, что ваша пользовательская конфигурация оболочки завершается корректно
If you set a custom command, make sure that the default Shell used by starship will properly execute the command with a graceful exit (via the `shell` option).
Если вы задаете собственную команду, убедитесь, что оболочка по умолчанию, используемая starship, правильно выполняет команду с плавным выходом (через опцию `shell`).
For example, PowerShell requires the `-Command` parameter to execute a one liner. Omitting this parameter might throw starship into a recursive loop where the shell might try to load a full profile environment with starship itself again and hence re-execute the custom command, getting into a never ending loop.
Например, PowerShell требует параметра `-Command` для выполнения одного лайнера. Пропуск этого параметра может привести к тому, что starship попадет в рекурсивный цикл, в котором оболочка может попытаться снова загрузить среду с полным профилем с помощью starship и, следовательно, повторно выполнить пользовательскую команду, попадая в бесконечный цикл.
Parameters similar to `-NoProfile` in PowerShell are recommended for other shells as well to avoid extra loading time of a custom profile on every starship invocation.
Параметры, аналогичные `-NoProfile` в PowerShell, рекомендуются для других оболочек, a также, чтобы избежать дополнительного времени загрузки пользовательского профиля на каждом starship вызове.
Automatic detection of shells and proper parameters addition are currently implemented, but it's possible that not all shells are covered. [Please open an issue](https://github.com/starship/starship/issues/new/choose) with shell details and starship configuration if you hit such scenario.
Автоматическое определение оболочек и добавление соответствующих параметров в настоящее время реализованы, но возможно, что не все оболочки покрыты. [Пожалуйста, откройте проблему](https://github.com/starship/starship/issues/new/choose) с подробной информацией о shell и конфигурации starship, если вы столкнетесь с таким сценарием.
:::
@@ -4673,19 +4826,19 @@ Automatic detection of shells and proper parameters addition are currently imple
# ~/.config/starship.toml
[custom.foo]
command = 'echo foo' # shows output of command
detect_files = ['foo'] # can specify filters but wildcards are not supported
command = 'echo foo' # показывает выходные данные команды
detect_files = ['foo'] # можно указать фильтры, но подстановочные знаки не поддерживаются
when = ''' test "$HOME" = "$PWD" '''
format = ' transcending [$output]($style)'
[custom.time]
command = 'time /T'
detect_extensions = ['pst'] # filters *.pst files
detect_extensions = ['pst'] # фильтры *.pst файлов
shell = ['pwsh.exe', '-NoProfile', '-Command', '-']
[custom.time-as-arg]
command = 'time /T'
detect_extensions = ['pst'] # filters *.pst files
detect_extensions = ['pst'] # фильтры *.pst файлов
shell = ['pwsh.exe', '-NoProfile', '-Command']
use_stdin = false
```
+3 -1
View File
@@ -229,10 +229,12 @@ curl -sS https://starship.rs/install.sh | sh
| Alpine Linux 3.13+ | [Alpine Linux Packages](https://pkgs.alpinelinux.org/packages?name=starship) | `apk add starship` |
| Arch Linux | [Arch Linux Extra](https://archlinux.org/packages/extra/x86_64/starship) | `pacman -S starship` |
| CentOS 7+ | [Copr](https://copr.fedorainfracloud.org/coprs/atim/starship) | `dnf copr enable atim/starship` <br /> `dnf install starship` |
| Debian 13+ | [Debian Main](https://sources.debian.org/src/starship/1.22.1-1/) | `apt install starship` |
| Gentoo | [Gentoo Packages](https://packages.gentoo.org/packages/app-shells/starship) | `emerge app-shells/starship` |
| Manjaro | | `pacman -S starship` |
| NixOS | [nixpkgs](https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/misc/starship/default.nix) | `nix-env -iA nixpkgs.starship` |
| openSUSE | [OSS](https://software.opensuse.org/package/starship) | `zypper in starship` |
| Ubuntu 25.04+ | [Ubuntu Universe](https://packages.ubuntu.com/source/plucky/starship) | `apt install starship` |
| Void Linux | [Void Linux Packages](https://github.com/void-linux/void-packages/tree/master/srcpkgs/starship) | `xbps-install -S starship` |
</details>
@@ -338,7 +340,7 @@ eval $(starhip init ion)
<details>
<summary>Nushell</summary>
Добавьте следующее в конец вашей конфигурации Nutshell (найдите это, запустив `$nu.config-path` в Nushell):
Добавьте следующее в конец вашей конфигурации Nushell (найдите это, запустив `$nu.config-path` в Nushell):
```sh
mkdir ($nu.data-dir | path join "vendor/autoload")
+51 -51
View File
@@ -1,16 +1,16 @@
# Migrating to v0.45.0
# Миграция на v0.45.0
Starship v0.45.0 is a release containing breaking changes, in preparation for the big v1.0.0. We have made some major changes around how configuration is done on the prompt, to allow for a greater degree of customization.
Starship v0.45.0 - это релиз, содержащий важные изменения в рамках подготовки к выпуску большой v1.0.0. Мы внесли несколько существенных изменений в то, как выполняется настройка в промпте, чтобы обеспечить большую степень настройки.
This guide is intended to walk you through the breaking changes.
Это руководство предназначено для того, чтобы ознакомить вас с основными изменениями.
## `prompt_order` has been replaced by a root-level `format`
## `prompt_order` был заменен на корневой уровень `format`
Previously to v0.45.0, `prompt_order` would accept an array of module names in the order which they should be rendered by Starship.
Ранее, до v0.45.0, `prompt_order` принимал массив имен модулей в том порядке, в котором они должны были отображаться Starship.
Starship v0.45.0 instead accepts a `format` value, allowing for customization of the prompt outside of the modules themselves.
Вместо Starship v0.45.0 принимает значение `format`, что позволяет настраивать промпт вне самих модулей.
**Example pre-v0.45.0 configuration**
**Пример конфигурации pre-v0.45.0**
```toml
prompt_order = [
@@ -31,7 +31,7 @@ prompt_order = [
]
```
**Example v0.45.0 configuration**
**Пример конфигурации v0.45.0**
```toml
format = """\
@@ -52,20 +52,20 @@ format = """\
"""
```
## Module `prefix` and `suffix` have been replaced by `format`
## Модуль `prefix` и `suffix` были заменены на `format`
Previously to v0.45.0, some modules would accept `prefix` and/or `suffix` in order to stylize the way that modules are rendered.
Ранее, до v0.45.0, некоторые модули принимали `prefix` и/или `suffix`, чтобы стилизовать способ отображения модулей.
Starship v0.45.0 instead accepts a `format` value, allowing for further customization of how modules are rendered. Instead of defining a prefix and suffix for the context-based variables, the variables can now be substituted from within a format string, which represents the module's output.
Вместо Starship v0.45.0 принимает значение `format`, что позволяет дополнительно настроить отображение модулей. Вместо определения префикса и суффикса для контекстных переменных, теперь можно заменить переменные из строки формата, которая представляет вывод модуля.
**Example pre-v0.45.0 configuration**
**Пример конфигурации pre-v0.45.0**
```toml
[cmd_duration]
prefix = "took "
```
**Example v0.45.0 configuration**
**Пример конфигурации v0.45.0**
```toml
[cmd_duration]
@@ -74,18 +74,18 @@ prefix = "took "
format = "took [$duration]($style) "
```
### Affected Modules
### Затронутые модули
#### Символ
| Removed Property | Replacement |
| Удалено | Замена |
| ----------------------- | ---------------- |
| `symbol` | `success_symbol` |
| `use_symbol_for_status` | `error_symbol` |
| `style_success` | `success_symbol` |
| `style_failure` | `error_symbol` |
**Changes to the Default Configuration**
**Изменения в конфигурации по умолчанию**
```diff
[character]
@@ -98,26 +98,26 @@ format = "took [$duration]($style) "
++ vicmd_symbol = "[](bold green)"
```
Previously, the `use_symbol_for_status` property was used to configure the prompt to show the `error_symbol` when the last command resulted in a non-zero status code.
Ранее свойство `use_symbol_for_status` использовалось для настройки промпта на отображение `error_symbol`, когда результатом выполнения последней команды был ненулевой код состояния.
With the release of v0.45.0, we now always use `error_symbol` after non-zero status codes, unifying `use_symbol_for_status` and `error_symbol` properties.
С выходом v0.45.0 мы теперь всегда используем `error_symbol` после ненулевых кодов состояния, объединяя свойства `use_symbol_for_status` и `error_symbol`.
To configure the prompt to use the older `use_symbol_for_status = true` configuration, add the following to your config file:
Чтобы настроить промпт на использование более старой конфигурации `use_symbol_for_status = true`, добавьте в свой конфигурационный файл следующее:
```toml
[character]
error_symbol = "[](bold red)"
```
_Note:_ The `character` element automatically adds a space after, so unlike the other `format` strings, we specifically do not add one in the above examples.
_Примечание:_ После элемента `character` автоматически добавляется пробел, поэтому, в отличие от других строк `format`, мы специально не добавляем его в приведенных выше примерах.
#### Длительность команды
| Removed Property | Replacement |
| ---------------- | ----------- |
| Удалено | Замена |
| -------- | -------- |
| `prefix` | `format` |
**Changes to the Default Configuration**
**Изменения в конфигурации по умолчанию**
```diff
[cmd_duration]
@@ -127,11 +127,11 @@ _Note:_ The `character` element automatically adds a space after, so unlike the
#### Каталог
| Removed Property | Replacement |
| ---------------- | ----------- |
| Удалено | Замена |
| -------- | -------- |
| `prefix` | `format` |
**Changes to the Default Configuration**
**Изменения в конфигурации по умолчанию**
```diff
[directory]
@@ -141,12 +141,12 @@ _Note:_ The `character` element automatically adds a space after, so unlike the
#### Переменная Окружения
| Removed Property | Replacement |
| ---------------- | ----------- |
| Удалено | Замена |
| -------- | -------- |
| `prefix` | `format` |
| `suffix` | `format` |
**Changes to the Default Configuration**
**Изменения в конфигурации по умолчанию**
```diff
[env_var]
@@ -157,12 +157,12 @@ _Note:_ The `character` element automatically adds a space after, so unlike the
#### Коммит Git
| Removed Property | Replacement |
| ---------------- | ----------- |
| Удалено | Замена |
| -------- | -------- |
| `prefix` | `format` |
| `suffix` | `format` |
**Changes to the Default Configuration**
**Изменения в конфигурации по умолчанию**
```diff
[git_commit]
@@ -173,13 +173,13 @@ _Note:_ The `character` element automatically adds a space after, so unlike the
#### Статус Git
| Removed Property | Replacement |
| ----------------- | ----------- |
| Удалено | Замена |
| ----------------- | -------- |
| `prefix` | `format` |
| `suffix` | `format` |
| `show_sync_count` | `format` |
**Changes to the Default Configuration**
**Изменения в конфигурации по умолчанию**
```diff
[git_status]
@@ -189,11 +189,11 @@ _Note:_ The `character` element automatically adds a space after, so unlike the
++ format = '([\[$all_status$ahead_behind\]]($style) )'
```
Previously, the `show_sync_count` property was used to configure the prompt to show the number of commits the branch was ahead or behind the remote branch.
Ранее свойство `show_sync_count` использовалось для настройки промпта на отображение количества коммитов, которые ветвь выполняла перед удаленной ветвью или позади нее.
With the release of v0.45.0, this has been replaced with three separate properties, `ahead`, `behind`, and `diverged`.
С выпуском v0.45.0 это было заменено тремя отдельными свойствами: `ahead`, `behind` и `diverged`.
To configure the prompt to use the older `show_sync_count = true` configuration, set the following to your config file:
Чтобы настроить промпт на использование более старой конфигурации `show_sync_count = true`, задайте в вашем конфигурационном файле следующее:
```toml
[git_status]
@@ -204,12 +204,12 @@ behind = "⇣${count}"
#### Имя хоста
| Removed Property | Replacement |
| ---------------- | ----------- |
| Удалено | Замена |
| -------- | -------- |
| `prefix` | `format` |
| `suffix` | `format` |
**Changes to the Default Configuration**
**Изменения в конфигурации по умолчанию**
```diff
[hostname]
@@ -220,13 +220,13 @@ behind = "⇣${count}"
#### Singularity
| Removed Property | Replacement |
| ---------------- | ----------- |
| Удалено | Замена |
| -------- | -------- |
| `label` | `format` |
| `prefix` | `format` |
| `suffix` | `format` |
**Changes to the Default Configuration**
**Изменения в конфигурации по умолчанию**
```diff
[singularity]
@@ -237,11 +237,11 @@ behind = "⇣${count}"
#### Время
| Removed Property | Replacement |
| ---------------- | ------------- |
| Удалено | Замена |
| -------- | ------------- |
| `format` | `time_format` |
**Changes to the Default Configuration**
**Изменения в конфигурации по умолчанию**
```diff
[time]
@@ -250,14 +250,14 @@ behind = "⇣${count}"
++ format = "at 🕙[$time]($style) "
```
#### Custom Commands
#### Пользовательские команды
| Removed Property | Replacement |
| ---------------- | ----------- |
| Удалено | Замена |
| -------- | -------- |
| `prefix` | `format` |
| `suffix` | `format` |
**Changes to the Default Configuration**
**Изменения в конфигурации по умолчанию**
```diff
[custom.example]
+6
View File
@@ -75,3 +75,9 @@
Это псевдоминималистичный пресет, вдохновленный приглашениями командной оболочки [geometry](https://github.com/geometry-zsh/geometry) и [spaceship](https://github.com/spaceship-prompt/spaceship-prompt).
[![Скриншот пресета Jetpack](/presets/img/jetpack.png "Нажмите, чтобы просмотреть пресет Jetpack")](./jetpack)
## [Catppuccin Powerline](./catppuccin-powerline.md)
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
[![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png "Click to view Catppuccin Powerline preset")](./catppuccin-powerline)
@@ -0,0 +1,28 @@
[Return to Presets](./README.md#catppuccin-powerline)
# Catppuccin Powerline Preset
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png)
### Обязательные требования
- A [Nerd Font](https://www.nerdfonts.com/) installed and enabled in your terminal
### Конфигурация
```sh
starship preset catppuccin-powerline -o ~/.config/starship.toml
```
By default this preset uses the Mocha flavour of Catppucin, but you can specify any of the flavours by modifying the value of `palette`:
- `catppuccin_mocha`
- `catppuccin_frappe`
- `catppuccin_macchiato`
- `catppucin_latte`
[Click to download TOML](/presets/toml/catppuccin-powerline.toml)
<<< @/public/presets/toml/catppuccin-powerline.toml
+168 -15
View File
@@ -328,6 +328,7 @@ $azure\
$nats\
$direnv\
$env_var\
$mise\
$crystal\
$custom\
$sudo\
@@ -339,6 +340,7 @@ $time\
$status\
$os\
$container\
$netns\
$shell\
$character"""
```
@@ -618,7 +620,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
*: This variable can only be used as a part of a style string
### Examples
### Example
#### Customize the format
@@ -629,15 +631,6 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
format = 'via [🍔 $version](bold green) '
```
#### Replace Node.js
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']
```
## C
The `c` module shows some information about your C compiler. By default the module will be shown if the current directory contains a `.c` or `.h` file.
@@ -684,6 +677,53 @@ If a C compiler is not supported by this module, you can request it by [raising
format = 'via [$name $version]($style)'
```
## CPP
The `cpp` module shows some information about your `C++` compiler. By default, the module will be shown if the current directory contains a `.cpp`, `.hpp`, or other `C++`-related files.
### Options
| Option | Default | Description |
| ------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version(-$name) )]($style)'` | The format string for the module. |
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
| `symbol` | `'C++ '` | The symbol used before displaying the compiler details |
| `detect_extensions` | `['cpp', 'cc', 'cxx', 'c++', 'hpp', 'hh', 'hxx', 'h++', 'tcc']` | Which extensions should trigger this module. |
| `detect_files` | `[]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. |
| `commands` | `[ [ 'c++', '--version' ], [ 'g++', '--version' ], [ 'clang++', '--version' ] ]` | How to detect what the compiler is |
| `stil` | `'bold 149'` | The style for the module. |
| `disabled` | `true` | Disables the `cpp` module. |
### Variables
| Variable | Example | Description |
| -------- | ------- | ------------------------------------ |
| name | clang++ | The name of the compiler |
| version | 13.0.0 | The version of the compiler |
| symbol | | Mirrors the value of option `symbol` |
| stil | | Mirrors the value of option `style` |
NB that `version` is not in the default format.
### Commands
The `commands` option accepts a list of commands to determine the compiler version and name.
Each command is represented as a list of the executable name, followed by its arguments, usually something like `['mycpp', '--version']`. Starship will try executing each command until it gets a result on STDOUT.
If a C++ compiler is not supported by this module, you can request it by [raising an issue on GitHub](https://github.com/starship/starship/).
### Example
```toml
# ~/.config/starship.toml
[cpp]
disabled = false
format = 'via [$name $version]($style)'
```
## Character
The `character` module shows a character (usually an arrow) beside where the text is entered in your terminal.
@@ -874,6 +914,7 @@ This does not suppress conda's own prompt modifier, you may want to run `conda c
| `stil` | `'bold green'` | The style for the module. |
| `format` | `'via [$symbol$environment]($style) '` | The format for the module. |
| `ignore_base` | `true` | Ignores `base` environment when activated. |
| `detect_env_vars` | `["!PIXI_ENVIRONMENT_NAME"]` | Which environment variable(s) should trigger this module. If it's a pixi environment, this module is not being triggered by default. |
| `disabled` | `false` | Disables the `conda` module. |
### Variables
@@ -1876,7 +1917,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
### Options
| Option | Default | Description |
| ------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| -------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | The default format for `git_status` |
| `conflicted` | `'='` | This branch has merge conflicts. |
| `ahead` | `'⇡'` | The format of `ahead` |
@@ -1894,6 +1935,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
| `ignore_submodules` | `false` | Ignore changes to submodules. |
| `disabled` | `false` | Disables the `git_status` module. |
| `windows_starship` | | Use this (Linux) path to a Windows Starship executable to render `git_status` when on Windows paths in WSL. |
| `use_git_executable` | `false` | Do not use `gitoxide` for computing the status, but use the `git` executable instead. |
### Variables
@@ -2817,6 +2859,40 @@ truncation_length = 4
truncation_symbol = ''
```
## Mise
The `mise` module shows the current mise health as reported by running `mise doctor`.
### Options
| Option | Default | Description |
| ------------------ | -------------------------------- | ------------------------------------------------ |
| `symbol` | `'mise '` | The symbol used before displaying _mise_ health. |
| `stil` | `'bold purple'` | The style for the module. |
| `format` | `'on [$symbol$health]($style) '` | The format for the module. |
| `healthy_symbol` | `healthy` | The message displayed when _mise_ is healthy. |
| `unhealthy_symbol` | `unhealthy` | The message displayed when _mise_ is unhealthy. |
| `disabled` | `true` | Disables the `mise` module. |
### Variables
| Variable | Example | Description |
| --------- | --------- | ------------------------------------ |
| health | `healthy` | The health of _mise_ |
| 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
[mise]
health = 'ready'
```
## Mojo
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
@@ -2881,6 +2957,37 @@ format = '[$symbol]($style)'
style = 'bold purple'
```
## Network Namespace
The `netns` module shows the current network namespace. This uses `ip netns identify` to get the network namespace, so only network namespaces mounted at `/var/run/netns` will be detected.
### Options
| Option | Default | Description |
| ---------- | --------------------------------- | ----------------------------------------------------------------- |
| `format` | `'[$symbol \[$name\]]($style)'` | The format for the module. |
| `symbol` | `'🛜 '` | The symbol used before the network namespace (defaults to empty). |
| `stil` | `'blue bold dimmed'` | The style for the module. |
| `disabled` | `false` | Disables the `netns` module. |
### Variables
| Variable | Example | Description |
| --------- | ---------- | ----------------------------------------- |
| name | `my-netns` | The name of the current network namespace |
| symbol | | Mirrors the value of option `symbol` |
| style\* | | Mirrors the value of option `style` |
### Example
```toml
# ~/.config/starship.toml
[netns]
style = 'bold yellow'
symbol = '🌐 '
```
## Nim
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). By default the module will be shown if any of the following conditions are met:
@@ -2975,6 +3082,8 @@ The `nodejs` module shows the currently installed version of [Node.js](https://n
- The current directory contains a file with the `.js`, `.mjs` or `.cjs` extension
- The current directory contains a file with the `.ts`, `.mts` or `.cts` extension
Additionally, the module will be hidden by default if the directory contains a `bunfig.toml`, `bun.lock`, or `bun.lockb` file, overriding the above conditions.
### Options
| Option | Default | Description |
@@ -3202,6 +3311,7 @@ Amazon = "🙂 "
Android = "🤖 "
Arch = "🎗️ "
Artix = "🎗️ "
Bluefin = "🐟 "
CachyOS = "🎗️ "
CentOS = "💠 "
Debian = "🌀 "
@@ -3280,6 +3390,7 @@ Arch = "Arch is the best! "
The `package` module is shown when the current directory is the repository for a package, and shows its current version. The module currently supports `npm`, `nimble`, `cargo`, `poetry`, `python`, `composer`, `gradle`, `julia`, `mix`, `helm`, `shards`, `daml` and `dart` packages.
- [**npm**](https://docs.npmjs.com/cli/commands/npm) The `npm` package version is extracted from the `package.json` present in the current directory
- [**JSR**](https://jsr.io/) The `jsr` package version is extracted from the `jsr.json`/`jsr.jsonc` or `deno.json`/`deno.jsonc` present in the current directory
- [**Cargo**](https://doc.rust-lang.org/cargo/) The `cargo` package version is extracted from the `Cargo.toml` present in the current directory
- [**Nimble**](https://github.com/nim-lang/nimble) - The `nimble` package version is extracted from the `*.nimble` file present in the current directory with the `nimble dump` command
- [**Poetry**](https://python-poetry.org/) The `poetry` package version is extracted from the `pyproject.toml` present in the current directory
@@ -3424,6 +3535,49 @@ The `pijul_channel` module shows the active channel of the repo in your current
| `truncation_symbol` | `'…'` | The symbol used to indicate a branch name was truncated. |
| `disabled` | `true` | Disables the `pijul` module. |
## Pixi
The `pixi` module shows the installed [pixi](https://pixi.sh) version as well as the activated environment, if `$PIXI_ENVIRONMENT_NAME` is set.
::: tip
This does not suppress pixi's own prompt modifier, you may want to run `pixi config set change-ps1 false`.
:::
### Options
| Option | Default | Description |
| -------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )(\($environment\) )]($style)'` | The format for the module. |
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch`. |
| `symbol` | `'🧚 '` | The symbol used before the environment name. |
| `stil` | `'yellow bold' | The style for the module. |
| `show_default_environment` | `true` | Whether to indicate that the `default` environment of your project is activated. |
| `pixi_binary` | `['pixi']` | Configures the pixi binary that Starship should execute when getting the version. |
| `detect_extensions` | `[]` | Which extensions should trigger this module. |
| `detect_files` | `['pixi.toml']` | Which filenames should trigger this module. |
| `detect_folders` | `['.pixi']` | Which folders should trigger this module. |
| `disabled` | `false` | Disables the `pixi` module. |
### Variables
| Variable | Example | Description |
| ----------- | --------- | ------------------------------------ |
| version | `v0.33.0` | The version of `pixi` |
| environment | `py311` | The current pixi environment |
| symbol | | Mirrors the value of option `symbol` |
| stil | | Mirrors the value of option `style` |
### Example
```toml
# ~/.config/starship.toml
[pixi]
format = '[$symbol$environment](yellow) '
```
## Pulumi
The `pulumi` module shows the current username, selected [Pulumi Stack](https://www.pulumi.com/docs/intro/concepts/stack/), and version.
@@ -3538,7 +3692,6 @@ 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
@@ -3546,16 +3699,16 @@ By default, the module will be shown if any of the following conditions are met:
### 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. |
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should execute 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_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. |
+3 -1
View File
@@ -229,10 +229,12 @@ Alternatif olarak aşağıdaki paket yöneticileri ile de Starship'i yükleyebil
| Alpine Linux 3.13+ | [Alpine Linux Paketleri](https://pkgs.alpinelinux.org/packages?name=starship) | `apk add starship` |
| Arch Linux | [Arch Linux Extra](https://archlinux.org/packages/extra/x86_64/starship) | `pacman -S starship` |
| CentOS 7+ | [Copr](https://copr.fedorainfracloud.org/coprs/atim/starship) | `dnf copr enable atim/starship` <br /> `dnf install starship` |
| Debian 13+ | [Debian Main](https://sources.debian.org/src/starship/1.22.1-1/) | `apt install starship` |
| Gentoo | [Gentoo Paketleri](https://packages.gentoo.org/packages/app-shells/starship) | `emerge app-shells/starship` |
| Manjaro | | `pacman -S starship` |
| NixOS | [nixpkgs](https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/misc/starship/default.nix) | `nix-env -iA nixpkgs.starship` |
| openSUSE | [OSS](https://software.opensuse.org/package/starship) | `zypper in starship` |
| Ubuntu 25.04+ | [Ubuntu Universe](https://packages.ubuntu.com/source/plucky/starship) | `apt install starship` |
| Void Linux | [Void Linux Paketleri](https://github.com/void-linux/void-packages/tree/master/srcpkgs/starship) | `xbps-install -S starship` |
</details>
@@ -345,7 +347,7 @@ mkdir ($nu.data-dir | path join "vendor/autoload")
starship init nu | save -f ($nu.data-dir | path join "vendor/autoload/starship.nu")
```
Note: Only Nushell v0.96+ is supported
Not: Nushell v0.96'tan sonraki sürümler desteklenmektedir
</details>
+6
View File
@@ -75,3 +75,9 @@ This preset is heavily inspired by [Pastel Powerline](./pastel-powerline.md), an
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.
[![Screenshot of Jetpack preset](/presets/img/jetpack.png "Click to view Jetpack preset")](./jetpack)
## [Catppuccin Powerline](./catppuccin-powerline.md)
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
[![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png "Click to view Catppuccin Powerline preset")](./catppuccin-powerline)
@@ -0,0 +1,28 @@
[Return to Presets](./README.md#catppuccin-powerline)
# Catppuccin Powerline Preset
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png)
### Ön koşullar
- A [Nerd Font](https://www.nerdfonts.com/) installed and enabled in your terminal
### Yapılandırma
```sh
starship preset catppuccin-powerline -o ~/.config/starship.toml
```
By default this preset uses the Mocha flavour of Catppucin, but you can specify any of the flavours by modifying the value of `palette`:
- `catppuccin_mocha`
- `catppuccin_frappe`
- `catppuccin_macchiato`
- `catppucin_latte`
[Click to download TOML](/presets/toml/catppuccin-powerline.toml)
<<< @/public/presets/toml/catppuccin-powerline.toml
+2 -2
View File
@@ -166,11 +166,11 @@ onMounted(() => {
::: warning
Це зміниться в майбутньому. Only Nushell v0.96+ is supported.
Це зміниться в майбутньому. Підтримується лише Nushell v0.96+.
:::
Add the following to the end of your Nushell configuration (find it by running `$nu.config-path` in Nushell):
Додайте наступний рядок наприкінці налаштувань Nushell (знайдіть її за допомоги `$nu.config-path` в Nushell):
```sh
mkdir ($nu.data-dir | path join "vendor/autoload")
+170 -17
View File
@@ -249,7 +249,7 @@ mustard = '#af8700'
```toml
format = '$all'
# Є еквівалентом до
# Which is equivalent to
format = """
$username\
$hostname\
@@ -328,6 +328,7 @@ $azure\
$nats\
$direnv\
$env_var\
$mise\
$crystal\
$custom\
$sudo\
@@ -339,6 +340,7 @@ $time\
$status\
$os\
$container\
$netns\
$shell\
$character"""
```
@@ -618,7 +620,7 @@ symbol = '🦬 '
*: Ця змінна може бути використана лише як частина стилю рядка
### Приклади
### Приклад
#### Налаштуйте формат
@@ -629,15 +631,6 @@ symbol = '🦬 '
format = 'via [🍔 $version](bold green) '
```
#### Замінити Node.js
Ви можете перевизначити параметр `detect_files` властивості [модуля nodejs](#nodejs) у вашій конфігурації, щоб показати середу виконання bun:
```toml
[nodejs]
detect_files = ['package.json', '.node-version', '!bunfig.toml', '!bun.lockb']
```
## C
Модуль `c` показує інформацію про ваш C компілятор. Стандартно модуль буде показаний, якщо поточна тека містить файли `.c` чи `.h`.
@@ -684,6 +677,53 @@ NB `версія` не має стандартного формату.
format = 'via [$name $version]($style)'
```
## CPP
The `cpp` module shows some information about your `C++` compiler. By default, the module will be shown if the current directory contains a `.cpp`, `.hpp`, or other `C++`-related files.
### Параметри
| Параметр | Стандартно | Опис |
| ------------------- | -------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| `format` | `'via [$symbol($version(-$name) )]($style)'` | Формат рядка модуля. |
| `version_format` | `'v${raw}'` | Формат версії. Доступні змінні `raw`, `major`, `minor` та `patch` |
| `symbol` | `'C++ '` | Символ, який знаходиться перед інформацією про компілятор |
| `detect_extensions` | `['cpp', 'cc', 'cxx', 'c++', 'hpp', 'hh', 'hxx', 'h++', 'tcc']` | Які розширення повинні запускати цей модуль. |
| `detect_files` | `[]` | Які імена файлів мають запускати цей модуль. |
| `detect_folders` | `[]` | В яких теках цей модуль має запускатись. |
| `commands` | `[ [ 'c++', '--version' ], [ 'g++', '--version' ], [ 'clang++', '--version' ] ]` | Як виявити компілятор |
| `style` | `'bold 149'` | Стиль модуля. |
| `disabled` | `true` | Disables the `cpp` module. |
### Змінні
| Змінна | Приклад | Опис |
| ------- | ------- | ---------------------------------------- |
| name | clang++ | Назва компілятора |
| version | 13.0.0 | Версія компілятора |
| symbol | | Віддзеркалює значення параметра `symbol` |
| style | | Віддзеркалює значення параметра `style` |
NB `версія` не має стандартного формату.
### Команди
Параметр `commands` отримує список команд для визначення версії та назви компілятора.
Each command is represented as a list of the executable name, followed by its arguments, usually something like `['mycpp', '--version']`. Starship спробує виконати кожну команду, поки не отримає результат в STDOUT.
If a C++ compiler is not supported by this module, you can request it by [raising an issue on GitHub](https://github.com/starship/starship/).
### Приклад
```toml
# ~/.config/starship.toml
[cpp]
disabled = false
format = 'via [$name $version]($style)'
```
## Character
Модуль `character` показує символ (зазвичай стрілку) поруч з текстом, який вводиться в терміналі.
@@ -874,6 +914,7 @@ format = 'underwent [$duration](bold yellow)'
| `style` | `'bold green'` | Стиль модуля. |
| `format` | `'via [$symbol$environment]($style) '` | Формат модуля. |
| `ignore_base` | `true` | Ігнорувати середовище `base`. |
| `detect_env_vars` | `["!PIXI_ENVIRONMENT_NAME"]` | Які змінні середовища повинні запускати цей модуль. If it's a pixi environment, this module is not being triggered by default. |
| `disabled` | `false` | Вимикає модуль `conda`. |
### Змінні
@@ -1876,7 +1917,7 @@ format = '[+$added]($added_style)/[-$deleted]($deleted_style) '
### Параметри
| Параметр | Стандартно | Опис |
| ------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| -------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | Стандартний формат `git_status` |
| `conflicted` | `'='` | Ця гілка конфлікт злиття. |
| `ahead` | `'⇡'` | Формат `ahead` |
@@ -1894,6 +1935,7 @@ format = '[+$added]($added_style)/[-$deleted]($deleted_style) '
| `ignore_submodules` | `false` | Ігнорувати зміни в субмодулях. |
| `disabled` | `false` | Вимикає модуль `git_status`. |
| `windows_starship` | | Використовуйте цей (Linux) шлях до виконуваного файлу у Windows для показу `git_status` у випадку шляхів Windows у WSL. |
| `use_git_executable` | `false` | Do not use `gitoxide` for computing the status, but use the `git` executable instead. |
### Змінні
@@ -2817,6 +2859,40 @@ truncation_length = 4
truncation_symbol = ''
```
## Mise
The `mise` module shows the current mise health as reported by running `mise doctor`.
### Параметри
| Параметр | Стандартно | Опис |
| ------------------ | -------------------------------- | ------------------------------------------------ |
| `symbol` | `'mise '` | The symbol used before displaying _mise_ health. |
| `style` | `'bold purple'` | Стиль модуля. |
| `format` | `'on [$symbol$health]($style) '` | Формат модуля. |
| `healthy_symbol` | `healthy` | The message displayed when _mise_ is healthy. |
| `unhealthy_symbol` | `unhealthy` | The message displayed when _mise_ is unhealthy. |
| `disabled` | `true` | Disables the `mise` module. |
### Змінні
| Змінна | Приклад | Опис |
| --------- | --------- | ---------------------------------------- |
| health | `healthy` | The health of _mise_ |
| symbol | | Віддзеркалює значення параметра `symbol` |
| style\* | | Віддзеркалює значення параметра `style` |
*: Ця змінна може бути використана лише як частина стилю рядка
### Приклад
```toml
# ~/.config/starship.toml
[mise]
health = 'ready'
```
## Mojo
Модуль `mojo` показує поточну версію встановленої мови програмування [Mojo](https://www.modular.com/mojo)
@@ -2854,7 +2930,7 @@ format = 'via [mojo ($version )($hash )]($style)'
## NATS
Модуль `nats` показує назву поточного контексту[NATS](https://nats.io).
Модуль `nats` показує назву поточного контексту [NATS](https://nats.io).
### Параметри
@@ -2881,6 +2957,37 @@ format = '[$symbol]($style)'
style = 'bold purple'
```
## Простір імен мережі
Модуль `netns` показує поточний простір імен мережі. Для отримання простору мережевих імен використовується `ip netns identify`, тому буде виявлено лише простори мережевих імен, змонтовані за адресою `/var/run/netns`.
### Параметри
| Параметр | Стандартно | Опис |
| ---------- | --------------------------------- | -------------------------------------------------------------------------- |
| `format` | `'[$symbol \[$name\]]($style)'` | Формат модуля. |
| `symbol` | `'🛜 '` | Символ, що використовується перед простором імен мережі (типово порожньо). |
| `style` | `'blue bold dimmed'` | Стиль модуля. |
| `disabled` | `false` | Вимикає модуль ` netns `. |
### Змінні
| Змінна | Приклад | Опис |
| --------- | ---------- | ---------------------------------------- |
| name | `my-netns` | Імʼя поточного простору імен мережі |
| symbol | | Віддзеркалює значення параметра `symbol` |
| style\* | | Віддзеркалює значення параметра `style` |
### Приклад
```toml
# ~/.config/starship.toml
[netns]
style = 'bold yellow'
symbol = '🌐 '
```
## Nim
Модуль `nim` показує поточну встановлену версію [Nim](https://nim-lang.org/). Типово, модуль показується, якщо виконується будь-яка з наступних умов:
@@ -2975,6 +3082,8 @@ format = 'via [☃️ $state( \($name\))](bold blue) '
- Поточна тека містить файли з розширеннями `.js`, `.mjs` або `.cjs`
- Поточна тека містить файли з розширеннями `.ts`, `.mts` чи `.cts`
Додатково, модуль буде стандартно прихованим, якщо тека містить `bunfig. oml`, `bun.lock`або `bun.lockb` файл, що замінює перелічені вище умови.
### Параметри
| Параметр | Стандартно | Опис |
@@ -3202,6 +3311,7 @@ Amazon = "🙂 "
Android = "🤖 "
Arch = "🎗️ "
Artix = "🎗️ "
Bluefin = "🐟 "
CachyOS = "🎗️ "
CentOS = "💠 "
Debian = "🌀 "
@@ -3280,6 +3390,7 @@ Arch = "Arch is the best! "
Модуль `package` показується, коли поточна тека є сховищем для пакунка, і показує його поточну версію. Наразі модуль підтримує такі пакунки: `npm`, `nimble`, `cargo`, `poetry`, `python`, `composer`, `gradle`, `julia`, `mix`, `helm`, `shards`, `daml` та `dart`.
- [**npm**](https://docs.npmjs.com/cli/commands/npm) — версія пакунка `npm` отримується з `package.json` з поточної теки
- [**JSR**](https://jsr.io/) — версія пакунка `jsr` отримана з файлів `jsr.json`/`jsr.jsonc` чи `deno.json`/`deno.jsonc` у поточній теці
- [**Cargo**](https://doc.rust-lang.org/cargo/) — версія пакунка `cargo` отримується з `Cargo.toml` з поточної теки
- [**Nimble**](https://github.com/nim-lang/nimble) — версія пакунка `nimble` з файлу `*.nimble` з поточної теки, отримана командою `nimble dump`
- [**Poetry**](https://python-poetry.org/) — версія пакунка `poetry` отримується з `pyproject.toml` з поточної теки
@@ -3424,6 +3535,49 @@ format = 'via [🔹 $version](147 bold) '
| `truncation_symbol` | `'…'` | Символ, що використовується для позначення назви гілки, яка була скорочена. |
| `disabled` | `true` | Вимикає модуль `pijul`. |
## Pixi
The `pixi` module shows the installed [pixi](https://pixi.sh) version as well as the activated environment, if `$PIXI_ENVIRONMENT_NAME` is set.
::: tip
This does not suppress pixi's own prompt modifier, you may want to run `pixi config set change-ps1 false`.
:::
### Параметри
| Параметр | Стандартно | Опис |
| -------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )(\($environment\) )]($style)'` | Формат модуля. |
| `version_format` | `'v${raw}'` | Формат версії. Доступні змінні `raw`, `major`, `minor` та `patch`. |
| `symbol` | `'🧚 '` | Символ що передує назві оточення. |
| `style` | `'yellow bold' | Стиль модуля. |
| `show_default_environment` | `true` | Whether to indicate that the `default` environment of your project is activated. |
| `pixi_binary` | `['pixi']` | Configures the pixi binary that Starship should execute when getting the version. |
| `detect_extensions` | `[]` | Які розширення повинні запускати цей модуль. |
| `detect_files` | `['pixi.toml']` | Які імена файлів мають запускати цей модуль. |
| `detect_folders` | `['.pixi']` | В яких теках цей модуль має запускатись. |
| `disabled` | `false` | Disables the `pixi` module. |
### Змінні
| Змінна | Приклад | Опис |
| ----------- | --------- | ---------------------------------------- |
| version | `v0.33.0` | The version of `pixi` |
| environment | `py311` | The current pixi environment |
| symbol | | Віддзеркалює значення параметра `symbol` |
| style | | Віддзеркалює значення параметра `style` |
### Приклад
```toml
# ~/.config/starship.toml
[pixi]
format = '[$symbol$environment](yellow) '
```
## Pulumi
Модуль `pulumi` показує імʼя поточного користувача та версію обраного [Pulumi Stack](https://www.pulumi.com/docs/intro/concepts/stack/).
@@ -3538,7 +3692,6 @@ format = 'via [$symbol$version](bold white)'
- Поточна тека містить файл `requirements.txt`
- Поточна тека містить файл `setup.py`
- Поточна тека містить файл `tox.ini`
- Поточна тека містить файл `pixi.toml`
- Поточна тека містить файл `.py`.
- Поточна тека містить файли з розширенням `.ipynb`.
- Віртуальне середовище активовано
@@ -3546,16 +3699,16 @@ format = 'via [$symbol$version](bold white)'
### Параметри
| Параметр | Стандартно | Опис |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| -------------------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------- |
| `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 буде використовувати для отримання версії. |
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should execute 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_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini']` | Назви файлів, які активують модуль |
| `detect_folders` | `[]` | Назви тек, що активують модуль |
| `disabled` | `false` | Вимикає модуль `python`. |
+4 -2
View File
@@ -229,10 +229,12 @@ curl -sS https://starship.rs/install.sh | sh
| Alpine Linux 3.13+ | [Alpine Linux Packages](https://pkgs.alpinelinux.org/packages?name=starship) | `apk add starship` |
| Arch Linux | [Arch Linux Extra](https://archlinux.org/packages/extra/x86_64/starship) | `pacman -S starship` |
| CentOS 7+ | [Copr](https://copr.fedorainfracloud.org/coprs/atim/starship) | `dnf copr enable atim/starship` <br /> `dnf install starship` |
| Debian 13+ | [Debian Main](https://sources.debian.org/src/starship/1.22.1-1/) | `apt install starship` |
| Gentoo | [Gentoo Packages](https://packages.gentoo.org/packages/app-shells/starship) | `emerge app-shells/starship` |
| Manjaro | | `pacman -S starship` |
| NixOS | [nixpkgs](https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/misc/starship/default.nix) | `nix-env -iA nixpkgs.starship` |
| openSUSE | [OSS](https://software.opensuse.org/package/starship) | `zypper in starship` |
| Ubuntu 25.04+ | [Ubuntu Universe](https://packages.ubuntu.com/source/plucky/starship) | `apt install starship` |
| Void Linux | [Void Linux Packages](https://github.com/void-linux/void-packages/tree/master/srcpkgs/starship) | `xbps-install -S starship` |
</details>
@@ -338,14 +340,14 @@ eval $(starship init ion)
<details>
<summary>Nushell</summary>
Add the following to the end of your Nushell configuration (find it by running `$nu.config-path` in Nushell):
Додайте наступний рядок наприкінці налаштувань Nushell (знайдіть її за допомоги `$nu.config-path` в Nushell):
```sh
mkdir ($nu.data-dir | path join "vendor/autoload")
starship init nu | save -f ($nu.data-dir | path join "vendor/autoload/starship.nu")
```
Note: Only Nushell v0.96+ is supported
Примітка: Підтримується лише Nushell v0.96+
</details>
+6
View File
@@ -75,3 +75,9 @@
Цей псевдомінімалістичний шаблон створений під враженням від [geometry](https://github.com/geometry-zsh/geometry) та [spaceship](https://github.com/spaceship-prompt/spaceship-prompt).
[![Скріншот шаблона Jetpack](/presets/img/jetpack.png "Натисніть для перегляду шаблона Jetpack")](./jetpack)
## [Catppuccin Powerline](./catppuccin-powerline.md)
Цей шаблон є трохи зміненою версією [Gruvbox Rainbow](./gruvbox-rainbow.md), що використовує палітру [Catppuccin](https://github.com/catppuccin/catppuccin).
[![Скріншот шаблона Catppuccin Powerline](/presets/img/catppuccin-powerline.png "Натисніть, щоб переглянути шаблон Catppucin Powerline")](./catppuccin-powerline)
@@ -0,0 +1,28 @@
[Повернутися до Шаблонів](./README.md#catppuccin-powerline)
# Catppuccin Powerline
Цей шаблон є трохи зміненою версією [Gruvbox Rainbow](./gruvbox-rainbow.md), що використовує палітру [Catppuccin](https://github.com/catppuccin/catppuccin).
![Знімок екрана Catppuccin Powerline](/presets/img/catppuccin-powerline.png)
### Передумови
- Встановлено та активовано [Nerd Font](https://www.nerdfonts.com/) у вашому терміналі
### Налаштування
```sh
starship preset catppuccin-powerline -o ~/.config/starship.toml
```
Стандартно цей шаблон використовує стиль Мокко від Catppucin, але ви можете вказати будь-який інший стиль, змінивши значення параметра `palette`:
- `catppuccin_mocha`
- `catppuccin_frappe`
- `catppuccin_macchiato`
- `catppucin_latte`
[Натисніть, щоб завантажити TOML](/presets/toml/catppuccin-powerline.toml)
<<< @/public/presets/toml/catppuccin-powerline.toml
+1 -1
View File
@@ -166,7 +166,7 @@ onMounted(() => {
::: warning
Điều này có thể thay đổi trong tương lai. Only Nushell v0.96+ is supported.
Điều này có thể thay đổi trong tương lai. Chỉ hỗ trợ nushell từ phiên bản 0.96 trở lên.
:::
+174 -21
View File
@@ -328,6 +328,7 @@ $azure\
$nats\
$direnv\
$env_var\
$mise\
$crystal\
$custom\
$sudo\
@@ -339,6 +340,7 @@ $time\
$status\
$os\
$container\
$netns\
$shell\
$character"""
```
@@ -618,7 +620,7 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
*: Biến này có thể chỉ được sử dụng như một phần của style string
### Các ví dụ
### Ví dụ
#### Customize the format
@@ -629,15 +631,6 @@ The `bun` module shows the currently installed version of the [bun](https://bun.
format = 'via [🍔 $version](bold green) '
```
#### Replace Node.js
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']
```
## C
The `c` module shows some information about your C compiler. By default the module will be shown if the current directory contains a `.c` or `.h` file.
@@ -684,6 +677,53 @@ If a C compiler is not supported by this module, you can request it by [raising
format = 'via [$name $version]($style)'
```
## CPP
The `cpp` module shows some information about your `C++` compiler. By default, the module will be shown if the current directory contains a `.cpp`, `.hpp`, or other `C++`-related files.
### Options
| Tuỳ chọn | Mặc định | Mô tả |
| ------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version(-$name) )]($style)'` | The format string for the module. |
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` |
| `symbol` | `'C++ '` | The symbol used before displaying the compiler details |
| `detect_extensions` | `['cpp', 'cc', 'cxx', 'c++', 'hpp', 'hh', 'hxx', 'h++', 'tcc']` | 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. |
| `commands` | `[ [ 'c++', '--version' ], [ 'g++', '--version' ], [ 'clang++', '--version' ] ]` | How to detect what the compiler is |
| `style` | `'bold 149'` | Kiểu cho module. |
| `disabled` | `true` | Disables the `cpp` module. |
### Các biến
| Biến | Ví dụ | Mô tả |
| ------- | ------- | -------------------------------- |
| name | clang++ | The name of the compiler |
| version | 13.0.0 | The version of the compiler |
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style | | Giá trị ghi đè của `style` |
NB that `version` is not in the default format.
### Commands
The `commands` option accepts a list of commands to determine the compiler version and name.
Each command is represented as a list of the executable name, followed by its arguments, usually something like `['mycpp', '--version']`. Starship will try executing each command until it gets a result on STDOUT.
If a C++ compiler is not supported by this module, you can request it by [raising an issue on GitHub](https://github.com/starship/starship/).
### Ví dụ
```toml
# ~/.config/starship.toml
[cpp]
disabled = false
format = 'via [$name $version]($style)'
```
## Character
Module `character` cho biết một kí tự (thường là một mũi tên) bên cạnh nơi văn bản được nhập trong terminal của bạn.
@@ -758,7 +798,7 @@ The `cmake` module shows the currently installed version of [CMake](https://cmak
- Đường dẫn hiện tại chứa một tập tin `CmakeLists.txt`
- Đường dẫn hiện tại chứa một tập tin `CMakeCache.txt`
### Options
### Các tuỳ chọn
| Tuỳ chọn | Mặc định | Mô tả |
| ------------------- | -------------------------------------- | ------------------------------------------------------------------------- |
@@ -788,7 +828,7 @@ The `cobol` module shows the currently installed version of COBOL. By default, t
- The current directory contains any files ending in `.cob` or `.COB`
- The current directory contains any files ending in `.cbl` or `.CBL`
### Các tuỳ chọn
### Options
| Tuỳ chọn | Mặc định | Mô tả |
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
@@ -874,6 +914,7 @@ Cái này không loại bỏ conda's prompt mà nó sở hữu, bạn có thể
| `style` | `'bold green'` | Kiểu cho module. |
| `format` | `'via [$symbol$environment]($style) '` | Định dạng cho module. |
| `ignore_base` | `true` | Bỏ qua biến môi trường `base` khi đã kích hoạt. |
| `detect_env_vars` | `["!PIXI_ENVIRONMENT_NAME"]` | Which environment variable(s) should trigger this module. If it's a pixi environment, this module is not being triggered by default. |
| `disabled` | `false` | Vô hiệu module `conda`. |
### Các biến
@@ -1456,7 +1497,7 @@ The `erlang` module shows the currently installed version of [Erlang/OTP](https:
- Thư mục hiện tại chứa một tập tin `rebar.config`.
- Thư mục hiện tại chứa một tập tin `erlang.mk`.
### Options
### Các tuỳ chọn
| Tuỳ chọn | Mặc định | Mô tả |
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
@@ -1494,7 +1535,7 @@ The `fennel` module shows the currently installed version of [Fennel](https://fe
- The current directory contains a file with the `.fnl` extension
### Các tuỳ chọn
### Options
| Tuỳ chọn | Mặc định | Mô tả |
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- |
@@ -1831,7 +1872,7 @@ Mặc định, mô đun này được vô hiệu. Để kích hoạt nó, thiế
:::
### Options
### Các tuỳ chọn
| Tuỳ chọn | Mặc định | Mô tả |
| -------------------- | ------------------------------------------------------------ | ------------------------------------- |
@@ -1876,7 +1917,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
### Các tuỳ chọn
| Tuỳ chọn | Mặc định | Mô tả |
| ------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| -------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | Định dạng mặc định cho `git_status` |
| `conflicted` | `'='` | Nhánh này có nhiều merge conflicts. |
| `ahead` | `'⇡'` | Định dạng của `ahead` |
@@ -1894,6 +1935,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
| `ignore_submodules` | `false` | Ignore changes to submodules. |
| `disabled` | `false` | Vô hiệu `git_status` module. |
| `windows_starship` | | Use this (Linux) path to a Windows Starship executable to render `git_status` when on Windows paths in WSL. |
| `use_git_executable` | `false` | Do not use `gitoxide` for computing the status, but use the `git` executable instead. |
### Các biến
@@ -1971,7 +2013,7 @@ windows_starship = '/mnt/c/Users/username/scoop/apps/starship/current/starship.e
The `gleam` module shows the currently installed version of [Gleam](https://gleam.run/). 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 `gleam.toml` file
- Thư mục hiện tại chứa một tập tin `gleam.toml`
- The current directory contains a file with the `.gleam` extension
### Các tuỳ chọn
@@ -2817,6 +2859,40 @@ truncation_length = 4
truncation_symbol = ''
```
## Mise
The `mise` module shows the current mise health as reported by running `mise doctor`.
### Các tuỳ chọn
| Tuỳ chọn | Mặc định | Mô tả |
| ------------------ | -------------------------------- | ------------------------------------------------ |
| `symbol` | `'mise '` | The symbol used before displaying _mise_ health. |
| `style` | `'bold purple'` | Kiểu cho module. |
| `format` | `'on [$symbol$health]($style) '` | Định dạng cho module. |
| `healthy_symbol` | `healthy` | The message displayed when _mise_ is healthy. |
| `unhealthy_symbol` | `unhealthy` | The message displayed when _mise_ is unhealthy. |
| `disabled` | `true` | Disables the `mise` module. |
### Các biến
| Biến | Ví dụ | Mô tả |
| --------- | --------- | -------------------------------- |
| health | `healthy` | The health of _mise_ |
| 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
[mise]
health = 'ready'
```
## Mojo
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
@@ -2881,6 +2957,37 @@ format = '[$symbol]($style)'
style = 'bold purple'
```
## Network Namespace
The `netns` module shows the current network namespace. This uses `ip netns identify` to get the network namespace, so only network namespaces mounted at `/var/run/netns` will be detected.
### Các tuỳ chọn
| Tuỳ chọn | Mặc định | Mô tả |
| ---------- | --------------------------------- | ----------------------------------------------------------------- |
| `format` | `'[$symbol \[$name\]]($style)'` | Định dạng cho module. |
| `symbol` | `'🛜 '` | The symbol used before the network namespace (defaults to empty). |
| `style` | `'blue bold dimmed'` | Kiểu cho module. |
| `disabled` | `false` | Disables the `netns` module. |
### Các biến
| Biến | Ví dụ | Mô tả |
| --------- | ---------- | ----------------------------------------- |
| name | `my-netns` | The name of the current network namespace |
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` |
### Ví dụ
```toml
# ~/.config/starship.toml
[netns]
style = 'bold yellow'
symbol = '🌐 '
```
## Nim
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). 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:
@@ -2975,6 +3082,8 @@ The `nodejs` module shows the currently installed version of [Node.js](https://n
- The current directory contains a file with the `.js`, `.mjs` or `.cjs` extension
- The current directory contains a file with the `.ts`, `.mts` or `.cts` extension
Additionally, the module will be hidden by default if the directory contains a `bunfig.toml`, `bun.lock`, or `bun.lockb` file, overriding the above conditions.
### Các tuỳ chọn
| Tuỳ chọn | Mặc định | Mô tả |
@@ -3202,6 +3311,7 @@ Amazon = "🙂 "
Android = "🤖 "
Arch = "🎗️ "
Artix = "🎗️ "
Bluefin = "🐟 "
CachyOS = "🎗️ "
CentOS = "💠 "
Debian = "🌀 "
@@ -3280,6 +3390,7 @@ Arch = "Arch is the best! "
The `package` module is shown when the current directory is the repository for a package, and shows its current version. The module currently supports `npm`, `nimble`, `cargo`, `poetry`, `python`, `composer`, `gradle`, `julia`, `mix`, `helm`, `shards`, `daml` and `dart` packages.
- [**npm**](https://docs.npmjs.com/cli/commands/npm) The `npm` package version is extracted from the `package.json` present in the current directory
- [**JSR**](https://jsr.io/) The `jsr` package version is extracted from the `jsr.json`/`jsr.jsonc` or `deno.json`/`deno.jsonc` present in the current directory
- [**Cargo**](https://doc.rust-lang.org/cargo/) The `cargo` package version is extracted from the `Cargo.toml` present in the current directory
- [**Nimble**](https://github.com/nim-lang/nimble) - The `nimble` package version is extracted from the `*.nimble` file present in the current directory with the `nimble dump` command
- [**Poetry**](https://python-poetry.org/) The `poetry` package version is extracted from the `pyproject.toml` present in the current directory
@@ -3424,6 +3535,49 @@ The `pijul_channel` module shows the active channel of the repo in your current
| `truncation_symbol` | `'…'` | Biểu tượng sử dụng để nhận biết một tên nhánh được rút gọn. |
| `disabled` | `true` | Disables the `pijul` module. |
## Pixi
The `pixi` module shows the installed [pixi](https://pixi.sh) version as well as the activated environment, if `$PIXI_ENVIRONMENT_NAME` is set.
::: tip
This does not suppress pixi's own prompt modifier, you may want to run `pixi config set change-ps1 false`.
:::
### Các tuỳ chọn
| Tuỳ chọn | Mặc định | Mô tả |
| -------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )(\($environment\) )]($style)'` | Định dạng cho module. |
| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch`. |
| `symbol` | `'🧚 '` | Kí hiệu sử dụng trước tên biến môi trường. |
| `style` | `'yellow bold' | Kiểu cho module. |
| `show_default_environment` | `true` | Whether to indicate that the `default` environment of your project is activated. |
| `pixi_binary` | `['pixi']` | Configures the pixi binary that Starship should execute when getting the version. |
| `detect_extensions` | `[]` | Những tiện ích mở rộng nào sẽ kích hoạt mô-đun này. |
| `detect_files` | `['pixi.toml']` | Những tên tệp nào sẽ kích hoạt mô-đun này. |
| `detect_folders` | `['.pixi']` | Những thư mục nào sẽ kích hoạt mô-đun này. |
| `disabled` | `false` | Disables the `pixi` module. |
### Các biến
| Biến | Ví dụ | Mô tả |
| ----------- | --------- | -------------------------------- |
| version | `v0.33.0` | The version of `pixi` |
| environment | `py311` | The current pixi environment |
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style | | Giá trị ghi đè của `style` |
### Ví dụ
```toml
# ~/.config/starship.toml
[pixi]
format = '[$symbol$environment](yellow) '
```
## Pulumi
The `pulumi` module shows the current username, selected [Pulumi Stack](https://www.pulumi.com/docs/intro/concepts/stack/), and version.
@@ -3538,7 +3692,6 @@ 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
@@ -3546,16 +3699,16 @@ By default, the module will be shown if any of the following conditions are met:
### 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. |
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should execute 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_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. |
+4 -2
View File
@@ -229,10 +229,12 @@ Hoặc là, cài đặt Starship bằng một package manager bất kì:
| Alpine Linux 3.13+ | [Alpine Linux Packages](https://pkgs.alpinelinux.org/packages?name=starship) | `apk add starship` |
| Arch Linux | [Arch Linux Extra](https://archlinux.org/packages/extra/x86_64/starship) | `pacman -S starship` |
| CentOS 7+ | [Copr](https://copr.fedorainfracloud.org/coprs/atim/starship) | `dnf copr enable atim/starship` <br /> `dnf install starship` |
| Debian 13+ | [Debian Main](https://sources.debian.org/src/starship/1.22.1-1/) | `apt install starship` |
| Gentoo | [Gentoo Packages](https://packages.gentoo.org/packages/app-shells/starship) | `emerge app-shells/starship` |
| Manjaro | | `pacman -S starship` |
| NixOS | [nixpkgs](https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/misc/starship/default.nix) | `nix-env -iA nixpkgs.starship` |
| openSUSE | [OSS](https://software.opensuse.org/package/starship) | `zypper in starship` |
| Ubuntu 25.04+ | [Ubuntu Universe](https://packages.ubuntu.com/source/plucky/starship) | `apt install starship` |
| Void Linux | [Void Linux Packages](https://github.com/void-linux/void-packages/tree/master/srcpkgs/starship) | `xbps-install -S starship` |
</details>
@@ -345,7 +347,7 @@ mkdir ($nu.data-dir | path join "vendor/autoload")
starship init nu | save -f ($nu.data-dir | path join "vendor/autoload/starship.nu")
```
Note: Only Nushell v0.96+ is supported
Lưu ý: Chỉ hỗ trợ Nushell v0.96+
</details>
@@ -434,7 +436,7 @@ 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.
Chương trình này sẽ không chuyển bất kỳ thông tin nào sang các hệ thống mạng khác trừ khi có yêu cầu cụ thể của người dùng hoặc người cài đặt hoặc vận hành chương trình.
<p align="center">
<br>
+6
View File
@@ -75,3 +75,9 @@ This preset is heavily inspired by [Pastel Powerline](./pastel-powerline.md), an
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.
[![Screenshot of Jetpack preset](/presets/img/jetpack.png "Click to view Jetpack preset")](./jetpack)
## [Catppuccin Powerline](./catppuccin-powerline.md)
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
[![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png "Click to view Catppuccin Powerline preset")](./catppuccin-powerline)
@@ -0,0 +1,28 @@
[Return to Presets](./README.md#catppuccin-powerline)
# Catppuccin Powerline Preset
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png)
### Yêu cầu
- A [Nerd Font](https://www.nerdfonts.com/) installed and enabled in your terminal
### Cấu hình
```sh
starship preset catppuccin-powerline -o ~/.config/starship.toml
```
By default this preset uses the Mocha flavour of Catppucin, but you can specify any of the flavours by modifying the value of `palette`:
- `catppuccin_mocha`
- `catppuccin_frappe`
- `catppuccin_macchiato`
- `catppucin_latte`
[Click to download TOML](/presets/toml/catppuccin-powerline.toml)
<<< @/public/presets/toml/catppuccin-powerline.toml
+2 -2
View File
@@ -166,11 +166,11 @@ onMounted(() => {
::: warning
这部分今后可能会改变。 Only Nushell v0.96+ is supported.
这部分今后可能会改变。 仅支持 Nushell v0.96+
:::
Add the following to the end of your Nushell configuration (find it by running `$nu.config-path` in Nushell):
将以下内容添加到你的 Nushell 配置文件的末尾(在 Nushell 中运行 `$nu.config-path` 可以找到该文件)
```sh
mkdir ($nu.data-dir | path join "vendor/autoload")
+274 -121
View File
@@ -128,9 +128,9 @@ line2
"""
```
### 式字符串
### 式字符串
组件将根据式字符串输出其中字段。 大多数组件可以通过 `format` 项来配置它的显示格式。 格式设定内可以包含文本、字段以及文本组。
组件将根据式字符串输出其中字段。 大多数组件可以通过 `format` 项来配置它的显示格式。 格式设定内可以包含文本、字段以及文本组。
#### 字段
@@ -138,17 +138,17 @@ line2
例如:
- 式字符串 `'$version'` 仅包含字段 `version`
- 式字符串 `'$git_branch$git_commit'` 包含两个字段,`git_branch``git_commit`
- 式字符串 `'$git_branch $git_commit'` 包含两个空格分隔的字段
- 式字符串 `'$version'` 仅包含字段 `version`
- 式字符串 `'$git_branch$git_commit'` 包含两个字段,`git_branch``git_commit`
- 式字符串 `'$git_branch $git_commit'` 包含两个字段,以一个空格分隔。
#### 文本组
文本由以下两种括号来进行分组:
一个文本组以两个括号部分组
第一`[]`括号中的内容是[格式字符串](#format-strings) 你可以在当中添加文本,变量甚至嵌套其他括号
第一个部分包含在 `[]` 中,内容是一个[格式字符串](#format-strings) 你可以在当中添加文本、字段,甚至嵌套其他文本组
第二`()`括号中的内容是[样式字符串](#style-strings) 用于指定第一括号中内容的样式。
第二个部分包含在 `()`中,内容是一个[样式字符串](#style-strings) 用于指定第一部分括号中内容的样式。
例如:
@@ -167,25 +167,25 @@ Starship 中的大多数组件允许您为其设置显示样式。 显示样式
- `'bold italic fg:purple'` 设置粗体、斜体、紫色文本
- `''` 显式禁用所有样式
请注意,最终显示样式将由您的终端模拟器控制。 例如,有的终端模拟器对于“bold”属性的文本是加亮颜色而不是加粗文字,有的颜色主题对“普通”和“明亮”两种属性的颜色使用相同的颜色值。 此外,要获得意大利体文本(一般设计为斜体),您的终端必须支持意大利体显示
请注意,最终显示样式将由您的终端模拟器控制。 例如,有的终端模拟器对于“bold”属性的文本是加亮颜色而不是加粗文字,有的颜色主题对“普通”和“明亮”两种属性的颜色使用相同的颜色值。 此外,要显示斜体文本,也需要您的终端的支持
#### 条件格式设定
#### 条件格式字符串
在格式设定里,`(``)` 包裹的内容是条件格式设定:若其包含的字段为空则不会渲染。
`(``)` 包裹的内容是条件格式字符串: 当其中包含的字段全部为空时,该字符串不会渲染。
例如:
- `'(@$region)'` will show nothing if the variable `region` is `None` or empty string, otherwise `@` followed by the value of region.
- `'(some text)'` will always show nothing since there are no variables wrapped in the braces.
- When `$combined` is a shortcut for `\[$a$b\]`, `'($combined)'` will show nothing only if `$a` and `$b` are both `None`. This works the same as `'(\[$a$b\] )'`.
- `'(@$region)'`:如果字段 `region` `None` 或空字符串,什么都不显示;否则显示 `@` region 字段的值。
- `'(some text)'`:永远不会显示,因为括号里没有任何字段。
- 如果 `$combined` `\[$a$b\]` 的简写,则 `'($combined)'` 当切仅当 `$a` `$b` 都为 `None` 时什么都不显示。 这和 `'(\[$a$b\] )'` 的效果相同。
### 错误匹配
### 反向匹配
许多组件都有 `detect_extensions``detect_files``detect_folders` 变量。 These take lists of strings to match or not match. "Negative" options, those which should not be matched, are indicated with a leading '!' character. The presence of _any_ negative indicator in the directory will result in the module not being matched.
许多组件都有 `detect_extensions``detect_files``detect_folders` 变量。 这些变量接受用于匹配或不匹配的字符串。 反向匹配指用于指定不匹配的字符串,以字符 '!' 开头。 目录中出现反向匹配的_任何_文件会导致组件不被匹配。
Extensions are matched against both the characters after the last dot in a filename, and the characters after the first dot in a filename. For example, `foo.bar.tar.gz` will be matched against `bar.tar.gz` and `gz` in the `detect_extensions` variable. Files whose name begins with a dot are not considered to have extensions at all.
对于文件扩展名,文件名中第一个点后的内容和最后一个点后的内容会被分别匹配一次。 例如,`foo.bar.tar.gz``detect_extensions` 字段中既会匹配 `bar.tar.gz`,也会匹配 `gz`。 文件名以点开头的文件则被视为没有扩展名。
To see how this works in practice, you could match TypeScript but not MPEG Transport Stream files thus:
实践中的例子,你可以这样来匹配 TypeScript,同时排除 MPEG 传输流文件:
```toml
detect_extensions = ['ts', '!video.ts', '!audio.ts']
@@ -202,11 +202,11 @@ detect_extensions = ['ts', '!video.ts', '!audio.ts']
| `format` | [见下文](#default-prompt-format) | 配置提示符的格式。 |
| `right_format` | `''` | 参见[启用右侧提示](../advanced-config/#enable-right-prompt) |
| `scan_timeout` | `30` | Starship 扫描文件的超时时间(单位:毫秒)。 |
| `command_timeout` | `500` | Startship 执行命令的超时时间(单位:毫秒)。 |
| `command_timeout` | `500` | Starship 执行命令的超时时间(单位:毫秒)。 |
| `add_newline` | `true` | 在 shell 提示符之间插入空行。 |
| `palette` | `''` | Sets which color palette from `palettes` to use. |
| `palettes` | `{}` | Collection of color palettes that assign [colors](../advanced-config/#style-strings) to user-defined names. Note that color palettes cannot reference their own color definitions. |
| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. |
| `follow_symlinks` | `true` | 跟随系统链接检查他们是否是一个路径。在诸如 Git 等组件中使用。 |
::: tip 提示
@@ -249,7 +249,7 @@ mustard = '#af8700'
```toml
format = '$all'
# 相当于
# Which is equivalent to
format = """
$username\
$hostname\
@@ -328,6 +328,7 @@ $azure\
$nats\
$direnv\
$env_var\
$mise\
$crystal\
$custom\
$sudo\
@@ -339,11 +340,12 @@ $time\
$status\
$os\
$container\
$netns\
$shell\
$character"""
```
如果你只是想扩展默认的格式,你可以使用 `$all`; 你另外添加到格式中的组件不会重复出现。 例如:
如果你只是想扩展默认的格式,你可以使用 `$all`你另外添加到格式中的组件不会重复出现。 例如:
```toml
# Move the directory to the second line
@@ -393,7 +395,7 @@ When using [aws-sso-cli](https://github.com/synfinatic/aws-sso-cli) the profile
### 示例
#### Display everything
#### 显示所有内容
```toml
# ~/.config/starship.toml
@@ -593,15 +595,15 @@ symbol = '🦬 '
- 当前目录包含 `bun.lock` 文件
- 当前目录包含一个 `bun.lockb` 文件
- 当前目录包含一个 `bunfig.toml` 文件
- 当前目录包含 `bunfig.toml` 文件
### 配置项
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------------ | ------------------------------------------- |
| ------------------- | ------------------------------------------ | ---------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `symbol` | `'🥟 '` | 用于表示Bun的格式化字符串 |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'🥟 '` | 用于表示 Bun 的格式化字符串 |
| `detect_extensions` | `[]` | 触发此组件的扩展名 |
| `detect_files` | `['bun.lock', 'bun.lockb', 'bunfig.toml']` | 触发此组件的文件名 |
| `detect_folders` | `[]` | 触发此组件的文件夹 |
@@ -629,15 +631,6 @@ symbol = '🦬 '
format = 'via [🍔 $version](bold green) '
```
#### 替换 Node.js
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']
```
## C
The `c` module shows some information about your C compiler. By default the module will be shown if the current directory contains a `.c` or `.h` file.
@@ -647,7 +640,7 @@ The `c` module shows some information about your C compiler. By default the modu
| 选项 | 默认值 | 描述 |
| ------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------ |
| `format` | `'via [$symbol($version(-$name) )]($style)'` | The format string for the module. |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'C '` | The symbol used before displaying the compiler details |
| `detect_extensions` | `['c', 'h']` | 触发此组件的扩展名 |
| `detect_files` | `[]` | 触发此组件的文件名 |
@@ -684,20 +677,67 @@ If a C compiler is not supported by this module, you can request it by [raising
format = 'via [$name $version]($style)'
```
## CPP
The `cpp` module shows some information about your `C++` compiler. By default, the module will be shown if the current directory contains a `.cpp`, `.hpp`, or other `C++`-related files.
### 配置项
| 选项 | 默认值 | 描述 |
| ------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------ |
| `format` | `'via [$symbol($version(-$name) )]($style)'` | The format string for the module. |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段有 `raw`, `major`, `minor``patch` |
| `symbol` | `'C++ '` | The symbol used before displaying the compiler details |
| `detect_extensions` | `['cpp', 'cc', 'cxx', 'c++', 'hpp', 'hh', 'hxx', 'h++', 'tcc']` | 触发此组件的扩展名 |
| `detect_files` | `[]` | 触发此组件的文件名 |
| `detect_folders` | `[]` | 触发此组件的文件夹 |
| `commands` | `[ [ 'c++', '--version' ], [ 'g++', '--version' ], [ 'clang++', '--version' ] ]` | How to detect what the compiler is |
| `style` | `'bold 149'` | 此组件的样式。 |
| `disabled` | `true` | Disables the `cpp` module. |
### 变量
| 字段 | 示例 | 描述 |
| ------- | ------- | ----------- |
| name | clang++ | 编译器的名称 |
| version | 13.0.0 | 编译器的版本 |
| symbol | | `symbol`对应值 |
| style | | `style`对应值 |
NB that `version` is not in the default format.
### Commands
The `commands` option accepts a list of commands to determine the compiler version and name.
Each command is represented as a list of the executable name, followed by its arguments, usually something like `['mycpp', '--version']`. Starship will try executing each command until it gets a result on STDOUT.
If a C++ compiler is not supported by this module, you can request it by [raising an issue on GitHub](https://github.com/starship/starship/).
### 示例
```toml
# ~/.config/starship.toml
[cpp]
disabled = false
format = 'via [$name $version]($style)'
```
## 字符
`character` 组件用于在您输入终端的文本旁显示一个字符(通常是一个箭头)。
这个字符可以告诉您最后一个命令是否执行成功。 It can do this in two ways:
这个字符可以告诉您一个命令是否执行成功。 有两种方式:
- changing color (`red`/`green`)
- changing shape (``/`✖`)
- 更换颜色(`red`/`green`
- 更换字符(``/`✖`
By default it only changes color. If you also want to change its shape take a look at [this example](#with-custom-error-shape).
默认情况下只会更改颜色。 如果您也想更换字符,请查看 [此示例](#with-custom-error-shape)
::: warning 警告
`vimcmd_symbol` is only supported in cmd, fish and zsh. `vimcmd_replace_one_symbol`, `vimcmd_replace_symbol`, and `vimcmd_visual_symbol` are only supported in fish due to [upstream issues with mode detection in zsh](https://github.com/starship/starship/issues/625#issuecomment-732454148).
`vimcmd_symbol` 仅在 cmdfish zsh 中支持。 `vimcmd_replace_one_symbol``vimcmd_replace_symbol` `vimcmd_visual_symbol` 由于[一个 zsh 模式检测的上游 issue](https://github.com/starship/starship/issues/625#issuecomment-732454148) 仅在 fish 中支持。
:::
@@ -705,9 +745,9 @@ By default it only changes color. If you also want to change its shape take a lo
| 选项 | 默认值 | 描述 |
| --------------------------- | -------------------- | --------------------------------------------------------------------------------------- |
| `format` | `'$symbol '` | The format string used before the text input. |
| `success_symbol` | `'[](bold green)'` | The format string used before the text input if the previous command succeeded. |
| `error_symbol` | `'[](bold red)'` | The format string used before the text input if the previous command failed. |
| `format` | `'$symbol '` | 用在输入文本之前的格式字符串。 |
| `success_symbol` | `'[](bold green)'` | 当前一条命令执行成功时,用在输入文本之前的格式字符串。 |
| `error_symbol` | `'[](bold red)'` | 当前一条命令执行失败时,用在输入文本之前的格式字符串。 |
| `vimcmd_symbol` | `'[](bold green)'` | The format string used before the text input if the shell is in vim normal mode. |
| `vimcmd_replace_one_symbol` | `'[](bold purple)'` | The format string used before the text input if the shell is in vim `replace_one` mode. |
| `vimcmd_replace_symbol` | `'[](bold purple)'` | The format string used before the text input if the shell is in vim replace mode. |
@@ -761,9 +801,9 @@ vimcmd_symbol = '[V](bold green) '
### 配置项
| 选项 | 默认值 | 描述 |
| ------------------- | -------------------------------------- | -------------------------------------------- |
| ------------------- | -------------------------------------- | --------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'△ '` | The symbol used before the version of cmake. |
| `detect_extensions` | `[]` | Which extensions should trigger this module |
| `detect_files` | `['CMakeLists.txt', 'CMakeCache.txt']` | Which filenames should trigger this module |
@@ -794,7 +834,7 @@ The `cobol` module shows the currently installed version of COBOL. By default, t
| ------------------- | ------------------------------------ | ------------------------------------------------------- |
| `symbol` | `'⚙️ '` | The symbol used before displaying the version of COBOL. |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `style` | `'bold blue'` | 此组件的样式。 |
| `detect_extensions` | `['cbl', 'cob', 'CBL', 'COB']` | 触发此组件的扩展名 |
| `detect_files` | `[]` | 触发此组件的文件名 |
@@ -811,9 +851,9 @@ The `cobol` module shows the currently installed version of COBOL. By default, t
*: 此变量只能作为样式字符串的一部分使用
## Command Duration
## Command Duration 命令执行时长
`cmd_duration` 组件显示上一个命令执行的时。 此组件只在命令执行时间长于两秒时显示,或者当其 `min_time` 字段被设置时,按此值为执行时间的显示下限。
`cmd_duration` 组件显示上一个命令执行的时。 此组件只在命令执行时间长于两秒时显示,或者当其 `min_time` 字段被设置时,按此值为执行时间的显示下限。
::: warning 不要在 Bash 里捕获 DEBUG 信号
@@ -832,8 +872,8 @@ The `cobol` module shows the currently installed version of COBOL. By default, t
| `format` | `'took [$duration]($style) '` | 组件格式化模板。 |
| `style` | `'bold yellow'` | 此组件的样式。 |
| `disabled` | `false` | 禁用 `cmd_duration` 组件。 |
| `show_notifications` | `false` | Show desktop notifications when command completes. |
| `min_time_to_notify` | `45_000` | Shortest duration for notification (in milliseconds). |
| `show_notifications` | `false` | 当命令完成时显示桌面通知。 |
| `min_time_to_notify` | `45_000` | 要显示通知的最短执行时长(单位:毫秒)。 |
| `notification_timeout` | | Duration to show notification for (in milliseconds). If unset, notification timeout will be determined by daemon. Not all notification daemons honor this option. |
### 变量
@@ -868,12 +908,13 @@ The `conda` module shows the current [Conda](https://docs.conda.io/en/latest/) e
### 配置项
| 选项 | 默认值 | 描述 |
| ------------------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| ------------------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `truncation_length` | `1` | 如果这个 conda 环境是通过 `conda create -p [path]` 创建的,环境路径的目录深度应该被截断到此数量。 `0` 表示不用截断。 另请参阅 [`directory`](#directory) 组件。 |
| `symbol` | `'🅒 '` | 在环境名之前显示的符号。 |
| `style` | `'bold green'` | 此组件的样式。 |
| `format` | `'via [$symbol$environment]($style) '` | 组件格式化模板。 |
| `ignore_base` | `true` | 激活时忽略 `base` 环境。 |
| `detect_env_vars` | `["!PIXI_ENVIRONMENT_NAME"]` | Which environment variable(s) should trigger this module. If it's a pixi environment, this module is not being triggered by default. |
| `disabled` | `false` | 禁用 `conda` 组件。 |
### 变量
@@ -940,7 +981,7 @@ The `crystal` module shows the currently installed version of [Crystal](https://
| ------------------- | ------------------------------------ | --------------------------------------------------------- |
| `symbol` | `'🔮 '` | The symbol used before displaying the version of crystal. |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `style` | `'bold red'` | 此组件的样式。 |
| `detect_extensions` | `['cr']` | 触发此组件的扩展名 |
| `detect_files` | `['shard.yml']` | 触发此组件的文件名 |
@@ -977,7 +1018,7 @@ The `daml` module shows the currently used [Daml](https://www.digitalasset.com/d
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------ | ----------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'Λ '` | A format string representing the symbol of Daml |
| `style` | `'bold cyan'` | 此组件的样式。 |
| `detect_extensions` | `[]` | 触发此组件的扩展名 |
@@ -1017,7 +1058,7 @@ The `dart` module shows the currently installed version of [Dart](https://dart.d
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------------------- | ----------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'🎯 '` | A format string representing the symbol of Dart |
| `detect_extensions` | `['dart']` | 触发此组件的扩展名 |
| `detect_files` | `['pubspec.yaml', 'pubspec.yml', 'pubspec.lock']` | 触发此组件的文件名 |
@@ -1053,9 +1094,9 @@ format = 'via [🔰 $version](bold red) '
### 配置项
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------- |
| ------------------- | ------------------------------------------------------------------------------------ | --------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `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']` | 触发此组件的文件名 |
@@ -1080,11 +1121,11 @@ format = 'via [🔰 $version](bold red) '
format = 'via [🦕 $version](green bold) '
```
## Directory
## Directory 目录
`directory` 组件显示当前目录的路径,显示的路径会截断到三个父目录以内。 如果您处于一个 git 仓库中,显示的路径则最多会截断到该仓库的根目录。
When using the `fish_style_pwd_dir_length` option, instead of hiding the path that is truncated, you will see a shortened name of each directory based on the number you enable for the option.
当使用 `fish_style_pwd_dir_length` 选项时,不会隐藏截断的路径,而是会根据该选项值简写后的每个路径。
例如,对于 `~/Dev/Nix/nixpkgs/pkgs`,其中 `nixpkgs` 是 git 仓库根目录,fish 风格相关选项设置为 `1`。 您将会看到 `~/D/N/nixpkgs/pkgs`,而在设置 fish 风格之前,当前路径将显示成 `nixpkgs/pkgs`
@@ -1264,9 +1305,9 @@ The module will also show the Target Framework Moniker (<https://docs.microsoft.
### 配置项
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------- |
| ------------------- | ------------------------------------------------------------------------------------------------------- | --------------------------------------------- |
| `format` | `'via [$symbol($version )(🎯 $tfm )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'.NET '` | 这个字段的内容会显示在当前 .NET 版本之前。 |
| `heuristic` | `true` | 使用更快的版本探测机制以保证 starship 的运行速度。 |
| `detect_extensions` | `['csproj', 'fsproj', 'xproj']` | 触发此组件的扩展名 |
@@ -1308,7 +1349,7 @@ The `elixir` module shows the currently installed version of [Elixir](https://el
| 选项 | 默认值 | 描述 |
| ------------------- | ----------------------------------------------------------- | --------------------------------------------------------------- |
| `format` | `'via [$symbol($version \(OTP $otp_version\) )]($style)'` | The format for the module elixir. |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'💧 '` | The symbol used before displaying the version of Elixir/Erlang. |
| `detect_extensions` | `[]` | 触发此组件的扩展名 |
| `detect_files` | `['mix.exs']` | 触发此组件的文件名 |
@@ -1351,7 +1392,7 @@ The `elm` module shows the currently installed version of [Elm](https://elm-lang
| 选项 | 默认值 | 描述 |
| ------------------- | -------------------------------------------------- | ----------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'🌳 '` | A format string representing the symbol of Elm. |
| `detect_extensions` | `['elm']` | 触发此组件的扩展名 |
| `detect_files` | `['elm.json', 'elm-package.json', '.elm-version']` | 触发此组件的文件名 |
@@ -1461,7 +1502,7 @@ The `erlang` module shows the currently installed version of [Erlang/OTP](https:
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------ | -------------------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `' '` | The symbol used before displaying the version of erlang. |
| `style` | `'bold red'` | 此组件的样式。 |
| `detect_extensions` | `[]` | 触发此组件的扩展名 |
@@ -1499,7 +1540,7 @@ The `fennel` module shows the currently installed version of [Fennel](https://fe
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------ | -------------------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'🧅 '` | The symbol used before displaying the version of fennel. |
| `style` | `'bold green'` | 此组件的样式。 |
| `detect_extensions` | `['fnl']` | 触发此组件的扩展名 |
@@ -1876,7 +1917,7 @@ The Git Status module is very slow in Windows directories (for example under `/m
### 配置项
| 选项 | 默认值 | 描述 |
| ------------------ | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| -------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | The default format for `git_status` |
| `conflicted` | `'='` | 这个分支有合并冲突。 |
| `ahead` | `'⇡'` | The format of `ahead` |
@@ -1891,9 +1932,10 @@ The Git Status module is very slow in Windows directories (for example under `/m
| `deleted` | `'✘'` | The format of `deleted` |
| `typechanged` | `""` | The format of `typechanged` |
| `style` | `'bold red'` | 此组件的样式。 |
| `忽略子组件` | `false` | 忽略子模块的更改. |
| `ignore_submodules` | `false` | 忽略子模块的更改. |
| `disabled` | `false` | 禁用 `git_status` 组件。 |
| `windows_starship` | | Use this (Linux) path to a Windows Starship executable to render `git_status` when on Windows paths in WSL. |
| `use_git_executable` | `false` | Do not use `gitoxide` for computing the status, but use the `git` executable instead. |
### 变量
@@ -1971,7 +2013,7 @@ windows_starship = '/mnt/c/Users/username/scoop/apps/starship/current/starship.e
The `gleam` module shows the currently installed version of [Gleam](https://gleam.run/). 默认情况下,此组件将在满足以下任意条件时显示:
- The current directory contains a `gleam.toml` file
- 当前目录包含 `gleam.toml` 文件
- The current directory contains a file with the `.gleam` extension
### 配置项
@@ -1979,7 +2021,7 @@ The `gleam` module shows the currently installed version of [Gleam](https://glea
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------ | ------------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'⭐ '` | A format string representing the symbol of Gleam. |
| `detect_extensions` | `['gleam']` | 触发此组件的扩展名 |
| `detect_files` | `['gleam.toml']` | 触发此组件的文件名 |
@@ -2024,7 +2066,7 @@ The `golang` module shows the currently installed version of [Go](https://golang
| 选项 | 默认值 | 描述 |
| ------------------- | ----------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'🐹 '` | A format string representing the symbol of Go. |
| `detect_extensions` | `['go']` | 触发此组件的扩展名 |
| `detect_files` | `['go.mod', 'go.sum', 'go.work', 'glide.yaml', 'Gopkg.yml', 'Gopkg.lock', '.go-version']` | 触发此组件的文件名 |
@@ -2110,7 +2152,7 @@ The `gradle` module is only able to read your Gradle Wrapper version from your c
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------ | ----------------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'🅶 '` | A format string representing the symbol of Gradle. |
| `detect_extensions` | `['gradle', 'gradle.kts']` | 触发此组件的扩展名 |
| `detect_files` | `[]` | 触发此组件的文件名 |
@@ -2175,7 +2217,7 @@ The `haxe` module shows the currently installed version of [Haxe](https://haxe.o
| 选项 | 默认值 | 描述 |
| ------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------ |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `detect_extensions` | `['hx', 'hxml']` | 触发此组件的扩展名 |
| `detect_files` | `['project.xml', 'Project.xml', 'application.xml', 'haxelib.json', 'hxformat.json', '.haxerc']` | 触发此组件的文件名 |
| `detect_folders` | `['.haxelib', 'haxe_libraries']` | 触发此组件的文件夹 |
@@ -2214,7 +2256,7 @@ The `helm` module shows the currently installed version of [Helm](https://helm.s
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------ | ------------------------------------------------ |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `detect_extensions` | `[]` | 触发此组件的扩展名 |
| `detect_files` | `['helmfile.yaml', 'Chart.yaml']` | 触发此组件的文件名 |
| `detect_folders` | `[]` | 触发此组件的文件夹 |
@@ -2313,7 +2355,7 @@ aliases = { "Max's MacBook Pro" = "home" }
| 选项 | 默认值 | 描述 |
| ------------------- | --------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
| `format` | `'via [${symbol}(${version} )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `detect_extensions` | `['java', 'class', 'gradle', 'jar', 'cljs', 'cljc']` | 触发此组件的扩展名 |
| `detect_files` | `['pom.xml', 'build.gradle.kts', 'build.sbt', '.java-version', 'deps.edn', 'project.clj', 'build.boot', '.sdkmanrc']` | 触发此组件的文件名 |
| `detect_folders` | `[]` | 触发此组件的文件夹 |
@@ -2410,7 +2452,7 @@ The `julia` module shows the currently installed version of [Julia](https://juli
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------ | ------------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `detect_extensions` | `['jl']` | 触发此组件的扩展名 |
| `detect_files` | `['Project.toml', 'Manifest.toml']` | 触发此组件的文件名 |
| `detect_folders` | `[]` | 触发此组件的文件夹 |
@@ -2448,7 +2490,7 @@ The `kotlin` module shows the currently installed version of [Kotlin](https://ko
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------ | ----------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `detect_extensions` | `['kt', 'kts']` | 触发此组件的扩展名 |
| `detect_files` | `[]` | 触发此组件的文件名 |
| `detect_folders` | `[]` | 触发此组件的文件夹 |
@@ -2666,7 +2708,7 @@ The `lua` module shows the currently installed version of [Lua](http://www.lua.o
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------ | -------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'🌙 '` | A format string representing the symbol of Lua. |
| `detect_extensions` | `['lua']` | 触发此组件的扩展名 |
| `detect_files` | `['.lua-version']` | 触发此组件的文件名 |
@@ -2817,6 +2859,40 @@ truncation_length = 4
truncation_symbol = ''
```
## Mise
The `mise` module shows the current mise health as reported by running `mise doctor`.
### 配置项
| 选项 | 默认值 | 描述 |
| ------------------ | -------------------------------- | ------------------------------------------------ |
| `symbol` | `'mise '` | The symbol used before displaying _mise_ health. |
| `style` | `'bold purple'` | 此组件的样式。 |
| `format` | `'on [$symbol$health]($style) '` | 组件格式化模板。 |
| `healthy_symbol` | `healthy` | The message displayed when _mise_ is healthy. |
| `unhealthy_symbol` | `unhealthy` | The message displayed when _mise_ is unhealthy. |
| `disabled` | `true` | Disables the `mise` module. |
### 变量
| 字段 | 示例 | 描述 |
| --------- | --------- | -------------------- |
| health | `healthy` | The health of _mise_ |
| symbol | | `symbol`对应值 |
| style\* | | `style`对应值 |
*: 此变量只能作为样式字符串的一部分使用
### 示例
```toml
# ~/.config/starship.toml
[mise]
health = 'ready'
```
## Mojo
The `mojo` module shows the current version of [Mojo programming language](https://www.modular.com/mojo) installed
@@ -2881,6 +2957,37 @@ format = '[$symbol]($style)'
style = 'bold purple'
```
## Network Namespace
The `netns` module shows the current network namespace. This uses `ip netns identify` to get the network namespace, so only network namespaces mounted at `/var/run/netns` will be detected.
### 配置项
| 选项 | 默认值 | 描述 |
| ---------- | --------------------------------- | ----------------------------------------------------------------- |
| `format` | `'[$symbol \[$name\]]($style)'` | 组件格式化模板。 |
| `symbol` | `'🛜 '` | The symbol used before the network namespace (defaults to empty). |
| `style` | `'blue bold dimmed'` | 此组件的样式。 |
| `disabled` | `false` | Disables the `netns` module. |
### 变量
| 字段 | 示例 | 描述 |
| --------- | ---------- | ----------------------------------------- |
| name | `my-netns` | The name of the current network namespace |
| symbol | | `symbol`对应值 |
| style\* | | `style`对应值 |
### 示例
```toml
# ~/.config/starship.toml
[netns]
style = 'bold yellow'
symbol = '🌐 '
```
## Nim
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). 默认情况下,此组件将在满足以下任意条件时显示:
@@ -2895,7 +3002,7 @@ The `nim` module shows the currently installed version of [Nim](https://nim-lang
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------ | ----------------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | The format for the module |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'👑 '` | The symbol used before displaying the version of Nim. |
| `detect_extensions` | `['nim', 'nims', 'nimble']` | 触发此组件的扩展名 |
| `detect_files` | `['nim.cfg']` | 触发此组件的文件名 |
@@ -2966,21 +3073,23 @@ format = 'via [☃️ $state( \($name\))](bold blue) '
## Node.js
The `nodejs` module shows the currently installed version of [Node.js](https://nodejs.org/). 默认情况下,此组件将在满足以下任意条件时显示:
`nodejs` 组件显示当前安装的 [Node.js](https://nodejs.org/) 版本。 默认情况下,此组件将在满足以下任意条件时显示:
- 当前目录包含 `package.json` 文件
- The current directory contains a `.node-version` file
- The current directory contains a `.nvmrc` file
- 当前目录包含 `.node-version` 文件
- 当前目录包含 `.nvmrc` 文件
- 当前目录包含 `node_modules` 目录
- The current directory contains a file with the `.js`, `.mjs` or `.cjs` extension
- The current directory contains a file with the `.ts`, `.mts` or `.cts` extension
- 当前目录包含扩展名为 `.js``.mjs` `.cjs` 的文件
- 当前目录包含扩展名为 `.ts``.mts` `.cts` 的文件
此外,在默认情况下,如果目录中包含了 `bunfig.toml``bun.lock``bun.lockb` 文件,此组件将被隐藏,覆盖以上条件。
### 配置项
| 选项 | 默认值 | 描述 |
| ------------------- | --------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `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']` | 触发此组件的文件名 |
@@ -3025,7 +3134,7 @@ The `ocaml` module shows the currently installed version of [OCaml](https://ocam
| 选项 | 默认值 | 描述 |
| ------------------------- | -------------------------------------------------------------------------- | ------------------------------------------------------- |
| `format` | `'via [$symbol($version )(\($switch_indicator$switch_name\) )]($style)'` | The format string for the module. |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'🐫 '` | The symbol used before displaying the version of OCaml. |
| `global_switch_indicator` | `''` | The format string used to represent global OPAM switch. |
| `local_switch_indicator` | `'*'` | The format string used to represent local OPAM switch. |
@@ -3102,7 +3211,7 @@ The `opa` module shows the currently installed version of the OPA tool. By defau
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------ | ----------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'🪖 '` | A format string representing the symbol of OPA. |
| `detect_extensions` | `['rego']` | 触发此组件的扩展名 |
| `detect_files` | `[]` | 触发此组件的文件名 |
@@ -3202,6 +3311,7 @@ Amazon = "🙂 "
Android = "🤖 "
Arch = "🎗️ "
Artix = "🎗️ "
Bluefin = "🐟 "
CachyOS = "🎗️ "
CentOS = "💠 "
Debian = "🌀 "
@@ -3252,7 +3362,7 @@ Windows = "🪟 "
| --------- | ------------ | ------------------------------------------------------------------ |
| symbol | `🎗️` | The current operating system symbol from advanced option `symbols` |
| name | `Arch Linux` | The current operating system name |
| 类型 | `Arch` | The current operating system type |
| type | `Arch` | The current operating system type |
| codename | | The current operating system codename, if applicable |
| edition | | The current operating system edition, if applicable |
| version | | The current operating system version, if applicable |
@@ -3275,11 +3385,12 @@ Windows = " "
Arch = "Arch is the best! "
```
## Package Version
## Package Version 包版本
当前目录是软件包的代码仓库时,将显示 `package` 组件,并显示软件包当前版本。 The module currently supports `npm`, `nimble`, `cargo`, `poetry`, `python`, `composer`, `gradle`, `julia`, `mix`, `helm`, `shards`, `daml` and `dart` packages.
当前目录是软件包的代码仓库时,将显示 `package` 组件,并显示软件包当前版本。 该组件目前支持 `npm``nimble``cargo``poetry``python``composer``gradle``julia``mix``helm``shards``daml` `dart` 的软件包。
- [**npm**](https://docs.npmjs.com/cli/commands/npm) The `npm` package version is extracted from the `package.json` present in the current directory
- [**npm**](https://docs.npmjs.com/cli/commands/npm) `npm` 包版本提取自当前目录中的 `package.json` 文件
- [**JSR**](https://jsr.io/) The `jsr` package version is extracted from the `jsr.json`/`jsr.jsonc` or `deno.json`/`deno.jsonc` present in the current directory
- [**Cargo**](https://doc.rust-lang.org/cargo/) The `cargo` package version is extracted from the `Cargo.toml` present in the current directory
- [**Nimble**](https://github.com/nim-lang/nimble) - The `nimble` package version is extracted from the `*.nimble` file present in the current directory with the `nimble dump` command
- [**Poetry**](https://python-poetry.org/) The `poetry` package version is extracted from the `pyproject.toml` present in the current directory
@@ -3297,7 +3408,7 @@ Arch = "Arch is the best! "
- [**Daml**](https://www.digitalasset.com/developers) - The `daml` package version is extracted from the `daml.yaml` present in the current directory
- [**Dart**](https://pub.dev/) - The `dart` package version is extracted from the `pubspec.yaml` present in the current directory
> ⚠ 此组件显示的是源代码在当前目录中的软件包的版本,而不是包管理器的版本。
> ⚠ 此组件显示的是源代码在当前目录中的软件包的版本,而不是包管理器的版本。
### 配置项
@@ -3305,7 +3416,7 @@ Arch = "Arch is the best! "
| ----------------- | --------------------------------- | --------------------------------------------------------- |
| `format` | `'is [$symbol$version]($style) '` | 组件格式化模板。 |
| `symbol` | `'📦 '` | 这个字段的内容会显示在当前软件包版本之前。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `style` | `'bold 208'` | 此组件的样式。 |
| `display_private` | `false` | Enable displaying version for packages marked as private. |
| `disabled` | `false` | 禁用 `package` 组件。 |
@@ -3344,7 +3455,7 @@ The `perl` module shows the currently installed version of [Perl](https://www.pe
| 选项 | 默认值 | 描述 |
| ------------------- | -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | The format string for the module. |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'🐪 '` | The symbol used before displaying the version of Perl |
| `detect_extensions` | `['pl', 'pm', 'pod']` | 触发此组件的扩展名 |
| `detect_files` | `['Makefile.PL', 'Build.PL', 'cpanfile', 'cpanfile.snapshot', 'META.json', 'META.yml', '.perl-version']` | 触发此组件的文件名 |
@@ -3380,9 +3491,9 @@ The `php` module shows the currently installed version of [PHP](https://www.php.
### 配置项
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------ | ------------------------------------------- |
| ------------------- | ------------------------------------ | --------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'🐘 '` | 这个字段的内容会显示在当前 PHP 版本之前。 |
| `detect_extensions` | `['php']` | 触发此组件的扩展名 |
| `detect_files` | `['composer.json', '.php-version']` | 触发此组件的文件名 |
@@ -3424,6 +3535,49 @@ The `pijul_channel` module shows the active channel of the repo in your current
| `truncation_symbol` | `'…'` | 此字段的内容用来表示分支名称被截断。 |
| `disabled` | `true` | Disables the `pijul` module. |
## Pixi
The `pixi` module shows the installed [pixi](https://pixi.sh) version as well as the activated environment, if `$PIXI_ENVIRONMENT_NAME` is set.
::: tip 提示
This does not suppress pixi's own prompt modifier, you may want to run `pixi config set change-ps1 false`.
:::
### 配置项
| 选项 | 默认值 | 描述 |
| -------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )(\($environment\) )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 Available vars are `raw`, `major`, `minor`, & `patch`. |
| `symbol` | `'🧚 '` | 在环境名之前显示的符号。 |
| `style` | `'yellow bold' | 此组件的样式。 |
| `show_default_environment` | `true` | Whether to indicate that the `default` environment of your project is activated. |
| `pixi_binary` | `['pixi']` | Configures the pixi binary that Starship should execute when getting the version. |
| `detect_extensions` | `[]` | 触发此组件的扩展名 |
| `detect_files` | `['pixi.toml']` | 触发此组件的文件名 |
| `detect_folders` | `['.pixi']` | 触发此组件的文件夹 |
| `disabled` | `false` | Disables the `pixi` module. |
### 变量
| 字段 | 示例 | 描述 |
| ----------- | --------- | ---------------------------- |
| version | `v0.33.0` | The version of `pixi` |
| environment | `py311` | The current pixi environment |
| symbol | | `symbol`对应值 |
| style | | `style`对应值 |
### 示例
```toml
# ~/.config/starship.toml
[pixi]
format = '[$symbol$environment](yellow) '
```
## Pulumi
The `pulumi` module shows the current username, selected [Pulumi Stack](https://www.pulumi.com/docs/intro/concepts/stack/), and version.
@@ -3444,7 +3598,7 @@ By default the Pulumi version is not shown, since it takes an order of magnitude
| 选项 | 默认值 | 描述 |
| ---------------- | -------------------------------------------- | -------------------------------------------------------------- |
| `format` | `'via [$symbol($username@)$stack]($style) '` | The format string for the module. |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `' '` | A format string shown before the Pulumi stack. |
| `style` | `'bold 5'` | 此组件的样式。 |
| `search_upwards` | `true` | Enable discovery of pulumi config files in parent directories. |
@@ -3496,7 +3650,7 @@ The `purescript` module shows the currently installed version of [PureScript](ht
| 选项 | 默认值 | 描述 |
| ------------------- | --------------------------------------------- | ------------------------------------------------------------ |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'<=> '` | The symbol used before displaying the version of PureScript. |
| `detect_extensions` | `['purs']` | 触发此组件的扩展名 |
| `detect_files` | `['spago.dhall', 'spago.yaml', 'spago.lock']` | 触发此组件的文件名 |
@@ -3538,7 +3692,6 @@ 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 虚拟环境中
@@ -3546,16 +3699,16 @@ By default, the module will be shown if any of the following conditions are met:
### 配置项
| 选项 | 默认值 | 描述 |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| -------------------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------- |
| `format` | `'via [${symbol}${pyenv_prefix}(${version} )(\($virtualenv\) )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `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. |
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should execute 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_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` 组件。 |
@@ -3617,7 +3770,7 @@ By default, the module will be shown if any of the following conditions are met:
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------ | ------------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'⨁ '` | A format string representing the symbol of Quarto |
| `style` | `'bold #75AADB'` | 此组件的样式。 |
| `detect_extensions` | `['.qmd']` | 触发此组件的扩展名 |
@@ -3652,7 +3805,7 @@ The `rlang` module shows the currently installed version of [R](https://www.r-pr
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------ | --------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'📐'` | A format string representing the symbol of R. |
| `style` | `'blue bold'` | 此组件的样式。 |
| `detect_extensions` | `['R', 'Rd', 'Rmd', 'Rproj', 'Rsx']` | Which extensions should trigger this module |
@@ -3689,7 +3842,7 @@ The `raku` module shows the currently installed version of [Raku](https://www.ra
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------------------ | ----------------------------------------------------- |
| `format` | `'via [$symbol($version-$vm_version )]($style)'` | The format string for the module. |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'🦋 '` | The symbol used before displaying the version of Raku |
| `detect_extensions` | `['p6', 'pm6', 'pod6', 'raku', 'rakumod']` | 触发此组件的扩展名 |
| `detect_files` | `['META6.json']` | 触发此组件的文件名 |
@@ -3726,7 +3879,7 @@ By default the `red` module shows the currently installed version of [Red](https
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------ | ----------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'🔺 '` | A format string representing the symbol of Red. |
| `detect_extensions` | `['red']` | 触发此组件的扩展名 |
| `detect_files` | `[]` | 触发此组件的文件名 |
@@ -3769,7 +3922,7 @@ Starship gets the current Ruby version by running `ruby -v`.
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------ | ------------------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'💎 '` | A format string representing the symbol of Ruby. |
| `detect_extensions` | `['rb']` | 触发此组件的扩展名 |
| `detect_files` | `['Gemfile', '.ruby-version']` | 触发此组件的文件名 |
@@ -3810,7 +3963,7 @@ By default the `rust` module shows the currently installed version of [Rust](htt
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------ | ----------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'🦀 '` | A format string representing the symbol of Rust |
| `detect_extensions` | `['rs']` | 触发此组件的扩展名 |
| `detect_files` | `['Cargo.toml']` | 触发此组件的文件名 |
@@ -3852,7 +4005,7 @@ The `scala` module shows the currently installed version of [Scala](https://www.
| 选项 | 默认值 | 描述 |
| ------------------- | ---------------------------------------- | ------------------------------------------------- |
| `format` | `'via [${symbol}(${version} )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `detect_extensions` | `['sbt', 'scala']` | 触发此组件的扩展名 |
| `detect_files` | `['.scalaenv', '.sbtenv', 'build.sbt']` | 触发此组件的文件名 |
| `detect_folders` | `['.metals']` | 触发此组件的文件夹 |
@@ -4025,7 +4178,7 @@ The `solidity` module shows the currently installed version of [Solidity](https:
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------ | --------------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${major}.${minor}.${patch}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${major}.${minor}.${patch}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'S '` | A format string representing the symbol of Solidity |
| `compiler | ['solc'] | The default compiler for Solidity. |
| `detect_extensions` | `['sol']` | 触发此组件的扩展名 |
@@ -4209,7 +4362,7 @@ By default the `swift` module shows the currently installed version of [Swift](h
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------ | ------------------------------------------------ |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'🐦 '` | A format string representing the symbol of Swift |
| `detect_extensions` | `['swift']` | 触发此组件的扩展名 |
| `detect_files` | `['Package.swift']` | 触发此组件的文件名 |
@@ -4256,7 +4409,7 @@ By default the Terraform version is not shown, since this is slow for current ve
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------ | ----------------------------------------------------- |
| `format` | `'via [$symbol$workspace]($style) '` | The format string for the module. |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'💠'` | A format string shown before the terraform workspace. |
| `detect_extensions` | `['tf', 'tfplan', 'tfstate']` | 触发此组件的扩展名 |
| `detect_files` | `[]` | 触发此组件的文件名 |
@@ -4355,7 +4508,7 @@ By default, the module will be shown if any of the following conditions are met:
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------ | ------------------------------------------------ |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'t '` | A format string representing the symbol of Typst |
| `style` | `'bold #0093A7'` | 此组件的样式。 |
| `detect_extensions` | `['.typ']` | 触发此组件的扩展名 |
@@ -4374,11 +4527,11 @@ By default, the module will be shown if any of the following conditions are met:
*: 此变量只能作为样式字符串的一部分使用
## 用户名
## Username 用户名
`username` 组件显示当前活跃的用户名。 此组件将在符合以下任意条件时显示:
- The current user is root/admin
- 当前用户是 root/admin
- 当前用户与登录用户不相同
- 用户正通过 SSH 会话连接访问
- 字段 `show_always` 被设置为 true
@@ -4436,7 +4589,7 @@ The `vagrant` module shows the currently installed version of [Vagrant](https://
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------ | --------------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'⍱ '` | A format string representing the symbol of Vagrant. |
| `detect_extensions` | `[]` | 触发此组件的扩展名 |
| `detect_files` | `['Vagrantfile']` | 触发此组件的文件名 |
@@ -4473,9 +4626,9 @@ The `vlang` module shows you your currently installed version of [V](https://vla
### 配置项
| 选项 | 默认值 | 描述 |
| ------------------- | -------------------------------------------- | -------------------------------------------- |
| ------------------- | -------------------------------------------- | --------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'V '` | A format string representing the symbol of V |
| `detect_extensions` | `['v']` | 触发此组件的扩展名 |
| `detect_files` | `['v.mod', 'vpkg.json', '.vpkg-lock.json' ]` | 触发此组件的文件名 |
@@ -4542,7 +4695,7 @@ By default the `zig` module shows the currently installed version of [Zig](https
| 选项 | 默认值 | 描述 |
| ------------------- | ------------------------------------ | ----------------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 |
| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor``patch` |
| `version_format` | `'v${raw}'` | 版本格式 可用的字段`raw`, `major`, `minor``patch` |
| `symbol` | `'↯ '` | The symbol used before displaying the version of Zig. |
| `style` | `'bold yellow'` | 此组件的样式。 |
| `disabled` | `false` | Disables the `zig` module. |
@@ -4615,7 +4768,7 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt
| `when` | `false` | Either a boolean value (`true` or `false`, without quotes) or a string shell command used as a condition to show the module. In case of a string, the module will be shown if the `shell` returns a `0` status code from executing it. |
| `require_repo` | `false` | If `true`, the module will only be shown in paths containing a (git) repository. This option alone is not sufficient display condition in absence of other options. |
| `shell` | | [See below](#custom-command-shell) |
| `描述` | `'<custom module>'` | The description of the module that is shown when running `starship explain`. |
| `description` | `'<custom module>'` | The description of the module that is shown when running `starship explain`. |
| `unsafe_no_escape` | `false` | When set, command output is not escaped of characters that could be interpreted by the shell. |
| `detect_files` | `[]` | The files that will be searched in the working directory for a match. |
| `detect_folders` | `[]` | The directories that will be searched in the working directory for a match. |
+1 -1
View File
@@ -72,7 +72,7 @@ Starship 会执行数个不同的命令来获取应该显示的信息,例如
env STARSHIP_LOG=trace starship module rust
```
If starship is being slow you can try using the `timings` command to see if there is a particular module or command that is to blame.
若 Starship 运行缓慢,您可以使用 `timings` 命令查看运行缓慢的组件或命令。
```sh
env STARSHIP_LOG=trace starship timings
+5 -3
View File
@@ -229,10 +229,12 @@ curl -sS https://starship.rs/install.sh | sh
| Alpine Linux 3.13+ | [Alpine Linux Packages](https://pkgs.alpinelinux.org/packages?name=starship) | `apk add starship` |
| Arch Linux | [Arch Linux extra](https://archlinux.org/packages/extra/x86_64/starship) | `pacman -S starship` |
| CentOS 7+ | [Copr](https://copr.fedorainfracloud.org/coprs/atim/starship) | `dnf copr enable atim/starship` <br /> `dnf install starship` |
| Debian 13+ | [Debian Main](https://sources.debian.org/src/starship/1.22.1-1/) | `apt install starship` |
| Gentoo | [Gentoo Packages](https://packages.gentoo.org/packages/app-shells/starship) | `emerge app-shells/starship` |
| Manjaro | | `pacman -S starship` |
| NixOS | [nixpkgs](https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/misc/starship/default.nix) | `nix-env -iA nixpkgs.starship` |
| openSUSE | [OSS](https://software.opensuse.org/package/starship) | `zypper in starship` |
| Ubuntu 25.04+ | [Ubuntu Universe](https://packages.ubuntu.com/source/plucky/starship) | `apt install starship` |
| Void Linux | [Void Linux Packages](https://github.com/void-linux/void-packages/tree/master/srcpkgs/starship) | `xbps-install -S starship` |
</details>
@@ -338,14 +340,14 @@ eval $(starship init ion)
<details>
<summary>Nushell</summary>
Add the following to the end of your Nushell configuration (find it by running `$nu.config-path` in Nushell):
将以下内容添加到你的 Nushell 配置文件的末尾(在 Nushell 中运行 `$nu.config-path` 可以找到该文件)
```sh
mkdir ($nu.data-dir | path join "vendor/autoload")
starship init nu | save -f ($nu.data-dir | path join "vendor/autoload/starship.nu")
```
Note: Only Nushell v0.96+ is supported
注意:仅支持 Nushell v0.96+
</details>
@@ -425,7 +427,7 @@ eval "$(starship init zsh)"
通过 [成为赞助商 ](https://github.com/sponsors/starship)来支持这个项目。 您的名字或 LOGO 将在此处显示,并链接到您的网站。
## 🔒 Code Signing Policy
## 🔒 代码签名策略
Free code signing provided by [SignPath.io](https://signpath.io), certificate by [SignPath Foundation](https://signpath.org).
+2 -2
View File
@@ -111,7 +111,7 @@ error_symbol = "[✖](bold red)"
_Note:_ The `character` element automatically adds a space after, so unlike the other `format` strings, we specifically do not add one in the above examples.
#### Command Duration
#### Command Duration 命令执行时长
| Removed Property | Replacement |
| ---------------- | ----------- |
@@ -125,7 +125,7 @@ _Note:_ The `character` element automatically adds a space after, so unlike the
++ format = "took [$duration]($style) "
```
#### Directory
#### Directory 目录
| Removed Property | Replacement |
| ---------------- | ----------- |
+7 -1
View File
@@ -74,4 +74,10 @@ This preset is heavily inspired by [Pastel Powerline](./pastel-powerline.md), an
这是一个伪最简的预设,灵感来自 [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)
[![Jetpack 预设的屏幕截图](/presets/img/jetpack.png "Click to view Jetpack preset")](./jetpack)
## [Catppuccin Powerline](./catppuccin-powerline.md)
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
[![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png "Click to view Catppuccin Powerline preset")](./catppuccin-powerline)
+1 -1
View File
@@ -12,6 +12,6 @@
starship preset bracketed-segments -o ~/.config/starship.toml
```
[Click to download TOML](/presets/toml/bracketed-segments.toml){download}
[点这下载 TOML](/presets/toml/bracketed-segments.toml){download}
<<< @/public/presets/toml/bracketed-segments.toml
@@ -0,0 +1,28 @@
[Return to Presets](./README.md#catppuccin-powerline)
# Catppuccin Powerline Preset
This preset is a minimally modified version of [Gruvbox Rainbow](./gruvbox-rainbow.md) using the [Catppuccin](https://github.com/catppuccin/catppuccin) theme palette.
![Screenshot of Catppuccin Powerline preset](/presets/img/catppuccin-powerline.png)
### 前置要求
- A [Nerd Font](https://www.nerdfonts.com/) installed and enabled in your terminal
### 配置
```sh
starship preset catppuccin-powerline -o ~/.config/starship.toml
```
By default this preset uses the Mocha flavour of Catppucin, but you can specify any of the flavours by modifying the value of `palette`:
- `catppuccin_mocha`
- `catppuccin_frappe`
- `catppuccin_macchiato`
- `catppucin_latte`
[Click to download TOML](/presets/toml/catppuccin-powerline.toml)
<<< @/public/presets/toml/catppuccin-powerline.toml
+1 -1
View File
@@ -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){download}
[点这下载 TOML](/presets/toml/gruvbox-rainbow.toml){download}
<<< @/public/presets/toml/gruvbox-rainbow.toml

Some files were not shown because too many files have changed in this diff Show More