diff --git a/docs/ar-SA/config/README.md b/docs/ar-SA/config/README.md index 286375e2..c9970753 100644 --- a/docs/ar-SA/config/README.md +++ b/docs/ar-SA/config/README.md @@ -1804,13 +1804,13 @@ The `package` module is shown when the current directory is the repository for a ### Options -| Option | Default | Description | -| ----------------- | ---------------------------------- | ---------------------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | The format for the module. | -| `symbol` | `"📦 "` | The symbol used before displaying the version the package. | -| `style` | `"bold 208"` | The style for the module. | -| `display_private` | `false` | Enable displaying version for packages marked as private. | -| `disabled` | `false` | Disables the `package` module. | +| Option | Default | Description | +| ----------------- | --------------------------------- | ---------------------------------------------------------- | +| `format` | `"is [$symbol$version]($style) "` | The format for the module. | +| `symbol` | `"📦 "` | The symbol used before displaying the version the package. | +| `style` | `"bold 208"` | The style for the module. | +| `display_private` | `false` | Enable displaying version for packages marked as private. | +| `disabled` | `false` | Disables the `package` module. | ### Variables @@ -2151,7 +2151,9 @@ The `status` module displays the exit code of the previous command. The module w ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. ::: +This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. + +::: ### Options @@ -2335,7 +2337,11 @@ The `username` module shows active user's username. The module will be shown if - The user is currently connected as an SSH session - The variable `show_always` is set to true -::: tip SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. ::: +::: tip + +SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. + +::: ### Options diff --git a/docs/ar-SA/guide/README.md b/docs/ar-SA/guide/README.md index 74b5b1e6..9f33e569 100644 --- a/docs/ar-SA/guide/README.md +++ b/docs/ar-SA/guide/README.md @@ -125,6 +125,8 @@ ### Getting Started +**Note**: due to the proliferation of different platforms, only a subset of supported platforms are shown below. Can't see yours? Have a look at the [extra platform instructions](https://starship.rs/installing/). + 1. Install the **starship** binary: @@ -138,17 +140,10 @@ ``` - ##### From source on [crates.io](https://crates.io/): - - ```sh - cargo install starship - ``` - - #### Install via Package Manager - ##### With [Homebrew](https://brew.sh/): + ##### Example: [Homebrew](https://brew.sh/): ```sh brew install starship @@ -161,7 +156,7 @@ scoop install starship ``` -1. Add the init script to your shell's config file: +2. Add the init script to your shell's config file: #### Bash diff --git a/docs/ar-SA/installing/README.md b/docs/ar-SA/installing/README.md new file mode 100644 index 00000000..6f0ea0d6 --- /dev/null +++ b/docs/ar-SA/installing/README.md @@ -0,0 +1,46 @@ +# 🚀 Advanced Installation + +To install starship, you need to do two things: + +1. Get the **starship** binary onto your computer +1. Tell your shell to use the starship binary as its prompt by modifying its init scripts + +For most users, the instructions on [the main page](/guide/#🚀-installation) will work great. However, for some more specialized platforms, different instructions are needed. + +There are so many platforms out there that they didn't fit into the main README.md file, so here are some installation instructions for other platforms from the community. Is yours not here? Please do add it here if you figure it out! + +## [Nix](https://nixos.wiki/wiki/Nix) + +### Getting the Binary + +#### Imperatively + +```sh +nix-env -iA nixos.starship +``` + +#### Declarative, single user, via [home-manager](home-manager) + +Add `pkgs.starship` to your `home.packages` in your `home.nix` file, then run + +```sh +home-manager switch +``` + +#### Declarative, system-wide, with NixOS + +Add `pkgs.starship` to `environment.packages` in your `configuration.nix`, then run + +```sh +sudo nixos-rebuild switch +``` + +### Modifying Init Scripts + +#### With Nix and home-manager, using zsh: + +Add the following to `programs.zsh.initExtra` in your `home.nix` file, then run + +```sh +home-manager switch +``` diff --git a/docs/de-DE/advanced-config/README.md b/docs/de-DE/advanced-config/README.md index f699bf55..02adc1ab 100644 --- a/docs/de-DE/advanced-config/README.md +++ b/docs/de-DE/advanced-config/README.md @@ -82,7 +82,7 @@ Style-String sind Wortlisten, getrennt durch Leerzeichen. Die Wörter haben kein wobei `` eine Farbspezifikation ist (siehe unten). `fg:` und `` tun derzeit dasselbe , das kann sich in Zukunft aber ändern. Die Reihenfolge der Wörter in der Liste spielt keine Rolle. -The `none` token overrides all other tokens in a string if it is not part of a `bg:` specifier, so that e.g. `fg:red none fg:blue` will still create a string with no styling. `bg:none` sets the background to the default color so `fg:red bg:none` is equivalent to `red` or `fg:red` and `bg:green fg:red bg:none` is also equivalent to `fg:red` or `red`. It may become an error to use `none` in conjunction with other tokens in the future. +The `none` token overrides all other tokens in a string if it is not part of a `bg:` specifier, so that e.g. `fg:red none fg:blue` will still create a string with no styling. `bg:none` sets the background to the default color so `fg:red bg:none` is equivalent to `red` or `fg:red` and `bg:green fg:red bg:none` is also equivalent to `fg:red` or `red`. In der Zukunft könnte die Unterstützung von `none` in Verbindung mit anderen Tokens fallen gelassen werden. Eine Farbspezifikation kann wie folgt aussehen: diff --git a/docs/de-DE/config/README.md b/docs/de-DE/config/README.md index 460dfe77..cf1c8197 100644 --- a/docs/de-DE/config/README.md +++ b/docs/de-DE/config/README.md @@ -303,16 +303,16 @@ Das `battery` Modul zeigt, wie hoch der Akku des Geräts geladen ist und den akt ### Optionen -| Option | Standartwert | Beschreibung | -| -------------------- | --------------------------------- | ---------------------------------------------------------------- | -| `full_symbol` | `""` | Das Symbol das angezeigt wird wenn der Akku voll geladen ist. | -| `charging_symbol` | `""` | Das Symbol das angezeigt wird wenn der Akku aufgeladen wird. | -| `discharging_symbol` | `""` | Das Symbol, das angezeigt wird, wenn die Batterie entladen wird. | -| `unknown_symbol` | `""` | The symbol shown when the battery state is unknown. | -| `empty_symbol` | `""` | The symbol shown when the battery state is empty. | -| `format` | `"[$symbol$percentage]($style) "` | The format for the module. | -| `display` | [link](#battery-display) | Display threshold and style for the module. | -| `disabled` | `false` | Disables the `battery` module. | +| Option | Standartwert | Beschreibung | +| -------------------- | --------------------------------- | ----------------------------------------------------------------------------------- | +| `full_symbol` | `""` | Das Symbol das angezeigt wird wenn der Akku voll geladen ist. | +| `charging_symbol` | `""` | Das Symbol das angezeigt wird wenn der Akku aufgeladen wird. | +| `discharging_symbol` | `""` | Das Symbol, das angezeigt wird, wenn die Batterie entladen wird. | +| `unknown_symbol` | `""` | The symbol shown when the battery state is unknown. | +| `empty_symbol` | `""` | The symbol shown when the battery state is empty. | +| `format` | `"[$symbol$percentage]($style) "` | The format for the module. | +| `display` | [link](#battery-display) | Stellt den Grenzwert ein ab dem der Ladezustand (das battery-Modul) angezeigt wird. | +| `disabled` | `false` | Wenn der Wert auf `true` steht, wird das Akkustand-Modul deaktiviert. | ### Beispiel @@ -328,7 +328,7 @@ discharging_symbol = "💀" ### Anzeige des Akkustandes -The `display` configuration option is used to define when the battery indicator should be shown (threshold) and what it looks like (style). If no `display` is provided. Die Standardwerte sind folgende: +Die `display` Konfiguration "threshold" stellt ein ab wann die Akkuanzeige eingeblendet wird. Mit "style" wird das Erscheinungsbild festgelegt. Wenn `display` nicht angegeben ist. Die Standardwerte sind folgende: ```toml [[battery.display]] @@ -338,12 +338,12 @@ style = "bold red" #### Optionen -The `display` option is an array of the following table. +Die `display`-Option beinhaltet ein Array mit den folgenden Werten. -| Option | Beschreibung | -| ----------- | ----------------------------------------------- | -| `threshold` | The upper bound for the display option. | -| `style` | The style used if the display option is in use. | +| Option | Beschreibung | +| ----------- | ------------------------------------------------------- | +| `threshold` | Der Schwellenwert zur Anzeige dieser Option. | +| `style` | Der Stil, der zur Anzeige dieser Option verwendet wird. | #### Beispiel @@ -362,9 +362,9 @@ style = "bold yellow" ## Zeichen -The `character` module shows a character (usually an arrow) beside where the text is entered in your terminal. +Das `character` Modul zeigt ein Zeichen ( meistens einen Pfeil "❯") vor der Texteingabe an. -The character will tell you whether the last command was successful or not. It can do this in two ways: +Das Zeichen zeigt an ob der letzte Befehl erfolgreich war, oder einen Fehler erzeugt hat. It can do this in two ways: - changing color (`red`/`green`) - changing shape (`❯`/`✖`) @@ -379,7 +379,7 @@ By default it only changes color. If you also want to change it's shape take a l | `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. | | `vicmd_symbol` | `"[❮](bold green)"` | The format string used before the text input if the shell is in vim normal mode. | -| `disabled` | `false` | Disables the `character` module. | +| `disabled` | `false` | Deaktiviert das `character`-Modul. | ### Variables @@ -446,27 +446,27 @@ The `cmake` module shows the currently installed version of CMake if any of the ## Befehlsdauer -The `cmd_duration` module shows how long the last command took to execute. The module will be shown only if the command took longer than two seconds, or the `min_time` config value, if it exists. +Das `cmd_duration` Modul zeigt an wie lange der letzte Befehl ausgeführt wurde. Das Modul wird nur angezeigt wenn der letzte Befehl länger als zwei Sekunden ausgeführt wurde. Mit der `min_time` Option kann die Zeit eingestellt werden ab der `cmd_duration` angezeigt wird. -::: warning Do not hook the DEBUG trap in Bash +::: warning Nicht die DEBUG-trap in der Bash hooken -If you are running Starship in `bash`, do not hook the `DEBUG` trap after running `eval $(starship init $0)`, or this module **will** break. +Ist `bash` die Konsole der Wahl, dann nicht die `DEBUG`-trap nach der Ausführung von `eval $(starship init $0)` hooken, andernfalls **wird** dieses Modul unweigerlich untergehen. ::: -Bash users who need preexec-like functionality can use [rcaloras's bash_preexec framework](https://github.com/rcaloras/bash-preexec). Simply define the arrays `preexec_functions` and `precmd_functions` before running `eval $(starship init $0)`, and then proceed as normal. +Bash Nutzer, die eine "preexec" ähnliche Funktion benötigen, können [rcaloras bash_preexec Framework](https://github.com/rcaloras/bash-preexec) verwenden. Definieren Sie einfach die Arrays `preexec_functions` und `precmd_functions` bevor sie `eval $(starship init $0)` ausführen, und fahren Sie dann wie gewohnt fort. ### Optionen -| Option | Standardwert | Beschreibung | -| -------------------- | ----------------------------- | ---------------------------------------------------------- | -| `min_time` | `2_000` | Shortest duration to show time for (in milliseconds). | -| `show_milliseconds` | `false` | Show milliseconds in addition to seconds for the duration. | -| `format` | `"took [$duration]($style) "` | The format for the module. | -| `style` | `"bold yellow"` | Stil für dieses Modul. | -| `disabled` | `false` | Disables the `cmd_duration` module. | -| `show_notifications` | `false` | Show desktop notifications when command completes. | -| `min_time_to_notify` | `45_000` | Shortest duration for notification (in milliseconds). | +| Option | Standardwert | Beschreibung | +| -------------------- | ----------------------------- | ------------------------------------------------------------------ | +| `min_time` | `2_000` | Schwellwert für kleinste anzuzeigende Laufzeit (in Millisekunden). | +| `show_milliseconds` | `false` | Zeige Millisekunden zusätzlich zu Sekunden. | +| `format` | `"took [$duration]($style) "` | The format for the module. | +| `style` | `"bold yellow"` | Stil für dieses Modul. | +| `disabled` | `false` | Deaktiviert das `cmd_duration`-Modul. | +| `show_notifications` | `false` | Show desktop notifications when command completes. | +| `min_time_to_notify` | `45_000` | Shortest duration for notification (in milliseconds). | ::: Tipp @@ -495,24 +495,24 @@ format = "underwent [$duration](bold yellow)" ## Conda -The `conda` module shows the current conda environment, if `$CONDA_DEFAULT_ENV` is set. +Das `conda`-Modul zeigt dessen aktuelle Umgebung an, sofern `$CONDA_DEFAULT_ENV` gesetzt ist. ::: Tipp -This does not suppress conda's own prompt modifier, you may want to run `conda config --set changeps1 False`. +Hinweis: Dies unterdrückt nicht conda's eigenen Prompt-Modifikator, sie können jedoch conda mit `conda config --set changeps1 False` konfigurieren, um die Ausgabe von conda selbst auszuschalten. ::: ### Optionen -| Option | Standardwert | Beschreibung | -| ------------------- | -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `truncation_length` | `1` | The number of directories the environment path should be truncated to, if the environment was created via `conda create -p [path]`. `0` means no truncation. Also see the [`directory`](#directory) module. | -| `symbol` | `"🅒 "` | The symbol used before the environment name. | -| `style` | `"bold green"` | Stil für dieses Modul. | -| `format` | `"via [$symbol$environment]($style) "` | The format for the module. | -| `ignore_base` | `true` | Ignores `base` environment when activated. | -| `disabled` | `false` | Disables the `conda` module. | +| Option | Standardwert | Beschreibung | +| ------------------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `truncation_length` | `1` | Die Anzahl der Verzeichnisse, auf die der Verzeichnisspfad abgeschnitten werden soll, wenn die Umgebung über `conda erstellt wurde -p [path]`. `0` bedeutet keine Kürzung. Beachte auch die Beschreibung für das [`directory`](#directory) Modul. | +| `symbol` | `"🅒 "` | Symbol das vor dem Umgebungsnamen angezeigt wird. | +| `style` | `"bold green"` | Stil für dieses Modul. | +| `format` | `"via [$symbol$environment]($style) "` | The format for the module. | +| `ignore_base` | `true` | Ignores `base` environment when activated. | +| `disabled` | `false` | Deaktiviert das `conda`-Modul. | ### Variables @@ -606,7 +606,7 @@ format = "via [🔰 $version](bold red) " ## Verzeichnis -The `directory` module shows the path to your current directory, truncated to three parent folders. Your directory will also be truncated to the root of the git repo that you're currently in. +Das `directory` -Modul zeigt den Pfad zu Ihrem aktuellen Verzeichnis an, abgeschnitten auf drei übergeordnete Ordner. Your directory will also be truncated to the root of the git repo that you're currently in. When using the fish style pwd 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. @@ -616,17 +616,17 @@ For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, an | Option | Standardwert | Beschreibung | | ------------------- | -------------------------------------------------- | -------------------------------------------------------------------------------- | -| `truncation_length` | `3` | The number of parent folders that the current directory should be truncated to. | +| `truncation_length` | `3` | Die Anzahl der übergeordneten Ordner, die angezeigt werden. | | `truncate_to_repo` | `true` | Whether or not to truncate to the root of the git repo that you're currently in. | | `format` | `"[$path]($style)[$read_only]($read_only_style) "` | The format for the module. | | `style` | `"bold cyan"` | Stil für dieses Modul. | -| `disabled` | `false` | Disables the `directory` module. | +| `disabled` | `false` | Deaktiviert das `directory`-Modul. | | `read_only` | `"🔒"` | The symbol indicating current directory is read only. | | `read_only_style` | `"red"` | The style for the read only symbol. | | `truncation_symbol` | `""` | The symbol to prefix to truncated paths. eg: "…/" |
-This module has a few advanced configuration options that control how the directory is displayed. +Dieses Modul hat einige erweiterte Konfigurationsoptionen, welche die Darstellung von Verzeichnissen steuern. | Advanced Option | Standardwert | Beschreibung | | --------------------------- | ------------ | ---------------------------------------------------------------------------------------- | @@ -722,13 +722,13 @@ The module will also show the Target Framework Moniker ("` | The description of the module that is shown when running `starship explain`. | -| `files` | `[]` | The files that will be searched in the working directory for a match. | -| `directories` | `[]` | The directories that will be searched in the working directory for a match. | -| `extensions` | `[]` | The extensions that will be searched in the working directory for a match. | -| `symbol` | `""` | The symbol used before displaying the command output. | -| `style` | `"bold green"` | Stil für dieses Modul. | -| `format` | `"[$symbol$output]($style) "` | The format for the module. | -| `disabled` | `false` | Disables this `custom` module. | +| Option | Standardwert | Beschreibung | +| -------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------- | +| `command` | | The command whose output should be printed. The command will be passed on stdin to the shell. | +| `when` | | A shell command used as a condition to show the module. The module will be shown if the command returns a `0` status code. | +| `shell` | | [See below](#custom-command-shell) | +| `beschreibung` | `""` | The description of the module that is shown when running `starship explain`. | +| `files` | `[]` | The files that will be searched in the working directory for a match. | +| `directories` | `[]` | The directories that will be searched in the working directory for a match. | +| `extensions` | `[]` | The extensions that will be searched in the working directory for a match. | +| `symbol` | `""` | The symbol used before displaying the command output. | +| `style` | `"bold green"` | Stil für dieses Modul. | +| `format` | `"[$symbol$output]($style) "` | The format for the module. | +| `disabled` | `false` | Disables this `custom` module. | ### Variables diff --git a/docs/de-DE/guide/README.md b/docs/de-DE/guide/README.md index 40ad9c69..70421a65 100644 --- a/docs/de-DE/guide/README.md +++ b/docs/de-DE/guide/README.md @@ -102,7 +102,7 @@ width="50%" align="right" /> -**The minimal, blazing-fast, and infinitely customizable prompt for any shell!** +**Minimale, super schnelle und unendlich anpassbare Prompt für jede Shell!** - **Fast:** it's fast – _really really_ fast! 🚀 - **Customizable:** configure every aspect of your prompt. @@ -125,6 +125,8 @@ ### Erste Schritte +**Note**: due to the proliferation of different platforms, only a subset of supported platforms are shown below. Can't see yours? Have a look at the [extra platform instructions](https://starship.rs/installing/). + 1. Installiere **starship**: @@ -138,17 +140,10 @@ ``` - ##### Per Quellcode über [crates.io](https://crates.io/): - - ```sh - cargo install starship - ``` - - #### Installation mithilfe eines Paket-Managers - ##### Mit [Homebrew](https://brew.sh/): + ##### Example: [Homebrew](https://brew.sh/): ```sh brew install starship @@ -161,7 +156,7 @@ scoop install starship ``` -1. Füge das init-Skript zur Konfigurationsdatei deiner Shell hinzu: +2. Füge das init-Skript zur Konfigurationsdatei deiner Shell hinzu: #### Bash @@ -222,7 +217,7 @@ Wir laden Leute **aller Erfahrungsstufen** herzlich ein mitzumachen! Falls du di Wenn du eine andere Sprache flüssig sprichts, würden wir uns sehr freuen wenn du helfen würdest die Dokumentation in anderen Sprachen auf dem aktuellsten Stand zu halten. Hier kannst du bei der Übersetzung helfen [Starship Crowdin](https://translate.starship.rs/). -Falls du an Starship mitwirken willst, wirf bitte einen Blick auf den [Contributing Guide](https://github.com/starship/starship/blob/master/CONTRIBUTING.md). Schau auch gerne auf unserem [Discord server](https://discord.gg/8Jzqu3T) vorbei. 👋 +Falls du an Starship mitwirken willst, wirf bitte einen Blick auf den [Leitfaden zum Mitwirken](https://github.com/starship/starship/blob/master/CONTRIBUTING.md). Schau auch gerne auf unserem [Discord-Server](https://discord.gg/8Jzqu3T) vorbei. 👋 ### Mitwirkenden @@ -231,7 +226,7 @@ Das Projekt existiert dank aller der, die Mitwirken. [[Mitmachen](https://github ### Finanzielle Unterstützung -Become a financial contributor and help us sustain our community. [[Contribute](https://opencollective.com/starship/contribute)] +Become a financial contributor and help us sustain our community. [[Mitmachen](https://opencollective.com/starship/contribute)] #### Individuals @@ -239,7 +234,7 @@ Become a financial contributor and help us sustain our community. [[Contribute]( #### Organisationen -Support this project with your organization. Your logo will show up here with a link to your website. [[Contribute](https://opencollective.com/starship/contribute)] +Support this project with your organization. Your logo will show up here with a link to your website. [[Mitmachen](https://opencollective.com/starship/contribute)] @@ -254,7 +249,7 @@ Support this project with your organization. Your logo will show up here with a ## 💭 Inspiriert durch -Schaut euch bitte auch die Projekte an, die die Entstehung von Starship inspiriert haben. 🙏 +Bitte schaue dir diese früheren Projekte an, die dazu beigetragen haben, Starship zu kreieren. 🙏 - **[denysdovhan/spaceship-prompt](https://github.com/denysdovhan/spaceship-prompt)** - Ein ZSH-Prompt für Astronauten. @@ -264,9 +259,9 @@ Schaut euch bitte auch die Projekte an, die die Entstehung von Starship inspirie


- Starship Raketen Icon + Starship Raketen-Symbol

## 📝 Lizenz -Copyright © 2019-present, [Starship Contributors](https://github.com/starship/starship/graphs/contributors).
Unter der [ISC](https://github.com/starship/starship/blob/master/LICENSE) Lizens. +Copyright © 2019-heute [Starship-Mitwirkende](https://github.com/starship/starship/graphs/contributors).
Dieses Projekt ist [ISC](https://github.com/starship/starship/blob/master/LICENSE) lizenziert. diff --git a/docs/de-DE/installing/README.md b/docs/de-DE/installing/README.md new file mode 100644 index 00000000..6f0ea0d6 --- /dev/null +++ b/docs/de-DE/installing/README.md @@ -0,0 +1,46 @@ +# 🚀 Advanced Installation + +To install starship, you need to do two things: + +1. Get the **starship** binary onto your computer +1. Tell your shell to use the starship binary as its prompt by modifying its init scripts + +For most users, the instructions on [the main page](/guide/#🚀-installation) will work great. However, for some more specialized platforms, different instructions are needed. + +There are so many platforms out there that they didn't fit into the main README.md file, so here are some installation instructions for other platforms from the community. Is yours not here? Please do add it here if you figure it out! + +## [Nix](https://nixos.wiki/wiki/Nix) + +### Getting the Binary + +#### Imperatively + +```sh +nix-env -iA nixos.starship +``` + +#### Declarative, single user, via [home-manager](home-manager) + +Add `pkgs.starship` to your `home.packages` in your `home.nix` file, then run + +```sh +home-manager switch +``` + +#### Declarative, system-wide, with NixOS + +Add `pkgs.starship` to `environment.packages` in your `configuration.nix`, then run + +```sh +sudo nixos-rebuild switch +``` + +### Modifying Init Scripts + +#### With Nix and home-manager, using zsh: + +Add the following to `programs.zsh.initExtra` in your `home.nix` file, then run + +```sh +home-manager switch +``` diff --git a/docs/es-ES/config/README.md b/docs/es-ES/config/README.md index df1b2e75..58b73200 100644 --- a/docs/es-ES/config/README.md +++ b/docs/es-ES/config/README.md @@ -304,16 +304,16 @@ El módulo `battery` muestra la cantidad de batería y si se está cargando o no ### Opciones -| Opción | Por defecto | Descripción | -| -------------------- | --------------------------------- | --------------------------------------------------- | -| `full_symbol` | `""` | Se muestra cuando la batería está cargada. | -| `charging_symbol` | `""` | Se muestra cuando la batería se está cargando. | -| `discharging_symbol` | `""` | Se muestra cuando la batería se está descargando. | -| `unknown_symbol` | `""` | The symbol shown when the battery state is unknown. | -| `empty_symbol` | `""` | The symbol shown when the battery state is empty. | -| `format` | `"[$symbol$percentage]($style) "` | El formato del módulo. | -| `display` | [ver aquí](#battery-display) | Display threshold and style for the module. | -| `disabled` | `false` | Disables the `battery` module. | +| Opción | Por defecto | Descripción | +| -------------------- | --------------------------------- | ------------------------------------------------------------------------ | +| `full_symbol` | `""` | Se muestra cuando la batería está cargada. | +| `charging_symbol` | `""` | Se muestra cuando la batería se está cargando. | +| `discharging_symbol` | `""` | Se muestra cuando la batería se está descargando. | +| `unknown_symbol` | `""` | El símbolo que se muestra cuando el estado de la batería es desconocido. | +| `empty_symbol` | `""` | El símbolo que se muestra cuando el estado de la batería está vacío. | +| `format` | `"[$symbol$percentage]($style) "` | El formato del módulo. | +| `display` | [ver aquí](#battery-display) | Define cuándo mostrar el indicador y el estilo. | +| `disabled` | `false` | Desactiva el módulo `battery`. | ### Ejemplo @@ -329,7 +329,7 @@ discharging_symbol = "💀" ### Indicador de batería -The `display` configuration option is used to define when the battery indicator should be shown (threshold) and what it looks like (style). If no `display` is provided. El valor por defecto es el siguiente: +La configuración de la opción `display` es usada para definir cuándo se debe mostrar el indicador de batería y cómo debe mostrarse. Si no se provee ningún valor para `display` El valor por defecto es el siguiente: ```toml [[battery.display]] @@ -339,12 +339,12 @@ style = "bold red" #### Opciones -The `display` option is an array of the following table. +La opción `display` es un array de la siguiente tabla. -| Opción | Descripción | -| ----------- | ----------------------------------------------- | -| `threshold` | The upper bound for the display option. | -| `style` | The style used if the display option is in use. | +| Opción | Descripción | +| ----------- | --------------------------------------------------------------- | +| `threshold` | El umbral para la opción de visualización. | +| `style` | El estilo usado cuando si la opción <0>display está activa. | #### Ejemplo @@ -363,30 +363,30 @@ style = "bold yellow" ## Character -The `character` module shows a character (usually an arrow) beside where the text is entered in your terminal. +El módulo `character` muestra un carater (normalmente una flecha) tras el texto que introduces en el terminal. -The character will tell you whether the last command was successful or not. It can do this in two ways: +El carácter te dirá si el último comando funcionó o no. Se puede hacer de dos maneras: - Cambiando el color (`red`/`green`) - Cambiando la forma (`.`/`✖`) -By default it only changes color. If you also want to change it's shape take a look at [this example](#with-custom-error-shape). +Por defecto sólo cambia el color. Si también se quiere cambiar su forma, ver [este ejemplo](#with-custom-error-shape). ### Opciones -| Opción | Por defecto | Descripción | -| ---------------- | ------------------- | -------------------------------------------------------------------------------- | -| `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. | -| `vicmd_symbol` | `"[❮](bold green)"` | The format string used before the text input if the shell is in vim normal mode. | -| `disabled` | `false` | Disables the `character` module. | +| Opción | Por defecto | Descripción | +| ---------------- | ------------------- | ------------------------------------------------------------------------------------------------------- | +| `format` | `"$symbol "` | La cadena de formato usada antes de la entrada de texto. | +| `success_symbol` | `"[❯](bold green)"` | La cadena de formato usada antes de la entrada de texto si el comando anterior tuvo éxito. | +| `error_symbol` | `"[❯](bold red)"` | La cadena de formato usada antes de la entrada de texto si el comando anterior falló. | +| `vicmd_symbol` | `"[❮](bold green)"` | El cadena de formato antes de la entrada de texto si el intérprete de comandos está en modo vim normal. | +| `disabled` | `false` | Desactiva el módulo `character`. | ### Variables -| Variable | Ejemplo | Descripción | -| -------- | ------- | --------------------------------------------------------------------- | -| symbol | | A mirror of either `success_symbol`, `error_symbol` or `vicmd_symbol` | +| Variable | Ejemplo | Descripción | +| -------- | ------- | -------------------------------------------------------------- | +| symbol | | Un espejo de `success_symbol`, `error_symbol` o `vicmd_symbol` | ### Ejemplos @@ -428,18 +428,18 @@ The `cmake` module shows the currently installed version of CMake if any of the ### Opciones -| Opción | Por defecto | Descripción | -| ---------- | ---------------------------------- | -------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | -| `symbol` | `"喝 "` | The symbol used before the version of cmake. | -| `style` | `"bold blue"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `cmake` module. | +| Opción | Por defecto | Descripción | +| ---------- | ---------------------------------- | ---------------------------------------------- | +| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | +| `symbol` | `"喝 "` | El símbolo usado antes de la versión de cmake. | +| `style` | `"bold blue"` | El estilo del módulo. | +| `disabled` | `false` | Desactiva el módulo `cmake`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | --------- | -------------------------------------- | -| version | `v3.17.3` | The version of cmake | +| version | `v3.17.3` | La versión de cmake | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -447,40 +447,40 @@ The `cmake` module shows the currently installed version of CMake if any of the ## Tiempo de Ejecución -The `cmd_duration` module shows how long the last command took to execute. The module will be shown only if the command took longer than two seconds, or the `min_time` config value, if it exists. +El módulo `cmd_duration` muestra cuánto tiempo tardó el último comando en ejecutarse. El módulo se mostrará solo si el comando llevó dos segundos o más, o el valor de `min_time`, si existe. -::: warning Do not hook the DEBUG trap in Bash +::: warning No utilizar DEBUG en Bash -If you are running Starship in `bash`, do not hook the `DEBUG` trap after running `eval $(starship init $0)`, or this module **will** break. +Si estás usando Starship con `bash`, no uses `DEBUG` después de ejecutar `eval $(starship init $0)`, o el módulo **se romperá**. ::: -Bash users who need preexec-like functionality can use [rcaloras's bash_preexec framework](https://github.com/rcaloras/bash-preexec). Simply define the arrays `preexec_functions` and `precmd_functions` before running `eval $(starship init $0)`, and then proceed as normal. +Los usuarios de bash que necesiten la funcionalidad preexec-like pueden usar el framework rcaloras's bash_preexec. Simplemente define los arrays preexec_functions y precmd_functions antes de ejecutar eval $(starship init $0), y continúa con normalidad. Basta con definir los arrays `preexec_functions` y `precmd_functions` antes de ejecutar `eval $(starship init $0)`, y luego proceder como siempre. ### Opciones -| Opción | Por defecto | Descripción | -| -------------------- | ----------------------------- | ---------------------------------------------------------- | -| `min_time` | `2_000` | Shortest duration to show time for (in milliseconds). | -| `show_milliseconds` | `false` | Show milliseconds in addition to seconds for the duration. | -| `format` | `"took [$duration]($style) "` | El formato del módulo. | -| `style` | `"bold yellow"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `cmd_duration` module. | -| `show_notifications` | `false` | Show desktop notifications when command completes. | -| `min_time_to_notify` | `45_000` | Shortest duration for notification (in milliseconds). | +| Opción | Por defecto | Descripción | +| -------------------- | ----------------------------- | --------------------------------------------------------------------- | +| `min_time` | `2_000` | Duración mínima para mostrar el tiempo de ejecución (en milisegundos) | +| `show_milliseconds` | `false` | Muestra la duración con precisión en milisegundos. | +| `format` | `"took [$duration]($style) "` | El formato del módulo. | +| `style` | `"bold yellow"` | El estilo del módulo. | +| `disabled` | `false` | Desactiva el módulo `cmd_duration`. | +| `show_notifications` | `false` | Muestra notificaciones de escritorio cuando se complete el comando. | +| `min_time_to_notify` | `45_000` | Shortest duration for notification (in milliseconds). | ::: tip -Showing desktop notifications requires starship to be built with `rust-notify` support. You check if your starship supports notifications by running `STARSHIP_LOG=debug starship module cmd_duration -d 60000` when `show_notifications` is set to `true`. +Mostrar notificaciones de escritorio requiere que se construya starship con soporte de `rust-notify`. Comprueba si tu Starship soporta notificaciones ejecutando `STARSHIP_LOG=debug starship module cmd_duration -d 60000` cuando `show_notifications` está establecido en `true`. ::: ### Variables -| Variable | Ejemplo | Descripción | -| --------- | -------- | --------------------------------------- | -| duration | `16m40s` | The time it took to execute the command | -| style\* | | Refleja el valor de la opción `style` | +| Variable | Ejemplo | Descripción | +| --------- | -------- | ------------------------------------------ | +| duration | `16m40s` | El tiempo que tardó en ejecutar el comando | +| style\* | | Refleja el valor de la opción `style` | \*: Esta variable sólo puede ser usada como parte de una cadena de estilo @@ -496,30 +496,30 @@ format = "underwent [$duration](bold yellow)" ## Conda -The `conda` module shows the current conda environment, if `$CONDA_DEFAULT_ENV` is set. +El módulo `conda` muestra el actual entorno conda, si la variable `$CONDA_DEFAULT_ENV` existe. ::: tip -This does not suppress conda's own prompt modifier, you may want to run `conda config --set changeps1 False`. +Esto no modifica el propio símbolo de sistema de conda. En caso de querer suprimirlo, ejecuta `conda config --set changeps1 False`. ::: ### Opciones -| Opción | Por defecto | Descripción | -| ------------------- | -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `truncation_length` | `1` | The number of directories the environment path should be truncated to, if the environment was created via `conda create -p [path]`. `0` means no truncation. Also see the [`directory`](#directory) module. | -| `symbol` | `"🅒 "` | The symbol used before the environment name. | -| `style` | `"bold green"` | El estilo del módulo. | -| `format` | `"via [$symbol$environment]($style) "` | El formato del módulo. | -| `ignore_base` | `true` | Ignores `base` environment when activated. | -| `disabled` | `false` | Disables the `conda` module. | +| Opción | Por defecto | Descripción | +| ------------------- | -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `truncation_length` | `1` | El número de directorios a los que se debe truncar la variable de entorno, si el entorno fue creado usando `conda create -p [path]`. `0` significa sin truncamiento. Mirar también el módulo [`directory`](#directory). | +| `symbol` | `"🅒 "` | El símbolo usado antes del nombre del entorno. | +| `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. | +| `disabled` | `false` | Desactiva el módulo `conda`. | ### Variables | Variable | Ejemplo | Descripción | | ----------- | ------------ | -------------------------------------- | -| environment | `astronauts` | The current conda environment | +| environment | `astronauts` | El entorno conda actual | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -536,25 +536,25 @@ format = "[$symbol$environment](dimmed green) " ## Crystal -The `crystal` module shows the currently installed version of Crystal. El módulo se muestra si algunas de las siguientes condiciones se cumplen: +El módulo `crystal` muestra la versión actual de Crystal. El módulo se muestra si algunas de las siguientes condiciones se cumplen: - El directorio actual contiene un fichero `shard.yml` - El directorio actual contiene un fichero `.cr` ### Opciones -| Opción | Por defecto | Descripción | -| ---------- | ---------------------------------- | --------------------------------------------------------- | -| `symbol` | `"🔮 "` | The symbol used before displaying the version of crystal. | -| `style` | `"bold red"` | El estilo del módulo. | -| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | -| `disabled` | `false` | Disables the `crystal` module. | +| Opción | Por defecto | Descripción | +| ---------- | ---------------------------------- | --------------------------------------------- | +| `symbol` | `"🔮 "` | Símbolo usado antes de la versión de Crystal. | +| `style` | `"bold red"` | El estilo del módulo. | +| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | +| `disabled` | `false` | Desactiva el módulo `crystal`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | --------- | -------------------------------------- | -| version | `v0.32.1` | The version of `crystal` | +| version | `v0.32.1` | La versión de `crystal` | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -571,7 +571,7 @@ format = "via [✨ $version](bold blue) " ## Dart -The `dart` module shows the currently installed version of Dart. El módulo se muestra si algunas de las siguientes condiciones se cumplen: +El módulo `dart` muestra la versión actualmente instalada de Dart. El módulo se muestra si algunas de las siguientes condiciones se cumplen: - El directorio actual contiene un archivo con la extensión `.dart` - El directorio actual contiene un directorio `.dart_tool` @@ -579,18 +579,18 @@ The `dart` module shows the currently installed version of Dart. El módulo se m ### Opciones -| Opción | Por defecto | Descripción | -| ---------- | ---------------------------------- | ----------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | -| `symbol` | `"🎯 "` | A format string representing the symbol of Dart | -| `style` | `"bold blue"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `dart` module. | +| Opción | Por defecto | Descripción | +| ---------- | ---------------------------------- | ------------------------------------------------------- | +| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | +| `symbol` | `"🎯 "` | Una cadena de formato que representa el símbolo de Dart | +| `style` | `"bold blue"` | El estilo del módulo. | +| `disabled` | `false` | Desactiva el módulo `dart`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | -------- | -------------------------------------- | -| version | `v2.8.4` | The version of `dart` | +| version | `v2.8.4` | La versión de `dart` | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -607,35 +607,35 @@ format = "via [🔰 $version](bold red) " ## Directory -The `directory` module shows the path to your current directory, truncated to three parent folders. Your directory will also be truncated to the root of the git repo that you're currently in. +El módulo `directory` muestra la ruta hasta el directorio actual, mostrando tres directorios padre como máximo. Tu directorio se truncará a la raíz del repositorio git en el que estés. -When using the fish style pwd 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. +Cuando usas el estilo fish de la opción pwd, en lugar de ocultar la ruta truncada, verás una versión acortada del nombre de cada directorio basada en el número que activa la opción. -For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, and the option set to `1`. You will now see `~/D/N/nixpkgs/pkgs`, whereas before it would have been `nixpkgs/pkgs`. +Por ejemplo, dado `~/Dev/Nix/nixpkgs/pkgs` donde `nixpkgs` es la raíz del repositorio y el valor de la opción es `1`. En ese caso, verás `~/D/N/nixpkgs/pkgs`, cuando antes hubiera sido `nixpkgs/pkgs`. ### Opciones -| Opción | Por defecto | Descripción | -| ------------------- | -------------------------------------------------- | -------------------------------------------------------------------------------- | -| `truncation_length` | `3` | The number of parent folders that the current directory should be truncated to. | -| `truncate_to_repo` | `true` | Whether or not to truncate to the root of the git repo that you're currently in. | -| `format` | `"[$path]($style)[$read_only]($read_only_style) "` | El formato del módulo. | -| `style` | `"bold cyan"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `directory` module. | -| `read_only` | `"🔒"` | The symbol indicating current directory is read only. | -| `read_only_style` | `"red"` | The style for the read only symbol. | -| `truncation_symbol` | `""` | The symbol to prefix to truncated paths. eg: "…/" | +| Opción | Por defecto | Descripción | +| ------------------- | -------------------------------------------------- | ------------------------------------------------------------------------------ | +| `truncation_length` | `3` | El número de directorios padre a los que se debe truncar el directorio actual. | +| `truncate_to_repo` | `true` | Trunca o no hasta la raíz del repositorio git en el que estés. | +| `format` | `"[$path]($style)[$read_only]($read_only_style) "` | El formato del módulo. | +| `style` | `"bold cyan"` | El estilo del módulo. | +| `disabled` | `false` | Desactiva el módulo `directory`. | +| `read_only` | `"🔒"` | El símbolo que indica si el directorio actual es de sólo lectura. | +| `read_only_style` | `"red"` | El estilo para el símbolo de sólo lectura. | +| `truncation_symbol` | `""` | El símbolo a prefijar a las rutas truncadas. ej: "…/" |
-This module has a few advanced configuration options that control how the directory is displayed. +Este módulo tiene algunas opciones avanzadas de configuración que controlan cómo se muestra el directorio. -| Advanced Option | Por defecto | Descripción | -| --------------------------- | ----------- | ---------------------------------------------------------------------------------------- | -| `substitutions` | | A table of substitutions to be made to the path. | -| `fish_style_pwd_dir_length` | `0` | The number of characters to use when applying fish shell pwd path logic. | -| `use_logical_path` | `true` | Displays the logical path provided by the shell (`PWD`) instead of the path from the OS. | +| Opciones avanzadas | Por defecto | Descripción | +| --------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------- | +| `substitutions` | | Una tabla de sustituciones que se deben hacer a la ruta. | +| `fish_style_pwd_dir_length` | `0` | El número de caracteres a usar al aplicar la lógica de ruta pwd de la shell de fish. | +| `use_logical_path` | `true` | Muestra la ruta lógica proporcionada por el intérprete de comandos (`PWD`) en lugar de la ruta del sistema operativo. | -`substitutions` allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories (i.e. Java). Note that this will disable the fish style PWD. +`substitutions` permite definir reemplazos arbitrarios para cadenas literales que ocurren en la ruta, por ejemplo prefijos largos de red o directorios de desarrollo (p. ej. Java). Ten en cuenta que esto desactivará el estilo PWD de fish. ```toml [directory.substitutions] @@ -643,7 +643,7 @@ For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, an "src/com/long/java/path" = "mypath" ``` -`fish_style_pwd_dir_length` interacts with the standard truncation options in a way that can be surprising at first: if it's non-zero, the components of the path that would normally be truncated are instead displayed with that many characters. For example, the path `/built/this/city/on/rock/and/roll`, which would normally be displayed as as `rock/and/roll`, would be displayed as `/b/t/c/o/rock/and/roll` with `fish_style_pwd_dir_length = 1`--the path components that would normally be removed are displayed with a single character. For `fish_style_pwd_dir_length = 2`, it would be `/bu/th/ci/on/rock/and/roll`. +`fish_style_pwd_dir_length` interactúa con las opciones de truncamiento estándar de una manera que puede sorprenderse primero: si no es cero, los componentes de la ruta que normalmente se truncarían se muestran con esa cantidad de caracteres. Por ejemplo, la ruta `/built/this/city/on/rock/and/roll`, que normalmente se mostraría como `rock/and/roll`, se mostraría como `/b/t/c/o/rock/and/roll` con `fish_style_pwd_dir_length = 1`--los componentes de ruta que normalmente se eliminarían se muestran con un solo carácter. Para `fish_style_pwd_dir_length = 2`, sería `/bu/th/ci/on/rock/and/roll`.
@@ -651,7 +651,7 @@ For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, an | Variable | Ejemplo | Descripción | | --------- | --------------------- | ------------------------------------- | -| path | `"D:/Projects"` | The current directory path | +| path | `"D:/Projects"` | La ruta de directorio actual | | style\* | `"black bold dimmed"` | Refleja el valor de la opción `style` | \*: Esta variable sólo puede ser usada como parte de una cadena de estilo @@ -668,23 +668,23 @@ truncation_symbol = "…/" ## Docker Context -The `docker_context` module shows the currently active [Docker context](https://docs.docker.com/engine/context/working-with-contexts/) if it's not set to `default`. +El módulo `docker_context` muestra el [Docker context](https://docs.docker.com/engine/context/working-with-contexts/) activo si no está a `default`. ### Opciones -| Opción | Por defecto | Descripción | -| ----------------- | ---------------------------------- | --------------------------------------------------------------------------------------- | -| `format` | `"via [$symbol$context]($style) "` | El formato del módulo. | -| `symbol` | `"🐳 "` | The symbol used before displaying the Docker context. | -| `style` | `"blue bold"` | El estilo del módulo. | -| `only_with_files` | `false` | Only show when there's a `docker-compose.yml` or `Dockerfile` in the current directory. | -| `disabled` | `true` | Disables the `docker_context` module. | +| Opción | Por defecto | Descripción | +| ----------------- | ---------------------------------- | -------------------------------------------------------------------------------------------------- | +| `format` | `"via [$symbol$context]($style) "` | El formato del módulo. | +| `symbol` | `"🐳 "` | El símbolo usado antes de mostrar el contexto de Docker. | +| `style` | `"blue bold"` | El estilo del módulo. | +| `only_with_files` | `false` | Solo lo muestra cuando hay un archivo `docker-compose.yml` o `Dockerfile` en el directorio actual. | +| `disabled` | `true` | Desactiva el módulo `docker_context`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | -------------- | -------------------------------------- | -| context | `test_context` | The current docker context | +| context | `test_context` | El contexto actual de docker | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -701,9 +701,9 @@ format = "via [🐋 $context](blue bold)" ## Dotnet -The `dotnet` module shows the relevant version of the .NET Core SDK for the current directory. If the SDK has been pinned in the current directory, the pinned version is shown. Otherwise the module shows the latest installed version of the SDK. +El módulo `dotnet` muestra la versión usada de .NET Core SDK para el directorio actual. Si el SDK ha sido anclado en el directorio actual, se mostrará la versión fijada. De lo contrario, el módulo muestra la última versión instalada del SDK. -This module will only be shown in your prompt when one or more of the following files are present in the current directory: +Este módulo solo se mostrará en tu mensaje cuando uno o más de los siguientes archivos estén presentes en el directorio actual: - `global.json` - `project.json` @@ -715,30 +715,30 @@ This module will only be shown in your prompt when one or more of the following - `*.fsproj` - `*.xproj` -You'll also need the .NET Core SDK installed in order to use it correctly. +También necesitará tener instalado .NET Core SDK para poder usarlo correctamente. -Internally, this module uses its own mechanism for version detection. Typically it is twice as fast as running `dotnet --version`, but it may show an incorrect version if your .NET project has an unusual directory layout. If accuracy is more important than speed, you can disable the mechanism by setting `heuristic = false` in the module options. +Internamente, este módulo utiliza su propio mecanismo para la detección de versiones. Normalmente es el doble de rápido que ejecutar `dotnet --version`, pero puede mostrar una versión incorrecta si tu proyecto .NET tiene un diseño de directorio inusual. Si la precisión es más importante que la velocidad, puede desactivar el mecanismo estableciendo `heuristic = false` en las opciones del módulo. -The module will also show the Target Framework Moniker () when there is a csproj file in the current directory. +El módulo también mostrará el Target Framework Moniker ([https://docs.microsoft. om/es/dotnet/standard/frameworks#supported-target-framework-versions](https://docs.microsoft.com/en-us/dotnet/standard/frameworks#supported-target-framework-versions)) cuando exista un archivo csproj en el directorio actual. ### Opciones -| Opción | Por defecto | Descripción | -| ----------- | --------------------------------------- | -------------------------------------------------------- | -| `format` | `"[$symbol$version( 🎯 $tfm)]($style) "` | El formato del módulo. | -| `symbol` | `"•NET "` | The symbol used before displaying the version of dotnet. | -| `heuristic` | `true` | Use faster version detection to keep starship snappy. | -| `style` | `"bold blue"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `dotnet` module. | +| Opción | Por defecto | Descripción | +| ----------- | --------------------------------------- | ------------------------------------------------------------------------- | +| `format` | `"[$symbol$version( 🎯 $tfm)]($style) "` | El formato del módulo. | +| `symbol` | `"•NET "` | Símbolo usado antes de mostrar la versión de .NET | +| `heuristic` | `true` | Usa una detección de versiones más rápida para mantener a starship veloz. | +| `style` | `"bold blue"` | El estilo del módulo. | +| `disabled` | `false` | Deshabilita el módulo `dotnet`. | ### Variables -| Variable | Ejemplo | Descripción | -| --------- | ---------------- | ------------------------------------------------------------------ | -| version | `v3.1.201` | The version of `dotnet` sdk | -| tfm | `netstandard2.0` | The Target Framework Moniker that the current project is targeting | -| symbol | | Refleja el valor de la opción `symbol` | -| style\* | | Refleja el valor de la opción `style` | +| Variable | Ejemplo | Descripción | +| --------- | ---------------- | --------------------------------------------------------------- | +| version | `v3.1.201` | La version del sdk de `dotnet` | +| tfm | `netstandard2.0` | El Target Framework Moniker al que se dirige el proyecto actual | +| symbol | | Refleja el valor de la opción `symbol` | +| style\* | | Refleja el valor de la opción `style` | \*: Esta variable sólo puede ser usada como parte de una cadena de estilo @@ -755,25 +755,25 @@ heuristic = false ## Elixir -The `elixir` module shows the currently installed version of Elixir and Erlang/OTP. El módulo se muestra si algunas de las siguientes condiciones se cumplen: +El módulo `elixir` muestra la version instalada actualmente de Elixir y Erlang/OTP. El módulo se muestra si algunas de las siguientes condiciones se cumplen: - El directorio actual contiene un archivo `mix.exs`. ### Opciones -| Opción | Por defecto | Descripción | -| ---------- | --------------------------------------------------------- | --------------------------------------------------------------- | -| `symbol` | `"💧 "` | The symbol used before displaying the version of Elixir/Erlang. | -| `style` | `"bold purple"` | El estilo del módulo. | -| `format` | `'via [$symbol$version \(OTP $otp_version\)]($style) '` | The format for the module elixir. | -| `disabled` | `false` | Disables the `elixir` module. | +| Opción | Por defecto | Descripción | +| ---------- | --------------------------------------------------------- | -------------------------------------------------------------- | +| `symbol` | `"💧 "` | El símbolo usado antes de mostrar la version de Elixir/Erlang. | +| `style` | `"bold purple"` | El estilo del módulo. | +| `format` | `'via [$symbol$version \(OTP $otp_version\)]($style) '` | El formato para el módulo elixir. | +| `disabled` | `false` | Desactiva el módulo `elixir`. | ### Variables | Variable | Ejemplo | Descripción | | ----------- | ------- | -------------------------------------- | -| version | `v1.10` | The version of `elixir` | -| otp_version | | The otp version of `elixir` | +| version | `v1.10` | La version de `elixir` | +| otp_version | | La version de otp de `elixir` | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -790,7 +790,7 @@ symbol = "🔮 " ## Elm -The `elm` module shows the currently installed version of Elm. El módulo se muestra si algunas de las siguientes condiciones se cumplen: +El módulo `elm` muestra la versión actualmente instalada de Elm. El módulo se muestra si algunas de las siguientes condiciones se cumplen: - El directorio actual contiene un fichero `elm.json` - El directorio actual contiene un fichero `elm-package.json` @@ -800,18 +800,18 @@ The `elm` module shows the currently installed version of Elm. El módulo se mue ### Opciones -| Opción | Por defecto | Descripción | -| ---------- | ---------------------------------- | ----------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | -| `symbol` | `"🌳 "` | A format string representing the symbol of Elm. | -| `style` | `"cyan bold"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `elm` module. | +| Opción | Por defecto | Descripción | +| ---------- | ---------------------------------- | ------------------------------------------------------- | +| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | +| `symbol` | `"🌳 "` | Una cadena de formato que representa el símbolo de Elm. | +| `style` | `"cyan bold"` | El estilo del módulo. | +| `disabled` | `false` | Desactiva el módulo `elm`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | --------- | -------------------------------------- | -| version | `v0.19.1` | The version of `elm` | +| version | `v0.19.1` | La versión de `elm` | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -828,28 +828,28 @@ format = "via [ $version](cyan bold) " ## Variable de entorno -The `env_var` module displays the current value of a selected environment variable. The module will be shown only if any of the following conditions are met: +El módulo `env_var` muestra el valor actual de una variable de entorno seleccionada. El módulo se mostrará sólo si se cumplen cualquiera de las siguientes condiciones: - La opción de configuración de `variable` coincide con una variable de entorno existente - La opción de configuración de `variable` no está definida, pero la opción de configuración `predeterminada` se encuentra ### Opciones -| Opción | Por defecto | Descripción | -| ---------- | ------------------------------ | ---------------------------------------------------------------------------- | -| `symbol` | | The symbol used before displaying the variable value. | -| `variable` | | The environment variable to be displayed. | -| `default` | | The default value to be displayed when the selected variable is not defined. | -| `format` | `"with [$env_value]($style) "` | El formato del módulo. | -| `disabled` | `false` | Disables the `env_var` module. | +| Opción | Por defecto | Descripción | +| ------------- | ------------------------------ | -------------------------------------------------------------------------------------- | +| `symbol` | | El símbolo usado antes de mostrar el valor de la variable. | +| `variable` | | La variable de entorno a mostrar. | +| `por defecto` | | El valor por defecto que se mostrará cuando la variable seleccionada no está definida. | +| `format` | `"with [$env_value]($style) "` | El formato del módulo. | +| `disabled` | `false` | Desactiva el módulo `env_var`. | ### Variables -| Variable | Ejemplo | Descripción | -| --------- | ------------------------------------------- | ------------------------------------------ | -| env_value | `Windows NT` (if _variable_ would be `$OS`) | The environment value of option `variable` | -| symbol | | Refleja el valor de la opción `symbol` | -| style\* | `black bold dimmed` | Refleja el valor de la opción `style` | +| Variable | Ejemplo | Descripción | +| --------- | ------------------------------------- | ------------------------------------------- | +| env_value | `Windows NT` (si _variable_ es `$OS`) | El valor de entorno de la opción `variable` | +| symbol | | Refleja el valor de la opción `symbol` | +| style\* | `black bold dimmed` | Refleja el valor de la opción `style` | \*: Esta variable sólo puede ser usada como parte de una cadena de estilo @@ -865,25 +865,25 @@ default = "unknown shell" ## Erlang -The `erlang` module shows the currently installed version of Erlang/OTP. El módulo se muestra si algunas de las siguientes condiciones se cumplen: +El módulo `erlang` muestra la versión instalada de Erlang/OTP. El módulo se muestra si algunas de las siguientes condiciones se cumplen: - El directorio actual contiene un fichero `rebar.config`. - El directorio actual contiene un fichero `erlang.mk`. ### Opciones -| Opción | Por defecto | Descripción | -| ---------- | ---------------------------------- | -------------------------------------------------------- | -| `symbol` | `" "` | The symbol used before displaying the version of erlang. | -| `style` | `"bold red"` | El estilo del módulo. | -| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | -| `disabled` | `false` | Disables the `erlang` module. | +| Opción | Por defecto | Descripción | +| ---------- | ---------------------------------- | ------------------------------------------------------- | +| `symbol` | `" "` | El símbolo usado antes de mostrar la versión de Erlang. | +| `style` | `"bold red"` | El estilo del módulo. | +| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | +| `disabled` | `false` | Desactiva el módulo `erlang`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | --------- | -------------------------------------- | -| version | `v22.1.3` | The version of `erlang` | +| version | `v22.1.3` | La versión de `erlang` | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -900,28 +900,28 @@ format = "via [e $version](bold red) " ## Gcloud -The `gcloud` module shows the current configuration for [`gcloud`](https://cloud.google.com/sdk/gcloud) CLI. This is based on the `~/.config/gcloud/active_config` file and the `~/.config/gcloud/configurations/config_{CONFIG NAME}` file and the `CLOUDSDK_CONFIG` env var. +El módulo `gcloud` muestra la configuración actual para el CLI de [`gcloud`](https://cloud.google.com/sdk/gcloud). Esto se basa en el archivo `~/.config/gcloud/active_config`, el archivo `~/.config/gcloud/configurations/config_{CONFIG NAME}` y la varieble de entorno `CLOUDSDK_CONFIG`. ### Opciones -| Opción | Por defecto | Descripción | -| ---------------- | ------------------------------------------------ | --------------------------------------------------------------- | -| `format` | `'on [$symbol$account(\($region\))]($style) '` | El formato del módulo. | -| `symbol` | `"☁️ "` | The symbol used before displaying the current GCP profile. | -| `region_aliases` | | Table of region aliases to display in addition to the GCP name. | -| `style` | `"bold blue"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `gcloud` module. | +| Opción | Por defecto | Descripción | +| ---------------- | ------------------------------------------------ | ---------------------------------------------------------- | +| `format` | `'on [$symbol$account(\($region\))]($style) '` | El formato del módulo. | +| `symbol` | `"☁️ "` | El símbolo usado antes de mostrar el perfil actual de GCP. | +| `region_aliases` | | Tabla de alias de región a mostrar además del nombre GCP. | +| `style` | `"bold blue"` | El estilo del módulo. | +| `disabled` | `false` | Desactiva el módulo `gcloud`. | ### Variables -| Variable | Ejemplo | Descripción | -| --------- | ----------------- | ------------------------------------------------------------------ | -| region | `us-central1` | The current GCP region | -| account | `foo@example.com` | The current GCP profile | -| project | | The current GCP project | -| active | `default` | The active config name written in `~/.config/gcloud/active_config` | -| symbol | | Refleja el valor de la opción `symbol` | -| style\* | | Refleja el valor de la opción `style` | +| Variable | Ejemplo | Descripción | +| --------- | ----------------- | ----------------------------------------------------------------------------- | +| region | `us-central1` | La región GCP actual | +| account | `foo@example.com` | El perfil actual de GCP | +| project | | El proyecto GCP actual | +| active | `por defecto` | El nombre de configuración activo escrito en `~/.config/gcloud/active_config` | +| symbol | | Refleja el valor de la opción `symbol` | +| style\* | | Refleja el valor de la opción `style` | \*: Esta variable sólo puede ser usada como parte de una cadena de estilo @@ -960,30 +960,30 @@ asia-northeast1 = "an1" ## Git Branch -The `git_branch` module shows the active branch of the repo in your current directory. +El módulo `git_branch` muestra la rama activa del repositorio en su directorio actual. ### Opciones -| Opción | Por defecto | Descripción | -| -------------------- | -------------------------------- | ---------------------------------------------------------------------------------------- | -| `always_show_remote` | `false` | Shows the remote tracking branch name, even if it is equal to the local branch name. | -| `format` | `"on [$symbol$branch]($style) "` | El formato del módulo. Use `"$branch"` to refer to the current branch name. | -| `symbol` | `" "` | A format string representing the symbol of git branch. | -| `style` | `"bold purple"` | El estilo del módulo. | -| `truncation_length` | `2^63 - 1` | Truncates a git branch to X graphemes. | -| `truncation_symbol` | `"…"` | The symbol used to indicate a branch name was truncated. You can use `""` for no symbol. | -| `only_attached` | `false` | Only show the branch name when not in a detached HEAD state. | -| `disabled` | `false` | Disables the `git_branch` module. | +| Opción | Por defecto | Descripción | +| -------------------- | -------------------------------- | ------------------------------------------------------------------------------------------------------- | +| `always_show_remote` | `false` | Muestra el nombre de la rama de seguimiento remoto, incluso si es igual al nombre de la rama local. | +| `format` | `"on [$symbol$branch]($style) "` | El formato del módulo. Use `"$branch"` para referirse al nombre de la rama actual. | +| `symbol` | `" "` | Una cadena de formato que representa el símbolo de la rama git. | +| `style` | `"bold purple"` | El estilo del módulo. | +| `truncation_length` | `2^63 - 1` | Trunca una rama git a X grafemas. | +| `truncation_symbol` | `"…"` | El símbolo usado para indicar que un nombre de rama fue truncado. Puedes usar `""` para ningún símbolo. | +| `only_attached` | `false` | Muestra sólo el nombre de la rama cuando no esté en un estado detached HEAD. | +| `disabled` | `false` | Desactiva el módulo `git_branch`. | ### Variables -| Variable | Ejemplo | Descripción | -| ------------- | -------- | ---------------------------------------------------------------------------------------------------- | -| branch | `master` | The current branch name, falls back to `HEAD` if there's no current branch (e.g. git detached HEAD). | -| remote_name | `origin` | The remote name. | -| remote_branch | `master` | The name of the branch tracked on `remote_name`. | -| symbol | | Refleja el valor de la opción `symbol` | -| style\* | | Refleja el valor de la opción `style` | +| Variable | Ejemplo | Descripción | +| ------------- | -------- | ------------------------------------------------------------------------------------------------------------- | +| branch | `master` | El nombre de la rama actual, regresa a `HEAD` si no hay ninguna rama actual (por ejemplo, git detached HEAD). | +| remote_name | `origin` | The remote name. | +| remote_branch | `master` | The name of the branch tracked on `remote_name`. | +| symbol | | Refleja el valor de la opción `symbol` | +| style\* | | Refleja el valor de la opción `style` | \*: Esta variable sólo puede ser usada como parte de una cadena de estilo @@ -1000,25 +1000,25 @@ truncation_symbol = "" ## Git commit -The `git_commit` module shows the current commit hash and also the tag (if any) of the repo in your current directory. +El módulo `git_commit` muestra el hash de commit actual y también la etiqueta (si existe) del repositorio en su directorio actual. ### Opciones -| Opción | Por defecto | Descripción | -| -------------------- | ------------------------------------------------------ | ----------------------------------------------------- | -| `commit_hash_length` | `7` | The length of the displayed git commit hash. | -| `format` | `"[\\($hash\\)]($style) [\\($tag\\)]($style)"` | El formato del módulo. | -| `style` | `"bold green"` | El estilo del módulo. | -| `only_detached` | `true` | Only show git commit hash when in detached HEAD state | -| `tag_disabled` | `true` | Disables showing tag info in `git_commit` module. | -| `tag_symbol` | `"🏷 "` | Tag symbol prefixing the info shown | -| `disabled` | `false` | Disables the `git_commit` module. | +| Opción | Por defecto | Descripción | +| -------------------- | ------------------------------------------------------ | ---------------------------------------------------------------------------- | +| `commit_hash_length` | `7` | La longitud del hash del commit de git mostrado. | +| `format` | `"[\\($hash\\)]($style) [\\($tag\\)]($style)"` | El formato del módulo. | +| `style` | `"bold green"` | El estilo del módulo. | +| `only_detached` | `true` | Mostrar solo el hash del commit de git cuando esté en estado "detached HEAD" | +| `tag_disabled` | `true` | Deshabilita mostrar información de etiquetas en el módulo `git_commit`. | +| `tag_symbol` | `"🏷 "` | Símbolo de etiqueta prefijando la información mostrada | +| `disabled` | `false` | Desactiva el módulo `git_commit`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | --------- | ------------------------------------- | -| hash | `b703eb3` | The current git commit hash | +| hash | `b703eb3` | El hash actual del commit de git | | style\* | | Refleja el valor de la opción `style` | \*: Esta variable sólo puede ser usada como parte de una cadena de estilo @@ -1035,30 +1035,30 @@ tag_symbol = "🔖 " ## Git state -The `git_state` module will show in directories which are part of a git repository, and where there is an operation in progress, such as: _REBASING_, _BISECTING_, etc. If there is progress information (e.g., REBASING 3/10), that information will be shown too. +El módulo `git_state` se mostrará en directorios que son parte de un repositorio git, y donde hay una operación en curso, tales como: _REBASING_, _BISECTING_, etc. Si hay información de progreso (por ejemplo, REBASING 3/10), esa información será mostrada también. ### Opciones -| Opción | Por defecto | Descripción | -| -------------- | --------------------------------------------------------------- | --------------------------------------------------------------------------------------- | -| `rebase` | `"REBASING"` | A format string displayed when a `rebase` is in progress. | -| `merge` | `"MERGING"` | A format string displayed when a `merge` is in progress. | -| `revert` | `"REVERTING"` | A format string displayed when a `revert` is in progress. | -| `cherry_pick` | `"CHERRY-PICKING"` | A format string displayed when a `cherry-pick` is in progress. | -| `bisect` | `"BISECTING"` | A format string displayed when a `bisect` is in progress. | -| `am` | `"AM"` | A format string displayed when an `apply-mailbox` (`git am`) is in progress. | -| `am_or_rebase` | `"AM/REBASE"` | A format string displayed when an ambiguous `apply-mailbox` or `rebase` is in progress. | -| `style` | `"bold yellow"` | El estilo del módulo. | -| `format` | `'\([$state( $progress_current/$progress_total)]($style)\) '` | El formato del módulo. | -| `disabled` | `false` | Disables the `git_state` module. | +| Opción | Por defecto | Descripción | +| -------------- | --------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | +| `rebase` | `"REBASING"` | Una cadena de formato que se muestra cuando un `rebase` está en progreso. | +| `merge` | `"MERGING"` | Una cadena de formato que se muestra cuando un `merge` está en progreso. | +| `revert` | `"REVERTING"` | Una cadena de formato mostrada cuando un `revert` está en progreso. | +| `cherry_pick` | `"CHERRY-PICKING"` | Una cadena de formato que se muestra cuando un `cherry-pick` está en progreso. | +| `bisect` | `"BISECTING"` | Una cadena de formato que se muestra cuando un `bisect` está en progreso. | +| `am` | `"AM"` | Una cadena de formato que se muestra cuando un `apply-mailbox` (`git am`) está en progeso. | +| `am_or_rebase` | `"AM/REBASE"` | Una cadena de formato que se muestra cuando un ambiguo `apply-builbox` o `rebase` está en progreso. | +| `style` | `"bold yellow"` | El estilo del módulo. | +| `format` | `'\([$state( $progress_current/$progress_total)]($style)\) '` | El formato del módulo. | +| `disabled` | `false` | Desactiva el módulo `git_state`. | ### Variables | Variable | Ejemplo | Descripción | | ---------------- | ---------- | ------------------------------------- | -| state | `REBASING` | The current state of the repo | -| progress_current | `1` | The current operation progress | -| progress_total | `2` | The total operation progress | +| state | `REBASING` | El estado actual del repositorio | +| progress_current | `1` | El progreso de la operación actual | +| progress_total | `2` | El progreso total de la operación | | style\* | | Refleja el valor de la opción `style` | \*: Esta variable sólo puede ser usada como parte de una cadena de estilo @@ -1075,57 +1075,57 @@ cherry_pick = "[🍒 PICKING](bold red)" ## Git status -The `git_status` module shows symbols representing the state of the repo in your current directory. +El módulo `git_status` muestra símbolos que representan el estado del repositorio en su directorio actual. ### Opciones -| Opción | Por defecto | Descripción | -| ------------ | ----------------------------------------------- | ----------------------------------- | -| `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | The default format for `git_status` | -| `conflicted` | `"="` | This branch has merge conflicts. | -| `ahead` | `"⇡"` | The format of `ahead` | -| `behind` | `"⇣"` | The format of `behind` | -| `diverged` | `"⇕"` | The format of `diverged` | -| `untracked` | `"?"` | The format of `untracked` | -| `stashed` | `"$"` | The format of `stashed` | -| `modified` | `"!"` | The format of `modified` | -| `staged` | `"+"` | The format of `staged` | -| `renamed` | `"»"` | The format of `renamed` | -| `deleted` | `"✘"` | The format of `deleted` | -| `style` | `"bold red"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `git_status` module. | +| Opción | Por defecto | Descripción | +| ------------ | ----------------------------------------------- | ---------------------------------------- | +| `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | El formato por defecto para `git_status` | +| `conflicted` | `"="` | Esta rama tiene conflictos de fusión. | +| `ahead` | `"⇡"` | El formato de `ahead` | +| `behind` | `"⇣"` | El formato de `behind` | +| `diverged` | `"⇕"` | El formato de `diverged` | +| `untracked` | `"?"` | El formato de `untracked` | +| `stashed` | `"$"` | El formato de `stashed` | +| `modified` | `"!"` | El formato de `modified` | +| `staged` | `"+"` | El formato de `staged` | +| `renamed` | `"»"` | El formato de `renamed` | +| `deleted` | `"✘"` | El formato de `deleted` | +| `style` | `"bold red"` | El estilo del módulo. | +| `disabled` | `false` | Desactiva el módulo `git_status`. | ### Variables -The following variables can be used in `format`: +Las siguientes variables se pueden utilizar en `format`: -| Variable | Descripción | -| -------------- | --------------------------------------------------------------------------------------------- | -| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$staged$untracked` | -| `ahead_behind` | Displays `diverged` `ahead` or `behind` format string based on the current status of the repo | -| `conflicted` | Displays `conflicted` when this branch has merge conflicts. | -| `untracked` | Displays `untracked` when there are untracked files in the working directory. | -| `stashed` | Displays `stashed` when a stash exists for the local repository. | -| `modified` | Displays `modified` when there are file modifications in the working directory. | -| `staged` | Displays `staged` when a new file has been added to the staging area. | -| `renamed` | Displays `renamed` when a renamed file has been added to the staging area. | -| `deleted` | Displays `deleted` when a file's deletion has been added to the staging area. | -| style\* | Refleja el valor de la opción `style` | +| Variable | Descripción | +| -------------- | -------------------------------------------------------------------------------------------------------- | +| `all_status` | Atajo para `$conflicted$stashed$deleted$renamed$modified$staged$untracked` | +| `ahead_behind` | Muestra la cadena de formato de `diverged` `ahead` o `behind` basado en el estado actual del repositorio | +| `conflicted` | Muestra `conflicted` cuando esta rama tiene conflictos de fusión. | +| `untracked` | Muestra `untracked` cuando hay archivos sin rastrear en el directorio de trabajo. | +| `stashed` | Muestra `stashed` cuando existe un "stash" para el repositorio local. | +| `modified` | Muestra `modified` cuando hay modificaciones de archivo en el directorio de trabajo. | +| `staged` | Muestra `staged` cuando se ha añadido un nuevo archivo al área de "stash". | +| `renamed` | Muestra `renamed` cuando un archivo renombrado ha sido añadido al área de "stash". | +| `deleted` | Muestra `deleted` cuando un archivo ha sido añadido al área de "stash". | +| style\* | Refleja el valor de la opción `style` | \*: Esta variable sólo puede ser usada como parte de una cadena de estilo -The following variables can be used in `diverged`: +Las siguientes variables pueden ser usadas en `diverged`: -| Variable | Descripción | -| -------------- | ---------------------------------------------- | -| `ahead_count` | Number of commits ahead of the tracking branch | -| `behind_count` | Number of commits behind the tracking branch | +| Variable | Descripción | +| -------------- | ------------------------------------------------------- | +| `ahead_count` | Número de commits por delante de la rama de seguimiento | +| `behind_count` | Número de commits detrás de la rama de seguimiento | -The following variables can be used in `conflicted`, `ahead`, `behind`, `untracked`, `stashed`, `modified`, `staged`, `renamed` and `deleted`: +Las siguientes variales pueden ser usadas en `conflicted`, `ahead`, `behind`, `untracked`, `stashed`, `modified`, `staged`, `renamed` and `deleted`: -| Variable | Descripción | -| -------- | ------------------------ | -| `count` | Show the number of files | +| Variable | Descripción | +| -------- | ----------------------------- | +| `count` | Muestra el número de archivos | ### Ejemplo @@ -1145,7 +1145,7 @@ renamed = "👅" deleted = "🗑" ``` -Show ahead/behind count of the branch being tracked +Mostrar el recuento delante/detrás de la rama que está siendo rastreada ```toml # ~/.config/starship.toml @@ -1158,7 +1158,7 @@ behind = "⇣${count}" ## Golang -The `golang` module shows the currently installed version of Golang. El módulo se muestra si algunas de las siguientes condiciones se cumplen: +El módulo `golang` muestra la versión actualmente instalada de Golang. El módulo se muestra si algunas de las siguientes condiciones se cumplen: - El directorio actual contiene un fichero `go.mod` - El directorio actual contiene un fichero `go.sum` @@ -1171,18 +1171,18 @@ The `golang` module shows the currently installed version of Golang. El módulo ### Opciones -| Opción | Por defecto | Descripción | -| ---------- | ---------------------------------- | ---------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | -| `symbol` | `"🐹 "` | A format string representing the symbol of Go. | -| `style` | `"bold cyan"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `golang` module. | +| Opción | Por defecto | Descripción | +| ---------- | ---------------------------------- | ------------------------------------------------------ | +| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | +| `symbol` | `"🐹 "` | Una cadena de formato que representa el símbolo de Go. | +| `style` | `"bold cyan"` | El estilo del módulo. | +| `disabled` | `false` | Desactiva el módulo de `golang`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | --------- | -------------------------------------- | -| version | `v1.12.1` | The version of `go` | +| version | `v1.12.1` | La versión de `go` | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -1199,25 +1199,25 @@ format = "via [🏎💨 $version](bold cyan) " ## Helm -The `helm` module shows the currently installed version of Helm. El módulo se muestra si algunas de las siguientes condiciones se cumplen: +El módulo `helm` muestra la versión instalada de Helm. El módulo se muestra si algunas de las siguientes condiciones se cumplen: - El directorio actual contiene un fichero `helmfile.yaml` - El directorio actual contiene un archivo `Chart.yaml` ### Opciones -| Opción | Por defecto | Descripción | -| ---------- | ---------------------------------- | ------------------------------------------------ | -| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | -| `symbol` | `"⎈ "` | A format string representing the symbol of Helm. | -| `style` | `"bold white"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `helm` module. | +| Opción | Por defecto | Descripción | +| ---------- | ---------------------------------- | -------------------------------------------------------- | +| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | +| `symbol` | `"⎈ "` | Una cadena de formato que representa el símbolo de Helm. | +| `style` | `"bold white"` | El estilo del módulo. | +| `disabled` | `false` | Desactiva el módulo `helm`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | -------- | -------------------------------------- | -| version | `v3.1.1` | The version of `helm` | +| version | `v3.1.1` | La versión de `helm` | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -1234,17 +1234,17 @@ format = "via [⎈ $version](bold white) " ## Hostname -The `hostname` module shows the system hostname. +El módulo `hostname` muestra el nombre de host del sistema. ### Opciones -| Opción | Por defecto | Descripción | -| ---------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | -| `ssh_only` | `true` | Only show hostname when connected to an SSH session. | -| `trim_at` | `"."` | String that the hostname is cut off at, after the first match. `"."` will stop after the first dot. `""` will disable any truncation | -| `format` | `"[$hostname]($style) in "` | El formato del módulo. | -| `style` | `"bold dimmed green"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `hostname` module. | +| Opción | Por defecto | Descripción | +| ---------- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `ssh_only` | `true` | Mostrar sólo el nombre de host cuando esté conectado a una sesión SSH. | +| `trim_at` | `"."` | Cadena en la que el nombre de host se corta, después de la primera partida. `"."` se detendrá después del primer punto. `""` deshabilitará cualquier truncamiento | +| `format` | `"[$hostname]($style) in "` | El formato del módulo. | +| `style` | `"bold dimmed green"` | El estilo del módulo. | +| `disabled` | `false` | Desactiva el módulo `hostname`. | ### Variables @@ -1269,25 +1269,25 @@ disabled = false ## Java -The `java` module shows the currently installed version of Java. El módulo se muestra si algunas de las siguientes condiciones se cumplen: +El módulo `java` muestra la versión actualmente instalada de Java. El módulo se muestra si algunas de las siguientes condiciones se cumplen: - El directorio actual contiene un archivo `pom.xml`, `build.gradle.kts`, `build.sbt`, `.java-version`, `.deps.edn`, `project.clj`, o `build.boot` - El directorio actual contiene un archivo con la extensión `.java`, `.class`, `.gradle` o `.jar`, `.clj` o `.cljc` ### Opciones -| Opción | Por defecto | Descripción | -| ---------- | -------------------------------------- | ----------------------------------------------- | -| `format` | `"via [${symbol}${version}]($style) "` | El formato del módulo. | -| `symbol` | `"☕ "` | A format string representing the symbol of Java | -| `style` | `"red dimmed"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `java` module. | +| Opción | Por defecto | Descripción | +| ---------- | -------------------------------------- | ------------------------------------------------------- | +| `format` | `"via [${symbol}${version}]($style) "` | El formato del módulo. | +| `symbol` | `"☕ "` | Una cadena de formato que representa el símbolo de Java | +| `style` | `"red dimmed"` | El estilo del módulo. | +| `disabled` | `false` | Desactiva el módulo `java`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | ------- | -------------------------------------- | -| version | `v14` | The version of `java` | +| version | `v14` | La versión de `java` | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -1304,23 +1304,23 @@ symbol = "🌟 " ## Jobs -The `jobs` module shows the current number of jobs running. The module will be shown only if there are background jobs running. The module will show the number of jobs running if there is more than 1 job, or more than the `threshold` config value, if it exists. +El módulo `jobs` muestra el número actual de tareas en ejecución. El módulo se mostrará sólo si hay tareas en segundo plano ejecutándose. El módulo mostrará el número de tareas en ejecución si hay más de 1 tarea o más que el valor configurado de `threshold`, si existe. ### Opciones -| Opción | Por defecto | Descripción | -| ----------- | ----------------------------- | ------------------------------------------------ | -| `threshold` | `1` | Show number of jobs if exceeded. | -| `format` | `"[$symbol$number]($style) "` | El formato del módulo. | -| `symbol` | `"✦"` | A format string representing the number of jobs. | -| `style` | `"bold blue"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `jobs` module. | +| Opción | Por defecto | Descripción | +| ----------- | ----------------------------- | --------------------------------------------------------- | +| `threshold` | `1` | Muestra el número de tareas si se exceden. | +| `format` | `"[$symbol$number]($style) "` | El formato del módulo. | +| `symbol` | `"✦"` | Una cadena de formato que representa el número de tareas. | +| `style` | `"bold blue"` | El estilo del módulo. | +| `disabled` | `false` | Desactiva el módulo `jobs`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | ------- | -------------------------------------- | -| number | `1` | The number of jobs | +| number | `1` | El número de tareas | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -1338,7 +1338,7 @@ threshold = 4 ## Julia -The `julia` module shows the currently installed version of Julia. El módulo se muestra si algunas de las siguientes condiciones se cumplen: +El módulo `Julia` muestra la versión actualmente instalada de Julia. El módulo se muestra si algunas de las siguientes condiciones se cumplen: - El directorio actual contiene un archivo `Project.toml` - El directorio actual contiene un archivo `Manifest.toml` @@ -1346,18 +1346,18 @@ The `julia` module shows the currently installed version of Julia. El módulo se ### Opciones -| Opción | Por defecto | Descripción | -| ---------- | ---------------------------------- | ------------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | -| `symbol` | `"ஃ "` | A format string representing the symbol of Julia. | -| `style` | `"bold purple"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `julia` module. | +| Opción | Por defecto | Descripción | +| ---------- | ---------------------------------- | --------------------------------------------------------- | +| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | +| `symbol` | `"ஃ "` | Una cadena de formato que representa el símbolo de Julia. | +| `style` | `"bold purple"` | El estilo del módulo. | +| `disabled` | `false` | Desactiva el módulo `julia`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | -------- | -------------------------------------- | -| version | `v1.4.0` | The version of `julia` | +| version | `v1.4.0` | La versión de `julia` | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -1417,32 +1417,32 @@ kotlin_binary = "kotlinc" ## Kubernetes -Displays the current Kubernetes context name and, if set, the namespace from the kubeconfig file. The namespace needs to be set in the kubeconfig file, this can be done via `kubectl config set-context starship-cluster --namespace astronaut`. If the `$KUBECONFIG` env var is set the module will use that if not it will use the `~/.kube/config`. +Muestra el nombre del contexto actual de Kubernetes y, si se establece, el espacio de nombres del archivo kubeconfig. El espacio de nombres necesita establecerse en el archivo kubeconfig, esto puede hacerse mediante `kubectl config set-context starship-cluster --namespace astronaut`. Si se establece la variable de entorno `$KUBECONFIG`, el módulo usará eso si no usará el `~/.kube/config`. ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. +Este módulo está deshabilitado por defecto. Para activarlo, establece `disabled` a `false` en tu archivo de configuración. ::: ### Opciones -| Opción | Por defecto | Descripción | -| ----------------- | ---------------------------------------------------- | --------------------------------------------------------------------- | -| `symbol` | `"☸ "` | A format string representing the symbol displayed before the Cluster. | -| `format` | `'[$symbol$context( \($namespace\))]($style) in '` | El formato del módulo. | -| `style` | `"cyan bold"` | El estilo del módulo. | -| `context_aliases` | | Table of context aliases to display. | -| `disabled` | `true` | Disables the `kubernetes` module. | +| Opción | Por defecto | Descripción | +| ----------------- | ---------------------------------------------------- | --------------------------------------------------------------------------- | +| `symbol` | `"☸ "` | Una cadena de formato que representa el símbolo mostrado antes del Cluster. | +| `format` | `'[$symbol$context( \($namespace\))]($style) in '` | El formato del módulo. | +| `style` | `"cyan bold"` | El estilo del módulo. | +| `context_aliases` | | Tabla de alias de contexto a mostrar. | +| `disabled` | `true` | Desactiva el módulo `kubernetes`. | ### Variables -| Variable | Ejemplo | Descripción | -| --------- | -------------------- | ---------------------------------------- | -| context | `starship-cluster` | The current kubernetes context | -| namespace | `starship-namespace` | If set, the current kubernetes namespace | -| symbol | | Refleja el valor de la opción `symbol` | -| style\* | | Refleja el valor de la opción `style` | +| Variable | Ejemplo | Descripción | +| --------- | -------------------- | ----------------------------------------------------------- | +| context | `starship-cluster` | El contexto actual de kubernetes | +| namespace | `starship-namespace` | Si se establece, el espacio de nombres actual de kubernetes | +| symbol | | Refleja el valor de la opción `symbol` | +| style\* | | Refleja el valor de la opción `style` | \*: Esta variable sólo puede ser usada como parte de una cadena de estilo @@ -1458,15 +1458,15 @@ disabled = false "dev.local.cluster.k8s" = "dev" ``` -## Line Break +## Salto de línea -The `line_break` module separates the prompt into two lines. +El módulo `line_break` separa el indicador en dos líneas. ### Opciones -| Opción | Por defecto | Descripción | -| ---------- | ----------- | ------------------------------------------------------------------ | -| `disabled` | `false` | Disables the `line_break` module, making the prompt a single line. | +| Opción | Por defecto | Descripción | +| ---------- | ----------- | ------------------------------------------------------------------------------- | +| `disabled` | `false` | Deshabilita el módulo `line_break`, haciendo que el mensaje sea una sola línea. | ### Ejemplo @@ -1479,27 +1479,27 @@ disabled = true ## Lua -The `lua` module shows the currently installed version of Lua. El módulo se muestra si algunas de las siguientes condiciones se cumplen: +El módulo `lua` muestra la versión instalada de Lua. El módulo se muestra si algunas de las siguientes condiciones se cumplen: -- The current directory contains a `.lua-version` file -- The current directory contains a `lua` directory -- The current directory contains a file with the `.lua` extension +- El directorio actual contiene un archivo `.lua-version` +- El directorio actual contiene un directorio `lua` +- El directorio actual contiene un archivo con la extensión `.lua` ### Opciones -| Opción | Por defecto | Descripción | -| ------------ | ---------------------------------- | -------------------------------------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | -| `symbol` | `"🌙 "` | A format string representing the symbol of Lua. | -| `style` | `"bold blue"` | El estilo del módulo. | -| `lua_binary` | `"lua"` | Configures the lua binary that Starship executes when getting the version. | -| `disabled` | `false` | Disables the `lua` module. | +| Opción | Por defecto | Descripción | +| ------------ | ---------------------------------- | ----------------------------------------------------------------------- | +| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | +| `symbol` | `"🌙 "` | Una cadena de formato que representa el símbolo de Lua. | +| `style` | `"bold blue"` | El estilo del módulo. | +| `lua_binary` | `"lua"` | Configura el binario de lua que Starship ejecuta al obtener la versión. | +| `disabled` | `false` | Desactiva el módulo `lua`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | -------- | -------------------------------------- | -| version | `v5.4.0` | The version of `lua` | +| version | `v5.4.0` | La versión de `lua` | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -1514,40 +1514,40 @@ The `lua` module shows the currently installed version of Lua. El módulo se mue format = "via [🌕 $version](bold blue) " ``` -## Memory Usage +## Memoria utilizada -The `memory_usage` module shows current system memory and swap usage. +El módulo `memory_usage` muestra la memoria del sistema actual y el uso de memoria de intercambio. -By default the swap usage is displayed if the total system swap is non-zero. +Por defecto, el uso de swap se muestra si el intercambio total del sistema no es cero. ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. +Este módulo está deshabilitado por defecto. Para activarlo, establece `disabled` a `false` en tu archivo de configuración. ::: ### Opciones -| Opción | Por defecto | Descripción | -| ----------- | --------------------------------------------- | -------------------------------------------------------- | -| `threshold` | `75` | Hide the memory usage unless it exceeds this percentage. | -| `format` | `"via $symbol [${ram}( | ${swap})]($style) "` | El formato del módulo. | -| `symbol` | `"🐏"` | The symbol used before displaying the memory usage. | -| `style` | `"bold dimmed white"` | El estilo del módulo. | -| `disabled` | `true` | Disables the `memory_usage` module. | +| Opción | Por defecto | Descripción | +| ----------- | --------------------------------------------- | ------------------------------------------------------------- | +| `threshold` | `75` | Ocultar el uso de memoria a menos que supere este porcentaje. | +| `format` | `"via $symbol [${ram}( | ${swap})]($style) "` | El formato del módulo. | +| `symbol` | `"🐏"` | El símbolo usado antes de mostrar el uso de memoria. | +| `style` | `"bold dimmed white"` | El estilo del módulo. | +| `disabled` | `true` | Desactiva el módulo `memory_usage`. | ### Variables -| Variable | Ejemplo | Descripción | -| ---------------- | ------------- | ------------------------------------------------------------------ | -| ram | `31GiB/65GiB` | The usage/total RAM of the current system memory. | -| ram_pct | `48%` | The percentage of the current system memory. | -| swap\*\* | `1GiB/4GiB` | The swap memory size of the current system swap memory file. | -| swap_pct\*\* | `77%` | The swap memory percentage of the current system swap memory file. | -| symbol | `🐏` | Refleja el valor de la opción `symbol` | -| style\* | | Refleja el valor de la opción `style` | +| Variable | Ejemplo | Descripción | +| ---------------- | ------------- | ---------------------------------------------------------------------------------- | +| ram | `31GiB/65GiB` | La memoria RAM usada/total del sistema actual. | +| ram_pct | `48%` | El porcentaje de la memoria actual del sistema. | +| swap\*\* | `1GiB/4GiB` | El tamaño de la memoria de intercambio del archivo de memoria del sistema actual. | +| swap_pct\*\* | `77%` | El porcentaje de memoria de intercambio del archivo de memoria del sistema actual. | +| symbol | `🐏` | Refleja el valor de la opción `symbol` | +| style\* | | Refleja el valor de la opción `style` | -\*: This variable can only be used as a part of a style string \*\*: The SWAP file information is only displayed if detected on the current system +\*: Esta variable sólo puede utilizarse como parte de una cadena de estilo \*\*: La información del archivo SWAP sólo se muestra si se detecta en el sistema actual ### Ejemplo @@ -1563,24 +1563,24 @@ style = "bold dimmed green" ## Mercurial Branch -The `hg_branch` module shows the active branch of the repo in your current directory. +El módulo `hg_branch` muestra la rama activa del repositorio en su directorio actual. ### Opciones -| Opción | Por defecto | Descripción | -| ------------------- | -------------------------------- | -------------------------------------------------------------------------------------------- | -| `symbol` | `" "` | The symbol used before the hg bookmark or branch name of the repo in your current directory. | -| `style` | `"bold purple"` | El estilo del módulo. | -| `format` | `"on [$symbol$branch]($style) "` | El formato del módulo. | -| `truncation_length` | `2^63 - 1` | Truncates the hg branch name to X graphemes | -| `truncation_symbol` | `"…"` | The symbol used to indicate a branch name was truncated. | -| `disabled` | `true` | Disables the `hg_branch` module. | +| Opción | Por defecto | Descripción | +| ------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------- | +| `symbol` | `" "` | El símbolo usado antes del marcador hg o nombre de la rama del repositorio en su directorio actual. | +| `style` | `"bold purple"` | El estilo del módulo. | +| `format` | `"on [$symbol$branch]($style) "` | El formato del módulo. | +| `truncation_length` | `2^63 - 1` | Trunca el nombre de la rama hg a X grafemas | +| `truncation_symbol` | `"…"` | El símbolo usado para indicar que un nombre de rama fue truncado. | +| `disabled` | `true` | Desactiva el módulo `hg_branch`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | -------- | -------------------------------------- | -| branch | `master` | The active mercurial branch | +| branch | `master` | La rama de mercurial activa | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -1599,27 +1599,27 @@ truncation_symbol = "" ## Nim -The `nim` module shows the currently installed version of Nim. El módulo se muestra si algunas de las siguientes condiciones se cumplen: +El módulo `nim` muestra la versión instalada de Nim. El módulo se muestra si algunas de las siguientes condiciones se cumplen: -- The current directory contains a `nim.cfg` file -- The current directory contains a file with the `.nim` extension -- The current directory contains a file with the `.nims` extension -- The current directory contains a file with the `.nimble` extension +- El directorio actual contiene un archivo `nim.cfg` +- El directorio actual contiene un archivo con la extensión `.nim` +- El directorio actual contiene un archivo con la extensión `.nims` +- El directorio actual contiene un archivo con la extensión `.nimble` ### Opciones -| Opción | Por defecto | Descripción | -| ---------- | ---------------------------------- | ----------------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | The format for the module | -| `symbol` | `"👑 "` | The symbol used before displaying the version of Nim. | -| `style` | `"bold yellow"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `nim` module. | +| Opción | Por defecto | Descripción | +| ---------- | ---------------------------------- | ---------------------------------------------------- | +| `format` | `"via [$symbol$version]($style) "` | El formato del módulo | +| `symbol` | `"👑 "` | El símbolo usado antes de mostrar la versión de Nim. | +| `style` | `"bold yellow"` | El estilo del módulo. | +| `disabled` | `false` | Desactiva el módulo `nim`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | -------- | -------------------------------------- | -| version | `v1.2.0` | The version of `nimc` | +| version | `v1.2.0` | La versión de `nimc` | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -1637,25 +1637,25 @@ symbol = "🎣 " ## Nix-shell -The `nix_shell` module shows the nix-shell environment. The module will be shown when inside a nix-shell environment. +El módulo `nix_shell` muestra el entorno nix-shell. El módulo se mostrará dentro de un entorno nix-shell. ### Opciones -| Opción | Por defecto | Descripción | -| ------------ | ---------------------------------------------- | ----------------------------------------------------- | -| `format` | `'via [$symbol$state( \($name\))]($style) '` | El formato del módulo. | -| `symbol` | `"❄️ "` | A format string representing the symbol of nix-shell. | -| `style` | `"bold blue"` | El estilo del módulo. | -| `impure_msg` | `"impure"` | A format string shown when the shell is impure. | -| `pure_msg` | `"pure"` | A format string shown when the shell is pure. | -| `disabled` | `false` | Disables the `nix_shell` module. | +| Opción | Por defecto | Descripción | +| ------------ | ---------------------------------------------- | -------------------------------------------------------------------------------- | +| `format` | `'via [$symbol$state( \($name\))]($style) '` | El formato del módulo. | +| `symbol` | `"❄️ "` | Una cadena de formato que representa el símbolo de nix-shell. | +| `style` | `"bold blue"` | El estilo del módulo. | +| `impure_msg` | `"impure"` | Una cadena de formato que se muestra cuando el intérprete de comandos es impuro. | +| `pure_msg` | `"pure"` | Una cadena de formato que se muestra cuando el intérprete de comandos es puro. | +| `disabled` | `false` | Desactiva el módulo `nix_shell`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | ------- | -------------------------------------- | -| state | `pure` | The state of the nix-shell | -| name | `lorri` | The name of the nix-shell | +| state | `pure` | El estado de nix-shell | +| name | `lorri` | El nombre de nix-shell | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -1675,29 +1675,29 @@ format = 'via [☃️ $state( \($name\))](bold blue) ' ## NodeJS -The `nodejs` module shows the currently installed version of NodeJS. El módulo se muestra si algunas de las siguientes condiciones se cumplen: +El módulo `nodejs` muestra la versión instalada de NodeJS. El módulo se muestra si algunas de las siguientes condiciones se cumplen: -- The current directory contains a `package.json` file -- The current directory contains a `.node-version` file -- The current directory contains a `node_modules` directory -- The current directory contains a file with the `.js`, `.mjs` or `.cjs` extension -- The current directory contains a file with the `.ts` extension +- El directorio actual contiene un archivo `package.json` +- El directorio actual contiene un archivo `.node-version` +- El directorio actual contiene un directorio `node_modules` +- 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` ### Opciones -| Opción | Por defecto | Descripción | -| ------------------- | ---------------------------------- | ----------------------------------------------------------------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | -| `symbol` | `"⬢ "` | A format string representing the symbol of NodeJS. | -| `style` | `"bold green"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `nodejs` module. | -| `not_capable_style` | `bold red` | The style for the module when an engines property in Packages.json does not match the NodeJS version. | +| Opción | Por defecto | Descripción | +| ------------------- | ---------------------------------- | --------------------------------------------------------------------------------------------------------------- | +| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | +| `symbol` | `"⬢ "` | Una cadena de formato que representa el símbolo de NodeJS. | +| `style` | `"bold green"` | El estilo del módulo. | +| `disabled` | `false` | Desactiva el módulo `nodejs`. | +| `not_capable_style` | `bold red` | El estilo para el módulo cuando una propiedad de motores en Packages.json no coincide con la versión de NodeJS. | ###  Variables | Variable | Ejemplo | Descripción | | --------- | ---------- | -------------------------------------- | -| version | `v13.12.0` | The version of `node` | +| version | `v13.12.0` | La versión de `node` | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -1714,29 +1714,29 @@ format = "via [🤖 $version](bold green) " ## OCaml -The `ocaml` module shows the currently installed version of OCaml. El módulo se muestra si algunas de las siguientes condiciones se cumplen: +El módulo `ocaml` muestra la versión actualmente instalada de OCaml. El módulo se muestra si algunas de las siguientes condiciones se cumplen: -- The current directory contains a file with `.opam` extension or `_opam` directory -- The current directory contains a `esy.lock` directory -- The current directory contains a `dune` or `dune-project` file -- The current directory contains a `jbuild` or `jbuild-ignore` file -- The current directory contains a `.merlin` file -- The current directory contains a file with `.ml`, `.mli`, `.re` or `.rei` extension +- El directorio actual contiene un archivo con extensión `.opam` o directorio `_opam` +- El directorio actual contiene un directorio `esy.lock` +- El directorio actual contiene un archivo `dune` o `dune-project` +- El directorio actual contiene un archivo `jbuild` o `jbuild-ignore` +- El directorio actual contiene un archivo `.merlin` +- El directorio actual contiene un archivo con la extensión `.ml`, `.mli`, `.re` o `.rei` ### Opciones -| Opción | Por defecto | Descripción | -| ---------- | ---------------------------------- | ------------------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | The format string for the module. | -| `symbol` | `"🐫 "` | The symbol used before displaying the version of OCaml. | -| `style` | `"bold yellow"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `ocaml` module. | +| Opción | Por defecto | Descripción | +| ---------- | ---------------------------------- | ------------------------------------------------------ | +| `format` | `"via [$symbol$version]($style) "` | La cadena de formato para el módulo. | +| `symbol` | `"🐫 "` | El símbolo usado antes de mostrar la versión de OCaml. | +| `style` | `"bold yellow"` | El estilo del módulo. | +| `disabled` | `false` | Desactiva el módulo `ocaml`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | --------- | -------------------------------------- | -| version | `v4.10.0` | The version of `ocaml` | +| version | `v4.10.0` | La versión de `ocaml` | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -1753,23 +1753,23 @@ format = "via [🐪 $version]($style) " ## OpenStack -The `openstack` module shows the current OpenStack cloud and project. The module only active when the `OS_CLOUD` env var is set, in which case it will read `clouds.yaml` file from any of the [default locations](https://docs.openstack.org/python-openstackclient/latest/configuration/index.html#configuration-files). to fetch the current project in use. +El módulo `openstack` muestra la nube OpenStack actual y el proyecto. El módulo solo está activo cuando la variable env `OS_CLOUD` está definida en cuyo caso leerá el archivo `nubes. aml` desde cualquiera de las [ubicaciones por defecto](https://docs.openstack.org/python-openstackclient/latest/configuration/index.html#configuration-files) para obtener el proyecto actual en uso. ### Opciones -| Opción | Por defecto | Descripción | -| ---------- | --------------------------------------------------- | -------------------------------------------------------------- | -| `format` | `"on [$symbol$cloud(\\($project\\))]($style) "` | El formato del módulo. | -| `symbol` | `"☁️ "` | The symbol used before displaying the current OpenStack cloud. | -| `style` | `"bold yellow"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `OpenStack` module. | +| Opción | Por defecto | Descripción | +| ---------- | --------------------------------------------------- | ----------------------------------------------------------- | +| `format` | `"on [$symbol$cloud(\\($project\\))]($style) "` | El formato del módulo. | +| `symbol` | `"☁️ "` | El símbolo usado antes de mostrar la nube OpenStack actual. | +| `style` | `"bold yellow"` | El estilo del módulo. | +| `disabled` | `false` | Desactiva el módulo `OpenStack`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | ------- | -------------------------------------- | -| cloud | `corp` | The current OpenStack cloud | -| project | `dev` | The current OpenStack project | +| cloud | `corp` | La nube OpenStack actual | +| project | `dev` | El proyecto OpenStack actual | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -1786,38 +1786,38 @@ style = "bold yellow" symbol = "☁️ " ``` -## Package Version +## Versión del paquete -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`, `cargo`, `poetry`, `composer`, `gradle`, `julia`, `mix` and `helm` packages. +El módulo `package` se muestra cuando el directorio actual es el repositorio de un paquete, y muestra su versión actual. El módulo soporta actualmente los paquetes `npm`, `cargo`, `poetry`, `composer`, `gradle`, `julia`, `mix` y `helm`. -- **npm** – The `npm` package version is extracted from the `package.json` present in the current directory -- **cargo** – The `cargo` package version is extracted from the `Cargo.toml` present in the current directory -- **poetry** – The `poetry` package version is extracted from the `pyproject.toml` present in the current directory -- **composer** – The `composer` package version is extracted from the `composer.json` present in the current directory -- **gradle** – The `gradle` package version is extracted from the `build.gradle` present -- **julia** - The package version is extracted from the `Project.toml` present -- **mix** - The `mix` package version is extracted from the `mix.exs` present -- **helm** - The `helm` chart version is extracted from the `Chart.yaml` present -- **maven** - The `maven` package version is extracted from the `pom.xml` present +- **npm** – La versión del paquete `npm` se extrae del `package.json` presente en el directorio actual +- **cargo** – La versión del paquete `cargo` se extrae del `Cargo.toml` presente en el directorio actual +- **poetry** – La versión del paquete `poetry` es extraída del `pyproject.toml` presente en el directorio actual +- **composer** - La versión del paquete `composer` se extrae del `composer.json` presente en el directorio actual +- **gradle** – La versión del paquete `gradle` es extraída del `build.gradle` presente +- **julia** - La versión del paquete se extrae del `Project.toml` presente +- **mix** - La versión del paquete `mix` se extrae del `mix.exs` presente +- **helm** - La versión del gráfico `helm` se extrae del `Chart.yaml` presente +- **maven** - La versión del paquete `maven` es extraída del `pom.xml` presente - **meson** - The `meson` package version is extracted from the `meson.build` present > ⚠️ La versión que se muestra es la del paquete cuyo código fuente está en tu directorio actual, no en tu gestor de paquetes. ### Opciones -| Opción | Por defecto | Descripción | -| ----------------- | ---------------------------------- | ---------------------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | -| `symbol` | `"📦 "` | The symbol used before displaying the version the package. | -| `style` | `"bold 208"` | El estilo del módulo. | -| `display_private` | `false` | Enable displaying version for packages marked as private. | -| `disabled` | `false` | Disables the `package` module. | +| Opción | Por defecto | Descripción | +| ----------------- | --------------------------------- | -------------------------------------------------------------------------------- | +| `format` | `"is [$symbol$version]($style) "` | El formato del módulo. | +| `symbol` | `"📦 "` | El símbolo usado antes de mostrar la versión del paquete. | +| `style` | `"bold 208"` | El estilo del módulo. | +| `display_private` | `false` | Activar la visualización de la versión para los paquetes marcados como privados. | +| `disabled` | `false` | Desactiva el módulo `package`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | -------- | -------------------------------------- | -| version | `v1.0.0` | The version of your package | +| version | `v1.0.0` | La versión de su paquete | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -1834,28 +1834,28 @@ format = "via [🎁 $version](208 bold) " ## Perl -The `perl` module shows the currently installed version of Perl. El módulo se muestra si algunas de las siguientes condiciones se cumplen: +El módulo `perl` muestra la versión actualmente instalada de Perl. El módulo se muestra si algunas de las siguientes condiciones se cumplen: -- The current directory contains a `Makefile.PL` or `Build.PL` file -- The current directory contains a `cpanfile` or `cpanfile.snapshot` file -- The current directory contains a `META.json` file or `META.yml` file -- The current directory contains a `.perl-version` file -- The current directory contains a `.pl`, `.pm` or `.pod` +- El directorio actual contiene un archivo `Makefile.PL` o `Build.PL` +- El directorio actual contiene un archivo `cpanfile` o `cpanfile.snapshot` +- El directorio actual contiene un archivo `META.json` o `META.yml` +- El directorio actual contiene un archivo `.perl-version` +- El directorio actual contiene un `.pl`, `.pm` o `.pod` ### Opciones -| Opción | Por defecto | Descripción | -| ---------- | ---------------------------------- | ----------------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | The format string for the module. | -| `symbol` | `"🐪 "` | The symbol used before displaying the version of Perl | -| `style` | `"bold 149"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `perl` module. | +| Opción | Por defecto | Descripción | +| ---------- | ---------------------------------- | ---------------------------------------------------- | +| `format` | `"via [$symbol$version]($style) "` | La cadena de formato para el módulo. | +| `symbol` | `"🐪 "` | El símbolo usado antes de mostrar la versión de Perl | +| `style` | `"bold 149"` | El estilo del módulo. | +| `disabled` | `false` | Desactiva el módulo `perl`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | --------- | -------------------------------------- | -| version | `v5.26.1` | The version of `perl` | +| version | `v5.26.1` | La versión de `perl` | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -1870,26 +1870,26 @@ format = "via [🦪 $version]($style) " ## PHP -The `php` module shows the currently installed version of PHP. El módulo se muestra si algunas de las siguientes condiciones se cumplen: +El módulo `php` muestra la versión instalada de PHP. El módulo se muestra si algunas de las siguientes condiciones se cumplen: -- The current directory contains a `composer.json` file -- The current directory contains a `.php-version` file -- The current directory contains a `.php` file +- El directorio actual contiene un archivo `composer.json` +- El directorio actual contiene un archivo `.php-version` +- El directorio actual contiene un archivo `.php` ### Opciones -| Opción | Por defecto | Descripción | -| ---------- | ---------------------------------- | ----------------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | -| `symbol` | `"🐘 "` | The symbol used before displaying the version of PHP. | -| `style` | `"147 bold"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `php` module. | +| Opción | Por defecto | Descripción | +| ---------- | ---------------------------------- | ---------------------------------------------------- | +| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | +| `symbol` | `"🐘 "` | El símbolo usado antes de mostrar la versión de PHP. | +| `style` | `"147 bold"` | El estilo del módulo. | +| `disabled` | `false` | Desactiva el módulo `php`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | -------- | -------------------------------------- | -| version | `v7.3.8` | The version of `php` | +| version | `v7.3.8` | La versión de `php` | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -1906,25 +1906,25 @@ format = "via [🔹 $version](147 bold) " ## PureScript -The `purescript` module shows the currently installed version of PureScript version. El módulo se muestra si algunas de las siguientes condiciones se cumplen: +El módulo `purescript` muestra la versión actualmente instalada de PureScript. El módulo se muestra si algunas de las siguientes condiciones se cumplen: -- The current directory contains a `spago.dhall` file -- The current directory contains a \*.purs files +- El directorio actual contiene un archivo `spago.dhall` +- El directorio actual contiene un archivo \*.purs ### Opciones -| Opción | Por defecto | Descripción | -| ---------- | ---------------------------------- | ------------------------------------------------------------ | -| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | -| `symbol` | `"<=> "` | The symbol used before displaying the version of PureScript. | -| `style` | `"bold white"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `purescript` module. | +| Opción | Por defecto | Descripción | +| ---------- | ---------------------------------- | ----------------------------------------------------------- | +| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | +| `symbol` | `"<=> "` | El símbolo usado antes de mostrar la versión de PureScript. | +| `style` | `"bold white"` | El estilo del módulo. | +| `disabled` | `false` | Deshabilita el módulo `purescript`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | -------- | -------------------------------------- | -| version | `0.13.5` | The version of `purescript` | +| version | `0.13.5` | La versión de `purescript` | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -1941,52 +1941,52 @@ format = "via [$symbol$version](bold white)" ## Python -The `python` module shows the currently installed version of Python and the current Python virtual environment if one is activated. +El módulo `python` muestra la versión actualmente instalada de Python y el actual entorno virtual de Python si uno está activado. -If `pyenv_version_name` is set to `true`, it will display the pyenv version name. Otherwise, it will display the version number from `python --version`. +Si `pyenv_version_name` se establece en `true`, mostrará el nombre de la versión de pyenv. De lo contrario, se mostrará el número de versión de `python --version`. El módulo se muestra si algunas de las siguientes condiciones se cumplen: -- The current directory contains a `.python-version` file -- The current directory contains a `requirements.txt` file -- The current directory contains a `pyproject.toml` file -- The current directory contains a file with the `.py` extension (and `scan_for_pyfiles` is true) -- The current directory contains a `Pipfile` file -- The current directory contains a `tox.ini` file -- The current directory contains a `setup.py` file -- The current directory contains a `__init__.py` file -- A virtual environment is currently activated +- El directorio actual contiene un archivo `.python-version` +- El directorio actual contiene un archivo `requirements.txt` +- El directorio actual contiene un archivo `pyproject.toml` +- El directorio actual contiene un archivo con la extensión `.py` (y `scan_for_pyfiles` es verdadero) +- El directorio actual contiene un archivo `Pipfile` +- El directorio actual contiene un archivo `tox.ini` +- El directorio actual contiene un archivo `setup.py` +- El directorio actual contiene un archivo `__init__.py` +- Un entorno virtual está activado actualmente ### Opciones -| Opción | Por defecto | Descripción | -| -------------------- | ------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | -| `format` | `'via [${symbol}${pyenv_prefix}${version}( \($virtualenv\))]($style) '` | El formato del módulo. | -| `symbol` | `"🐍 "` | A format string representing the symbol of Python | -| `style` | `"yellow bold"` | El estilo del módulo. | -| `pyenv_version_name` | `false` | Use pyenv to get Python version | -| `pyenv_prefix` | `pyenv` | Prefix before pyenv version display, only used if pyenv is used | -| `scan_for_pyfiles` | `true` | If false, Python files in the current directory will not show this module. | -| `python_binary` | `["python", "python3, "python2"]` | Configures the python binaries that Starship should executes when getting the version. | -| `disabled` | `false` | Disables the `python` module. | +| Opción | Por defecto | Descripción | +| -------------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | +| `format` | `'via [${symbol}${pyenv_prefix}${version}( \($virtualenv\))]($style) '` | El formato del módulo. | +| `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 | +| `scan_for_pyfiles` | `true` | Si es falso, los archivos Python en el directorio actual no mostrarán este módulo. | +| `python_binary` | `["python", "python3, "python2"]` | Configura los binarios de python que Starship debería ejecutar al obtener la versión. | +| `disabled` | `false` | Desactiva el módulo `python`. | ::: tip -The `python_binary` variable accepts either a string or a list of strings. Starship will try executing each binary until it gets a result. Note you can only change the binary that Starship executes to get the version of Python not the arguments that are used. +La variable `python_binary` acepta una cadena o una lista de cadenas. Starship intentará ejecutar cada binario hasta que obtenga un resultado. Ten en cuenta que sólo puedes cambiar el binario que Starship ejecuta para obtener la versión de Python no los argumentos que se utilizan. -The default values and order for `python_binary` was chosen to first identify the Python version in a virtualenv/conda environments (which currently still add a `python`, no matter if it points to `python3` or `python2`). This has the side effect that if you still have a system Python 2 installed, it may be picked up before any Python 3 (at least on Linux Distros that always symlink `/usr/bin/python` to Python 2). If you do not work with Python 2 anymore but cannot remove the system Python 2, changing this to `"python3"` will hide any Python version 2, see example below. +Los valores por defecto y el orden para `python_binary` fue elegido para identificar primero la versión de Python en un entorno virtualenv/conda (que actualmente añade un `python`, no importa si apunta a `pithon3` o `pithon2`). Esto tiene el efecto secundario que si todavía tienes un sistema de Python 2 instalado, puede ser recogido antes de cualquier Python 3 (al menos en las Distros de Linux que siempre enlazan `/usr/bin/python` a Python 2). Si ya no trabajas con Python 2 pero no puedes removerlo del sistema, cambiando esto a `"python3"` ocultará cualquier versión de Python 2, ver ejemplo a continuación. ::: ### Variables -| Variable | Ejemplo | Descripción | -| ------------ | --------------- | ------------------------------------------ | -| version | `"v3.8.1"` | The version of `python` | -| symbol | `"🐍 "` | Refleja el valor de la opción `symbol` | -| style | `"yellow bold"` | Refleja el valor de la opción `style` | -| pyenv_prefix | `"pyenv "` | Mirrors the value of option `pyenv_prefix` | -| virtualenv | `"venv"` | The current `virtualenv` name | +| Variable | Ejemplo | Descripción | +| ------------ | --------------- | ------------------------------------------- | +| version | `"v3.8.1"` | La versión de `python` | +| symbol | `"🐍 "` | Refleja el valor de la opción `symbol` | +| style | `"yellow bold"` | Refleja el valor de la opción `style` | +| pyenv_prefix | `"pyenv "` | Ordena el valor de la opción `pyenv_prefix` | +| virtualenv | `"venv"` | El nombre actual del `virtualenv` | ### Ejemplo @@ -2003,32 +2003,32 @@ pyenv_version_name = true # ~/.config/starship.toml [python] -# Only use the `python3` binary to get the version. +# Solo usa el binario `python3` para obtener la versión. python_binary = "python3" ``` ## Ruby -The `ruby` module shows the currently installed version of Ruby. El módulo se muestra si algunas de las siguientes condiciones se cumplen: +El módulo `ruby` muestra la versión actualmente instalada de Ruby. El módulo se muestra si algunas de las siguientes condiciones se cumplen: -- The current directory contains a `Gemfile` file -- The current directory contains a `.ruby-version` file -- The current directory contains a `.rb` file +- El directorio actual contiene un archivo `Gemfile` +- El directorio actual contiene un archivo `.ruby-version` +- El directorio actual contiene un archivo `.rb` ### Opciones -| Opción | Por defecto | Descripción | -| ---------- | ---------------------------------- | ------------------------------------------------ | -| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | -| `symbol` | `"💎 "` | A format string representing the symbol of Ruby. | -| `style` | `"bold red"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `ruby` module. | +| Opción | Por defecto | Descripción | +| ---------- | ---------------------------------- | -------------------------------------------------------- | +| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | +| `symbol` | `"💎 "` | Una cadena de formato que representa el símbolo de Ruby. | +| `style` | `"bold red"` | El estilo del módulo. | +| `disabled` | `false` | Desactiva el módulo `ruby`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | -------- | -------------------------------------- | -| version | `v2.5.1` | The version of `ruby` | +| version | `v2.5.1` | La versión de `ruby` | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -2045,25 +2045,25 @@ symbol = "🔺 " ## Rust -The `rust` module shows the currently installed version of Rust. El módulo se muestra si algunas de las siguientes condiciones se cumplen: +El módulo `rust` muestra la versión instalada de Rust. El módulo se muestra si algunas de las siguientes condiciones se cumplen: -- The current directory contains a `Cargo.toml` file -- The current directory contains a file with the `.rs` extension +- El directorio actual contiene un archivo `Cargo.toml` +- El directorio actual contiene un archivo con la extensión `.rs` ### Opciones -| Opción | Por defecto | Descripción | -| ---------- | ---------------------------------- | ----------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | -| `symbol` | `"🦀 "` | A format string representing the symbol of Rust | -| `style` | `"bold red"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `rust` module. | +| Opción | Por defecto | Descripción | +| ---------- | ---------------------------------- | ------------------------------------------------------- | +| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | +| `symbol` | `"🦀 "` | Una cadena de formato que representa el símbolo de Rust | +| `style` | `"bold red"` | El estilo del módulo. | +| `disabled` | `false` | Desactiva el módulo `rust`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | ----------------- | -------------------------------------- | -| version | `v1.43.0-nightly` | The version of `rustc` | +| version | `v1.43.0-nightly` | La versión de `rustc` | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -2080,24 +2080,24 @@ format = "via [⚙️ $version](red bold)" ## SHLVL -The `shlvl` module shows the current SHLVL ("shell level") environment variable, if it is set to a number and meets or exceeds the specified threshold. +El módulo `shlvl` muestra la variable de entorno actual SHLVL ("nivel de shell"), si está establecido en un número y conoce o supera el umbral especificado. ### Opciones | Opción | Por defecto | Descripción | | ----------- | ---------------------------- | ----------------------------------------------------------- | -| `threshold` | `2` | Display threshold. | +| `threshold` | `2` | Mostrar umbral. | | `format` | `"[$symbol$shlvl]($style) "` | El formato del módulo. | -| `symbol` | `"↕️ "` | The symbol used to represent the SHLVL. | +| `symbol` | `"↕️ "` | El símbolo usado para representar el SHLVL. | | `repeat` | `false` | Causes `symbol` to be repeated by the current SHLVL amount. | | `style` | `"bold yellow"` | El estilo del módulo. | -| `disabled` | `true` | Disables the `shlvl` module. | +| `disabled` | `true` | Desactiva el módulo `shlvl`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | ------- | -------------------------------------- | -| shlvl | `3` | The current value of SHLVL | +| shlvl | `3` | El valor actual de SHLVL | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -2116,22 +2116,22 @@ threshold = 3 ## Singularity -The `singularity` module shows the current singularity image, if inside a container and `$SINGULARITY_NAME` is set. +El módulo `singularity` muestra la imagen de singularity actual, si se encuentra dentro de un contenedor y `$SINGULARITY_NAME` está establecido. ### Opciones -| Opción | Por defecto | Descripción | -| ---------- | -------------------------------- | ------------------------------------------------ | -| `format` | `'[$symbol\[$env\]]($style) '` | El formato del módulo. | -| `symbol` | `""` | A format string displayed before the image name. | -| `style` | `"bold dimmed blue"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `singularity` module. | +| Opción | Por defecto | Descripción | +| ---------- | -------------------------------- | ------------------------------------------------------------------- | +| `format` | `'[$symbol\[$env\]]($style) '` | El formato del módulo. | +| `symbol` | `""` | Una cadena de formato que se muestra antes del nombre de la imagen. | +| `style` | `"bold dimmed blue"` | El estilo del módulo. | +| `disabled` | `false` | Desactiva el módulo `singularity`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | ------------ | -------------------------------------- | -| env | `centos.img` | The current singularity image | +| env | `centos.img` | La imagen de singularity actual | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -2148,17 +2148,19 @@ format = '[📦 \[$env\]]($style) ' ## Status -The `status` module displays the exit code of the previous command. The module will be shown only if the exit code is not `0`. +El módulo `status` muestra el código de salida del comando anterior. El módulo se mostrará sólo si el código de salida no es `0`. ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. ::: +Este módulo está deshabilitado por defecto. Para activarlo, establece `disabled` a `false` en tu archivo de configuración. + +::: ### Opciones | Opción | Por defecto | Descripción | | ----------------------- | -------------------------- | ---------------------------------------------------- | -| `format` | `[$symbol$status]($style)` | The format of the module | +| `format` | `[$symbol$status]($style)` | El formato del módulo | | `symbol` | `"✖"` | The symbol displayed on program error | | `not_executable_symbol` | `"🚫"` | The symbol displayed when file isn't executable | | `not_found_symbol` | `"🔍"` | The symbol displayed when the command can't be found | @@ -2167,14 +2169,14 @@ This module is disabled by default. To enable it, set `disabled` to `false` in y | `style` | `"bold red"` | El estilo del módulo. | | `recognize_signal_code` | `true` | Enable signal mapping from exit code | | `map_symbol` | `false` | Enable symbols mapping from exit code | -| `disabled` | `true` | Disables the `status` module. | +| `disabled` | `true` | Desactiva el módulo `status`. | ### Variables | Variable | Ejemplo | Descripción | | -------------- | ------- | -------------------------------------------------------------------- | -| status | `127` | The exit code of the last command | -| int | `127` | The exit code of the last command | +| status | `127` | El código de salida del último comando | +| int | `127` | El código de salida del último comando | | common_meaning | `ERROR` | Meaning of the code if not a signal | | signal_number | `9` | Signal number corresponding to the exit code, only if signalled | | signal_name | `KILL` | Name of the signal corresponding to the exit code, only if signalled | @@ -2203,23 +2205,23 @@ disabled = false The `swift` module shows the currently installed version of Swift. El módulo se muestra si algunas de las siguientes condiciones se cumplen: -- The current directory contains a `Package.swift` file -- The current directory contains a file with the `.swift` extension +- El directorio actual contiene un archivo `Package.swift` +- El directorio actual contiene un archivo con la extensión `.swift` ### Opciones -| Opción | Por defecto | Descripción | -| ---------- | ---------------------------------- | ------------------------------------------------ | -| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | -| `symbol` | `"🐦 "` | A format string representing the symbol of Swift | -| `style` | `"bold 202"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `swift` module. | +| Opción | Por defecto | Descripción | +| ---------- | ---------------------------------- | -------------------------------------------------------- | +| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | +| `symbol` | `"🐦 "` | Una cadena de formato que representa el símbolo de Swift | +| `style` | `"bold 202"` | El estilo del módulo. | +| `disabled` | `false` | Desactiva el módulo `swift`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | -------- | -------------------------------------- | -| version | `v5.2.4` | The version of `swift` | +| version | `v5.2.4` | La versión de `swift` | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -2238,26 +2240,26 @@ format = "via [🏎 $version](red bold)" The `terraform` module shows the currently selected terraform workspace and version. By default the terraform version is not shown, since this is slow on current versions of terraform when a lot of plugins are in use. If you still want to enable it, [follow the example shown below](#with-version). El módulo se muestra si algunas de las siguientes condiciones se cumplen: -- The current directory contains a `.terraform` folder -- Current directory contains a file with the `.tf` or `.hcl` extensions +- El directorio actual contiene una carpeta `.terraform` +- El directorio actual contiene un archivo con las extensiones `.tf` o `.hcl` ### Opciones -| Opción | Por defecto | Descripción | -| ---------- | ------------------------------------ | ----------------------------------------------------- | -| `format` | `"via [$symbol$workspace]($style) "` | The format string for the module. | -| `symbol` | `"💠 "` | A format string shown before the terraform workspace. | -| `style` | `"bold 105"` | El estilo del módulo. | -| `disabled` | `false` | Disables the `terraform` module. | +| Opción | Por defecto | Descripción | +| ---------- | ------------------------------------ | ------------------------------------------------------------------------------- | +| `format` | `"via [$symbol$workspace]($style) "` | La cadena de formato para el módulo. | +| `symbol` | `"💠 "` | Una cadena de formato que se muestra antes del espacio de trabajo de terraform. | +| `style` | `"bold 105"` | El estilo del módulo. | +| `disabled` | `false` | Desactiva el módulo `terraform`. | ### Variables -| Variable | Ejemplo | Descripción | -| --------- | ---------- | -------------------------------------- | -| version | `v0.12.24` | The version of `terraform` | -| workspace | `default` | The current terraform workspace | -| symbol | | Refleja el valor de la opción `symbol` | -| style\* | | Refleja el valor de la opción `style` | +| Variable | Ejemplo | Descripción | +| --------- | ------------- | ----------------------------------------- | +| version | `v0.12.24` | La versión de `terraform` | +| workspace | `por defecto` | El espacio de trabajo actual de terraform | +| symbol | | Refleja el valor de la opción `symbol` | +| style\* | | Refleja el valor de la opción `style` | \*: Esta variable sólo puede ser usada como parte de una cadena de estilo @@ -2287,21 +2289,21 @@ The `time` module shows the current **local** time. The `format` configuration v ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. +Este módulo está deshabilitado por defecto. Para activarlo, establece `disabled` a `false` en tu archivo de configuración. ::: ### Opciones -| Opción | Por defecto | Descripción | -| ----------------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | -| `format` | `"at [$time]($style) "` | The format string for the module. | -| `use_12hr` | `false` | Enables 12 hour formatting | -| `time_format` | see below | The [chrono format string](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) used to format the time. | -| `style` | `"bold yellow"` | The style for the module time | -| `utc_time_offset` | `"local"` | Sets the UTC offset to use. Range from -24 < x < 24. Allows floats to accommodate 30/45 minute timezone offsets. | -| `disabled` | `true` | Disables the `time` module. | -| `time_range` | `"-"` | Sets the time range during which the module will be shown. Times must be specified in 24-hours format | +| Opción | Por defecto | Descripción | +| ----------------- | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `format` | `"at [$time]($style) "` | La cadena de formato para el módulo. | +| `use_12hr` | `false` | Activa el formato de 12 horas | +| `time_format` | see below | La [cadena de formato de chrono](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) utilizada para formatear la hora. | +| `style` | `"bold yellow"` | El estilo para la hora del módulo | +| `utc_time_offset` | `"local"` | Establece el desplazamiento UTC a utilizar. Rango de -24 < x < 24. Permite a los flotantes acomodar los desplazamientos de zona horaria de 30/45 minutos. | +| `disabled` | `true` | Desactiva el módulo `time`. | +| `time_range` | `"-"` | Establece el intervalo de tiempo durante el cual el módulo se mostrará. La hora debe ser especificada en formato de 24 horas | If `use_12hr` is `true`, then `time_format` defaults to `"%r"`. Otherwise, it defaults to `"%T"`. Manually setting `time_format` will override the `use_12hr` setting. @@ -2309,7 +2311,7 @@ If `use_12hr` is `true`, then `time_format` defaults to `"%r"`. Otherwise, it de | Variable | Ejemplo | Descripción | | --------- | ---------- | ------------------------------------- | -| time | `13:08:10` | The current time. | +| time | `13:08:10` | La hora actual. | | style\* | | Refleja el valor de la opción `style` | \*: Esta variable sólo puede ser usada como parte de una cadena de estilo @@ -2327,33 +2329,37 @@ utc_time_offset = "-5" time_range = "10:00:00-14:00:00" ``` -## Username +## Nombre de usuario The `username` module shows active user's username. El módulo se muestra si algunas de las siguientes condiciones se cumplen: -- The current user is root -- The current user isn't the same as the one that is logged in -- The user is currently connected as an SSH session -- The variable `show_always` is set to true +- El usuario actual es root +- El usuario actual no es el mismo que el que está conectado +- El usuario está actualmente conectado como una sesión SSH +- La variable `show_always` se establece en true -::: tip SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. ::: +::: tip + +SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. + +::: ### Opciones -| Opción | Por defecto | Descripción | -| ------------- | ----------------------- | ------------------------------------- | -| `style_root` | `"bold red"` | The style used when the user is root. | -| `style_user` | `"bold yellow"` | The style used for non-root users. | -| `format` | `"[$user]($style) in "` | El formato del módulo. | -| `show_always` | `false` | Always shows the `username` module. | -| `disabled` | `false` | Disables the `username` module. | +| Opción | Por defecto | Descripción | +| ------------- | ----------------------- | ------------------------------------------ | +| `style_root` | `"bold red"` | El estilo usado cuando el usuario es root. | +| `style_user` | `"bold yellow"` | El estilo usado para usuarios no root. | +| `format` | `"[$user]($style) in "` | El formato del módulo. | +| `show_always` | `false` | Siempre muestra el módulo `username`. | +| `disabled` | `false` | Desactiva el módulo `username`. | ### Variables -| Variable | Ejemplo | Descripción | -| -------- | ------------ | ------------------------------------------------------------------------------------------- | -| `style` | `"red bold"` | Mirrors the value of option `style_root` when root is logged in and `style_user` otherwise. | -| `user` | `"matchai"` | The currently logged-in user ID. | +| Variable | Ejemplo | Descripción | +| -------- | ------------ | --------------------------------------------------------------------------------------------------- | +| `style` | `"red bold"` | Refleja el valor de la opción `style_root` cuando root inició sesión y `style_user` por otra parte. | +| `user` | `"matchai"` | El ID de usuario conectado actualmente. | ### Ejemplo @@ -2372,22 +2378,22 @@ show_always = true The `zig` module shows the currently installed version of Zig. El módulo se muestra si algunas de las siguientes condiciones se cumplen: -- The current directory contains a `.zig` file +- El directorio actual contiene un archivo `.zig` ### Opciones -| Opción | Por defecto | Descripción | -| ---------- | ---------------------------------- | ----------------------------------------------------- | -| `symbol` | `"↯ "` | The symbol used before displaying the version of Zig. | -| `style` | `"bold yellow"` | El estilo del módulo. | -| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | -| `disabled` | `false` | Disables the `zig` module. | +| Opción | Por defecto | Descripción | +| ---------- | ---------------------------------- | ---------------------------------------------------- | +| `symbol` | `"↯ "` | El símbolo usado antes de mostrar la versión de Zig. | +| `style` | `"bold yellow"` | El estilo del módulo. | +| `format` | `"via [$symbol$version]($style) "` | El formato del módulo. | +| `disabled` | `false` | Desactiva el módulo `zig`. | ### Variables | Variable | Ejemplo | Descripción | | --------- | -------- | -------------------------------------- | -| version | `v0.6.0` | The version of `zig` | +| version | `v0.6.0` | La versión de `zig` | | symbol | | Refleja el valor de la opción `symbol` | | style\* | | Refleja el valor de la opción `style` | @@ -2402,16 +2408,16 @@ The `zig` module shows the currently installed version of Zig. El módulo se mue symbol = "⚡️ " ``` -## Custom commands +## Comandos personalizados The `custom` modules show the output of some arbitrary commands. These modules will be shown if any of the following conditions are met: -- The current directory contains a file whose name is in `files` -- The current directory contains a directory whose name is in `directories` -- The current directory contains a file whose extension is in `extensions` -- The `when` command returns 0 +- El directorio actual contiene un archivo cuyo nombre está en `files` +- El directorio actual contiene un directorio cuyo nombre está en `directories` +- El directorio actual contiene un archivo cuya extensión está en `extensions` +- El comando `when` devuelve 0 ::: tip @@ -2433,27 +2439,27 @@ The order in which custom modules are shown can be individually set by including ### Opciones -| Opción | Por defecto | Descripción | -| ------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------- | -| `command` | | The command whose output should be printed. The command will be passed on stdin to the shell. | -| `when` | | A shell command used as a condition to show the module. The module will be shown if the command returns a `0` status code. | -| `shell` | | [See below](#custom-command-shell) | -| `description` | `""` | The description of the module that is shown when running `starship explain`. | -| `files` | `[]` | The files that will be searched in the working directory for a match. | -| `directories` | `[]` | The directories that will be searched in the working directory for a match. | -| `extensions` | `[]` | The extensions that will be searched in the working directory for a match. | -| `symbol` | `""` | The symbol used before displaying the command output. | -| `style` | `"bold green"` | El estilo del módulo. | -| `format` | `"[$symbol$output]($style) "` | El formato del módulo. | -| `disabled` | `false` | Disables this `custom` module. | +| Opción | Por defecto | Descripción | +| ------------- | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | +| `command` | | El comando cuya salida debe ser impresa. El comando se pasará en stdin al shell. | +| `when` | | Comando de shell usado como condición para mostrar el módulo. El módulo se mostrará si el comando devuelve un código de estado `0`. | +| `shell` | | [Ver abajo](#custom-command-shell) | +| `description` | `""` | La descripción del módulo que se muestra al ejecutar `starship explain`. | +| `files` | `[]` | Los archivos que se buscarán en el directorio de trabajo para obtener una coincidencia. | +| `directories` | `[]` | Los directorios que se buscarán en el directorio de trabajo para una coincidencia. | +| `extensions` | `[]` | Las extensiones que se buscarán en el directorio de trabajo para obtener una coincidencia. | +| `symbol` | `""` | El símbolo usado antes de mostrar la salida del comando. | +| `style` | `"bold green"` | El estilo del módulo. | +| `format` | `"[$symbol$output]($style) "` | El formato del módulo. | +| `disabled` | `false` | Desactiva este módulo `custom`. | ### Variables -| Variable | Descripción | -| --------- | -------------------------------------- | -| output | The output of shell command in `shell` | -| symbol | Refleja el valor de la opción `symbol` | -| style\* | Refleja el valor de la opción `style` | +| Variable | Descripción | +| --------- | ----------------------------------------- | +| output | La salida del comando de shell en `shell` | +| symbol | Refleja el valor de la opción `symbol` | +| style\* | Refleja el valor de la opción `style` | \*: Esta variable sólo puede ser usada como parte de una cadena de estilo @@ -2461,8 +2467,8 @@ The order in which custom modules are shown can be individually set by including `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. +- La primera cadena es la ruta al intérprete de comandos a usar para ejecutar el comando. +- Otros argumentos siguientes son pasados al shell. If unset, it will fallback to STARSHIP_SHELL and then to "sh" on Linux, and "cmd /C" on Windows. @@ -2492,8 +2498,8 @@ Automatic detection of shells and proper parameters addition are currently imple # ~/.config/starship.toml [custom.foo] -command = "echo foo" # shows output of command -files = ["foo"] # can specify filters +command = "echo foo" # muestra la salida del comando +files = ["foo"] # se pueden especificar filtros when = """ test "$HOME" == "$PWD" """ format = " transcending [$output]($style)" diff --git a/docs/es-ES/guide/README.md b/docs/es-ES/guide/README.md index d152b9ae..8fe736c5 100644 --- a/docs/es-ES/guide/README.md +++ b/docs/es-ES/guide/README.md @@ -125,6 +125,8 @@ ### Comenzar +**Note**: due to the proliferation of different platforms, only a subset of supported platforms are shown below. Can't see yours? Have a look at the [extra platform instructions](https://starship.rs/installing/). + 1. Instala el binario de **Starship**: @@ -138,17 +140,10 @@ ``` - ##### Desde el código fuente en [crates.io](https://crates.io/): - - ```sh - cargo install starship - ``` - - #### Instalar con un gestor de paquetes - ##### Con [Homebew](https://brew.sh/): + ##### Example: [Homebrew](https://brew.sh/): ```sh brew install starship @@ -161,7 +156,7 @@ scoop install starship ``` -1. Añade el script de inicio al archivo de configuración de tu interfaz de línea de comandos: +2. Añade el script de inicio al archivo de configuración de tu interfaz de línea de comandos: #### Bash diff --git a/docs/es-ES/installing/README.md b/docs/es-ES/installing/README.md new file mode 100644 index 00000000..6f0ea0d6 --- /dev/null +++ b/docs/es-ES/installing/README.md @@ -0,0 +1,46 @@ +# 🚀 Advanced Installation + +To install starship, you need to do two things: + +1. Get the **starship** binary onto your computer +1. Tell your shell to use the starship binary as its prompt by modifying its init scripts + +For most users, the instructions on [the main page](/guide/#🚀-installation) will work great. However, for some more specialized platforms, different instructions are needed. + +There are so many platforms out there that they didn't fit into the main README.md file, so here are some installation instructions for other platforms from the community. Is yours not here? Please do add it here if you figure it out! + +## [Nix](https://nixos.wiki/wiki/Nix) + +### Getting the Binary + +#### Imperatively + +```sh +nix-env -iA nixos.starship +``` + +#### Declarative, single user, via [home-manager](home-manager) + +Add `pkgs.starship` to your `home.packages` in your `home.nix` file, then run + +```sh +home-manager switch +``` + +#### Declarative, system-wide, with NixOS + +Add `pkgs.starship` to `environment.packages` in your `configuration.nix`, then run + +```sh +sudo nixos-rebuild switch +``` + +### Modifying Init Scripts + +#### With Nix and home-manager, using zsh: + +Add the following to `programs.zsh.initExtra` in your `home.nix` file, then run + +```sh +home-manager switch +``` diff --git a/docs/fr-FR/advanced-config/README.md b/docs/fr-FR/advanced-config/README.md index ec08b827..acee4799 100644 --- a/docs/fr-FR/advanced-config/README.md +++ b/docs/fr-FR/advanced-config/README.md @@ -82,7 +82,7 @@ Les chaînes de style sont une liste de mots, séparés par des espaces. Les mot où `` est un spécificateur de couleur (discuté ci-dessous). `fg:` et `` font actuellement la même chose, même si cela peut changer plus tard. L'ordre des mots dans le string n'a pas d'importance. -The `none` token overrides all other tokens in a string if it is not part of a `bg:` specifier, so that e.g. `fg:red none fg:blue` will still create a string with no styling. `bg:none` sets the background to the default color so `fg:red bg:none` is equivalent to `red` or `fg:red` and `bg:green fg:red bg:none` is also equivalent to `fg:red` or `red`. It may become an error to use `none` in conjunction with other tokens in the future. +The `none` token overrides all other tokens in a string if it is not part of a `bg:` specifier, so that e.g. `fg:red none fg:blue` will still create a string with no styling. `bg:none` sets the background to the default color so `fg:red bg:none` is equivalent to `red` or `fg:red` and `bg:green fg:red bg:none` is also equivalent to `fg:red` or `red`. Il peut devenir une erreur d'utiliser `none` en conjonction avec d'autres jetons dans le futur. Un spécificateur de couleur peut être l'un des éléments suivants : diff --git a/docs/fr-FR/config/README.md b/docs/fr-FR/config/README.md index 17756196..477a4649 100644 --- a/docs/fr-FR/config/README.md +++ b/docs/fr-FR/config/README.md @@ -303,16 +303,16 @@ Le module `battery` montre à quel point la batterie de l'appareil est chargée ### Options -| Option | Default | Description | -| -------------------- | --------------------------------- | --------------------------------------------------- | -| `full_symbol` | `""` | Le symbole affiché lorsque la batterie est pleine. | -| `charging_symbol` | `""` | Le symbole affiché lorsque la batterie se charge. | -| `discharging_symbol` | `""` | Le symbole affiché lorsque la batterie se décharge. | -| `unknown_symbol` | `""` | The symbol shown when the battery state is unknown. | -| `empty_symbol` | `""` | The symbol shown when the battery state is empty. | -| `format` | `"[$symbol$percentage]($style) "` | Format du module. | -| `display` | [lien](#battery-display) | Display threshold and style for the module. | -| `disabled` | `false` | Disables the `battery` module. | +| Option | Default | Description | +| -------------------- | --------------------------------- | ------------------------------------------------------------- | +| `full_symbol` | `""` | Le symbole affiché lorsque la batterie est pleine. | +| `charging_symbol` | `""` | Le symbole affiché lorsque la batterie se charge. | +| `discharging_symbol` | `""` | Le symbole affiché lorsque la batterie se décharge. | +| `unknown_symbol` | `""` | Le symbole affiché lorsque l'état de la batterie est inconnu. | +| `empty_symbol` | `""` | Le symbole affiché lorsque la batterie est vide. | +| `format` | `"[$symbol$percentage]($style) "` | Format du module. | +| `display` | [lien](#battery-display) | Affiche le seuil et le style du module. | +| `disabled` | `false` | Désactive le module `battery`. | ### Exemple @@ -328,7 +328,7 @@ discharging_symbol = "💀" ### Indicateur de batterie -The `display` configuration option is used to define when the battery indicator should be shown (threshold) and what it looks like (style). If no `display` is provided. La valeur par défaut est la suivante : +L'option de configuration `display` est utilisée pour définir quand l'indicateur de batterie doit être affiché (seuil) et à quoi il ressemble (style). Si aucun `display` n'est fourni. La valeur par défaut est la suivante : ```toml [[battery.display]] @@ -338,12 +338,12 @@ style = "bold red" #### Options -The `display` option is an array of the following table. +L'option `display` est une array de la table suivante. -| Option | Description | -| ----------- | ----------------------------------------------- | -| `threshold` | The upper bound for the display option. | -| `style` | The style used if the display option is in use. | +| Option | Description | +| ----------- | -------------------------------------------------- | +| `threshold` | La limite supérieure pour l'option d'affichage. | +| `style` | Le style de l'option display si elle est utilisée. | #### Exemple @@ -362,30 +362,30 @@ style = "bold yellow" ## Caractères -The `character` module shows a character (usually an arrow) beside where the text is entered in your terminal. +Le module `character` affiche un caractère (habituellement une flèche) à côté de l'endroit où le texte est entré dans votre terminal. -The character will tell you whether the last command was successful or not. It can do this in two ways: +Le caractère vous dira si la dernière commande a été réussie ou pas. Cela peut être fait de deux manières: - changement de couleur (`red`/`green`) - changement de forme (`❯`/`✖`) -By default it only changes color. If you also want to change it's shape take a look at [this example](#with-custom-error-shape). +Par défaut, il ne change que la couleur. Si vous voulez également changer sa forme, jetez un œil à [cet exemple](#with-custom-error-shape). ### Options -| Option | Défaut | Description | -| ---------------- | ------------------- | -------------------------------------------------------------------------------- | -| `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. | -| `vicmd_symbol` | `"[❮](bold green)"` | The format string used before the text input if the shell is in vim normal mode. | -| `disabled` | `false` | Disables the `character` module. | +| Option | Défaut | Description | +| ---------------- | ------------------- | ----------------------------------------------------------------------------- | +| `format` | `"$symbol "` | Le format utilisée avant l'entrée de texte. | +| `success_symbol` | `"[❯](bold green)"` | Le format utilisé avant l'entrée de texte si la commande précédente a réussi. | +| `error_symbol` | `"[❯](bold red)"` | Le format utilisé avant l'entrée de texte si la commande précédente a échoué. | +| `vicmd_symbol` | `"[❮](bold green)"` | Le format utilisé avant l'entrée de texte si le shell est en mode vim normal. | +| `disabled` | `false` | Désactive le module `character`. | ### Variables -| Variable | Exemple | Description | -| -------- | ------- | --------------------------------------------------------------------- | -| symbol | | A mirror of either `success_symbol`, `error_symbol` or `vicmd_symbol` | +| Variable | Exemple | Description | +| -------- | ------- | --------------------------------------------------------------- | +| symbol | | Reflète sois `success_symbol`, `error_symbol` ou `vicmd_symbol` | ### Exemples @@ -420,25 +420,25 @@ vicmd_symbol = "[V](bold green) " ## CMake -The `cmake` module shows the currently installed version of CMake if any of the following conditions are met: +Le module `cmake` affiche la version actuellement installée de CMake si l'une des conditions suivantes est remplie : - Le répertoire actuel contient un fichier `CMakeLists.txt` - Le répertoire actuel contient un fichier ` CMakeCache.txt` ### Options -| Option | Défaut | Description | -| ---------- | ---------------------------------- | -------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | Format du module. | -| `symbol` | `"喝 "` | The symbol used before the version of cmake. | -| `style` | `"bold blue"` | Le style du module. | -| `disabled` | `false` | Disables the `cmake` module. | +| Option | Défaut | Description | +| ---------- | ---------------------------------- | --------------------------------------------- | +| `format` | `"via [$symbol$version]($style) "` | Format du module. | +| `symbol` | `"喝 "` | Le symbole utilisé avant la version de cmake. | +| `style` | `"bold blue"` | Le style du module. | +| `disabled` | `false` | Désactive le module `cmake`. | ### Variables | Variable | Exemple | Description | | --------- | --------- | -------------------------------------- | -| version | `v3.17.3` | The version of cmake | +| version | `v3.17.3` | La version de cmake | | symbol | | Reflète la valeur de l'option `symbol` | | style\* | | Reflète la valeur de l'option `style` | @@ -446,27 +446,27 @@ The `cmake` module shows the currently installed version of CMake if any of the ## Temps d'exécution -The `cmd_duration` module shows how long the last command took to execute. The module will be shown only if the command took longer than two seconds, or the `min_time` config value, if it exists. +Le module `cmd_duration` montre le temps qu'a pris la dernière commande a pris pour s'exécuter. Le module ne sera affiché que si la commande a pris plus de deux secondes, ou si la valeur de configuration `min_time` existe. -::: warning Do not hook the DEBUG trap in Bash +::: attention, n'accrochez pas la trappe DEBUG en Bash -If you are running Starship in `bash`, do not hook the `DEBUG` trap after running `eval $(starship init $0)`, or this module **will** break. +Si vous utilisez starship en `bash`, n'accrochez pas `DEBUG` après avoir exécuté `eval $(starship init $0)`, ou ce module **cassera**. ::: -Bash users who need preexec-like functionality can use [rcaloras's bash_preexec framework](https://github.com/rcaloras/bash-preexec). Simply define the arrays `preexec_functions` and `precmd_functions` before running `eval $(starship init $0)`, and then proceed as normal. +Les utilisateurs de Bash qui ont besoin de fonctionnalité pré-exec peuvent utiliser [rcaloras's bash_preexec framework](https://github.com/rcaloras/bash-preexec). Définissez simplement les array `preexec_functions` et `precmd_functions` avant d'éxécuter `eval $(starship init $0)`, puis procédez comme d'habitude. ### Options -| Option | Défaut | Description | -| -------------------- | ----------------------------- | ---------------------------------------------------------- | -| `min_time` | `2_000` | Shortest duration to show time for (in milliseconds). | -| `show_milliseconds` | `false` | Show milliseconds in addition to seconds for the duration. | -| `format` | `"took [$duration]($style) "` | Format du module. | -| `style` | `"bold yellow"` | Le style du module. | -| `disabled` | `false` | Disables the `cmd_duration` module. | -| `show_notifications` | `false` | Show desktop notifications when command completes. | -| `min_time_to_notify` | `45_000` | Shortest duration for notification (in milliseconds). | +| Option | Défaut | Description | +| -------------------- | ----------------------------- | ---------------------------------------------------------------------- | +| `min_time` | `2_000` | Durée la plus courte quand afficher le temps (en millisecondes). | +| `show_milliseconds` | `false` | Afficher les millisecondes en plus des secondes pendant la durée. | +| `format` | `"took [$duration]($style) "` | Format du module. | +| `style` | `"bold yellow"` | Le style du module. | +| `disabled` | `false` | Désactive le module `cmd_duration`. | +| `show_notifications` | `false` | Afficher les notifications du bureau lorsque la commande est terminée. | +| `min_time_to_notify` | `45_000` | Shortest duration for notification (in milliseconds). | ::: tip @@ -476,10 +476,10 @@ Showing desktop notifications requires starship to be built with `rust-notify` s ### Variables -| Variable | Exemple | Description | -| --------- | -------- | --------------------------------------- | -| duration | `16m40s` | The time it took to execute the command | -| style\* | | Reflète la valeur de l'option `style` | +| Variable | Exemple | Description | +| --------- | -------- | --------------------------------------------- | +| duration | `16m40s` | Le temps nécessaire pour exécuter la commande | +| style\* | | Reflète la valeur de l'option `style` | \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style @@ -495,32 +495,32 @@ format = "underwent [$duration](bold yellow)" ## Conda -The `conda` module shows the current conda environment, if `$CONDA_DEFAULT_ENV` is set. +Le module `conda` affiche l'environnement conda actuel, si `$CONDA_DEFAULT_ENV` est défini. ::: tip -This does not suppress conda's own prompt modifier, you may want to run `conda config --set changeps1 False`. +Cela ne supprime pas le modificateur d'invite de conda, vous pouvez exécuter `conda config --set changeps1 False`. ::: ### Options -| Option | Défaut | Description | -| ------------------- | -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `truncation_length` | `1` | The number of directories the environment path should be truncated to, if the environment was created via `conda create -p [path]`. `0` means no truncation. Also see the [`directory`](#directory) module. | -| `symbol` | `"🅒 "` | The symbol used before the environment name. | -| `style` | `"bold green"` | Le style du module. | -| `format` | `"via [$symbol$environment]($style) "` | Format du module. | -| `ignore_base` | `true` | Ignores `base` environment when activated. | -| `disabled` | `false` | Disables the `conda` module. | +| Option | Défaut | Description | +| ------------------- | -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `truncation_length` | `1` | Le nombre de répertoires dans lesquels le chemin d'environnement (Path) doit être tronqué, si l'environnement a été créé via `conda create -p [path]`. `0` ne signifie pas de troncature. Regardez aussi le module [`directory`](#directory). | +| `symbol` | `"🅒 "` | Le symbole utilisé avant le nom d'environnement. | +| `style` | `"bold green"` | Le style du module. | +| `format` | `"via [$symbol$environment]($style) "` | Format du module. | +| `ignore_base` | `true` | Ignore l'environnement `base` lorsqu'il est activé. | +| `disabled` | `false` | Désactive le module `conda`. | ### Variables -| Variable | Exemple | Description | -| ----------- | ------------ | -------------------------------------- | -| environment | `astronauts` | The current conda environment | -| symbol | | Reflète la valeur de l'option `symbol` | -| style\* | | Reflète la valeur de l'option `style` | +| Variable | Exemple | Description | +| ------------- | ------------ | -------------------------------------- | +| environnement | `astronauts` | La version courante de conda | +| symbol | | Reflète la valeur de l'option `symbol` | +| style\* | | Reflète la valeur de l'option `style` | \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style @@ -535,25 +535,25 @@ format = "[$symbol$environment](dimmed green) " ## Crystal -The `crystal` module shows the currently installed version of Crystal. Le module est affiché si l'une des ces conditions est remplie : +Le module `crystal` affiche la version actuellement installée de Crystal. Le module est affiché si l'une des ces conditions est remplie : - Le répertoire courant contient un fichier `shard.yml` - Le répertoire courant contient un fichier `.cr` ### Options -| Option | Défaut | Description | -| ---------- | ---------------------------------- | --------------------------------------------------------- | -| `symbol` | `"🔮 "` | The symbol used before displaying the version of crystal. | -| `style` | `"bold red"` | Le style du module. | -| `format` | `"via [$symbol$version]($style) "` | Format du module. | -| `disabled` | `false` | Disables the `crystal` module. | +| Option | Défaut | Description | +| ---------- | ---------------------------------- | ---------------------------------------------------------- | +| `symbol` | `"🔮 "` | Le symbole utilisé avant d'afficher la version de crystal. | +| `style` | `"bold green"` | Le style du module. | +| `format` | `"via [$symbol$version]($style) "` | Format du module. | +| `disabled` | `false` | Désactive le module `crystal`. | ### Variables | Variable | Exemple | Description | | --------- | --------- | -------------------------------------- | -| version | `v0.32.1` | The version of `crystal` | +| version | `v0.32.1` | La version de `cristal` | | symbol | | Reflète la valeur de l'option `symbol` | | style\* | | Reflète la valeur de l'option `style` | @@ -570,7 +570,7 @@ format = "via [✨ $version](bold blue) " ## Dart -The `dart` module shows the currently installed version of Dart. Le module est affiché si l'une des ces conditions est remplie : +Le module `crystal` affiche la version courante installée de Dart. Le module est affiché si l'une des ces conditions est remplie : - Le répertoire courant contient un fichier `.dart` - Le répertoire courant contient un répertoire `.dart_tool` @@ -578,18 +578,18 @@ The `dart` module shows the currently installed version of Dart. Le module est a ### Options -| Option | Défaut | Description | -| ---------- | ---------------------------------- | ----------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | Format du module. | -| `symbol` | `"🎯 "` | A format string representing the symbol of Dart | -| `style` | `"bold blue"` | Le style du module. | -| `disabled` | `false` | Disables the `dart` module. | +| Option | Défaut | Description | +| ---------- | ---------------------------------- | -------------------------------------------------------- | +| `format` | `"via [$symbol$version]($style) "` | Format du module. | +| `symbol` | `"🎯 "` | Une chaîne de caractères représentant le symbole de Dart | +| `style` | `"bold blue"` | Le style du module. | +| `disabled` | `false` | Désactive le module `dart`. | ### Variables | Variable | Exemple | Description | | --------- | -------- | -------------------------------------- | -| version | `v2.8.4` | The version of `dart` | +| version | `v2.8.4` | La version de `dart` | | symbol | | Reflète la valeur de l'option `symbol` | | style\* | | Reflète la valeur de l'option `style` | @@ -606,31 +606,31 @@ format = "via [🔰 $version](bold red) " ## Dossier -The `directory` module shows the path to your current directory, truncated to three parent folders. Your directory will also be truncated to the root of the git repo that you're currently in. +Le mode `directory` montre le chemin de votre dossier actuel, tronqué au 3 dossiers parents. Votre répertoire sera également tronqué à la racine du repo git dans lequel vous vous trouvez actuellement. -When using the fish style pwd 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. +Quand vous utilisez le style pwd de fish, au lieu de cacher le chemin qui est troqué, vous verrez un nom raccourcis de chaque dossiers basés sur le nombre établi pour l'option. -For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, and the option set to `1`. You will now see `~/D/N/nixpkgs/pkgs`, whereas before it would have been `nixpkgs/pkgs`. +Par exemple, donné `~/Dev/Nix/nixpkgs/pkgs` où `nixpkgs` est la racine du repo, et l'option définie à `1`. Vous verrez maintenant `~/D/N/nixpkgs/pkgs`, alors que vous auriez vu `nixpkgs/pkgs` avant. ### Options -| Option | Défaut | Description | -| ------------------- | -------------------------------------------------- | -------------------------------------------------------------------------------- | -| `truncation_length` | `3` | The number of parent folders that the current directory should be truncated to. | -| `truncate_to_repo` | `true` | Whether or not to truncate to the root of the git repo that you're currently in. | -| `format` | `"[$path]($style)[$read_only]($read_only_style) "` | Format du module. | -| `style` | `"bold cyan"` | Le style du module. | -| `disabled` | `false` | Disables the `directory` module. | -| `read_only` | `"🔒"` | The symbol indicating current directory is read only. | -| `read_only_style` | `"red"` | The style for the read only symbol. | -| `truncation_symbol` | `""` | The symbol to prefix to truncated paths. eg: "…/" | +| Option | Défaut | Description | +| ------------------- | -------------------------------------------------- | ------------------------------------------------------------------------------------- | +| `truncation_length` | `3` | Le nombre de dossiers parents selon lesquels le répertoire courant doit être tronqué. | +| `truncate_to_repo` | `true` | Si oui ou non tronquer à la racine du repo git dans lequel vous vous trouvez. | +| `format` | `"[$path]($style)[$read_only]($read_only_style) "` | Format du module. | +| `style` | `"bold cyan"` | Le style du module. | +| `disabled` | `false` | Désactive le module `directory`. | +| `read_only` | `"🔒"` | Le symbole indiquant que le répertoire courant est en lecture seule. | +| `read_only_style` | `"red"` | Le style du symbole en lecture seule. | +| `truncation_symbol` | `""` | Le symbole en préfixe aux chemins tronqués. eg: "…/" |
-This module has a few advanced configuration options that control how the directory is displayed. +Ce module possède quelques options de configuration avancées qui contrôlent l'affichage du répertoire. -| Advanced Option | Défaut | Description | +| Options avancées | Défaut | Description | | --------------------------- | ------ | ---------------------------------------------------------------------------------------- | -| `substitutions` | | A table of substitutions to be made to the path. | +| `substitutions` | | Table de substitutions à faire au chemin. | | `fish_style_pwd_dir_length` | `0` | The number of characters to use when applying fish shell pwd path logic. | | `use_logical_path` | `true` | Displays the logical path provided by the shell (`PWD`) instead of the path from the OS. | @@ -650,7 +650,7 @@ For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, an | Variable | Exemple | Description | | --------- | --------------------- | ------------------------------------- | -| path | `"D:/Projects"` | The current directory path | +| path | `"D:/Projects"` | Le chemin du répertoire courant | | style\* | `"black bold dimmed"` | Reflète la valeur de l'option `style` | \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style @@ -677,7 +677,7 @@ The `docker_context` module shows the currently active [Docker context](https:// | `symbol` | `"🐳 "` | The symbol used before displaying the Docker context. | | `style` | `"blue bold"` | Le style du module. | | `only_with_files` | `false` | Only show when there's a `docker-compose.yml` or `Dockerfile` in the current directory. | -| `disabled` | `true` | Disables the `docker_context` module. | +| `disabled` | `true` | Désactive le module `docker_context`. | ### Variables @@ -728,13 +728,13 @@ The module will also show the Target Framework Moniker ( "` | The symbol used before displaying the version of PureScript. | -| `style` | `"bold white"` | Le style du module. | -| `disabled` | `false` | Disables the `purescript` module. | +| Option | Défaut | Description | +| ---------- | ---------------------------------- | ------------------------------------------------------------- | +| `format` | `"via [$symbol$version]($style) "` | Format du module. | +| `symbol` | `"<=> "` | Le symbole utilisé avant d'afficher la version de PureScript. | +| `style` | `"bold white"` | Le style du module. | +| `disabled` | `false` | Désactive le module `purescript`. | ### Variables @@ -1951,8 +1951,8 @@ Le module est affiché si l'une des ces conditions est remplie : - The current directory contains a `pyproject.toml` file - The current directory contains a file with the `.py` extension (and `scan_for_pyfiles` is true) - The current directory contains a `Pipfile` file -- The current directory contains a `tox.ini` file -- The current directory contains a `setup.py` file +- Le répertoire courant contient un fichier `tox.ini` +- Le répertoire courant contient un fichier `setup.py` - The current directory contains a `__init__.py` file - A virtual environment is currently activated @@ -2020,7 +2020,7 @@ The `ruby` module shows the currently installed version of Ruby. Le module est a | ---------- | ---------------------------------- | ------------------------------------------------ | | `format` | `"via [$symbol$version]($style) "` | Format du module. | | `symbol` | `"💎 "` | A format string representing the symbol of Ruby. | -| `style` | `"bold red"` | Le style du module. | +| `style` | `"bold green"` | Le style du module. | | `disabled` | `false` | Disables the `ruby` module. | ### Variables @@ -2055,7 +2055,7 @@ The `rust` module shows the currently installed version of Rust. Le module est a | ---------- | ---------------------------------- | ----------------------------------------------- | | `format` | `"via [$symbol$version]($style) "` | Format du module. | | `symbol` | `"🦀 "` | A format string representing the symbol of Rust | -| `style` | `"bold red"` | Le style du module. | +| `style` | `"bold green"` | Le style du module. | | `disabled` | `false` | Disables the `rust` module. | ### Variables @@ -2151,7 +2151,9 @@ The `status` module displays the exit code of the previous command. The module w ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. ::: +Ce module est désactivé par défaut. Pour l'activer, configurez `disabled` sur `false` dans votre fichier de configuration. + +::: ### Options @@ -2163,7 +2165,7 @@ This module is disabled by default. To enable it, set `disabled` to `false` in y | `not_found_symbol` | `"🔍"` | The symbol displayed when the command can't be found | | `sigint_symbol` | `"🧱"` | The symbol displayed on SIGINT (Ctrl + c) | | `signal_symbol` | `"⚡"` | The symbol displayed on any signal | -| `style` | `"bold red"` | Le style du module. | +| `style` | `"bold green"` | Le style du module. | | `recognize_signal_code` | `true` | Enable signal mapping from exit code | | `map_symbol` | `false` | Enable symbols mapping from exit code | | `disabled` | `true` | Disables the `status` module. | @@ -2254,7 +2256,7 @@ The `terraform` module shows the currently selected terraform workspace and vers | Variable | Exemple | Description | | --------- | ---------- | -------------------------------------- | | version | `v0.12.24` | The version of `terraform` | -| workspace | `default` | The current terraform workspace | +| workspace | `défaut` | The current terraform workspace | | symbol | | Reflète la valeur de l'option `symbol` | | style\* | | Reflète la valeur de l'option `style` | @@ -2286,21 +2288,21 @@ The `time` module shows the current **local** time. The `format` configuration v ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. +Ce module est désactivé par défaut. Pour l'activer, configurez `disabled` sur `false` dans votre fichier de configuration. ::: ### Options -| Option | Défaut | Description | -| ----------------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | -| `format` | `"at [$time]($style) "` | The format string for the module. | -| `use_12hr` | `false` | Enables 12 hour formatting | -| `time_format` | see below | The [chrono format string](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) used to format the time. | -| `style` | `"bold yellow"` | The style for the module time | -| `utc_time_offset` | `"local"` | Sets the UTC offset to use. Range from -24 < x < 24. Allows floats to accommodate 30/45 minute timezone offsets. | -| `disabled` | `true` | Disables the `time` module. | -| `time_range` | `"-"` | Sets the time range during which the module will be shown. Times must be specified in 24-hours format | +| Option | Défaut | Description | +| ----------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `format` | `"at [$time]($style) "` | The format string for the module. | +| `use_12hr` | `false` | Activer le format 12h | +| `time_format` | voir plus bas | Le [format chrono](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) utilisé pour formater l'heure. | +| `style` | `"bold yellow"` | Le style utilisé par le module | +| `utc_time_offset` | `"local"` | Définir le décalage horaire UTC à utiliser. Range from -24 < x < 24. Accepte des nombres décimaux pour s'adapter aux décalages de 30/45 minutes. | +| `disabled` | `true` | Désactiver le module `time`. | +| `time_range` | `"-"` | Sets the time range during which the module will be shown. Times must be specified in 24-hours format | If `use_12hr` is `true`, then `time_format` defaults to `"%r"`. Otherwise, it defaults to `"%T"`. Manually setting `time_format` will override the `use_12hr` setting. @@ -2308,7 +2310,7 @@ If `use_12hr` is `true`, then `time_format` defaults to `"%r"`. Otherwise, it de | Variable | Exemple | Description | | --------- | ---------- | ------------------------------------- | -| time | `13:08:10` | The current time. | +| temps | `13:08:10` | The current time. | | style\* | | Reflète la valeur de l'option `style` | \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style @@ -2326,26 +2328,30 @@ utc_time_offset = "-5" time_range = "10:00:00-14:00:00" ``` -## Username +## Nom d'utilisateur The `username` module shows active user's username. Le module est affiché si l'une des ces conditions est remplie : -- The current user is root -- The current user isn't the same as the one that is logged in -- The user is currently connected as an SSH session -- The variable `show_always` is set to true +- L'utilisateur courant est root +- L'utilisateur courant est différent de celui connecté +- L'utilisateur est actuellement connecté à une session SSH +- La variable `show_always` a comme valeur true -::: tip SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. ::: +::: tip + +SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. + +::: ### Options -| Option | Défaut | Description | -| ------------- | ----------------------- | ------------------------------------- | -| `style_root` | `"bold red"` | The style used when the user is root. | -| `style_user` | `"bold yellow"` | The style used for non-root users. | -| `format` | `"[$user]($style) in "` | Format du module. | -| `show_always` | `false` | Always shows the `username` module. | -| `disabled` | `false` | Disables the `username` module. | +| Option | Défaut | Description | +| ------------- | ----------------------- | ------------------------------------------------ | +| `style_root` | `"bold green"` | Le style utilisé quand l'utilisateur est root. | +| `style_user` | `"bold yellow"` | Le style utilisé pour les utilisateurs non-root. | +| `format` | `"[$user]($style) in "` | Format du module. | +| `show_always` | `false` | Toujours afficher le module `username`. | +| `disabled` | `false` | Désactiver le module `username`. | ### Variables @@ -2460,7 +2466,7 @@ The order in which custom modules are shown can be individually set by including `shell` accepts a non-empty list of strings, where: -- The first string is the path to the shell to use to execute the command. +- La première chaîne est le chemin vers le shell à utiliser pour exécuter la commande. - 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. diff --git a/docs/fr-FR/guide/README.md b/docs/fr-FR/guide/README.md index 845fad4c..80a92bd3 100644 --- a/docs/fr-FR/guide/README.md +++ b/docs/fr-FR/guide/README.md @@ -125,6 +125,8 @@ ### Démarrage rapide +**Note**: due to the proliferation of different platforms, only a subset of supported platforms are shown below. Can't see yours? Have a look at the [extra platform instructions](https://starship.rs/installing/). + 1. Installer l'exécutable **starship** : @@ -138,17 +140,10 @@ ``` - ##### Depuis la source sur [crates.io](https://crates.io/): - - ```sh - cargo install starship - ``` - - #### Installer via le gestionnaire de paquets - ##### Avec [Homebrew](https://brew.sh/): + ##### Example: [Homebrew](https://brew.sh/): ```sh brew install starship @@ -161,7 +156,7 @@ scoop install starship ``` -1. Ajouter le script d’initialisation au fichier de configuration de votre shell: +2. Ajouter le script d’initialisation au fichier de configuration de votre shell: #### Bash diff --git a/docs/fr-FR/installing/README.md b/docs/fr-FR/installing/README.md new file mode 100644 index 00000000..6f0ea0d6 --- /dev/null +++ b/docs/fr-FR/installing/README.md @@ -0,0 +1,46 @@ +# 🚀 Advanced Installation + +To install starship, you need to do two things: + +1. Get the **starship** binary onto your computer +1. Tell your shell to use the starship binary as its prompt by modifying its init scripts + +For most users, the instructions on [the main page](/guide/#🚀-installation) will work great. However, for some more specialized platforms, different instructions are needed. + +There are so many platforms out there that they didn't fit into the main README.md file, so here are some installation instructions for other platforms from the community. Is yours not here? Please do add it here if you figure it out! + +## [Nix](https://nixos.wiki/wiki/Nix) + +### Getting the Binary + +#### Imperatively + +```sh +nix-env -iA nixos.starship +``` + +#### Declarative, single user, via [home-manager](home-manager) + +Add `pkgs.starship` to your `home.packages` in your `home.nix` file, then run + +```sh +home-manager switch +``` + +#### Declarative, system-wide, with NixOS + +Add `pkgs.starship` to `environment.packages` in your `configuration.nix`, then run + +```sh +sudo nixos-rebuild switch +``` + +### Modifying Init Scripts + +#### With Nix and home-manager, using zsh: + +Add the following to `programs.zsh.initExtra` in your `home.nix` file, then run + +```sh +home-manager switch +``` diff --git a/docs/it-IT/README.md b/docs/it-IT/README.md index b22afa4a..29b05b7a 100644 --- a/docs/it-IT/README.md +++ b/docs/it-IT/README.md @@ -44,7 +44,7 @@ description: Starship è il prompt minimalista, super veloce ed estremamente per #### Installa con Package Manager - With [Homebrew](https://brew.sh/): + Con [Homebrew](https://brew.sh/): ```sh brew install starship diff --git a/docs/it-IT/config/README.md b/docs/it-IT/config/README.md index 90628f67..31490be6 100644 --- a/docs/it-IT/config/README.md +++ b/docs/it-IT/config/README.md @@ -1,4 +1,4 @@ -# Configuration +# Configurazione To get started configuring starship, create the following file: `~/.config/starship.toml`. @@ -825,7 +825,7 @@ The `elm` module shows the currently installed version of Elm. The module will b format = "via [ $version](cyan bold) " ``` -## Environment Variable +## Variabili di ambiente The `env_var` module displays the current value of a selected environment variable. The module will be shown only if any of the following conditions are met: @@ -1684,13 +1684,13 @@ The `nodejs` module shows the currently installed version of NodeJS. The module ### Options -| Option | Default | Description | -| ------------------- | ---------------------------------- | ----------------------------------------------------------------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | The format for the module. | -| `symbol` | `"⬢ "` | A format string representing the symbol of NodeJS. | -| `style` | `"bold green"` | The style for the module. | -| `disabled` | `false` | Disables the `nodejs` module. | -| `not_capable_style` | `bold red` | The style for the module when an engines property in Packages.json does not match the NodeJS version. | +| Option | Default | Description | +| ------------------- | ---------------------------------- | --------------------------------------------------------------------------------------------------------- | +| `format` | `"via [$symbol$version]($style) "` | The format for the module. | +| `symbol` | `"⬢ "` | A format string representing the symbol of NodeJS. | +| `style` | `"bold green"` | The style for the module. | +| `disabled` | `false` | Disables the `nodejs` module. | +| `not_capable_style` | `bold red` | Lo stile per il modulo quando una proprietà chiave in Packages.json non corrisponde alla versione NodeJS. | ###  Variables @@ -1798,19 +1798,19 @@ The `package` module is shown when the current directory is the repository for a - **mix** - The `mix` package version is extracted from the `mix.exs` present - **helm** - The `helm` chart version is extracted from the `Chart.yaml` present - **maven** - The `maven` package version is extracted from the `pom.xml` present -- **meson** - The `meson` package version is extracted from the `meson.build` present +- **meson** - La versione del pacchetto `meson` è estratta dal `meson.build` presente > ⚠️ The version being shown is that of the package whose source code is in your current directory, not your package manager. ### Options -| Option | Default | Description | -| ----------------- | ---------------------------------- | ---------------------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | The format for the module. | -| `symbol` | `"📦 "` | The symbol used before displaying the version the package. | -| `style` | `"bold 208"` | The style for the module. | -| `display_private` | `false` | Enable displaying version for packages marked as private. | -| `disabled` | `false` | Disables the `package` module. | +| Option | Default | Description | +| ----------------- | --------------------------------- | ---------------------------------------------------------- | +| `format` | `"is [$symbol$version]($style) "` | The format for the module. | +| `symbol` | `"📦 "` | The symbol used before displaying the version the package. | +| `style` | `"bold 208"` | The style for the module. | +| `display_private` | `false` | Enable displaying version for packages marked as private. | +| `disabled` | `false` | Disables the `package` module. | ### Variables @@ -2151,7 +2151,9 @@ The `status` module displays the exit code of the previous command. The module w ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. ::: +This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. + +::: ### Options @@ -2335,7 +2337,11 @@ The `username` module shows active user's username. The module will be shown if - The user is currently connected as an SSH session - The variable `show_always` is set to true -::: tip SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. ::: +::: tip + +SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. + +::: ### Options diff --git a/docs/it-IT/guide/README.md b/docs/it-IT/guide/README.md index 709fabb6..b72b9372 100644 --- a/docs/it-IT/guide/README.md +++ b/docs/it-IT/guide/README.md @@ -125,6 +125,8 @@ ### Inizia +**Note**: due to the proliferation of different platforms, only a subset of supported platforms are shown below. Can't see yours? Have a look at the [extra platform instructions](https://starship.rs/installing/). + 1. Installa il binario **starship**: @@ -138,17 +140,10 @@ ``` - ##### Da un sorgente su [crates.io](https://crates.io/): - - ```sh - cargo install starship - ``` - - #### Installa via Package Manager - ##### Con [Homebrew](https://brew.sh/): + ##### Example: [Homebrew](https://brew.sh/): ```sh brew install starship @@ -161,7 +156,7 @@ scoop install starship ``` -1. Aggiungi lo script di inizializzazione al file di configurazione della shell: +2. Aggiungi lo script di inizializzazione al file di configurazione della shell: #### Bash @@ -231,7 +226,7 @@ Questi progetto esiste grazie a tutte le persone che contribuiscono. [[Contribut ### Contributori Finanziari -Diventa un contributore finanziario e aiutaci a sostenere la nostra comunità. [[Contribute](https://opencollective.com/starship/contribute)] +Diventa un contributore finanziario e aiutaci a sostenere la nostra comunità. [[Contribuisci](https://opencollective.com/starship/contribute)] #### Privati diff --git a/docs/it-IT/installing/README.md b/docs/it-IT/installing/README.md new file mode 100644 index 00000000..6f0ea0d6 --- /dev/null +++ b/docs/it-IT/installing/README.md @@ -0,0 +1,46 @@ +# 🚀 Advanced Installation + +To install starship, you need to do two things: + +1. Get the **starship** binary onto your computer +1. Tell your shell to use the starship binary as its prompt by modifying its init scripts + +For most users, the instructions on [the main page](/guide/#🚀-installation) will work great. However, for some more specialized platforms, different instructions are needed. + +There are so many platforms out there that they didn't fit into the main README.md file, so here are some installation instructions for other platforms from the community. Is yours not here? Please do add it here if you figure it out! + +## [Nix](https://nixos.wiki/wiki/Nix) + +### Getting the Binary + +#### Imperatively + +```sh +nix-env -iA nixos.starship +``` + +#### Declarative, single user, via [home-manager](home-manager) + +Add `pkgs.starship` to your `home.packages` in your `home.nix` file, then run + +```sh +home-manager switch +``` + +#### Declarative, system-wide, with NixOS + +Add `pkgs.starship` to `environment.packages` in your `configuration.nix`, then run + +```sh +sudo nixos-rebuild switch +``` + +### Modifying Init Scripts + +#### With Nix and home-manager, using zsh: + +Add the following to `programs.zsh.initExtra` in your `home.nix` file, then run + +```sh +home-manager switch +``` diff --git a/docs/ja-JP/advanced-config/README.md b/docs/ja-JP/advanced-config/README.md index 799a0414..b2d47a9c 100644 --- a/docs/ja-JP/advanced-config/README.md +++ b/docs/ja-JP/advanced-config/README.md @@ -82,7 +82,7 @@ starship_precmd_user_func="set_win_title" ここで、 `` は色を指定します（以下で述べます）。 `fg:` と `` は現在同様の動作ですが、将来変更される可能性があります。 文字列中の単語の順序は関係ありません。 -The `none` token overrides all other tokens in a string if it is not part of a `bg:` specifier, so that e.g. `fg:red none fg:blue` will still create a string with no styling. `bg:none` sets the background to the default color so `fg:red bg:none` is equivalent to `red` or `fg:red` and `bg:green fg:red bg:none` is also equivalent to `fg:red` or `red`. It may become an error to use `none` in conjunction with other tokens in the future. +The `none` token overrides all other tokens in a string if it is not part of a `bg:` specifier, so that e.g. `fg:red none fg:blue` will still create a string with no styling. `bg:none` sets the background to the default color so `fg:red bg:none` is equivalent to `red` or `fg:red` and `bg:green fg:red bg:none` is also equivalent to `fg:red` or `red`. 将来 `none` を他の単語と一緒に使用することはエラーになるかもしれません。 色は以下のいずれか1つを指定できます。 diff --git a/docs/ja-JP/config/README.md b/docs/ja-JP/config/README.md index 4620a9c6..9efac3dc 100644 --- a/docs/ja-JP/config/README.md +++ b/docs/ja-JP/config/README.md @@ -304,16 +304,16 @@ symbol = "🅰 " ### オプション -| オプション | デフォルト | 説明 | -| -------------------- | --------------------------------- | --------------------------------------------------- | -| `full_symbol` | `""` | バッテリーが満タンのときに表示される記号です。 | -| `charging_symbol` | `""` | バッテリーの充電中に表示される記号です。 | -| `discharging_symbol` | `""` | バッテリーが放電しているときに表示される記号です。 | -| `unknown_symbol` | `""` | The symbol shown when the battery state is unknown. | -| `empty_symbol` | `""` | The symbol shown when the battery state is empty. | -| `format` | `"[$symbol$percentage]($style) "` | moduleのフォーマットです。 | -| `display` | [link](#battery-display) | Display threshold and style for the module. | -| `disabled` | `false` | Disables the `battery` module. | +| オプション | デフォルト | 説明 | +| -------------------- | --------------------------------- | ------------------------- | +| `full_symbol` | `""` | バッテリーが満タンのときに表示される記号です。 | +| `charging_symbol` | `""` | バッテリーの充電中に表示される記号です。 | +| `discharging_symbol` | `""` | バッテリーが放電しているときに表示される記号です。 | +| `unknown_symbol` | `""` | バッテリー状態が不明なときに表示される記号です。 | +| `empty_symbol` | `""` | バッテリーが空のときに表示される記号です。 | +| `format` | `"[$symbol$percentage]($style) "` | moduleのフォーマットです。 | +| `display` | [link](#battery-display) | モジュールの閾値とスタイルを表示します。 | +| `disabled` | `false` | `battery`モジュールを無効にします。 | ### 設定例 @@ -329,7 +329,7 @@ discharging_symbol = "💀" ### バッテリーの表示 -The `display` configuration option is used to define when the battery indicator should be shown (threshold) and what it looks like (style). If no `display` is provided. デフォルトは次のとおりです。 +`display` オプションを使用して、バッテリーインジケーターを表示するタイミング（閾値）と外観（スタイル）を定義します。 `display` が提供されない場合、 デフォルトは次のとおりです。 ```toml [[battery.display]] @@ -339,12 +339,12 @@ style = "bold red" #### オプション -The `display` option is an array of the following table. +`display`オプションは、次の表の通りです。 -| オプション | 説明 | -| ----------- | ----------------------------------------------- | -| `threshold` | The upper bound for the display option. | -| `style` | The style used if the display option is in use. | +| オプション | 説明 | +| ----------- | ------------------------------ | +| `threshold` | バッテリーが表示される上限です。 | +| `style` | displayオプションが使用されている場合のスタイルです。 | #### 設定例 @@ -363,14 +363,14 @@ style = "bold yellow" ## 文字 -The `character` module shows a character (usually an arrow) beside where the text is entered in your terminal. +`character`モジュールは、端末でテキストが入力される場所の横に文字（通常は矢印）を表示します。 -The character will tell you whether the last command was successful or not. It can do this in two ways: +文字は、最後のコマンドが成功したかどうかを示します。 表し方は下記の2つです。 - 色の変更 (`赤`/`緑`) - プロンプトの表示の変更 (`❯`/`✖`) -By default it only changes color. If you also want to change it's shape take a look at [this example](#with-custom-error-shape). +デフォルトでは、色だけが変更されます。 If you also want to change it's shape take a look at [this example](#with-custom-error-shape). ### オプション @@ -380,7 +380,7 @@ By default it only changes color. If you also want to change it's shape take a l | `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. | | `vicmd_symbol` | `"[❮](bold green)"` | The format string used before the text input if the shell is in vim normal mode. | -| `disabled` | `false` | Disables the `character` module. | +| `disabled` | `false` | `character`モジュールを無効にします。 | ### 変数 @@ -447,27 +447,27 @@ The `cmake` module shows the currently installed version of CMake if any of the ## コマンド実行時間 -The `cmd_duration` module shows how long the last command took to execute. The module will be shown only if the command took longer than two seconds, or the `min_time` config value, if it exists. +`cmd_duration`モジュールは、最後のコマンドの実行にかかった時間を示します。 モジュールが表示されるのは、コマンドが2秒以上かかった場合、または`min_time`値が存在する場合のみです。 -::: warning Do not hook the DEBUG trap in Bash +::: warning BashでDEBUGトラップをhookしない -If you are running Starship in `bash`, do not hook the `DEBUG` trap after running `eval $(starship init $0)`, or this module **will** break. +`bash`でStarshipを実行している場合、 `eval $(starship init $0)`実行した後に`DEBUG`トラップをフックしないでください。そうしないと、このモジュールが**おそらくですが**壊れます。 ::: -Bash users who need preexec-like functionality can use [rcaloras's bash_preexec framework](https://github.com/rcaloras/bash-preexec). Simply define the arrays `preexec_functions` and `precmd_functions` before running `eval $(starship init $0)`, and then proceed as normal. +preexecのような機能を必要とするBashユーザーは、 [rcalorasのbash_preexecフレームワーク](https://github.com/rcaloras/bash-preexec)を使用できます。 `eval $(starship init $0)` を実行する前に、`preexec_functions`、および`precmd_functions`定義するだけで、通常どおり続行します。 ### オプション -| オプション | デフォルト | 説明 | -| -------------------- | ----------------------------- | ---------------------------------------------------------- | -| `min_time` | `2_000` | Shortest duration to show time for (in milliseconds). | -| `show_milliseconds` | `false` | Show milliseconds in addition to seconds for the duration. | -| `format` | `"took [$duration]($style) "` | moduleのフォーマットです。 | -| `style` | `"bold yellow"` | モジュールのスタイルです。 | -| `disabled` | `false` | Disables the `cmd_duration` module. | -| `show_notifications` | `false` | Show desktop notifications when command completes. | -| `min_time_to_notify` | `45_000` | Shortest duration for notification (in milliseconds). | +| オプション | デフォルト | 説明 | +| -------------------- | ----------------------------- | ----------------------------------------------------- | +| `min_time` | `2_000` | 実行時間を表示する最短期間（ミリ秒単位）です。 | +| `show_milliseconds` | `false` | 実行時間の秒に加えてミリ秒を表示します。 | +| `format` | `"took [$duration]($style) "` | moduleのフォーマットです。 | +| `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). | ::: tip @@ -477,10 +477,10 @@ Showing desktop notifications requires starship to be built with `rust-notify` s ### 変数 -| 変数 | 設定例 | 説明 | -| --------- | -------- | --------------------------------------- | -| duration | `16m40s` | The time it took to execute the command | -| style\* | | オプション `style` の値をミラーする | +| 変数 | 設定例 | 説明 | +| --------- | -------- | ---------------------- | +| duration | `16m40s` | コマンドの実行時間 | +| style\* | | オプション `style` の値をミラーする | \*: この変数はスタイル文字列の一部としてのみ使用できます @@ -496,24 +496,24 @@ format = "underwent [$duration](bold yellow)" ## Conda -The `conda` module shows the current conda environment, if `$CONDA_DEFAULT_ENV` is set. +`$CONDA_DEFAULT_ENV`が設定されている場合、`conda`モジュールは現在のcondaの環境を表示します。 ::: tip -This does not suppress conda's own prompt modifier, you may want to run `conda config --set changeps1 False`. +Note: これはconda自身の プロンプト修飾子 を抑制しません。`conda config --set changeps1 False` で実行することができます。 ::: ### オプション -| オプション | デフォルト | 説明 | -| ------------------- | -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `truncation_length` | `1` | The number of directories the environment path should be truncated to, if the environment was created via `conda create -p [path]`. `0` means no truncation. Also see the [`directory`](#directory) module. | -| `symbol` | `"🅒 "` | The symbol used before the environment name. | -| `style` | `"bold green"` | モジュールのスタイルです。 | -| `format` | `"via [$symbol$environment]($style) "` | moduleのフォーマットです。 | -| `ignore_base` | `true` | Ignores `base` environment when activated. | -| `disabled` | `false` | Disables the `conda` module. | +| オプション | デフォルト | 説明 | +| ------------------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | +| `truncation_length` | `1` | 環境が`conda create -p [path]`で作成された場合、環境パスが切り捨てられるディレクトリ数。 `0`は切り捨てがないことを意味します。 [`directory`](#directory)もご覧ください。 | +| `symbol` | `"🅒 "` | 環境名の直前に使用されるシンボルです。 | +| `style` | `"bold green"` | モジュールのスタイルです。 | +| `format` | `"via [$symbol$environment]($style) "` | moduleのフォーマットです。 | +| `ignore_base` | `true` | Ignores `base` environment when activated. | +| `disabled` | `false` | `conda`モジュールを無効にします。 | ### 変数 @@ -536,19 +536,19 @@ format = "[$symbol$environment](dimmed green) " ## Crystal -The `crystal` module shows the currently installed version of Crystal. 次の条件のいずれかが満たされると、モジュールが表示されます。 +`crystal`モジュールには、現在インストールされているCrystalのバージョンが表示されます。 次の条件のいずれかが満たされると、モジュールが表示されます。 - カレントディレクトリに`shard.yml`ファイルが含まれている - カレントディレクトリに`.cr`の拡張子のファイルが含まれている ### オプション -| オプション | デフォルト | 説明 | -| ---------- | ---------------------------------- | --------------------------------------------------------- | -| `symbol` | `"🔮 "` | The symbol used before displaying the version of crystal. | -| `style` | `"bold red"` | モジュールのスタイルです。 | -| `format` | `"via [$symbol$version]($style) "` | moduleのフォーマットです。 | -| `disabled` | `false` | Disables the `crystal` module. | +| オプション | デフォルト | 説明 | +| ---------- | ---------------------------------- | ------------------------------ | +| `symbol` | `"🔮 "` | Crystalのバージョンを表示する前に使用される記号です。 | +| `style` | `"bold red"` | モジュールのスタイルです。 | +| `format` | `"via [$symbol$version]($style) "` | moduleのフォーマットです。 | +| `disabled` | `false` | `crystal`モジュールを無効にします。 | ### 変数 @@ -607,33 +607,33 @@ format = "via [🔰 $version](bold red) " ## ディレクトリ -The `directory` module shows the path to your current directory, truncated to three parent folders. Your directory will also be truncated to the root of the git repo that you're currently in. +`directory`モジュールには、現在のディレクトリへのパスが表示され、3つの親フォルダは切り捨てられます。 ディレクトリは、現在のgitリポジトリであるとルートとなります。 -When using the fish style pwd 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スタイルのpwdオプションを使用すると、切り捨てられたパスを非表示にする代わりに、オプションで有効にした番号に基づいて各ディレクトリの短縮名が表示されます。 -For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, and the option set to `1`. You will now see `~/D/N/nixpkgs/pkgs`, whereas before it would have been `nixpkgs/pkgs`. +例として、`~/Dev/Nix/nixpkgs/pkgs`で、`nixpkgs`がリポジトリルートであり、オプションが`1`に設定されている場合を挙げます。 以前は`nixpkgs/pkgs`でしたが、`~/D/N/nixpkgs/pkgs`が表示されます。 ### オプション -| オプション | デフォルト | 説明 | -| ------------------- | -------------------------------------------------- | -------------------------------------------------------------------------------- | -| `truncation_length` | `3` | The number of parent folders that the current directory should be truncated to. | -| `truncate_to_repo` | `true` | Whether or not to truncate to the root of the git repo that you're currently in. | -| `format` | `"[$path]($style)[$read_only]($read_only_style) "` | moduleのフォーマットです。 | -| `style` | `"bold cyan"` | モジュールのスタイルです。 | -| `disabled` | `false` | Disables the `directory` module. | -| `read_only` | `"🔒"` | The symbol indicating current directory is read only. | -| `read_only_style` | `"red"` | The style for the read only symbol. | -| `truncation_symbol` | `""` | The symbol to prefix to truncated paths. eg: "…/" | +| オプション | デフォルト | 説明 | +| ------------------- | -------------------------------------------------- | ----------------------------------------------------- | +| `truncation_length` | `3` | 現在のディレクトリを切り捨てる親フォルダーの数です。 | +| `truncate_to_repo` | `true` | 現在いるgitリポジトリのルートに切り捨てるかどうかです。 | +| `format` | `"[$path]($style)[$read_only]($read_only_style) "` | moduleのフォーマットです。 | +| `style` | `"bold cyan"` | モジュールのスタイルです。 | +| `disabled` | `false` | `directory`モジュールを無効にします。 | +| `read_only` | `"🔒"` | The symbol indicating current directory is read only. | +| `read_only_style` | `"red"` | The style for the read only symbol. | +| `truncation_symbol` | `""` | The symbol to prefix to truncated paths. eg: "…/" |
-This module has a few advanced configuration options that control how the directory is displayed. +このモジュールは、どのようにディレクトリを表示するかについての高度なオプションをいくつか持っています。 -| Advanced Option | デフォルト | 説明 | -| --------------------------- | ------ | ---------------------------------------------------------------------------------------- | -| `substitutions` | | A table of substitutions to be made to the path. | -| `fish_style_pwd_dir_length` | `0` | The number of characters to use when applying fish shell pwd path logic. | -| `use_logical_path` | `true` | Displays the logical path provided by the shell (`PWD`) instead of the path from the OS. | +| Advanced Option | デフォルト | 説明 | +| --------------------------- | ------ | ------------------------------------------------ | +| `substitutions` | | A table of substitutions to be made to the path. | +| `fish_style_pwd_dir_length` | `0` | fish shellのpwdパスロジックを適用するときに使用する文字数です。 | +| `use_logical_path` | `true` | OSからのパスの代わりに、シェル(`PWD`) によって提供される論理パスを表示します。 | `substitutions` allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories (i.e. Java). Note that this will disable the fish style PWD. @@ -668,7 +668,7 @@ truncation_symbol = "…/" ## Docker Context -The `docker_context` module shows the currently active [Docker context](https://docs.docker.com/engine/context/working-with-contexts/) if it's not set to `default`. +`docker_context`モジュールは、 [Dockerコンテキスト](https://docs.docker.com/engine/context/working-with-contexts/)が`デフォルト`に設定されていない場合、現在アクティブな <1>Dockerコンテキストを表示します。 ### オプション @@ -678,7 +678,7 @@ The `docker_context` module shows the currently active [Docker context](https:// | `symbol` | `"🐳 "` | The symbol used before displaying the Docker context. | | `style` | `"blue bold"` | モジュールのスタイルです。 | | `only_with_files` | `false` | Only show when there's a `docker-compose.yml` or `Dockerfile` in the current directory. | -| `disabled` | `true` | Disables the `docker_context` module. | +| `disabled` | `true` | `docker_context`モジュールを無効にします。 | ### 変数 @@ -701,7 +701,7 @@ format = "via [🐋 $context](blue bold)" ## Dotnet -The `dotnet` module shows the relevant version of the .NET Core SDK for the current directory. If the SDK has been pinned in the current directory, the pinned version is shown. Otherwise the module shows the latest installed version of the SDK. +`dotnet` モジュールはカレントディレクトリに関係する.NET Core SDKのバージョンを表示します。 もし SDKは現在のディレクトリに固定されているのであれば、その固定されたバージョンが表示されます。 それ以外の場合、モジュール SDKの最新のインストールバージョンを示します。 This module will only be shown in your prompt when one or more of the following files are present in the current directory: @@ -717,19 +717,19 @@ This module will only be shown in your prompt when one or more of the following You'll also need the .NET Core SDK installed in order to use it correctly. -Internally, this module uses its own mechanism for version detection. Typically it is twice as fast as running `dotnet --version`, but it may show an incorrect version if your .NET project has an unusual directory layout. If accuracy is more important than speed, you can disable the mechanism by setting `heuristic = false` in the module options. +内部的に、このモジュールは自身のバージョン検知のメカニズムを利用します。 `dotnet --version` を実行するより2倍速く実行できますが、.NET project一般的でないディレクトリlayoutの場合は間違ったバージョンが示されてしまうことがあります。 速度よりも精度が重要な場合は、次の方法でメカニズムを無効にできます。 モジュールオプションで`heuristic = false `を設定します。 The module will also show the Target Framework Moniker () when there is a csproj file in the current directory. ### オプション -| オプション | デフォルト | 説明 | -| ----------- | --------------------------------------- | -------------------------------------------------------- | -| `format` | `"[$symbol$version( 🎯 $tfm)]($style) "` | moduleのフォーマットです。 | -| `symbol` | `"•NET "` | The symbol used before displaying the version of dotnet. | -| `heuristic` | `true` | Use faster version detection to keep starship snappy. | -| `style` | `"bold blue"` | モジュールのスタイルです。 | -| `disabled` | `false` | Disables the `dotnet` module. | +| オプション | デフォルト | 説明 | +| ----------- | --------------------------------------- | ------------------------------------ | +| `format` | `"[$symbol$version( 🎯 $tfm)]($style) "` | moduleのフォーマットです。 | +| `symbol` | `•NET "` | dotnetのバージョンを表示する前に使用される記号です。 | +| `heuristic` | `true` | より高速なバージョン検出を使用して、starshipの動作を維持します。 | +| `style` | `"bold blue"` | モジュールのスタイルです。 | +| `disabled` | `false` | `dotnet`モジュールを無効にします。 | ### 変数 @@ -790,7 +790,7 @@ symbol = "🔮 " ## Elm -The `elm` module shows the currently installed version of Elm. 次の条件のいずれかが満たされると、モジュールが表示されます。 +`elm`モジュールは、現在インストールされているElmのバージョンを示します。 次の条件のいずれかが満たされると、モジュールが表示されます。 - カレントディレクトリに`elm.json`ファイルが含まれている - カレントディレクトリに`elm-package.json`ファイルが含まれている @@ -805,7 +805,7 @@ The `elm` module shows the currently installed version of Elm. 次の条件の | `format` | `"via [$symbol$version]($style) "` | moduleのフォーマットです。 | | `symbol` | `"🌳 "` | A format string representing the symbol of Elm. | | `style` | `"cyan bold"` | モジュールのスタイルです。 | -| `disabled` | `false` | Disables the `elm` module. | +| `disabled` | `false` | `elm`モジュールを無効にします。 | ### 変数 @@ -828,20 +828,20 @@ format = "via [ $version](cyan bold) " ## 環境変数 -The `env_var` module displays the current value of a selected environment variable. The module will be shown only if any of the following conditions are met: +`env_var`モジュールは、選択された環境変数の現在の値を表示します。 次の条件のいずれかが満たされると、モジュールが表示されます。 - `variable`オプションが、既存の環境変数と一致する - `variable`オプションが定義されておらず、`default`オプションが定義されている ### オプション -| オプション | デフォルト | 説明 | -| ---------- | ------------------------------ | ---------------------------------------------------------------------------- | -| `symbol` | | The symbol used before displaying the variable value. | -| `variable` | | The environment variable to be displayed. | -| `default` | | The default value to be displayed when the selected variable is not defined. | -| `format` | `"with [$env_value]($style) "` | moduleのフォーマットです。 | -| `disabled` | `false` | Disables the `env_var` module. | +| オプション | デフォルト | 説明 | +| ---------- | ------------------------------ | ------------------------------------- | +| `symbol` | | 環境変数を表示する前に使用される記号です。 | +| `variable` | | 表示される環境変数です。 | +| `default` | | 上のvariableが定義されていない場合に表示されるデフォルトの値です。 | +| `format` | `"with [$env_value]($style) "` | moduleのフォーマットです。 | +| `disabled` | `false` | `env_var`モジュールを無効にします。 | ### 変数 @@ -960,20 +960,20 @@ asia-northeast1 = "an1" ## Git ブランチ -The `git_branch` module shows the active branch of the repo in your current directory. +`git_branch`モジュールは、現在のディレクトリにあるリポジトリのアクティブなブランチを表示します。 ### オプション -| オプション | デフォルト | 説明 | -| -------------------- | -------------------------------- | ---------------------------------------------------------------------------------------- | -| `always_show_remote` | `false` | Shows the remote tracking branch name, even if it is equal to the local branch name. | -| `format` | `"on [$symbol$branch]($style) "` | moduleのフォーマットです。 Use `"$branch"` to refer to the current branch name. | -| `symbol` | `" "` | A format string representing the symbol of git branch. | -| `style` | `"bold purple"` | モジュールのスタイルです。 | -| `truncation_length` | `2^63 - 1` | Truncates a git branch to X graphemes. | -| `truncation_symbol` | `"…"` | The symbol used to indicate a branch name was truncated. You can use `""` for no symbol. | -| `only_attached` | `false` | Only show the branch name when not in a detached HEAD state. | -| `disabled` | `false` | Disables the `git_branch` module. | +| オプション | デフォルト | 説明 | +| -------------------- | -------------------------------- | ------------------------------------------------------------------------------------ | +| `always_show_remote` | `false` | Shows the remote tracking branch name, even if it is equal to the local branch name. | +| `format` | `"on [$symbol$branch]($style) "` | moduleのフォーマットです。 Use `"$branch"` to refer to the current branch name. | +| `symbol` | `" "` | A format string representing the symbol of git branch. | +| `style` | `"bold purple"` | モジュールのスタイルです。 | +| `truncation_length` | `2^63 - 1` | Truncates a git branch to X graphemes. | +| `truncation_symbol` | `"…"` | ブランチ名切り捨てられていることを示すための記号です。 You can use `""` for no symbol. | +| `only_attached` | `false` | Only show the branch name when not in a detached HEAD state. | +| `disabled` | `false` | `git_branch`モジュールを無効にします。 | ### 変数 @@ -1004,15 +1004,15 @@ The `git_commit` module shows the current commit hash and also the tag (if any) ### オプション -| オプション | デフォルト | 説明 | -| -------------------- | ------------------------------------------------------ | ----------------------------------------------------- | -| `commit_hash_length` | `7` | The length of the displayed git commit hash. | -| `format` | `"[\\($hash\\)]($style) [\\($tag\\)]($style)"` | moduleのフォーマットです。 | -| `style` | `"bold green"` | モジュールのスタイルです。 | -| `only_detached` | `true` | Only show git commit hash when in detached HEAD state | -| `tag_disabled` | `true` | Disables showing tag info in `git_commit` module. | -| `tag_symbol` | `"🏷 "` | Tag symbol prefixing the info shown | -| `disabled` | `false` | Disables the `git_commit` module. | +| オプション | デフォルト | 説明 | +| -------------------- | ------------------------------------------------------ | ------------------------------------------------- | +| `commit_hash_length` | `7` | 表示されるgitコミットハッシュの長さです。 | +| `format` | `"[\\($hash\\)]($style) [\\($tag\\)]($style)"` | moduleのフォーマットです。 | +| `style` | `"bold green"` | モジュールのスタイルです。 | +| `only_detached` | `true` | 切り離されたHEAD状態のときのみgit commit hashを表示します | +| `tag_disabled` | `true` | Disables showing tag info in `git_commit` module. | +| `tag_symbol` | `"🏷 "` | Tag symbol prefixing the info shown | +| `disabled` | `false` | `git_commit`モジュールを無効にします。 | ### 変数 @@ -1035,7 +1035,7 @@ tag_symbol = "🔖 " ## Git の進行状態 -The `git_state` module will show in directories which are part of a git repository, and where there is an operation in progress, such as: _REBASING_, _BISECTING_, etc. If there is progress information (e.g., REBASING 3/10), that information will be shown too. +`git_state`モジュールはgitディレクトリの進行状態を表します。 (例: _REBASING_, _BISECTING_, その他) 進捗情報がある場合(例: REBASING 3/10)はその情報も表示されます。 ### オプション @@ -1050,7 +1050,7 @@ The `git_state` module will show in directories which are part of a git reposito | `am_or_rebase` | `"AM/REBASE"` | A format string displayed when an ambiguous `apply-mailbox` or `rebase` is in progress. | | `style` | `"bold yellow"` | モジュールのスタイルです。 | | `format` | `'\([$state( $progress_current/$progress_total)]($style)\) '` | moduleのフォーマットです。 | -| `disabled` | `false` | Disables the `git_state` module. | +| `disabled` | `false` | `git_state`モジュールを無効にします。 | ### 変数 @@ -1075,25 +1075,25 @@ cherry_pick = "[🍒 PICKING](bold red)" ## Git の状態 -The `git_status` module shows symbols representing the state of the repo in your current directory. +`git_status`モジュールは、現在のディレクトリのリポジトリの状態を表すシンボルを表示します。 ### オプション -| オプション | デフォルト | 説明 | -| ------------ | ----------------------------------------------- | ----------------------------------- | -| `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | The default format for `git_status` | -| `conflicted` | `"="` | This branch has merge conflicts. | -| `ahead` | `"⇡"` | The format of `ahead` | -| `behind` | `"⇣"` | The format of `behind` | -| `diverged` | `"⇕"` | The format of `diverged` | -| `untracked` | `"?"` | The format of `untracked` | -| `stashed` | `"$"` | The format of `stashed` | -| `modified` | `"!"` | The format of `modified` | -| `staged` | `"+"` | The format of `staged` | -| `renamed` | `"»"` | The format of `renamed` | -| `deleted` | `"✘"` | The format of `deleted` | -| `style` | `"bold red"` | モジュールのスタイルです。 | -| `disabled` | `false` | Disables the `git_status` module. | +| オプション | デフォルト | 説明 | +| ------------ | ----------------------------------------------- | ------------------------- | +| `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | `git_status` のデフォルトフォーマット | +| `conflicted` | `"="` | このブランチにはマージの競合があります。 | +| `ahead` | `"⇡"` | `ahead`のフォーマット | +| `behind` | `"⇣"` | `behind`のフォーマット | +| `diverged` | `"⇕"` | `diverged`のフォーマット | +| `untracked` | `"?"` | The format of `untracked` | +| `stashed` | `"$"` | The format of `stashed` | +| `modified` | `"!"` | The format of `modified` | +| `staged` | `"+"` | The format of `staged` | +| `renamed` | `"»"` | The format of `renamed` | +| `deleted` | `"✘"` | The format of `deleted` | +| `style` | `"bold red"` | モジュールのスタイルです。 | +| `disabled` | `false` | `git_status`モジュールを無効にします。 | ### 変数 @@ -1123,9 +1123,9 @@ The following variables can be used in `diverged`: The following variables can be used in `conflicted`, `ahead`, `behind`, `untracked`, `stashed`, `modified`, `staged`, `renamed` and `deleted`: -| 変数 | 説明 | -| ------- | ------------------------ | -| `count` | Show the number of files | +| 変数 | 説明 | +| ------- | ------------- | +| `count` | ファイルの数を表示します。 | ### 設定例 @@ -1158,7 +1158,7 @@ behind = "⇣${count}" ## Golang -The `golang` module shows the currently installed version of Golang. 次の条件のいずれかが満たされると、モジュールが表示されます。 +`golang`モジュールは、現在インストールされているGolangのバージョンを示します。 次の条件のいずれかが満たされると、モジュールが表示されます。 - カレントディレクトリに`go.mod`ファイルが含まれている - カレントディレクトリに`go.sum`ファイルが含まれている @@ -1176,7 +1176,7 @@ The `golang` module shows the currently installed version of Golang. 次の条 | `format` | `"via [$symbol$version]($style) "` | moduleのフォーマットです。 | | `symbol` | `"🐹 "` | A format string representing the symbol of Go. | | `style` | `"bold cyan"` | モジュールのスタイルです。 | -| `disabled` | `false` | Disables the `golang` module. | +| `disabled` | `false` | `golang`モジュールを無効にします。 | ### 変数 @@ -1234,17 +1234,17 @@ format = "via [⎈ $version](bold white) " ## ホスト名 -The `hostname` module shows the system hostname. +`hostname`モジュールには、システムのホスト名が表示されます。 ### オプション -| オプション | デフォルト | 説明 | -| ---------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | -| `ssh_only` | `true` | Only show hostname when connected to an SSH session. | -| `trim_at` | `"."` | String that the hostname is cut off at, after the first match. `"."` will stop after the first dot. `""` will disable any truncation | -| `format` | `"[$hostname]($style) in "` | moduleのフォーマットです。 | -| `style` | `"bold dimmed green"` | モジュールのスタイルです。 | -| `disabled` | `false` | Disables the `hostname` module. | +| オプション | デフォルト | 説明 | +| ---------- | --------------------------- | --------------------------------------------------------------------------- | +| `ssh_only` | `true` | SSHセッションに接続されている場合にのみホスト名を表示します。 | +| `trim_at` | `"."` | この文字が最初にマッチするまでをホスト名と認識します。 `"."`は最初の. までをホスト名として認識します。 `""`を指定した場合トリムしません。 | +| `format` | `"[$hostname]($style) in "` | moduleのフォーマットです。 | +| `style` | `"bold dimmed green"` | モジュールのスタイルです。 | +| `disabled` | `false` | `hostname`モジュールを無効にします。 | ### 変数 @@ -1269,7 +1269,7 @@ disabled = false ## Java -The `java` module shows the currently installed version of Java. 次の条件のいずれかが満たされると、モジュールが表示されます。 +`java`モジュールは、現在インストールされているJavaのバージョンを示します。 次の条件のいずれかが満たされると、モジュールが表示されます。 - The current directory contains a `pom.xml`, `build.gradle.kts`, `build.sbt`, `.java-version`, `.deps.edn`, `project.clj`, or `build.boot` file - The current directory contains a file with the `.java`, `.class`, `.gradle`, `.jar`, `.clj`, or `.cljc` extension @@ -1281,7 +1281,7 @@ The `java` module shows the currently installed version of Java. 次の条件の | `format` | `"via [${symbol}${version}]($style) "` | moduleのフォーマットです。 | | `symbol` | `"☕ "` | A format string representing the symbol of Java | | `style` | `"red dimmed"` | モジュールのスタイルです。 | -| `disabled` | `false` | Disables the `java` module. | +| `disabled` | `false` | `java`モジュールを無効にします。 | ### 変数 @@ -1304,17 +1304,17 @@ symbol = "🌟 " ## ジョブ -The `jobs` module shows the current number of jobs running. The module will be shown only if there are background jobs running. The module will show the number of jobs running if there is more than 1 job, or more than the `threshold` config value, if it exists. +`jobs`モジュールには、実行中のジョブの現在の数が表示されます。 このモジュールは、実行中のバックグラウンドジョブがある場合にのみ表示されます。 1つ以上のジョブがある、または`threshold`に指定した値以上にジョブがある場合は実行中のジョブの数を表示します。 ### オプション | オプション | デフォルト | 説明 | | ----------- | ----------------------------- | ------------------------------------------------ | -| `threshold` | `1` | Show number of jobs if exceeded. | +| `threshold` | `1` | 超過した場合、ジョブの数を表示します。 | | `format` | `"[$symbol$number]($style) "` | moduleのフォーマットです。 | | `symbol` | `"✦"` | A format string representing the number of jobs. | | `style` | `"bold blue"` | モジュールのスタイルです。 | -| `disabled` | `false` | Disables the `jobs` module. | +| `disabled` | `false` | `jobs`モジュールを無効にします。 | ### 変数 @@ -1338,7 +1338,7 @@ threshold = 4 ## Julia -The `julia` module shows the currently installed version of Julia. 次の条件のいずれかが満たされると、モジュールが表示されます。 +`julia`モジュールは、現在インストールされているJuliaのバージョンを示します。 次の条件のいずれかが満たされると、モジュールが表示されます。 - カレントディレクトリに`Project.toml`ファイルが含まれている - カレントディレクトリに`Manifest.toml`ファイルが含まれている @@ -1351,7 +1351,7 @@ The `julia` module shows the currently installed version of Julia. 次の条件 | `format` | `"via [$symbol$version]($style) "` | moduleのフォーマットです。 | | `symbol` | `"ஃ "` | A format string representing the symbol of Julia. | | `style` | `"bold purple"` | モジュールのスタイルです。 | -| `disabled` | `false` | Disables the `julia` module. | +| `disabled` | `false` | `julia`モジュールを無効にします。 | ### 変数 @@ -1421,7 +1421,7 @@ Displays the current Kubernetes context name and, if set, the namespace from the ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. +このモジュールはデフォルトで無効になっています。 有効にするには、設定ファイルで`disabled`を`false`に設定します。 ::: @@ -1458,15 +1458,15 @@ disabled = false "dev.local.cluster.k8s" = "dev" ``` -## Line Break +## 改行 -The `line_break` module separates the prompt into two lines. +`line_break`モジュールは、プロンプトを2行に分割します。 ### オプション -| オプション | デフォルト | 説明 | -| ---------- | ------- | ------------------------------------------------------------------ | -| `disabled` | `false` | Disables the `line_break` module, making the prompt a single line. | +| オプション | デフォルト | 説明 | +| ---------- | ------- | ------------------------------------- | +| `disabled` | `false` | `line_break`モジュールを無効にして、プロンプトを1行にします。 | ### 設定例 @@ -1514,27 +1514,28 @@ The `lua` module shows the currently installed version of Lua. 次の条件の format = "via [🌕 $version](bold blue) " ``` -## Memory Usage +## メモリ使用量 -The `memory_usage` module shows current system memory and swap usage. +`memory_usageモジュールは、現在のシステムメモリとスワップ使用量を示します。

-By default the swap usage is displayed if the total system swap is non-zero. +

デフォルトでは、システムスワップの合計がゼロ以外の場合、スワップ使用量が表示されます。

-::: tip +

::: tip

-This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. +

このモジュールはデフォルトで無効になっています。 +有効にするには、設定ファイルでdisabled`を`false`に設定します。 ::: ### オプション -| オプション | デフォルト | 説明 | -| ----------- | --------------------------------------------- | -------------------------------------------------------- | -| `threshold` | `75` | Hide the memory usage unless it exceeds this percentage. | -| `format` | `"via $symbol [${ram}( | ${swap})]($style) "` | moduleのフォーマットです。 | -| `symbol` | `"🐏"` | The symbol used before displaying the memory usage. | -| `style` | `"bold dimmed white"` | モジュールのスタイルです。 | -| `disabled` | `true` | Disables the `memory_usage` module. | +| オプション | デフォルト | 説明 | +| ----------- | --------------------------------------------- | --------------------------- | +| `threshold` | `75` | この閾値を超えない限り、メモリ使用率は表示されません。 | +| `format` | `"via $symbol [${ram}( | ${swap})]($style) "` | moduleのフォーマットです。 | +| `symbol` | `"🐏"` | メモリ使用率を表示する前に使用される記号です。 | +| `style` | `"bold dimmed white"` | モジュールのスタイルです。 | +| `disabled` | `true` | `memory_usage`モジュールを無効にします。 | ### 変数 @@ -1561,9 +1562,9 @@ symbol = " " style = "bold dimmed green" ``` -## Mercurial Branch +## Mercurial ブランチ -The `hg_branch` module shows the active branch of the repo in your current directory. +` hg_branch `モジュールは、現在のディレクトリにあるリポジトリのアクティブなブランチを示します。 ### オプション @@ -1573,7 +1574,7 @@ The `hg_branch` module shows the active branch of the repo in your current direc | `style` | `"bold purple"` | モジュールのスタイルです。 | | `format` | `"on [$symbol$branch]($style) "` | moduleのフォーマットです。 | | `truncation_length` | `2^63 - 1` | Truncates the hg branch name to X graphemes | -| `truncation_symbol` | `"…"` | The symbol used to indicate a branch name was truncated. | +| `truncation_symbol` | `"…"` | ブランチ名切り捨てられていることを示すための記号です。 | | `disabled` | `true` | Disables the `hg_branch` module. | ### 変数 @@ -1637,7 +1638,7 @@ symbol = "🎣 " ## Nix-shell -The `nix_shell` module shows the nix-shell environment. The module will be shown when inside a nix-shell environment. +`nix_shell`モジュールは、nix-shell環境を示しています。 このモジュールは、nixシェル環境内にあるときに表示されます。 ### オプション @@ -1648,7 +1649,7 @@ The `nix_shell` module shows the nix-shell environment. The module will be shown | `style` | `"bold blue"` | モジュールのスタイルです。 | | `impure_msg` | `"impure"` | A format string shown when the shell is impure. | | `pure_msg` | `"pure"` | A format string shown when the shell is pure. | -| `disabled` | `false` | Disables the `nix_shell` module. | +| `disabled` | `false` | `nix_shell`モジュールを無効にします。 | ### 変数 @@ -1675,11 +1676,11 @@ format = 'via [☃️ $state( \($name\))](bold blue) ' ## NodeJS -The `nodejs` module shows the currently installed version of NodeJS. 次の条件のいずれかが満たされると、モジュールが表示されます。 +`nodejs`モジュールは、現在インストールされているNodeJSのバージョンを示します。 次の条件のいずれかが満たされると、モジュールが表示されます。 -- The current directory contains a `package.json` file +- カレントディレクトリに`package.json`ファイルが含まれている - The current directory contains a `.node-version` file -- The current directory contains a `node_modules` directory +- カレントディレクトリに`node_modules`ディレクトリが含まれている - The current directory contains a file with the `.js`, `.mjs` or `.cjs` extension - The current directory contains a file with the `.ts` extension @@ -1690,7 +1691,7 @@ The `nodejs` module shows the currently installed version of NodeJS. 次の条 | `format` | `"via [$symbol$version]($style) "` | moduleのフォーマットです。 | | `symbol` | `"⬢ "` | A format string representing the symbol of NodeJS. | | `style` | `"bold green"` | モジュールのスタイルです。 | -| `disabled` | `false` | Disables the `nodejs` module. | +| `disabled` | `false` | `nodejs`モジュールを無効にします。 | | `not_capable_style` | `bold red` | The style for the module when an engines property in Packages.json does not match the NodeJS version. | ###  Variables @@ -1786,14 +1787,14 @@ style = "bold yellow" symbol = "☁️ " ``` -## Package Version +## パッケージのバージョン -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`, `cargo`, `poetry`, `composer`, `gradle`, `julia`, `mix` and `helm` packages. +`package`モジュールは、現在のディレクトリがパッケージのリポジトリである場合に表示され、現在のバージョンが表示されます。 The module currently supports `npm`, `cargo`, `poetry`, `composer`, `gradle`, `julia`, `mix` and `helm` packages. -- **npm** – The `npm` package version is extracted from the `package.json` present in the current directory -- **cargo** – The `cargo` package version is extracted from the `Cargo.toml` present in the current directory -- **poetry** – The `poetry` package version is extracted from the `pyproject.toml` present in the current directory -- **composer** – The `composer` package version is extracted from the `composer.json` present in the current directory +- **npm** – `npm`パッケージバージョンは、現在のディレクトリにある`package.json`から抽出されます +- **cargo** – `cargo`パッケージバージョンは、現在のディレクトリにある`Cargo.toml`から抽出されます。 +- **poetry** – `poetry`パッケージバージョンは、現在のディレクトリにある`pyproject.toml`から抽出されます +- **composer** – `composer`パッケージバージョンは、現在のディレクトリにある`composer.json`から抽出されます - **gradle** – The `gradle` package version is extracted from the `build.gradle` present - **julia** - The package version is extracted from the `Project.toml` present - **mix** - The `mix` package version is extracted from the `mix.exs` present @@ -1805,13 +1806,13 @@ The `package` module is shown when the current directory is the repository for a ### オプション -| オプション | デフォルト | 説明 | -| ----------------- | ---------------------------------- | ---------------------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | moduleのフォーマットです。 | -| `symbol` | `"📦 "` | The symbol used before displaying the version the package. | -| `style` | `"bold 208"` | モジュールのスタイルです。 | -| `display_private` | `false` | Enable displaying version for packages marked as private. | -| `disabled` | `false` | Disables the `package` module. | +| オプション | デフォルト | 説明 | +| ----------------- | --------------------------------- | --------------------------------------------------------- | +| `format` | `"is [$symbol$version]($style) "` | moduleのフォーマットです。 | +| `symbol` | `"📦 "` | パッケージのバージョンを表示する前に使用される記号です。 | +| `style` | `"bold 208"` | モジュールのスタイルです。 | +| `display_private` | `false` | Enable displaying version for packages marked as private. | +| `disabled` | `false` | `package` モジュールを無効にします。 | ### 変数 @@ -1870,20 +1871,20 @@ format = "via [🦪 $version]($style) " ## PHP -The `php` module shows the currently installed version of PHP. 次の条件のいずれかが満たされると、モジュールが表示されます。 +`php`モジュールは、現在インストールされているPHPのバージョンを示します。 次の条件のいずれかが満たされると、モジュールが表示されます。 - The current directory contains a `composer.json` file - The current directory contains a `.php-version` file -- The current directory contains a `.php` file +- カレントディレクトリに`.php`の拡張子のファイルが含まれている ### オプション -| オプション | デフォルト | 説明 | -| ---------- | ---------------------------------- | ----------------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | moduleのフォーマットです。 | -| `symbol` | `"🐘 "` | The symbol used before displaying the version of PHP. | -| `style` | `"147 bold"` | モジュールのスタイルです。 | -| `disabled` | `false` | Disables the `php` module. | +| オプション | デフォルト | 説明 | +| ---------- | ---------------------------------- | -------------------------- | +| `format` | `"via [$symbol$version]($style) "` | moduleのフォーマットです。 | +| `symbol` | `"🐘 "` | PHPのバージョンを表示する前に使用される記号です。 | +| `style` | `"147 bold"` | モジュールのスタイルです。 | +| `disabled` | `false` | `php`モジュールを無効にします。 | ### 変数 @@ -1941,21 +1942,21 @@ format = "via [$symbol$version](bold white)" ## Python -The `python` module shows the currently installed version of Python and the current Python virtual environment if one is activated. +`python` モジュールは現在インストールされているPythonのバージョンと アクティブ化されている場合は現在のPython仮想環境を表示します。 If `pyenv_version_name` is set to `true`, it will display the pyenv version name. Otherwise, it will display the version number from `python --version`. 次の条件のいずれかが満たされると、モジュールが表示されます。 -- The current directory contains a `.python-version` file -- The current directory contains a `requirements.txt` file -- The current directory contains a `pyproject.toml` file +- カレントディレクトリに`.python-version`ファイルが含まれている +- カレントディレクトリに`requirements.txt`ファイルが含まれている +- カレントディレクトリに`pyproject.toml`ファイルが含まれている - The current directory contains a file with the `.py` extension (and `scan_for_pyfiles` is true) -- The current directory contains a `Pipfile` file -- The current directory contains a `tox.ini` file -- The current directory contains a `setup.py` file +- カレントディレクトリに`Pipfile`ファイルが含まれている +- カレントディレクトリに`tox.ini`ファイルが含まれている +- カレントディレクトリに`setup.py`ファイルが含まれている - The current directory contains a `__init__.py` file -- A virtual environment is currently activated +- 仮想環境がアクティブである ### オプション @@ -1964,11 +1965,11 @@ If `pyenv_version_name` is set to `true`, it will display the pyenv version name | `format` | `'via [${symbol}${pyenv_prefix}${version}( \($virtualenv\))]($style) '` | moduleのフォーマットです。 | | `symbol` | `"🐍 "` | A format string representing the symbol of Python | | `style` | `"yellow bold"` | モジュールのスタイルです。 | -| `pyenv_version_name` | `false` | Use pyenv to get Python version | +| `pyenv_version_name` | `false` | pyenvを使用してPythonバージョンを取得します | | `pyenv_prefix` | `pyenv` | Prefix before pyenv version display, only used if pyenv is used | | `scan_for_pyfiles` | `true` | If false, Python files in the current directory will not show this module. | | `python_binary` | `["python", "python3, "python2"]` | Configures the python binaries that Starship should executes when getting the version. | -| `disabled` | `false` | Disables the `python` module. | +| `disabled` | `false` | `python`モジュールを無効にします。 | ::: tip @@ -2009,11 +2010,11 @@ python_binary = "python3" ## Ruby -The `ruby` module shows the currently installed version of Ruby. 次の条件のいずれかが満たされると、モジュールが表示されます。 +`ruby`モジュールは、現在インストールされているRubyのバージョンを示します。 次の条件のいずれかが満たされると、モジュールが表示されます。 -- The current directory contains a `Gemfile` file +- カレントディレクトリに`Gemfile`ファイルが含まれている - The current directory contains a `.ruby-version` file -- The current directory contains a `.rb` file +- カレントディレクトリに`.rb`の拡張子のファイルが含まれている ### オプション @@ -2022,7 +2023,7 @@ The `ruby` module shows the currently installed version of Ruby. 次の条件の | `format` | `"via [$symbol$version]($style) "` | moduleのフォーマットです。 | | `symbol` | `"💎 "` | A format string representing the symbol of Ruby. | | `style` | `"bold red"` | モジュールのスタイルです。 | -| `disabled` | `false` | Disables the `ruby` module. | +| `disabled` | `false` | `ruby`モジュールを無効にします。 | ### 変数 @@ -2045,10 +2046,10 @@ symbol = "🔺 " ## Rust -The `rust` module shows the currently installed version of Rust. 次の条件のいずれかが満たされると、モジュールが表示されます。 +`rust`モジュールには、現在インストールされているRustのバージョンが表示されます。 次の条件のいずれかが満たされると、モジュールが表示されます。 -- The current directory contains a `Cargo.toml` file -- The current directory contains a file with the `.rs` extension +- カレントディレクトリに`Cargo.toml`ファイルが含まれている +- カレントディレクトリに`.rs`の拡張子のファイルが含まれている ### オプション @@ -2057,7 +2058,7 @@ The `rust` module shows the currently installed version of Rust. 次の条件の | `format` | `"via [$symbol$version]($style) "` | moduleのフォーマットです。 | | `symbol` | `"🦀 "` | A format string representing the symbol of Rust | | `style` | `"bold red"` | モジュールのスタイルです。 | -| `disabled` | `false` | Disables the `rust` module. | +| `disabled` | `false` | `rust`モジュールを無効にします。 | ### 変数 @@ -2152,7 +2153,9 @@ The `status` module displays the exit code of the previous command. The module w ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. ::: +このモジュールはデフォルトで無効になっています。 有効にするには、設定ファイルで`disabled`を`false`に設定します。 + +::: ### オプション @@ -2238,7 +2241,7 @@ format = "via [🏎 $version](red bold)" The `terraform` module shows the currently selected terraform workspace and version. By default the terraform version is not shown, since this is slow on current versions of terraform when a lot of plugins are in use. If you still want to enable it, [follow the example shown below](#with-version). 次の条件のいずれかが満たされると、モジュールが表示されます。 -- The current directory contains a `.terraform` folder +- カレントディレクトリに`.terraform`フォルダが含まれている - Current directory contains a file with the `.tf` or `.hcl` extensions ### オプション @@ -2248,7 +2251,7 @@ The `terraform` module shows the currently selected terraform workspace and vers | `format` | `"via [$symbol$workspace]($style) "` | The format string for the module. | | `symbol` | `"💠 "` | A format string shown before the terraform workspace. | | `style` | `"bold 105"` | モジュールのスタイルです。 | -| `disabled` | `false` | Disables the `terraform` module. | +| `disabled` | `false` | `terraform`モジュールを無効にします。 | ### 変数 @@ -2287,21 +2290,21 @@ The `time` module shows the current **local** time. The `format` configuration v ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. +このモジュールはデフォルトで無効になっています。 有効にするには、設定ファイルで`disabled`を`false`に設定します。 ::: ### オプション -| オプション | デフォルト | 説明 | -| ----------------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | -| `format` | `"at [$time]($style) "` | The format string for the module. | -| `use_12hr` | `false` | Enables 12 hour formatting | -| `time_format` | see below | The [chrono format string](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) used to format the time. | -| `style` | `"bold yellow"` | The style for the module time | -| `utc_time_offset` | `"local"` | Sets the UTC offset to use. Range from -24 < x < 24. Allows floats to accommodate 30/45 minute timezone offsets. | -| `disabled` | `true` | Disables the `time` module. | -| `time_range` | `"-"` | Sets the time range during which the module will be shown. Times must be specified in 24-hours format | +| オプション | デフォルト | 説明 | +| ----------------- | ----------------------- | ----------------------------------------------------------------------------------------------------- | +| `format` | `"at [$time]($style) "` | The format string for the module. | +| `use_12hr` | `false` | 12時間のフォーマットを有効にします。 | +| `time_format` | この表の下を参照してください | 時刻のフォーマットに使用される[クロノフォーマット文字列](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) です。 | +| `style` | `"bold yellow"` | モジュールのスタイルです。 | +| `utc_time_offset` | `"local"` | 使用するUTCオフセットを設定します。 Range from -24 < x < 24. フロートが30/45分のタイムゾーンオフセットに対応できるようにします。 | +| `disabled` | `true` | `time`モジュールを無効にします。 | +| `time_range` | `"-"` | Sets the time range during which the module will be shown. Times must be specified in 24-hours format | If `use_12hr` is `true`, then `time_format` defaults to `"%r"`. Otherwise, it defaults to `"%T"`. Manually setting `time_format` will override the `use_12hr` setting. @@ -2309,7 +2312,7 @@ If `use_12hr` is `true`, then `time_format` defaults to `"%r"`. Otherwise, it de | 変数 | 設定例 | 説明 | | --------- | ---------- | ---------------------- | -| time | `13:08:10` | The current time. | +| 時刻 | `13:08:10` | The current time. | | style\* | | オプション `style` の値をミラーする | \*: この変数はスタイル文字列の一部としてのみ使用できます @@ -2327,26 +2330,30 @@ utc_time_offset = "-5" time_range = "10:00:00-14:00:00" ``` -## Username +## ユーザー名 The `username` module shows active user's username. 次の条件のいずれかが満たされると、モジュールが表示されます。 -- The current user is root -- The current user isn't the same as the one that is logged in -- The user is currently connected as an SSH session -- The variable `show_always` is set to true +- カレントユーザーがroot +- カレントユーザーが、ログインしているユーザーとは異なる +- ユーザーがSSHセッションとして接続されている +- `show_always`変数がtrueに設定されている -::: tip SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. ::: +::: tip + +SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. + +::: ### オプション -| オプション | デフォルト | 説明 | -| ------------- | ----------------------- | ------------------------------------- | -| `style_root` | `"bold red"` | The style used when the user is root. | -| `style_user` | `"bold yellow"` | The style used for non-root users. | -| `format` | `"[$user]($style) in "` | moduleのフォーマットです。 | -| `show_always` | `false` | Always shows the `username` module. | -| `disabled` | `false` | Disables the `username` module. | +| オプション | デフォルト | 説明 | +| ------------- | ----------------------- | ------------------------- | +| `style_root` | `"bold red"` | ユーザーがrootのときに使用されるスタイルです。 | +| `style_user` | `"bold yellow"` | 非rootユーザーに使用されるスタイルです。 | +| `format` | `"[$user]($style) in "` | moduleのフォーマットです。 | +| `show_always` | `false` | `username` モジュールを常に表示します。 | +| `disabled` | `false` | `username` モジュールを無効にします。 | ### 変数 @@ -2437,8 +2444,8 @@ The order in which custom modules are shown can be individually set by including | ------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------- | | `command` | | The command whose output should be printed. The command will be passed on stdin to the shell. | | `when` | | A shell command used as a condition to show the module. The module will be shown if the command returns a `0` status code. | -| `shell` | | [See below](#custom-command-shell) | -| `description` | `""` | The description of the module that is shown when running `starship explain`. | +| `shell` | | [この表の下を参照してください](#custom-command-shell) | +| `説明` | `""` | The description of the module that is shown when running `starship explain`. | | `files` | `[]` | The files that will be searched in the working directory for a match. | | `directories` | `[]` | The directories that will be searched in the working directory for a match. | | `extensions` | `[]` | The extensions that will be searched in the working directory for a match. | diff --git a/docs/ja-JP/guide/README.md b/docs/ja-JP/guide/README.md index c6c9ac4b..1d4171ee 100644 --- a/docs/ja-JP/guide/README.md +++ b/docs/ja-JP/guide/README.md @@ -125,6 +125,8 @@ ### 入門 +**Note**: due to the proliferation of different platforms, only a subset of supported platforms are shown below. Can't see yours? Have a look at the [extra platform instructions](https://starship.rs/installing/). + 1. **Starship** のバイナリをインストール @@ -138,17 +140,10 @@ ``` - ##### [crates.io](https://crates.io/)からソースをインストール - - ```sh - cargo install starship - ``` - - #### パッケージマネージャー経由でインストール - ##### [ Homebrew ](https://brew.sh/)の場合： + ##### Example: [Homebrew](https://brew.sh/): ```sh brew install starship @@ -161,7 +156,7 @@ scoop install starship ``` -1. 初期化のためのスクリプトをシェルの設定ファイルに追加 +2. 初期化のためのスクリプトをシェルの設定ファイルに追加 #### Bash diff --git a/docs/ja-JP/installing/README.md b/docs/ja-JP/installing/README.md new file mode 100644 index 00000000..6f0ea0d6 --- /dev/null +++ b/docs/ja-JP/installing/README.md @@ -0,0 +1,46 @@ +# 🚀 Advanced Installation + +To install starship, you need to do two things: + +1. Get the **starship** binary onto your computer +1. Tell your shell to use the starship binary as its prompt by modifying its init scripts + +For most users, the instructions on [the main page](/guide/#🚀-installation) will work great. However, for some more specialized platforms, different instructions are needed. + +There are so many platforms out there that they didn't fit into the main README.md file, so here are some installation instructions for other platforms from the community. Is yours not here? Please do add it here if you figure it out! + +## [Nix](https://nixos.wiki/wiki/Nix) + +### Getting the Binary + +#### Imperatively + +```sh +nix-env -iA nixos.starship +``` + +#### Declarative, single user, via [home-manager](home-manager) + +Add `pkgs.starship` to your `home.packages` in your `home.nix` file, then run + +```sh +home-manager switch +``` + +#### Declarative, system-wide, with NixOS + +Add `pkgs.starship` to `environment.packages` in your `configuration.nix`, then run + +```sh +sudo nixos-rebuild switch +``` + +### Modifying Init Scripts + +#### With Nix and home-manager, using zsh: + +Add the following to `programs.zsh.initExtra` in your `home.nix` file, then run + +```sh +home-manager switch +``` diff --git a/docs/ko-KR/config/README.md b/docs/ko-KR/config/README.md index 286375e2..c9970753 100644 --- a/docs/ko-KR/config/README.md +++ b/docs/ko-KR/config/README.md @@ -1804,13 +1804,13 @@ The `package` module is shown when the current directory is the repository for a ### Options -| Option | Default | Description | -| ----------------- | ---------------------------------- | ---------------------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | The format for the module. | -| `symbol` | `"📦 "` | The symbol used before displaying the version the package. | -| `style` | `"bold 208"` | The style for the module. | -| `display_private` | `false` | Enable displaying version for packages marked as private. | -| `disabled` | `false` | Disables the `package` module. | +| Option | Default | Description | +| ----------------- | --------------------------------- | ---------------------------------------------------------- | +| `format` | `"is [$symbol$version]($style) "` | The format for the module. | +| `symbol` | `"📦 "` | The symbol used before displaying the version the package. | +| `style` | `"bold 208"` | The style for the module. | +| `display_private` | `false` | Enable displaying version for packages marked as private. | +| `disabled` | `false` | Disables the `package` module. | ### Variables @@ -2151,7 +2151,9 @@ The `status` module displays the exit code of the previous command. The module w ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. ::: +This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. + +::: ### Options @@ -2335,7 +2337,11 @@ The `username` module shows active user's username. The module will be shown if - The user is currently connected as an SSH session - The variable `show_always` is set to true -::: tip SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. ::: +::: tip + +SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. + +::: ### Options diff --git a/docs/ko-KR/guide/README.md b/docs/ko-KR/guide/README.md index 74b5b1e6..9f33e569 100644 --- a/docs/ko-KR/guide/README.md +++ b/docs/ko-KR/guide/README.md @@ -125,6 +125,8 @@ ### Getting Started +**Note**: due to the proliferation of different platforms, only a subset of supported platforms are shown below. Can't see yours? Have a look at the [extra platform instructions](https://starship.rs/installing/). + 1. Install the **starship** binary: @@ -138,17 +140,10 @@ ``` - ##### From source on [crates.io](https://crates.io/): - - ```sh - cargo install starship - ``` - - #### Install via Package Manager - ##### With [Homebrew](https://brew.sh/): + ##### Example: [Homebrew](https://brew.sh/): ```sh brew install starship @@ -161,7 +156,7 @@ scoop install starship ``` -1. Add the init script to your shell's config file: +2. Add the init script to your shell's config file: #### Bash diff --git a/docs/ko-KR/installing/README.md b/docs/ko-KR/installing/README.md new file mode 100644 index 00000000..6f0ea0d6 --- /dev/null +++ b/docs/ko-KR/installing/README.md @@ -0,0 +1,46 @@ +# 🚀 Advanced Installation + +To install starship, you need to do two things: + +1. Get the **starship** binary onto your computer +1. Tell your shell to use the starship binary as its prompt by modifying its init scripts + +For most users, the instructions on [the main page](/guide/#🚀-installation) will work great. However, for some more specialized platforms, different instructions are needed. + +There are so many platforms out there that they didn't fit into the main README.md file, so here are some installation instructions for other platforms from the community. Is yours not here? Please do add it here if you figure it out! + +## [Nix](https://nixos.wiki/wiki/Nix) + +### Getting the Binary + +#### Imperatively + +```sh +nix-env -iA nixos.starship +``` + +#### Declarative, single user, via [home-manager](home-manager) + +Add `pkgs.starship` to your `home.packages` in your `home.nix` file, then run + +```sh +home-manager switch +``` + +#### Declarative, system-wide, with NixOS + +Add `pkgs.starship` to `environment.packages` in your `configuration.nix`, then run + +```sh +sudo nixos-rebuild switch +``` + +### Modifying Init Scripts + +#### With Nix and home-manager, using zsh: + +Add the following to `programs.zsh.initExtra` in your `home.nix` file, then run + +```sh +home-manager switch +``` diff --git a/docs/nl-NL/config/README.md b/docs/nl-NL/config/README.md index 286375e2..c9970753 100644 --- a/docs/nl-NL/config/README.md +++ b/docs/nl-NL/config/README.md @@ -1804,13 +1804,13 @@ The `package` module is shown when the current directory is the repository for a ### Options -| Option | Default | Description | -| ----------------- | ---------------------------------- | ---------------------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | The format for the module. | -| `symbol` | `"📦 "` | The symbol used before displaying the version the package. | -| `style` | `"bold 208"` | The style for the module. | -| `display_private` | `false` | Enable displaying version for packages marked as private. | -| `disabled` | `false` | Disables the `package` module. | +| Option | Default | Description | +| ----------------- | --------------------------------- | ---------------------------------------------------------- | +| `format` | `"is [$symbol$version]($style) "` | The format for the module. | +| `symbol` | `"📦 "` | The symbol used before displaying the version the package. | +| `style` | `"bold 208"` | The style for the module. | +| `display_private` | `false` | Enable displaying version for packages marked as private. | +| `disabled` | `false` | Disables the `package` module. | ### Variables @@ -2151,7 +2151,9 @@ The `status` module displays the exit code of the previous command. The module w ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. ::: +This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. + +::: ### Options @@ -2335,7 +2337,11 @@ The `username` module shows active user's username. The module will be shown if - The user is currently connected as an SSH session - The variable `show_always` is set to true -::: tip SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. ::: +::: tip + +SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. + +::: ### Options diff --git a/docs/nl-NL/guide/README.md b/docs/nl-NL/guide/README.md index 74b5b1e6..9f33e569 100644 --- a/docs/nl-NL/guide/README.md +++ b/docs/nl-NL/guide/README.md @@ -125,6 +125,8 @@ ### Getting Started +**Note**: due to the proliferation of different platforms, only a subset of supported platforms are shown below. Can't see yours? Have a look at the [extra platform instructions](https://starship.rs/installing/). + 1. Install the **starship** binary: @@ -138,17 +140,10 @@ ``` - ##### From source on [crates.io](https://crates.io/): - - ```sh - cargo install starship - ``` - - #### Install via Package Manager - ##### With [Homebrew](https://brew.sh/): + ##### Example: [Homebrew](https://brew.sh/): ```sh brew install starship @@ -161,7 +156,7 @@ scoop install starship ``` -1. Add the init script to your shell's config file: +2. Add the init script to your shell's config file: #### Bash diff --git a/docs/nl-NL/installing/README.md b/docs/nl-NL/installing/README.md new file mode 100644 index 00000000..6f0ea0d6 --- /dev/null +++ b/docs/nl-NL/installing/README.md @@ -0,0 +1,46 @@ +# 🚀 Advanced Installation + +To install starship, you need to do two things: + +1. Get the **starship** binary onto your computer +1. Tell your shell to use the starship binary as its prompt by modifying its init scripts + +For most users, the instructions on [the main page](/guide/#🚀-installation) will work great. However, for some more specialized platforms, different instructions are needed. + +There are so many platforms out there that they didn't fit into the main README.md file, so here are some installation instructions for other platforms from the community. Is yours not here? Please do add it here if you figure it out! + +## [Nix](https://nixos.wiki/wiki/Nix) + +### Getting the Binary + +#### Imperatively + +```sh +nix-env -iA nixos.starship +``` + +#### Declarative, single user, via [home-manager](home-manager) + +Add `pkgs.starship` to your `home.packages` in your `home.nix` file, then run + +```sh +home-manager switch +``` + +#### Declarative, system-wide, with NixOS + +Add `pkgs.starship` to `environment.packages` in your `configuration.nix`, then run + +```sh +sudo nixos-rebuild switch +``` + +### Modifying Init Scripts + +#### With Nix and home-manager, using zsh: + +Add the following to `programs.zsh.initExtra` in your `home.nix` file, then run + +```sh +home-manager switch +``` diff --git a/docs/pl-PL/config/README.md b/docs/pl-PL/config/README.md index 286375e2..c9970753 100644 --- a/docs/pl-PL/config/README.md +++ b/docs/pl-PL/config/README.md @@ -1804,13 +1804,13 @@ The `package` module is shown when the current directory is the repository for a ### Options -| Option | Default | Description | -| ----------------- | ---------------------------------- | ---------------------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | The format for the module. | -| `symbol` | `"📦 "` | The symbol used before displaying the version the package. | -| `style` | `"bold 208"` | The style for the module. | -| `display_private` | `false` | Enable displaying version for packages marked as private. | -| `disabled` | `false` | Disables the `package` module. | +| Option | Default | Description | +| ----------------- | --------------------------------- | ---------------------------------------------------------- | +| `format` | `"is [$symbol$version]($style) "` | The format for the module. | +| `symbol` | `"📦 "` | The symbol used before displaying the version the package. | +| `style` | `"bold 208"` | The style for the module. | +| `display_private` | `false` | Enable displaying version for packages marked as private. | +| `disabled` | `false` | Disables the `package` module. | ### Variables @@ -2151,7 +2151,9 @@ The `status` module displays the exit code of the previous command. The module w ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. ::: +This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. + +::: ### Options @@ -2335,7 +2337,11 @@ The `username` module shows active user's username. The module will be shown if - The user is currently connected as an SSH session - The variable `show_always` is set to true -::: tip SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. ::: +::: tip + +SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. + +::: ### Options diff --git a/docs/pl-PL/guide/README.md b/docs/pl-PL/guide/README.md index 74b5b1e6..9f33e569 100644 --- a/docs/pl-PL/guide/README.md +++ b/docs/pl-PL/guide/README.md @@ -125,6 +125,8 @@ ### Getting Started +**Note**: due to the proliferation of different platforms, only a subset of supported platforms are shown below. Can't see yours? Have a look at the [extra platform instructions](https://starship.rs/installing/). + 1. Install the **starship** binary: @@ -138,17 +140,10 @@ ``` - ##### From source on [crates.io](https://crates.io/): - - ```sh - cargo install starship - ``` - - #### Install via Package Manager - ##### With [Homebrew](https://brew.sh/): + ##### Example: [Homebrew](https://brew.sh/): ```sh brew install starship @@ -161,7 +156,7 @@ scoop install starship ``` -1. Add the init script to your shell's config file: +2. Add the init script to your shell's config file: #### Bash diff --git a/docs/pl-PL/installing/README.md b/docs/pl-PL/installing/README.md new file mode 100644 index 00000000..6f0ea0d6 --- /dev/null +++ b/docs/pl-PL/installing/README.md @@ -0,0 +1,46 @@ +# 🚀 Advanced Installation + +To install starship, you need to do two things: + +1. Get the **starship** binary onto your computer +1. Tell your shell to use the starship binary as its prompt by modifying its init scripts + +For most users, the instructions on [the main page](/guide/#🚀-installation) will work great. However, for some more specialized platforms, different instructions are needed. + +There are so many platforms out there that they didn't fit into the main README.md file, so here are some installation instructions for other platforms from the community. Is yours not here? Please do add it here if you figure it out! + +## [Nix](https://nixos.wiki/wiki/Nix) + +### Getting the Binary + +#### Imperatively + +```sh +nix-env -iA nixos.starship +``` + +#### Declarative, single user, via [home-manager](home-manager) + +Add `pkgs.starship` to your `home.packages` in your `home.nix` file, then run + +```sh +home-manager switch +``` + +#### Declarative, system-wide, with NixOS + +Add `pkgs.starship` to `environment.packages` in your `configuration.nix`, then run + +```sh +sudo nixos-rebuild switch +``` + +### Modifying Init Scripts + +#### With Nix and home-manager, using zsh: + +Add the following to `programs.zsh.initExtra` in your `home.nix` file, then run + +```sh +home-manager switch +``` diff --git a/docs/pt-BR/config/README.md b/docs/pt-BR/config/README.md index 994928c5..a106870e 100644 --- a/docs/pt-BR/config/README.md +++ b/docs/pt-BR/config/README.md @@ -379,7 +379,7 @@ By default it only changes color. If you also want to change it's shape take a l | `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. | | `vicmd_symbol` | `"[❮](bold green)"` | The format string used before the text input if the shell is in vim normal mode. | -| `disabled` | `false` | Disables the `character` module. | +| `disabled` | `false` | Desabilita o módulo `character`. | ### Variables @@ -448,7 +448,7 @@ The `cmake` module shows the currently installed version of CMake if any of the The `cmd_duration` module shows how long the last command took to execute. The module will be shown only if the command took longer than two seconds, or the `min_time` config value, if it exists. -::: warning Do not hook the DEBUG trap in Bash +::: warning Não utilize o DEBUG-trap no Bash If you are running Starship in `bash`, do not hook the `DEBUG` trap after running `eval $(starship init $0)`, or this module **will** break. @@ -1457,7 +1457,7 @@ disabled = false "dev.local.cluster.k8s" = "dev" ``` -## Line Break +## Quebra de linha The `line_break` module separates the prompt into two lines. @@ -1513,7 +1513,7 @@ The `lua` module shows the currently installed version of Lua. The module will b format = "via [🌕 $version](bold blue) " ``` -## Memory Usage +## Uso de memória The `memory_usage` module shows current system memory and swap usage. @@ -1804,13 +1804,13 @@ The `package` module is shown when the current directory is the repository for a ### Opções -| Option | Padrão | Descrição | -| ----------------- | ---------------------------------- | ---------------------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | The format for the module. | -| `symbol` | `"📦 "` | The symbol used before displaying the version the package. | -| `style` | `"bold 208"` | O estilo do módulo. | -| `display_private` | `false` | Enable displaying version for packages marked as private. | -| `disabled` | `false` | Disables the `package` module. | +| Option | Padrão | Descrição | +| ----------------- | --------------------------------- | ---------------------------------------------------------- | +| `format` | `"is [$symbol$version]($style) "` | The format for the module. | +| `symbol` | `"📦 "` | The symbol used before displaying the version the package. | +| `style` | `"bold 208"` | O estilo do módulo. | +| `display_private` | `false` | Enable displaying version for packages marked as private. | +| `disabled` | `false` | Disables the `package` module. | ### Variables @@ -2151,7 +2151,9 @@ The `status` module displays the exit code of the previous command. The module w ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. ::: +This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. + +::: ### Opções @@ -2335,7 +2337,11 @@ The `username` module shows active user's username. The module will be shown if - The user is currently connected as an SSH session - The variable `show_always` is set to true -::: tip SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. ::: +::: tip + +SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. + +::: ### Opções @@ -2437,7 +2443,7 @@ The order in which custom modules are shown can be individually set by including | `command` | | The command whose output should be printed. The command will be passed on stdin to the shell. | | `when` | | A shell command used as a condition to show the module. The module will be shown if the command returns a `0` status code. | | `shell` | | [See below](#custom-command-shell) | -| `description` | `""` | The description of the module that is shown when running `starship explain`. | +| `descrição` | `""` | The description of the module that is shown when running `starship explain`. | | `files` | `[]` | The files that will be searched in the working directory for a match. | | `directories` | `[]` | The directories that will be searched in the working directory for a match. | | `extensions` | `[]` | The extensions that will be searched in the working directory for a match. | diff --git a/docs/pt-BR/guide/README.md b/docs/pt-BR/guide/README.md index 8d8d07b2..b74b85ef 100644 --- a/docs/pt-BR/guide/README.md +++ b/docs/pt-BR/guide/README.md @@ -125,6 +125,8 @@ ### Primeiros passos +**Note**: due to the proliferation of different platforms, only a subset of supported platforms are shown below. Can't see yours? Have a look at the [extra platform instructions](https://starship.rs/installing/). + 1. Instale o binário do **starship**: @@ -138,17 +140,10 @@ ``` - ##### Código fonte via [crates.io](https://crates.io/): - - ```sh - cargo install starship - ``` - - #### Instalar via gerenciador de pacotes - ##### Com o [Homebrew](https://brew.sh/): + ##### Example: [Homebrew](https://brew.sh/): ```sh brew install starship @@ -161,7 +156,7 @@ scoop install starship ``` -1. Adicione o script de inicialização no arquivo de configuração do seu shell: +2. Adicione o script de inicialização no arquivo de configuração do seu shell: #### Bash diff --git a/docs/pt-BR/installing/README.md b/docs/pt-BR/installing/README.md new file mode 100644 index 00000000..6f0ea0d6 --- /dev/null +++ b/docs/pt-BR/installing/README.md @@ -0,0 +1,46 @@ +# 🚀 Advanced Installation + +To install starship, you need to do two things: + +1. Get the **starship** binary onto your computer +1. Tell your shell to use the starship binary as its prompt by modifying its init scripts + +For most users, the instructions on [the main page](/guide/#🚀-installation) will work great. However, for some more specialized platforms, different instructions are needed. + +There are so many platforms out there that they didn't fit into the main README.md file, so here are some installation instructions for other platforms from the community. Is yours not here? Please do add it here if you figure it out! + +## [Nix](https://nixos.wiki/wiki/Nix) + +### Getting the Binary + +#### Imperatively + +```sh +nix-env -iA nixos.starship +``` + +#### Declarative, single user, via [home-manager](home-manager) + +Add `pkgs.starship` to your `home.packages` in your `home.nix` file, then run + +```sh +home-manager switch +``` + +#### Declarative, system-wide, with NixOS + +Add `pkgs.starship` to `environment.packages` in your `configuration.nix`, then run + +```sh +sudo nixos-rebuild switch +``` + +### Modifying Init Scripts + +#### With Nix and home-manager, using zsh: + +Add the following to `programs.zsh.initExtra` in your `home.nix` file, then run + +```sh +home-manager switch +``` diff --git a/docs/pt-PT/config/README.md b/docs/pt-PT/config/README.md index 286375e2..c9970753 100644 --- a/docs/pt-PT/config/README.md +++ b/docs/pt-PT/config/README.md @@ -1804,13 +1804,13 @@ The `package` module is shown when the current directory is the repository for a ### Options -| Option | Default | Description | -| ----------------- | ---------------------------------- | ---------------------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | The format for the module. | -| `symbol` | `"📦 "` | The symbol used before displaying the version the package. | -| `style` | `"bold 208"` | The style for the module. | -| `display_private` | `false` | Enable displaying version for packages marked as private. | -| `disabled` | `false` | Disables the `package` module. | +| Option | Default | Description | +| ----------------- | --------------------------------- | ---------------------------------------------------------- | +| `format` | `"is [$symbol$version]($style) "` | The format for the module. | +| `symbol` | `"📦 "` | The symbol used before displaying the version the package. | +| `style` | `"bold 208"` | The style for the module. | +| `display_private` | `false` | Enable displaying version for packages marked as private. | +| `disabled` | `false` | Disables the `package` module. | ### Variables @@ -2151,7 +2151,9 @@ The `status` module displays the exit code of the previous command. The module w ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. ::: +This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. + +::: ### Options @@ -2335,7 +2337,11 @@ The `username` module shows active user's username. The module will be shown if - The user is currently connected as an SSH session - The variable `show_always` is set to true -::: tip SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. ::: +::: tip + +SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. + +::: ### Options diff --git a/docs/pt-PT/guide/README.md b/docs/pt-PT/guide/README.md index 74b5b1e6..9f33e569 100644 --- a/docs/pt-PT/guide/README.md +++ b/docs/pt-PT/guide/README.md @@ -125,6 +125,8 @@ ### Getting Started +**Note**: due to the proliferation of different platforms, only a subset of supported platforms are shown below. Can't see yours? Have a look at the [extra platform instructions](https://starship.rs/installing/). + 1. Install the **starship** binary: @@ -138,17 +140,10 @@ ``` - ##### From source on [crates.io](https://crates.io/): - - ```sh - cargo install starship - ``` - - #### Install via Package Manager - ##### With [Homebrew](https://brew.sh/): + ##### Example: [Homebrew](https://brew.sh/): ```sh brew install starship @@ -161,7 +156,7 @@ scoop install starship ``` -1. Add the init script to your shell's config file: +2. Add the init script to your shell's config file: #### Bash diff --git a/docs/pt-PT/installing/README.md b/docs/pt-PT/installing/README.md new file mode 100644 index 00000000..6f0ea0d6 --- /dev/null +++ b/docs/pt-PT/installing/README.md @@ -0,0 +1,46 @@ +# 🚀 Advanced Installation + +To install starship, you need to do two things: + +1. Get the **starship** binary onto your computer +1. Tell your shell to use the starship binary as its prompt by modifying its init scripts + +For most users, the instructions on [the main page](/guide/#🚀-installation) will work great. However, for some more specialized platforms, different instructions are needed. + +There are so many platforms out there that they didn't fit into the main README.md file, so here are some installation instructions for other platforms from the community. Is yours not here? Please do add it here if you figure it out! + +## [Nix](https://nixos.wiki/wiki/Nix) + +### Getting the Binary + +#### Imperatively + +```sh +nix-env -iA nixos.starship +``` + +#### Declarative, single user, via [home-manager](home-manager) + +Add `pkgs.starship` to your `home.packages` in your `home.nix` file, then run + +```sh +home-manager switch +``` + +#### Declarative, system-wide, with NixOS + +Add `pkgs.starship` to `environment.packages` in your `configuration.nix`, then run + +```sh +sudo nixos-rebuild switch +``` + +### Modifying Init Scripts + +#### With Nix and home-manager, using zsh: + +Add the following to `programs.zsh.initExtra` in your `home.nix` file, then run + +```sh +home-manager switch +``` diff --git a/docs/ru-RU/config/README.md b/docs/ru-RU/config/README.md index 1e29d10e..fb541cda 100644 --- a/docs/ru-RU/config/README.md +++ b/docs/ru-RU/config/README.md @@ -303,16 +303,16 @@ symbol = "🅰 " ### Опции -| Параметр | По умолчанию | Описание | -| -------------------- | --------------------------------- | --------------------------------------------------- | -| `full_symbol` | `""` | Символ, отображаемый при полной батарее. | -| `charging_symbol` | `""` | Символ, показываемый при зарядке аккумулятора. | -| `discharging_symbol` | `""` | Символ, показываемый при разрядке аккумулятора. | -| `unknown_symbol` | `""` | The symbol shown when the battery state is unknown. | -| `empty_symbol` | `""` | The symbol shown when the battery state is empty. | -| `format` | `"[$symbol$percentage]($style) "` | Формат модуля. | -| `display` | [ссылка](#battery-display) | Display threshold and style for the module. | -| `disabled` | `false` | Disables the `battery` module. | +| Параметр | По умолчанию | Описание | +| -------------------- | --------------------------------- | ------------------------------------------------------- | +| `full_symbol` | `""` | Символ, отображаемый при полной батарее. | +| `charging_symbol` | `""` | Символ, показываемый при зарядке аккумулятора. | +| `discharging_symbol` | `""` | Символ, показываемый при разрядке аккумулятора. | +| `unknown_symbol` | `""` | Символ, отображаемый при неизвестном состоянии батареи. | +| `empty_symbol` | `""` | Символ, отображаемый при пустом состоянии батареи. | +| `format` | `"[$symbol$percentage]($style) "` | Формат модуля. | +| `display` | [ссылка](#battery-display) | Порог отображения и стиль для модуля. | +| `disabled` | `false` | Отключает модуль `battery`. | ### Пример @@ -328,7 +328,7 @@ discharging_symbol = "💀" ### Отображение батареи -The `display` configuration option is used to define when the battery indicator should be shown (threshold) and what it looks like (style). If no `display` is provided. Значение по умолчанию: +Параметр `display` используется для определения того, когда индикатор батареи должен быть показан (threshhold) и как он выглядит (style). Если `display` не предоставлено. Значение по умолчанию: ```toml [[battery.display]] @@ -338,12 +338,12 @@ style = "bold red" #### Опции -The `display` option is an array of the following table. +Опция `display` представляет собой массив следующей таблицы. -| Параметр | Описание | -| ----------- | ----------------------------------------------- | -| `threshold` | The upper bound for the display option. | -| `style` | The style used if the display option is in use. | +| Параметр | Описание | +| ----------- | -------------------------------------------------------- | +| `threshold` | Верхняя граница опции отображения. | +| `style` | Используемый стиль, если используется опция отображения. | #### Пример @@ -362,9 +362,9 @@ style = "bold yellow" ## Символ -The `character` module shows a character (usually an arrow) beside where the text is entered in your terminal. +Модуль `character` показывает символ (обычно, стрелка) рядом с вводимым текстом в терминале. -The character will tell you whether the last command was successful or not. It can do this in two ways: +Символ показывает, была ли последняя команда успешной или нет. It can do this in two ways: - changing color (`red`/`green`) - changing shape (`❯`/`✖`) @@ -379,7 +379,7 @@ By default it only changes color. If you also want to change it's shape take a l | `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. | | `vicmd_symbol` | `"[❮](bold green)"` | The format string used before the text input if the shell is in vim normal mode. | -| `disabled` | `false` | Disables the `character` module. | +| `disabled` | `false` | Отключает модуль `character`. | ### Переменные @@ -446,27 +446,27 @@ The `cmake` module shows the currently installed version of CMake if any of the ## Длительность команды -The `cmd_duration` module shows how long the last command took to execute. The module will be shown only if the command took longer than two seconds, or the `min_time` config value, if it exists. +Модуль `cmd_duration` показывает время исполнения последней команды. Модуль будет показан только, если команда заняла более двух секунд, или если задан параметр `min_time`. -::: warning Do not hook the DEBUG trap in Bash +::: warning Не подключайте ловушку DEBUG к Bash -If you are running Starship in `bash`, do not hook the `DEBUG` trap after running `eval $(starship init $0)`, or this module **will** break. +Если вы испоьзуете Starship в `bash`, не подключайте ловушку `DEBUG` после запуска `eval $(starship init $0)`, иначе этот модуль сломается. ::: -Bash users who need preexec-like functionality can use [rcaloras's bash_preexec framework](https://github.com/rcaloras/bash-preexec). Simply define the arrays `preexec_functions` and `precmd_functions` before running `eval $(starship init $0)`, and then proceed as normal. +Пользователи Bash, которым нужна функциональность, подобная preexec, могут использовать [фреймворк bash_preexec от rcaloras](https://github.com/rcaloras/bash-preexec). Просто определите массивы `preexec_functions` и `precmd_functions` перед запуском `eval $(starship init $0)`, а затем продолжайте нормально. ### Опции -| Параметр | По умолчанию | Описание | -| -------------------- | ----------------------------- | ---------------------------------------------------------- | -| `min_time` | `2_000` | Shortest duration to show time for (in milliseconds). | -| `show_milliseconds` | `false` | Show milliseconds in addition to seconds for the duration. | -| `format` | `"took [$duration]($style) "` | Формат модуля. | -| `style` | `"bold yellow"` | Стиль модуля. | -| `disabled` | `false` | Disables the `cmd_duration` module. | -| `show_notifications` | `false` | Show desktop notifications when command completes. | -| `min_time_to_notify` | `45_000` | Shortest duration for notification (in milliseconds). | +| Параметр | По умолчанию | Описание | +| -------------------- | ----------------------------- | -------------------------------------------------------------------- | +| `min_time` | `2_000` | Кратчайшая продолжительность для показа времени (в миллисекундах). | +| `show_milliseconds` | `false` | Показывать миллисекунды в дополнение к секундам в продолжительности. | +| `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). | ::: tip @@ -495,24 +495,24 @@ format = "underwent [$duration](bold yellow)" ## Конда -The `conda` module shows the current conda environment, if `$CONDA_DEFAULT_ENV` is set. +Модуль `conda` показывает текущее окружение conda, если `$CONDA_DEFAULT_ENV` присвоено значение. ::: tip -This does not suppress conda's own prompt modifier, you may want to run `conda config --set changeps1 False`. +Это не подавляет модификатор командной строки самой conda. Возможно, вы захотите запустить `conda config --set changeps1 False`. ::: ### Опции -| Параметр | По умолчанию | Описание | -| ------------------- | -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `truncation_length` | `1` | The number of directories the environment path should be truncated to, if the environment was created via `conda create -p [path]`. `0` means no truncation. Also see the [`directory`](#directory) module. | -| `symbol` | `"🅒 "` | The symbol used before the environment name. | -| `style` | `"bold green"` | Стиль модуля. | -| `format` | `"via [$symbol$environment]($style) "` | Формат модуля. | -| `ignore_base` | `true` | Ignores `base` environment when activated. | -| `disabled` | `false` | Disables the `conda` module. | +| Параметр | По умолчанию | Описание | +| ------------------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `truncation_length` | `1` | Количество каталогов, в которых путь к окружению должен быть усечен, если окружение было создано через `conda create -p [path]`. `0` означает без усечения. Также смотрите модуль [`directory`](#directory). | +| `symbol` | `"🅒 "` | Символ перед названием окружения. | +| `style` | `"bold green"` | Стиль модуля. | +| `format` | `"via [$symbol$environment]($style) "` | Формат модуля. | +| `ignore_base` | `true` | Ignores `base` environment when activated. | +| `disabled` | `false` | Отключает модуль `conda`. | ### Переменные @@ -535,19 +535,19 @@ format = "[$symbol$environment](dimmed green) " ## Crystal -The `crystal` module shows the currently installed version of Crystal. Модуль будет показан, если любое из следующих условий соблюдено: +Модуль `crystal` показывает установленную версию Crystal. Модуль будет показан, если любое из следующих условий соблюдено: - Текущий каталог содержит файл `shard.yml` - Текущий каталог содержит файл `.cr` ### Опции -| Параметр | По умолчанию | Описание | -| ---------- | ---------------------------------- | --------------------------------------------------------- | -| `symbol` | `"🔮 "` | The symbol used before displaying the version of crystal. | -| `style` | `"bold red"` | Стиль модуля. | -| `format` | `"via [$symbol$version]($style) "` | Формат модуля. | -| `disabled` | `false` | Disables the `crystal` module. | +| Параметр | По умолчанию | Описание | +| ---------- | ---------------------------------- | ------------------------------------------------------- | +| `symbol` | `"🔮 "` | Символ, используемый перед отображением версии crystal. | +| `style` | `"bold red"` | Стиль модуля. | +| `format` | `"via [$symbol$version]($style) "` | Формат модуля. | +| `disabled` | `false` | Отключает модуль `crystal`. | ### Переменные @@ -606,33 +606,33 @@ format = "via [🔰 $version](bold red) " ## Каталог -The `directory` module shows the path to your current directory, truncated to three parent folders. Your directory will also be truncated to the root of the git repo that you're currently in. +Модуль `directory` показывает путь к вашей текущей директории, усеченной до трех родительских папок. Ваш каталог также будет отсечен до корня git репозитория, в котором вы находитесь. -When using the fish style pwd 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, вместо скрытия усеченного каталога, вы увидите укороченное имя каталога, зависимое от числа символов вы установите для этой опции. -For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, and the option set to `1`. You will now see `~/D/N/nixpkgs/pkgs`, whereas before it would have been `nixpkgs/pkgs`. +Например, возьмем `~/Dev/Nix/nixpkgs/pkgs` где `nixpkgs` является корневым репозиторием, и в опции установлено `1`. Вы увидите `~/D/N/nixpkgs/pkgs`, а до этого было бы `nixpkgs/pkgs`. ### Опции -| Параметр | По умолчанию | Описание | -| ------------------- | -------------------------------------------------- | -------------------------------------------------------------------------------- | -| `truncation_length` | `3` | The number of parent folders that the current directory should be truncated to. | -| `truncate_to_repo` | `true` | Whether or not to truncate to the root of the git repo that you're currently in. | -| `format` | `"[$path]($style)[$read_only]($read_only_style) "` | Формат модуля. | -| `style` | `"bold cyan"` | Стиль модуля. | -| `disabled` | `false` | Disables the `directory` module. | -| `read_only` | `"🔒"` | The symbol indicating current directory is read only. | -| `read_only_style` | `"red"` | The style for the read only symbol. | -| `truncation_symbol` | `""` | The symbol to prefix to truncated paths. eg: "…/" | +| Параметр | По умолчанию | Описание | +| ------------------- | -------------------------------------------------- | ---------------------------------------------------------------------------- | +| `truncation_length` | `3` | Количество родительских папок, к которым должен быть усечен текущий каталог. | +| `truncate_to_repo` | `true` | Следует или нет обрезать до корня репозитория git, в котором вы находитесь. | +| `format` | `"[$path]($style)[$read_only]($read_only_style) "` | Формат модуля. | +| `style` | `"bold cyan"` | Стиль модуля. | +| `disabled` | `false` | Отключает модуль `directory`. | +| `read_only` | `"🔒"` | The symbol indicating current directory is read only. | +| `read_only_style` | `"red"` | The style for the read only symbol. | +| `truncation_symbol` | `""` | The symbol to prefix to truncated paths. eg: "…/" |

-This module has a few advanced configuration options that control how the directory is displayed. +Этот модуль имеет несколько расширенных опций конфигурации, которые контролируют отображение каталога. -| Advanced Option | По умолчанию | Описание | -| --------------------------- | ------------ | ---------------------------------------------------------------------------------------- | -| `substitutions` | | A table of substitutions to be made to the path. | -| `fish_style_pwd_dir_length` | `0` | The number of characters to use when applying fish shell pwd path logic. | -| `use_logical_path` | `true` | Displays the logical path provided by the shell (`PWD`) instead of the path from the OS. | +| Advanced Option | По умолчанию | Описание | +| --------------------------- | ------------ | --------------------------------------------------------------------------------- | +| `substitutions` | | A table of substitutions to be made to the path. | +| `fish_style_pwd_dir_length` | `0` | Количество символов, используемых при использовании логики создания пути из fish. | +| `use_logical_path` | `true` | Отображает логический путь от оболочки (`PWD`) вместо пути от ОС. | `substitutions` allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories (i.e. Java). Note that this will disable the fish style PWD. @@ -642,7 +642,7 @@ For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, an "src/com/long/java/path" = "mypath" ``` -`fish_style_pwd_dir_length` interacts with the standard truncation options in a way that can be surprising at first: if it's non-zero, the components of the path that would normally be truncated are instead displayed with that many characters. For example, the path `/built/this/city/on/rock/and/roll`, which would normally be displayed as as `rock/and/roll`, would be displayed as `/b/t/c/o/rock/and/roll` with `fish_style_pwd_dir_length = 1`--the path components that would normally be removed are displayed with a single character. For `fish_style_pwd_dir_length = 2`, it would be `/bu/th/ci/on/rock/and/roll`. +`fish_style_pwd_dir_length` взаимодействует со стандартными параметрами усечения, которые могут сначала показаться странными: если он не равен нулю, элементы пути, который обычно усекается, вместо этого отображаются с указанным количеством символов. For example, the path `/built/this/city/on/rock/and/roll`, which would normally be displayed as as `rock/and/roll`, would be displayed as `/b/t/c/o/rock/and/roll` with `fish_style_pwd_dir_length = 1`--the path components that would normally be removed are displayed with a single character. For `fish_style_pwd_dir_length = 2`, it would be `/bu/th/ci/on/rock/and/roll`.
@@ -667,7 +667,7 @@ truncation_symbol = "…/" ## Контекст Docker -The `docker_context` module shows the currently active [Docker context](https://docs.docker.com/engine/context/working-with-contexts/) if it's not set to `default`. +Модуль `docker_context` показывает текущий активный [контекст Docker](https://docs.docker.com/engine/context/working-with-contexts/), если он не установлен как `default`. ### Опции @@ -700,7 +700,7 @@ format = "via [🐋 $context](blue bold)" ## Dotnet -The `dotnet` module shows the relevant version of the .NET Core SDK for the current directory. If the SDK has been pinned in the current directory, the pinned version is shown. Otherwise the module shows the latest installed version of the SDK. +Модуль `dotnet` показывает соответствующую версию .NET Core SDK для текущего каталога. Если SDK был закреплен в текущей директории, будет показана закрепленная версия. В противном случае модуль отображает последнюю установленную версию SDK. This module will only be shown in your prompt when one or more of the following files are present in the current directory: @@ -716,19 +716,19 @@ This module will only be shown in your prompt when one or more of the following You'll also need the .NET Core SDK installed in order to use it correctly. -Internally, this module uses its own mechanism for version detection. Typically it is twice as fast as running `dotnet --version`, but it may show an incorrect version if your .NET project has an unusual directory layout. If accuracy is more important than speed, you can disable the mechanism by setting `heuristic = false` in the module options. +Внутренне этот модуль использует свой собственный механизм определения версий. Обычно он в два раза быстрее, чем `dotnet --version`, но он может показывать неправильную версию, если ваш .NET проект имеет необычный формат каталога. Если точность важнее, чем скорость, вы можете отключить механизм опцией `heuristic = false` в настройках модуля. The module will also show the Target Framework Moniker () when there is a csproj file in the current directory. ### Опции -| Параметр | По умолчанию | Описание | -| ----------- | --------------------------------------- | -------------------------------------------------------- | -| `format` | `"[$symbol$version( 🎯 $tfm)]($style) "` | Формат модуля. | -| `symbol` | `"•NET "` | The symbol used before displaying the version of dotnet. | -| `heuristic` | `true` | Use faster version detection to keep starship snappy. | -| `style` | `"bold blue"` | Стиль модуля. | -| `disabled` | `false` | Disables the `dotnet` module. | +| Параметр | По умолчанию | Описание | +| ----------- | --------------------------------------- | ----------------------------------------------------------------- | +| `format` | `"[$symbol$version( 🎯 $tfm)]($style) "` | Формат модуля. | +| `symbol` | `"•NET "` | Символ перед отображением текущей версии dotnet. | +| `heuristic` | `true` | Использовать быстрое определение версии, для сохранения скорости. | +| `style` | `"bold blue"` | Стиль модуля. | +| `disabled` | `false` | Отключает модуль `dotnet`. | ### Переменные @@ -754,18 +754,18 @@ heuristic = false ## Elixir -The `elixir` module shows the currently installed version of Elixir and Erlang/OTP. Модуль будет показан, если любое из следующих условий соблюдено: +Модуль `elixir` показывает установленную версию Elixir и Erlang/OTP. Модуль будет показан, если любое из следующих условий соблюдено: - Текущий каталог содержит файл `mix.exs`. ### Опции -| Параметр | По умолчанию | Описание | -| ---------- | --------------------------------------------------------- | --------------------------------------------------------------- | -| `symbol` | `"💧 "` | The symbol used before displaying the version of Elixir/Erlang. | -| `style` | `"bold purple"` | Стиль модуля. | -| `format` | `'via [$symbol$version \(OTP $otp_version\)]($style) '` | The format for the module elixir. | -| `disabled` | `false` | Disables the `elixir` module. | +| Параметр | По умолчанию | Описание | +| ---------- | --------------------------------------------------------- | ------------------------------------------------------------- | +| `symbol` | `"💧 "` | Символ, используемый перед отображением версии Elixir/Erlang. | +| `style` | `"bold purple"` | Стиль модуля. | +| `format` | `'via [$symbol$version \(OTP $otp_version\)]($style) '` | The format for the module elixir. | +| `disabled` | `false` | Отключает модуль `elixir`. | ### Переменные @@ -789,7 +789,7 @@ symbol = "🔮 " ## Elm -The `elm` module shows the currently installed version of Elm. Модуль будет показан, если любое из следующих условий соблюдено: +Модуль `elm` показывает установленную версию Elm. Модуль будет показан, если любое из следующих условий соблюдено: - Текущий каталог содержит файл `elm.json` - Текущий каталог содержит файл `elm-package.json` @@ -804,7 +804,7 @@ The `elm` module shows the currently installed version of Elm. Модуль бу | `format` | `"via [$symbol$version]($style) "` | Формат модуля. | | `symbol` | `"🌳 "` | A format string representing the symbol of Elm. | | `style` | `"cyan bold"` | Стиль модуля. | -| `disabled` | `false` | Disables the `elm` module. | +| `disabled` | `false` | Отключает модуль `elm`. | ### Переменные @@ -827,20 +827,20 @@ format = "via [ $version](cyan bold) " ## Переменная Окружения -The `env_var` module displays the current value of a selected environment variable. The module will be shown only if any of the following conditions are met: +Модуль `env_var` отображает текущее значение выбранной переменной окружения. Модуль будет показан только в том случае, если любое из следующих условий соблюдено: - Опция `variable` соответствует существующей переменной среды - Опция `variable` не определена, но определена опция `default` ### Опции -| Параметр | По умолчанию | Описание | -| ---------- | ------------------------------ | ---------------------------------------------------------------------------- | -| `symbol` | | The symbol used before displaying the variable value. | -| `variable` | | The environment variable to be displayed. | -| `default` | | The default value to be displayed when the selected variable is not defined. | -| `format` | `"with [$env_value]($style) "` | Формат модуля. | -| `disabled` | `false` | Disables the `env_var` module. | +| Параметр | По умолчанию | Описание | +| ---------- | ------------------------------ | ---------------------------------------------------------------- | +| `symbol` | | Символ, используемый перед отображением значения переменной. | +| `variable` | | Отображаемая переменная окружения. | +| `default` | | Значение отображаемое, когда выбранная переменная не определена. | +| `format` | `"with [$env_value]($style) "` | Формат модуля. | +| `disabled` | `false` | Отключает модуль `env_var`. | ### Переменные @@ -959,20 +959,20 @@ asia-northeast1 = "an1" ## Ветвь Git -The `git_branch` module shows the active branch of the repo in your current directory. +Модуль `git_branch` показывает активную ветку репозитория в вашем текущей директории. ### Опции -| Параметр | По умолчанию | Описание | -| -------------------- | -------------------------------- | ---------------------------------------------------------------------------------------- | -| `always_show_remote` | `false` | Shows the remote tracking branch name, even if it is equal to the local branch name. | -| `format` | `"on [$symbol$branch]($style) "` | Формат модуля. Use `"$branch"` to refer to the current branch name. | -| `symbol` | `" "` | A format string representing the symbol of git branch. | -| `style` | `"bold purple"` | Стиль модуля. | -| `truncation_length` | `2^63 - 1` | Truncates a git branch to X graphemes. | -| `truncation_symbol` | `"…"` | The symbol used to indicate a branch name was truncated. You can use `""` for no symbol. | -| `only_attached` | `false` | Only show the branch name when not in a detached HEAD state. | -| `disabled` | `false` | Disables the `git_branch` module. | +| Параметр | По умолчанию | Описание | +| -------------------- | -------------------------------- | --------------------------------------------------------------------------------------------- | +| `always_show_remote` | `false` | Shows the remote tracking branch name, even if it is equal to the local branch name. | +| `format` | `"on [$symbol$branch]($style) "` | Формат модуля. Use `"$branch"` to refer to the current branch name. | +| `symbol` | `" "` | A format string representing the symbol of git branch. | +| `style` | `"bold purple"` | Стиль модуля. | +| `truncation_length` | `2^63 - 1` | Отрезает ветку git до X графемов. | +| `truncation_symbol` | `"…"` | Символ, используемый для обозначения усечения названия ветки. You can use `""` for no symbol. | +| `only_attached` | `false` | Only show the branch name when not in a detached HEAD state. | +| `disabled` | `false` | Отключает модуль `git_branch`. | ### Переменные @@ -1003,15 +1003,15 @@ The `git_commit` module shows the current commit hash and also the tag (if any) ### Опции -| Параметр | По умолчанию | Описание | -| -------------------- | ------------------------------------------------------ | ----------------------------------------------------- | -| `commit_hash_length` | `7` | The length of the displayed git commit hash. | -| `format` | `"[\\($hash\\)]($style) [\\($tag\\)]($style)"` | Формат модуля. | -| `style` | `"bold green"` | Стиль модуля. | -| `only_detached` | `true` | Only show git commit hash when in detached HEAD state | -| `tag_disabled` | `true` | Disables showing tag info in `git_commit` module. | -| `tag_symbol` | `"🏷 "` | Tag symbol prefixing the info shown | -| `disabled` | `false` | Disables the `git_commit` module. | +| Параметр | По умолчанию | Описание | +| -------------------- | ------------------------------------------------------ | ----------------------------------------------------------------------- | +| `commit_hash_length` | `7` | Длина отображаемого хэша коммита git. | +| `format` | `"[\\($hash\\)]($style) [\\($tag\\)]($style)"` | Формат модуля. | +| `style` | `"bold green"` | Стиль модуля. | +| `only_detached` | `true` | Показывать хэш коммита git, только находясь в состоянии отделённой HEAD | +| `tag_disabled` | `true` | Disables showing tag info in `git_commit` module. | +| `tag_symbol` | `"🏷 "` | Tag symbol prefixing the info shown | +| `disabled` | `false` | Отключает модуль `git_commit`. | ### Переменные @@ -1034,7 +1034,7 @@ tag_symbol = "🔖 " ## Состояние Git -The `git_state` module will show in directories which are part of a git repository, and where there is an operation in progress, such as: _REBASING_, _BISECTING_, etc. If there is progress information (e.g., REBASING 3/10), that information will be shown too. +Модуль `git_state` будет отображаться в директориях, являющимися частью репозитория git, и там, где выполняется операция, такие как: _REBASING_, _BISECTING_, и т. д. Если есть информация о прогрессе (например, REBASING 3/10), эта информация также будет показана. ### Опции @@ -1049,7 +1049,7 @@ The `git_state` module will show in directories which are part of a git reposito | `am_or_rebase` | `"AM/REBASE"` | A format string displayed when an ambiguous `apply-mailbox` or `rebase` is in progress. | | `style` | `"bold yellow"` | Стиль модуля. | | `format` | `'\([$state( $progress_current/$progress_total)]($style)\) '` | Формат модуля. | -| `disabled` | `false` | Disables the `git_state` module. | +| `disabled` | `false` | Отключает модуль `git_state`. | ### Переменные @@ -1074,14 +1074,14 @@ cherry_pick = "[🍒 PICKING](bold red)" ## Статус Git -The `git_status` module shows symbols representing the state of the repo in your current directory. +Модуль `git_status` отображает символы, представляющие состояние репозитория в вашей текущей директории. ### Опции | Параметр | По умолчанию | Описание | | ------------ | ----------------------------------------------- | ----------------------------------- | | `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | The default format for `git_status` | -| `conflicted` | `"="` | This branch has merge conflicts. | +| `conflicted` | `"="` | Эта ветка имеет конфликты слияния. | | `ahead` | `"⇡"` | The format of `ahead` | | `behind` | `"⇣"` | The format of `behind` | | `diverged` | `"⇕"` | The format of `diverged` | @@ -1092,7 +1092,7 @@ The `git_status` module shows symbols representing the state of the repo in your | `renamed` | `"»"` | The format of `renamed` | | `deleted` | `"✘"` | The format of `deleted` | | `style` | `"bold red"` | Стиль модуля. | -| `disabled` | `false` | Disables the `git_status` module. | +| `disabled` | `false` | Отключает модуль `git_status`. | ### Переменные @@ -1122,9 +1122,9 @@ The following variables can be used in `diverged`: The following variables can be used in `conflicted`, `ahead`, `behind`, `untracked`, `stashed`, `modified`, `staged`, `renamed` and `deleted`: -| Переменная | Описание | -| ---------- | ------------------------ | -| `count` | Show the number of files | +| Переменная | Описание | +| ---------- | -------------------------- | +| `count` | Показать количество файлов | ### Пример @@ -1144,7 +1144,7 @@ renamed = "👅" deleted = "🗑" ``` -Show ahead/behind count of the branch being tracked +Показывать счетчик впереди/позади для отслеживаемой ветки ```toml # ~/.config/starship.toml @@ -1157,7 +1157,7 @@ behind = "⇣${count}" ## Golang -The `golang` module shows the currently installed version of Golang. Модуль будет показан, если любое из следующих условий соблюдено: +Модуль `golang` показывает установленную версию Golang. Модуль будет показан, если любое из следующих условий соблюдено: - Текущий каталог содержит файл `go.mod` - Текущий каталог содержит файл `go.sum` @@ -1175,7 +1175,7 @@ The `golang` module shows the currently installed version of Golang. Модул | `format` | `"via [$symbol$version]($style) "` | Формат модуля. | | `symbol` | `"🐹 "` | A format string representing the symbol of Go. | | `style` | `"bold cyan"` | Стиль модуля. | -| `disabled` | `false` | Disables the `golang` module. | +| `disabled` | `false` | Отключает модуль `golang`. | ### Переменные @@ -1233,17 +1233,17 @@ format = "via [⎈ $version](bold white) " ## Имя хоста -The `hostname` module shows the system hostname. +Модуль `hostname` отображает имя системы (хоста). ### Опции -| Параметр | По умолчанию | Описание | -| ---------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | -| `ssh_only` | `true` | Only show hostname when connected to an SSH session. | -| `trim_at` | `"."` | String that the hostname is cut off at, after the first match. `"."` will stop after the first dot. `""` will disable any truncation | -| `format` | `"[$hostname]($style) in "` | Формат модуля. | -| `style` | `"bold dimmed green"` | Стиль модуля. | -| `disabled` | `false` | Disables the `hostname` module. | +| Параметр | По умолчанию | Описание | +| ---------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | +| `ssh_only` | `true` | Показывать имя хоста только при подключении к SSH-сессии. | +| `trim_at` | `"."` | Символы, по которую имя хоста будет сокращено после первого совпадения. `"."` остановится после первой точки. `""` отключит любое усечение | +| `format` | `"[$hostname]($style) in "` | Формат модуля. | +| `style` | `"bold dimmed green"` | Стиль модуля. | +| `disabled` | `false` | Отключает модуль `hostname`. | ### Переменные @@ -1268,7 +1268,7 @@ disabled = false ## Java -The `java` module shows the currently installed version of Java. Модуль будет показан, если любое из следующих условий соблюдено: +Модуль `java` показывает установленную версию Java. Модуль будет показан, если любое из следующих условий соблюдено: - The current directory contains a `pom.xml`, `build.gradle.kts`, `build.sbt`, `.java-version`, `.deps.edn`, `project.clj`, or `build.boot` file - The current directory contains a file with the `.java`, `.class`, `.gradle`, `.jar`, `.clj`, or `.cljc` extension @@ -1280,7 +1280,7 @@ The `java` module shows the currently installed version of Java. Модуль б | `format` | `"via [${symbol}${version}]($style) "` | Формат модуля. | | `symbol` | `"☕ "` | A format string representing the symbol of Java | | `style` | `"red dimmed"` | Стиль модуля. | -| `disabled` | `false` | Disables the `java` module. | +| `disabled` | `false` | Отключает модуль `java`. | ### Переменные @@ -1303,17 +1303,17 @@ symbol = "🌟 " ## Задачи -The `jobs` module shows the current number of jobs running. The module will be shown only if there are background jobs running. The module will show the number of jobs running if there is more than 1 job, or more than the `threshold` config value, if it exists. +Модуль `jobs` отображает текущее количество запущенных работ. Модуль будет показан только если работы выполняются в фоне. Модуль покажет количество запущенных задач при наличии более чем 1 задачи, или больше, чем значение конфигурации `threshold`, если оно существует. ### Опции | Параметр | По умолчанию | Описание | | ----------- | ----------------------------- | ------------------------------------------------ | -| `threshold` | `1` | Show number of jobs if exceeded. | +| `threshold` | `1` | Показывать количество задач, если превышено. | | `format` | `"[$symbol$number]($style) "` | Формат модуля. | | `symbol` | `"✦"` | A format string representing the number of jobs. | | `style` | `"bold blue"` | Стиль модуля. | -| `disabled` | `false` | Disables the `jobs` module. | +| `disabled` | `false` | Отключает модуль `jobs`. | ### Переменные @@ -1420,7 +1420,7 @@ Displays the current Kubernetes context name and, if set, the namespace from the ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. +По умолчанию этот модуль отключен. Чтобы включить его, установите `disabled` на `false` в файле конфигурации. ::: @@ -1432,7 +1432,7 @@ This module is disabled by default. To enable it, set `disabled` to `false` in y | `format` | `'[$symbol$context( \($namespace\))]($style) in '` | Формат модуля. | | `style` | `"cyan bold"` | Стиль модуля. | | `context_aliases` | | Table of context aliases to display. | -| `disabled` | `true` | Disables the `kubernetes` module. | +| `disabled` | `true` | Отключает модуль `kubernetes`. | ### Переменные @@ -1457,15 +1457,15 @@ disabled = false "dev.local.cluster.k8s" = "dev" ``` -## Line Break +## Перевод Строки -The `line_break` module separates the prompt into two lines. +Модуль `line_break` разделяет командную строку на две строки. ### Опции -| Параметр | По умолчанию | Описание | -| ---------- | ------------ | ------------------------------------------------------------------ | -| `disabled` | `false` | Disables the `line_break` module, making the prompt a single line. | +| Параметр | По умолчанию | Описание | +| ---------- | ------------ | ------------------------------------------------------------------------ | +| `disabled` | `false` | Отключает модуль `line_break`, отображая командную строку в одну строку. | ### Пример @@ -1513,27 +1513,27 @@ The `lua` module shows the currently installed version of Lua. Модуль бу format = "via [🌕 $version](bold blue) " ``` -## Memory Usage +## Использование памяти -The `memory_usage` module shows current system memory and swap usage. +Модуль `memory_usage` отображает текущую системную память и использование подкачки. -By default the swap usage is displayed if the total system swap is non-zero. +По умолчанию использование подкачки отображается, если общая сумма подкачки системы не равна нулю. ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. +По умолчанию этот модуль отключен. Чтобы включить его, установите `disabled` на `false` в файле конфигурации. ::: ### Опции -| Параметр | По умолчанию | Описание | -| ----------- | --------------------------------------------- | -------------------------------------------------------- | -| `threshold` | `75` | Hide the memory usage unless it exceeds this percentage. | -| `format` | `"via $symbol [${ram}( | ${swap})]($style) "` | Формат модуля. | -| `symbol` | `"🐏"` | The symbol used before displaying the memory usage. | -| `style` | `"bold dimmed white"` | Стиль модуля. | -| `disabled` | `true` | Disables the `memory_usage` module. | +| Параметр | По умолчанию | Описание | +| ----------- | --------------------------------------------- | ------------------------------------------------------------------ | +| `threshold` | `75` | Скрывать использование памяти, если она не превышает этот процент. | +| `format` | `"via $symbol [${ram}( | ${swap})]($style) "` | Формат модуля. | +| `symbol` | `"🐏"` | Символ, используемый перед отображением использования памяти. | +| `style` | `"bold dimmed white"` | Стиль модуля. | +| `disabled` | `true` | Отключает модуль `memory_usage`. | ### Переменные @@ -1560,20 +1560,20 @@ symbol = " " style = "bold dimmed green" ``` -## Mercurial Branch +## Ветка Mercurial -The `hg_branch` module shows the active branch of the repo in your current directory. +Модуль `hg_branch` показывает активную ветку репозитория в вашем текущем каталоге. ### Опции -| Параметр | По умолчанию | Описание | -| ------------------- | -------------------------------- | -------------------------------------------------------------------------------------------- | -| `symbol` | `" "` | The symbol used before the hg bookmark or branch name of the repo in your current directory. | -| `style` | `"bold purple"` | Стиль модуля. | -| `format` | `"on [$symbol$branch]($style) "` | Формат модуля. | -| `truncation_length` | `2^63 - 1` | Truncates the hg branch name to X graphemes | -| `truncation_symbol` | `"…"` | The symbol used to indicate a branch name was truncated. | -| `disabled` | `true` | Disables the `hg_branch` module. | +| Параметр | По умолчанию | Описание | +| ------------------- | -------------------------------- | ---------------------------------------------------------------------------------------- | +| `symbol` | `" "` | Символ, используемый перед закладкой hg или именем ветки репозитория в текущем каталоге. | +| `style` | `"bold purple"` | Стиль модуля. | +| `format` | `"on [$symbol$branch]($style) "` | Формат модуля. | +| `truncation_length` | `2^63 - 1` | Обрезает имя ветки hg до X графемов | +| `truncation_symbol` | `"…"` | Символ, используемый для обозначения усечения названия ветки. | +| `disabled` | `true` | Отключает модуль `hg_branch`. | ### Переменные @@ -1609,7 +1609,7 @@ The `nim` module shows the currently installed version of Nim. Модуль бу | Параметр | По умолчанию | Описание | | ---------- | ---------------------------------- | ----------------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | The format for the module | +| `format` | `"via [$symbol$version]($style) "` | Формат модуля | | `symbol` | `"👑 "` | The symbol used before displaying the version of Nim. | | `style` | `"bold yellow"` | Стиль модуля. | | `disabled` | `false` | Disables the `nim` module. | @@ -1636,7 +1636,7 @@ symbol = "🎣 " ## Nix-shell -The `nix_shell` module shows the nix-shell environment. The module will be shown when inside a nix-shell environment. +Модуль `nix_shell` показывает окружение nix-shell. Модуль будет показываться внутри среды nix-shell. ### Опции @@ -1647,7 +1647,7 @@ The `nix_shell` module shows the nix-shell environment. The module will be shown | `style` | `"bold blue"` | Стиль модуля. | | `impure_msg` | `"impure"` | A format string shown when the shell is impure. | | `pure_msg` | `"pure"` | A format string shown when the shell is pure. | -| `disabled` | `false` | Disables the `nix_shell` module. | +| `disabled` | `false` | Отключает модуль `nix_shell`. | ### Переменные @@ -1674,11 +1674,11 @@ format = 'via [☃️ $state( \($name\))](bold blue) ' ## NodeJS -The `nodejs` module shows the currently installed version of NodeJS. Модуль будет показан, если любое из следующих условий соблюдено: +Модуль `nodejs` показывает установленную версию NodeJS. Модуль будет показан, если любое из следующих условий соблюдено: -- The current directory contains a `package.json` file +- Текущий каталог содержит файл `package.json` - The current directory contains a `.node-version` file -- The current directory contains a `node_modules` directory +- Текущий каталог содержит каталог `node_modules` - The current directory contains a file with the `.js`, `.mjs` or `.cjs` extension - The current directory contains a file with the `.ts` extension @@ -1689,7 +1689,7 @@ The `nodejs` module shows the currently installed version of NodeJS. Модул | `format` | `"via [$symbol$version]($style) "` | Формат модуля. | | `symbol` | `"⬢ "` | A format string representing the symbol of NodeJS. | | `style` | `"bold green"` | Стиль модуля. | -| `disabled` | `false` | Disables the `nodejs` module. | +| `disabled` | `false` | Отключает модуль `nodejs`. | | `not_capable_style` | `bold red` | The style for the module when an engines property in Packages.json does not match the NodeJS version. | ###  Variables @@ -1785,15 +1785,15 @@ style = "bold yellow" symbol = "☁️ " ``` -## Package Version +## Версия пакета -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`, `cargo`, `poetry`, `composer`, `gradle`, `julia`, `mix` and `helm` packages. +Модуль `package` отображается, когда текущий каталог является репозиторием для пакета и показывает его текущую версию. The module currently supports `npm`, `cargo`, `poetry`, `composer`, `gradle`, `julia`, `mix` and `helm` packages. -- **npm** – The `npm` package version is extracted from the `package.json` present in the current directory -- **cargo** – The `cargo` package version is extracted from the `Cargo.toml` present in the current directory -- **poetry** – The `poetry` package version is extracted from the `pyproject.toml` present in the current directory -- **composer** – The `composer` package version is extracted from the `composer.json` present in the current directory -- **gradle** – The `gradle` package version is extracted from the `build.gradle` present +- **npm** – Версия пакета `npm` из файла `package.json` в текущем каталоге +- **cargo** – Версия пакета `cargo` из файла `Cargo.toml` в текущем каталоге +- **poetry** – Версия пакета `poetry` из файла `pyproject.toml` в текущем каталоге +- **composer** – Версия пакета `composer` из `composer.json` в текущем каталоге +- **gradle** – Версия пакета `gradle` извлечена из `build.gradle` - **julia** - The package version is extracted from the `Project.toml` present - **mix** - The `mix` package version is extracted from the `mix.exs` present - **helm** - The `helm` chart version is extracted from the `Chart.yaml` present @@ -1804,13 +1804,13 @@ The `package` module is shown when the current directory is the repository for a ### Опции -| Параметр | По умолчанию | Описание | -| ----------------- | ---------------------------------- | ---------------------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | Формат модуля. | -| `symbol` | `"📦 "` | The symbol used before displaying the version the package. | -| `style` | `"bold 208"` | Стиль модуля. | -| `display_private` | `false` | Enable displaying version for packages marked as private. | -| `disabled` | `false` | Disables the `package` module. | +| Параметр | По умолчанию | Описание | +| ----------------- | --------------------------------- | --------------------------------------------------------- | +| `format` | `"is [$symbol$version]($style) "` | Формат модуля. | +| `symbol` | `"📦 "` | Символ, используемый перед отображением версии пакета. | +| `style` | `"bold 208"` | Стиль модуля. | +| `display_private` | `false` | Enable displaying version for packages marked as private. | +| `disabled` | `false` | Отключает модуль `package`. | ### Переменные @@ -1869,20 +1869,20 @@ format = "via [🦪 $version]($style) " ## PHP -The `php` module shows the currently installed version of PHP. Модуль будет показан, если любое из следующих условий соблюдено: +Модуль `php` показывает установленную версию PHP. Модуль будет показан, если любое из следующих условий соблюдено: -- The current directory contains a `composer.json` file -- The current directory contains a `.php-version` file -- The current directory contains a `.php` file +- Текущий каталог содержит файл `composer.json` +- Текущий каталог содержит файл `.php-version` +- Текущий каталог содержит файл `.php` ### Опции -| Параметр | По умолчанию | Описание | -| ---------- | ---------------------------------- | ----------------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | Формат модуля. | -| `symbol` | `"🐘 "` | The symbol used before displaying the version of PHP. | -| `style` | `"147 bold"` | Стиль модуля. | -| `disabled` | `false` | Disables the `php` module. | +| Параметр | По умолчанию | Описание | +| ---------- | ---------------------------------- | --------------------------------------------------- | +| `format` | `"via [$symbol$version]($style) "` | Формат модуля. | +| `symbol` | `"🐘 "` | Символ, используемый перед отображением версии PHP. | +| `style` | `"147 bold"` | Стиль модуля. | +| `disabled` | `false` | Отключает модуль `php`. | ### Переменные @@ -1946,15 +1946,15 @@ If `pyenv_version_name` is set to `true`, it will display the pyenv version name Модуль будет показан, если любое из следующих условий соблюдено: -- The current directory contains a `.python-version` file -- The current directory contains a `requirements.txt` file -- The current directory contains a `pyproject.toml` file +- Текущий каталог содержит файл `.python-version` +- Текущий каталог содержит файл `requirements.txt` +- Текущий каталог содержит файл `pyproject.toml` - The current directory contains a file with the `.py` extension (and `scan_for_pyfiles` is true) -- The current directory contains a `Pipfile` file -- The current directory contains a `tox.ini` file -- The current directory contains a `setup.py` file +- Текущий каталог содержит файл `Pipfile` +- Текущий каталог содержит файл `tox.ini` +- Текущий каталог содержит файл `setup.py` - The current directory contains a `__init__.py` file -- A virtual environment is currently activated +- Виртуальная среда в данный момент активирована ### Опции @@ -1963,7 +1963,7 @@ If `pyenv_version_name` is set to `true`, it will display the pyenv version name | `format` | `'via [${symbol}${pyenv_prefix}${version}( \($virtualenv\))]($style) '` | Формат модуля. | | `symbol` | `"🐍 "` | A format string representing the symbol of Python | | `style` | `"yellow bold"` | Стиль модуля. | -| `pyenv_version_name` | `false` | Use pyenv to get Python version | +| `pyenv_version_name` | `false` | Использовать pyenv для получения версии Python | | `pyenv_prefix` | `pyenv` | Prefix before pyenv version display, only used if pyenv is used | | `scan_for_pyfiles` | `true` | If false, Python files in the current directory will not show this module. | | `python_binary` | `["python", "python3, "python2"]` | Configures the python binaries that Starship should executes when getting the version. | @@ -2008,11 +2008,11 @@ python_binary = "python3" ## Ruby -The `ruby` module shows the currently installed version of Ruby. Модуль будет показан, если любое из следующих условий соблюдено: +Модуль `ruby` показывает установленную версию Ruby. Модуль будет показан, если любое из следующих условий соблюдено: -- The current directory contains a `Gemfile` file -- The current directory contains a `.ruby-version` file -- The current directory contains a `.rb` file +- Текущий каталог содержит файл `Gemfile` +- Текущий каталог содержит файл `.ruby-version` +- Текущий каталог содержит файл `.rb` ### Опции @@ -2021,7 +2021,7 @@ The `ruby` module shows the currently installed version of Ruby. Модуль б | `format` | `"via [$symbol$version]($style) "` | Формат модуля. | | `symbol` | `"💎 "` | A format string representing the symbol of Ruby. | | `style` | `"bold red"` | Стиль модуля. | -| `disabled` | `false` | Disables the `ruby` module. | +| `disabled` | `false` | Отключает модуль `ruby`. | ### Переменные @@ -2044,10 +2044,10 @@ symbol = "🔺 " ## Rust -The `rust` module shows the currently installed version of Rust. Модуль будет показан, если любое из следующих условий соблюдено: +Модуль `rust` показывает установленную версию Rust. Модуль будет показан, если любое из следующих условий соблюдено: -- The current directory contains a `Cargo.toml` file -- The current directory contains a file with the `.rs` extension +- Текущий каталог содержит файл `Cargo.toml` +- Текущий каталог содержит файл с расширением `.rs` ### Опции @@ -2056,7 +2056,7 @@ The `rust` module shows the currently installed version of Rust. Модуль б | `format` | `"via [$symbol$version]($style) "` | Формат модуля. | | `symbol` | `"🦀 "` | A format string representing the symbol of Rust | | `style` | `"bold red"` | Стиль модуля. | -| `disabled` | `false` | Disables the `rust` module. | +| `disabled` | `false` | Отключает модуль `rust`. | ### Переменные @@ -2115,7 +2115,7 @@ threshold = 3 ## Singularity -The `singularity` module shows the current singularity image, if inside a container and `$SINGULARITY_NAME` is set. +Модуль `singularity` показывает текущий образ singularity, если внутри контейнера и `$SINGULARITY_NAME` установлена. ### Опции @@ -2151,7 +2151,9 @@ The `status` module displays the exit code of the previous command. The module w ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. ::: +По умолчанию этот модуль отключен. Чтобы включить его, установите `disabled` на `false` в файле конфигурации. + +::: ### Опции @@ -2237,7 +2239,7 @@ format = "via [🏎 $version](red bold)" The `terraform` module shows the currently selected terraform workspace and version. By default the terraform version is not shown, since this is slow on current versions of terraform when a lot of plugins are in use. If you still want to enable it, [follow the example shown below](#with-version). Модуль будет показан, если любое из следующих условий соблюдено: -- The current directory contains a `.terraform` folder +- Текущий каталог содержит папку `.terraform` - Current directory contains a file with the `.tf` or `.hcl` extensions ### Опции @@ -2247,7 +2249,7 @@ The `terraform` module shows the currently selected terraform workspace and vers | `format` | `"via [$symbol$workspace]($style) "` | The format string for the module. | | `symbol` | `"💠 "` | A format string shown before the terraform workspace. | | `style` | `"bold 105"` | Стиль модуля. | -| `disabled` | `false` | Disables the `terraform` module. | +| `disabled` | `false` | Отключает модуль `terraform`. | ### Переменные @@ -2286,21 +2288,21 @@ The `time` module shows the current **local** time. The `format` configuration v ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. +По умолчанию этот модуль отключен. Чтобы включить его, установите `disabled` на `false` в файле конфигурации. ::: ### Опции -| Параметр | По умолчанию | Описание | -| ----------------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | -| `format` | `"at [$time]($style) "` | The format string for the module. | -| `use_12hr` | `false` | Enables 12 hour formatting | -| `time_format` | see below | The [chrono format string](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) used to format the time. | -| `style` | `"bold yellow"` | The style for the module time | -| `utc_time_offset` | `"local"` | Sets the UTC offset to use. Range from -24 < x < 24. Allows floats to accommodate 30/45 minute timezone offsets. | -| `disabled` | `true` | Disables the `time` module. | -| `time_range` | `"-"` | Sets the time range during which the module will be shown. Times must be specified in 24-hours format | +| Параметр | По умолчанию | Описание | +| ----------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `format` | `"at [$time]($style) "` | The format string for the module. | +| `use_12hr` | `false` | Включить 12-часовое форматирование | +| `time_format` | см. ниже | [Строка формата chrono](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html), используемая для форматирования времени. | +| `style` | `"bold yellow"` | Стиль модуля времени | +| `utc_time_offset` | `"local"` | Устанавливает смещение UTC. Range from -24 < x < 24. Разрешает числам с плавающей точкой встраивать 30/45-минутное смещение временной зоны. | +| `disabled` | `true` | Отключает модуль `time`. | +| `time_range` | `"-"` | Sets the time range during which the module will be shown. Times must be specified in 24-hours format | If `use_12hr` is `true`, then `time_format` defaults to `"%r"`. Otherwise, it defaults to `"%T"`. Manually setting `time_format` will override the `use_12hr` setting. @@ -2308,7 +2310,7 @@ If `use_12hr` is `true`, then `time_format` defaults to `"%r"`. Otherwise, it de | Переменная | Пример | Описание | | ---------- | ---------- | ----------------------------------- | -| time | `13:08:10` | The current time. | +| время | `13:08:10` | The current time. | | style\* | | Отражает значение параметра `style` | \*: Эта переменная может использоваться только в качестве части строки style @@ -2326,26 +2328,30 @@ utc_time_offset = "-5" time_range = "10:00:00-14:00:00" ``` -## Username +## Имя пользователя The `username` module shows active user's username. Модуль будет показан, если любое из следующих условий соблюдено: -- The current user is root -- The current user isn't the same as the one that is logged in -- The user is currently connected as an SSH session -- The variable `show_always` is set to true +- Текущий пользователь - root +- Текущий пользователь отличается от залогиненного +- Пользователь подключен к SSH-сессии +- Переменная `show_always` равна true -::: tip SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. ::: +::: tip + +SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. + +::: ### Опции -| Параметр | По умолчанию | Описание | -| ------------- | ----------------------- | ------------------------------------- | -| `style_root` | `"bold red"` | The style used when the user is root. | -| `style_user` | `"bold yellow"` | The style used for non-root users. | -| `format` | `"[$user]($style) in "` | Формат модуля. | -| `show_always` | `false` | Always shows the `username` module. | -| `disabled` | `false` | Disables the `username` module. | +| Параметр | По умолчанию | Описание | +| ------------- | ----------------------- | ------------------------------------------------------- | +| `style_root` | `"bold red"` | Стиль, используемый для пользователя root. | +| `style_user` | `"bold yellow"` | Стиль, используемый для всех пользователей, кроме root. | +| `format` | `"[$user]($style) in "` | Формат модуля. | +| `show_always` | `false` | Всегда показывать модуль `username`. | +| `disabled` | `false` | Отключает модуль `username`. | ### Переменные @@ -2437,7 +2443,7 @@ The order in which custom modules are shown can be individually set by including | `command` | | The command whose output should be printed. The command will be passed on stdin to the shell. | | `when` | | A shell command used as a condition to show the module. The module will be shown if the command returns a `0` status code. | | `shell` | | [See below](#custom-command-shell) | -| `description` | `""` | The description of the module that is shown when running `starship explain`. | +| `описание` | `""` | The description of the module that is shown when running `starship explain`. | | `files` | `[]` | The files that will be searched in the working directory for a match. | | `directories` | `[]` | The directories that will be searched in the working directory for a match. | | `extensions` | `[]` | The extensions that will be searched in the working directory for a match. | diff --git a/docs/ru-RU/guide/README.md b/docs/ru-RU/guide/README.md index 3a2a2896..e8cc54e9 100644 --- a/docs/ru-RU/guide/README.md +++ b/docs/ru-RU/guide/README.md @@ -125,6 +125,8 @@ ### Начало работы +**Note**: due to the proliferation of different platforms, only a subset of supported platforms are shown below. Can't see yours? Have a look at the [extra platform instructions](https://starship.rs/installing/). + 1. Установите двоичный файл **starship**: @@ -138,17 +140,10 @@ ``` - ##### Из источника на [crates.io](https://crates.io/): - - ```sh - cargo install starship - ``` - - #### Установить через менеджер пакетов - ##### С [Homebrew](https://brew.sh/): + ##### Example: [Homebrew](https://brew.sh/): ```sh brew install starship @@ -161,7 +156,7 @@ scoop install starship ``` -1. Добавить сценарий инициализации в конфигурационный файл вашей оболочки: +2. Добавить сценарий инициализации в конфигурационный файл вашей оболочки: #### Bash diff --git a/docs/ru-RU/installing/README.md b/docs/ru-RU/installing/README.md new file mode 100644 index 00000000..6f0ea0d6 --- /dev/null +++ b/docs/ru-RU/installing/README.md @@ -0,0 +1,46 @@ +# 🚀 Advanced Installation + +To install starship, you need to do two things: + +1. Get the **starship** binary onto your computer +1. Tell your shell to use the starship binary as its prompt by modifying its init scripts + +For most users, the instructions on [the main page](/guide/#🚀-installation) will work great. However, for some more specialized platforms, different instructions are needed. + +There are so many platforms out there that they didn't fit into the main README.md file, so here are some installation instructions for other platforms from the community. Is yours not here? Please do add it here if you figure it out! + +## [Nix](https://nixos.wiki/wiki/Nix) + +### Getting the Binary + +#### Imperatively + +```sh +nix-env -iA nixos.starship +``` + +#### Declarative, single user, via [home-manager](home-manager) + +Add `pkgs.starship` to your `home.packages` in your `home.nix` file, then run + +```sh +home-manager switch +``` + +#### Declarative, system-wide, with NixOS + +Add `pkgs.starship` to `environment.packages` in your `configuration.nix`, then run + +```sh +sudo nixos-rebuild switch +``` + +### Modifying Init Scripts + +#### With Nix and home-manager, using zsh: + +Add the following to `programs.zsh.initExtra` in your `home.nix` file, then run + +```sh +home-manager switch +``` diff --git a/docs/tr-TR/config/README.md b/docs/tr-TR/config/README.md index 286375e2..c9970753 100644 --- a/docs/tr-TR/config/README.md +++ b/docs/tr-TR/config/README.md @@ -1804,13 +1804,13 @@ The `package` module is shown when the current directory is the repository for a ### Options -| Option | Default | Description | -| ----------------- | ---------------------------------- | ---------------------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | The format for the module. | -| `symbol` | `"📦 "` | The symbol used before displaying the version the package. | -| `style` | `"bold 208"` | The style for the module. | -| `display_private` | `false` | Enable displaying version for packages marked as private. | -| `disabled` | `false` | Disables the `package` module. | +| Option | Default | Description | +| ----------------- | --------------------------------- | ---------------------------------------------------------- | +| `format` | `"is [$symbol$version]($style) "` | The format for the module. | +| `symbol` | `"📦 "` | The symbol used before displaying the version the package. | +| `style` | `"bold 208"` | The style for the module. | +| `display_private` | `false` | Enable displaying version for packages marked as private. | +| `disabled` | `false` | Disables the `package` module. | ### Variables @@ -2151,7 +2151,9 @@ The `status` module displays the exit code of the previous command. The module w ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. ::: +This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. + +::: ### Options @@ -2335,7 +2337,11 @@ The `username` module shows active user's username. The module will be shown if - The user is currently connected as an SSH session - The variable `show_always` is set to true -::: tip SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. ::: +::: tip + +SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. + +::: ### Options diff --git a/docs/tr-TR/guide/README.md b/docs/tr-TR/guide/README.md index 74b5b1e6..9f33e569 100644 --- a/docs/tr-TR/guide/README.md +++ b/docs/tr-TR/guide/README.md @@ -125,6 +125,8 @@ ### Getting Started +**Note**: due to the proliferation of different platforms, only a subset of supported platforms are shown below. Can't see yours? Have a look at the [extra platform instructions](https://starship.rs/installing/). + 1. Install the **starship** binary: @@ -138,17 +140,10 @@ ``` - ##### From source on [crates.io](https://crates.io/): - - ```sh - cargo install starship - ``` - - #### Install via Package Manager - ##### With [Homebrew](https://brew.sh/): + ##### Example: [Homebrew](https://brew.sh/): ```sh brew install starship @@ -161,7 +156,7 @@ scoop install starship ``` -1. Add the init script to your shell's config file: +2. Add the init script to your shell's config file: #### Bash diff --git a/docs/tr-TR/installing/README.md b/docs/tr-TR/installing/README.md new file mode 100644 index 00000000..6f0ea0d6 --- /dev/null +++ b/docs/tr-TR/installing/README.md @@ -0,0 +1,46 @@ +# 🚀 Advanced Installation + +To install starship, you need to do two things: + +1. Get the **starship** binary onto your computer +1. Tell your shell to use the starship binary as its prompt by modifying its init scripts + +For most users, the instructions on [the main page](/guide/#🚀-installation) will work great. However, for some more specialized platforms, different instructions are needed. + +There are so many platforms out there that they didn't fit into the main README.md file, so here are some installation instructions for other platforms from the community. Is yours not here? Please do add it here if you figure it out! + +## [Nix](https://nixos.wiki/wiki/Nix) + +### Getting the Binary + +#### Imperatively + +```sh +nix-env -iA nixos.starship +``` + +#### Declarative, single user, via [home-manager](home-manager) + +Add `pkgs.starship` to your `home.packages` in your `home.nix` file, then run + +```sh +home-manager switch +``` + +#### Declarative, system-wide, with NixOS + +Add `pkgs.starship` to `environment.packages` in your `configuration.nix`, then run + +```sh +sudo nixos-rebuild switch +``` + +### Modifying Init Scripts + +#### With Nix and home-manager, using zsh: + +Add the following to `programs.zsh.initExtra` in your `home.nix` file, then run + +```sh +home-manager switch +``` diff --git a/docs/zh-CN/advanced-config/README.md b/docs/zh-CN/advanced-config/README.md index fc5a0020..881617ee 100644 --- a/docs/zh-CN/advanced-config/README.md +++ b/docs/zh-CN/advanced-config/README.md @@ -82,7 +82,7 @@ starship_precmd_user_func="set_win_title" `` 是颜色说明符（下面解释）。 `fg:` 和 `` 当前产生一样的效果，尽管未来可能会改变。 字符串中的单词顺序不影响显示结果。 -The `none` token overrides all other tokens in a string if it is not part of a `bg:` specifier, so that e.g. `fg:red none fg:blue` will still create a string with no styling. `bg:none` sets the background to the default color so `fg:red bg:none` is equivalent to `red` or `fg:red` and `bg:green fg:red bg:none` is also equivalent to `fg:red` or `red`. It may become an error to use `none` in conjunction with other tokens in the future. +The `none` token overrides all other tokens in a string if it is not part of a `bg:` specifier, so that e.g. `fg:red none fg:blue` will still create a string with no styling. `bg:none` sets the background to the default color so `fg:red bg:none` is equivalent to `red` or `fg:red` and `bg:green fg:red bg:none` is also equivalent to `fg:red` or `red`. 未来可能会将 `none` 与其它标识符一起使用视为一种错误。 颜色说明符可以是以下内容之一： diff --git a/docs/zh-CN/config/README.md b/docs/zh-CN/config/README.md index c2c21a26..7d7ffb9a 100644 --- a/docs/zh-CN/config/README.md +++ b/docs/zh-CN/config/README.md @@ -303,16 +303,16 @@ symbol = "🅰 " ### 配置项 -| Option | 默认值 | 描述 | -| -------------------- | --------------------------------- | --------------------------------------------------- | -| `full_symbol` | `""` | 显示于电池充满时。 | -| `charging_symbol` | `""` | 显示于正在充电时。 | -| `discharging_symbol` | `""` | 显示于电池放电时。 | -| `unknown_symbol` | `""` | The symbol shown when the battery state is unknown. | -| `empty_symbol` | `""` | The symbol shown when the battery state is empty. | -| `format` | `"[$symbol$percentage]($style) "` | 组件格式化模板。 | -| `display` | [见下文](#battery-display) | Display threshold and style for the module. | -| `disabled` | `false` | Disables the `battery` module. | +| Option | 默认值 | 描述 | +| -------------------- | --------------------------------- | ---------------- | +| `full_symbol` | `""` | 显示于电池充满时。 | +| `charging_symbol` | `""` | 显示于正在充电时。 | +| `discharging_symbol` | `""` | 显示于电池放电时。 | +| `unknown_symbol` | `""` | 显示于电池状态未知时 | +| `empty_symbol` | `""` | 显示于电池状态为空时 | +| `format` | `"[$symbol$percentage]($style) "` | 组件格式化模板。 | +| `display` | [见下文](#battery-display) | 电量显示阈值和样式。 | +| `disabled` | `false` | 禁用 `battery` 组件。 | ### 示例 @@ -328,7 +328,7 @@ discharging_symbol = "💀" ### Battery 组件的显示 -The `display` configuration option is used to define when the battery indicator should be shown (threshold) and what it looks like (style). If no `display` is provided. 默认设置如下： +`display` 选项用于定义电池指示器的显示阈值（threshold）和显示效果（style）。 如果 `display` 没有设置， 默认设置如下： ```toml [[battery.display]] @@ -338,12 +338,12 @@ style = "bold red" #### 配置项 -The `display` option is an array of the following table. +`display` 字段的子字段如下： -| Option | 描述 | -| ----------- | ----------------------------------------------- | -| `threshold` | The upper bound for the display option. | -| `style` | The style used if the display option is in use. | +| Option | 描述 | +| ----------- | ---------------- | +| `threshold` | 当前显示设置的电量上限（见示例） | +| `style` | 若组件被显示，则使用此样式 | #### 示例 @@ -362,9 +362,9 @@ style = "bold yellow" ## Character -The `character` module shows a character (usually an arrow) beside where the text is entered in your terminal. +`character` 组件用于在您输入终端的文本旁显示一个字符（通常是一个箭头）。 -The character will tell you whether the last command was successful or not. It can do this in two ways: +这个字符可以告诉您最后一个命令是否执行成功。 It can do this in two ways: - changing color (`red`/`green`) - changing shape (`❯`/`✖`) @@ -379,7 +379,7 @@ By default it only changes color. If you also want to change it's shape take a l | `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. | | `vicmd_symbol` | `"[❮](bold green)"` | The format string used before the text input if the shell is in vim normal mode. | -| `disabled` | `false` | Disables the `character` module. | +| `disabled` | `false` | 禁用 `character` 组件。 | ### Variables @@ -446,27 +446,27 @@ The `cmake` module shows the currently installed version of CMake if any of the ## Command Duration -The `cmd_duration` module shows how long the last command took to execute. The module will be shown only if the command took longer than two seconds, or the `min_time` config value, if it exists. +`cmd_duration` 组件显示上一个命令执行的时间。 此组件只在命令执行时间长于两秒时显示，或者当其 `min_time` 字段被设置时，按此值为执行时间的显示下限。 -::: warning Do not hook the DEBUG trap in Bash +::: warning 不要在 Bash 里捕获 DEBUG 信号 -If you are running Starship in `bash`, do not hook the `DEBUG` trap after running `eval $(starship init $0)`, or this module **will** break. +如果您正在 `bash` 上使用 Starship，在运行 `eval $(starship)` 后，不要捕获 `DEBUG` 信号，否则此组件**将会**坏掉。 ::: -Bash users who need preexec-like functionality can use [rcaloras's bash_preexec framework](https://github.com/rcaloras/bash-preexec). Simply define the arrays `preexec_functions` and `precmd_functions` before running `eval $(starship init $0)`, and then proceed as normal. +需要在自动每一条命令前执行某些操作的 Bash 用户可以使用 [rcaloras 的 bash_preexec 框架](https://github.com/rcaloras/bash-preexec)。 只需要在执行 `eval $(starship init $0)` 前简单地定义 `preexec_functions` 和 `precmd_functions` 两个列表，就可以照常运行了。 ### 配置项 -| Option | 默认值 | 描述 | -| -------------------- | ----------------------------- | ---------------------------------------------------------- | -| `min_time` | `2_000` | Shortest duration to show time for (in milliseconds). | -| `show_milliseconds` | `false` | Show milliseconds in addition to seconds for the duration. | -| `format` | `"took [$duration]($style) "` | 组件格式化模板。 | -| `style` | `"bold yellow"` | 此组件的样式。 | -| `disabled` | `false` | Disables the `cmd_duration` module. | -| `show_notifications` | `false` | Show desktop notifications when command completes. | -| `min_time_to_notify` | `45_000` | Shortest duration for notification (in milliseconds). | +| Option | 默认值 | 描述 | +| -------------------- | ----------------------------- | ----------------------------------------------------- | +| `min_time` | `2_000` | 显示此组件所需的最短执行时长（单位：毫秒）。 | +| `show_milliseconds` | `false` | 除了秒数外在执行时长中额外显示毫秒。 | +| `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). | ::: tip @@ -495,24 +495,24 @@ format = "underwent [$duration](bold yellow)" ## Conda -The `conda` module shows the current conda environment, if `$CONDA_DEFAULT_ENV` is set. +`conda` 组件在 `$CONDA_DEFAULT_ENV` 被设置时显示当前 conda 环境。 ::: tip -This does not suppress conda's own prompt modifier, you may want to run `conda config --set changeps1 False`. +此组件没有禁用 conda 自带的提示符修改，您可能需要执行 `conda config --set changeps1 False`。 ::: ### 配置项 -| Option | 默认值 | 描述 | -| ------------------- | -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `truncation_length` | `1` | The number of directories the environment path should be truncated to, if the environment was created via `conda create -p [path]`. `0` means no truncation. Also see the [`directory`](#directory) module. | -| `symbol` | `"🅒 "` | The symbol used before the environment name. | -| `style` | `"bold green"` | 此组件的样式。 | -| `format` | `"via [$symbol$environment]($style) "` | 组件格式化模板。 | -| `ignore_base` | `true` | Ignores `base` environment when activated. | -| `disabled` | `false` | Disables the `conda` module. | +| Option | 默认值 | 描述 | +| ------------------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | +| `truncation_length` | `1` | 如果这个 conda 环境是通过 `conda create -p [path]` 创建的，环境路径的目录深度应该被截断到此数量。 `0` 表示不用截断。 另请参阅 [`directory`](#directory) 组件。 | +| `symbol` | `"🅒 "` | 在环境名之前显示的符号。 | +| `style` | `"bold green"` | 此组件的样式。 | +| `format` | `"via [$symbol$environment]($style) "` | 组件格式化模板。 | +| `ignore_base` | `true` | Ignores `base` environment when activated. | +| `disabled` | `false` | 禁用 `conda` 组件。 | ### Variables @@ -606,33 +606,33 @@ format = "via [🔰 $version](bold red) " ## Directory -The `directory` module shows the path to your current directory, truncated to three parent folders. Your directory will also be truncated to the root of the git repo that you're currently in. +`directory` 组件显示当前目录的路径，显示的路径会截断到三个父目录以内。 如果您处于一个 git 仓库中，显示的路径则最多会截断到该仓库的根目录。 -When using the fish style pwd 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 风格的当前目录显示样式时，您会看到基于您的设置的每个上级目录的短名称，而不是隐藏被截断的上级目录。 -For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, and the option set to `1`. You will now see `~/D/N/nixpkgs/pkgs`, whereas before it would have been `nixpkgs/pkgs`. +例如，对于 `~/Dev/Nix/nixpkgs/pkgs`，其中 `nixpkgs` 是 git 仓库根目录，fish 风格相关选项设置为 `1`。 您将会看到 `~/D/N/nixpkgs/pkgs`，而在设置 fish 风格之前，当前路径将显示成 `nixpkgs/pkgs`。 ### 配置项 -| Option | 默认值 | 描述 | -| ------------------- | -------------------------------------------------- | -------------------------------------------------------------------------------- | -| `truncation_length` | `3` | The number of parent folders that the current directory should be truncated to. | -| `truncate_to_repo` | `true` | Whether or not to truncate to the root of the git repo that you're currently in. | -| `format` | `"[$path]($style)[$read_only]($read_only_style) "` | 组件格式化模板。 | -| `style` | `"bold cyan"` | 此组件的样式。 | -| `disabled` | `false` | Disables the `directory` module. | -| `read_only` | `"🔒"` | The symbol indicating current directory is read only. | -| `read_only_style` | `"red"` | The style for the read only symbol. | -| `truncation_symbol` | `""` | The symbol to prefix to truncated paths. eg: "…/" | +| Option | 默认值 | 描述 | +| ------------------- | -------------------------------------------------- | ----------------------------------------------------- | +| `truncation_length` | `3` | 当前目录路径被截断后最多保留的父目录数量。 | +| `truncate_to_repo` | `true` | 是否只截断到您当前处于的 git 仓库根目录下。 | +| `format` | `"[$path]($style)[$read_only]($read_only_style) "` | 组件格式化模板。 | +| `style` | `"bold cyan"` | 此组件的样式。 | +| `disabled` | `false` | 禁用 `directory` 组件。 | +| `read_only` | `"🔒"` | The symbol indicating current directory is read only. | +| `read_only_style` | `"red"` | The style for the read only symbol. | +| `truncation_symbol` | `""` | The symbol to prefix to truncated paths. eg: "…/" |
-This module has a few advanced configuration options that control how the directory is displayed. +此组件有几个高级配置选项来控制当前目录路径的显示方式。 -| Advanced Option | 默认值 | 描述 | -| --------------------------- | ------ | ---------------------------------------------------------------------------------------- | -| `substitutions` | | A table of substitutions to be made to the path. | -| `fish_style_pwd_dir_length` | `0` | The number of characters to use when applying fish shell pwd path logic. | -| `use_logical_path` | `true` | Displays the logical path provided by the shell (`PWD`) instead of the path from the OS. | +| Advanced Option | 默认值 | 描述 | +| --------------------------- | ------ | ------------------------------------------------ | +| `substitutions` | | A table of substitutions to be made to the path. | +| `fish_style_pwd_dir_length` | `0` | 使用 fish shell 当前目录路径逻辑时每个省略目录名使用的字符数。 | +| `use_logical_path` | `true` | 显示由 shell 提供的逻辑路径（`PWD`）而不是 OS 提供的路径。 | `substitutions` allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories (i.e. Java). Note that this will disable the fish style PWD. @@ -700,7 +700,7 @@ format = "via [🐋 $context](blue bold)" ## Dotnet -The `dotnet` module shows the relevant version of the .NET Core SDK for the current directory. If the SDK has been pinned in the current directory, the pinned version is shown. Otherwise the module shows the latest installed version of the SDK. +`dotnet` 模块显示与当前目录下使用的 .NET Core SDK 相关联的版本。 如果当前目录已被绑定了一个版本的 SDK，则显示被帮定的版本。 否则此组件将显示最新安装的 SDK 版本。 This module will only be shown in your prompt when one or more of the following files are present in the current directory: @@ -716,19 +716,19 @@ This module will only be shown in your prompt when one or more of the following You'll also need the .NET Core SDK installed in order to use it correctly. -Internally, this module uses its own mechanism for version detection. Typically it is twice as fast as running `dotnet --version`, but it may show an incorrect version if your .NET project has an unusual directory layout. If accuracy is more important than speed, you can disable the mechanism by setting `heuristic = false` in the module options. +在内部，此组件使用自己的版本检测机制。 一般来说此组件是直接执行 `dotnet --version` 的两倍快，但当你的 .NET 项目使用了不常见的目录布局时此组件可能显示一个错误的版本。 如果相比于速度您更需要正确的版本号，您可以在组件设置中设置 `heuristic = false` 来禁用该机制。 The module will also show the Target Framework Moniker () when there is a csproj file in the current directory. ### 配置项 -| Option | 默认值 | 描述 | -| ----------- | --------------------------------------- | -------------------------------------------------------- | -| `format` | `"[$symbol$version( 🎯 $tfm)]($style) "` | 组件格式化模板。 | -| `symbol` | `"•NET "` | The symbol used before displaying the version of dotnet. | -| `heuristic` | `true` | Use faster version detection to keep starship snappy. | -| `style` | `"bold blue"` | 此组件的样式。 | -| `disabled` | `false` | Disables the `dotnet` module. | +| Option | 默认值 | 描述 | +| ----------- | --------------------------------------- | ------------------------------ | +| `format` | `"[$symbol$version( 🎯 $tfm)]($style) "` | 组件格式化模板。 | +| `symbol` | `"•NET "` | 这个字段的内容会显示在当前 .NET 版本之前。 | +| `heuristic` | `true` | 使用更快的版本探测机制以保证 starship 的运行速度。 | +| `style` | `"bold blue"` | 此组件的样式。 | +| `disabled` | `false` | 禁用 `dotnet` 组件。 | ### Variables @@ -827,20 +827,20 @@ format = "via [ $version](cyan bold) " ## Environment Variable -The `env_var` module displays the current value of a selected environment variable. The module will be shown only if any of the following conditions are met: +`env_var` 组件显示选定的环境变量的当前值。 此组件只有满足以下条件之一时才会被显示： - 设置的 `variable` 是一个已存在的环境变量 - 未定义 `variable`，但定义了 `default` ### 配置项 -| Option | 默认值 | 描述 | -| ---------- | ------------------------------ | ---------------------------------------------------------------------------- | -| `symbol` | | The symbol used before displaying the variable value. | -| `variable` | | The environment variable to be displayed. | -| `default` | | The default value to be displayed when the selected variable is not defined. | -| `format` | `"with [$env_value]($style) "` | 组件格式化模板。 | -| `disabled` | `false` | Disables the `env_var` module. | +| Option | 默认值 | 描述 | +| ---------- | ------------------------------ | ------------------- | +| `symbol` | | 这个字段的内容会显示在环境变量值之前。 | +| `variable` | | 要显示的环境变量。 | +| `default` | | 所选变量未定义时显示的默认值。 | +| `format` | `"with [$env_value]($style) "` | 组件格式化模板。 | +| `disabled` | `false` | 禁用 `env_var` 组件。 | ### Variables @@ -959,20 +959,20 @@ asia-northeast1 = "an1" ## Git Branch -The `git_branch` module shows the active branch of the repo in your current directory. +`git_branch` 组件显示当前目录的 git 仓库的活动分支。 ### 配置项 -| Option | 默认值 | 描述 | -| -------------------- | -------------------------------- | ---------------------------------------------------------------------------------------- | -| `always_show_remote` | `false` | Shows the remote tracking branch name, even if it is equal to the local branch name. | -| `format` | `"on [$symbol$branch]($style) "` | 组件格式化模板。 Use `"$branch"` to refer to the current branch name. | -| `symbol` | `" "` | A format string representing the symbol of git branch. | -| `style` | `"bold purple"` | 此组件的样式。 | -| `truncation_length` | `2^63 - 1` | Truncates a git branch to X graphemes. | -| `truncation_symbol` | `"…"` | The symbol used to indicate a branch name was truncated. You can use `""` for no symbol. | -| `only_attached` | `false` | Only show the branch name when not in a detached HEAD state. | -| `disabled` | `false` | Disables the `git_branch` module. | +| Option | 默认值 | 描述 | +| -------------------- | -------------------------------- | ------------------------------------------------------------------------------------ | +| `always_show_remote` | `false` | Shows the remote tracking branch name, even if it is equal to the local branch name. | +| `format` | `"on [$symbol$branch]($style) "` | 组件格式化模板。 Use `"$branch"` to refer to the current branch name. | +| `symbol` | `" "` | A format string representing the symbol of git branch. | +| `style` | `"bold purple"` | 此组件的样式。 | +| `truncation_length` | `2^63 - 1` | Truncates a git branch to X graphemes. | +| `truncation_symbol` | `"…"` | 此字段的内容用来表示分支名称被截断。 You can use `""` for no symbol. | +| `only_attached` | `false` | Only show the branch name when not in a detached HEAD state. | +| `disabled` | `false` | 禁用 `git_branch` 组件。 | ### Variables @@ -1005,13 +1005,13 @@ The `git_commit` module shows the current commit hash and also the tag (if any) | Option | 默认值 | 描述 | | -------------------- | ------------------------------------------------------ | ----------------------------------------------------- | -| `commit_hash_length` | `7` | The length of the displayed git commit hash. | +| `commit_hash_length` | `7` | 显示的 git 提交哈希值的长度。 | | `format` | `"[\\($hash\\)]($style) [\\($tag\\)]($style)"` | 组件格式化模板。 | | `style` | `"bold green"` | 此组件的样式。 | | `only_detached` | `true` | Only show git commit hash when in detached HEAD state | | `tag_disabled` | `true` | Disables showing tag info in `git_commit` module. | | `tag_symbol` | `"🏷 "` | Tag symbol prefixing the info shown | -| `disabled` | `false` | Disables the `git_commit` module. | +| `disabled` | `false` | 禁用 `git_commit` 组件。 | ### Variables @@ -1034,7 +1034,7 @@ tag_symbol = "🔖 " ## Git State -The `git_state` module will show in directories which are part of a git repository, and where there is an operation in progress, such as: _REBASING_, _BISECTING_, etc. If there is progress information (e.g., REBASING 3/10), that information will be shown too. +`git_state` 组件会显示当前目录在哪个 git 仓库中，以及正在进行的操作，例如：_REBASING_，_BISECTING_ 等。 进度信息（例如 REBASING 3/10）如果存在则也会被显示。 ### 配置项 @@ -1049,7 +1049,7 @@ The `git_state` module will show in directories which are part of a git reposito | `am_or_rebase` | `"AM/REBASE"` | A format string displayed when an ambiguous `apply-mailbox` or `rebase` is in progress. | | `style` | `"bold yellow"` | 此组件的样式。 | | `format` | `'\([$state( $progress_current/$progress_total)]($style)\) '` | 组件格式化模板。 | -| `disabled` | `false` | Disables the `git_state` module. | +| `disabled` | `false` | 禁用 `git_state` 模块 | ### Variables @@ -1074,14 +1074,14 @@ cherry_pick = "[🍒 PICKING](bold red)" ## Git Status -The `git_status` module shows symbols representing the state of the repo in your current directory. +`git_status`组件通过相应的符号显示您当前目录中 git 仓库的状态。 ### 配置项 | Option | 默认值 | 描述 | | ------------ | ----------------------------------------------- | ----------------------------------- | | `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | The default format for `git_status` | -| `conflicted` | `"="` | This branch has merge conflicts. | +| `conflicted` | `"="` | 这个分支有合并冲突。 | | `ahead` | `"⇡"` | The format of `ahead` | | `behind` | `"⇣"` | The format of `behind` | | `diverged` | `"⇕"` | The format of `diverged` | @@ -1092,7 +1092,7 @@ The `git_status` module shows symbols representing the state of the repo in your | `renamed` | `"»"` | The format of `renamed` | | `deleted` | `"✘"` | The format of `deleted` | | `style` | `"bold red"` | 此组件的样式。 | -| `disabled` | `false` | Disables the `git_status` module. | +| `disabled` | `false` | 禁用 `git_status` 组件。 | ### Variables @@ -1122,9 +1122,9 @@ The following variables can be used in `diverged`: The following variables can be used in `conflicted`, `ahead`, `behind`, `untracked`, `stashed`, `modified`, `staged`, `renamed` and `deleted`: -| 字段 | 描述 | -| ------- | ------------------------ | -| `count` | Show the number of files | +| 字段 | 描述 | +| ------- | --------- | +| `count` | 显示相应的文件数量 | ### 示例 @@ -1157,7 +1157,7 @@ behind = "⇣${count}" ## Golang -The `golang` module shows the currently installed version of Golang. 此组件将在符合以下任意条件之一时显示： +`golang` 组件显示当前安装的 Golang 版本。 此组件将在符合以下任意条件之一时显示： - 当前目录包含 `go.mod` 文件 - 当前目录包含 `go.sum` 文件 @@ -1175,7 +1175,7 @@ The `golang` module shows the currently installed version of Golang. 此组件 | `format` | `"via [$symbol$version]($style) "` | 组件格式化模板。 | | `symbol` | `"🐹 "` | A format string representing the symbol of Go. | | `style` | `"bold cyan"` | 此组件的样式。 | -| `disabled` | `false` | Disables the `golang` module. | +| `disabled` | `false` | 禁用 `golang` 组件。 | ### Variables @@ -1233,17 +1233,17 @@ format = "via [⎈ $version](bold white) " ## Hostname -The `hostname` module shows the system hostname. +`hostname` 组件显示系统主机名。 ### 配置项 -| Option | 默认值 | 描述 | -| ---------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | -| `ssh_only` | `true` | Only show hostname when connected to an SSH session. | -| `trim_at` | `"."` | String that the hostname is cut off at, after the first match. `"."` will stop after the first dot. `""` will disable any truncation | -| `format` | `"[$hostname]($style) in "` | 组件格式化模板。 | -| `style` | `"bold dimmed green"` | 此组件的样式。 | -| `disabled` | `false` | Disables the `hostname` module. | +| Option | 默认值 | 描述 | +| ---------- | --------------------------- | ------------------------------------------------------------------ | +| `ssh_only` | `true` | 仅在连接到 SSH 会话时显示主机名。 | +| `trim_at` | `"."` | 当主机名过长被截断时，会截断成第一次匹配该字符串之前的主机名。 `"."` 会让主机名截断到第一个点处。 `""` 会禁用任何截断。 | +| `format` | `"[$hostname]($style) in "` | 组件格式化模板。 | +| `style` | `"bold dimmed green"` | 此组件的样式。 | +| `disabled` | `false` | 禁用 `hostname` 组件。 | ### Variables @@ -1268,7 +1268,7 @@ disabled = false ## Java -The `java` module shows the currently installed version of Java. 此组件将在符合以下任意条件之一时显示： +`java` 组件显示当前安装的 Java 版本。 此组件将在符合以下任意条件之一时显示： - The current directory contains a `pom.xml`, `build.gradle.kts`, `build.sbt`, `.java-version`, `.deps.edn`, `project.clj`, or `build.boot` file - The current directory contains a file with the `.java`, `.class`, `.gradle`, `.jar`, `.clj`, or `.cljc` extension @@ -1280,7 +1280,7 @@ The `java` module shows the currently installed version of Java. 此组件将在 | `format` | `"via [${symbol}${version}]($style) "` | 组件格式化模板。 | | `symbol` | `"☕ "` | A format string representing the symbol of Java | | `style` | `"red dimmed"` | 此组件的样式。 | -| `disabled` | `false` | Disables the `java` module. | +| `disabled` | `false` | 禁用 `java` 组件。 | ### Variables @@ -1303,17 +1303,17 @@ symbol = "🌟 " ## Jobs -The `jobs` module shows the current number of jobs running. The module will be shown only if there are background jobs running. The module will show the number of jobs running if there is more than 1 job, or more than the `threshold` config value, if it exists. +`jobs` 组件显示当前正在运行的任务数量。 仅当有后台任务运行时，此组件才会显示。 如果有超过 1 个作业，模块将显示正在运行的作业数量，如果配置了 `threshold` 字段，则使用它作为显示作业数量的下限。 ### 配置项 | Option | 默认值 | 描述 | | ----------- | ----------------------------- | ------------------------------------------------ | -| `threshold` | `1` | Show number of jobs if exceeded. | +| `threshold` | `1` | 如果超过此字段的值，显示任务数量。 | | `format` | `"[$symbol$number]($style) "` | 组件格式化模板。 | | `symbol` | `"✦"` | A format string representing the number of jobs. | | `style` | `"bold blue"` | 此组件的样式。 | -| `disabled` | `false` | Disables the `jobs` module. | +| `disabled` | `false` | 禁用 `jobs` 组件。 | ### Variables @@ -1420,7 +1420,7 @@ Displays the current Kubernetes context name and, if set, the namespace from the ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. +此组件默认被禁用。 若要启用此组件，请在配置文件中设置 `disable` 字段为 `false`。 ::: @@ -1459,13 +1459,13 @@ disabled = false ## Line Break -The `line_break` module separates the prompt into two lines. +`line_break` 组件将提示分隔为两行。 ### 配置项 -| Option | 默认值 | 描述 | -| ---------- | ------- | ------------------------------------------------------------------ | -| `disabled` | `false` | Disables the `line_break` module, making the prompt a single line. | +| Option | 默认值 | 描述 | +| ---------- | ------- | --------------------------- | +| `disabled` | `false` | 禁用 `line_break` 组件，使提示成为单行。 | ### 示例 @@ -1515,25 +1515,25 @@ format = "via [🌕 $version](bold blue) " ## Memory Usage -The `memory_usage` module shows current system memory and swap usage. +`memory_usage` 组件显示当前系统内存和交换区使用情况。 -By default the swap usage is displayed if the total system swap is non-zero. +默认情况下，如果系统交换区使用不为 0，则会显示交换区使用情况。 ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. +此组件默认被禁用。 若要启用此组件，请在配置文件中设置 `disable` 字段为 `false`。 ::: ### 配置项 -| Option | 默认值 | 描述 | -| ----------- | --------------------------------------------- | -------------------------------------------------------- | -| `threshold` | `75` | Hide the memory usage unless it exceeds this percentage. | -| `format` | `"via $symbol [${ram}( | ${swap})]($style) "` | 组件格式化模板。 | -| `symbol` | `"🐏"` | The symbol used before displaying the memory usage. | -| `style` | `"bold dimmed white"` | 此组件的样式。 | -| `disabled` | `true` | Disables the `memory_usage` module. | +| Option | 默认值 | 描述 | +| ----------- | --------------------------------------------- | ---------------------- | +| `threshold` | `75` | 隐藏内存使用情况，除非它超过这个百分比。 | +| `format` | `"via $symbol [${ram}( | ${swap})]($style) "` | 组件格式化模板。 | +| `symbol` | `"🐏"` | 这个字段的内容会显示在当前内存使用情况之前。 | +| `style` | `"bold dimmed white"` | 此组件的样式。 | +| `disabled` | `true` | 禁用 `memory_usage` 模块 | ### Variables @@ -1562,18 +1562,18 @@ style = "bold dimmed green" ## Mercurial Branch -The `hg_branch` module shows the active branch of the repo in your current directory. +`hg_branch` 组件显示当前目录的 hg 仓库的活动分支。 ### 配置项 -| Option | 默认值 | 描述 | -| ------------------- | -------------------------------- | -------------------------------------------------------------------------------------------- | -| `symbol` | `" "` | The symbol used before the hg bookmark or branch name of the repo in your current directory. | -| `style` | `"bold purple"` | 此组件的样式。 | -| `format` | `"on [$symbol$branch]($style) "` | 组件格式化模板。 | -| `truncation_length` | `2^63 - 1` | Truncates the hg branch name to X graphemes | -| `truncation_symbol` | `"…"` | The symbol used to indicate a branch name was truncated. | -| `disabled` | `true` | Disables the `hg_branch` module. | +| Option | 默认值 | 描述 | +| ------------------- | -------------------------------- | ------------------------------- | +| `symbol` | `" "` | 该字段的内容显示于当前仓库的 hg 书签或活动分支名之前。 | +| `style` | `"bold purple"` | 此组件的样式。 | +| `format` | `"on [$symbol$branch]($style) "` | 组件格式化模板。 | +| `truncation_length` | `2^63 - 1` | 将显示的 hg 分支名截断到该数量的字素（graphemes） | +| `truncation_symbol` | `"…"` | 此字段的内容用来表示分支名称被截断。 | +| `disabled` | `true` | 禁用 `hg_branch` 组件。 | ### Variables @@ -1636,7 +1636,7 @@ symbol = "🎣 " ## Nix-shell -The `nix_shell` module shows the nix-shell environment. The module will be shown when inside a nix-shell environment. +`nix_shell` 组件显示 nix-shell 环境。 当处于一个 nix-shell 环境中时，此组件会被显示。 ### 配置项 @@ -1647,7 +1647,7 @@ The `nix_shell` module shows the nix-shell environment. The module will be shown | `style` | `"bold blue"` | 此组件的样式。 | | `impure_msg` | `"impure"` | A format string shown when the shell is impure. | | `pure_msg` | `"pure"` | A format string shown when the shell is pure. | -| `disabled` | `false` | Disables the `nix_shell` module. | +| `disabled` | `false` | 禁用 `nix_shell` 组件。 | ### Variables @@ -1674,11 +1674,11 @@ format = 'via [☃️ $state( \($name\))](bold blue) ' ## NodeJS -The `nodejs` module shows the currently installed version of NodeJS. 此组件将在符合以下任意条件之一时显示： +`nodejs` 组件显示当前安装的 NodeJS 版本。 此组件将在符合以下任意条件之一时显示： -- The current directory contains a `package.json` file +- 当前目录包含 `package.json` 文件 - The current directory contains a `.node-version` file -- The current directory contains a `node_modules` directory +- 当前目录包含 `node_modules` 目录 - The current directory contains a file with the `.js`, `.mjs` or `.cjs` extension - The current directory contains a file with the `.ts` extension @@ -1689,7 +1689,7 @@ The `nodejs` module shows the currently installed version of NodeJS. 此组件 | `format` | `"via [$symbol$version]($style) "` | 组件格式化模板。 | | `symbol` | `"⬢ "` | A format string representing the symbol of NodeJS. | | `style` | `"bold green"` | 此组件的样式。 | -| `disabled` | `false` | Disables the `nodejs` module. | +| `disabled` | `false` | 禁用 `nodejs` 组件。 | | `not_capable_style` | `bold red` | The style for the module when an engines property in Packages.json does not match the NodeJS version. | ###  Variables @@ -1787,12 +1787,12 @@ symbol = "☁️ " ## Package Version -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`, `cargo`, `poetry`, `composer`, `gradle`, `julia`, `mix` and `helm` packages. +当前目录是软件包的代码仓库时，将显示 `package` 组件，并显示软件包当前版本。 The module currently supports `npm`, `cargo`, `poetry`, `composer`, `gradle`, `julia`, `mix` and `helm` packages. -- **npm** – The `npm` package version is extracted from the `package.json` present in the current directory -- **cargo** – The `cargo` package version is extracted from the `Cargo.toml` present in the current directory -- **poetry** – The `poetry` package version is extracted from the `pyproject.toml` present in the current directory -- **composer** – The `composer` package version is extracted from the `composer.json` present in the current directory +- **npm** —— `npm` 软件包版本从当前目录下的 `package.json` 中得到 +- **cargo** —— `cargo` 软件包的版本从当前目录下的 `Cargo.toml` 中得到 +- **poetry** —— `poetry` 软件包版本从当前目录下的 `pyproject.toml` 中得到 +- **composer** —— `composer` 软件包版本从当前目录下的 `composer.json` 中得到 - **gradle** – The `gradle` package version is extracted from the `build.gradle` present - **julia** - The package version is extracted from the `Project.toml` present - **mix** - The `mix` package version is extracted from the `mix.exs` present @@ -1804,13 +1804,13 @@ The `package` module is shown when the current directory is the repository for a ### 配置项 -| Option | 默认值 | 描述 | -| ----------------- | ---------------------------------- | ---------------------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | 组件格式化模板。 | -| `symbol` | `"📦 "` | The symbol used before displaying the version the package. | -| `style` | `"bold 208"` | 此组件的样式。 | -| `display_private` | `false` | Enable displaying version for packages marked as private. | -| `disabled` | `false` | Disables the `package` module. | +| Option | 默认值 | 描述 | +| ----------------- | --------------------------------- | --------------------------------------------------------- | +| `format` | `"is [$symbol$version]($style) "` | 组件格式化模板。 | +| `symbol` | `"📦 "` | 这个字段的内容会显示在当前软件包版本之前。 | +| `style` | `"bold 208"` | 此组件的样式。 | +| `display_private` | `false` | Enable displaying version for packages marked as private. | +| `disabled` | `false` | 禁用 `package` 组件。 | ### Variables @@ -1869,20 +1869,20 @@ format = "via [🦪 $version]($style) " ## PHP -The `php` module shows the currently installed version of PHP. 此组件将在符合以下任意条件之一时显示： +`php` 组件显示当前安装的 PHP 版本。 此组件将在符合以下任意条件之一时显示： -- The current directory contains a `composer.json` file +- 当前目录包含一个 `composer.json` 文件 - The current directory contains a `.php-version` file -- The current directory contains a `.php` file +- 当前目录包含一个 `.php` 文件 ### 配置项 -| Option | 默认值 | 描述 | -| ---------- | ---------------------------------- | ----------------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | 组件格式化模板。 | -| `symbol` | `"🐘 "` | The symbol used before displaying the version of PHP. | -| `style` | `"147 bold"` | 此组件的样式。 | -| `disabled` | `false` | Disables the `php` module. | +| Option | 默认值 | 描述 | +| ---------- | ---------------------------------- | ----------------------- | +| `format` | `"via [$symbol$version]($style) "` | 组件格式化模板。 | +| `symbol` | `"🐘 "` | 这个字段的内容会显示在当前 PHP 版本之前。 | +| `style` | `"147 bold"` | 此组件的样式。 | +| `disabled` | `false` | 禁用 `php` 组件。 | ### Variables @@ -1940,34 +1940,34 @@ format = "via [$symbol$version](bold white)" ## Python -The `python` module shows the currently installed version of Python and the current Python virtual environment if one is activated. +`python` 组件组件展示已经安装了的Python版本以及如果虚拟环境被激活则会显示当前Python虚拟环境 -If `pyenv_version_name` is set to `true`, it will display the pyenv version name. Otherwise, it will display the version number from `python --version`. +如果`pyenv_version_name`被设置为`true`, 本组件将会展示pyenv版本名。 否则则显示通过`python --version`获得的版本号 此组件将在符合以下任意条件之一时显示： -- The current directory contains a `.python-version` file -- The current directory contains a `requirements.txt` file -- The current directory contains a `pyproject.toml` file -- The current directory contains a file with the `.py` extension (and `scan_for_pyfiles` is true) -- The current directory contains a `Pipfile` file -- The current directory contains a `tox.ini` file -- The current directory contains a `setup.py` file -- The current directory contains a `__init__.py` file -- A virtual environment is currently activated +- 当前目录包含 `.python-version` 文件 +- 当前目录包含 `requirements.txt` 文件 +- 当前目录包含 `pyproject.toml` 文件 +- 当前目录包含一个扩展名名为`.py`的文件(以及`scan_for_pyfile`为true) +- 当前目录包含 `Pipfile` 文件 +- 当前目录包含一个 `tox.ini` 文件 +- 当前目录包含一个 `setup.py` 文件 +- 当前目录包含一个名为`__init__.py`的文件 +- 当前处于一个活跃的 python 虚拟环境中 ### 配置项 | Option | 默认值 | 描述 | | -------------------- | ------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | | `format` | `'via [${symbol}${pyenv_prefix}${version}( \($virtualenv\))]($style) '` | 组件格式化模板。 | -| `symbol` | `"🐍 "` | A format string representing the symbol of Python | +| `symbol` | `"🐍 "` | 用于表示Python的格式化字符串。 | | `style` | `"yellow bold"` | 此组件的样式。 | -| `pyenv_version_name` | `false` | Use pyenv to get Python version | +| `pyenv_version_name` | `false` | 使用 pyenv 获取 Python 版本 | | `pyenv_prefix` | `pyenv` | Prefix before pyenv version display, only used if pyenv is used | -| `scan_for_pyfiles` | `true` | If false, Python files in the current directory will not show this module. | +| `scan_for_pyfiles` | `true` | 如果设置为false, 在本目录下的Python文件将不会在本组件中显示。 | | `python_binary` | `["python", "python3, "python2"]` | Configures the python binaries that Starship should executes when getting the version. | -| `disabled` | `false` | Disables the `python` module. | +| `disabled` | `false` | 禁用 `python` 组件。 | ::: tip @@ -1981,11 +1981,11 @@ The default values and order for `python_binary` was chosen to first identify th | 字段 | 示例 | 描述 | | ------------ | --------------- | ------------------------------------------ | -| version | `"v3.8.1"` | The version of `python` | +| version | `"v3.8.1"` | `python`版本 | | symbol | `"🐍 "` | `symbol`对应值 | | style | `"yellow bold"` | `style`对应值 | | pyenv_prefix | `"pyenv "` | Mirrors the value of option `pyenv_prefix` | -| virtualenv | `"venv"` | The current `virtualenv` name | +| virtualenv | `"venv"` | 当前`virtualenv`名称 | ### 示例 @@ -2008,11 +2008,11 @@ python_binary = "python3" ## Ruby -The `ruby` module shows the currently installed version of Ruby. 此组件将在符合以下任意条件之一时显示： +`ruby` 组件显示当前安装的 Ruby 版本。 此组件将在符合以下任意条件之一时显示： -- The current directory contains a `Gemfile` file +- 当前目录包含 `Gemfile` 文件 - The current directory contains a `.ruby-version` file -- The current directory contains a `.rb` file +- 当前目录包含 `.rb` 文件 ### 配置项 @@ -2021,7 +2021,7 @@ The `ruby` module shows the currently installed version of Ruby. 此组件将在 | `format` | `"via [$symbol$version]($style) "` | 组件格式化模板。 | | `symbol` | `"💎 "` | A format string representing the symbol of Ruby. | | `style` | `"bold red"` | 此组件的样式。 | -| `disabled` | `false` | Disables the `ruby` module. | +| `disabled` | `false` | 禁用 `ruby` 组件。 | ### Variables @@ -2044,10 +2044,10 @@ symbol = "🔺 " ## Rust -The `rust` module shows the currently installed version of Rust. 此组件将在符合以下任意条件之一时显示： +`rust` 组件显示当前安装的 Rust 版本。 此组件将在符合以下任意条件之一时显示： -- The current directory contains a `Cargo.toml` file -- The current directory contains a file with the `.rs` extension +- 当前目录包含 `Cargo.toml` 文件 +- 当前目录包含一个使用 `.rs` 扩展名的文件 ### 配置项 @@ -2056,7 +2056,7 @@ The `rust` module shows the currently installed version of Rust. 此组件将在 | `format` | `"via [$symbol$version]($style) "` | 组件格式化模板。 | | `symbol` | `"🦀 "` | A format string representing the symbol of Rust | | `style` | `"bold red"` | 此组件的样式。 | -| `disabled` | `false` | Disables the `rust` module. | +| `disabled` | `false` | 禁用 `rust` 组件。 | ### Variables @@ -2151,7 +2151,9 @@ The `status` module displays the exit code of the previous command. The module w ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. ::: +此组件默认被禁用。 若要启用此组件，请在配置文件中设置 `disable` 字段为 `false`。 + +::: ### 配置项 @@ -2237,7 +2239,7 @@ format = "via [🏎 $version](red bold)" The `terraform` module shows the currently selected terraform workspace and version. By default the terraform version is not shown, since this is slow on current versions of terraform when a lot of plugins are in use. If you still want to enable it, [follow the example shown below](#with-version). 此组件将在符合以下任意条件之一时显示： -- The current directory contains a `.terraform` folder +- 当前目录包含 `.terraform` 目录 - Current directory contains a file with the `.tf` or `.hcl` extensions ### 配置项 @@ -2247,7 +2249,7 @@ The `terraform` module shows the currently selected terraform workspace and vers | `format` | `"via [$symbol$workspace]($style) "` | The format string for the module. | | `symbol` | `"💠 "` | A format string shown before the terraform workspace. | | `style` | `"bold 105"` | 此组件的样式。 | -| `disabled` | `false` | Disables the `terraform` module. | +| `disabled` | `false` | 禁用 `terraform` 组件。 | ### Variables @@ -2286,21 +2288,21 @@ The `time` module shows the current **local** time. The `format` configuration v ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. +此组件默认被禁用。 若要启用此组件，请在配置文件中设置 `disable` 字段为 `false`。 ::: ### 配置项 -| Option | 默认值 | 描述 | -| ----------------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | -| `format` | `"at [$time]($style) "` | The format string for the module. | -| `use_12hr` | `false` | Enables 12 hour formatting | -| `time_format` | see below | The [chrono format string](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) used to format the time. | -| `style` | `"bold yellow"` | The style for the module time | -| `utc_time_offset` | `"local"` | Sets the UTC offset to use. Range from -24 < x < 24. Allows floats to accommodate 30/45 minute timezone offsets. | -| `disabled` | `true` | Disables the `time` module. | -| `time_range` | `"-"` | Sets the time range during which the module will be shown. Times must be specified in 24-hours format | +| Option | 默认值 | 描述 | +| ----------------- | ----------------------- | ----------------------------------------------------------------------------------------------------- | +| `format` | `"at [$time]($style) "` | The format string for the module. | +| `use_12hr` | `false` | 启用 12 小时格式 | +| `time_format` | 见下文解释 | 用来格式化时间显示的 [chrono 格式字符串](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) | +| `style` | `"bold yellow"` | 显示时间的样式。 | +| `utc_time_offset` | `"local"` | 设置所用 UTC 偏移量。 Range from -24 < x < 24. 允许使用浮点数来得到 30/45 分钟的时区偏移。 | +| `disabled` | `true` | 禁用 `time` 组件。 | +| `time_range` | `"-"` | Sets the time range during which the module will be shown. Times must be specified in 24-hours format | If `use_12hr` is `true`, then `time_format` defaults to `"%r"`. Otherwise, it defaults to `"%T"`. Manually setting `time_format` will override the `use_12hr` setting. @@ -2330,22 +2332,26 @@ time_range = "10:00:00-14:00:00" The `username` module shows active user's username. 此组件将在符合以下任意条件之一时显示： -- The current user is root -- The current user isn't the same as the one that is logged in -- The user is currently connected as an SSH session -- The variable `show_always` is set to true +- 当前用户是 root +- 当前用户与登录用户不相同 +- 用户正通过 SSH 会话连接访问 +- 字段 `show_always` 被设置为 true -::: tip SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. ::: +::: tip + +SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. + +::: ### 配置项 -| Option | 默认值 | 描述 | -| ------------- | ----------------------- | ------------------------------------- | -| `style_root` | `"bold red"` | The style used when the user is root. | -| `style_user` | `"bold yellow"` | The style used for non-root users. | -| `format` | `"[$user]($style) in "` | 组件格式化模板。 | -| `show_always` | `false` | Always shows the `username` module. | -| `disabled` | `false` | Disables the `username` module. | +| Option | 默认值 | 描述 | +| ------------- | ----------------------- | ------------------- | +| `style_root` | `"bold red"` | 当前用户为 root 时使用的样式。 | +| `style_user` | `"bold yellow"` | 非 root 用户使用的样式。 | +| `format` | `"[$user]($style) in "` | 组件格式化模板。 | +| `show_always` | `false` | 总是显示 `username` 组件。 | +| `disabled` | `false` | 禁用 `username` 组件。 | ### Variables @@ -2437,7 +2443,7 @@ The order in which custom modules are shown can be individually set by including | `command` | | The command whose output should be printed. The command will be passed on stdin to the shell. | | `when` | | A shell command used as a condition to show the module. The module will be shown if the command returns a `0` status code. | | `shell` | | [See below](#custom-command-shell) | -| `description` | `""` | The description of the module that is shown when running `starship explain`. | +| `描述` | `""` | The description of the module that is shown when running `starship explain`. | | `files` | `[]` | The files that will be searched in the working directory for a match. | | `directories` | `[]` | The directories that will be searched in the working directory for a match. | | `extensions` | `[]` | The extensions that will be searched in the working directory for a match. | diff --git a/docs/zh-CN/guide/README.md b/docs/zh-CN/guide/README.md index 50aeef8f..93e59357 100644 --- a/docs/zh-CN/guide/README.md +++ b/docs/zh-CN/guide/README.md @@ -125,6 +125,8 @@ ### 开始安装 +**Note**: due to the proliferation of different platforms, only a subset of supported platforms are shown below. Can't see yours? Have a look at the [extra platform instructions](https://starship.rs/installing/). + 1. 安装 **starship** 二进制文件： @@ -138,17 +140,10 @@ ``` - ##### 直接从 [crates.io](https://crates.io/) 获取源代码编译： - - ```sh - cargo install starship - ``` - - #### 通过软件包管理器安装 - ##### 使用 [Homebrew](https://brew.sh/) + ##### Example: [Homebrew](https://brew.sh/): ```sh brew install starship @@ -161,7 +156,7 @@ scoop install starship ``` -1. 将初始化脚本添加到您的 shell 的配置文件： +2. 将初始化脚本添加到您的 shell 的配置文件： #### Bash @@ -218,7 +213,7 @@ ## 🤝 贡献 -我们一直在寻找贡献者！你都可以参与贡献 **不论你的技能如何**。 如果您希望快速为项目作出贡献，请尝试解决 [good first issue](https://github.com/starship/starship/labels/🌱%20good%20first%20issue)。 +我们一直在寻找贡献者！你都可以参与贡献 ** 不论你的技能如何 **。 如果您希望快速为项目作出贡献，请尝试解决 [good first issue](https://github.com/starship/starship/labels/🌱%20good%20first%20issue)。 If you are fluent in a non-English language, we greatly appreciate any help keeping our docs translated and up-to-date in other languages. If you would like to help, translations can be contributed on the [Starship Crowdin](https://translate.starship.rs/). diff --git a/docs/zh-CN/installing/README.md b/docs/zh-CN/installing/README.md new file mode 100644 index 00000000..6f0ea0d6 --- /dev/null +++ b/docs/zh-CN/installing/README.md @@ -0,0 +1,46 @@ +# 🚀 Advanced Installation + +To install starship, you need to do two things: + +1. Get the **starship** binary onto your computer +1. Tell your shell to use the starship binary as its prompt by modifying its init scripts + +For most users, the instructions on [the main page](/guide/#🚀-installation) will work great. However, for some more specialized platforms, different instructions are needed. + +There are so many platforms out there that they didn't fit into the main README.md file, so here are some installation instructions for other platforms from the community. Is yours not here? Please do add it here if you figure it out! + +## [Nix](https://nixos.wiki/wiki/Nix) + +### Getting the Binary + +#### Imperatively + +```sh +nix-env -iA nixos.starship +``` + +#### Declarative, single user, via [home-manager](home-manager) + +Add `pkgs.starship` to your `home.packages` in your `home.nix` file, then run + +```sh +home-manager switch +``` + +#### Declarative, system-wide, with NixOS + +Add `pkgs.starship` to `environment.packages` in your `configuration.nix`, then run + +```sh +sudo nixos-rebuild switch +``` + +### Modifying Init Scripts + +#### With Nix and home-manager, using zsh: + +Add the following to `programs.zsh.initExtra` in your `home.nix` file, then run + +```sh +home-manager switch +``` diff --git a/docs/zh-TW/advanced-config/README.md b/docs/zh-TW/advanced-config/README.md index 15b1c4c7..6d0cd28a 100644 --- a/docs/zh-TW/advanced-config/README.md +++ b/docs/zh-TW/advanced-config/README.md @@ -82,7 +82,7 @@ starship_precmd_user_func="set_win_title" 其中 `` 是指定顏色用的（下面解釋）。 `fg:` 與 `` 目前做一樣的事情，不過未來可能會改變。 單詞在字串中的順序不重要。 -The `none` token overrides all other tokens in a string if it is not part of a `bg:` specifier, so that e.g. `fg:red none fg:blue` will still create a string with no styling. `bg:none` sets the background to the default color so `fg:red bg:none` is equivalent to `red` or `fg:red` and `bg:green fg:red bg:none` is also equivalent to `fg:red` or `red`. It may become an error to use `none` in conjunction with other tokens in the future. +The `none` token overrides all other tokens in a string if it is not part of a `bg:` specifier, so that e.g. `fg:red none fg:blue` will still create a string with no styling. `bg:none` sets the background to the default color so `fg:red bg:none` is equivalent to `red` or `fg:red` and `bg:green fg:red bg:none` is also equivalent to `fg:red` or `red`. 未來可能會將 `none` 與其他符號一起使用的情形視為是一種錯誤。 一個顏色指定符號可以是下列其中之一： diff --git a/docs/zh-TW/config/README.md b/docs/zh-TW/config/README.md index 90026bd7..16faaf5e 100644 --- a/docs/zh-TW/config/README.md +++ b/docs/zh-TW/config/README.md @@ -303,16 +303,16 @@ symbol = "🅰 " ### 選項 -| Option | 預設 | 說明 | -| -------------------- | --------------------------------- | --------------------------------------------------- | -| `full_symbol` | `""` | 當電池充飽時顯示的符號。 | -| `charging_symbol` | `""` | 當電池正在充電時顯示的符號。 | -| `discharging_symbol` | `""` | 當電池正在放電時顯示的符號。 | -| `unknown_symbol` | `""` | The symbol shown when the battery state is unknown. | -| `empty_symbol` | `""` | The symbol shown when the battery state is empty. | -| `format` | `"[$symbol$percentage]($style) "` | The format for the module. | -| `display` | [連結](#battery-display) | Display threshold and style for the module. | -| `disabled` | `false` | Disables the `battery` module. | +| Option | 預設 | 說明 | +| -------------------- | --------------------------------- | -------------------------- | +| `full_symbol` | `""` | 當電池充飽時顯示的符號。 | +| `charging_symbol` | `""` | 當電池正在充電時顯示的符號。 | +| `discharging_symbol` | `""` | 當電池正在放電時顯示的符號。 | +| `unknown_symbol` | `""` | 當電池狀態不明時顯示的符號。 | +| `empty_symbol` | `""` | 當電池沒電時顯示的符號。 | +| `format` | `"[$symbol$percentage]($style) "` | The format for the module. | +| `display` | [連結](#battery-display) | 顯示的門檻與模組的風格。 | +| `disabled` | `false` | 停用 `battery` 模組。 | ### 範例 @@ -328,7 +328,7 @@ discharging_symbol = "💀" ### 電池顯示 -The `display` configuration option is used to define when the battery indicator should be shown (threshold) and what it looks like (style). If no `display` is provided. 預設如下： +`display` 設定是用來定義甚麼時候電池指示會顯示出來 (threshold)，以及它長甚麼樣子 (style)。 如果沒有提供 `display`。 預設如下： ```toml [[battery.display]] @@ -338,12 +338,12 @@ style = "bold red" #### 選項 -The `display` option is an array of the following table. +`display` 選項是一個下列表格的陣列。 -| Option | 說明 | -| ----------- | ----------------------------------------------- | -| `threshold` | The upper bound for the display option. | -| `style` | The style used if the display option is in use. | +| Option | 說明 | +| ----------- | ----------- | +| `threshold` | 顯示選項的上界。 | +| `style` | 顯示選項使用時的風格。 | #### 範例 @@ -362,9 +362,9 @@ style = "bold yellow" ## 字元 -The `character` module shows a character (usually an arrow) beside where the text is entered in your terminal. +`character` 模組在你的文字輸入處旁顯示一個字元 (通常是箭頭)。 -The character will tell you whether the last command was successful or not. It can do this in two ways: +這個字元會告訴你最後的指令是成功還是失敗。 It can do this in two ways: - changing color (`red`/`green`) - changing shape (`❯`/`✖`) @@ -379,7 +379,7 @@ By default it only changes color. If you also want to change it's shape take a l | `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. | | `vicmd_symbol` | `"[❮](bold green)"` | The format string used before the text input if the shell is in vim normal mode. | -| `disabled` | `false` | Disables the `character` module. | +| `disabled` | `false` | 停用 `character` 模組。 | ### Variables @@ -446,27 +446,27 @@ The `cmake` module shows the currently installed version of CMake if any of the ## 指令持續時間 -The `cmd_duration` module shows how long the last command took to execute. The module will be shown only if the command took longer than two seconds, or the `min_time` config value, if it exists. +`cmd_duration` 模組顯示最後一個指令執行所花費的時間。 這個模組只會在指令花費超過兩秒或是有設定 `min_time` 時，超過設定值時出現。 -::: warning Do not hook the DEBUG trap in Bash +::: warning 不要在 Bash 中設置 DEBUG trap -If you are running Starship in `bash`, do not hook the `DEBUG` trap after running `eval $(starship init $0)`, or this module **will** break. +如果你在 `bash` 中使用 Starship，不要在執行 `eval $(starship init $0)` 之後設置 `DEBUG` trap，不然這個模組**會**壞掉。 ::: -Bash users who need preexec-like functionality can use [rcaloras's bash_preexec framework](https://github.com/rcaloras/bash-preexec). Simply define the arrays `preexec_functions` and `precmd_functions` before running `eval $(starship init $0)`, and then proceed as normal. +想使用類似 preexec 功能的 Bash 使用者可以 [rcaloras 的 bash_preexec 框架](https://github.com/rcaloras/bash-preexec)。 只要在 `eval $(starship init $0)` 之前簡單地定義 `preexec_functions` 與 `precmd_functions` 兩個陣列，然後就可以照常進行。 ### 選項 -| Option | 預設 | 說明 | -| -------------------- | ----------------------------- | ---------------------------------------------------------- | -| `min_time` | `2_000` | Shortest duration to show time for (in milliseconds). | -| `show_milliseconds` | `false` | Show milliseconds in addition to seconds for the duration. | -| `format` | `"took [$duration]($style) "` | The format for the module. | -| `style` | `"bold yellow"` | 這個模組的風格。 | -| `disabled` | `false` | Disables the `cmd_duration` module. | -| `show_notifications` | `false` | Show desktop notifications when command completes. | -| `min_time_to_notify` | `45_000` | Shortest duration for notification (in milliseconds). | +| Option | 預設 | 說明 | +| -------------------- | ----------------------------- | ----------------------------------------------------- | +| `min_time` | `2_000` | Shortest duration to show time for (in milliseconds). | +| `show_milliseconds` | `false` | 顯示時間除了以秒為單位外，亦以毫秒顯示 | +| `format` | `"took [$duration]($style) "` | The format for the module. | +| `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). | ::: tip @@ -495,7 +495,7 @@ format = "underwent [$duration](bold yellow)" ## Conda -The `conda` module shows the current conda environment, if `$CONDA_DEFAULT_ENV` is set. +如果有設定 `$CONDA_DEFAULT_ENV` 時，`conda` 模組顯示現在 conda 的環境。 ::: tip @@ -505,14 +505,14 @@ This does not suppress conda's own prompt modifier, you may want to run `conda c ### 選項 -| Option | 預設 | 說明 | -| ------------------- | -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `truncation_length` | `1` | The number of directories the environment path should be truncated to, if the environment was created via `conda create -p [path]`. `0` means no truncation. Also see the [`directory`](#directory) module. | -| `symbol` | `"🅒 "` | The symbol used before the environment name. | -| `style` | `"bold green"` | 這個模組的風格。 | -| `format` | `"via [$symbol$environment]($style) "` | The format for the module. | -| `ignore_base` | `true` | Ignores `base` environment when activated. | -| `disabled` | `false` | Disables the `conda` module. | +| Option | 預設 | 說明 | +| ------------------- | -------------------------------------- | ----------------------------------------------------------------------------------------------- | +| `truncation_length` | `1` | 如果環境變數由所`conda create -p [path]`產生時，環境變數的資料夾需要截斷的數目。 `0` 表示不截斷 也請參考 [`directory`](#directory)模組 | +| `symbol` | `"🅒 "` | 環境名稱前使用的符號。 | +| `style` | `"bold green"` | 這個模組的風格。 | +| `format` | `"via [$symbol$environment]($style) "` | The format for the module. | +| `ignore_base` | `true` | Ignores `base` environment when activated. | +| `disabled` | `false` | 停用 `conda` 模組。 | ### Variables @@ -535,7 +535,7 @@ format = "[$symbol$environment](dimmed green) " ## Crystal -The `crystal` module shows the currently installed version of Crystal. 這個模組在下列其中一個條件達成時顯示： +`crystal` 模組顯示現在所安裝的Crystal版本 這個模組在下列其中一個條件達成時顯示： - 現在資料夾中含有一個 `shard.yml` 檔案 - 現在資料夾中含有一個`.cr`檔案 @@ -606,33 +606,33 @@ format = "via [🔰 $version](bold red) " ## 資料夾 -The `directory` module shows the path to your current directory, truncated to three parent folders. Your directory will also be truncated to the root of the git repo that you're currently in. +`directory` 模組顯示到現在資料夾的路徑，並裁減到前三層資料夾。 你的資料夾也會被裁減到你所在的 git 儲存庫的根目錄。 -When using the fish style pwd 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 風格的 pwd 選項，將不會隱藏被裁減的資料夾，而是會根據你在選項中設定的數字看到每一層資料夾的縮寫。 -For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, and the option set to `1`. You will now see `~/D/N/nixpkgs/pkgs`, whereas before it would have been `nixpkgs/pkgs`. +例如，給定一個右列的路徑 `~/Dev/Nix/nixpkgs/pkgs` 其中 `nixpkgs` 是儲存庫的根目錄，而且該選項被設定為 `1`。 你會看到 `~/D/N/nixpkgs/pkgs`，而在這個設定之前則是 `nixpkgs/pkgs`。 ### 選項 -| Option | 預設 | 說明 | -| ------------------- | -------------------------------------------------- | -------------------------------------------------------------------------------- | -| `truncation_length` | `3` | The number of parent folders that the current directory should be truncated to. | -| `truncate_to_repo` | `true` | Whether or not to truncate to the root of the git repo that you're currently in. | -| `format` | `"[$path]($style)[$read_only]($read_only_style) "` | The format for the module. | -| `style` | `"bold cyan"` | 這個模組的風格。 | -| `disabled` | `false` | Disables the `directory` module. | -| `read_only` | `"🔒"` | The symbol indicating current directory is read only. | -| `read_only_style` | `"red"` | The style for the read only symbol. | -| `truncation_symbol` | `""` | The symbol to prefix to truncated paths. eg: "…/" | +| Option | 預設 | 說明 | +| ------------------- | -------------------------------------------------- | ----------------------------------------------------- | +| `truncation_length` | `3` | 到達現在資料夾的路徑中，要被裁減掉的資料夾數目。 | +| `truncate_to_repo` | `true` | 是否要裁減到你現在所在的 git 儲存庫的根目錄。 | +| `format` | `"[$path]($style)[$read_only]($read_only_style) "` | The format for the module. | +| `style` | `"bold cyan"` | 這個模組的風格。 | +| `disabled` | `false` | 停用 `directory` 模組。 | +| `read_only` | `"🔒"` | The symbol indicating current directory is read only. | +| `read_only_style` | `"red"` | The style for the read only symbol. | +| `truncation_symbol` | `""` | The symbol to prefix to truncated paths. eg: "…/" |
-This module has a few advanced configuration options that control how the directory is displayed. +這個模組有些進階設定選項可以控制顯示資料夾。 -| Advanced Option | 預設 | 說明 | -| --------------------------- | ------ | ---------------------------------------------------------------------------------------- | -| `substitutions` | | A table of substitutions to be made to the path. | -| `fish_style_pwd_dir_length` | `0` | The number of characters to use when applying fish shell pwd path logic. | -| `use_logical_path` | `true` | Displays the logical path provided by the shell (`PWD`) instead of the path from the OS. | +| Advanced Option | 預設 | 說明 | +| --------------------------- | ------ | ------------------------------------------------ | +| `substitutions` | | A table of substitutions to be made to the path. | +| `fish_style_pwd_dir_length` | `0` | 當使用 fish shell 的 pwd 路徑邏輯時使用的字元數量。 | +| `use_logical_path` | `true` | 顯示 shell (`PWD`) 提供的邏輯路徑，而不是 OS 的路徑。 | `substitutions` allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories (i.e. Java). Note that this will disable the fish style PWD. @@ -700,7 +700,7 @@ format = "via [🐋 $context](blue bold)" ## Dotnet -The `dotnet` module shows the relevant version of the .NET Core SDK for the current directory. If the SDK has been pinned in the current directory, the pinned version is shown. Otherwise the module shows the latest installed version of the SDK. +`dotnet` 模組顯示現在資料夾使用的 .NET Core SDK 的版本。 如果這個資料夾已經選定一個 SDK，則顯示這個 SDK 的版本。 如果沒有的話，則顯示最新安裝的 SDK 版本。 This module will only be shown in your prompt when one or more of the following files are present in the current directory: @@ -716,19 +716,19 @@ This module will only be shown in your prompt when one or more of the following You'll also need the .NET Core SDK installed in order to use it correctly. -Internally, this module uses its own mechanism for version detection. Typically it is twice as fast as running `dotnet --version`, but it may show an incorrect version if your .NET project has an unusual directory layout. If accuracy is more important than speed, you can disable the mechanism by setting `heuristic = false` in the module options. +這個模組內部是使用它自己的機制來偵測版本。 一般來說這個模組有 `dotnet --version` 的兩倍快，但是它可能會在你的 .NET 專案有不尋常的資料夾結構時顯示不正確的版本。 如果精確度比速度更重要的話，你可以藉由設定模組中的 `heuristic = false` 選項來停用這個功能。 The module will also show the Target Framework Moniker () when there is a csproj file in the current directory. ### 選項 -| Option | 預設 | 說明 | -| ----------- | --------------------------------------- | -------------------------------------------------------- | -| `format` | `"[$symbol$version( 🎯 $tfm)]($style) "` | The format for the module. | -| `symbol` | `"•NET "` | The symbol used before displaying the version of dotnet. | -| `heuristic` | `true` | Use faster version detection to keep starship snappy. | -| `style` | `"bold blue"` | 這個模組的風格。 | -| `disabled` | `false` | Disables the `dotnet` module. | +| Option | 預設 | 說明 | +| ----------- | --------------------------------------- | ---------------------------- | +| `format` | `"[$symbol$version( 🎯 $tfm)]($style) "` | The format for the module. | +| `symbol` | `"•NET "` | 在顯示 dotnet 版本之前用的符號。 | +| `heuristic` | `true` | 使用更快速的版本偵測法來保持 starship 的速度。 | +| `style` | `"bold blue"` | 這個模組的風格。 | +| `disabled` | `false` | 停用 `dotnet` 模組。 | ### Variables @@ -827,20 +827,20 @@ format = "via [ $version](cyan bold) " ## 環境變數 -The `env_var` module displays the current value of a selected environment variable. The module will be shown only if any of the following conditions are met: +`env_var`模組顯示一個選擇的環境變數的現在數值。 這個模組只在下列條件其中之一達到時顯示： - `variable` 設定選項符合一個存在的環境變數。 - 沒有設定 `variable` 選項，但是有設定 `default` 選項。 ### 選項 -| Option | 預設 | 說明 | -| ---------- | ------------------------------ | ---------------------------------------------------------------------------- | -| `symbol` | | The symbol used before displaying the variable value. | -| `variable` | | The environment variable to be displayed. | -| `default` | | The default value to be displayed when the selected variable is not defined. | -| `format` | `"with [$env_value]($style) "` | The format for the module. | -| `disabled` | `false` | Disables the `env_var` module. | +| Option | 預設 | 說明 | +| ---------- | ------------------------------ | -------------------------- | +| `symbol` | | 顯示在變數數值之前的符號。 | +| `variable` | | 要顯示的環境變數。 | +| `default` | | 在選擇的變數值沒有定義時，顯示的預設值。 | +| `format` | `"with [$env_value]($style) "` | The format for the module. | +| `disabled` | `false` | 停用 `env_var` 模組。 | ### Variables @@ -959,20 +959,20 @@ asia-northeast1 = "an1" ## Git 分支 -The `git_branch` module shows the active branch of the repo in your current directory. +`git_branch` 模組顯示現在的資料夾中使用中的儲存庫的分支。 ### 選項 -| Option | 預設 | 說明 | -| -------------------- | -------------------------------- | ---------------------------------------------------------------------------------------- | -| `always_show_remote` | `false` | Shows the remote tracking branch name, even if it is equal to the local branch name. | -| `format` | `"on [$symbol$branch]($style) "` | The format for the module. Use `"$branch"` to refer to the current branch name. | -| `symbol` | `" "` | A format string representing the symbol of git branch. | -| `style` | `"bold purple"` | 這個模組的風格。 | -| `truncation_length` | `2^63 - 1` | Truncates a git branch to X graphemes. | -| `truncation_symbol` | `"…"` | The symbol used to indicate a branch name was truncated. You can use `""` for no symbol. | -| `only_attached` | `false` | Only show the branch name when not in a detached HEAD state. | -| `disabled` | `false` | Disables the `git_branch` module. | +| Option | 預設 | 說明 | +| -------------------- | -------------------------------- | ------------------------------------------------------------------------------------ | +| `always_show_remote` | `false` | Shows the remote tracking branch name, even if it is equal to the local branch name. | +| `format` | `"on [$symbol$branch]($style) "` | The format for the module. Use `"$branch"` to refer to the current branch name. | +| `symbol` | `" "` | A format string representing the symbol of git branch. | +| `style` | `"bold purple"` | 這個模組的風格。 | +| `truncation_length` | `2^63 - 1` | Truncates a git branch to X graphemes. | +| `truncation_symbol` | `"…"` | 用來指示分支名稱被縮減的符號。 You can use `""` for no symbol. | +| `only_attached` | `false` | Only show the branch name when not in a detached HEAD state. | +| `disabled` | `false` | 停用 `git_branch` 模組。 | ### Variables @@ -1034,7 +1034,7 @@ tag_symbol = "🔖 " ## Git State -The `git_state` module will show in directories which are part of a git repository, and where there is an operation in progress, such as: _REBASING_, _BISECTING_, etc. If there is progress information (e.g., REBASING 3/10), that information will be shown too. +`git_state` 模組會顯示在 git 儲存庫中的資料夾內，以及會在有作業正在進行時顯示，像是：_REBASING_、_BISECTING_ 等等。 如果有進展的資訊 (像是 REBASING 3/10)，也會一併顯示出來。 ### 選項 @@ -1049,7 +1049,7 @@ The `git_state` module will show in directories which are part of a git reposito | `am_or_rebase` | `"AM/REBASE"` | A format string displayed when an ambiguous `apply-mailbox` or `rebase` is in progress. | | `style` | `"bold yellow"` | 這個模組的風格。 | | `format` | `'\([$state( $progress_current/$progress_total)]($style)\) '` | The format for the module. | -| `disabled` | `false` | Disables the `git_state` module. | +| `disabled` | `false` | 停用 `git_state` 模組。 | ### Variables @@ -1074,14 +1074,14 @@ cherry_pick = "[🍒 PICKING](bold red)" ## Git Status -The `git_status` module shows symbols representing the state of the repo in your current directory. +`git_status` 模組顯示用來表示現在資料夾之中儲存庫狀態的符號。 ### 選項 | Option | 預設 | 說明 | | ------------ | ----------------------------------------------- | ----------------------------------- | | `format` | `'([\[$all_status$ahead_behind\]]($style) )'` | The default format for `git_status` | -| `conflicted` | `"="` | This branch has merge conflicts. | +| `conflicted` | `"="` | 這個分支有合併衝突。 | | `ahead` | `"⇡"` | The format of `ahead` | | `behind` | `"⇣"` | The format of `behind` | | `diverged` | `"⇕"` | The format of `diverged` | @@ -1092,7 +1092,7 @@ The `git_status` module shows symbols representing the state of the repo in your | `renamed` | `"»"` | The format of `renamed` | | `deleted` | `"✘"` | The format of `deleted` | | `style` | `"bold red"` | 這個模組的風格。 | -| `disabled` | `false` | Disables the `git_status` module. | +| `disabled` | `false` | 停用 `git_status` 模組。 | ### Variables @@ -1157,7 +1157,7 @@ behind = "⇣${count}" ## Golang -The `golang` module shows the currently installed version of Golang. 這個模組在下列其中一個條件達成時顯示： +`golang` 模組顯示現在安裝的 Golang 版本。 這個模組在下列其中一個條件達成時顯示： - 現在資料夾中含有一個 `go.mod` 檔案 - 現在資料夾中含有一個 `go.sum` 檔案 @@ -1175,7 +1175,7 @@ The `golang` module shows the currently installed version of Golang. 這個模 | `format` | `"via [$symbol$version]($style) "` | The format for the module. | | `symbol` | `"🐹 "` | A format string representing the symbol of Go. | | `style` | `"bold cyan"` | 這個模組的風格。 | -| `disabled` | `false` | Disables the `golang` module. | +| `disabled` | `false` | 停用 `golang` 模組。 | ### Variables @@ -1233,17 +1233,17 @@ format = "via [⎈ $version](bold white) " ## 主機名稱 -The `hostname` module shows the system hostname. +`hostname` 模組顯示系統的主機名稱。 ### 選項 -| Option | 預設 | 說明 | -| ---------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | -| `ssh_only` | `true` | Only show hostname when connected to an SSH session. | -| `trim_at` | `"."` | String that the hostname is cut off at, after the first match. `"."` will stop after the first dot. `""` will disable any truncation | -| `format` | `"[$hostname]($style) in "` | The format for the module. | -| `style` | `"bold dimmed green"` | 這個模組的風格。 | -| `disabled` | `false` | Disables the `hostname` module. | +| Option | 預設 | 說明 | +| ---------- | --------------------------- | ---------------------------------------------------------- | +| `ssh_only` | `true` | 只在連接到一個 SSH session 時顯示主機名稱。 | +| `trim_at` | `"."` | 擷取出主機名稱的斷點，以第一個符合的為準。 `"."` 會讓它停在第一個點的符號。 `""` 會停用任何的截斷功能。 | +| `format` | `"[$hostname]($style) in "` | The format for the module. | +| `style` | `"bold dimmed green"` | 這個模組的風格。 | +| `disabled` | `false` | 停用 `hostname` 模組。 | ### Variables @@ -1268,7 +1268,7 @@ disabled = false ## Java -The `java` module shows the currently installed version of Java. 這個模組在下列其中一個條件達成時顯示： +`java` 模組顯示現在安裝的 Java 版本。 這個模組在下列其中一個條件達成時顯示： - The current directory contains a `pom.xml`, `build.gradle.kts`, `build.sbt`, `.java-version`, `.deps.edn`, `project.clj`, or `build.boot` file - The current directory contains a file with the `.java`, `.class`, `.gradle`, `.jar`, `.clj`, or `.cljc` extension @@ -1280,7 +1280,7 @@ The `java` module shows the currently installed version of Java. 這個模組在 | `format` | `"via [${symbol}${version}]($style) "` | The format for the module. | | `symbol` | `"☕ "` | A format string representing the symbol of Java | | `style` | `"red dimmed"` | 這個模組的風格。 | -| `disabled` | `false` | Disables the `java` module. | +| `disabled` | `false` | 停用 `java` 模組。 | ### Variables @@ -1303,17 +1303,17 @@ symbol = "🌟 " ## 工作 -The `jobs` module shows the current number of jobs running. The module will be shown only if there are background jobs running. The module will show the number of jobs running if there is more than 1 job, or more than the `threshold` config value, if it exists. +`jobs` 模組顯示現在正在執行中的工作。 這個模組只會在有背景工作正在執行時顯示。 這個模組會在工作數量超過一個，或者有設定 `threshold` 時且數量超過設定值時，顯示工作的數量。 ### 選項 | Option | 預設 | 說明 | | ----------- | ----------------------------- | ------------------------------------------------ | -| `threshold` | `1` | Show number of jobs if exceeded. | +| `threshold` | `1` | 在超過指定值時顯示工作數量。 | | `format` | `"[$symbol$number]($style) "` | The format for the module. | | `symbol` | `"✦"` | A format string representing the number of jobs. | | `style` | `"bold blue"` | 這個模組的風格。 | -| `disabled` | `false` | Disables the `jobs` module. | +| `disabled` | `false` | 停用 `jobs` 模組。 | ### Variables @@ -1420,7 +1420,7 @@ Displays the current Kubernetes context name and, if set, the namespace from the ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. +這個模組預設是停用的。 想要啟用它的話，請在設定檔中將 `disabled` 設定為 `false`。 ::: @@ -1457,15 +1457,15 @@ disabled = false "dev.local.cluster.k8s" = "dev" ``` -## Line Break +## 換行 -The `line_break` module separates the prompt into two lines. +`line_break` 模組將提示字元分成兩行。 ### 選項 -| Option | 預設 | 說明 | -| ---------- | ------- | ------------------------------------------------------------------ | -| `disabled` | `false` | Disables the `line_break` module, making the prompt a single line. | +| Option | 預設 | 說明 | +| ---------- | ------- | ----------------------------- | +| `disabled` | `false` | 停用 `line_break` 模組，讓提示字元變成一行。 | ### 範例 @@ -1513,27 +1513,27 @@ The `lua` module shows the currently installed version of Lua. 這個模組在 format = "via [🌕 $version](bold blue) " ``` -## Memory Usage +## 記憶體使用量 -The `memory_usage` module shows current system memory and swap usage. +`memory_usage` 模組顯示現在系統記憶體與 swap 的使用量。 -By default the swap usage is displayed if the total system swap is non-zero. +預設 swap 使用量會在系統總 swap 使用量不為 0 時顯示出來。 ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. +這個模組預設是停用的。 想要啟用它的話，請在設定檔中將 `disabled` 設定為 `false`。 ::: ### 選項 -| Option | 預設 | 說明 | -| ----------- | --------------------------------------------- | -------------------------------------------------------- | -| `threshold` | `75` | Hide the memory usage unless it exceeds this percentage. | -| `format` | `"via $symbol [${ram}( | ${swap})]($style) "` | The format for the module. | -| `symbol` | `"🐏"` | The symbol used before displaying the memory usage. | -| `style` | `"bold dimmed white"` | 這個模組的風格。 | -| `disabled` | `true` | Disables the `memory_usage` module. | +| Option | 預設 | 說明 | +| ----------- | --------------------------------------------- | -------------------------- | +| `threshold` | `75` | 將記憶體使用量隱藏，除非使用量超過指定值。 | +| `format` | `"via $symbol [${ram}( | ${swap})]($style) "` | The format for the module. | +| `symbol` | `"🐏"` | 顯示在記憶體使用量之前的符號。 | +| `style` | `"bold dimmed white"` | 這個模組的風格。 | +| `disabled` | `true` | 停用 `memory_usage` 模組。 | ### Variables @@ -1572,7 +1572,7 @@ The `hg_branch` module shows the active branch of the repo in your current direc | `style` | `"bold purple"` | 這個模組的風格。 | | `format` | `"on [$symbol$branch]($style) "` | The format for the module. | | `truncation_length` | `2^63 - 1` | Truncates the hg branch name to X graphemes | -| `truncation_symbol` | `"…"` | The symbol used to indicate a branch name was truncated. | +| `truncation_symbol` | `"…"` | 用來指示分支名稱被縮減的符號。 | | `disabled` | `true` | Disables the `hg_branch` module. | ### Variables @@ -1636,7 +1636,7 @@ symbol = "🎣 " ## Nix-shell -The `nix_shell` module shows the nix-shell environment. The module will be shown when inside a nix-shell environment. +`nix_shell` 模組顯示 nix-shell 環境。 這個模組會在 nix-shell 環境中顯示。 ### 選項 @@ -1647,7 +1647,7 @@ The `nix_shell` module shows the nix-shell environment. The module will be shown | `style` | `"bold blue"` | 這個模組的風格。 | | `impure_msg` | `"impure"` | A format string shown when the shell is impure. | | `pure_msg` | `"pure"` | A format string shown when the shell is pure. | -| `disabled` | `false` | Disables the `nix_shell` module. | +| `disabled` | `false` | 停用 `nix_shell` 模組。 | ### Variables @@ -1674,11 +1674,11 @@ format = 'via [☃️ $state( \($name\))](bold blue) ' ## NodeJS -The `nodejs` module shows the currently installed version of NodeJS. 這個模組在下列其中一個條件達成時顯示： +`nodejs` 模組顯示現在安裝的 NodeJS 版本。 這個模組在下列其中一個條件達成時顯示： -- The current directory contains a `package.json` file +- 現在資料夾中包含一個 `package.json` 檔案 - The current directory contains a `.node-version` file -- The current directory contains a `node_modules` directory +- 現在資料夾中包含一個 `node_modules` 資料夾 - The current directory contains a file with the `.js`, `.mjs` or `.cjs` extension - The current directory contains a file with the `.ts` extension @@ -1689,7 +1689,7 @@ The `nodejs` module shows the currently installed version of NodeJS. 這個模 | `format` | `"via [$symbol$version]($style) "` | The format for the module. | | `symbol` | `"⬢ "` | A format string representing the symbol of NodeJS. | | `style` | `"bold green"` | 這個模組的風格。 | -| `disabled` | `false` | Disables the `nodejs` module. | +| `disabled` | `false` | 停用 `nodejs` 模組。 | | `not_capable_style` | `bold red` | The style for the module when an engines property in Packages.json does not match the NodeJS version. | ###  Variables @@ -1785,13 +1785,13 @@ style = "bold yellow" symbol = "☁️ " ``` -## Package Version +## 套件版本 -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`, `cargo`, `poetry`, `composer`, `gradle`, `julia`, `mix` and `helm` packages. +The `package` 模組在現在資料夾是一個套件的儲藏庫時出現，並顯示他的現在版本。 這個模組目前支援 `npm`、`cargo`、`poetry`、`composer`、`gradle`、`julia`、`mix`, 跟 `helm` 套件 -- **npm** – The `npm` package version is extracted from the `package.json` present in the current directory -- **cargo** – The `cargo` package version is extracted from the `Cargo.toml` present in the current directory -- **poetry** – The `poetry` package version is extracted from the `pyproject.toml` present in the current directory +- **npm** – `npm` 套件的版本是從現在資料夾中的 `package.json` 之中擷取出來的 +- **cargo** – `cargo` 套件的版本是從現在資料夾中的 `Cargo.toml` 之中擷取出來的 +- **poetry** – `poetry` 套件的版本是從現在資料夾中的 `pyproject.toml` 之中擷取出來的 - **composer** – The `composer` package version is extracted from the `composer.json` present in the current directory - **gradle** – The `gradle` package version is extracted from the `build.gradle` present - **julia** - The package version is extracted from the `Project.toml` present @@ -1804,13 +1804,13 @@ The `package` module is shown when the current directory is the repository for a ### 選項 -| Option | 預設 | 說明 | -| ----------------- | ---------------------------------- | ---------------------------------------------------------- | -| `format` | `"via [$symbol$version]($style) "` | The format for the module. | -| `symbol` | `"📦 "` | The symbol used before displaying the version the package. | -| `style` | `"bold 208"` | 這個模組的風格。 | -| `display_private` | `false` | Enable displaying version for packages marked as private. | -| `disabled` | `false` | Disables the `package` module. | +| Option | 預設 | 說明 | +| ----------------- | --------------------------------- | --------------------------------------------------------- | +| `format` | `"is [$symbol$version]($style) "` | The format for the module. | +| `symbol` | `"📦 "` | 顯示在套件的版本之前的符號。 | +| `style` | `"bold 208"` | 這個模組的風格。 | +| `display_private` | `false` | Enable displaying version for packages marked as private. | +| `disabled` | `false` | 停用 `package` 模組。 | ### Variables @@ -1946,13 +1946,13 @@ If `pyenv_version_name` is set to `true`, it will display the pyenv version name 這個模組在下列其中一個條件達成時顯示： -- The current directory contains a `.python-version` file -- The current directory contains a `requirements.txt` file -- The current directory contains a `pyproject.toml` file +- 目前資料夾中有一個 `.python-version` 檔案 +- 目前資料夾中有一個 `requirements.txt` 檔案 +- 目前資料夾中有一個 `pyproject.toml` 檔案 - The current directory contains a file with the `.py` extension (and `scan_for_pyfiles` is true) -- The current directory contains a `Pipfile` file -- The current directory contains a `tox.ini` file -- The current directory contains a `setup.py` file +- 目前資料夾中有一個 `Pipfile` 檔案 +- 目前資料夾中有一個 `tox.ini` 檔案 +- 現在資料夾中包含一個 `setup.py` 檔案 - The current directory contains a `__init__.py` file - A virtual environment is currently activated @@ -1963,11 +1963,11 @@ If `pyenv_version_name` is set to `true`, it will display the pyenv version name | `format` | `'via [${symbol}${pyenv_prefix}${version}( \($virtualenv\))]($style) '` | The format for the module. | | `symbol` | `"🐍 "` | A format string representing the symbol of Python | | `style` | `"yellow bold"` | 這個模組的風格。 | -| `pyenv_version_name` | `false` | Use pyenv to get Python version | +| `pyenv_version_name` | `false` | 使用 pyenv 取得 Python 的版本。 | | `pyenv_prefix` | `pyenv` | Prefix before pyenv version display, only used if pyenv is used | | `scan_for_pyfiles` | `true` | If false, Python files in the current directory will not show this module. | | `python_binary` | `["python", "python3, "python2"]` | Configures the python binaries that Starship should executes when getting the version. | -| `disabled` | `false` | Disables the `python` module. | +| `disabled` | `false` | 停用 `python` 模組。 | ::: tip @@ -2008,11 +2008,11 @@ python_binary = "python3" ## Ruby -The `ruby` module shows the currently installed version of Ruby. 這個模組在下列其中一個條件達成時顯示： +`ruby` 模組顯示現在安裝的 Ruby 版本。 這個模組在下列其中一個條件達成時顯示： -- The current directory contains a `Gemfile` file +- 目前資料夾中有一個 `Gemfile` 檔案 - The current directory contains a `.ruby-version` file -- The current directory contains a `.rb` file +- 目前資料夾中有一個 `.rb` 檔案 ### 選項 @@ -2021,7 +2021,7 @@ The `ruby` module shows the currently installed version of Ruby. 這個模組在 | `format` | `"via [$symbol$version]($style) "` | The format for the module. | | `symbol` | `"💎 "` | A format string representing the symbol of Ruby. | | `style` | `"bold red"` | 這個模組的風格。 | -| `disabled` | `false` | Disables the `ruby` module. | +| `disabled` | `false` | 停用 `ruby` 模組。 | ### Variables @@ -2044,10 +2044,10 @@ symbol = "🔺 " ## Rust -The `rust` module shows the currently installed version of Rust. 這個模組在下列其中一個條件達成時顯示： +`rust` 模組顯示現在安裝的 Rust 版本。 這個模組在下列其中一個條件達成時顯示： -- The current directory contains a `Cargo.toml` file -- The current directory contains a file with the `.rs` extension +- 目前資料夾中有一個 `Cargo.toml` 檔案 +- 現在資料夾中包含一個檔案具有 `.rs` 副檔名 ### 選項 @@ -2056,7 +2056,7 @@ The `rust` module shows the currently installed version of Rust. 這個模組在 | `format` | `"via [$symbol$version]($style) "` | The format for the module. | | `symbol` | `"🦀 "` | A format string representing the symbol of Rust | | `style` | `"bold red"` | 這個模組的風格。 | -| `disabled` | `false` | Disables the `rust` module. | +| `disabled` | `false` | 停用 `rust` 模組。 | ### Variables @@ -2151,7 +2151,9 @@ The `status` module displays the exit code of the previous command. The module w ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. ::: +這個模組預設是停用的。 想要啟用它的話，請在設定檔中將 `disabled` 設定為 `false`。 + +::: ### 選項 @@ -2286,21 +2288,21 @@ The `time` module shows the current **local** time. The `format` configuration v ::: tip -This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. +這個模組預設是停用的。 想要啟用它的話，請在設定檔中將 `disabled` 設定為 `false`。 ::: ### 選項 -| Option | 預設 | 說明 | -| ----------------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | -| `format` | `"at [$time]($style) "` | The format string for the module. | -| `use_12hr` | `false` | Enables 12 hour formatting | -| `time_format` | see below | The [chrono format string](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) used to format the time. | -| `style` | `"bold yellow"` | The style for the module time | -| `utc_time_offset` | `"local"` | Sets the UTC offset to use. Range from -24 < x < 24. Allows floats to accommodate 30/45 minute timezone offsets. | -| `disabled` | `true` | Disables the `time` module. | -| `time_range` | `"-"` | Sets the time range during which the module will be shown. Times must be specified in 24-hours format | +| Option | 預設 | 說明 | +| ----------------- | ----------------------- | ----------------------------------------------------------------------------------------------------- | +| `format` | `"at [$time]($style) "` | The format string for the module. | +| `use_12hr` | `false` | 啟用 12 小時格式。 | +| `time_format` | 請看下列 | 用來顯示時間的 [chrono 格式字串](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html)。 | +| `style` | `"bold yellow"` | 這個模組的時間的風格。 | +| `utc_time_offset` | `"local"` | 設定相對於 UTC 的時差。 Range from -24 < x < 24. 允許使用浮點數來表示 30/45 分鐘時差的時區。 | +| `disabled` | `true` | 停用 `time` 模組。 | +| `time_range` | `"-"` | Sets the time range during which the module will be shown. Times must be specified in 24-hours format | If `use_12hr` is `true`, then `time_format` defaults to `"%r"`. Otherwise, it defaults to `"%T"`. Manually setting `time_format` will override the `use_12hr` setting. @@ -2308,7 +2310,7 @@ If `use_12hr` is `true`, then `time_format` defaults to `"%r"`. Otherwise, it de | 變數 | 範例 | 說明 | | --------- | ---------- | ----------------------------------- | -| time | `13:08:10` | The current time. | +| 時間 | `13:08:10` | The current time. | | style\* | | Mirrors the value of option `style` | \*: This variable can only be used as a part of a style string @@ -2326,26 +2328,30 @@ utc_time_offset = "-5" time_range = "10:00:00-14:00:00" ``` -## Username +## 使用者名稱 The `username` module shows active user's username. 這個模組在下列其中一個條件達成時顯示： -- The current user is root -- The current user isn't the same as the one that is logged in -- The user is currently connected as an SSH session -- The variable `show_always` is set to true +- 目前使用者為 root +- 目前使用者並非登入時的使用者 +- 使用者透過 SSH session 進行連線 +- 變數 `show_always` 被設為 true -::: tip SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. ::: +::: tip + +SSH connection is detected by checking environment variables `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`. If your SSH host does not set up these variables, one workaround is to set one of them with a dummy value. + +::: ### 選項 -| Option | 預設 | 說明 | -| ------------- | ----------------------- | ------------------------------------- | -| `style_root` | `"bold red"` | The style used when the user is root. | -| `style_user` | `"bold yellow"` | The style used for non-root users. | -| `format` | `"[$user]($style) in "` | The format for the module. | -| `show_always` | `false` | Always shows the `username` module. | -| `disabled` | `false` | Disables the `username` module. | +| Option | 預設 | 說明 | +| ------------- | ----------------------- | -------------------------- | +| `style_root` | `"bold red"` | 使用者為 root 時使用的風格。 | +| `style_user` | `"bold yellow"` | 非 root 使用者時使用的風格。 | +| `format` | `"[$user]($style) in "` | The format for the module. | +| `show_always` | `false` | 總是顯示 `username` 模組。 | +| `disabled` | `false` | 停用 `username` 模組。 | ### Variables @@ -2437,7 +2443,7 @@ The order in which custom modules are shown can be individually set by including | `command` | | The command whose output should be printed. The command will be passed on stdin to the shell. | | `when` | | A shell command used as a condition to show the module. The module will be shown if the command returns a `0` status code. | | `shell` | | [See below](#custom-command-shell) | -| `description` | `""` | The description of the module that is shown when running `starship explain`. | +| `說明` | `""` | The description of the module that is shown when running `starship explain`. | | `files` | `[]` | The files that will be searched in the working directory for a match. | | `directories` | `[]` | The directories that will be searched in the working directory for a match. | | `extensions` | `[]` | The extensions that will be searched in the working directory for a match. | diff --git a/docs/zh-TW/guide/README.md b/docs/zh-TW/guide/README.md index c4c5e377..1225d38d 100644 --- a/docs/zh-TW/guide/README.md +++ b/docs/zh-TW/guide/README.md @@ -125,6 +125,8 @@ ### 入門 +**Note**: due to the proliferation of different platforms, only a subset of supported platforms are shown below. Can't see yours? Have a look at the [extra platform instructions](https://starship.rs/installing/). + 1. 安裝 **starship** 執行檔： @@ -138,17 +140,10 @@ ``` - ##### From source on [crates.io](https://crates.io/): - - ```sh - cargo install starship - ``` - - #### Install via Package Manager - ##### With [Homebrew](https://brew.sh/): + ##### Example: [Homebrew](https://brew.sh/): ```sh brew install starship @@ -161,7 +156,7 @@ scoop install starship ``` -1. 將初始化腳本 (script) 加入你的 shell 的設定檔： +2. 將初始化腳本 (script) 加入你的 shell 的設定檔： #### Bash diff --git a/docs/zh-TW/installing/README.md b/docs/zh-TW/installing/README.md new file mode 100644 index 00000000..6f0ea0d6 --- /dev/null +++ b/docs/zh-TW/installing/README.md @@ -0,0 +1,46 @@ +# 🚀 Advanced Installation + +To install starship, you need to do two things: + +1. Get the **starship** binary onto your computer +1. Tell your shell to use the starship binary as its prompt by modifying its init scripts + +For most users, the instructions on [the main page](/guide/#🚀-installation) will work great. However, for some more specialized platforms, different instructions are needed. + +There are so many platforms out there that they didn't fit into the main README.md file, so here are some installation instructions for other platforms from the community. Is yours not here? Please do add it here if you figure it out! + +## [Nix](https://nixos.wiki/wiki/Nix) + +### Getting the Binary + +#### Imperatively + +```sh +nix-env -iA nixos.starship +``` + +#### Declarative, single user, via [home-manager](home-manager) + +Add `pkgs.starship` to your `home.packages` in your `home.nix` file, then run + +```sh +home-manager switch +``` + +#### Declarative, system-wide, with NixOS + +Add `pkgs.starship` to `environment.packages` in your `configuration.nix`, then run + +```sh +sudo nixos-rebuild switch +``` + +### Modifying Init Scripts + +#### With Nix and home-manager, using zsh: + +Add the following to `programs.zsh.initExtra` in your `home.nix` file, then run + +```sh +home-manager switch +```