Llewellyn/starship
1
0
Fork 0
mirror of https://github.com/Llewellynvdm/starship.git synced 2024-12-01 01:04:00 +00:00
Code Issues Releases Activity

docs(i18n): New Crowdin updates (#2559)

Browse Source
This commit is contained in:
Matan Kushner 2021-04-08 11:52:32 -04:00 committed by GitHub
parent 8af677c811
commit 7a0046ed58
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
46 changed files with 986 additions and 985 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
docs/ar-SA/faq/README.md
View File

@ -92,5 +92,5 @@ If Starship was installed using the `curl | bash` script, the following command
```sh ```sh
# Locate and delete the starship binary # Locate and delete the starship binary
bash -c 'rm "$(which starship)"' sh -c 'rm "$(which starship)"'
``` ```

2
docs/ckb-IR/faq/README.md
View File

@ -92,5 +92,5 @@ If Starship was installed using the `curl | bash` script, the following command
```sh ```sh
# Locate and delete the starship binary # Locate and delete the starship binary
bash -c 'rm "$(which starship)"' sh -c 'rm "$(which starship)"'
``` ```

2
docs/de-DE/README.md
View File

@ -45,7 +45,7 @@ description: Starship ist eine minimale, super schnelle, und extrem anpassbare P
#### Installation mithilfe eines Paket-Managers #### Installation mithilfe eines Paket-Managers
With [Homebrew](https://brew.sh/): Mit [Homebrew](https://brew.sh/):
```sh ```sh
brew install starship brew install starship

4
docs/de-DE/advanced-config/README.md
View File

@ -57,9 +57,9 @@ Füge dies in `Zsh` zum `precmd_functions`-Array hinzu:
precmd_functions+=(set_win_title) precmd_functions+=(set_win_title)
``` ```
If you like the result, add these lines to your shell configuration file (`~/.bashrc` or `~/.zshrc`) to make it permanent. Wenn Sie das Resultat für gut empfinden, fügen Sie diese Zeilen zu ihrer Shell Konfigurationsdatei hinzu (`~/.bashrc` oder `~/.zshrc`) um das Ergebnis permanent zu machen.
For example, if you want to display your current directory in your terminal tab title, add the following snippet to your `~/.bashrc` or `~/.zshrc`: Zum Beispiel, wenn sie ihr aktuelles Verzeichnis als Terminal Title anzeigen wollen, fügen Sie folgenden Code-Schnipsel zu ihrer `~/.bashrc` oder `~/.zshrc` hinzu:
```bash ```bash
function set_win_title(){ function set_win_title(){

166
docs/de-DE/config/README.md
View File

@ -305,7 +305,7 @@ symbol = "🅰 "
## Akkustand ## Akkustand
The `battery` module shows how charged the device's battery is and its current charging status. The module is only visible when the device's battery is below 10%. Das `battery` Modul zeigt, wie hoch der Akku des Geräts geladen ist und den aktuellen Ladestatus. Das Modul ist nur sichtbar, wenn der Akku des Geräts unter 10% geladen ist.
### Optionen ### Optionen
@ -333,7 +333,7 @@ discharging_symbol = "💀 "
### Anzeige des Akkustandes ### 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 ```toml
[[battery.display]] [[battery.display]]
@ -343,7 +343,7 @@ style = "bold red"
#### Optionen #### Optionen
The `display` option is an array of the following table. Die `display`-Option beinhaltet ein Array mit den folgenden Werten.
| Option | Beschreibung | | Option | Beschreibung |
| ----------- | ------------------------------------------------------- | | ----------- | ------------------------------------------------------- |
@ -367,9 +367,9 @@ style = "bold yellow"
## Zeichen ## 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 color (`red`/`green`)
- changing shape (`❯`/`✖`) - changing shape (`❯`/`✖`)
@ -456,15 +456,15 @@ The `cmake` module shows the currently installed version of CMake. By default th
## Befehlsdauer ## 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 ### Optionen
@ -478,7 +478,7 @@ Bash users who need preexec-like functionality can use [rcaloras's bash_preexec
| `show_notifications` | `false` | Show desktop notifications when command completes. | | `show_notifications` | `false` | Show desktop notifications when command completes. |
| `min_time_to_notify` | `45_000` | Shortest duration for notification (in milliseconds). | | `min_time_to_notify` | `45_000` | Shortest duration for notification (in milliseconds). |
::: tip ::: Tipp
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`. 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`.
@ -505,11 +505,11 @@ format = "underwent [$duration](bold yellow)"
## Conda ## 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.
::: tip ::: 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.
::: :::
@ -587,7 +587,7 @@ The `dart` module shows the currently installed version of Dart. By default the
- The current directory contains a file with `.dart` extension - The current directory contains a file with `.dart` extension
- The current directory contains a `.dart_tool` directory - The current directory contains a `.dart_tool` directory
- The current directory contains a `pubspec.yaml`, `pubspec.yml` or `pubspec.lock` file - Das aktuelle Verzeichnis enthält `pubspec.yaml`, `pubspec.yml` oder `pubspec.lock`
### Optionen ### Optionen
@ -622,7 +622,7 @@ format = "via [🔰 $version](bold red) "
## Verzeichnis ## 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. 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.
@ -643,7 +643,7 @@ For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, an
| `home_symbol` | `"~"` | The symbol indicating home directory. | | `home_symbol` | `"~"` | The symbol indicating home directory. |
<details> <details>
<summary>This module has a few advanced configuration options that control how the directory is displayed.</summary> <summary>Dieses Modul hat einige erweiterte Konfigurationsoptionen, welche die Darstellung von Verzeichnissen steuern.</summary>
| Advanced Option | Standardwert | Beschreibung | | Advanced Option | Standardwert | Beschreibung |
| --------------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | --------------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@ -751,7 +751,7 @@ The module will also show the Target Framework Moniker (<https://docs.microsoft.
| `detect_files` | `["global.json", "project.json", "Directory.Build.props", "Directory.Build.targets", "Packages.props"]` | Which filenames should trigger this module. | | `detect_files` | `["global.json", "project.json", "Directory.Build.props", "Directory.Build.targets", "Packages.props"]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this modules. | | `detect_folders` | `[]` | Which folders should trigger this modules. |
| `style` | `"bold blue"` | Stil für dieses Modul. | | `style` | `"bold blue"` | Stil für dieses Modul. |
| `disabled` | `false` | Disables the `dotnet` module. | | `disabled` | `false` | Deaktiviert das `dotnet`-Modul. |
### Variables ### Variables
@ -991,7 +991,7 @@ asia-northeast1 = "an1"
## Git-Branch ## Git-Branch
The `git_branch` module shows the active branch of the repo in your current directory. Das `git_branch`-Modul zeigt den aktiven Git-Branch des Repositories im aktuellen Verzeichnis an.
### Optionen ### Optionen
@ -1189,7 +1189,7 @@ behind = "⇣${count}"
## Golang ## Golang
The `golang` module shows the currently installed version of Golang. By default the module will be shown if any of the following conditions are met: Das `golang`-Modul zeigt die aktuell installierte Version von Golang. By default the module will be shown if any of the following conditions are met:
- Das aktuelle Verzeichnis enthält eine `go.mod`-Datei - Das aktuelle Verzeichnis enthält eine `go.mod`-Datei
- Das aktuelle Verzeichnis enthält eine `go.sum`-Datei - Das aktuelle Verzeichnis enthält eine `go.sum`-Datei
@ -1210,7 +1210,7 @@ The `golang` module shows the currently installed version of Golang. By default
| `detect_files` | `["go.mod", "go.sum", "glide.yaml", "Gopkg.yml", "Gopkg.lock", ".go-version"]` | Which filenames should trigger this module. | | `detect_files` | `["go.mod", "go.sum", "glide.yaml", "Gopkg.yml", "Gopkg.lock", ".go-version"]` | Which filenames should trigger this module. |
| `detect_folders` | `["Godeps"]` | Which folders should trigger this module. | | `detect_folders` | `["Godeps"]` | Which folders should trigger this module. |
| `style` | `"bold cyan"` | Stil für dieses Modul. | | `style` | `"bold cyan"` | Stil für dieses Modul. |
| `disabled` | `false` | Disables the `golang` module. | | `disabled` | `false` | Deaktiviert das `golang`-Modul. |
### Variables ### Variables
@ -1271,7 +1271,7 @@ format = "via [⎈ $version](bold white) "
## Hostname ## Hostname
The `hostname` module shows the system hostname. Das `hostname`-Modul zeigt den Hostnamen des Systems an.
### Optionen ### Optionen
@ -1306,7 +1306,7 @@ disabled = false
## Java ## Java
The `java` module shows the currently installed version of Java. By default the module will be shown if any of the following conditions are met: Das `java` Modul zeigt die derzeit installierte Version von Java an. By default the module will be shown if any of the following conditions are met:
- 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 `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 - The current directory contains a file with the `.java`, `.class`, `.gradle`, `.jar`, `.clj`, or `.cljc` extension
@ -1321,7 +1321,7 @@ The `java` module shows the currently installed version of Java. By default the
| `detect_folders` | `[]` | Which folders should trigger this modules. | | `detect_folders` | `[]` | Which folders should trigger this modules. |
| `symbol` | `"☕ "` | A format string representing the symbol of Java | | `symbol` | `"☕ "` | A format string representing the symbol of Java |
| `style` | `"red dimmed"` | Stil für dieses Modul. | | `style` | `"red dimmed"` | Stil für dieses Modul. |
| `disabled` | `false` | Disables the `java` module. | | `disabled` | `false` | Deaktiviert das `Java`-Modul. |
### Variables ### Variables
@ -1471,9 +1471,9 @@ kotlin_binary = "kotlinc"
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`. 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`.
::: tip ::: Tipp
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. Dieses Modul ist standardmäßig deaktiviert. Setze in deiner Konfiguration `disabled` auf `false` um es zu aktivieren.
::: :::
@ -1512,7 +1512,7 @@ disabled = false
## Zeilenumbruch ## Zeilenumbruch
The `line_break` module separates the prompt into two lines. Das `line_break`-Modul unterteilt den Prompt in zwei Zeilen.
### Optionen ### Optionen
@ -1571,13 +1571,13 @@ format = "via [🌕 $version](bold blue) "
## Speicherauslastung ## Speicherauslastung
The `memory_usage` module shows current system memory and swap usage. Das `memory_usage` Modul zeigt den aktuellen Systemspeicher und die swap-Nutzung an.
By default the swap usage is displayed if the total system swap is non-zero. Standardmäßig wird die swap-Nutzung angezeigt, wenn der gesamte System-swap nicht Null ist.
::: tip ::: Tipp
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. Dieses Modul ist standardmäßig deaktiviert. Setze in deiner Konfiguration `disabled` auf `false` um es zu aktivieren.
::: :::
@ -1695,7 +1695,7 @@ symbol = "🎣 "
## Nix-Shell ## Nix-Shell
The `nix_shell` module shows the nix-shell environment. The module will be shown when inside a nix-shell environment. Das `nix_shell`-Modul zeigt die nix-shell Umgebung an. Das Modul wird angezeigt, wenn es sich in einer nix-Shell-Umgebung befindet.
### Optionen ### Optionen
@ -1733,7 +1733,7 @@ format = 'via [☃️ $state( \($name\))](bold blue) '
## NodeJS ## NodeJS
The `nodejs` module shows the currently installed version of NodeJS. By default the module will be shown if any of the following conditions are met: Das `nodejs`-Modul zeigt die aktuell installierte Version von NodeJS. By default the module will be shown if any of the following conditions are met:
- Das aktuelle Verzeichnis enthält eine `package.json`-Datei - Das aktuelle Verzeichnis enthält eine `package.json`-Datei
- The current directory contains a `.node-version` file - The current directory contains a `.node-version` file
@ -1751,7 +1751,7 @@ The `nodejs` module shows the currently installed version of NodeJS. By default
| `detect_files` | `["package.json", ".node-version"]` | Which filenames should trigger this module. | | `detect_files` | `["package.json", ".node-version"]` | Which filenames should trigger this module. |
| `detect_folders` | `["node_modules"]` | Which folders should trigger this module. | | `detect_folders` | `["node_modules"]` | Which folders should trigger this module. |
| `style` | `"bold green"` | Stil für dieses Modul. | | `style` | `"bold green"` | Stil für dieses Modul. |
| `disabled` | `false` | Disables the `nodejs` module. | | `disabled` | `false` | Deaktiviert das `nodejs`-Modul. |
| `not_capable_style` | `bold red` | The style for the module when an engines property in `package.json` does not match the NodeJS version. | | `not_capable_style` | `bold red` | The style for the module when an engines property in `package.json` does not match the NodeJS version. |
### Variables ### Variables
@ -1856,7 +1856,7 @@ symbol = "☁️ "
## Paketversion ## Paketversion
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. Das `Package` Modul wird angezeigt, wenn das aktuelle Verzeichnis das Repository für ein Paket ist, und zeigt dessen aktuelle Version an. The module currently supports `npm`, `cargo`, `poetry`, `composer`, `gradle`, `julia`, `mix` and `helm` packages.
- **npm** – Die `npm` Paketversion wird aus dem `package.json` gelesen, das sich im aktuellen Verzeichnis befindet - **npm** – Die `npm` Paketversion wird aus dem `package.json` gelesen, das sich im aktuellen Verzeichnis befindet
- **Cargo** – Die `Cargo` Paketversion wird aus dem `Cargo.toml` gelesen, das sich im aktuellen Verzeichnis befindet - **Cargo** – Die `Cargo` Paketversion wird aus dem `Cargo.toml` gelesen, das sich im aktuellen Verzeichnis befindet
@ -1941,7 +1941,7 @@ format = "via [🦪 $version]($style) "
## PHP ## PHP
The `php` module shows the currently installed version of PHP. By default the module will be shown if any of the following conditions are met: Das `php`-Modul zeigt die aktuell installierte Version von PHP. By default the module will be shown if any of the following conditions are met:
- Das aktuelle Verzeichnis enthält eine `composer.json`-Datei - Das aktuelle Verzeichnis enthält eine `composer.json`-Datei
- The current directory contains a `.php-version` file - The current directory contains a `.php-version` file
@ -1957,7 +1957,7 @@ The `php` module shows the currently installed version of PHP. By default the mo
| `detect_files` | `["composer.json", ".php-version"]` | Which filenames should trigger this module. | | `detect_files` | `["composer.json", ".php-version"]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. | | `detect_folders` | `[]` | Which folders should trigger this module. |
| `style` | `"147 bold"` | Stil für dieses Modul. | | `style` | `"147 bold"` | Stil für dieses Modul. |
| `disabled` | `false` | Disables the `php` module. | | `disabled` | `false` | Deaktiviert das `php`-Modul. |
### Variables ### Variables
@ -2025,13 +2025,13 @@ If `pyenv_version_name` is set to `true`, it will display the pyenv version name
By default the module will be shown if any of the following conditions are met: By default the module will be shown if any of the following conditions are met:
- Das aktuelle Verzeichnis enthält eine `.python-version`-Datei - Das aktuelle Verzeichnis enthält eine `.python-version`-Datei
- The current directory contains a `Pipfile` file - Das aktuelle Verzeichnis enthält eine `Pipfile`-Datei
- The current directory contains a `__init__.py` file - The current directory contains a `__init__.py` file
- The current directory contains a `pyproject.toml` file - Das aktuelle Verzeichnis enthält eine `pyproject.toml`-Datei
- The current directory contains a `requirements.txt` file - Das aktuelle Verzeichnis enthält eine `requirements.txt`-Datei
- The current directory contains a `setup.py` file - Das aktuelle Verzeichnis enthält eine `setup.py`-Datei
- The current directory contains a `tox.ini` file - Das aktuelle Verzeichnis enthält eine `tox.ini`-Datei
- The current directory contains a file with the `.py` extension. - Das aktuelle Verzeichnis enthält eine Datei mit der `.py`-Erweiterung.
- Ein virtualenv ist momentan aktiv - Ein virtualenv ist momentan aktiv
### Optionen ### Optionen
@ -2047,9 +2047,9 @@ By default the module will be shown if any of the following conditions are met:
| `detect_extensions` | `[".py"]` | Which extensions should trigger this module | | `detect_extensions` | `[".py"]` | Which extensions should trigger this module |
| `detect_files` | `[".python-version", "Pipfile", "__init__.py", "pyproject.toml", "requirements.txt", "setup.py", "tox.ini"]` | Which filenames should trigger this module | | `detect_files` | `[".python-version", "Pipfile", "__init__.py", "pyproject.toml", "requirements.txt", "setup.py", "tox.ini"]` | Which filenames should trigger this module |
| `detect_folders` | `[]` | Which folders should trigger this module | | `detect_folders` | `[]` | Which folders should trigger this module |
| `disabled` | `false` | Disables the `python` module. | | `disabled` | `false` | Deaktiviert das `python`-Modul. |
::: tip ::: Tipp
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. 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.
@ -2095,7 +2095,7 @@ detect_extensions = []
## Ruby ## Ruby
By default the `ruby` module shows the currently installed version of Ruby. The module will be shown if any of the following conditions are met: By default the `ruby` module shows the currently installed version of Ruby. Das Modul wird gezeigt, wenn mindestens einer der folgenden Punkte erfüllt ist:
- Das aktuelle Verzeichnis enthält eine `Gemfile`-Datei - Das aktuelle Verzeichnis enthält eine `Gemfile`-Datei
- The current directory contains a `.ruby-version` file - The current directory contains a `.ruby-version` file
@ -2111,7 +2111,7 @@ By default the `ruby` module shows the currently installed version of Ruby. The
| `detect_files` | `["Gemfile", ".ruby-version"]` | Which filenames should trigger this module. | | `detect_files` | `["Gemfile", ".ruby-version"]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. | | `detect_folders` | `[]` | Which folders should trigger this module. |
| `style` | `"bold red"` | Stil für dieses Modul. | | `style` | `"bold red"` | Stil für dieses Modul. |
| `disabled` | `false` | Disables the `ruby` module. | | `disabled` | `false` | Deaktiviert das `ruby`-Modul. |
### Variables ### Variables
@ -2134,7 +2134,7 @@ symbol = "🔺 "
## Rust ## Rust
By default the `rust` module shows the currently installed version of Rust. The module will be shown if any of the following conditions are met: By default the `rust` module shows the currently installed version of Rust. Das Modul wird gezeigt, wenn mindestens einer der folgenden Punkte erfüllt ist:
- Das aktuelle Verzeichnis enthält eine `Cargo.toml`-Datei - Das aktuelle Verzeichnis enthält eine `Cargo.toml`-Datei
- Das aktuelle Verzeichnis enthält eine Datei mit der `.rs`-Erweiterung - Das aktuelle Verzeichnis enthält eine Datei mit der `.rs`-Erweiterung
@ -2149,7 +2149,7 @@ By default the `rust` module shows the currently installed version of Rust. The
| `detect_files` | `["Cargo.toml"]` | Which filenames should trigger this module. | | `detect_files` | `["Cargo.toml"]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. | | `detect_folders` | `[]` | Which folders should trigger this module. |
| `style` | `"bold red"` | Stil für dieses Modul. | | `style` | `"bold red"` | Stil für dieses Modul. |
| `disabled` | `false` | Disables the `rust` module. | | `disabled` | `false` | Deaktiviert das `rust`-Modul. |
### Variables ### Variables
@ -2213,9 +2213,9 @@ symbol = "🌟 "
The `shell` module shows an indicator for currently used shell. The `shell` module shows an indicator for currently used shell.
::: tip ::: Tipp
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. Dieses Modul ist standardmäßig deaktiviert. Setze in deiner Konfiguration `disabled` auf `false` um es zu aktivieren.
::: :::
@ -2322,9 +2322,9 @@ format = '[📦 \[$env\]]($style) '
The `status` module displays the exit code of the previous command. The module will be shown only if the exit code is not `0`. The `status` module displays the exit code of the previous command. The module will be shown only if the exit code is not `0`.
::: tip ::: Tipp
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. Dieses Modul ist standardmäßig deaktiviert. Setze in deiner Konfiguration `disabled` auf `false` um es zu aktivieren.
::: :::
@ -2377,7 +2377,7 @@ disabled = false
## Swift ## Swift
By default the `swift` module shows the currently installed version of Swift. The module will be shown if any of the following conditions are met: By default the `swift` module shows the currently installed version of Swift. Das Modul wird gezeigt, wenn mindestens einer der folgenden Punkte erfüllt ist:
- The current directory contains a `Package.swift` file - The current directory contains a `Package.swift` file
- The current directory contains a file with the `.swift` extension - The current directory contains a file with the `.swift` extension
@ -2415,9 +2415,9 @@ format = "via [🏎 $version](red bold)"
## Terraform ## Terraform
The `terraform` module shows the currently selected terraform workspace and version. Das `Terraform` Modul zeigt den aktuell ausgewählten terraform Arbeitsbereich und die Version an.
::: tip ::: Tipp
By default the terraform version is not shown, since this is slow for 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). By default the terraform version is not shown, since this is slow for 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).
@ -2425,7 +2425,7 @@ By default the terraform version is not shown, since this is slow for current ve
By default the module will be shown if any of the following conditions are met: By default the module will be shown if any of the following conditions are met:
- The current directory contains a `.terraform` folder - Das aktuelle Verzeichnis enthält eine `.terraform`-Datei
- Current directory contains a file with the `.tf` or `.hcl` extensions - Current directory contains a file with the `.tf` or `.hcl` extensions
### Optionen ### Optionen
@ -2438,7 +2438,7 @@ By default the module will be shown if any of the following conditions are met:
| `detect_files` | `[]` | Which filenames should trigger this module. | | `detect_files` | `[]` | Which filenames should trigger this module. |
| `detect_folders` | `[".terraform"]` | Which folders should trigger this module. | | `detect_folders` | `[".terraform"]` | Which folders should trigger this module. |
| `style` | `"bold 105"` | Stil für dieses Modul. | | `style` | `"bold 105"` | Stil für dieses Modul. |
| `disabled` | `false` | Disables the `terraform` module. | | `disabled` | `false` | Deaktiviert das `terraform` Modul. |
### Variables ### Variables
@ -2473,33 +2473,33 @@ format = "[🏎💨 $workspace]($style) "
## Zeit ## Zeit
The `time` module shows the current **local** time. The `format` configuration value is used by the [`chrono`](https://crates.io/crates/chrono) crate to control how the time is displayed. Take a look [at the chrono strftime docs](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) to see what options are available. Das `time` Modul zeigt die aktuelle **lokale** Zeit an. Der `format` Wert wird von der crate [`chrono`](https://crates.io/crates/chrono) benutzt um die Zeit zu formatieren. Schau dir [die chrono strftime Dokumentation](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) an, um die möglichen Optionen zu sehen.
::: tip ::: Tipp
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. Dieses Modul ist standardmäßig deaktiviert. Setze in deiner Konfiguration `disabled` auf `false` um es zu aktivieren.
::: :::
### Optionen ### Optionen
| Option | Standardwert | Beschreibung | | Option | Standardwert | Beschreibung |
| ----------------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | ----------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `format` | `"at [$time]($style) "` | The format string for the module. | | `format` | `"at [$time]($style) "` | The format string for the module. |
| `use_12hr` | `false` | Enables 12 hour formatting | | `use_12hr` | `false` | Aktiviert 12-Stunden-Format |
| `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. | | `time_format` | siehe unten | Das Format zum Anzeigen der Uhrzeit in [chrono-Formatierung](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html). |
| `style` | `"bold yellow"` | The style for the module time | | `style` | `"bold yellow"` | Stil für dieses Modul |
| `utc_time_offset` | `"local"` | Sets the UTC offset to use. Range from -24 &lt; x &lt; 24. Allows floats to accommodate 30/45 minute timezone offsets. | | `utc_time_offset` | `"local"` | Verwendetes Zeitzonen-Offset. Range from -24 &lt; x &lt; 24. Allows floats to accommodate 30/45 minute timezone offsets. |
| `disabled` | `true` | Disables the `time` module. | | `disabled` | `true` | Deaktiviert das `time`-Modul. |
| `time_range` | `"-"` | Sets the time range during which the module will be shown. Times must be specified in 24-hours format | | `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. If `use_12hr` is `true`, then `time_format` defaults to `"%r"`. Andernfalls ist es standardmäßig `"%T"`. Manually setting `time_format` will override the `use_12hr` setting.
### Variables ### Variables
| Variable | Beispiel | Beschreibung | | Variable | Beispiel | Beschreibung |
| --------- | ---------- | ----------------------------------- | | --------- | ---------- | ----------------------------------- |
| time | `13:08:10` | The current time. | | zeit | `13:08:10` | The current time. |
| style\* | | Mirrors the value of option `style` | | style\* | | Mirrors the value of option `style` |
\*: This variable can only be used as a part of a style string \*: This variable can only be used as a part of a style string
@ -2519,14 +2519,14 @@ time_range = "10:00:00-14:00:00"
## Username ## Username
The `username` module shows active user's username. The module will be shown if any of the following conditions are met: Das `username` Modul zeigt den Namen des aktiven Benutzers. Das Modul wird gezeigt, wenn mindestens einer der folgenden Punkte erfüllt ist:
- The current user is root - Der aktuelle Benutzer ist root
- The current user isn't the same as the one that is logged in - Der aktuelle Benutzer ist nicht der eingeloggte Benutzer
- The user is currently connected as an SSH session - Der Benutzer ist aktuell via SSH verbunden
- The variable `show_always` is set to true - Die Variable `show_always` ist auf true gesetzt
::: tip ::: Tipp
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. 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.
@ -2535,12 +2535,12 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
### Optionen ### Optionen
| Option | Standardwert | Beschreibung | | Option | Standardwert | Beschreibung |
| ------------- | ----------------------- | ------------------------------------- | | ------------- | ----------------------- | ---------------------------------------------- |
| `style_root` | `"bold red"` | The style used when the user is root. | | `style_root` | `"bold red"` | Stil wenn der Benutzer unter root läuft. |
| `style_user` | `"bold yellow"` | The style used for non-root users. | | `style_user` | `"bold yellow"` | Stil wenn der Benutzer nicht unter root läuft. |
| `format` | `"[$user]($style) in "` | The format for the module. | | `format` | `"[$user]($style) in "` | The format for the module. |
| `show_always` | `false` | Always shows the `username` module. | | `show_always` | `false` | Immer das `username` Modul anzeigen. |
| `disabled` | `false` | Disables the `username` module. | | `disabled` | `false` | Deavktiviert das `username` Modul. |
### Variables ### Variables
@ -2633,7 +2633,7 @@ format = "[🆅 $repo](bold blue) "
## Zig ## Zig
By default the the `zig` module shows the currently installed version of Zig. The module will be shown if any of the following conditions are met: By default the the `zig` module shows the currently installed version of Zig. Das Modul wird gezeigt, wenn mindestens einer der folgenden Punkte erfüllt ist:
- The current directory contains a `.zig` file - The current directory contains a `.zig` file
@ -2679,19 +2679,19 @@ These modules will be shown if any of the following conditions are met:
- The current directory contains a file whose extension is in `extensions` - The current directory contains a file whose extension is in `extensions`
- The `when` command returns 0 - The `when` command returns 0
::: tip ::: Tipp
Multiple custom modules can be defined by using a `.`. Multiple custom modules can be defined by using a `.`.
::: :::
::: tip ::: Tipp
The order in which custom modules are shown can be individually set by including `${custom.foo}` in the top level `format` (as it includes a dot, you need to use `${...}`). By default, the `custom` module will simply show all custom modules in the order they were defined. The order in which custom modules are shown can be individually set by including `${custom.foo}` in the top level `format` (as it includes a dot, you need to use `${...}`). By default, the `custom` module will simply show all custom modules in the order they were defined.
::: :::
::: tip ::: Tipp
[Issue #1252](https://github.com/starship/starship/discussions/1252) contains examples of custom modules. If you have an interesting example not covered there, feel free to share it there! [Issue #1252](https://github.com/starship/starship/discussions/1252) contains examples of custom modules. If you have an interesting example not covered there, feel free to share it there!

4
docs/de-DE/faq/README.md
View File

@ -38,7 +38,7 @@ NUM_JOBS=$(jobs -p | wc -l)
PS1="$(starship prompt --status=$STATUS --jobs=$NUM_JOBS)" PS1="$(starship prompt --status=$STATUS --jobs=$NUM_JOBS)"
``` ```
The [Bash implementation](https://github.com/starship/starship/blob/master/src/init/starship.bash) built into Starship is slightly more complex to allow for advanced features like the [Command Duration module](https://starship.rs/config/#command-duration) and to ensure that Starship is compatible with pre-installed Bash configurations. Die [Bash Implementation](https://github.com/starship/starship/blob/master/src/init/starship.bash) ist etwas komplexer, um erweiterte Funktionen wie das [Befehlsdauer-Modul](https://starship.rs/config/#command-duration) zu ermöglichen und um sicherzustellen, dass Starship mit vorinstallierten Bash Konfigurationen kompatibel ist.
Für eine Liste aller Flaggen, die von `Starship-Eingabeaufforderung` akzeptiert wird, verwenden Sie den folgenden Befehl: Für eine Liste aller Flaggen, die von `Starship-Eingabeaufforderung` akzeptiert wird, verwenden Sie den folgenden Befehl:
@ -92,5 +92,5 @@ If Starship was installed using the `curl | bash` script, the following command
```sh ```sh
# Locate and delete the starship binary # Locate and delete the starship binary
bash -c 'rm "$(which starship)"' sh -c 'rm "$(which starship)"'
``` ```

2
docs/de-DE/presets/README.md
View File

@ -2,7 +2,7 @@
Here is a collection of community-submitted configuration presets for Starship. If you have a preset to share, please [submit a PR](https://github.com/starship/starship/edit/master/docs/presets/README.md) updating this file! 😊 Here is a collection of community-submitted configuration presets for Starship. If you have a preset to share, please [submit a PR](https://github.com/starship/starship/edit/master/docs/presets/README.md) updating this file! 😊
## Nerd Font Symbols ## Nerd Font Symbole
This preset doesn't change anything except for the symbols used for each module. If emojis aren't your thing, this might catch your eye! This preset doesn't change anything except for the symbols used for each module. If emojis aren't your thing, this might catch your eye!

4
docs/es-ES/README.md
View File

@ -40,12 +40,12 @@ description: '¡Starship es el prompt minimalista, ultrarápido e infinitamente
```sh ```sh
curl -fsSL https://starship.rs/install.sh | bash curl -fsSL https://starship.rs/install.sh | bash
``` ```
To update the Starship itself, rerun the above script. It will replace the current version without touching Starship's configuration. Para actualizar Starship, vuelve a ejecutar el guión anterior. Reemplazará la versión actual sin tocar la configuración de Starship.
#### Instalar con un gestor de paquetes #### Instalar con un gestor de paquetes
With [Homebrew](https://brew.sh/): Con [Homebrew](https://brew.sh/):
```sh ```sh
brew install starship brew install starship

4
docs/es-ES/advanced-config/README.md
View File

@ -12,7 +12,7 @@ Las configuraciones de esta sección están sujetos a cambios en futuras version
Bash no posee un framework oficial de preexec/precmd como la mayoría de los demás intérpretes de comandos. Debido a esto, es difícil proporcionar "hooks" totalmente personalizables en `Bash`. Sin embargo, Starship te da la posibilidad de insertar de forma limitada tus propias funciones en el proceso de renderizado del prompt: Bash no posee un framework oficial de preexec/precmd como la mayoría de los demás intérpretes de comandos. Debido a esto, es difícil proporcionar "hooks" totalmente personalizables en `Bash`. Sin embargo, Starship te da la posibilidad de insertar de forma limitada tus propias funciones en el proceso de renderizado del prompt:
- Para ejecutar una función personalizada previa al renderizado del prompt, define una nueva función y asigna su nombre a `starship_precmd_user_func`. Por ejemplo, para renderizar un cohete antes del prompt, se puede realizar así: - Para ejecutar una función personalizada previa al renderizado del prompt, define una nueva función y asigna su nombre a `starship_precmd_user_func`. Por ejemplo, para dibujar un cohete antes del prompt, se puede realizar así:
```bash ```bash
function blastoff(){ function blastoff(){
@ -21,7 +21,7 @@ function blastoff(){
starship_precmd_user_func="blastoff" starship_precmd_user_func="blastoff"
``` ```
- Para ejecutar una función personalizada antes de que un comando sea ejecutado, es posible usar el [mecanismo trap `DEBUG`](https://jichu4n.com/posts/debug-trap-and-prompt_command-in-bash/). No obstante, ¡**debes** atrapar la señal DEBUG *antes* de inicializar Starship! Starship puede preservar el valor de la trampa DEBUG, pero si la trampa es reemplazada después de que Starship inicie, alguna funcionalidad fallará. - Para ejecutar una función personalizada antes de que un comando sea ejecutado, es posible usar el [mecanismo de trampa `DEBUG`](https://jichu4n.com/posts/debug-trap-and-prompt_command-in-bash/). No obstante, ¡**debes** atrapar la señal DEBUG *antes* de inicializar Starship! Starship puede preservar el valor de la trampa DEBUG, pero si la trampa es reemplazada después de que Starship inicie, alguna funcionalidad fallará.
```bash ```bash
function blastoff(){ function blastoff(){

106
docs/es-ES/config/README.md
View File

@ -1036,11 +1036,11 @@ El módulo `git_commit` muestra el hash de la confirmación actual y también la
### Opciones ### Opciones
| Opción | Por defecto | Descripción | | Opción | Por defecto | Descripción |
| -------------------- | ------------------------------------------------------ | ----------------------------------------------------------------------- | | -------------------- | ------------------------------------------------------ | -------------------------------------------------------------------------------------- |
| `commit_hash_length` | `7` | La longitud del hash del commit de git mostrado. | | `commit_hash_length` | `7` | La longitud del hash del commit de git mostrado. |
| `format` | `"[\\($hash\\)]($style) [\\($tag\\)]($style)"` | El formato del módulo. | | `format` | `"[\\($hash\\)]($style) [\\($tag\\)]($style)"` | El formato del módulo. |
| `style` | `"bold green"` | El estilo del módulo. | | `style` | `"bold green"` | El estilo del módulo. |
| `only_detached` | `true` | Only show git commit hash when in detached `HEAD` state | | `only_detached` | `true` | Mostrar solo el hash de la confirmación de git cuando esté en estado "detached `HEAD`" |
| `tag_disabled` | `true` | Deshabilita mostrar información de etiquetas en el módulo `git_commit`. | | `tag_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 | | `tag_symbol` | `"🏷 "` | Símbolo de etiqueta prefijando la información mostrada |
| `disabled` | `false` | Desactiva el módulo `git_commit`. | | `disabled` | `false` | Desactiva el módulo `git_commit`. |
@ -1627,7 +1627,7 @@ El módulo `hg_branch` muestra la rama activa del repositorio en su directorio a
| `symbol` | `" "` | El símbolo usado antes del marcador hg o nombre de la rama del repositorio en su directorio actual. | | `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. | | `style` | `"bold purple"` | El estilo del módulo. |
| `format` | `"on [$symbol$branch]($style) "` | El formato del módulo. | | `format` | `"on [$symbol$branch]($style) "` | El formato del módulo. |
| `truncation_length` | `2^63 - 1` | Truncates the hg branch name to `N` graphemes | | `truncation_length` | `2^63 - 1` | Trunca el nombre de la rama hg a `N` grafemas |
| `truncation_symbol` | `"…"` | El símbolo usado para indicar que un nombre de rama fue truncado. | | `truncation_symbol` | `"…"` | El símbolo usado para indicar que un nombre de rama fue truncado. |
| `disabled` | `true` | Desactiva el módulo `hg_branch`. | | `disabled` | `true` | Desactiva el módulo `hg_branch`. |
@ -1744,7 +1744,7 @@ El módulo `nodejs` muestra la versión instalada de NodeJS. Por defecto, el mó
### Opciones ### Opciones
| Opción | Por defecto | Descripción | | Opción | Por defecto | Descripción |
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------ | | ------------------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
| `format` | `"via [$symbol($version )]($style)"` | El formato del módulo. | | `format` | `"via [$symbol($version )]($style)"` | El formato del módulo. |
| `symbol` | `" "` | Una cadena de formato que representa el símbolo de NodeJS. | | `symbol` | `" "` | Una cadena de formato que representa el símbolo de NodeJS. |
| `detect_extensions` | `["js", "mjs", "cjs", "ts"]` | Qué extensiones deberían activar este módulo. | | `detect_extensions` | `["js", "mjs", "cjs", "ts"]` | Qué extensiones deberían activar este módulo. |
@ -1752,7 +1752,7 @@ El módulo `nodejs` muestra la versión instalada de NodeJS. Por defecto, el mó
| `detect_folders` | `["node_modules"]` | Qué carpetas deberían activar este módulo. | | `detect_folders` | `["node_modules"]` | Qué carpetas deberían activar este módulo. |
| `style` | `"bold green"` | El estilo del módulo. | | `style` | `"bold green"` | El estilo del módulo. |
| `disabled` | `false` | Deshabilita el módulo `nodejs`. | | `disabled` | `false` | Deshabilita el módulo `nodejs`. |
| `not_capable_style` | `bold red` | The style for the module when an engines property in `package.json` does not match the NodeJS version. | | `not_capable_style` | `bold red` | El estilo para el módulo cuando una propiedad de motores en `package.json` no coincide con la versión de NodeJS. |
### Variables ### Variables
@ -1787,24 +1787,24 @@ El módulo `ocaml` muestra la versión actualmente instalada de OCaml. Por defec
### Opciones ### Opciones
| Opción | Por defecto | Descripción | | Opción | Por defecto | Descripción |
| ------------------------- | -------------------------------------------------------------------------- | ------------------------------------------------------- | | ------------------------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| `format` | `"via [$symbol($version )(\($switch_indicator$switch_name\) )]($style)"` | La cadena de formato para el módulo. | | `format` | `"via [$symbol($version )(\($switch_indicator$switch_name\) )]($style)"` | La cadena de formato para el módulo. |
| `symbol` | `"🐫 "` | El símbolo usado antes de mostrar la versión de OCaml. | | `symbol` | `"🐫 "` | El símbolo usado antes de mostrar la versión de OCaml. |
| `global_switch_indicator` | `""` | The format string used to represent global OPAM switch. | | `global_switch_indicator` | `""` | La cadena de formato usada para representar el interruptor global de OPAM. |
| `local_switch_indicator` | `"*"` | The format string used to represent local OPAM switch. | | `local_switch_indicator` | `"*"` | La cadena de formato usada para representar el interruptor local de OPAM. |
| `detect_extensions` | `["opam", "ml", "mli", "re", "rei"]` | Qué extensiones deberían activar este módulo. | | `detect_extensions` | `["opam", "ml", "mli", "re", "rei"]` | Qué extensiones deberían activar este módulo. |
| `detect_files` | `["dune", "dune-project", "jbuild", "jbuild-ignore", ".merlin"]` | Qué nombres de archivo deberían activar este módulo. | | `detect_files` | `["dune", "dune-project", "jbuild", "jbuild-ignore", ".merlin"]` | Qué nombres de archivo deberían activar este módulo. |
| `detect_folders` | `["_opam", "esy.lock"]` | Qué carpetas deberían activar este módulo. | | `detect_folders` | `["_opam", "esy.lock"]` | Qué carpetas deberían activar este módulo. |
| `style` | `"bold yellow"` | El estilo del módulo. | | `style` | `"bold yellow"` | El estilo del módulo. |
| `disabled` | `false` | Disables the `ocaml` module. | | `disabled` | `false` | Deshabilita el módulo `ocaml`. |
### Variables ### Variables
| Variable | Ejemplo | Descripción | | Variable | Ejemplo | Descripción |
| ---------------- | ------------ | ----------------------------------------------------------------- | | ---------------- | ------------ | --------------------------------------------------------------------------- |
| version | `v4.10.0` | La versión de `ocaml` | | version | `v4.10.0` | La versión de `ocaml` |
| switch_name | `my-project` | The active OPAM switch | | switch_name | `my-project` | El interruptor OPAM activo |
| switch_indicator | | Mirrors the value of `indicator` for currently active OPAM switch | | switch_indicator | | Refleja el valor de `indicator` para el interruptor OPAM activo actualmente |
| symbol | | Refleja el valor de la opción `symbol` | | symbol | | Refleja el valor de la opción `symbol` |
| style\* | | Refleja el valor de la opción `style` | | style\* | | Refleja el valor de la opción `style` |
@ -1830,7 +1830,7 @@ El módulo `openstack` muestra la nube actual y el proyecto OpenStack. El módul
| `format` | `"on [$symbol$cloud(\\($project\\))]($style) "` | El formato del módulo. | | `format` | `"on [$symbol$cloud(\\($project\\))]($style) "` | El formato del módulo. |
| `symbol` | `"☁️ "` | El símbolo usado antes de mostrar la nube OpenStack actual. | | `symbol` | `"☁️ "` | El símbolo usado antes de mostrar la nube OpenStack actual. |
| `style` | `"bold yellow"` | El estilo del módulo. | | `style` | `"bold yellow"` | El estilo del módulo. |
| `disabled` | `false` | Disables the `openstack` module. | | `disabled` | `false` | Deshabilita el módulo `openstack`. |
### Variables ### Variables
@ -2252,16 +2252,16 @@ disabled = false
## SHLVL ## 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 alcanza o supera el umbral especificado.
### Opciones ### Opciones
| Opción | Por defecto | Descripción | | Opción | Por defecto | Descripción |
| ----------- | ---------------------------- | ------------------------------------------------------------- | | ----------- | ---------------------------- | ----------------------------------------------------------------- |
| `threshold` | `2` | Mostrar el umbral. | | `threshold` | `2` | Mostrar el umbral. |
| `format` | `"[$symbol$shlvl]($style) "` | El formato del módulo. | | `format` | `"[$symbol$shlvl]($style) "` | El formato del módulo. |
| `symbol` | `"↕️ "` | The symbol used to represent the `SHLVL`. | | `symbol` | `"↕️ "` | El símbolo utilizado para representar el `SHLVL`. |
| `repeat` | `false` | Causes `symbol` to be repeated by the current `SHLVL` amount. | | `repeat` | `false` | Hace que el `symbol` se repita con la cantidad actual de `SHLVL`. |
| `style` | `"bold yellow"` | El estilo del módulo. | | `style` | `"bold yellow"` | El estilo del módulo. |
| `disabled` | `true` | Deshabilita el módulo `shlvl`. | | `disabled` | `true` | Deshabilita el módulo `shlvl`. |
@ -2269,7 +2269,7 @@ The `shlvl` module shows the current `SHLVL` ("shell level") environment variabl
| Variable | Ejemplo | Descripción | | 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` | | symbol | | Refleja el valor de la opción `symbol` |
| style\* | | Refleja el valor de la opción `style` | | style\* | | Refleja el valor de la opción `style` |
@ -2578,7 +2578,7 @@ El módulo `vagrant` muestra la versión instalada de Vagrant. Por defecto, el m
| `detect_files` | `["Vagrantfile"]` | Qué nombres de archivo deberían activar este módulo. | | `detect_files` | `["Vagrantfile"]` | Qué nombres de archivo deberían activar este módulo. |
| `detect_folders` | `[]` | Qué carpetas deberían activar este módulo. | | `detect_folders` | `[]` | Qué carpetas deberían activar este módulo. |
| `style` | `"cyan bold"` | El estilo del módulo. | | `style` | `"cyan bold"` | El estilo del módulo. |
| `disabled` | `false` | Disables the `vagrant` module. | | `disabled` | `false` | Deshabilita el módulo `vagrant`. |
### Variables ### Variables
@ -2601,22 +2601,22 @@ format = "via [⍱ $version](bold white) "
## VCSH ## VCSH
The `vcsh` module displays the current active VCSH repository. The module will be shown only if a repository is currently in use. El módulo `vcsh` muestra el repositorio VCSH activo actual. El módulo sólo se mostrará si un repositorio está actualmente en uso.
### Opciones ### Opciones
| Opción | Por defecto | Descripción | | Opción | Por defecto | Descripción |
| ---------- | -------------------------------- | ------------------------------------------------------ | | ---------- | -------------------------------- | ------------------------------------------------------------ |
| `symbol` | | The symbol used before displaying the repository name. | | `symbol` | | El símbolo usado antes de mostrar el nombre del repositorio. |
| `style` | `"bold yellow"` | El estilo del módulo. | | `style` | `"bold yellow"` | El estilo del módulo. |
| `format` | `"vcsh [$symbol$repo]($style) "` | El formato del módulo. | | `format` | `"vcsh [$symbol$repo]($style) "` | El formato del módulo. |
| `disabled` | `false` | Disables the `vcsh` module. | | `disabled` | `false` | Deshabilita el módulo `vcsh`. |
### Variables ### Variables
| Variable | Ejemplo | Descripción | | Variable | Ejemplo | Descripción |
| ----------- | ------------------------------------------- | -------------------------------------- | | ----------- | ----------------------------------------------------------- | -------------------------------------- |
| repositorio | `dotfiles` if in a VCSH repo named dotfiles | The active repository name | | repositorio | `dotfiles` si está en un repositorio VCSH nombrado dotfiles | El nombre del repositorio activo |
| symbol | | Refleja el valor de la opción `symbol` | | symbol | | Refleja el valor de la opción `symbol` |
| style\* | `black bold dimmed` | Refleja el valor de la opción `style` | | style\* | `black bold dimmed` | Refleja el valor de la opción `style` |
@ -2633,18 +2633,18 @@ format = "[🆅 $repo](bold blue) "
## Zig ## Zig
By default the the `zig` module shows the currently installed version of Zig. El módulo se mostrará si se cumplen alguna de las siguientes condiciones: Por defecto, el módulo `zig` muestra la versión instalada de Zig. El módulo se mostrará si se cumplen alguna de las siguientes condiciones:
- El directorio actual contiene un archivo `.zig` - El directorio actual contiene un archivo `.zig`
### Opciones ### Opciones
| Opción | Por defecto | Descripción | | Opción | Por defecto | Descripción |
| ------------------- | ------------------------------------ | ----------------------------------------------------- | | ------------------- | ------------------------------------ | ---------------------------------------------------- |
| `symbol` | `"↯ "` | The symbol used before displaying the version of Zig. | | `symbol` | `"↯ "` | El símbolo usado antes de mostrar la versión de Zig. |
| `style` | `"bold yellow"` | El estilo del módulo. | | `style` | `"bold yellow"` | El estilo del módulo. |
| `format` | `"via [$symbol($version )]($style)"` | El formato del módulo. | | `format` | `"via [$symbol($version )]($style)"` | El formato del módulo. |
| `disabled` | `false` | Disables the `zig` module. | | `disabled` | `false` | Deshabilita el módulo `zig`. |
| `detect_extensions` | `["zig"]` | Qué extensiones deberían activar este módulo. | | `detect_extensions` | `["zig"]` | Qué extensiones deberían activar este módulo. |
| `detect_files` | `[]` | Qué nombres de archivo deberían activar este módulo. | | `detect_files` | `[]` | Qué nombres de archivo deberían activar este módulo. |
| `detect_folders` | `[]` | Qué carpetas deberían activar este módulo. | | `detect_folders` | `[]` | Qué carpetas deberían activar este módulo. |
@ -2670,9 +2670,9 @@ symbol = "⚡️ "
## Comandos personalizados ## Comandos personalizados
The `custom` modules show the output of some arbitrary commands. Los módulos `personalizados` muestran la salida de algunos comandos arbitrarios.
These modules will be shown if any of the following conditions are met: Estos módulos se mostrarán si se cumplen alguna de las siguientes condiciones:
- El directorio actual contiene un archivo cuyo nombre está en `files` - 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 directorio cuyo nombre está en `directories`
@ -2681,34 +2681,34 @@ These modules will be shown if any of the following conditions are met:
::: consejo ::: consejo
Multiple custom modules can be defined by using a `.`. Múltiples módulos personalizados pueden definirse usando un `.` (punto).
::: :::
::: consejo ::: consejo
The order in which custom modules are shown can be individually set by including `${custom.foo}` in the top level `format` (as it includes a dot, you need to use `${...}`). By default, the `custom` module will simply show all custom modules in the order they were defined. El orden en el que se muestran los módulos personalizados se puede establecer individualmente incluyendo `${custom.foo}` en el `format` de nivel superior (ya que incluye un punto, necesita usar `${...}`). Por defecto, el módulo `personalizado` simplemente mostrará todos los módulos personalizados en el orden en que fueron definidos.
::: :::
::: consejo ::: consejo
[Issue #1252](https://github.com/starship/starship/discussions/1252) contains examples of custom modules. If you have an interesting example not covered there, feel free to share it there! [El problema #1252](https://github.com/starship/starship/discussions/1252) contiene ejemplos de módulos personalizados. ¡Si tienes un ejemplo interesante no cubierto allí, no dudes en compartirlo!
::: :::
### Opciones ### Opciones
| Opción | Por defecto | Descripción | | Opción | Por defecto | Descripción |
| ------------- | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | | ------------- | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `comando` | | The command whose output should be printed. The command will be passed on stdin to the shell. | | `comando` | | El comando cuya salida debe ser impresa. El comando se pasará en stdin al intérprete de comandos. |
| `cuando` | | A shell command used as a condition to show the module. The module will be shown if the command returns a `0` status code. | | `cuando` | | Comando del intérprete de comandos 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) | | `shell` | | [Ver abajo](#custom-command-shell) |
| `descripción` | `"<custom module>"` | The description of the module that is shown when running `starship explain`. | | `descripción` | `"<custom module>"` | La descripción del módulo que se muestra al ejecutar `starship explain`. |
| `archivos` | `[]` | The files that will be searched in the working directory for a match. | | `archivos` | `[]` | Los archivos que se buscarán en el directorio de trabajo para obtener una coincidencia. |
| `directorios` | `[]` | The directories that will be searched in the working directory for a match. | | `directorios` | `[]` | Los directorios que se buscarán en el directorio de trabajo para una coincidencia. |
| `extensiones` | `[]` | The extensions that will be searched in the working directory for a match. | | `extensiones` | `[]` | Las extensiones que se buscarán en el directorio de trabajo para obtener una coincidencia. |
| `symbol` | `""` | The symbol used before displaying the command output. | | `symbol` | `""` | El símbolo usado antes de mostrar la salida del comando. |
| `style` | `"bold green"` | El estilo del módulo. | | `style` | `"bold green"` | El estilo del módulo. |
| `format` | `"[$symbol($output )]($style)"` | El formato del módulo. | | `format` | `"[$symbol($output )]($style)"` | El formato del módulo. |
| `disabled` | `false` | Deshabilita este `módulo` personalizado. | | `disabled` | `false` | Deshabilita este `módulo` personalizado. |
@ -2716,8 +2716,8 @@ The order in which custom modules are shown can be individually set by including
### Variables ### Variables
| Variable | Descripción | | Variable | Descripción |
| --------- | -------------------------------------- | | --------- | ----------------------------------------------------------- |
| salida | The output of shell command in `shell` | | salida | La salida del comando del intérprete de comandos en `shell` |
| symbol | Refleja el valor de la opción `symbol` | | symbol | Refleja el valor de la opción `symbol` |
| style\* | Refleja el valor de la opción `style` | | style\* | Refleja el valor de la opción `style` |
@ -2725,30 +2725,30 @@ The order in which custom modules are shown can be individually set by including
#### Comando personalizado del intérprete de comandos #### Comando personalizado del intérprete de comandos
`shell` accepts a non-empty list of strings, where: `shell` acepta una lista no vacía de cadenas, donde:
- La primera cadena es la ruta al intérprete de comandos a usar para ejecutar el comando. - La primera cadena es la ruta al intérprete de comandos a usar para ejecutar el comando.
- Otros argumentos siguientes que son pasados al shell. - Otros argumentos siguientes que son pasados al shell.
If unset, it will fallback to STARSHIP_SHELL and then to "sh" on Linux, and "cmd /C" on Windows. Si no está activado, se retornará a STARSHIP_SHELL y luego a "sh" en Linux, y "cmd /C" en Windows.
The `command` will be passed in on stdin. El `comando` será pasado en stdin.
If `shell` is not given or only contains one element and Starship detects PowerShell will be used, the following arguments will automatically be added: `-NoProfile -Command -`. This behavior can be avoided by explicitly passing arguments to the shell, e.g. Si no se da el `shell` o solo contiene un elemento y Starship detecta PowerShell los siguientes argumentos se añadirán automáticamente: `-NoProfile -Command -`. Este comportamiento puede evitarse pasando explícitamente argumentos al intérprete de comandos, p.ej.
```toml ```toml
shell = ["pwsh", "-Command", "-"] shell = ["pwsh", "-Command", "-"]
``` ```
::: warning Make sure your custom shell configuration exits gracefully ::: advertencia Asegúrate de que tu configuración personalizada del intérprete de comandos salga con éxito
If you set a custom command, make sure that the default Shell used by starship will properly execute the command with a graceful exit (via the `shell` option). Si estableces un comando personalizado, asegúrate de que el intérprete de comandos por defecto usado por Starship ejecutará correctamente el comando con una salida elegante (a través de la opción `shell`).
For example, PowerShell requires the `-Command` parameter to execute a one liner. Omitting this parameter might throw starship into a recursive loop where the shell might try to load a full profile environment with starship itself again and hence re-execute the custom command, getting into a never ending loop. Por ejemplo, PowerShell requiere el parámetro `-Command` para ejecutar una sola línea. Omitir este parámetro puede arrojar a Starship a un bucle recursivo donde el intérprete de comandos podría intentar cargar un entorno de perfil completo con Starship en sí misma y volver a ejecutar el comando personalizado, entrando en un bucle infinito.
Parameters similar to `-NoProfile` in PowerShell are recommended for other shells as well to avoid extra loading time of a custom profile on every starship invocation. Se recomiendan parámetros similares a `-NoProfile` en PowerShell para otros intérprete de comandos también para evitar tiempo extra de carga de un perfil personalizado en cada invocación de Starship.
Automatic detection of shells and proper parameters addition are currently implemented, but it's possible that not all shells are covered. [Please open an issue](https://github.com/starship/starship/issues/new/choose) with shell details and starship configuration if you hit such scenario. La detección automática de intérpretes de comandos y la adición adecuada de parámetros están actualmente implementados, pero es posible que no todos los intérpretes de comandos estén cubiertos. Por favor, [abre un problema](https://github.com/starship/starship/issues/new/choose) con los detalles del intérprete de comandos y la configuración de Starship si te encuentras en tal escenario.
::: :::

4
docs/es-ES/faq/README.md
View File

@ -91,6 +91,6 @@ Si Starship fue instalado usando un gestor de paquetes, por favor refiérete a s
Si Starship fue instalado usando el script `curl | bash`, el siguiente comando eliminará el binario: Si Starship fue instalado usando el script `curl | bash`, el siguiente comando eliminará el binario:
```sh ```sh
# Locate and delete the starship binary # Localiza y elimina el binario de starship
bash -c 'rm "$(which starship)"' sh -c 'rm "$(which starship)"'
``` ```

2
docs/es-ES/guide/README.md
View File

@ -160,7 +160,7 @@
```sh ```sh
curl -fsSL https://starship.rs/install.sh | bash curl -fsSL https://starship.rs/install.sh | bash
``` ```
To update the Starship itself, rerun the above script. It will replace the current version without touching Starship's configuration. Para actualizar Starship, vuelve a ejecutar el guión anterior. Reemplazará la versión actual sin tocar la configuración de Starship.
#### Instalar con un gestor de paquetes #### Instalar con un gestor de paquetes

2
docs/es-ES/installing/README.md
View File

@ -45,7 +45,7 @@ curl -fsSL https://starship.rs/install.sh | bash -s -- -b /data/data/com.termux/
nix-env -iA nixos.starship nix-env -iA nixos.starship
``` ```
#### Declarative, single user, via [home-manager](https://github.com/nix-community/home-manager) #### Declarativo, usuario único, a través de [home-manager](https://github.com/nix-community/home-manager)
Activa el módulo `programs.starship` en tu archivo `home.nix` y añade tus ajustes Activa el módulo `programs.starship` en tu archivo `home.nix` y añade tus ajustes

2
docs/fr-FR/README.md
View File

@ -45,7 +45,7 @@ description: Starship est un invite minimaliste, ultra-rapide et hautement perso
#### Installer via le gestionnaire de paquets #### Installer via le gestionnaire de paquets
With [Homebrew](https://brew.sh/): Avec [Homebrew](https://brew.sh/):
```sh ```sh
brew install starship brew install starship

222
docs/fr-FR/config/README.md
View File

@ -260,7 +260,7 @@ When using [awsu](https://github.com/kreuzwerker/awsu) the profile is read from
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemples ### Exemples
@ -305,7 +305,7 @@ symbol = "🅰 "
## Battery ## Battery
The `battery` module shows how charged the device's battery is and its current charging status. The module is only visible when the device's battery is below 10%. Le module `battery` montre à quel point la batterie de l'appareil est chargée et son état de charge actuel. Ce module n'est visible que lorsque la batterie de l'appareil est inférieure à 10%.
### Options ### Options
@ -333,7 +333,7 @@ discharging_symbol = "💀 "
### Indicateur de batterie ### 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 ```toml
[[battery.display]] [[battery.display]]
@ -343,7 +343,7 @@ style = "bold red"
#### Options #### Options
The `display` option is an array of the following table. L'option `display` est une array de la table suivante.
| Option | Description | | Option | Description |
| ----------- | -------------------------------------------------- | | ----------- | -------------------------------------------------- |
@ -367,14 +367,14 @@ style = "bold yellow"
## Caractères ## 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 couleur (`red`/`green`)
- changement de forme (`❯`/`✖`) - 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).
::: warning `error_symbol` is not supported on elvish shell. ::: ::: warning `error_symbol` is not supported on elvish shell. :::
@ -442,7 +442,7 @@ The `cmake` module shows the currently installed version of CMake. By default th
| `detect_files` | `["CMakeLists.txt", "CMakeCache.txt"]` | Which filenames should trigger this module | | `detect_files` | `["CMakeLists.txt", "CMakeCache.txt"]` | Which filenames should trigger this module |
| `detect_folders` | `[]` | Which folders should trigger this module | | `detect_folders` | `[]` | Which folders should trigger this module |
| `style` | `"bold blue"` | Le style du module. | | `style` | `"bold blue"` | Le style du module. |
| `disabled` | `false` | Disables the `cmake` module. | | `disabled` | `false` | Désactive le module `cmake`. |
### Variables ### Variables
@ -452,19 +452,19 @@ The `cmake` module shows the currently installed version of CMake. By default th
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
## Temps d'exécution ## 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 ### Options
@ -480,7 +480,7 @@ Bash users who need preexec-like functionality can use [rcaloras's bash_preexec
::: tip ::: 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`. L'affichage des notifications de bureau nécessite que starship soit compilé avec la prise en charge de `rust-notify`. Vérifiez si starship supporte les notifications en exécutant `STARSHIP_LOG=debug starship module cmd_duration -d 60000` lorsque `show_notifications` est défini à `true`.
::: :::
@ -491,7 +491,7 @@ Showing desktop notifications requires starship to be built with `rust-notify` s
| duration | `16m40s` | Le temps nécessaire pour exécuter la commande | | duration | `16m40s` | Le temps nécessaire pour exécuter la commande |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -505,11 +505,11 @@ format = "underwent [$duration](bold yellow)"
## Conda ## 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 ::: 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`.
::: :::
@ -532,7 +532,7 @@ This does not suppress conda's own prompt modifier, you may want to run `conda c
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -545,7 +545,7 @@ format = "[$symbol$environment](dimmed green) "
## Crystal ## Crystal
The `crystal` module shows the currently installed version of Crystal. By default the module will be shown if any of the following conditions are met: Le module `crystal` affiche la version actuellement installée de Crystal. By default the module will be shown if any of the following conditions are met:
- Le répertoire courant contient un fichier `shard.yml` - Le répertoire courant contient un fichier `shard.yml`
- Le répertoire courant contient un fichier `.cr` - Le répertoire courant contient un fichier `.cr`
@ -560,7 +560,7 @@ The `crystal` module shows the currently installed version of Crystal. By defaul
| `detect_files` | `["shard.yml"]` | Which filenames should trigger this module. | | `detect_files` | `["shard.yml"]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. | | `detect_folders` | `[]` | Which folders should trigger this module. |
| `format` | `"via [$symbol($version )]($style)"` | Format du module. | | `format` | `"via [$symbol($version )]($style)"` | Format du module. |
| `disabled` | `false` | Disables the `crystal` module. | | `disabled` | `false` | Désactive le module `crystal`. |
### Variables ### Variables
@ -570,7 +570,7 @@ The `crystal` module shows the currently installed version of Crystal. By defaul
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -583,7 +583,7 @@ format = "via [✨ $version](bold blue) "
## Dart ## Dart
The `dart` module shows the currently installed version of Dart. By default the module will be shown if any of the following conditions are met: Le module `dart` affiche la version courante installée de Dart. By default the module will be shown if any of the following conditions are met:
- Le répertoire courant contient un fichier `.dart` - Le répertoire courant contient un fichier `.dart`
- Le répertoire courant contient un répertoire `.dart_tool` - Le répertoire courant contient un répertoire `.dart_tool`
@ -599,7 +599,7 @@ The `dart` module shows the currently installed version of Dart. By default the
| `detect_files` | `["pubspec.yaml", "pubspec.yml", "pubspec.lock"]` | Which filenames should trigger this module. | | `detect_files` | `["pubspec.yaml", "pubspec.yml", "pubspec.lock"]` | Which filenames should trigger this module. |
| `detect_folders` | `[".dart_tool"]` | Which folders should trigger this module. | | `detect_folders` | `[".dart_tool"]` | Which folders should trigger this module. |
| `style` | `"bold blue"` | Le style du module. | | `style` | `"bold blue"` | Le style du module. |
| `disabled` | `false` | Disables the `dart` module. | | `disabled` | `false` | Désactive le module `dart`. |
### Variables ### Variables
@ -609,7 +609,7 @@ The `dart` module shows the currently installed version of Dart. By default the
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -622,11 +622,11 @@ format = "via [🔰 $version](bold red) "
## Dossier ## 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é aux 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 tronqué, vous verrez un nom raccourci de chaque dossier basé 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 ### Options
@ -643,7 +643,7 @@ For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, an
| `home_symbol` | `"~"` | The symbol indicating home directory. | | `home_symbol` | `"~"` | The symbol indicating home directory. |
<details> <details>
<summary>This module has a few advanced configuration options that control how the directory is displayed.</summary> <summary>Ce module possède quelques options de configuration avancées qui contrôlent l'affichage du répertoire.</summary>
| Options avancées | Défaut | Description | | Options avancées | Défaut | Description |
| --------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | --------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@ -670,7 +670,7 @@ For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, an
| path | `"D:/Projects"` | Le chemin du répertoire courant | | path | `"D:/Projects"` | Le chemin du répertoire courant |
| style\* | `"black bold dimmed"` | Reflète la valeur de l'option `style` | | style\* | `"black bold dimmed"` | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -697,7 +697,7 @@ The `docker_context` module shows the currently active [Docker context](https://
| `detect_files` | `["docker-compose.yml", "docker-compose.yaml", "Dockerfile"]` | Which filenames should trigger this module (needs `only_with_files` to be true). | | `detect_files` | `["docker-compose.yml", "docker-compose.yaml", "Dockerfile"]` | Which filenames should trigger this module (needs `only_with_files` to be true). |
| `detect_folders` | `[]` | Which folders should trigger this module (needs `only_with_files` to be true). | | `detect_folders` | `[]` | Which folders should trigger this module (needs `only_with_files` to be true). |
| `style` | `"blue bold"` | Le style du module. | | `style` | `"blue bold"` | Le style du module. |
| `disabled` | `false` | Disables the `docker_context` module. | | `disabled` | `false` | Désactive le module `docker_context`. |
### Variables ### Variables
@ -707,7 +707,7 @@ The `docker_context` module shows the currently active [Docker context](https://
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -751,7 +751,7 @@ The module will also show the Target Framework Moniker (<https://docs.microsoft.
| `detect_files` | `["global.json", "project.json", "Directory.Build.props", "Directory.Build.targets", "Packages.props"]` | Which filenames should trigger this module. | | `detect_files` | `["global.json", "project.json", "Directory.Build.props", "Directory.Build.targets", "Packages.props"]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this modules. | | `detect_folders` | `[]` | Which folders should trigger this modules. |
| `style` | `"bold blue"` | Le style du module. | | `style` | `"bold blue"` | Le style du module. |
| `disabled` | `false` | Disables the `dotnet` module. | | `disabled` | `false` | Désactive le module `dotnet`. |
### Variables ### Variables
@ -762,7 +762,7 @@ The module will also show the Target Framework Moniker (<https://docs.microsoft.
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -777,7 +777,7 @@ heuristic = false
## Elixir ## Elixir
The `elixir` module shows the currently installed version of Elixir and Erlang/OTP. By default the module will be shown if any of the following conditions are met: Le module `elixir` affiche la version actuellement installé d'Elixir et Erlang/OTP. By default the module will be shown if any of the following conditions are met:
- Le répertoire courant contient un fichier `mix.exs`. - Le répertoire courant contient un fichier `mix.exs`.
@ -802,7 +802,7 @@ The `elixir` module shows the currently installed version of Elixir and Erlang/O
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -843,7 +843,7 @@ The `elm` module shows the currently installed version of Elm. By default the mo
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -879,7 +879,7 @@ The `env_var` module displays the current value of a selected environment variab
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | `black bold dimmed` | Reflète la valeur de l'option `style` | | style\* | `black bold dimmed` | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -918,7 +918,7 @@ The `erlang` module shows the currently installed version of Erlang/OTP. By defa
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -954,7 +954,7 @@ The `gcloud` module shows the current configuration for [`gcloud`](https://cloud
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemples ### Exemples
@ -1016,7 +1016,7 @@ The `git_branch` module shows the active branch of the repo in your current dire
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -1052,7 +1052,7 @@ The `git_commit` module shows the current commit hash and also the tag (if any)
| hash | `b703eb3` | The current git commit hash | | hash | `b703eb3` | The current git commit hash |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -1092,7 +1092,7 @@ The `git_state` module will show in directories which are part of a git reposito
| progress_total | `2` | The total operation progress | | progress_total | `2` | The total operation progress |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -1143,7 +1143,7 @@ The following variables can be used in `format`:
| `deleted` | Displays `deleted` when a file's deletion has been added to the staging area. | | `deleted` | Displays `deleted` when a file's deletion has been added to the staging area. |
| style\* | Reflète la valeur de l'option `style` | | style\* | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
The following variables can be used in `diverged`: The following variables can be used in `diverged`:
@ -1220,7 +1220,7 @@ The `golang` module shows the currently installed version of Golang. By default
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -1258,7 +1258,7 @@ The `helm` module shows the currently installed version of Helm. By default the
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -1290,7 +1290,7 @@ The `hostname` module shows the system hostname.
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -1331,7 +1331,7 @@ The `java` module shows the currently installed version of Java. By default the
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -1370,7 +1370,7 @@ This module is not supported on tcsh.
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -1410,7 +1410,7 @@ The `julia` module shows the currently installed version of Julia. By default th
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -1448,7 +1448,7 @@ The `kotlin` module shows the currently installed version of Kotlin. By default
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -1473,7 +1473,7 @@ Displays the current Kubernetes context name and, if set, the namespace from the
::: tip ::: 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.
::: :::
@ -1496,7 +1496,7 @@ This module is disabled by default. To enable it, set `disabled` to `false` in y
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -1558,7 +1558,7 @@ The `lua` module shows the currently installed version of Lua. By default the mo
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -1577,7 +1577,7 @@ 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. Ce module est désactivé par défaut. Pour l'activer, configurez `disabled` sur `false` dans votre fichier de configuration.
::: :::
@ -1639,7 +1639,7 @@ The `hg_branch` module shows the active branch of the repo in your current direc
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -1681,7 +1681,7 @@ The `nim` module shows the currently installed version of Nim. By default the mo
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -1717,7 +1717,7 @@ The `nix_shell` module shows the nix-shell environment. The module will be shown
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -1762,7 +1762,7 @@ The `nodejs` module shows the currently installed version of NodeJS. By default
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -1808,7 +1808,7 @@ The `ocaml` module shows the currently installed version of OCaml. By default th
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -1841,7 +1841,7 @@ The `openstack` module shows the current OpenStack cloud and project. The module
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -1889,7 +1889,7 @@ The `package` module is shown when the current directory is the repository for a
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -1967,7 +1967,7 @@ The `php` module shows the currently installed version of PHP. By default the mo
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -1980,7 +1980,7 @@ format = "via [🔹 $version](147 bold) "
## PureScript ## PureScript
The `purescript` module shows the currently installed version of PureScript version. By default the module will be shown if any of the following conditions are met: Le module `purescript` affiche la version courante de Purescript installée. By default the module will be shown if any of the following conditions are met:
- Le répertoire courant contient un fichier `spago.dhall` - Le répertoire courant contient un fichier `spago.dhall`
- The current directory contains a file with the `.purs` extension - The current directory contains a file with the `.purs` extension
@ -1995,7 +1995,7 @@ The `purescript` module shows the currently installed version of PureScript vers
| `detect_files` | `["spago.dhall"]` | Which filenames should trigger this module. | | `detect_files` | `["spago.dhall"]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. | | `detect_folders` | `[]` | Which folders should trigger this module. |
| `style` | `"bold white"` | Le style du module. | | `style` | `"bold white"` | Le style du module. |
| `disabled` | `false` | Disables the `purescript` module. | | `disabled` | `false` | Désactive le module `purescript`. |
### Variables ### Variables
@ -2005,7 +2005,7 @@ The `purescript` module shows the currently installed version of PureScript vers
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -2027,10 +2027,10 @@ By default the module will be shown if any of the following conditions are met:
- The current directory contains a `.python-version` file - The current directory contains a `.python-version` file
- The current directory contains a `Pipfile` file - The current directory contains a `Pipfile` file
- The current directory contains a `__init__.py` file - The current directory contains a `__init__.py` file
- The current directory contains a `pyproject.toml` file - Le répertoire courant contient un fichier `pyproject.toml`
- The current directory contains a `requirements.txt` file - Le répertoire courant contient un fichier `requirements.txt`
- The current directory contains a `setup.py` file - Le répertoire courant contient un fichier `setup.py`
- The current directory contains a `tox.ini` file - Le répertoire courant contient un fichier `tox.ini`
- The current directory contains a file with the `.py` extension. - The current directory contains a file with the `.py` extension.
- A virtual environment is currently activated - A virtual environment is currently activated
@ -2095,7 +2095,7 @@ detect_extensions = []
## Ruby ## Ruby
By default the `ruby` module shows the currently installed version of Ruby. The module will be shown if any of the following conditions are met: By default the `ruby` module shows the currently installed version of Ruby. Le module est affiché si l'une de ces conditions est remplie :
- The current directory contains a `Gemfile` file - The current directory contains a `Gemfile` file
- The current directory contains a `.ruby-version` file - The current directory contains a `.ruby-version` file
@ -2121,7 +2121,7 @@ By default the `ruby` module shows the currently installed version of Ruby. The
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -2134,7 +2134,7 @@ symbol = "🔺 "
## Rust ## Rust
By default the `rust` module shows the currently installed version of Rust. The module will be shown if any of the following conditions are met: By default the `rust` module shows the currently installed version of Rust. Le module est affiché si l'une de ces conditions est remplie :
- The current directory contains a `Cargo.toml` file - The current directory contains a `Cargo.toml` file
- The current directory contains a file with the `.rs` extension - The current directory contains a file with the `.rs` extension
@ -2159,7 +2159,7 @@ By default the `rust` module shows the currently installed version of Rust. The
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -2198,7 +2198,7 @@ The `scala` module shows the currently installed version of Scala. By default th
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -2215,7 +2215,7 @@ The `shell` module shows an indicator for currently used shell.
::: tip ::: 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.
::: :::
@ -2273,7 +2273,7 @@ The `shlvl` module shows the current `SHLVL` ("shell level") environment variabl
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -2307,7 +2307,7 @@ The `singularity` module shows the current singularity image, if inside a contai
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -2324,7 +2324,7 @@ The `status` module displays the exit code of the previous command. The module w
::: tip ::: 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.
::: :::
@ -2358,7 +2358,7 @@ This module is disabled by default. To enable it, set `disabled` to `false` in y
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -2377,7 +2377,7 @@ disabled = false
## Swift ## Swift
By default the `swift` module shows the currently installed version of Swift. The module will be shown if any of the following conditions are met: By default the `swift` module shows the currently installed version of Swift. Le module est affiché si l'une de ces conditions est remplie :
- The current directory contains a `Package.swift` file - The current directory contains a `Package.swift` file
- The current directory contains a file with the `.swift` extension - The current directory contains a file with the `.swift` extension
@ -2402,7 +2402,7 @@ By default the `swift` module shows the currently installed version of Swift. Th
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -2449,7 +2449,7 @@ By default the module will be shown if any of the following conditions are met:
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -2473,36 +2473,36 @@ format = "[🏎💨 $workspace]($style) "
## Temps ## Temps
The `time` module shows the current **local** time. The `format` configuration value is used by the [`chrono`](https://crates.io/crates/chrono) crate to control how the time is displayed. Take a look [at the chrono strftime docs](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) to see what options are available. Le module `time` affiche l'heure actuelle **localement**. La valeur de `format` est utilisée par le package [`chrono`](https://crates.io/crates/chrono) pour contrôler la façon dont l'heure est affichée. Consultez la [doc de chrono strftime](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) pour découvrir les options disponibles.
::: tip ::: 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 ### Options
| Option | Défaut | Description | | Option | Défaut | Description |
| ----------------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | ----------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `format` | `"at [$time]($style) "` | The format string for the module. | | `format` | `"at [$time]($style) "` | The format string for the module. |
| `use_12hr` | `false` | Enables 12 hour formatting | | `use_12hr` | `false` | Activer le format 12h |
| `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. | | `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"` | The style for the module time | | `style` | `"bold yellow"` | Le style utilisé par le module |
| `utc_time_offset` | `"local"` | Sets the UTC offset to use. Range from -24 &lt; x &lt; 24. Allows floats to accommodate 30/45 minute timezone offsets. | | `utc_time_offset` | `"local"` | Définir le décalage horaire UTC à utiliser. Range from -24 &lt; x &lt; 24. Accepte des nombres décimaux pour s'adapter aux décalages de 30/45 minutes. |
| `disabled` | `true` | Disables the `time` module. | | `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 | | `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. If `use_12hr` is `true`, then `time_format` defaults to `"%r"`. Sinon, il est défini comme `"%T"`. Manually setting `time_format` will override the `use_12hr` setting.
### Variables ### Variables
| Variable | Exemple | Description | | 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` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -2517,14 +2517,14 @@ utc_time_offset = "-5"
time_range = "10:00:00-14:00:00" time_range = "10:00:00-14:00:00"
``` ```
## Username ## Nom d'utilisateur
The `username` module shows active user's username. The module will be shown if any of the following conditions are met: Le module `username` affiche le nom d'utilisateur de l'utilisateur actif. Le module est affiché si l'une de ces conditions est remplie :
- The current user is root - L'utilisateur courant est root
- The current user isn't the same as the one that is logged in - L'utilisateur courant est différent de celui connecté
- The user is currently connected as an SSH session - L'utilisateur est actuellement connecté à une session SSH
- The variable `show_always` is set to true - La variable `show_always` a comme valeur true
::: tip ::: tip
@ -2535,12 +2535,12 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
### Options ### Options
| Option | Défaut | Description | | Option | Défaut | Description |
| ------------- | ----------------------- | ------------------------------------- | | ------------- | ----------------------- | ------------------------------------------------ |
| `style_root` | `"bold green"` | The style used when the user is root. | | `style_root` | `"bold green"` | Le style utilisé quand l'utilisateur est root. |
| `style_user` | `"bold yellow"` | The style used for non-root users. | | `style_user` | `"bold yellow"` | Le style utilisé pour les utilisateurs non-root. |
| `format` | `"[$user]($style) in "` | Format du module. | | `format` | `"[$user]($style) in "` | Format du module. |
| `show_always` | `false` | Always shows the `username` module. | | `show_always` | `false` | Toujours afficher le module `username`. |
| `disabled` | `false` | Disables the `username` module. | | `disabled` | `false` | Désactiver le module `username`. |
### Variables ### Variables
@ -2588,7 +2588,7 @@ The `vagrant` module shows the currently installed version of Vagrant. By defaul
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -2620,7 +2620,7 @@ The `vcsh` module displays the current active VCSH repository. The module will b
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | `black bold dimmed` | Reflète la valeur de l'option `style` | | style\* | `black bold dimmed` | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -2633,7 +2633,7 @@ format = "[🆅 $repo](bold blue) "
## Zig ## Zig
By default the the `zig` module shows the currently installed version of Zig. The module will be shown if any of the following conditions are met: By default the the `zig` module shows the currently installed version of Zig. Le module est affiché si l'une de ces conditions est remplie :
- The current directory contains a `.zig` file - The current directory contains a `.zig` file
@ -2657,7 +2657,7 @@ By default the the `zig` module shows the currently installed version of Zig. Th
| symbol | | Reflète la valeur de l'option `symbol` | | symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` | | style\* | | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
### Exemple ### Exemple
@ -2721,13 +2721,13 @@ The order in which custom modules are shown can be individually set by including
| symbol | Reflète la valeur de l'option `symbol` | | symbol | Reflète la valeur de l'option `symbol` |
| style\* | Reflète la valeur de l'option `style` | | style\* | Reflète la valeur de l'option `style` |
\*: This variable can only be used as a part of a style string \* : Cette variable ne peut être utilisée que comme partie d'une chaîne de style
#### Commandes shell personnalisées #### Commandes shell personnalisées
`shell` accepts a non-empty list of strings, where: `shell` accepte une liste de chaînes non vide, où:
- 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. - 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. If unset, it will fallback to STARSHIP_SHELL and then to "sh" on Linux, and "cmd /C" on Windows.

22
docs/fr-FR/faq/README.md
View File

@ -38,7 +38,7 @@ NUM_JOBS=$(jobs -p | wc -l)
PS1="$(starship prompt --status=$STATUS --jobs=$NUM_JOBS)" PS1="$(starship prompt --status=$STATUS --jobs=$NUM_JOBS)"
``` ```
The [Bash implementation](https://github.com/starship/starship/blob/master/src/init/starship.bash) built into Starship is slightly more complex to allow for advanced features like the [Command Duration module](https://starship.rs/config/#command-duration) and to ensure that Starship is compatible with pre-installed Bash configurations. [L'implémentation Bash](https://github.com/starship/starship/blob/master/src/init/starship.bash) intégrée dans Starship est légèrement plus complexe pour permettre des fonctionnalités avancées comme le [module Durée de commande](https://starship.rs/config/#command-duration) et pour s'assurer que Starship est compatible avec les configurations Bash préinstallées.
Pour une liste de tous les flags acceptés par `starship`, utilisez la commande suivante : Pour une liste de tous les flags acceptés par `starship`, utilisez la commande suivante :
@ -60,37 +60,37 @@ curl -fsSL https://starship.rs/install.sh | bash -s -- --platform unknown-linux-
If you see symbols that you don't recognise you can use `starship explain` to explain the currently showing modules. If you see symbols that you don't recognise you can use `starship explain` to explain the currently showing modules.
## Why don't I see a glyph symbol in my prompt? ## Pourquoi ne vois-je pas de glyphe dans mon invite?
The most common cause of this is system misconfiguration. Some Linux distros in particular do not come with font support out-of-the-box. You need to ensure that: La cause la plus commune est la mauvaise configuration du système. Certaines distributions Linux ne sont pas équipées du support de police 'out of the box'. Vous devez vous assurer que:
- Votre locale est définie à une valeur UTF-8, comme `de_DE.UTF-8` ou `ja_JP.UTF-8`. Si `LC_ALL` n'est pas une valeur UTF-8, [vous aurez besoin de la modifier](https://www.tecmint.com/set-system-locales-in-linux/). - Votre locale est définie à une valeur UTF-8, comme `de_DE.UTF-8` ou `ja_JP.UTF-8`. Si `LC_ALL` n'est pas une valeur UTF-8, [vous aurez besoin de la modifier](https://www.tecmint.com/set-system-locales-in-linux/).
- Vous avez une police emoji installée. La plupart des systèmes sont fournis avec une police emoji par défaut, mais certains (notamment Arch Linux) ne le font pas. Vous pouvez habituellement en installer un par le biais du gestionnaire de paquets de votre système -[noto emoji](https://www.google.com/get/noto/help/emoji/) est un choix populaire. - Vous avez une police emoji installée. La plupart des systèmes sont fournis avec une police emoji par défaut, mais certains (notamment Arch Linux) ne le font pas. Vous pouvez habituellement en installer un par le biais du gestionnaire de paquets de votre système -[noto emoji](https://www.google.com/get/noto/help/emoji/) est un choix populaire.
- Vous utilisez une police [Nerd Font](https://www.nerdfonts.com/). - Vous utilisez une police [Nerd Font](https://www.nerdfonts.com/).
To test your system, run the following commands in a terminal: Pour tester votre système, exécutez les commandes suivantes dans un terminal :
```sh ```sh
echo -e "\xf0\x9f\x90\x8d" echo -e "\xf0\x9f\x90\x8d"
echo -e "\xee\x82\xa0" echo -e "\xee\x82\xa0"
``` ```
The first line should produce a [snake emoji](https://emojipedia.org/snake/), while the second should produce a [powerline branch symbol (e0a0)](https://github.com/ryanoasis/powerline-extra-symbols#glyphs). La première ligne doit produire un emoji [serpent](https://emojipedia.org/snake/), tandis que la seconde doit produire un symbole [de branche powerline (e0a0)](https://github.com/ryanoasis/powerline-extra-symbols#glyphs).
If either symbol fails to display correctly, your system is still misconfigured. Unfortunately, getting font configuration correct is sometimes difficult. Users on the Discord may be able to help. If both symbols display correctly, but you still don't see them in starship, [file a bug report!](https://github.com/starship/starship/issues/new/choose) Si l'un ou l'autre des symboles ne parvient pas à s'afficher correctement, votre système est toujours mal configuré. Malheureusement, il est parfois difficile d'obtenir une configuration correcte. Les utilisateurs sur Discord peuvent être en mesure d'aider. Si les deux symboles s'affichent correctement, mais vous ne les voyez toujours pas dans starship, [soumettez un rapport de bogue !](https://github.com/starship/starship/issues/new/choose)
## How do I uninstall Starship? ## Comment désinstaller Starship ?
Starship is just as easy to uninstall as it is to install in the first place. Starship est tout aussi facile à désinstaller que d'installer.
1. Supprimez les lignes de la configuration de votre shell (par exemple `~/.bashrc`) utilisées pour initialiser Starship. 1. Supprimez les lignes de la configuration de votre shell (par exemple `~/.bashrc`) utilisées pour initialiser Starship.
1. Supprimer l'exécutable de Starship. 1. Supprimer l'exécutable de Starship.
If Starship was installed using a package manager, please refer to their docs for uninstallation instructions. Si Starship a été installé à l'aide d'un gestionnaire de paquets, veuillez vous référer à leur documentation pour les instructions de désinstallation.
If Starship was installed using the `curl | bash` script, the following command will delete the binary: Si Starship a été installé en utilisant le script `curl | bash` , la commande suivante supprimera l'exécutable :
```sh ```sh
# Locate and delete the starship binary # Locate and delete the starship binary
bash -c 'rm "$(which starship)"' sh -c 'rm "$(which starship)"'
``` ```

6
docs/fr-FR/installing/README.md
View File

@ -37,7 +37,7 @@ curl -fsSL https://starship.rs/install.sh | bash -s -- -b /data/data/com.termux/
## [Nix](https://nixos.wiki/wiki/Nix) ## [Nix](https://nixos.wiki/wiki/Nix)
### Getting the Binary ### Obtention du binaire
#### Impératif #### Impératif
@ -45,7 +45,7 @@ curl -fsSL https://starship.rs/install.sh | bash -s -- -b /data/data/com.termux/
nix-env -iA nixos.starship nix-env -iA nixos.starship
``` ```
#### Declarative, single user, via [home-manager](https://github.com/nix-community/home-manager) #### Déclaration, utilisateur unique, via [home-manager](https://github.com/nix-community/home-manager)
Enable the `programs.starship` module in your `home.nix` file, and add your settings Enable the `programs.starship` module in your `home.nix` file, and add your settings
@ -77,7 +77,7 @@ home-manager switch
#### Déclaration, au niveau du système, avec NixOS #### Déclaration, au niveau du système, avec NixOS
Add `pkgs.starship` to `environment.systemPackages` in your `configuration.nix`, then run Ajoutez `pkgs.starship` à `environment.systemPackages` dans votre `configuration.nix`, puis exécutez
```sh ```sh
sudo nixos-rebuild switch sudo nixos-rebuild switch

2
docs/it-IT/README.md
View File

@ -45,7 +45,7 @@ description: Starship è il prompt minimalista, super veloce ed estremamente per
#### Installa con Package Manager #### Installa con Package Manager
With [Homebrew](https://brew.sh/): Con [Homebrew](https://brew.sh/):
```sh ```sh
brew install starship brew install starship

20
docs/it-IT/faq/README.md
View File

@ -38,7 +38,7 @@ NUM_JOBS=$(jobs -p | wc -l)
PS1="$(starship prompt --status=$STATUS --jobs=$NUM_JOBS)" PS1="$(starship prompt --status=$STATUS --jobs=$NUM_JOBS)"
``` ```
The [Bash implementation](https://github.com/starship/starship/blob/master/src/init/starship.bash) built into Starship is slightly more complex to allow for advanced features like the [Command Duration module](https://starship.rs/config/#command-duration) and to ensure that Starship is compatible with pre-installed Bash configurations. L'implementazione [Bash](https://github.com/starship/starship/blob/master/src/init/starship.bash) integrata in Starship è leggermente più complessa per consentire funzionalità avanzate come il [modulo di durata dei comandi](https://starship.rs/config/#command-duration) e per garantire che Starship sia compatibile con le configurazioni Bash preinstallate.
Per un elenco di tutti i flag accettati da `starship prompt`, utilizzare il seguente comando: Per un elenco di tutti i flag accettati da `starship prompt`, utilizzare il seguente comando:
@ -60,37 +60,37 @@ curl -fsSL https://starship.rs/install.sh | bash -s -- --platform unknown-linux-
If you see symbols that you don't recognise you can use `starship explain` to explain the currently showing modules. If you see symbols that you don't recognise you can use `starship explain` to explain the currently showing modules.
## Why don't I see a glyph symbol in my prompt? ## Perché non vedo un simbolo di glifo nel mio prompt?
The most common cause of this is system misconfiguration. Some Linux distros in particular do not come with font support out-of-the-box. You need to ensure that: La causa più comune è la configurazione errata del sistema. Alcune distribuzioni Linux in particolare non vengono fornite con il supporto dei font come impostazione predefinita. È necessario assicurarsi che:
- In locale sia impostato un valore UTF-8, come `de_DE.UTF-8` o `ja_JP.UTF-8`. Se `LC_ALL` non è un valore UTF-8, [dovrai cambiarlo](https://www.tecmint.com/set-system-locales-in-linux/). - In locale sia impostato un valore UTF-8, come `de_DE.UTF-8` o `ja_JP.UTF-8`. Se `LC_ALL` non è un valore UTF-8, [dovrai cambiarlo](https://www.tecmint.com/set-system-locales-in-linux/).
- Hai un font emoji installato. La maggior parte dei sistemi ha un font emoji per impostazione predefinita, ma alcuni (in particolare Arch Linux) non lo fanno. Di solito puoi installarne uno attraverso il gestore dei pacchetti del tuo sistema-[noto emoji](https://www.google.com/get/noto/help/emoji/) è uno dei popolari. - Hai un font emoji installato. La maggior parte dei sistemi ha un font emoji per impostazione predefinita, ma alcuni (in particolare Arch Linux) non lo fanno. Di solito puoi installarne uno attraverso il gestore dei pacchetti del tuo sistema-[noto emoji](https://www.google.com/get/noto/help/emoji/) è uno dei popolari.
- Stai usando un [font Nerd](https://www.nerdfonts.com/). - Stai usando un [font Nerd](https://www.nerdfonts.com/).
To test your system, run the following commands in a terminal: Per testare il sistema, eseguire i seguenti comandi in un terminale:
```sh ```sh
echo -e "\xf0\x9f\x90\x8d" echo -e "\xf0\x9f\x90\x8d"
echo -e "\xee\x82\xa0" echo -e "\xee\x82\xa0"
``` ```
The first line should produce a [snake emoji](https://emojipedia.org/snake/), while the second should produce a [powerline branch symbol (e0a0)](https://github.com/ryanoasis/powerline-extra-symbols#glyphs). La prima riga dovrebbe riprodurre una [emoji di un serpente](https://emojipedia.org/snake/), mentre la seconda dovrebbe riprodurre il [simbolo powerline di ramo (e0a0)](https://github.com/ryanoasis/powerline-extra-symbols#glyphs).
If either symbol fails to display correctly, your system is still misconfigured. Unfortunately, getting font configuration correct is sometimes difficult. Users on the Discord may be able to help. If both symbols display correctly, but you still don't see them in starship, [file a bug report!](https://github.com/starship/starship/issues/new/choose) Se uno dei due simboli non viene visualizzato correttamente, il sistema è ancora mal configurato. Sfortunatamente, ottenere la configurazione dei caratteri corretta a volte è difficile. Gli utenti su Discord potrebbero essere in grado di aiutarti. Se entrambi i simboli vengono visualizzati correttamente, ma non li vedi ancora in starship, [segnala un bug!](https://github.com/starship/starship/issues/new/choose)
## How do I uninstall Starship? ## Come posso disinstallare Starship?
Starship is just as easy to uninstall as it is to install in the first place. Starship è altrettanto facile da disinstallare come lo è da installare.
1. Rimuovi qualsiasi riga utilizzata per inizializzare Starship nella configurazione della tua shell (ad es. `~/.bashrc`). 1. Rimuovi qualsiasi riga utilizzata per inizializzare Starship nella configurazione della tua shell (ad es. `~/.bashrc`).
1. Elimina il binario di Starship. 1. Elimina il binario di Starship.
If Starship was installed using a package manager, please refer to their docs for uninstallation instructions. Se Starship è stato installato utilizzando un gestore di pacchetti, fai riferimento alla documentazione per le istruzioni di disinstallazione.
If Starship was installed using the `curl | bash` script, the following command will delete the binary: If Starship was installed using the `curl | bash` script, the following command will delete the binary:
```sh ```sh
# Locate and delete the starship binary # Locate and delete the starship binary
bash -c 'rm "$(which starship)"' sh -c 'rm "$(which starship)"'
``` ```

4
docs/ja-JP/README.md
View File

@ -45,7 +45,7 @@ description: Starship はミニマルで、非常に高速で、カスタマイ
#### パッケージマネージャー経由でインストール #### パッケージマネージャー経由でインストール
With [Homebrew](https://brew.sh/): [ Homebrew ](https://brew.sh/)の場合：
```sh ```sh
brew install starship brew install starship
@ -95,7 +95,7 @@ description: Starship はミニマルで、非常に高速で、カスタマイ
#### Powershell #### Powershell
Add the following to the end of `Microsoft.PowerShell_profile.ps1`. You can check the location of this file by querying the `$PROFILE` variable in PowerShell. 通常、パスは `~\Documents\PowerShell\Microsoft.PowerShell_profile.ps1` または -Nix 上では `~/.config/powershell/Microsoft.PowerShell_profile.ps1` です。 `Microsoft.PowerShell_profile.ps1` の最後に以下を追記してください。 PowerShell 上で `$PROFILE` 変数を問い合わせると、ファイルの場所を確認できます。 通常、パスは `~\Documents\PowerShell\Microsoft.PowerShell_profile.ps1` または -Nix 上では `~/.config/powershell/Microsoft.PowerShell_profile.ps1` です。
```sh ```sh
Invoke-Expression (&starship init powershell) Invoke-Expression (&starship init powershell)

279
docs/ja-JP/config/README.md
View File

@ -261,7 +261,7 @@ When using [awsu](https://github.com/kreuzwerker/awsu) the profile is read from
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -306,7 +306,7 @@ symbol = "🅰 "
## バッテリー ## バッテリー
The `battery` module shows how charged the device's battery is and its current charging status. The module is only visible when the device's battery is below 10%. `battery`モジュールは、デバイスのバッテリー残量と現在の充電状態を示します。 モジュールは、デバイスのバッテリー残量が10％未満の場合にのみ表示されます。
### オプション ### オプション
@ -334,7 +334,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 ```toml
[[battery.display]] [[battery.display]]
@ -344,7 +344,7 @@ style = "bold red"
#### オプション #### オプション
The `display` option is an array of the following table. `display`オプションは、次の表の通りです。
| オプション | 説明 | | オプション | 説明 |
| ----------- | ------------------------------ | | ----------- | ------------------------------ |
@ -368,14 +368,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).
::: warning `error_symbol` is not supported on elvish shell. ::: ::: warning `error_symbol` is not supported on elvish shell. :::
@ -453,19 +453,19 @@ The `cmake` module shows the currently installed version of CMake. By default th
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
## コマンド実行時間 ## コマンド実行時間
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`定義するだけで、通常どおり続行します。
### オプション ### オプション
@ -492,7 +492,7 @@ Showing desktop notifications requires starship to be built with `rust-notify` s
| duration | `16m40s` | コマンドの実行時間 | | duration | `16m40s` | コマンドの実行時間 |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -506,11 +506,11 @@ format = "underwent [$duration](bold yellow)"
## Conda ## Conda
The `conda` module shows the current conda environment, if `$CONDA_DEFAULT_ENV` is set. `$CONDA_DEFAULT_ENV`が設定されている場合、`conda`モジュールは現在のcondaの環境を表示します。
::: tip ::: 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` で実行することができます。
::: :::
@ -533,7 +533,7 @@ This does not suppress conda's own prompt modifier, you may want to run `conda c
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -546,7 +546,7 @@ format = "[$symbol$environment](dimmed green) "
## Crystal ## Crystal
The `crystal` module shows the currently installed version of Crystal. By default the module will be shown if any of the following conditions are met: `crystal`モジュールには、現在インストールされているCrystalのバージョンが表示されます。 By default the module will be shown if any of the following conditions are met:
- カレントディレクトリに`shard.yml`ファイルが含まれている - カレントディレクトリに`shard.yml`ファイルが含まれている
- カレントディレクトリに`.cr`の拡張子のファイルが含まれている - カレントディレクトリに`.cr`の拡張子のファイルが含まれている
@ -561,7 +561,7 @@ The `crystal` module shows the currently installed version of Crystal. By defaul
| `detect_files` | `["shard.yml"]` | Which filenames should trigger this module. | | `detect_files` | `["shard.yml"]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. | | `detect_folders` | `[]` | Which folders should trigger this module. |
| `format` | `"via [$symbol($version )]($style)"` | moduleのフォーマットです。 | | `format` | `"via [$symbol($version )]($style)"` | moduleのフォーマットです。 |
| `disabled` | `false` | Disables the `crystal` module. | | `disabled` | `false` | `crystal`モジュールを無効にします。 |
### 変数 ### 変数
@ -571,7 +571,7 @@ The `crystal` module shows the currently installed version of Crystal. By defaul
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -588,7 +588,7 @@ The `dart` module shows the currently installed version of Dart. By default the
- The current directory contains a file with `.dart` extension - The current directory contains a file with `.dart` extension
- The current directory contains a `.dart_tool` directory - The current directory contains a `.dart_tool` directory
- The current directory contains a `pubspec.yaml`, `pubspec.yml` or `pubspec.lock` file - カレントディレクトリに`pubspec.yaml`, `pubspec.yml`,もしくは`pubspec.lock`が含まれている
### オプション ### オプション
@ -610,7 +610,7 @@ The `dart` module shows the currently installed version of Dart. By default the
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -623,11 +623,11 @@ 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`が表示されます。
### オプション ### オプション
@ -644,7 +644,7 @@ For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, an
| `home_symbol` | `"~"` | The symbol indicating home directory. | | `home_symbol` | `"~"` | The symbol indicating home directory. |
<details> <details>
<summary>This module has a few advanced configuration options that control how the directory is displayed.</summary> <summary>このモジュールは、どのようにディレクトリを表示するかについての高度なオプションをいくつか持っています。</summary>
| Advanced Option | デフォルト | 説明 | | Advanced Option | デフォルト | 説明 |
| --------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | --------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@ -671,7 +671,7 @@ For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, an
| path | `"D:/Projects"` | The current directory path | | path | `"D:/Projects"` | The current directory path |
| style\* | `"black bold dimmed"` | オプション `style` の値をミラーする | | style\* | `"black bold dimmed"` | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -685,7 +685,7 @@ truncation_symbol = "…/"
## Docker Context ## 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コンテキストを表示します。
### オプション ### オプション
@ -698,7 +698,7 @@ The `docker_context` module shows the currently active [Docker context](https://
| `detect_files` | `["docker-compose.yml", "docker-compose.yaml", "Dockerfile"]` | Which filenames should trigger this module (needs `only_with_files` to be true). | | `detect_files` | `["docker-compose.yml", "docker-compose.yaml", "Dockerfile"]` | Which filenames should trigger this module (needs `only_with_files` to be true). |
| `detect_folders` | `[]` | Which folders should trigger this module (needs `only_with_files` to be true). | | `detect_folders` | `[]` | Which folders should trigger this module (needs `only_with_files` to be true). |
| `style` | `"blue bold"` | モジュールのスタイルです。 | | `style` | `"blue bold"` | モジュールのスタイルです。 |
| `disabled` | `false` | Disables the `docker_context` module. | | `disabled` | `false` | `docker_context`モジュールを無効にします。 |
### 変数 ### 変数
@ -708,7 +708,7 @@ The `docker_context` module shows the currently active [Docker context](https://
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -721,7 +721,7 @@ format = "via [🐋 $context](blue bold)"
## Dotnet ## 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の最新のインストールバージョンを示します。
By default this module will only be shown in your prompt when one or more of the following files are present in the current directory: By default this module will only be shown in your prompt when one or more of the following files are present in the current directory:
@ -737,7 +737,7 @@ By default this module will only be shown in your prompt when one or more of the
You'll also need the .NET Core SDK installed in order to use it correctly. 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 (<https://docs.microsoft.com/en-us/dotnet/standard/frameworks#supported-target-framework-versions>) when there is a csproj file in the current directory. The module will also show the Target Framework Moniker (<https://docs.microsoft.com/en-us/dotnet/standard/frameworks#supported-target-framework-versions>) when there is a csproj file in the current directory.
@ -752,7 +752,7 @@ The module will also show the Target Framework Moniker (<https://docs.microsoft.
| `detect_files` | `["global.json", "project.json", "Directory.Build.props", "Directory.Build.targets", "Packages.props"]` | Which filenames should trigger this module. | | `detect_files` | `["global.json", "project.json", "Directory.Build.props", "Directory.Build.targets", "Packages.props"]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this modules. | | `detect_folders` | `[]` | Which folders should trigger this modules. |
| `style` | `"bold blue"` | モジュールのスタイルです。 | | `style` | `"bold blue"` | モジュールのスタイルです。 |
| `disabled` | `false` | Disables the `dotnet` module. | | `disabled` | `false` | `dotnet`モジュールを無効にします。 |
### 変数 ### 変数
@ -763,7 +763,7 @@ The module will also show the Target Framework Moniker (<https://docs.microsoft.
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -803,7 +803,7 @@ The `elixir` module shows the currently installed version of Elixir and Erlang/O
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -816,7 +816,7 @@ symbol = "🔮 "
## Elm ## Elm
The `elm` module shows the currently installed version of Elm. By default the module will be shown if any of the following conditions are met: `elm`モジュールは、現在インストールされているElmのバージョンを示します。 By default the module will be shown if any of the following conditions are met:
- カレントディレクトリに`elm.json`ファイルが含まれている - カレントディレクトリに`elm.json`ファイルが含まれている
- カレントディレクトリに`elm-package.json`ファイルが含まれている - カレントディレクトリに`elm-package.json`ファイルが含まれている
@ -834,7 +834,7 @@ The `elm` module shows the currently installed version of Elm. By default the mo
| `detect_files` | `["elm.json", "elm-package.json", ".elm-version"]` | Which filenames should trigger this module. | | `detect_files` | `["elm.json", "elm-package.json", ".elm-version"]` | Which filenames should trigger this module. |
| `detect_folders` | `["elm-stuff"]` | Which folders should trigger this modules. | | `detect_folders` | `["elm-stuff"]` | Which folders should trigger this modules. |
| `style` | `"cyan bold"` | モジュールのスタイルです。 | | `style` | `"cyan bold"` | モジュールのスタイルです。 |
| `disabled` | `false` | Disables the `elm` module. | | `disabled` | `false` | `elm`モジュールを無効にします。 |
### 変数 ### 変数
@ -844,7 +844,7 @@ The `elm` module shows the currently installed version of Elm. By default the mo
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -857,7 +857,7 @@ 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`オプションが、既存の環境変数と一致する
- `variable`オプションが定義されておらず、`default`オプションが定義されている - `variable`オプションが定義されておらず、`default`オプションが定義されている
@ -880,7 +880,7 @@ The `env_var` module displays the current value of a selected environment variab
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | `black bold dimmed` | オプション `style` の値をミラーする | | style\* | `black bold dimmed` | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -919,7 +919,7 @@ The `erlang` module shows the currently installed version of Erlang/OTP. By defa
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -992,7 +992,7 @@ asia-northeast1 = "an1"
## Git ブランチ ## Git ブランチ
The `git_branch` module shows the active branch of the repo in your current directory. `git_branch`モジュールは、現在のディレクトリにあるリポジトリのアクティブなブランチを表示します。
### オプション ### オプション
@ -1017,7 +1017,7 @@ The `git_branch` module shows the active branch of the repo in your current dire
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -1053,7 +1053,7 @@ The `git_commit` module shows the current commit hash and also the tag (if any)
| hash | `b703eb3` | The current git commit hash | | hash | `b703eb3` | The current git commit hash |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -1067,7 +1067,7 @@ tag_symbol = "🔖 "
## Git の進行状態 ## 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)はその情報も表示されます。
### オプション ### オプション
@ -1093,7 +1093,7 @@ The `git_state` module will show in directories which are part of a git reposito
| progress_total | `2` | The total operation progress | | progress_total | `2` | The total operation progress |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -1107,7 +1107,7 @@ cherry_pick = "[🍒 PICKING](bold red)"
## Git の状態 ## Git の状態
The `git_status` module shows symbols representing the state of the repo in your current directory. `git_status`モジュールは、現在のディレクトリのリポジトリの状態を表すシンボルを表示します。
### オプション ### オプション
@ -1144,7 +1144,7 @@ The following variables can be used in `format`:
| `deleted` | Displays `deleted` when a file's deletion has been added to the staging area. | | `deleted` | Displays `deleted` when a file's deletion has been added to the staging area. |
| style\* | オプション `style` の値をミラーする | | style\* | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
The following variables can be used in `diverged`: The following variables can be used in `diverged`:
@ -1190,7 +1190,7 @@ behind = "⇣${count}"
## Golang ## Golang
The `golang` module shows the currently installed version of Golang. By default the module will be shown if any of the following conditions are met: `golang`モジュールは、現在インストールされているGolangのバージョンを示します。 By default the module will be shown if any of the following conditions are met:
- カレントディレクトリに`go.mod`ファイルが含まれている - カレントディレクトリに`go.mod`ファイルが含まれている
- カレントディレクトリに`go.sum`ファイルが含まれている - カレントディレクトリに`go.sum`ファイルが含まれている
@ -1211,7 +1211,7 @@ The `golang` module shows the currently installed version of Golang. By default
| `detect_files` | `["go.mod", "go.sum", "glide.yaml", "Gopkg.yml", "Gopkg.lock", ".go-version"]` | Which filenames should trigger this module. | | `detect_files` | `["go.mod", "go.sum", "glide.yaml", "Gopkg.yml", "Gopkg.lock", ".go-version"]` | Which filenames should trigger this module. |
| `detect_folders` | `["Godeps"]` | Which folders should trigger this module. | | `detect_folders` | `["Godeps"]` | Which folders should trigger this module. |
| `style` | `"bold cyan"` | モジュールのスタイルです。 | | `style` | `"bold cyan"` | モジュールのスタイルです。 |
| `disabled` | `false` | Disables the `golang` module. | | `disabled` | `false` | `golang`モジュールを無効にします。 |
### 変数 ### 変数
@ -1221,7 +1221,7 @@ The `golang` module shows the currently installed version of Golang. By default
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -1259,7 +1259,7 @@ The `helm` module shows the currently installed version of Helm. By default the
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -1272,7 +1272,7 @@ format = "via [⎈ $version](bold white) "
## ホスト名 ## ホスト名
The `hostname` module shows the system hostname. `hostname`モジュールには、システムのホスト名が表示されます。
### オプション ### オプション
@ -1291,7 +1291,7 @@ The `hostname` module shows the system hostname.
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -1307,7 +1307,7 @@ disabled = false
## Java ## Java
The `java` module shows the currently installed version of Java. By default the module will be shown if any of the following conditions are met: `java`モジュールは、現在インストールされているJavaのバージョンを示します。 By default the module will be shown if any of the following conditions are met:
- 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 `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 - The current directory contains a file with the `.java`, `.class`, `.gradle`, `.jar`, `.clj`, or `.cljc` extension
@ -1322,7 +1322,7 @@ The `java` module shows the currently installed version of Java. By default the
| `detect_folders` | `[]` | Which folders should trigger this modules. | | `detect_folders` | `[]` | Which folders should trigger this modules. |
| `symbol` | `"☕ "` | A format string representing the symbol of Java | | `symbol` | `"☕ "` | A format string representing the symbol of Java |
| `style` | `"red dimmed"` | モジュールのスタイルです。 | | `style` | `"red dimmed"` | モジュールのスタイルです。 |
| `disabled` | `false` | Disables the `java` module. | | `disabled` | `false` | `java`モジュールを無効にします。 |
### 変数 ### 変数
@ -1332,7 +1332,7 @@ The `java` module shows the currently installed version of Java. By default the
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -1345,7 +1345,7 @@ 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`に指定した値以上にジョブがある場合は実行中のジョブの数を表示します。
::: warning ::: warning
@ -1371,7 +1371,7 @@ This module is not supported on tcsh.
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -1385,7 +1385,7 @@ threshold = 4
## Julia ## Julia
The `julia` module shows the currently installed version of Julia. By default the module will be shown if any of the following conditions are met: `julia`モジュールは、現在インストールされているJuliaのバージョンを示します。 By default the module will be shown if any of the following conditions are met:
- カレントディレクトリに`Project.toml`ファイルが含まれている - カレントディレクトリに`Project.toml`ファイルが含まれている
- カレントディレクトリに`Manifest.toml`ファイルが含まれている - カレントディレクトリに`Manifest.toml`ファイルが含まれている
@ -1401,7 +1401,7 @@ The `julia` module shows the currently installed version of Julia. By default th
| `detect_folders` | `[]` | Which folders should trigger this modules. | | `detect_folders` | `[]` | Which folders should trigger this modules. |
| `symbol` | `"ஃ "` | A format string representing the symbol of Julia. | | `symbol` | `"ஃ "` | A format string representing the symbol of Julia. |
| `style` | `"bold purple"` | モジュールのスタイルです。 | | `style` | `"bold purple"` | モジュールのスタイルです。 |
| `disabled` | `false` | Disables the `julia` module. | | `disabled` | `false` | `julia`モジュールを無効にします。 |
### 変数 ### 変数
@ -1411,7 +1411,7 @@ The `julia` module shows the currently installed version of Julia. By default th
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -1449,7 +1449,7 @@ The `kotlin` module shows the currently installed version of Kotlin. By default
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -1474,7 +1474,7 @@ Displays the current Kubernetes context name and, if set, the namespace from the
::: tip ::: tip
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. このモジュールはデフォルトで無効になっています。 有効にするには、設定ファイルで`disabled`を`false`に設定します。
::: :::
@ -1497,7 +1497,7 @@ This module is disabled by default. To enable it, set `disabled` to `false` in y
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -1513,7 +1513,7 @@ disabled = false
## 改行 ## 改行
The `line_break` module separates the prompt into two lines. `line_break`モジュールは、プロンプトを2行に分割します。
### オプション ### オプション
@ -1559,7 +1559,7 @@ The `lua` module shows the currently installed version of Lua. By default the mo
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -1572,13 +1572,14 @@ format = "via [🌕 $version](bold blue) "
## メモリ使用量 ## メモリ使用量
The `memory_usage` module shows current system memory and swap usage. `memory_usage</ 0>モジュールは、現在のシステムメモリとスワップ使用量を示します。</p>
By default the swap usage is displayed if the total system swap is non-zero. <p spaces-before="0">デフォルトでは、システムスワップの合計がゼロ以外の場合、スワップ使用量が表示されます。</p>
::: tip <p spaces-before="0">::: tip</p>
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. <p spaces-before="0">このモジュールはデフォルトで無効になっています。
有効にするには、設定ファイルで<code>disabled`を`false`に設定します。
::: :::
@ -1619,7 +1620,7 @@ style = "bold dimmed green"
## Mercurial ブランチ ## Mercurial ブランチ
The `hg_branch` module shows the active branch of the repo in your current directory. ` hg_branch `モジュールは、現在のディレクトリにあるリポジトリのアクティブなブランチを示します。
### オプション ### オプション
@ -1640,7 +1641,7 @@ The `hg_branch` module shows the active branch of the repo in your current direc
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -1682,7 +1683,7 @@ The `nim` module shows the currently installed version of Nim. By default the mo
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -1696,7 +1697,7 @@ symbol = "🎣 "
## Nix-shell ## 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シェル環境内にあるときに表示されます。
### オプション ### オプション
@ -1718,7 +1719,7 @@ The `nix_shell` module shows the nix-shell environment. The module will be shown
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -1734,7 +1735,7 @@ format = 'via [☃️ $state( \($name\))](bold blue) '
## NodeJS ## NodeJS
The `nodejs` module shows the currently installed version of NodeJS. By default the module will be shown if any of the following conditions are met: `nodejs`モジュールは、現在インストールされているNodeJSのバージョンを示します。 By default the module will be shown if any of the following conditions are met:
- カレントディレクトリに`package.json`ファイルが含まれている - カレントディレクトリに`package.json`ファイルが含まれている
- The current directory contains a `.node-version` file - The current directory contains a `.node-version` file
@ -1752,7 +1753,7 @@ The `nodejs` module shows the currently installed version of NodeJS. By default
| `detect_files` | `["package.json", ".node-version"]` | Which filenames should trigger this module. | | `detect_files` | `["package.json", ".node-version"]` | Which filenames should trigger this module. |
| `detect_folders` | `["node_modules"]` | Which folders should trigger this module. | | `detect_folders` | `["node_modules"]` | Which folders should trigger this module. |
| `style` | `"bold green"` | モジュールのスタイルです。 | | `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 `package.json` does not match the NodeJS version. | | `not_capable_style` | `bold red` | The style for the module when an engines property in `package.json` does not match the NodeJS version. |
### 変数 ### 変数
@ -1763,7 +1764,7 @@ The `nodejs` module shows the currently installed version of NodeJS. By default
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -1809,7 +1810,7 @@ The `ocaml` module shows the currently installed version of OCaml. By default th
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -1842,7 +1843,7 @@ The `openstack` module shows the current OpenStack cloud and project. The module
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -1857,7 +1858,7 @@ symbol = "☁️ "
## パッケージのバージョン ## パッケージのバージョン
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** – `npm`パッケージバージョンは、現在のディレクトリにある`package.json`から抽出されます - **npm** – `npm`パッケージバージョンは、現在のディレクトリにある`package.json`から抽出されます
- **cargo** – `cargo`パッケージバージョンは、現在のディレクトリにある`Cargo.toml`から抽出されます。 - **cargo** – `cargo`パッケージバージョンは、現在のディレクトリにある`Cargo.toml`から抽出されます。
@ -1890,7 +1891,7 @@ The `package` module is shown when the current directory is the repository for a
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -1942,7 +1943,7 @@ format = "via [🦪 $version]($style) "
## PHP ## PHP
The `php` module shows the currently installed version of PHP. By default the module will be shown if any of the following conditions are met: `php`モジュールは、現在インストールされているPHPのバージョンを示します。 By default the module will be shown if any of the following conditions are met:
- カレントディレクトリに`composer.json`ファイルが含まれている - カレントディレクトリに`composer.json`ファイルが含まれている
- The current directory contains a `.php-version` file - The current directory contains a `.php-version` file
@ -1958,7 +1959,7 @@ The `php` module shows the currently installed version of PHP. By default the mo
| `detect_files` | `["composer.json", ".php-version"]` | Which filenames should trigger this module. | | `detect_files` | `["composer.json", ".php-version"]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. | | `detect_folders` | `[]` | Which folders should trigger this module. |
| `style` | `"147 bold"` | モジュールのスタイルです。 | | `style` | `"147 bold"` | モジュールのスタイルです。 |
| `disabled` | `false` | Disables the `php` module. | | `disabled` | `false` | `php`モジュールを無効にします。 |
### 変数 ### 変数
@ -1968,7 +1969,7 @@ The `php` module shows the currently installed version of PHP. By default the mo
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -2006,7 +2007,7 @@ The `purescript` module shows the currently installed version of PureScript vers
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -2019,20 +2020,20 @@ format = "via [$symbol$version](bold white)"
## Python ## 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`. 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`.
By default the module will be shown if any of the following conditions are met: By default the module will be shown if any of the following conditions are met:
- カレントディレクトリに`.python-version`ファイルが含まれている - カレントディレクトリに`.python-version`ファイルが含まれている
- The current directory contains a `Pipfile` file - カレントディレクトリに`Pipfile`ファイルが含まれている
- The current directory contains a `__init__.py` file - The current directory contains a `__init__.py` file
- The current directory contains a `pyproject.toml` file - カレントディレクトリに`pyproject.toml`ファイルが含まれている
- The current directory contains a `requirements.txt` file - カレントディレクトリに`requirements.txt`ファイルが含まれている
- The current directory contains a `setup.py` file - カレントディレクトリに`setup.py`ファイルが含まれている
- The current directory contains a `tox.ini` file - カレントディレクトリに`tox.ini`ファイルが含まれている
- The current directory contains a file with the `.py` extension. - カレントディレクトリに`.py`の拡張子のファイルが含まれている.
- 仮想環境がアクティブである - 仮想環境がアクティブである
### オプション ### オプション
@ -2048,7 +2049,7 @@ By default the module will be shown if any of the following conditions are met:
| `detect_extensions` | `[".py"]` | Which extensions should trigger this module | | `detect_extensions` | `[".py"]` | Which extensions should trigger this module |
| `detect_files` | `[".python-version", "Pipfile", "__init__.py", "pyproject.toml", "requirements.txt", "setup.py", "tox.ini"]` | Which filenames should trigger this module | | `detect_files` | `[".python-version", "Pipfile", "__init__.py", "pyproject.toml", "requirements.txt", "setup.py", "tox.ini"]` | Which filenames should trigger this module |
| `detect_folders` | `[]` | Which folders should trigger this module | | `detect_folders` | `[]` | Which folders should trigger this module |
| `disabled` | `false` | Disables the `python` module. | | `disabled` | `false` | `python`モジュールを無効にします。 |
::: tip ::: tip
@ -2096,7 +2097,7 @@ detect_extensions = []
## Ruby ## Ruby
By default the `ruby` module shows the currently installed version of Ruby. The module will be shown if any of the following conditions are met: By default the `ruby` module shows the currently installed version of Ruby. 次の条件のいずれかが満たされると、モジュールが表示されます。
- カレントディレクトリに`Gemfile`ファイルが含まれている - カレントディレクトリに`Gemfile`ファイルが含まれている
- The current directory contains a `.ruby-version` file - The current directory contains a `.ruby-version` file
@ -2112,7 +2113,7 @@ By default the `ruby` module shows the currently installed version of Ruby. The
| `detect_files` | `["Gemfile", ".ruby-version"]` | Which filenames should trigger this module. | | `detect_files` | `["Gemfile", ".ruby-version"]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. | | `detect_folders` | `[]` | Which folders should trigger this module. |
| `style` | `"bold red"` | モジュールのスタイルです。 | | `style` | `"bold red"` | モジュールのスタイルです。 |
| `disabled` | `false` | Disables the `ruby` module. | | `disabled` | `false` | `ruby`モジュールを無効にします。 |
### 変数 ### 変数
@ -2122,7 +2123,7 @@ By default the `ruby` module shows the currently installed version of Ruby. The
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -2135,7 +2136,7 @@ symbol = "🔺 "
## Rust ## Rust
By default the `rust` module shows the currently installed version of Rust. The module will be shown if any of the following conditions are met: By default the `rust` module shows the currently installed version of Rust. 次の条件のいずれかが満たされると、モジュールが表示されます。
- カレントディレクトリに`Cargo.toml`ファイルが含まれている - カレントディレクトリに`Cargo.toml`ファイルが含まれている
- カレントディレクトリに`.rs`の拡張子のファイルが含まれている - カレントディレクトリに`.rs`の拡張子のファイルが含まれている
@ -2150,7 +2151,7 @@ By default the `rust` module shows the currently installed version of Rust. The
| `detect_files` | `["Cargo.toml"]` | Which filenames should trigger this module. | | `detect_files` | `["Cargo.toml"]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. | | `detect_folders` | `[]` | Which folders should trigger this module. |
| `style` | `"bold red"` | モジュールのスタイルです。 | | `style` | `"bold red"` | モジュールのスタイルです。 |
| `disabled` | `false` | Disables the `rust` module. | | `disabled` | `false` | `rust`モジュールを無効にします。 |
### 変数 ### 変数
@ -2160,7 +2161,7 @@ By default the `rust` module shows the currently installed version of Rust. The
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -2199,7 +2200,7 @@ The `scala` module shows the currently installed version of Scala. By default th
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -2216,7 +2217,7 @@ The `shell` module shows an indicator for currently used shell.
::: tip ::: tip
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. このモジュールはデフォルトで無効になっています。 有効にするには、設定ファイルで`disabled`を`false`に設定します。
::: :::
@ -2274,7 +2275,7 @@ The `shlvl` module shows the current `SHLVL` ("shell level") environment variabl
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -2308,7 +2309,7 @@ The `singularity` module shows the current singularity image, if inside a contai
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -2325,7 +2326,7 @@ The `status` module displays the exit code of the previous command. The module w
::: tip ::: tip
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. このモジュールはデフォルトで無効になっています。 有効にするには、設定ファイルで`disabled`を`false`に設定します。
::: :::
@ -2359,7 +2360,7 @@ This module is disabled by default. To enable it, set `disabled` to `false` in y
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -2378,7 +2379,7 @@ disabled = false
## Swift ## Swift
By default the `swift` module shows the currently installed version of Swift. The module will be shown if any of the following conditions are met: By default the `swift` module shows the currently installed version of Swift. 次の条件のいずれかが満たされると、モジュールが表示されます。
- The current directory contains a `Package.swift` file - The current directory contains a `Package.swift` file
- The current directory contains a file with the `.swift` extension - The current directory contains a file with the `.swift` extension
@ -2403,7 +2404,7 @@ By default the `swift` module shows the currently installed version of Swift. Th
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -2416,7 +2417,7 @@ format = "via [🏎 $version](red bold)"
## Terraform ## Terraform
The `terraform` module shows the currently selected terraform workspace and version. `terraform`モジュールには、現在選択されているterraformワークスペースとバージョンが表示されます。
::: tip ::: tip
@ -2426,7 +2427,7 @@ By default the terraform version is not shown, since this is slow for current ve
By default the module will be shown if any of the following conditions are met: By default the module will be shown if any of the following conditions are met:
- The current directory contains a `.terraform` folder - カレントディレクトリに`.terraform`フォルダが含まれている
- Current directory contains a file with the `.tf` or `.hcl` extensions - Current directory contains a file with the `.tf` or `.hcl` extensions
### オプション ### オプション
@ -2439,7 +2440,7 @@ By default the module will be shown if any of the following conditions are met:
| `detect_files` | `[]` | Which filenames should trigger this module. | | `detect_files` | `[]` | Which filenames should trigger this module. |
| `detect_folders` | `[".terraform"]` | Which folders should trigger this module. | | `detect_folders` | `[".terraform"]` | Which folders should trigger this module. |
| `style` | `"bold 105"` | モジュールのスタイルです。 | | `style` | `"bold 105"` | モジュールのスタイルです。 |
| `disabled` | `false` | Disables the `terraform` module. | | `disabled` | `false` | `terraform`モジュールを無効にします。 |
### 変数 ### 変数
@ -2450,7 +2451,7 @@ By default the module will be shown if any of the following conditions are met:
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -2474,36 +2475,36 @@ format = "[🏎💨 $workspace]($style) "
## Time ## Time
The `time` module shows the current **local** time. The `format` configuration value is used by the [`chrono`](https://crates.io/crates/chrono) crate to control how the time is displayed. Take a look [at the chrono strftime docs](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) to see what options are available. `time`モジュールは、現在の**現地**時間を示します。 `format`設定は、時間の表示方法を制御するために[`chrono`](https://crates.io/crates/chrono)クレートによって使用されます。 使用可能なオプションを確認するには、[chrono strftimeのドキュメント](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html)をご覧ください。
::: tip ::: 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. | | `format` | `"at [$time]($style) "` | The format string for the module. |
| `use_12hr` | `false` | Enables 12 hour formatting | | `use_12hr` | `false` | 12時間のフォーマットを有効にします。 |
| `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. | | `time_format` | この表の下を参照してください | 時刻のフォーマットに使用される[クロノフォーマット文字列](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) です。 |
| `style` | `"bold yellow"` | The style for the module time | | `style` | `"bold yellow"` | モジュールのスタイルです。 |
| `utc_time_offset` | `"local"` | Sets the UTC offset to use. Range from -24 &lt; x &lt; 24. Allows floats to accommodate 30/45 minute timezone offsets. | | `utc_time_offset` | `"local"` | 使用するUTCオフセットを設定します。 Range from -24 &lt; x &lt; 24. フロートが30/45分のタイムゾーンオフセットに対応できるようにします。 |
| `disabled` | `true` | Disables the `time` module. | | `disabled` | `true` | `time`モジュールを無効にします。 |
| `time_range` | `"-"` | Sets the time range during which the module will be shown. Times must be specified in 24-hours format | | `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. If `use_12hr` is `true`, then `time_format` defaults to `"%r"`. それ以外の場合、デフォルトは`"%T"`です。 Manually setting `time_format` will override the `use_12hr` setting.
### 変数 ### 変数
| 変数 | 設定例 | 説明 | | 変数 | 設定例 | 説明 |
| --------- | ---------- | ---------------------- | | --------- | ---------- | ---------------------- |
| time | `13:08:10` | The current time. | | 時刻 | `13:08:10` | The current time. |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -2518,14 +2519,14 @@ utc_time_offset = "-5"
time_range = "10:00:00-14:00:00" time_range = "10:00:00-14:00:00"
``` ```
## Username ## ユーザー名
The `username` module shows active user's username. The module will be shown if any of the following conditions are met: `username`モジュールには、アクティブなユーザーのユーザー名が表示されます。 次の条件のいずれかが満たされると、モジュールが表示されます。
- The current user is root - カレントユーザーがroot
- The current user isn't the same as the one that is logged in - カレントユーザーが、ログインしているユーザーとは異なる
- The user is currently connected as an SSH session - ユーザーがSSHセッションとして接続されている
- The variable `show_always` is set to true - `show_always`変数がtrueに設定されている
::: tip ::: tip
@ -2536,12 +2537,12 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
### オプション ### オプション
| オプション | デフォルト | 説明 | | オプション | デフォルト | 説明 |
| ------------- | ----------------------- | ------------------------------------- | | ------------- | ----------------------- | ------------------------- |
| `style_root` | `"bold red"` | The style used when the user is root. | | `style_root` | `"bold red"` | ユーザーがrootのときに使用されるスタイルです。 |
| `style_user` | `"bold yellow"` | The style used for non-root users. | | `style_user` | `"bold yellow"` | 非rootユーザーに使用されるスタイルです。 |
| `format` | `"[$user]($style) in "` | moduleのフォーマットです。 | | `format` | `"[$user]($style) in "` | moduleのフォーマットです。 |
| `show_always` | `false` | Always shows the `username` module. | | `show_always` | `false` | `username` モジュールを常に表示します。 |
| `disabled` | `false` | Disables the `username` module. | | `disabled` | `false` | `username` モジュールを無効にします。 |
### 変数 ### 変数
@ -2589,7 +2590,7 @@ The `vagrant` module shows the currently installed version of Vagrant. By defaul
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -2621,7 +2622,7 @@ The `vcsh` module displays the current active VCSH repository. The module will b
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | `black bold dimmed` | オプション `style` の値をミラーする | | style\* | `black bold dimmed` | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -2634,7 +2635,7 @@ format = "[🆅 $repo](bold blue) "
## Zig ## Zig
By default the the `zig` module shows the currently installed version of Zig. The module will be shown if any of the following conditions are met: By default the the `zig` module shows the currently installed version of Zig. 次の条件のいずれかが満たされると、モジュールが表示されます。
- The current directory contains a `.zig` file - The current directory contains a `.zig` file
@ -2658,7 +2659,7 @@ By default the the `zig` module shows the currently installed version of Zig. Th
| symbol | | オプション `記号` の値をミラーする | | symbol | | オプション `記号` の値をミラーする |
| style\* | | オプション `style` の値をミラーする | | style\* | | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
### 設定例 ### 設定例
@ -2722,7 +2723,7 @@ The order in which custom modules are shown can be individually set by including
| symbol | オプション `記号` の値をミラーする | | symbol | オプション `記号` の値をミラーする |
| style\* | オプション `style` の値をミラーする | | style\* | オプション `style` の値をミラーする |
\*: This variable can only be used as a part of a style string \*: この変数はスタイル文字列の一部としてのみ使用できます
#### Custom command shell #### Custom command shell

2
docs/ja-JP/faq/README.md
View File

@ -92,5 +92,5 @@ Starshipのアンインストールはインストールと同じぐらい簡単
```sh ```sh
# Locate and delete the starship binary # Locate and delete the starship binary
bash -c 'rm "$(which starship)"' sh -c 'rm "$(which starship)"'
``` ```

2
docs/ko-KR/README.md
View File

@ -45,7 +45,7 @@ description: Starship is the minimal, blazing fast, and extremely customizable p
#### 패키지 매니저를 이용한 설치 #### 패키지 매니저를 이용한 설치
With [Homebrew](https://brew.sh/): [Homebrew](https://brew.sh/)를 통한 설치:
```sh ```sh
brew install starship brew install starship

2
docs/ko-KR/faq/README.md
View File

@ -92,5 +92,5 @@ If Starship was installed using the `curl | bash` script, the following command
```sh ```sh
# Locate and delete the starship binary # Locate and delete the starship binary
bash -c 'rm "$(which starship)"' sh -c 'rm "$(which starship)"'
``` ```

18
docs/ko-KR/guide/README.md
View File

@ -163,7 +163,7 @@
To update the Starship itself, rerun the above script. It will replace the current version without touching Starship's configuration. To update the Starship itself, rerun the above script. It will replace the current version without touching Starship's configuration.
#### Install via Package Manager #### 패키지 매니저를 이용한 설치
##### 예제: [Homebrew](https://brew.sh/): ##### 예제: [Homebrew](https://brew.sh/):
@ -179,12 +179,12 @@
scoop install starship scoop install starship
``` ```
2. Add the init script to your shell's config file: 2. 쉘 설정에 시동 스크립트를 추가:
#### Bash #### Bash
Add the following to the end of `~/.bashrc`: `~/.bashrc`에 아래 라인을 추가
```sh ```sh
# ~/.bashrc # ~/.bashrc
@ -195,7 +195,7 @@
#### Fish #### Fish
Add the following to the end of `~/.config/fish/config.fish`: `~/.config/fish/config.fish`에 아래 라인을 추가
```sh ```sh
# ~/.config/fish/config.fish # ~/.config/fish/config.fish
@ -206,7 +206,7 @@
#### Zsh #### Zsh
Add the following to the end of `~/.zshrc`: `~/.zshrc`에 아래 라인을 추가
```sh ```sh
# ~/.zshrc # ~/.zshrc
@ -217,7 +217,7 @@
#### 파워셀 #### 파워셀
`Microsoft.PowerShell_profile.ps1`의 끝부분에 아래 내용을 추가. 해당 설정파일은 파워쉘에서 `$PROFILE` 변수 확인을 통해 확인 가능. Typically the path is `~\Documents\PowerShell\Microsoft.PowerShell_profile.ps1` or `~/.config/powershell/Microsoft.PowerShell_profile.ps1` on -Nix. `Microsoft.PowerShell_profile.ps1`의 끝부분에 아래 내용을 추가. 해당 설정파일은 파워쉘에서 `$PROFILE` 변수 확인을 통해 확인 가능. 일반적으로 해당 파일은 `~\Documents\PowerShell\Microsoft.PowerShell_profile.ps1` 혹은 -Nix의 경우 `~/.config/powershell/Microsoft.PowerShell_profile.ps1`에 위치.
```powershell ```powershell
Invoke-Expression (&starship init powershell) Invoke-Expression (&starship init powershell)
@ -226,7 +226,7 @@
#### Ion #### Ion
Add the following to the end of `~/.config/ion/initrc`: 아래의 라인을 `~/.config/ion/initrc` 마지막에 추가:
```sh ```sh
# ~/.config/ion/initrc # ~/.config/ion/initrc
@ -237,7 +237,7 @@
#### Elvish #### Elvish
**Warning** Only elvish v0.15 or higher is supported. Add the following to the end of `~/.elvish/rc.elv`: **Warning** Only elvish v0.15 or higher is supported. 아래의 라인을 `~/.elvish/rc.elv` 마지막에 추가:
```sh ```sh
# ~/.elvish/rc.elv # ~/.elvish/rc.elv
@ -248,7 +248,7 @@
#### Tcsh #### Tcsh
Add the following to the end of `~/.tcshrc`: 아래의 라인을 `~/.tcshrc` 마지막에 추가:
```sh ```sh
# ~/.tcshrc # ~/.tcshrc

2
docs/nl-NL/faq/README.md
View File

@ -92,5 +92,5 @@ If Starship was installed using the `curl | bash` script, the following command
```sh ```sh
# Locate and delete the starship binary # Locate and delete the starship binary
bash -c 'rm "$(which starship)"' sh -c 'rm "$(which starship)"'
``` ```

2
docs/pl-PL/faq/README.md
View File

@ -92,5 +92,5 @@ If Starship was installed using the `curl | bash` script, the following command
```sh ```sh
# Locate and delete the starship binary # Locate and delete the starship binary
bash -c 'rm "$(which starship)"' sh -c 'rm "$(which starship)"'
``` ```

2
docs/pt-BR/README.md
View File

@ -45,7 +45,7 @@ description: O Starship é o prompt minimalista, extremamente rápido e extremam
#### Instalar via Gerenciador de Pacotes #### Instalar via Gerenciador de Pacotes
With [Homebrew](https://brew.sh/): Com o [Homebrew](https://brew.sh/):
```sh ```sh
brew install starship brew install starship

2
docs/pt-BR/config/README.md
View File

@ -458,7 +458,7 @@ The `cmake` module shows the currently installed version of CMake. By default th
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. 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. If you are running Starship in `bash`, do not hook the `DEBUG` trap after running `eval $(starship init $0)`, or this module **will** break.

2
docs/pt-BR/faq/README.md
View File

@ -92,5 +92,5 @@ If Starship was installed using the `curl | bash` script, the following command
```sh ```sh
# Locate and delete the starship binary # Locate and delete the starship binary
bash -c 'rm "$(which starship)"' sh -c 'rm "$(which starship)"'
``` ```

2
docs/pt-PT/faq/README.md
View File

@ -92,5 +92,5 @@ If Starship was installed using the `curl | bash` script, the following command
```sh ```sh
# Locate and delete the starship binary # Locate and delete the starship binary
bash -c 'rm "$(which starship)"' sh -c 'rm "$(which starship)"'
``` ```

2
docs/ru-RU/README.md
View File

@ -45,7 +45,7 @@ description: Starship - минимальная, быстрая и бесконе
#### Установить через менеджер пакетов #### Установить через менеджер пакетов
With [Homebrew](https://brew.sh/): С [Homebrew](https://brew.sh/):
```sh ```sh
brew install starship brew install starship

274
docs/ru-RU/config/README.md
View File

@ -260,7 +260,7 @@ When using [awsu](https://github.com/kreuzwerker/awsu) the profile is read from
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Примеры ### Примеры
@ -305,7 +305,7 @@ symbol = "🅰 "
## Батарея ## Батарея
The `battery` module shows how charged the device's battery is and its current charging status. The module is only visible when the device's battery is below 10%. Модуль `battery` показывает насколько заряжена батарея девайса и статус зарядки на данный момент. Модуль виден только, если заряд батареи устройства меньше 10%.
### Опции ### Опции
@ -333,7 +333,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 ```toml
[[battery.display]] [[battery.display]]
@ -343,7 +343,7 @@ style = "bold red"
#### Опции #### Опции
The `display` option is an array of the following table. Опция `display` представляет собой массив следующей таблицы.
| Параметр | Описание | | Параметр | Описание |
| ----------- | -------------------------------------------------------- | | ----------- | -------------------------------------------------------- |
@ -367,9 +367,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 color (`red`/`green`)
- changing shape (`❯`/`✖`) - changing shape (`❯`/`✖`)
@ -452,19 +452,19 @@ The `cmake` module shows the currently installed version of CMake. By default th
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
## Длительность команды ## Длительность команды
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)`, а затем продолжайте нормально.
### Опции ### Опции
@ -491,7 +491,7 @@ Showing desktop notifications requires starship to be built with `rust-notify` s
| duration | `16m40s` | The time it took to execute the command | | duration | `16m40s` | The time it took to execute the command |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -505,11 +505,11 @@ 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 ::: 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`.
::: :::
@ -532,7 +532,7 @@ This does not suppress conda's own prompt modifier, you may want to run `conda c
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -545,7 +545,7 @@ format = "[$symbol$environment](dimmed green) "
## Crystal ## Crystal
The `crystal` module shows the currently installed version of Crystal. By default the module will be shown if any of the following conditions are met: Модуль `crystal` показывает установленную версию Crystal. By default the module will be shown if any of the following conditions are met:
- Текущий каталог содержит файл `shard.yml` - Текущий каталог содержит файл `shard.yml`
- Текущий каталог содержит файл `.cr` - Текущий каталог содержит файл `.cr`
@ -560,7 +560,7 @@ The `crystal` module shows the currently installed version of Crystal. By defaul
| `detect_files` | `["shard.yml"]` | Which filenames should trigger this module. | | `detect_files` | `["shard.yml"]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. | | `detect_folders` | `[]` | Which folders should trigger this module. |
| `format` | `"via [$symbol($version )]($style)"` | Формат модуля. | | `format` | `"via [$symbol($version )]($style)"` | Формат модуля. |
| `disabled` | `false` | Disables the `crystal` module. | | `disabled` | `false` | Отключает модуль `crystal`. |
### Переменные ### Переменные
@ -570,7 +570,7 @@ The `crystal` module shows the currently installed version of Crystal. By defaul
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -609,7 +609,7 @@ The `dart` module shows the currently installed version of Dart. By default the
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -622,11 +622,11 @@ 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`.
### Опции ### Опции
@ -643,7 +643,7 @@ For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, an
| `home_symbol` | `"~"` | The symbol indicating home directory. | | `home_symbol` | `"~"` | The symbol indicating home directory. |
<details> <details>
<summary>This module has a few advanced configuration options that control how the directory is displayed.</summary> <summary>Этот модуль имеет несколько расширенных опций конфигурации, которые контролируют отображение каталога.</summary>
| Advanced Option | По умолчанию | Описание | | Advanced Option | По умолчанию | Описание |
| --------------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | --------------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@ -659,7 +659,7 @@ For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, an
"src/com/long/java/path" = "mypath" "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`.
</details> </details>
@ -670,7 +670,7 @@ For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, an
| path | `"D:/Projects"` | The current directory path | | path | `"D:/Projects"` | The current directory path |
| style\* | `"black bold dimmed"` | Отражает значение параметра `style` | | style\* | `"black bold dimmed"` | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -684,7 +684,7 @@ truncation_symbol = "…/"
## Контекст Docker ## Контекст 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`.
### Опции ### Опции
@ -707,7 +707,7 @@ The `docker_context` module shows the currently active [Docker context](https://
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -720,7 +720,7 @@ format = "via [🐋 $context](blue bold)"
## Dotnet ## 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.
By default this module will only be shown in your prompt when one or more of the following files are present in the current directory: By default this module will only be shown in your prompt when one or more of the following files are present in the current directory:
@ -736,7 +736,7 @@ By default this module will only be shown in your prompt when one or more of the
You'll also need the .NET Core SDK installed in order to use it correctly. 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 (<https://docs.microsoft.com/en-us/dotnet/standard/frameworks#supported-target-framework-versions>) when there is a csproj file in the current directory. The module will also show the Target Framework Moniker (<https://docs.microsoft.com/en-us/dotnet/standard/frameworks#supported-target-framework-versions>) when there is a csproj file in the current directory.
@ -751,7 +751,7 @@ The module will also show the Target Framework Moniker (<https://docs.microsoft.
| `detect_files` | `["global.json", "project.json", "Directory.Build.props", "Directory.Build.targets", "Packages.props"]` | Which filenames should trigger this module. | | `detect_files` | `["global.json", "project.json", "Directory.Build.props", "Directory.Build.targets", "Packages.props"]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this modules. | | `detect_folders` | `[]` | Which folders should trigger this modules. |
| `style` | `"bold blue"` | Стиль модуля. | | `style` | `"bold blue"` | Стиль модуля. |
| `disabled` | `false` | Disables the `dotnet` module. | | `disabled` | `false` | Отключает модуль `dotnet`. |
### Переменные ### Переменные
@ -762,7 +762,7 @@ The module will also show the Target Framework Moniker (<https://docs.microsoft.
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -777,7 +777,7 @@ heuristic = false
## Elixir ## Elixir
The `elixir` module shows the currently installed version of Elixir and Erlang/OTP. By default the module will be shown if any of the following conditions are met: Модуль `elixir` показывает установленную версию Elixir и Erlang/OTP. By default the module will be shown if any of the following conditions are met:
- Текущий каталог содержит файл `mix.exs`. - Текущий каталог содержит файл `mix.exs`.
@ -791,7 +791,7 @@ The `elixir` module shows the currently installed version of Elixir and Erlang/O
| `detect_folders` | `[]` | Which folders should trigger this modules. | | `detect_folders` | `[]` | Which folders should trigger this modules. |
| `style` | `"bold purple"` | Стиль модуля. | | `style` | `"bold purple"` | Стиль модуля. |
| `format` | `'via [$symbol($version \(OTP $otp_version\) )]($style)'` | The format for the module elixir. | | `format` | `'via [$symbol($version \(OTP $otp_version\) )]($style)'` | The format for the module elixir. |
| `disabled` | `false` | Disables the `elixir` module. | | `disabled` | `false` | Отключает модуль `elixir`. |
### Переменные ### Переменные
@ -802,7 +802,7 @@ The `elixir` module shows the currently installed version of Elixir and Erlang/O
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -815,7 +815,7 @@ symbol = "🔮 "
## Elm ## Elm
The `elm` module shows the currently installed version of Elm. By default the module will be shown if any of the following conditions are met: Модуль `elm` показывает установленную версию Elm. By default the module will be shown if any of the following conditions are met:
- Текущий каталог содержит файл `elm.json` - Текущий каталог содержит файл `elm.json`
- Текущий каталог содержит файл `elm-package.json` - Текущий каталог содержит файл `elm-package.json`
@ -833,7 +833,7 @@ The `elm` module shows the currently installed version of Elm. By default the mo
| `detect_files` | `["elm.json", "elm-package.json", ".elm-version"]` | Which filenames should trigger this module. | | `detect_files` | `["elm.json", "elm-package.json", ".elm-version"]` | Which filenames should trigger this module. |
| `detect_folders` | `["elm-stuff"]` | Which folders should trigger this modules. | | `detect_folders` | `["elm-stuff"]` | Which folders should trigger this modules. |
| `style` | `"cyan bold"` | Стиль модуля. | | `style` | `"cyan bold"` | Стиль модуля. |
| `disabled` | `false` | Disables the `elm` module. | | `disabled` | `false` | Отключает модуль `elm`. |
### Переменные ### Переменные
@ -843,7 +843,7 @@ The `elm` module shows the currently installed version of Elm. By default the mo
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -856,7 +856,7 @@ 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` соответствует существующей переменной среды
- Опция `variable` не определена, но определена опция `default` - Опция `variable` не определена, но определена опция `default`
@ -879,7 +879,7 @@ The `env_var` module displays the current value of a selected environment variab
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | `black bold dimmed` | Отражает значение параметра `style` | | style\* | `black bold dimmed` | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -918,7 +918,7 @@ The `erlang` module shows the currently installed version of Erlang/OTP. By defa
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -954,7 +954,7 @@ The `gcloud` module shows the current configuration for [`gcloud`](https://cloud
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Примеры ### Примеры
@ -991,7 +991,7 @@ asia-northeast1 = "an1"
## Ветвь Git ## Ветвь Git
The `git_branch` module shows the active branch of the repo in your current directory. Модуль `git_branch` показывает активную ветку репозитория в вашем текущей директории.
### Опции ### Опции
@ -1016,7 +1016,7 @@ The `git_branch` module shows the active branch of the repo in your current dire
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -1052,7 +1052,7 @@ The `git_commit` module shows the current commit hash and also the tag (if any)
| hash | `b703eb3` | The current git commit hash | | hash | `b703eb3` | The current git commit hash |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -1066,7 +1066,7 @@ tag_symbol = "🔖 "
## Состояние Git ## Состояние 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), эта информация также будет показана.
### Опции ### Опции
@ -1092,7 +1092,7 @@ The `git_state` module will show in directories which are part of a git reposito
| progress_total | `2` | The total operation progress | | progress_total | `2` | The total operation progress |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -1106,7 +1106,7 @@ cherry_pick = "[🍒 PICKING](bold red)"
## Статус Git ## Статус Git
The `git_status` module shows symbols representing the state of the repo in your current directory. Модуль `git_status` отображает символы, представляющие состояние репозитория в вашей текущей директории.
### Опции ### Опции
@ -1143,7 +1143,7 @@ The following variables can be used in `format`:
| `deleted` | Displays `deleted` when a file's deletion has been added to the staging area. | | `deleted` | Displays `deleted` when a file's deletion has been added to the staging area. |
| style\* | Отражает значение параметра `style` | | style\* | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
The following variables can be used in `diverged`: The following variables can be used in `diverged`:
@ -1176,7 +1176,7 @@ renamed = "👅"
deleted = "🗑" deleted = "🗑"
``` ```
Show ahead/behind count of the branch being tracked Показывать счетчик впереди/позади для отслеживаемой ветки
```toml ```toml
# ~/.config/starship.toml # ~/.config/starship.toml
@ -1189,7 +1189,7 @@ behind = "⇣${count}"
## Golang ## Golang
The `golang` module shows the currently installed version of Golang. By default the module will be shown if any of the following conditions are met: Модуль `golang` показывает установленную версию Golang. By default the module will be shown if any of the following conditions are met:
- Текущий каталог содержит файл `go.mod` - Текущий каталог содержит файл `go.mod`
- Текущий каталог содержит файл `go.sum` - Текущий каталог содержит файл `go.sum`
@ -1210,7 +1210,7 @@ The `golang` module shows the currently installed version of Golang. By default
| `detect_files` | `["go.mod", "go.sum", "glide.yaml", "Gopkg.yml", "Gopkg.lock", ".go-version"]` | Which filenames should trigger this module. | | `detect_files` | `["go.mod", "go.sum", "glide.yaml", "Gopkg.yml", "Gopkg.lock", ".go-version"]` | Which filenames should trigger this module. |
| `detect_folders` | `["Godeps"]` | Which folders should trigger this module. | | `detect_folders` | `["Godeps"]` | Which folders should trigger this module. |
| `style` | `"bold cyan"` | Стиль модуля. | | `style` | `"bold cyan"` | Стиль модуля. |
| `disabled` | `false` | Disables the `golang` module. | | `disabled` | `false` | Отключает модуль `golang`. |
### Переменные ### Переменные
@ -1220,7 +1220,7 @@ The `golang` module shows the currently installed version of Golang. By default
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -1258,7 +1258,7 @@ The `helm` module shows the currently installed version of Helm. By default the
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -1271,7 +1271,7 @@ format = "via [⎈ $version](bold white) "
## Имя хоста ## Имя хоста
The `hostname` module shows the system hostname. Модуль `hostname` отображает имя системы (хоста).
### Опции ### Опции
@ -1290,7 +1290,7 @@ The `hostname` module shows the system hostname.
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -1306,7 +1306,7 @@ disabled = false
## Java ## Java
The `java` module shows the currently installed version of Java. By default the module will be shown if any of the following conditions are met: Модуль `java` показывает установленную версию Java. By default the module will be shown if any of the following conditions are met:
- 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 `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 - The current directory contains a file with the `.java`, `.class`, `.gradle`, `.jar`, `.clj`, or `.cljc` extension
@ -1321,7 +1321,7 @@ The `java` module shows the currently installed version of Java. By default the
| `detect_folders` | `[]` | Which folders should trigger this modules. | | `detect_folders` | `[]` | Which folders should trigger this modules. |
| `symbol` | `"☕ "` | A format string representing the symbol of Java | | `symbol` | `"☕ "` | A format string representing the symbol of Java |
| `style` | `"red dimmed"` | Стиль модуля. | | `style` | `"red dimmed"` | Стиль модуля. |
| `disabled` | `false` | Disables the `java` module. | | `disabled` | `false` | Отключает модуль `java`. |
### Переменные ### Переменные
@ -1331,7 +1331,7 @@ The `java` module shows the currently installed version of Java. By default the
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -1344,7 +1344,7 @@ 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`, если оно существует.
::: warning ::: warning
@ -1370,7 +1370,7 @@ This module is not supported on tcsh.
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -1410,7 +1410,7 @@ The `julia` module shows the currently installed version of Julia. By default th
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -1448,7 +1448,7 @@ The `kotlin` module shows the currently installed version of Kotlin. By default
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -1473,7 +1473,7 @@ Displays the current Kubernetes context name and, if set, the namespace from the
::: tip ::: tip
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. По умолчанию этот модуль отключен. Чтобы включить его, установите `disabled` на `false` в файле конфигурации.
::: :::
@ -1496,7 +1496,7 @@ This module is disabled by default. To enable it, set `disabled` to `false` in y
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -1512,7 +1512,7 @@ disabled = false
## Перевод Строки ## Перевод Строки
The `line_break` module separates the prompt into two lines. Модуль `line_break` разделяет командную строку на две строки.
### Опции ### Опции
@ -1558,7 +1558,7 @@ The `lua` module shows the currently installed version of Lua. By default the mo
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -1571,13 +1571,13 @@ format = "via [🌕 $version](bold blue) "
## Использование памяти ## Использование памяти
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` в файле конфигурации.
::: :::
@ -1618,7 +1618,7 @@ style = "bold dimmed green"
## Ветка Mercurial ## Ветка Mercurial
The `hg_branch` module shows the active branch of the repo in your current directory. Модуль `hg_branch` показывает активную ветку репозитория в вашем текущем каталоге.
### Опции ### Опции
@ -1639,7 +1639,7 @@ The `hg_branch` module shows the active branch of the repo in your current direc
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -1681,7 +1681,7 @@ The `nim` module shows the currently installed version of Nim. By default the mo
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -1695,7 +1695,7 @@ symbol = "🎣 "
## Nix-shell ## 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.
### Опции ### Опции
@ -1717,7 +1717,7 @@ The `nix_shell` module shows the nix-shell environment. The module will be shown
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -1733,7 +1733,7 @@ format = 'via [☃️ $state( \($name\))](bold blue) '
## NodeJS ## NodeJS
The `nodejs` module shows the currently installed version of NodeJS. By default the module will be shown if any of the following conditions are met: Модуль `nodejs` показывает установленную версию NodeJS. By default the module will be shown if any of the following conditions are met:
- Текущий каталог содержит файл `package.json` - Текущий каталог содержит файл `package.json`
- The current directory contains a `.node-version` file - The current directory contains a `.node-version` file
@ -1751,7 +1751,7 @@ The `nodejs` module shows the currently installed version of NodeJS. By default
| `detect_files` | `["package.json", ".node-version"]` | Which filenames should trigger this module. | | `detect_files` | `["package.json", ".node-version"]` | Which filenames should trigger this module. |
| `detect_folders` | `["node_modules"]` | Which folders should trigger this module. | | `detect_folders` | `["node_modules"]` | Which folders should trigger this module. |
| `style` | `"bold green"` | Стиль модуля. | | `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 `package.json` does not match the NodeJS version. | | `not_capable_style` | `bold red` | The style for the module when an engines property in `package.json` does not match the NodeJS version. |
### Переменные ### Переменные
@ -1762,7 +1762,7 @@ The `nodejs` module shows the currently installed version of NodeJS. By default
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -1808,7 +1808,7 @@ The `ocaml` module shows the currently installed version of OCaml. By default th
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -1841,7 +1841,7 @@ The `openstack` module shows the current OpenStack cloud and project. The module
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -1856,7 +1856,7 @@ symbol = "☁️ "
## Версия пакета ## Версия пакета
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** – Версия пакета `npm` из файла `package.json` в текущем каталоге - **npm** – Версия пакета `npm` из файла `package.json` в текущем каталоге
- **cargo** – Версия пакета `cargo` из файла `Cargo.toml` в текущем каталоге - **cargo** – Версия пакета `cargo` из файла `Cargo.toml` в текущем каталоге
@ -1889,7 +1889,7 @@ The `package` module is shown when the current directory is the repository for a
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -1941,7 +1941,7 @@ format = "via [🦪 $version]($style) "
## PHP ## PHP
The `php` module shows the currently installed version of PHP. By default the module will be shown if any of the following conditions are met: Модуль `php` показывает установленную версию PHP. By default the module will be shown if any of the following conditions are met:
- Текущий каталог содержит файл `composer.json` - Текущий каталог содержит файл `composer.json`
- Текущий каталог содержит файл `.php-version` - Текущий каталог содержит файл `.php-version`
@ -1957,7 +1957,7 @@ The `php` module shows the currently installed version of PHP. By default the mo
| `detect_files` | `["composer.json", ".php-version"]` | Which filenames should trigger this module. | | `detect_files` | `["composer.json", ".php-version"]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. | | `detect_folders` | `[]` | Which folders should trigger this module. |
| `style` | `"147 bold"` | Стиль модуля. | | `style` | `"147 bold"` | Стиль модуля. |
| `disabled` | `false` | Disables the `php` module. | | `disabled` | `false` | Отключает модуль `php`. |
### Переменные ### Переменные
@ -1967,7 +1967,7 @@ The `php` module shows the currently installed version of PHP. By default the mo
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -2005,7 +2005,7 @@ The `purescript` module shows the currently installed version of PureScript vers
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -2025,13 +2025,13 @@ If `pyenv_version_name` is set to `true`, it will display the pyenv version name
By default the module will be shown if any of the following conditions are met: By default the module will be shown if any of the following conditions are met:
- Текущий каталог содержит файл `.python-version` - Текущий каталог содержит файл `.python-version`
- The current directory contains a `Pipfile` file - Текущий каталог содержит файл `Pipfile`
- The current directory contains a `__init__.py` file - The current directory contains a `__init__.py` file
- The current directory contains a `pyproject.toml` file - Текущий каталог содержит файл `pyproject.toml`
- The current directory contains a `requirements.txt` file - Текущий каталог содержит файл `requirements.txt`
- The current directory contains a `setup.py` file - Текущий каталог содержит файл `setup.py`
- The current directory contains a `tox.ini` file - Текущий каталог содержит файл `tox.ini`
- The current directory contains a file with the `.py` extension. - Текущий каталог содержит файл с расширением `.py`.
- Виртуальная среда в данный момент активирована - Виртуальная среда в данный момент активирована
### Опции ### Опции
@ -2095,7 +2095,7 @@ detect_extensions = []
## Ruby ## Ruby
By default the `ruby` module shows the currently installed version of Ruby. The module will be shown if any of the following conditions are met: By default the `ruby` module shows the currently installed version of Ruby. Модуль будет показан, если любое из следующих условий соблюдено:
- Текущий каталог содержит файл `Gemfile` - Текущий каталог содержит файл `Gemfile`
- Текущий каталог содержит файл `.ruby-version` - Текущий каталог содержит файл `.ruby-version`
@ -2111,7 +2111,7 @@ By default the `ruby` module shows the currently installed version of Ruby. The
| `detect_files` | `["Gemfile", ".ruby-version"]` | Which filenames should trigger this module. | | `detect_files` | `["Gemfile", ".ruby-version"]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. | | `detect_folders` | `[]` | Which folders should trigger this module. |
| `style` | `"bold red"` | Стиль модуля. | | `style` | `"bold red"` | Стиль модуля. |
| `disabled` | `false` | Disables the `ruby` module. | | `disabled` | `false` | Отключает модуль `ruby`. |
### Переменные ### Переменные
@ -2121,7 +2121,7 @@ By default the `ruby` module shows the currently installed version of Ruby. The
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -2134,7 +2134,7 @@ symbol = "🔺 "
## Rust ## Rust
By default the `rust` module shows the currently installed version of Rust. The module will be shown if any of the following conditions are met: By default the `rust` module shows the currently installed version of Rust. Модуль будет показан, если любое из следующих условий соблюдено:
- Текущий каталог содержит файл `Cargo.toml` - Текущий каталог содержит файл `Cargo.toml`
- Текущий каталог содержит файл с расширением `.rs` - Текущий каталог содержит файл с расширением `.rs`
@ -2149,7 +2149,7 @@ By default the `rust` module shows the currently installed version of Rust. The
| `detect_files` | `["Cargo.toml"]` | Which filenames should trigger this module. | | `detect_files` | `["Cargo.toml"]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. | | `detect_folders` | `[]` | Which folders should trigger this module. |
| `style` | `"bold red"` | Стиль модуля. | | `style` | `"bold red"` | Стиль модуля. |
| `disabled` | `false` | Disables the `rust` module. | | `disabled` | `false` | Отключает модуль `rust`. |
### Переменные ### Переменные
@ -2159,7 +2159,7 @@ By default the `rust` module shows the currently installed version of Rust. The
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -2198,7 +2198,7 @@ The `scala` module shows the currently installed version of Scala. By default th
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -2215,7 +2215,7 @@ The `shell` module shows an indicator for currently used shell.
::: tip ::: tip
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. По умолчанию этот модуль отключен. Чтобы включить его, установите `disabled` на `false` в файле конфигурации.
::: :::
@ -2273,7 +2273,7 @@ The `shlvl` module shows the current `SHLVL` ("shell level") environment variabl
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -2288,7 +2288,7 @@ threshold = 3
## Singularity ## Singularity
The `singularity` module shows the current singularity image, if inside a container and `$SINGULARITY_NAME` is set. Модуль `singularity` показывает текущий образ singularity, если внутри контейнера и `$SINGULARITY_NAME` установлена.
### Опции ### Опции
@ -2307,7 +2307,7 @@ The `singularity` module shows the current singularity image, if inside a contai
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -2324,7 +2324,7 @@ The `status` module displays the exit code of the previous command. The module w
::: tip ::: tip
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. По умолчанию этот модуль отключен. Чтобы включить его, установите `disabled` на `false` в файле конфигурации.
::: :::
@ -2358,7 +2358,7 @@ This module is disabled by default. To enable it, set `disabled` to `false` in y
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -2377,7 +2377,7 @@ disabled = false
## Swift ## Swift
By default the `swift` module shows the currently installed version of Swift. The module will be shown if any of the following conditions are met: By default the `swift` module shows the currently installed version of Swift. Модуль будет показан, если любое из следующих условий соблюдено:
- The current directory contains a `Package.swift` file - The current directory contains a `Package.swift` file
- The current directory contains a file with the `.swift` extension - The current directory contains a file with the `.swift` extension
@ -2402,7 +2402,7 @@ By default the `swift` module shows the currently installed version of Swift. Th
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -2415,7 +2415,7 @@ format = "via [🏎 $version](red bold)"
## Terraform ## Terraform
The `terraform` module shows the currently selected terraform workspace and version. Модуль `terraform` показывает выбранную рабочую область и версию terraform.
::: tip ::: tip
@ -2425,7 +2425,7 @@ By default the terraform version is not shown, since this is slow for current ve
By default the module will be shown if any of the following conditions are met: By default the module will be shown if any of the following conditions are met:
- The current directory contains a `.terraform` folder - Текущий каталог содержит папку `.terraform`
- Current directory contains a file with the `.tf` or `.hcl` extensions - Current directory contains a file with the `.tf` or `.hcl` extensions
### Опции ### Опции
@ -2438,7 +2438,7 @@ By default the module will be shown if any of the following conditions are met:
| `detect_files` | `[]` | Which filenames should trigger this module. | | `detect_files` | `[]` | Which filenames should trigger this module. |
| `detect_folders` | `[".terraform"]` | Which folders should trigger this module. | | `detect_folders` | `[".terraform"]` | Which folders should trigger this module. |
| `style` | `"bold 105"` | Стиль модуля. | | `style` | `"bold 105"` | Стиль модуля. |
| `disabled` | `false` | Disables the `terraform` module. | | `disabled` | `false` | Отключает модуль `terraform`. |
### Переменные ### Переменные
@ -2449,7 +2449,7 @@ By default the module will be shown if any of the following conditions are met:
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -2473,36 +2473,36 @@ format = "[🏎💨 $workspace]($style) "
## Время ## Время
The `time` module shows the current **local** time. The `format` configuration value is used by the [`chrono`](https://crates.io/crates/chrono) crate to control how the time is displayed. Take a look [at the chrono strftime docs](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) to see what options are available. Модуль `time` показывает текущее **локальное** время. Значение конфигурации `format` используется пакетом [`chrono`](https://crates.io/crates/chrono) для контроля того, как отображается время. Ознакомьтесь с [документацией chrono strftime](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html), чтобы увидеть доступные параметры.
::: tip ::: 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. | | `format` | `"at [$time]($style) "` | The format string for the module. |
| `use_12hr` | `false` | Enables 12 hour formatting | | `use_12hr` | `false` | Включить 12-часовое форматирование |
| `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. | | `time_format` | см. ниже | [Строка формата chrono](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html), используемая для форматирования времени. |
| `style` | `"bold yellow"` | The style for the module time | | `style` | `"bold yellow"` | Стиль модуля времени |
| `utc_time_offset` | `"local"` | Sets the UTC offset to use. Range from -24 &lt; x &lt; 24. Allows floats to accommodate 30/45 minute timezone offsets. | | `utc_time_offset` | `"local"` | Устанавливает смещение UTC. Range from -24 &lt; x &lt; 24. Разрешает числам с плавающей точкой встраивать 30/45-минутное смещение временной зоны. |
| `disabled` | `true` | Disables the `time` module. | | `disabled` | `true` | Отключает модуль `time`. |
| `time_range` | `"-"` | Sets the time range during which the module will be shown. Times must be specified in 24-hours format | | `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. If `use_12hr` is `true`, then `time_format` defaults to `"%r"`. Иначе по умолчанию используется `"%T"`. Manually setting `time_format` will override the `use_12hr` setting.
### Переменные ### Переменные
| Переменная | Пример | Описание | | Переменная | Пример | Описание |
| ---------- | ---------- | ----------------------------------- | | ---------- | ---------- | ----------------------------------- |
| time | `13:08:10` | The current time. | | время | `13:08:10` | The current time. |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -2517,14 +2517,14 @@ utc_time_offset = "-5"
time_range = "10:00:00-14:00:00" time_range = "10:00:00-14:00:00"
``` ```
## Username ## Имя пользователя
The `username` module shows active user's username. The module will be shown if any of the following conditions are met: Модуль `username` показывает имя текущего пользователя. Модуль будет показан, если любое из следующих условий соблюдено:
- The current user is root - Текущий пользователь - root
- The current user isn't the same as the one that is logged in - Текущий пользователь отличается от залогиненного
- The user is currently connected as an SSH session - Пользователь подключен к SSH-сессии
- The variable `show_always` is set to true - Переменная `show_always` равна true
::: tip ::: tip
@ -2535,12 +2535,12 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
### Опции ### Опции
| Параметр | По умолчанию | Описание | | Параметр | По умолчанию | Описание |
| ------------- | ----------------------- | ------------------------------------- | | ------------- | ----------------------- | ------------------------------------------------------- |
| `style_root` | `"bold red"` | The style used when the user is root. | | `style_root` | `"bold red"` | Стиль, используемый для пользователя root. |
| `style_user` | `"bold yellow"` | The style used for non-root users. | | `style_user` | `"bold yellow"` | Стиль, используемый для всех пользователей, кроме root. |
| `format` | `"[$user]($style) in "` | Формат модуля. | | `format` | `"[$user]($style) in "` | Формат модуля. |
| `show_always` | `false` | Always shows the `username` module. | | `show_always` | `false` | Всегда показывать модуль `username`. |
| `disabled` | `false` | Disables the `username` module. | | `disabled` | `false` | Отключает модуль `username`. |
### Переменные ### Переменные
@ -2588,7 +2588,7 @@ The `vagrant` module shows the currently installed version of Vagrant. By defaul
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -2620,7 +2620,7 @@ The `vcsh` module displays the current active VCSH repository. The module will b
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | `black bold dimmed` | Отражает значение параметра `style` | | style\* | `black bold dimmed` | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -2633,7 +2633,7 @@ format = "[🆅 $repo](bold blue) "
## Zig ## Zig
By default the the `zig` module shows the currently installed version of Zig. The module will be shown if any of the following conditions are met: By default the the `zig` module shows the currently installed version of Zig. Модуль будет показан, если любое из следующих условий соблюдено:
- The current directory contains a `.zig` file - The current directory contains a `.zig` file
@ -2657,7 +2657,7 @@ By default the the `zig` module shows the currently installed version of Zig. Th
| symbol | | Отражает значение параметра `symbol` | | symbol | | Отражает значение параметра `symbol` |
| style\* | | Отражает значение параметра `style` | | style\* | | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
### Пример ### Пример
@ -2721,7 +2721,7 @@ The order in which custom modules are shown can be individually set by including
| symbol | Отражает значение параметра `symbol` | | symbol | Отражает значение параметра `symbol` |
| style\* | Отражает значение параметра `style` | | style\* | Отражает значение параметра `style` |
\*: This variable can only be used as a part of a style string \*: Эта переменная может использоваться только в качестве части строки style
#### Custom command shell #### Custom command shell

4
docs/ru-RU/faq/README.md
View File

@ -38,7 +38,7 @@ NUM_JOBS=$(jobs -p | wc -l)
PS1="$(starship prompt --status=$STATUS --jobs=$NUM_JOBS)" PS1="$(starship prompt --status=$STATUS --jobs=$NUM_JOBS)"
``` ```
The [Bash implementation](https://github.com/starship/starship/blob/master/src/init/starship.bash) built into Starship is slightly more complex to allow for advanced features like the [Command Duration module](https://starship.rs/config/#command-duration) and to ensure that Starship is compatible with pre-installed Bash configurations. [Реализация для Bash](https://github.com/starship/starship/blob/master/src/init/starship.bash), встроенная в Starship, несколько сложнее, чтобы предоставить дополнительные возможности, такие как [модуль длительности команды](https://starship.rs/config/#command-duration) и обеспечить совместимость Starship с заранее установленными конфигурациями Bash.
Для списка всех флагов, принимаемых `starship prompt`, используйте следующую команду: Для списка всех флагов, принимаемых `starship prompt`, используйте следующую команду:
@ -92,5 +92,5 @@ If Starship was installed using the `curl | bash` script, the following command
```sh ```sh
# Locate and delete the starship binary # Locate and delete the starship binary
bash -c 'rm "$(which starship)"' sh -c 'rm "$(which starship)"'
``` ```

2
docs/tr-TR/faq/README.md
View File

@ -92,5 +92,5 @@ If Starship was installed using the `curl | bash` script, the following command
```sh ```sh
# Locate and delete the starship binary # Locate and delete the starship binary
bash -c 'rm "$(which starship)"' sh -c 'rm "$(which starship)"'
``` ```

2
docs/vi-VN/README.md
View File

@ -45,7 +45,7 @@ description: Starship là prompt nhỏ, cực nhanh, và khả năng tuỳ biế
#### Cài đặt thông qua Trình quản lí gói #### Cài đặt thông qua Trình quản lí gói
With [Homebrew](https://brew.sh/): Với [Homebrew](https://brew.sh/):
```sh ```sh
brew install starship brew install starship

264
docs/vi-VN/config/README.md
View File

@ -260,7 +260,7 @@ When using [awsu](https://github.com/kreuzwerker/awsu) the profile is read from
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Các vị dụ ### Các vị dụ
@ -305,7 +305,7 @@ symbol = "🅰 "
## Battery ## Battery
The `battery` module shows how charged the device's battery is and its current charging status. The module is only visible when the device's battery is below 10%. `battery` module cho biết cách sạc pin của thiết bị là gì và tình trạng sạc hiện tại của nó. Module chỉ được nhìn thấy khi pin của thiết bị dưới 10%.
### Các tuỳ chọn ### Các tuỳ chọn
@ -333,7 +333,7 @@ discharging_symbol = "💀 "
### Hiển thị pin ### Hiển thị pin
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. Mặc định như sau: Tuỳ chọn cấu hình `display` được sử dụng để định nghĩa khi nào pin nên cho biết (threshold) và nó trông như thế nào (style). Nếu `display` không được cung cấp. Mặc định như sau:
```toml ```toml
[[battery.display]] [[battery.display]]
@ -343,7 +343,7 @@ style = "bold red"
#### Các tuỳ chọn #### Các tuỳ chọn
The `display` option is an array of the following table. Tuỳ chọn `display` là một mảng của của bảng sau.
| Tuỳ chọn | Mô tả | | Tuỳ chọn | Mô tả |
| ----------- | ---------------------------------------------------------- | | ----------- | ---------------------------------------------------------- |
@ -367,16 +367,16 @@ style = "bold yellow"
## Character ## Character
The `character` module shows a character (usually an arrow) beside where the text is entered in your terminal. Module `character` cho biết một kí tự (thường là một mũi tên) bên cạnh nơi văn bản được nhập trong terminal của bạn.
The character will tell you whether the last command was successful or not. It can do this in two ways: Kí tự sẽ nói cho bạn câu lệnh cuối liệu thành công hay thất bại. Nó có thể làm điều này bằng hai cách:
- thay đổi màu(`đỏ`/`xanh lá`) - thay đổi màu(`đỏ`/`xanh lá`)
- thay đổi hình dạng (`❯`/`✖`) - thay đổi hình dạng (`❯`/`✖`)
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). Mặc định, nó chỉ thay đổi màu. Nếu bạn cũng muốn thay đổi hình dạng, tham khảo [ví dụ này](#with-custom-error-shape).
::: warning `error_symbol` is not supported on elvish shell. ::: ::: warning `error_symbol` không được hỗ trợ trên elvish shell. :::
### Các tuỳ chọn ### Các tuỳ chọn
@ -427,7 +427,7 @@ vicmd_symbol = "[V](bold green) "
## CMake ## CMake
The `cmake` module shows the currently installed version of CMake. By default the module will be activated if any of the following conditions are met: `cmake` module cho biết phiên bản Cmake hiện tại đã được cài đặt. Mặc định module sẽ được kích hoạt nếu thoả mãn bất kì điều kiện nào dưới đây:
- Đường dẫn hiện tại chứa một tập tin `CmakeLists.txt` - Đường dẫn hiện tại chứa một tập tin `CmakeLists.txt`
- Đường dẫn hiện tại chứa một tập tin `CMakeCache.txt` - Đường dẫn hiện tại chứa một tập tin `CMakeCache.txt`
@ -435,10 +435,10 @@ The `cmake` module shows the currently installed version of CMake. By default th
### Các tuỳ chọn ### Các tuỳ chọn
| Tuỳ chọn | Mặc định | Mô tả | | Tuỳ chọn | Mặc định | Mô tả |
| ------------------- | -------------------------------------- | ------------------------------------------- | | ------------------- | -------------------------------------- | -------------------------------------------------- |
| `format` | `"via [$symbol($version )]($style)"` | Định dạng cho module. | | `format` | `"via [$symbol($version )]($style)"` | Định dạng cho module. |
| `symbol` | `"△ "` | Kí hiệu sử dụng trước phiên bản của cmake. | | `symbol` | `"△ "` | Kí hiệu sử dụng trước phiên bản của cmake. |
| `detect_extensions` | `[]` | Which extensions should trigger this module | | `detect_extensions` | `[]` | Những tiện ích mở rộng nào sẽ kích hoạt mô-đun này |
| `detect_files` | `["CMakeLists.txt", "CMakeCache.txt"]` | Tên tệp nào sẽ kích hoạt mô-đun này | | `detect_files` | `["CMakeLists.txt", "CMakeCache.txt"]` | Tên tệp nào sẽ kích hoạt mô-đun này |
| `detect_folders` | `[]` | Thư mục nào sẽ kích hoạt mô-đun này | | `detect_folders` | `[]` | Thư mục nào sẽ kích hoạt mô-đun này |
| `style` | `"bold blue"` | Kiểu cho module. | | `style` | `"bold blue"` | Kiểu cho module. |
@ -452,19 +452,19 @@ The `cmake` module shows the currently installed version of CMake. By default th
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
## Command Duration ## 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. Module `cmd_duration`. cho biết câu lệnh cuối cùng thực thi trong bao lâu. Module sẽ được hiện chỉ khi câu lệnh lấy nhiều hơn 2 giây, hoặc giá trị cấu hình `min_time`, nếu nó tồn tại.
::: warning Do not hook the DEBUG trap in Bash ::: cảnh báo Không thể hook DEBUG trap trong 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. Nếu bạn đang chạy Starship trong `bash`, không thể hook `DEBUG` trap sau khi chạy `eval $(starship init $0)`, hoặc module này **sẽ** ngắt.
::: :::
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. Người dùng Bash, những người cần chức năng giống preexec có thể sử dụng [rcaloras's bash_preexec framework](https://github.com/rcaloras/bash-preexec). Đơn giản là định nghĩa các mảng `preexec_functions` và `precmd_functions` trước khi chạy `eval $(starship init $0)`, và sau đó thực thi như bình thường.
### Các tuỳ chọn ### Các tuỳ chọn
@ -478,9 +478,9 @@ Bash users who need preexec-like functionality can use [rcaloras's bash_preexec
| `show_notifications` | `false` | Hiện thông báo desktop khi câu lệnh hoàn thành. | | `show_notifications` | `false` | Hiện thông báo desktop khi câu lệnh hoàn thành. |
| `min_time_to_notify` | `45_000` | Khoảng thời gian ngắn nhất để thông báo (tính bằng milliseconds). | | `min_time_to_notify` | `45_000` | Khoảng thời gian ngắn nhất để thông báo (tính bằng milliseconds). |
::: tip ::: thử thuật
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`. Hiện thông báo desktop yêu cầu starship được built với sự hỗ trợ của `rust-notify`. Bạn kiểm tra nếu starship hỗ trợ các thông báo bằng cách chạy `STARSHIP_LOG=debug starship module cmd_duration -d 60000` khi `show_notifications` được thiết lập là `true`.
::: :::
@ -491,7 +491,7 @@ Showing desktop notifications requires starship to be built with `rust-notify` s
| duration | `16m40s` | Thời gian nó lấy để thực thi câu lệnh | | duration | `16m40s` | Thời gian nó lấy để thực thi câu lệnh |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -505,11 +505,11 @@ format = "underwent [$duration](bold yellow)"
## Conda ## Conda
The `conda` module shows the current conda environment, if `$CONDA_DEFAULT_ENV` is set. Module `conda` cho biết môi trường conda hiện tại, nếu `$CONDA_DEFAULT_ENV` được thiết lập.
::: tip ::: thử thuật
This does not suppress conda's own prompt modifier, you may want to run `conda config --set changeps1 False`. Cái này không loại bỏ conda's prompt mà nó sở hữu, bạn có thể muốn chạy `conda config --set changeps1 False`.
::: :::
@ -532,7 +532,7 @@ This does not suppress conda's own prompt modifier, you may want to run `conda c
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -545,7 +545,7 @@ format = "[$symbol$environment](dimmed green) "
## Crystal ## Crystal
The `crystal` module shows the currently installed version of Crystal. Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn: Module `crystal` cho biết phiên bản hiện tại của Crystal được đã cài đặt. Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn:
- Đường dẫn hiện tại chứa một tập tin `shard.yml` - Đường dẫn hiện tại chứa một tập tin `shard.yml`
- Đường dẫn hiện tại chứa một tập tin `.cr` - Đường dẫn hiện tại chứa một tập tin `.cr`
@ -570,7 +570,7 @@ The `crystal` module shows the currently installed version of Crystal. Mặc đ
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -583,7 +583,7 @@ format = "via [✨ $version](bold blue) "
## Dart ## Dart
The `dart` module shows the currently installed version of Dart. Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn: Module `dart` cho biết phiên bản của Dart đã cài đặt. Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn:
- Đường dẫn hiện tại chứa một tập tin với phần mở rộng `.dart` - Đường dẫn hiện tại chứa một tập tin với phần mở rộng `.dart`
- Đường dẫn hiện tại chứa một đường dẫn `.dart_tool` - Đường dẫn hiện tại chứa một đường dẫn `.dart_tool`
@ -609,7 +609,7 @@ The `dart` module shows the currently installed version of Dart. Mặc định m
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -622,11 +622,11 @@ format = "via [🔰 $version](bold red) "
## Đường dẫn ## Đường dẫn
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` module hiển thị đường dẫn thư mục hiện hành của bạn,, cắt ngắn ba thư mục cha. Đường dẫn của bạn cũng sẽ được cắt ngắn tới đường dẫn gốc của git repo hiện tại của bạn.
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. Khi sử dụng fish style pwd option, thay vì ẩn đường dẫn được rút gọn, bạn sẽ thấy một tên ngắn cho mỗi thư mục dựa trên số bạn cho phép trng tùy chọ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`. Cho ví dụ, `~/Dev/Nix/nixpkgs/pkgs` nơi `nixpkgs` là gốc của repo, và tuỳ chọn thiết lập sang `1`. Bây giờ bạn sẽ thấy `~/D/N/nixpkgs/pkgs`, trong khi trước nó là `nixpkgs/pkgs`.
### Các tuỳ chọn ### Các tuỳ chọn
@ -643,7 +643,7 @@ For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, an
| `home_symbol` | `"~"` | Biểu tượng nhận biết thư mục home. | | `home_symbol` | `"~"` | Biểu tượng nhận biết thư mục home. |
<details> <details>
<summary>This module has a few advanced configuration options that control how the directory is displayed.</summary> <summary>Mô đun này có một vài tùy chọn nâng cao để điều khiển cách thư mục được hiển thị.</summary>
| Tùy chọn nâng cao | Mặc định | Mô tả | | Tùy chọn nâng cao | Mặc định | Mô tả |
| --------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | --------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@ -670,7 +670,7 @@ For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, an
| path | `"D:/Projects"` | Đường dẫn thư mục hiện tại | | path | `"D:/Projects"` | Đường dẫn thư mục hiện tại |
| style\* | `"black bold dimmed"` | Giá trị ghi đè của `style` | | style\* | `"black bold dimmed"` | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -684,7 +684,7 @@ truncation_symbol = "…/"
## Docker Context ## 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`. Mô đun `docker_context` hiển thị [Docker context](https://docs.docker.com/engine/context/working-with-contexts/) hiện tại được kích hoạt nếu nó không được thiết lập `mặc định`.
### Các tuỳ chọn ### Các tuỳ chọn
@ -707,7 +707,7 @@ The `docker_context` module shows the currently active [Docker context](https://
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -720,9 +720,9 @@ format = "via [🐋 $context](blue bold)"
## Dotnet ## 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. Mô đun `dotnet` hiển thị phiên bản thích hợp của .NET Core SDK của đường dẫn hiện tại. Nếu SDK được ghim trong thư mục hiện tại, phiên bản ghim đó được hiển thị. Ngược lại, mô đun hiển thị phiên bản cuối cùng của SDK được cài đặt.
By default this module will only be shown in your prompt when one or more of the following files are present in the current directory: Mặc định, mô đun này sẽ chỉ được hiển thị trong dấu nhắc lệnh của bạn khi một hoặc nhiều tệp tin dưới đây xuất hiện trong thư mục hiện tại:
- `global.json` - `global.json`
- `project.json` - `project.json`
@ -734,11 +734,11 @@ By default this module will only be shown in your prompt when one or more of the
- `*.fsproj` - `*.fsproj`
- `*.xproj` - `*.xproj`
You'll also need the .NET Core SDK installed in order to use it correctly. Bạn cũng sẽ cần cài đặt .NET Core SDK đúng cách để sử dụng một cách chính xác.
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. Mô đun này sử dụng cơ chế của bản thân để phát hiện phiên bản của chính nó. Thông thường, nó nhanh gấp đôi nếu chạy `dotnet --version`, nhưng nó có thể hiện sai phiên bản nếu dự án .NET của bạn có một cấu trúc thư mục bất thường. Nếu độ chính xác quan trọng hơn tốc độ, bạn có thể vô hiệu cơ chế bằng cài đặt `heuristic = false` trong các tùy chọn mô đun.
The module will also show the Target Framework Moniker (<https://docs.microsoft.com/en-us/dotnet/standard/frameworks#supported-target-framework-versions>) when there is a csproj file in the current directory. Mô đun cũng sẽ hiện Target Framework Moniker (<https://docs.microsoft.com/en-us/dotnet/standard/frameworks#supported-target-framework-versions>) khi có một tệp tin csproj trong thư mục hiện tại.
### Các tuỳ chọn ### Các tuỳ chọn
@ -762,7 +762,7 @@ The module will also show the Target Framework Moniker (<https://docs.microsoft.
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -777,7 +777,7 @@ heuristic = false
## Elixir ## Elixir
The `elixir` module shows the currently installed version of Elixir and Erlang/OTP. Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn: Module `elixir` cho biết phiên bản của Elixir và Erlang/OTP đã cài đặt. Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn:
- Đường dẫn hiện tại chứa một tập tin `mix.exs`. - Đường dẫn hiện tại chứa một tập tin `mix.exs`.
@ -802,7 +802,7 @@ The `elixir` module shows the currently installed version of Elixir and Erlang/O
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -815,7 +815,7 @@ symbol = "🔮 "
## Elm ## Elm
The `elm` module shows the currently installed version of Elm. Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn: Module `elm` cho biết phiên bản của Elm đã cài đặt. Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn:
- Đường dẫn hiện tại chứa một tập tin `elm.json` - Đường dẫn hiện tại chứa một tập tin `elm.json`
- Đường dẫn hiện tại chứa một tập tin `elm-package.json` - Đường dẫn hiện tại chứa một tập tin `elm-package.json`
@ -843,7 +843,7 @@ The `elm` module shows the currently installed version of Elm. Mặc định mod
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -854,9 +854,9 @@ The `elm` module shows the currently installed version of Elm. Mặc định mod
format = "via [ $version](cyan bold) " format = "via [ $version](cyan bold) "
``` ```
## Environment Variable ## Biến môi trường
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: Mô đun `env_var` hiển thị giá trị hiện tại của biến môi trường được chọn. Mô đun sẽ được hiển thị chỉ khi bất kì điều kiện nào sau đây thỏa mãn:
- Tùy chọn `variable` khớp với mootjj biến môi trường tồn tại - Tùy chọn `variable` khớp với mootjj biến môi trường tồn tại
- Tùy chọn `variable` không được định nghĩa, nhưng tùy chọn `default` là - Tùy chọn `variable` không được định nghĩa, nhưng tùy chọn `default` là
@ -879,7 +879,7 @@ The `env_var` module displays the current value of a selected environment variab
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | `black bold dimmed` | Giá trị ghi đè của `style` | | style\* | `black bold dimmed` | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -893,7 +893,7 @@ default = "unknown shell"
## Erlang ## Erlang
The `erlang` module shows the currently installed version of Erlang/OTP. Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn: Module `erlang` cho biết phiên bản của Erlang/OTP đã cài đặt. Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn:
- Đường dẫn hiện tại chứa một tập tin `rebar.config`. - Đường dẫn hiện tại chứa một tập tin `rebar.config`.
- Đường dẫn hiện tại chứa một tập tin `erlang.mk`. - Đường dẫn hiện tại chứa một tập tin `erlang.mk`.
@ -918,7 +918,7 @@ The `erlang` module shows the currently installed version of Erlang/OTP. Mặc
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -931,7 +931,7 @@ format = "via [e $version](bold red) "
## Gcloud ## 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. Mô đun `gcloud` hiển thị cấu hình hiện tại của [`gcloud`](https://cloud.google.com/sdk/gcloud) CLI. Cái này dựa trên tập tin `~/.config/gcloud/active_config`, `~/.config/gcloud/configurations/config_{CONFIG NAME}` và biến môi trường `CLOUDSDK_CONFIG`.
### Các tuỳ chọn ### Các tuỳ chọn
@ -954,7 +954,7 @@ The `gcloud` module shows the current configuration for [`gcloud`](https://cloud
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Các ví dụ ### Các ví dụ
@ -991,7 +991,7 @@ asia-northeast1 = "an1"
## Git Branch ## Git Branch
The `git_branch` module shows the active branch of the repo in your current directory. Mô đun `git_branch` hiển thị nhánh hiệu lực của repo trong thư mục hiện tại của bạn.
### Các tuỳ chọn ### Các tuỳ chọn
@ -1016,7 +1016,7 @@ The `git_branch` module shows the active branch of the repo in your current dire
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -1031,7 +1031,7 @@ truncation_symbol = ""
## Git Commit ## Git Commit
The `git_commit` module shows the current commit hash and also the tag (if any) of the repo in your current directory. Mô đun `git_commit` hiển thị hash commit hiện tại và tag (nếu có) của repo trong thư mục hiện tại của bạn.
### Các tuỳ chọn ### Các tuỳ chọn
@ -1052,7 +1052,7 @@ The `git_commit` module shows the current commit hash and also the tag (if any)
| hash | `b703eb3` | Git commit hash hiện tại | | hash | `b703eb3` | Git commit hash hiện tại |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -1066,7 +1066,7 @@ tag_symbol = "🔖 "
## Git State ## 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. Mô đun `git_state` sẽ hiển hiển thị trong các thư mục là một phần của gt repository và những nơi tồn tại một hoạt động trong tiến trình như _REBASING_, _BISECTING_. Nếu có thông tin tiến trình (ví dụ, REBASING 3/10), thông tin đó cũng sẽ được hiển thị.
### Các tuỳ chọn ### Các tuỳ chọn
@ -1092,7 +1092,7 @@ The `git_state` module will show in directories which are part of a git reposito
| progress_total | `2` | Tổng số các quá trình | | progress_total | `2` | Tổng số các quá trình |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -1106,7 +1106,7 @@ cherry_pick = "[🍒 PICKING](bold red)"
## Git Status ## Git Status
The `git_status` module shows symbols representing the state of the repo in your current directory. Mô đun `git_status` hiển thị các biểu tượng đại diện cho trạng thái của repo trong thư mục hiện tại của bạn.
### Các tuỳ chọn ### Các tuỳ chọn
@ -1128,7 +1128,7 @@ The `git_status` module shows symbols representing the state of the repo in your
### Các biến ### Các biến
The following variables can be used in `format`: Các biến dưới đây có thể được sử dụng trong `format`:
| Biến | Mô tả | | Biến | Mô tả |
| -------------- | ----------------------------------------------------------------------------------------------- | | -------------- | ----------------------------------------------------------------------------------------------- |
@ -1143,16 +1143,16 @@ The following variables can be used in `format`:
| `deleted` | Hiển thị `deleted` khi một tệp tin bị xóa đã được thêm vào staging area. | | `deleted` | Hiển thị `deleted` khi một tệp tin bị xóa đã được thêm vào staging area. |
| style\* | Giá trị ghi đè của `style` | | style\* | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
The following variables can be used in `diverged`: Các biến sau có thể được sử dụng trong `diverged`:
| Biến | Mô tả | | Biến | Mô tả |
| -------------- | --------------------------------------------- | | -------------- | --------------------------------------------- |
| `ahead_count` | Số lượng commit phía trước của nhánh tracking | | `ahead_count` | Số lượng commit phía trước của nhánh tracking |
| `behind_count` | Số lượng commit phía sau nhánh tracking | | `behind_count` | Số lượng commit phía sau nhánh tracking |
The following variables can be used in `conflicted`, `ahead`, `behind`, `untracked`, `stashed`, `modified`, `staged`, `renamed` and `deleted`: Các biến sau có thể được sử dụng trong `conflicted`, `ahead`, `behind`, `untracked`, `stashed`, `modified`, `staged`, `renamed` and `deleted`:
| Biến | Mô tả | | Biến | Mô tả |
| ------- | ----------------------------- | | ------- | ----------------------------- |
@ -1176,7 +1176,7 @@ renamed = "👅"
deleted = "🗑" deleted = "🗑"
``` ```
Show ahead/behind count of the branch being tracked Hiển thị tổng số nhánh phía trước/phía sau của nhánh được track
```toml ```toml
# ~/.config/starship.toml # ~/.config/starship.toml
@ -1189,7 +1189,7 @@ behind = "⇣${count}"
## Golang ## Golang
The `golang` module shows the currently installed version of Golang. Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn: Mô đun `golang` hiển thị phiên bản Golang hiện tại được cài đặt. Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn:
- Thư mục hiện tại chứa một tập tin `go.mod` - Thư mục hiện tại chứa một tập tin `go.mod`
- Đường dẫn hiện tại chứa một tập tin `go.sum` - Đường dẫn hiện tại chứa một tập tin `go.sum`
@ -1220,7 +1220,7 @@ The `golang` module shows the currently installed version of Golang. Mặc đị
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -1233,7 +1233,7 @@ format = "via [🏎💨 $version](bold cyan) "
## Helm ## Helm
The `helm` module shows the currently installed version of Helm. Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn: Mô đun `helm` hiển thị phiên bản Helm hiện tại được cài đặt. Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn:
- Đường dẫn hiện tại chứa một tập tin `helmfile.yaml` - Đường dẫn hiện tại chứa một tập tin `helmfile.yaml`
- Thư mục hiện tại chứa một tập tin `Chart.yaml` - Thư mục hiện tại chứa một tập tin `Chart.yaml`
@ -1258,7 +1258,7 @@ The `helm` module shows the currently installed version of Helm. Mặc định m
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -1271,7 +1271,7 @@ format = "via [⎈ $version](bold white) "
## Hostname ## Hostname
The `hostname` module shows the system hostname. Mô đun `hostname` hiển thị hostnam hệ thống.
### Các tuỳ chọn ### Các tuỳ chọn
@ -1290,7 +1290,7 @@ The `hostname` module shows the system hostname.
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -1306,7 +1306,7 @@ disabled = false
## Java ## Java
The `java` module shows the currently installed version of Java. Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn: Mô đun `java` cho biết phiên bản của Java đã cài đặt. Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn:
- Thư mục hiện tại chứa một tệp tin `pom.xml`, `build.gradle.kts`, `build.sbt`, `.java-version`, `.deps.edn`, `project.clj`, or `build.boot` - Thư mục hiện tại chứa một tệp tin `pom.xml`, `build.gradle.kts`, `build.sbt`, `.java-version`, `.deps.edn`, `project.clj`, or `build.boot`
- Thư mục hiện tại chứa một tệp tin với phần mở rộng `.java`, `.class`, `.gradle`, `.jar`, `.clj`, or `.cljc` - Thư mục hiện tại chứa một tệp tin với phần mở rộng `.java`, `.class`, `.gradle`, `.jar`, `.clj`, or `.cljc`
@ -1331,7 +1331,7 @@ The `java` module shows the currently installed version of Java. Mặc định m
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -1344,11 +1344,11 @@ symbol = "🌟 "
## Jobs ## 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` module cho biết số lượng các jobs đang chạy. Mô đun sẽ được hiển thị chỉ khi có background jobs đang chạy. Mô đúnẽ hiển thị số lượng jobs đang chỵ nếu có nhiều hơn 1 jobs, hoặc nhiều hơn giá trị cấu hình `threshold`, nếu nó tồn tại.
::: cảnh báo ::: cảnh báo
This module is not supported on tcsh. Mô đun này không hỗ trợ trên tcsh.
::: :::
@ -1370,7 +1370,7 @@ This module is not supported on tcsh.
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -1384,7 +1384,7 @@ threshold = 4
## Julia ## Julia
The `julia` module shows the currently installed version of Julia. Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn: Mô đun `julia` hiển thị phiên bản Julia hiện tại được cài đặt. Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn:
- Thư mục hiện tại chứa một tệp tin `Project.toml` - Thư mục hiện tại chứa một tệp tin `Project.toml`
- Thư mục hiện tại chứa một tập tin `Manifest.toml` - Thư mục hiện tại chứa một tập tin `Manifest.toml`
@ -1410,7 +1410,7 @@ The `julia` module shows the currently installed version of Julia. Mặc định
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -1423,7 +1423,7 @@ symbol = "∴ "
## Kotlin ## Kotlin
The `kotlin` module shows the currently installed version of Kotlin. Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn: Mô đun `golang` hiển thị phiên bản Kotlin hiện tại được cài đặt. Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn:
- Thư mục hiện tại chứa một tệp tin `.kt` hoặc một tệp tin `.kts` - Thư mục hiện tại chứa một tệp tin `.kt` hoặc một tệp tin `.kts`
@ -1448,7 +1448,7 @@ The `kotlin` module shows the currently installed version of Kotlin. Mặc đị
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -1469,11 +1469,11 @@ kotlin_binary = "kotlinc"
## Kubernetes ## 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`. Hiển thị tên của Kubernetes context hiện tại, nếu thiết lập, namespace lấy từ tệp tin kubeconfig. Namespace cần được thiết lập trong tệp tin kubeconfig, cài này có thể được thực thi thông qua `kubectl config set-context starship-cluster --namespace astronaut`. Nếu biến môi trường `$KUBECONFIG` được thiết lập, mô đun sẽ sử dụng cái đó nếu nó không sử dụng `~/.kube/config`.
::: tip ::: thử thuật
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. Mặc định, mô đun này được vô hiệu. Để kích hoạt nó, thiết lập `disabled` sang `false` trong tập tin cấu hình của bạn.
::: :::
@ -1496,7 +1496,7 @@ This module is disabled by default. To enable it, set `disabled` to `false` in y
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -1558,7 +1558,7 @@ The `lua` module shows the currently installed version of Lua. Mặc định mod
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -1575,9 +1575,9 @@ The `memory_usage` module shows current system memory and swap usage.
By default the swap usage is displayed if the total system swap is non-zero. By default the swap usage is displayed if the total system swap is non-zero.
::: tip ::: thử thuật
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. Mặc định, mô đun này được vô hiệu. Để kích hoạt nó, thiết lập `disabled` sang `false` trong tập tin cấu hình của bạn.
::: :::
@ -1639,7 +1639,7 @@ The `hg_branch` module shows the active branch of the repo in your current direc
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -1681,7 +1681,7 @@ The `nim` module shows the currently installed version of Nim. Mặc định mod
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -1717,7 +1717,7 @@ The `nix_shell` module shows the nix-shell environment. The module will be shown
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -1762,7 +1762,7 @@ The `nodejs` module shows the currently installed version of NodeJS. Mặc đị
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -1808,7 +1808,7 @@ The `ocaml` module shows the currently installed version of OCaml. Mặc định
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -1841,7 +1841,7 @@ The `openstack` module shows the current OpenStack cloud and project. The module
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -1889,7 +1889,7 @@ The `package` module is shown when the current directory is the repository for a
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -1967,7 +1967,7 @@ The `php` module shows the currently installed version of PHP. Mặc định mod
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -2005,7 +2005,7 @@ The `purescript` module shows the currently installed version of PureScript vers
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -2027,10 +2027,10 @@ Mặc định module sẽ được hiển thị nếu có bất kì điều ki
- The current directory contains a `.python-version` file - The current directory contains a `.python-version` file
- The current directory contains a `Pipfile` file - The current directory contains a `Pipfile` file
- The current directory contains a `__init__.py` file - The current directory contains a `__init__.py` file
- The current directory contains a `pyproject.toml` file - Đường dẫn hiện tại chứa một tập tin `pyproject.toml`
- The current directory contains a `requirements.txt` file - Đường dẫn hiện tại chứa một tập tin `requirements.txt`
- The current directory contains a `setup.py` file - Đường dẫn hiện tại chứa một tập tin `setup.py`
- The current directory contains a `tox.ini` file - Đường dẫn hiện tại chứa một tập tin `tox.ini`
- The current directory contains a file with the `.py` extension. - The current directory contains a file with the `.py` extension.
- A virtual environment is currently activated - A virtual environment is currently activated
@ -2044,12 +2044,12 @@ Mặc định module sẽ được hiển thị nếu có bất kì điều ki
| `pyenv_version_name` | `false` | Use pyenv to get Python version | | `pyenv_version_name` | `false` | Use pyenv to get Python version |
| `pyenv_prefix` | `pyenv` | Prefix before pyenv version display, only used if pyenv is used | | `pyenv_prefix` | `pyenv` | Prefix before pyenv version display, only used if pyenv is used |
| `python_binary` | `["python", "python3, "python2"]` | Configures the python binaries that Starship should executes when getting the version. | | `python_binary` | `["python", "python3, "python2"]` | Configures the python binaries that Starship should executes when getting the version. |
| `detect_extensions` | `[".py"]` | Which extensions should trigger this module | | `detect_extensions` | `[".py"]` | Những tiện ích mở rộng nào sẽ kích hoạt mô-đun này |
| `detect_files` | `[".python-version", "Pipfile", "__init__.py", "pyproject.toml", "requirements.txt", "setup.py", "tox.ini"]` | Which filenames should trigger this module | | `detect_files` | `[".python-version", "Pipfile", "__init__.py", "pyproject.toml", "requirements.txt", "setup.py", "tox.ini"]` | Tên tệp nào sẽ kích hoạt mô-đun này |
| `detect_folders` | `[]` | Which folders should trigger this module | | `detect_folders` | `[]` | Thư mục nào sẽ kích hoạt mô-đun này |
| `disabled` | `false` | Disables the `python` module. | | `disabled` | `false` | Disables the `python` module. |
::: tip ::: thử thuật
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. 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.
@ -2095,7 +2095,7 @@ detect_extensions = []
## Ruby ## Ruby
By default the `ruby` module shows the currently installed version of Ruby. The module will be shown if any of the following conditions are met: By default the `ruby` module shows the currently installed version of Ruby. Module cho sẽ được hiện nếu bất kì điều kiện nào dưới đây thoả mãn:
- The current directory contains a `Gemfile` file - The current directory contains a `Gemfile` file
- The current directory contains a `.ruby-version` file - The current directory contains a `.ruby-version` file
@ -2121,7 +2121,7 @@ By default the `ruby` module shows the currently installed version of Ruby. The
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -2134,7 +2134,7 @@ symbol = "🔺 "
## Rust ## Rust
By default the `rust` module shows the currently installed version of Rust. The module will be shown if any of the following conditions are met: By default the `rust` module shows the currently installed version of Rust. Module cho sẽ được hiện nếu bất kì điều kiện nào dưới đây thoả mãn:
- The current directory contains a `Cargo.toml` file - The current directory contains a `Cargo.toml` file
- The current directory contains a file with the `.rs` extension - The current directory contains a file with the `.rs` extension
@ -2159,7 +2159,7 @@ By default the `rust` module shows the currently installed version of Rust. The
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -2198,7 +2198,7 @@ The `scala` module shows the currently installed version of Scala. Mặc định
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -2213,9 +2213,9 @@ symbol = "🌟 "
The `shell` module shows an indicator for currently used shell. The `shell` module shows an indicator for currently used shell.
::: tip ::: thử thuật
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. Mặc định, mô đun này được vô hiệu. Để kích hoạt nó, thiết lập `disabled` sang `false` trong tập tin cấu hình của bạn.
::: :::
@ -2273,7 +2273,7 @@ The `shlvl` module shows the current `SHLVL` ("shell level") environment variabl
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -2307,7 +2307,7 @@ The `singularity` module shows the current singularity image, if inside a contai
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -2322,9 +2322,9 @@ format = '[📦 \[$env\]]($style) '
The `status` module displays the exit code of the previous command. The module will be shown only if the exit code is not `0`. The `status` module displays the exit code of the previous command. The module will be shown only if the exit code is not `0`.
::: tip ::: thử thuật
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. Mặc định, mô đun này được vô hiệu. Để kích hoạt nó, thiết lập `disabled` sang `false` trong tập tin cấu hình của bạn.
::: :::
@ -2358,7 +2358,7 @@ This module is disabled by default. To enable it, set `disabled` to `false` in y
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -2377,7 +2377,7 @@ disabled = false
## Swift ## Swift
By default the `swift` module shows the currently installed version of Swift. The module will be shown if any of the following conditions are met: By default the `swift` module shows the currently installed version of Swift. Module cho sẽ được hiện nếu bất kì điều kiện nào dưới đây thoả mãn:
- The current directory contains a `Package.swift` file - The current directory contains a `Package.swift` file
- The current directory contains a file with the `.swift` extension - The current directory contains a file with the `.swift` extension
@ -2402,7 +2402,7 @@ By default the `swift` module shows the currently installed version of Swift. Th
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -2417,7 +2417,7 @@ format = "via [🏎 $version](red bold)"
The `terraform` module shows the currently selected terraform workspace and version. The `terraform` module shows the currently selected terraform workspace and version.
::: tip ::: thử thuật
By default the terraform version is not shown, since this is slow for 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). By default the terraform version is not shown, since this is slow for 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).
@ -2449,7 +2449,7 @@ Mặc định module sẽ được hiển thị nếu có bất kì điều ki
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -2475,9 +2475,9 @@ format = "[🏎💨 $workspace]($style) "
The `time` module shows the current **local** time. The `format` configuration value is used by the [`chrono`](https://crates.io/crates/chrono) crate to control how the time is displayed. Take a look [at the chrono strftime docs](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) to see what options are available. The `time` module shows the current **local** time. The `format` configuration value is used by the [`chrono`](https://crates.io/crates/chrono) crate to control how the time is displayed. Take a look [at the chrono strftime docs](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) to see what options are available.
::: tip ::: thử thuật
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. Mặc định, mô đun này được vô hiệu. Để kích hoạt nó, thiết lập `disabled` sang `false` trong tập tin cấu hình của bạn.
::: :::
@ -2499,10 +2499,10 @@ If `use_12hr` is `true`, then `time_format` defaults to `"%r"`. Otherwise, it de
| Biến | Ví dụ | Mô tả | | Biến | Ví dụ | Mô tả |
| --------- | ---------- | -------------------------- | | --------- | ---------- | -------------------------- |
| time | `13:08:10` | The current time. | | thời gian | `13:08:10` | The current time. |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -2519,14 +2519,14 @@ time_range = "10:00:00-14:00:00"
## Username ## Username
The `username` module shows active user's username. The module will be shown if any of the following conditions are met: The `username` module shows active user's username. Module cho sẽ được hiện nếu bất kì điều kiện nào dưới đây thoả mãn:
- The current user is root - The current user is root
- The current user isn't the same as the one that is logged in - The current user isn't the same as the one that is logged in
- The user is currently connected as an SSH session - The user is currently connected as an SSH session
- The variable `show_always` is set to true - The variable `show_always` is set to true
::: tip ::: thử thuật
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. 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.
@ -2588,7 +2588,7 @@ The `vagrant` module shows the currently installed version of Vagrant. Mặc đ
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -2620,7 +2620,7 @@ The `vcsh` module displays the current active VCSH repository. The module will b
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | `black bold dimmed` | Giá trị ghi đè của `style` | | style\* | `black bold dimmed` | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -2633,7 +2633,7 @@ format = "[🆅 $repo](bold blue) "
## Zig ## Zig
By default the the `zig` module shows the currently installed version of Zig. The module will be shown if any of the following conditions are met: By default the the `zig` module shows the currently installed version of Zig. Module cho sẽ được hiện nếu bất kì điều kiện nào dưới đây thoả mãn:
- The current directory contains a `.zig` file - The current directory contains a `.zig` file
@ -2657,7 +2657,7 @@ By default the the `zig` module shows the currently installed version of Zig. Th
| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | | Giá trị ghi đè của `style` | | style\* | | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
### Ví dụ ### Ví dụ
@ -2679,19 +2679,19 @@ These modules will be shown if any of the following conditions are met:
- The current directory contains a file whose extension is in `extensions` - The current directory contains a file whose extension is in `extensions`
- The `when` command returns 0 - The `when` command returns 0
::: tip ::: thử thuật
Multiple custom modules can be defined by using a `.`. Multiple custom modules can be defined by using a `.`.
::: :::
::: tip ::: thử thuật
The order in which custom modules are shown can be individually set by including `${custom.foo}` in the top level `format` (as it includes a dot, you need to use `${...}`). By default, the `custom` module will simply show all custom modules in the order they were defined. The order in which custom modules are shown can be individually set by including `${custom.foo}` in the top level `format` (as it includes a dot, you need to use `${...}`). By default, the `custom` module will simply show all custom modules in the order they were defined.
::: :::
::: tip ::: thử thuật
[Issue #1252](https://github.com/starship/starship/discussions/1252) contains examples of custom modules. If you have an interesting example not covered there, feel free to share it there! [Issue #1252](https://github.com/starship/starship/discussions/1252) contains examples of custom modules. If you have an interesting example not covered there, feel free to share it there!
@ -2721,7 +2721,7 @@ The order in which custom modules are shown can be individually set by including
| symbol | Giá trị ghi đè tuỳ chọn `symbol` | | symbol | Giá trị ghi đè tuỳ chọn `symbol` |
| style\* | Giá trị ghi đè của `style` | | style\* | Giá trị ghi đè của `style` |
\*: This variable can only be used as a part of a style string \*: Biến này có thể chỉ được sử dụng như một phần của style string
#### Custom command shell #### Custom command shell

4
docs/vi-VN/faq/README.md
View File

@ -38,7 +38,7 @@ NUM_JOBS=$(jobs -p | wc -l)
PS1="$(starship prompt --status=$STATUS --jobs=$NUM_JOBS)" PS1="$(starship prompt --status=$STATUS --jobs=$NUM_JOBS)"
``` ```
The [Bash implementation](https://github.com/starship/starship/blob/master/src/init/starship.bash) built into Starship is slightly more complex to allow for advanced features like the [Command Duration module](https://starship.rs/config/#command-duration) and to ensure that Starship is compatible with pre-installed Bash configurations. [Bản cài đặt Bash](https://github.com/starship/starship/blob/master/src/init/starship.bash) xây dựng bên trong Starship phực tạp hơn một chút để cho phép thực hiện các tính năng nâng cao hơn một chứt như [Command Duration module](https://starship.rs/config/#command-duration) và chắc chắn rằng Starship là tương thích với cấu hình Bash đã cài đặt trước đó.
Với một danh sách tất cả các cờ đã được chấp nhận bởi `starship prompt`, sử dụng lệnh sau: Với một danh sách tất cả các cờ đã được chấp nhận bởi `starship prompt`, sử dụng lệnh sau:
@ -92,5 +92,5 @@ Nếu Starship đã được cài đặt bằng việc sử dụng `curl | bash`
```sh ```sh
# Locate and delete the starship binary # Locate and delete the starship binary
bash -c 'rm "$(which starship)"' sh -c 'rm "$(which starship)"'
``` ```

12
docs/vi-VN/installing/README.md
View File

@ -37,7 +37,7 @@ curl -fsSL https://starship.rs/install.sh | bash -s -- -b /data/data/com.termux/
## [Nix](https://nixos.wiki/wiki/Nix) ## [Nix](https://nixos.wiki/wiki/Nix)
### Getting the Binary ### Lấy tệp tin nhị phân
#### Lệnh #### Lệnh
@ -45,16 +45,16 @@ curl -fsSL https://starship.rs/install.sh | bash -s -- -b /data/data/com.termux/
nix-env -iA nixos.starship nix-env -iA nixos.starship
``` ```
#### Declarative, single user, via [home-manager](https://github.com/nix-community/home-manager) #### Khai báo, người dùng đơn, thông qua [home-manager](https://github.com/nix-community/home-manager)
Enable the `programs.starship` module in your `home.nix` file, and add your settings Kích hoạt mô đun `programs.starship` trong tệp `home.nix` của bạn, và thêm các cài đặt của bạn
```nix ```nix
{ {
programs.starship = { programs.starship = {
enable = true; enable = true;
enableZshIntegration = true; enableZshIntegration = true;
# Configuration written to ~/.config/starship.toml # Cấu hình viết vào ~/.config/starship.toml
settings = { settings = {
# add_newline = false; # add_newline = false;
@ -69,7 +69,7 @@ Enable the `programs.starship` module in your `home.nix` file, and add your sett
} }
``` ```
then run sau đó chạy
```sh ```sh
home-manager switch home-manager switch
@ -77,7 +77,7 @@ home-manager switch
#### Khai báo, system-wide, với NixOS #### Khai báo, system-wide, với NixOS
Add `pkgs.starship` to `environment.systemPackages` in your `configuration.nix`, then run Thêm`pkgs.starship` vào `environment.systemPackages` trong `configuration.nix` của bạn, sau đó chạy
```sh ```sh
sudo nixos-rebuild switch sudo nixos-rebuild switch

2
docs/zh-CN/README.md
View File

@ -45,7 +45,7 @@ description: Starship is the minimal, blazing fast, and extremely customizable p
#### 通过软件包管理器安装 #### 通过软件包管理器安装
With [Homebrew](https://brew.sh/): 使用 [Homebrew](https://brew.sh/)：
```sh ```sh
brew install starship brew install starship

162
docs/zh-CN/config/README.md
View File

@ -305,7 +305,7 @@ symbol = "🅰 "
## Battery ## Battery
The `battery` module shows how charged the device's battery is and its current charging status. The module is only visible when the device's battery is below 10%. `battery` 组件显示电池充电情况和当前充电状态。 这个组件只会在当前电量低于 10% 时显示。
### 配置项 ### 配置项
@ -333,7 +333,7 @@ discharging_symbol = "💀 "
### Battery 组件的显示 ### 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 ```toml
[[battery.display]] [[battery.display]]
@ -343,7 +343,7 @@ style = "bold red"
#### 配置项 #### 配置项
The `display` option is an array of the following table. `display` 字段的子字段如下：
| Option | 描述 | | Option | 描述 |
| ----------- | ---------------- | | ----------- | ---------------- |
@ -367,9 +367,9 @@ style = "bold yellow"
## Character ## 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 color (`red`/`green`)
- changing shape (`❯`/`✖`) - changing shape (`❯`/`✖`)
@ -456,15 +456,15 @@ The `cmake` module shows the currently installed version of CMake. By default th
## Command Duration ## 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` 两个列表，就可以照常运行了。
### 配置项 ### 配置项
@ -505,11 +505,11 @@ format = "underwent [$duration](bold yellow)"
## Conda ## Conda
The `conda` module shows the current conda environment, if `$CONDA_DEFAULT_ENV` is set. `conda` 组件在 `$CONDA_DEFAULT_ENV` 被设置时显示当前 conda 环境。
::: tip ::: 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`。
::: :::
@ -587,7 +587,7 @@ The `dart` module shows the currently installed version of Dart. By default the
- The current directory contains a file with `.dart` extension - The current directory contains a file with `.dart` extension
- The current directory contains a `.dart_tool` directory - The current directory contains a `.dart_tool` directory
- The current directory contains a `pubspec.yaml`, `pubspec.yml` or `pubspec.lock` file - 当前目录包含 `pubspec.yaml`，`pubspec.yml` 或 `pubspec.lock` 文件
### 配置项 ### 配置项
@ -622,11 +622,11 @@ format = "via [🔰 $version](bold red) "
## Directory ## 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`。
### 配置项 ### 配置项
@ -643,7 +643,7 @@ For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, an
| `home_symbol` | `"~"` | The symbol indicating home directory. | | `home_symbol` | `"~"` | The symbol indicating home directory. |
<details> <details>
<summary>This module has a few advanced configuration options that control how the directory is displayed.</summary> <summary>此组件有几个高级配置选项来控制当前目录路径的显示方式。</summary>
| Advanced Option | 默认值 | 描述 | | Advanced Option | 默认值 | 描述 |
| --------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | --------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@ -720,7 +720,7 @@ format = "via [🐋 $context](blue bold)"
## Dotnet ## 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 版本。
By default this module will only be shown in your prompt when one or more of the following files are present in the current directory: By default this module will only be shown in your prompt when one or more of the following files are present in the current directory:
@ -736,7 +736,7 @@ By default this module will only be shown in your prompt when one or more of the
You'll also need the .NET Core SDK installed in order to use it correctly. 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 (<https://docs.microsoft.com/en-us/dotnet/standard/frameworks#supported-target-framework-versions>) when there is a csproj file in the current directory. The module will also show the Target Framework Moniker (<https://docs.microsoft.com/en-us/dotnet/standard/frameworks#supported-target-framework-versions>) when there is a csproj file in the current directory.
@ -751,7 +751,7 @@ The module will also show the Target Framework Moniker (<https://docs.microsoft.
| `detect_files` | `["global.json", "project.json", "Directory.Build.props", "Directory.Build.targets", "Packages.props"]` | Which filenames should trigger this module. | | `detect_files` | `["global.json", "project.json", "Directory.Build.props", "Directory.Build.targets", "Packages.props"]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this modules. | | `detect_folders` | `[]` | Which folders should trigger this modules. |
| `style` | `"bold blue"` | 此组件的样式。 | | `style` | `"bold blue"` | 此组件的样式。 |
| `disabled` | `false` | Disables the `dotnet` module. | | `disabled` | `false` | 禁用 `dotnet` 组件。 |
### Variables ### Variables
@ -856,7 +856,7 @@ format = "via [ $version](cyan bold) "
## Environment Variable ## 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` 是一个已存在的环境变量
- 未定义 `variable`，但定义了 `default` - 未定义 `variable`，但定义了 `default`
@ -991,7 +991,7 @@ asia-northeast1 = "an1"
## Git Branch ## Git Branch
The `git_branch` module shows the active branch of the repo in your current directory. `git_branch` 组件显示当前目录的 git 仓库的活动分支。
### 配置项 ### 配置项
@ -1066,7 +1066,7 @@ tag_symbol = "🔖 "
## Git State ## 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）如果存在则也会被显示。
### 配置项 ### 配置项
@ -1106,7 +1106,7 @@ cherry_pick = "[🍒 PICKING](bold red)"
## Git Status ## Git Status
The `git_status` module shows symbols representing the state of the repo in your current directory. `git_status`组件通过相应的符号显示您当前目录中 git 仓库的状态。
### 配置项 ### 配置项
@ -1189,7 +1189,7 @@ behind = "⇣${count}"
## Golang ## Golang
The `golang` module shows the currently installed version of Golang. By default the module will be shown if any of the following conditions are met: `golang` 组件显示当前安装的 Golang 版本。 By default the module will be shown if any of the following conditions are met:
- 当前目录包含 `go.mod` 文件 - 当前目录包含 `go.mod` 文件
- 当前目录包含 `go.sum` 文件 - 当前目录包含 `go.sum` 文件
@ -1210,7 +1210,7 @@ The `golang` module shows the currently installed version of Golang. By default
| `detect_files` | `["go.mod", "go.sum", "glide.yaml", "Gopkg.yml", "Gopkg.lock", ".go-version"]` | Which filenames should trigger this module. | | `detect_files` | `["go.mod", "go.sum", "glide.yaml", "Gopkg.yml", "Gopkg.lock", ".go-version"]` | Which filenames should trigger this module. |
| `detect_folders` | `["Godeps"]` | Which folders should trigger this module. | | `detect_folders` | `["Godeps"]` | Which folders should trigger this module. |
| `style` | `"bold cyan"` | 此组件的样式。 | | `style` | `"bold cyan"` | 此组件的样式。 |
| `disabled` | `false` | Disables the `golang` module. | | `disabled` | `false` | 禁用 `golang` 组件。 |
### Variables ### Variables
@ -1271,7 +1271,7 @@ format = "via [⎈ $version](bold white) "
## Hostname ## Hostname
The `hostname` module shows the system hostname. `hostname` 组件显示系统主机名。
### 配置项 ### 配置项
@ -1306,7 +1306,7 @@ disabled = false
## Java ## Java
The `java` module shows the currently installed version of Java. By default the module will be shown if any of the following conditions are met: `java` 组件显示当前安装的 Java 版本。 By default the module will be shown if any of the following conditions are met:
- 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 `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 - The current directory contains a file with the `.java`, `.class`, `.gradle`, `.jar`, `.clj`, or `.cljc` extension
@ -1321,7 +1321,7 @@ The `java` module shows the currently installed version of Java. By default the
| `detect_folders` | `[]` | Which folders should trigger this modules. | | `detect_folders` | `[]` | Which folders should trigger this modules. |
| `symbol` | `"☕ "` | A format string representing the symbol of Java | | `symbol` | `"☕ "` | A format string representing the symbol of Java |
| `style` | `"red dimmed"` | 此组件的样式。 | | `style` | `"red dimmed"` | 此组件的样式。 |
| `disabled` | `false` | Disables the `java` module. | | `disabled` | `false` | 禁用 `java` 组件。 |
### Variables ### Variables
@ -1344,7 +1344,7 @@ symbol = "🌟 "
## Jobs ## 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` 字段，则使用它作为显示作业数量的下限。
::: warning ::: warning
@ -1473,7 +1473,7 @@ Displays the current Kubernetes context name and, if set, the namespace from the
::: tip ::: tip
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. 此组件默认被禁用。 若要启用此组件，请在配置文件中设置 `disable` 字段为 `false`。
::: :::
@ -1512,7 +1512,7 @@ disabled = false
## Line Break ## Line Break
The `line_break` module separates the prompt into two lines. `line_break` 组件将提示分隔为两行。
### 配置项 ### 配置项
@ -1571,13 +1571,13 @@ format = "via [🌕 $version](bold blue) "
## Memory Usage ## 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 ::: tip
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. 此组件默认被禁用。 若要启用此组件，请在配置文件中设置 `disable` 字段为 `false`。
::: :::
@ -1618,7 +1618,7 @@ style = "bold dimmed green"
## Mercurial Branch ## Mercurial Branch
The `hg_branch` module shows the active branch of the repo in your current directory. `hg_branch` 组件显示当前目录的 hg 仓库的活动分支。
### 配置项 ### 配置项
@ -1695,7 +1695,7 @@ symbol = "🎣 "
## Nix-shell ## 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 环境中时，此组件会被显示。
### 配置项 ### 配置项
@ -1733,7 +1733,7 @@ format = 'via [☃️ $state( \($name\))](bold blue) '
## NodeJS ## NodeJS
The `nodejs` module shows the currently installed version of NodeJS. By default the module will be shown if any of the following conditions are met: `nodejs` 组件显示当前安装的 NodeJS 版本。 By default the module will be shown if any of the following conditions are met:
- 当前目录包含 `package.json` 文件 - 当前目录包含 `package.json` 文件
- The current directory contains a `.node-version` file - The current directory contains a `.node-version` file
@ -1751,7 +1751,7 @@ The `nodejs` module shows the currently installed version of NodeJS. By default
| `detect_files` | `["package.json", ".node-version"]` | Which filenames should trigger this module. | | `detect_files` | `["package.json", ".node-version"]` | Which filenames should trigger this module. |
| `detect_folders` | `["node_modules"]` | Which folders should trigger this module. | | `detect_folders` | `["node_modules"]` | Which folders should trigger this module. |
| `style` | `"bold green"` | 此组件的样式。 | | `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 `package.json` does not match the NodeJS version. | | `not_capable_style` | `bold red` | The style for the module when an engines property in `package.json` does not match the NodeJS version. |
### Variables ### Variables
@ -1856,7 +1856,7 @@ symbol = "☁️ "
## Package Version ## 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** —— `npm` 软件包版本从当前目录下的 `package.json` 中得到 - **npm** —— `npm` 软件包版本从当前目录下的 `package.json` 中得到
- **cargo** —— `cargo` 软件包的版本从当前目录下的 `Cargo.toml` 中得到 - **cargo** —— `cargo` 软件包的版本从当前目录下的 `Cargo.toml` 中得到
@ -1941,7 +1941,7 @@ format = "via [🦪 $version]($style) "
## PHP ## PHP
The `php` module shows the currently installed version of PHP. By default the module will be shown if any of the following conditions are met: `php` 组件显示当前安装的 PHP 版本。 By default the module will be shown if any of the following conditions are met:
- 当前目录包含一个 `composer.json` 文件 - 当前目录包含一个 `composer.json` 文件
- The current directory contains a `.php-version` file - The current directory contains a `.php-version` file
@ -1957,7 +1957,7 @@ The `php` module shows the currently installed version of PHP. By default the mo
| `detect_files` | `["composer.json", ".php-version"]` | Which filenames should trigger this module. | | `detect_files` | `["composer.json", ".php-version"]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. | | `detect_folders` | `[]` | Which folders should trigger this module. |
| `style` | `"147 bold"` | 此组件的样式。 | | `style` | `"147 bold"` | 此组件的样式。 |
| `disabled` | `false` | Disables the `php` module. | | `disabled` | `false` | 禁用 `php` 组件。 |
### Variables ### Variables
@ -2018,20 +2018,20 @@ format = "via [$symbol$version](bold white)"
## Python ## 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`获得的版本号
By default the module will be shown if any of the following conditions are met: By default the module will be shown if any of the following conditions are met:
- 当前目录包含 `.python-version` 文件 - 当前目录包含 `.python-version` 文件
- The current directory contains a `Pipfile` file - 当前目录包含 `Pipfile` 文件
- The current directory contains a `__init__.py` file - 当前目录包含一个名为`__init__.py`的文件
- The current directory contains a `pyproject.toml` file - 当前目录包含 `pyproject.toml` 文件
- The current directory contains a `requirements.txt` file - 当前目录包含 `requirements.txt` 文件
- The current directory contains a `setup.py` file - 当前目录包含一个 `setup.py` 文件
- The current directory contains a `tox.ini` file - 当前目录包含一个 `tox.ini` 文件
- The current directory contains a file with the `.py` extension. - 当前目录包含一个使用 `.py` 扩展名的文件.
- 当前处于一个活跃的 python 虚拟环境中 - 当前处于一个活跃的 python 虚拟环境中
### 配置项 ### 配置项
@ -2047,7 +2047,7 @@ By default the module will be shown if any of the following conditions are met:
| `detect_extensions` | `[".py"]` | Which extensions should trigger this module | | `detect_extensions` | `[".py"]` | Which extensions should trigger this module |
| `detect_files` | `[".python-version", "Pipfile", "__init__.py", "pyproject.toml", "requirements.txt", "setup.py", "tox.ini"]` | Which filenames should trigger this module | | `detect_files` | `[".python-version", "Pipfile", "__init__.py", "pyproject.toml", "requirements.txt", "setup.py", "tox.ini"]` | Which filenames should trigger this module |
| `detect_folders` | `[]` | Which folders should trigger this module | | `detect_folders` | `[]` | Which folders should trigger this module |
| `disabled` | `false` | Disables the `python` module. | | `disabled` | `false` | 禁用 `python` 组件。 |
::: tip ::: tip
@ -2095,7 +2095,7 @@ detect_extensions = []
## Ruby ## Ruby
By default the `ruby` module shows the currently installed version of Ruby. The module will be shown if any of the following conditions are met: By default the `ruby` module shows the currently installed version of Ruby. 此组件将在符合以下任意条件之一时显示：
- 当前目录包含 `Gemfile` 文件 - 当前目录包含 `Gemfile` 文件
- The current directory contains a `.ruby-version` file - The current directory contains a `.ruby-version` file
@ -2111,7 +2111,7 @@ By default the `ruby` module shows the currently installed version of Ruby. The
| `detect_files` | `["Gemfile", ".ruby-version"]` | Which filenames should trigger this module. | | `detect_files` | `["Gemfile", ".ruby-version"]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. | | `detect_folders` | `[]` | Which folders should trigger this module. |
| `style` | `"bold red"` | 此组件的样式。 | | `style` | `"bold red"` | 此组件的样式。 |
| `disabled` | `false` | Disables the `ruby` module. | | `disabled` | `false` | 禁用 `ruby` 组件。 |
### Variables ### Variables
@ -2134,7 +2134,7 @@ symbol = "🔺 "
## Rust ## Rust
By default the `rust` module shows the currently installed version of Rust. The module will be shown if any of the following conditions are met: By default the `rust` module shows the currently installed version of Rust. 此组件将在符合以下任意条件之一时显示：
- 当前目录包含 `Cargo.toml` 文件 - 当前目录包含 `Cargo.toml` 文件
- 当前目录包含一个使用 `.rs` 扩展名的文件 - 当前目录包含一个使用 `.rs` 扩展名的文件
@ -2149,7 +2149,7 @@ By default the `rust` module shows the currently installed version of Rust. The
| `detect_files` | `["Cargo.toml"]` | Which filenames should trigger this module. | | `detect_files` | `["Cargo.toml"]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. | | `detect_folders` | `[]` | Which folders should trigger this module. |
| `style` | `"bold red"` | 此组件的样式。 | | `style` | `"bold red"` | 此组件的样式。 |
| `disabled` | `false` | Disables the `rust` module. | | `disabled` | `false` | 禁用 `rust` 组件。 |
### Variables ### Variables
@ -2215,7 +2215,7 @@ The `shell` module shows an indicator for currently used shell.
::: tip ::: tip
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. 此组件默认被禁用。 若要启用此组件，请在配置文件中设置 `disable` 字段为 `false`。
::: :::
@ -2324,7 +2324,7 @@ The `status` module displays the exit code of the previous command. The module w
::: tip ::: tip
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. 此组件默认被禁用。 若要启用此组件，请在配置文件中设置 `disable` 字段为 `false`。
::: :::
@ -2377,7 +2377,7 @@ disabled = false
## Swift ## Swift
By default the `swift` module shows the currently installed version of Swift. The module will be shown if any of the following conditions are met: By default the `swift` module shows the currently installed version of Swift. 此组件将在符合以下任意条件之一时显示：
- The current directory contains a `Package.swift` file - The current directory contains a `Package.swift` file
- The current directory contains a file with the `.swift` extension - The current directory contains a file with the `.swift` extension
@ -2415,7 +2415,7 @@ format = "via [🏎 $version](red bold)"
## Terraform ## Terraform
The `terraform` module shows the currently selected terraform workspace and version. `terraform` 组件显示当前选定的 terraform 工作区和版本。
::: tip ::: tip
@ -2425,7 +2425,7 @@ By default the terraform version is not shown, since this is slow for current ve
By default the module will be shown if any of the following conditions are met: By default the module will be shown if any of the following conditions are met:
- The current directory contains a `.terraform` folder - 当前目录包含 `.terraform` 目录
- Current directory contains a file with the `.tf` or `.hcl` extensions - Current directory contains a file with the `.tf` or `.hcl` extensions
### 配置项 ### 配置项
@ -2438,7 +2438,7 @@ By default the module will be shown if any of the following conditions are met:
| `detect_files` | `[]` | Which filenames should trigger this module. | | `detect_files` | `[]` | Which filenames should trigger this module. |
| `detect_folders` | `[".terraform"]` | Which folders should trigger this module. | | `detect_folders` | `[".terraform"]` | Which folders should trigger this module. |
| `style` | `"bold 105"` | 此组件的样式。 | | `style` | `"bold 105"` | 此组件的样式。 |
| `disabled` | `false` | Disables the `terraform` module. | | `disabled` | `false` | 禁用 `terraform` 组件。 |
### Variables ### Variables
@ -2473,27 +2473,27 @@ format = "[🏎💨 $workspace]($style) "
## Time ## Time
The `time` module shows the current **local** time. The `format` configuration value is used by the [`chrono`](https://crates.io/crates/chrono) crate to control how the time is displayed. Take a look [at the chrono strftime docs](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) to see what options are available. `time` 组件显示当前的 **本地** 时间。 `format` 字段值会提供给 [`chrono`](https://crates.io/crates/chrono) crate 用来控制时间显示方式。 请参阅 [chrono strftime 文档](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) 以了解可用格式选项。
::: tip ::: tip
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. 此组件默认被禁用。 若要启用此组件，请在配置文件中设置 `disable` 字段为 `false`。
::: :::
### 配置项 ### 配置项
| Option | 默认值 | 描述 | | Option | 默认值 | 描述 |
| ----------------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | ----------------- | ----------------------- | ----------------------------------------------------------------------------------------------------- |
| `format` | `"at [$time]($style) "` | The format string for the module. | | `format` | `"at [$time]($style) "` | The format string for the module. |
| `use_12hr` | `false` | Enables 12 hour formatting | | `use_12hr` | `false` | 启用 12 小时格式 |
| `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. | | `time_format` | 见下文解释 | 用来格式化时间显示的 [chrono 格式字符串](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) |
| `style` | `"bold yellow"` | The style for the module time | | `style` | `"bold yellow"` | 显示时间的样式。 |
| `utc_time_offset` | `"local"` | Sets the UTC offset to use. Range from -24 &lt; x &lt; 24. Allows floats to accommodate 30/45 minute timezone offsets. | | `utc_time_offset` | `"local"` | 设置所用 UTC 偏移量。 Range from -24 &lt; x &lt; 24. 允许使用浮点数来得到 30/45 分钟的时区偏移。 |
| `disabled` | `true` | Disables the `time` module. | | `disabled` | `true` | 禁用 `time` 组件。 |
| `time_range` | `"-"` | Sets the time range during which the module will be shown. Times must be specified in 24-hours format | | `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. If `use_12hr` is `true`, then `time_format` defaults to `"%r"`. 否则，其默认值为 `"%T"`。 Manually setting `time_format` will override the `use_12hr` setting.
### Variables ### Variables
@ -2519,12 +2519,12 @@ time_range = "10:00:00-14:00:00"
## Username ## Username
The `username` module shows active user's username. The module will be shown if any of the following conditions are met: `username` 组件显示当前活跃的用户名。 此组件将在符合以下任意条件之一时显示：
- The current user is root - 当前用户是 root
- The current user isn't the same as the one that is logged in - 当前用户与登录用户不相同
- The user is currently connected as an SSH session - 用户正通过 SSH 会话连接访问
- The variable `show_always` is set to true - 字段 `show_always` 被设置为 true
::: tip ::: tip
@ -2535,12 +2535,12 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
### 配置项 ### 配置项
| Option | 默认值 | 描述 | | Option | 默认值 | 描述 |
| ------------- | ----------------------- | ------------------------------------- | | ------------- | ----------------------- | ------------------- |
| `style_root` | `"bold red"` | The style used when the user is root. | | `style_root` | `"bold red"` | 当前用户为 root 时使用的样式。 |
| `style_user` | `"bold yellow"` | The style used for non-root users. | | `style_user` | `"bold yellow"` | 非 root 用户使用的样式。 |
| `format` | `"[$user]($style) in "` | 组件格式化模板。 | | `format` | `"[$user]($style) in "` | 组件格式化模板。 |
| `show_always` | `false` | Always shows the `username` module. | | `show_always` | `false` | 总是显示 `username` 组件。 |
| `disabled` | `false` | Disables the `username` module. | | `disabled` | `false` | 禁用 `username` 组件。 |
### Variables ### Variables
@ -2633,7 +2633,7 @@ format = "[🆅 $repo](bold blue) "
## Zig ## Zig
By default the the `zig` module shows the currently installed version of Zig. The module will be shown if any of the following conditions are met: By default the the `zig` module shows the currently installed version of Zig. 此组件将在符合以下任意条件之一时显示：
- The current directory contains a `.zig` file - The current directory contains a `.zig` file

4
docs/zh-CN/faq/README.md
View File

@ -38,7 +38,7 @@ NUM_JOBS=$(jobs -p | wc -l)
PS1="$(starship prompt --status=$STATUS --jobs=$NUM_JOBS)" PS1="$(starship prompt --status=$STATUS --jobs=$NUM_JOBS)"
``` ```
The [Bash implementation](https://github.com/starship/starship/blob/master/src/init/starship.bash) built into Starship is slightly more complex to allow for advanced features like the [Command Duration module](https://starship.rs/config/#command-duration) and to ensure that Starship is compatible with pre-installed Bash configurations. 内置于 Starship 的 [Bash 适配](https://github.com/starship/starship/blob/master/src/init/starship.bash) 稍微复杂一些，实现了像 [命令用时统计组件](https://starship.rs/config/#command-duration) 这样的功能，还确保 Starship 能与之前设置的 Bash 配置相兼容。
使用以下命令了解 `starship prompt` 所能接受的所有参数： 使用以下命令了解 `starship prompt` 所能接受的所有参数：
@ -92,5 +92,5 @@ If Starship was installed using the `curl | bash` script, the following command
```sh ```sh
# Locate and delete the starship binary # Locate and delete the starship binary
bash -c 'rm "$(which starship)"' sh -c 'rm "$(which starship)"'
``` ```

2
docs/zh-TW/README.md
View File

@ -45,7 +45,7 @@ description: Starship 是適合任何 shell 的最小、極速、高度客製化
#### 使用套件管理器安裝： #### 使用套件管理器安裝：
With [Homebrew](https://brew.sh/): 使用 [Homebrew](https://brew.sh/)：
```sh ```sh
brew install starship brew install starship

148
docs/zh-TW/config/README.md
View File

@ -305,7 +305,7 @@ symbol = "🅰 "
## 電池 ## 電池
The `battery` module shows how charged the device's battery is and its current charging status. The module is only visible when the device's battery is below 10%. `battery` 模組顯示電池的電量以及現在的充電狀態。 這個模組只會在裝置的電量低於 10% 的時候看見。
### 選項 ### 選項
@ -333,7 +333,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 ```toml
[[battery.display]] [[battery.display]]
@ -343,7 +343,7 @@ style = "bold red"
#### 選項 #### 選項
The `display` option is an array of the following table. `display` 選項是一個下列表格的陣列。
| Option | 說明 | | Option | 說明 |
| ----------- | ----------- | | ----------- | ----------- |
@ -367,9 +367,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 color (`red`/`green`)
- changing shape (`❯`/`✖`) - changing shape (`❯`/`✖`)
@ -456,15 +456,15 @@ The `cmake` module shows the currently installed version of CMake. By default th
## 指令持續時間 ## 指令持續時間
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` 兩個陣列，然後就可以照常進行。
### 選項 ### 選項
@ -505,7 +505,7 @@ format = "underwent [$duration](bold yellow)"
## Conda ## Conda
The `conda` module shows the current conda environment, if `$CONDA_DEFAULT_ENV` is set. 如果有設定 `$CONDA_DEFAULT_ENV` 時，`conda` 模組顯示現在 conda 的環境。
::: tip ::: tip
@ -545,7 +545,7 @@ format = "[$symbol$environment](dimmed green) "
## Crystal ## Crystal
The `crystal` module shows the currently installed version of Crystal. By default the module will be shown if any of the following conditions are met: `crystal` 模組顯示現在所安裝的Crystal版本 By default the module will be shown if any of the following conditions are met:
- 現在資料夾中含有一個 `shard.yml` 檔案 - 現在資料夾中含有一個 `shard.yml` 檔案
- 現在資料夾中含有一個`.cr`檔案 - 現在資料夾中含有一個`.cr`檔案
@ -587,7 +587,7 @@ The `dart` module shows the currently installed version of Dart. By default the
- The current directory contains a file with `.dart` extension - The current directory contains a file with `.dart` extension
- The current directory contains a `.dart_tool` directory - The current directory contains a `.dart_tool` directory
- The current directory contains a `pubspec.yaml`, `pubspec.yml` or `pubspec.lock` file - 現在資料夾中包含一個 `pubspec.yaml`、`pubspec.yml` 或 `pubspec.lock` 檔案
### 選項 ### 選項
@ -622,11 +622,11 @@ 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`。
### 選項 ### 選項
@ -643,7 +643,7 @@ For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, an
| `home_symbol` | `"~"` | The symbol indicating home directory. | | `home_symbol` | `"~"` | The symbol indicating home directory. |
<details> <details>
<summary>This module has a few advanced configuration options that control how the directory is displayed.</summary> <summary>這個模組有些進階設定選項可以控制顯示資料夾。</summary>
| Advanced Option | 預設 | 說明 | | Advanced Option | 預設 | 說明 |
| --------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | --------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@ -720,7 +720,7 @@ format = "via [🐋 $context](blue bold)"
## Dotnet ## 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 版本。
By default this module will only be shown in your prompt when one or more of the following files are present in the current directory: By default this module will only be shown in your prompt when one or more of the following files are present in the current directory:
@ -736,7 +736,7 @@ By default this module will only be shown in your prompt when one or more of the
You'll also need the .NET Core SDK installed in order to use it correctly. 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 (<https://docs.microsoft.com/en-us/dotnet/standard/frameworks#supported-target-framework-versions>) when there is a csproj file in the current directory. The module will also show the Target Framework Moniker (<https://docs.microsoft.com/en-us/dotnet/standard/frameworks#supported-target-framework-versions>) when there is a csproj file in the current directory.
@ -751,7 +751,7 @@ The module will also show the Target Framework Moniker (<https://docs.microsoft.
| `detect_files` | `["global.json", "project.json", "Directory.Build.props", "Directory.Build.targets", "Packages.props"]` | Which filenames should trigger this module. | | `detect_files` | `["global.json", "project.json", "Directory.Build.props", "Directory.Build.targets", "Packages.props"]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this modules. | | `detect_folders` | `[]` | Which folders should trigger this modules. |
| `style` | `"bold blue"` | 這個模組的風格。 | | `style` | `"bold blue"` | 這個模組的風格。 |
| `disabled` | `false` | Disables the `dotnet` module. | | `disabled` | `false` | 停用 `dotnet` 模組。 |
### Variables ### Variables
@ -856,7 +856,7 @@ 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` 設定選項符合一個存在的環境變數。
- 沒有設定 `variable` 選項，但是有設定 `default` 選項。 - 沒有設定 `variable` 選項，但是有設定 `default` 選項。
@ -991,7 +991,7 @@ asia-northeast1 = "an1"
## Git 分支 ## Git 分支
The `git_branch` module shows the active branch of the repo in your current directory. `git_branch` 模組顯示現在的資料夾中使用中的儲存庫的分支。
### 選項 ### 選項
@ -1066,7 +1066,7 @@ tag_symbol = "🔖 "
## Git State ## 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)，也會一併顯示出來。
### 選項 ### 選項
@ -1106,7 +1106,7 @@ cherry_pick = "[🍒 PICKING](bold red)"
## Git Status ## Git Status
The `git_status` module shows symbols representing the state of the repo in your current directory. `git_status` 模組顯示用來表示現在資料夾之中儲存庫狀態的符號。
### 選項 ### 選項
@ -1189,7 +1189,7 @@ behind = "⇣${count}"
## Golang ## Golang
The `golang` module shows the currently installed version of Golang. By default the module will be shown if any of the following conditions are met: `golang` 模組顯示現在安裝的 Golang 版本。 By default the module will be shown if any of the following conditions are met:
- 現在資料夾中含有一個 `go.mod` 檔案 - 現在資料夾中含有一個 `go.mod` 檔案
- 現在資料夾中含有一個 `go.sum` 檔案 - 現在資料夾中含有一個 `go.sum` 檔案
@ -1210,7 +1210,7 @@ The `golang` module shows the currently installed version of Golang. By default
| `detect_files` | `["go.mod", "go.sum", "glide.yaml", "Gopkg.yml", "Gopkg.lock", ".go-version"]` | Which filenames should trigger this module. | | `detect_files` | `["go.mod", "go.sum", "glide.yaml", "Gopkg.yml", "Gopkg.lock", ".go-version"]` | Which filenames should trigger this module. |
| `detect_folders` | `["Godeps"]` | Which folders should trigger this module. | | `detect_folders` | `["Godeps"]` | Which folders should trigger this module. |
| `style` | `"bold cyan"` | 這個模組的風格。 | | `style` | `"bold cyan"` | 這個模組的風格。 |
| `disabled` | `false` | Disables the `golang` module. | | `disabled` | `false` | 停用 `golang` 模組。 |
### Variables ### Variables
@ -1271,7 +1271,7 @@ format = "via [⎈ $version](bold white) "
## 主機名稱 ## 主機名稱
The `hostname` module shows the system hostname. `hostname` 模組顯示系統的主機名稱。
### 選項 ### 選項
@ -1306,7 +1306,7 @@ disabled = false
## Java ## Java
The `java` module shows the currently installed version of Java. By default the module will be shown if any of the following conditions are met: `java` 模組顯示現在安裝的 Java 版本。 By default the module will be shown if any of the following conditions are met:
- 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 `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 - The current directory contains a file with the `.java`, `.class`, `.gradle`, `.jar`, `.clj`, or `.cljc` extension
@ -1321,7 +1321,7 @@ The `java` module shows the currently installed version of Java. By default the
| `detect_folders` | `[]` | Which folders should trigger this modules. | | `detect_folders` | `[]` | Which folders should trigger this modules. |
| `symbol` | `"☕ "` | A format string representing the symbol of Java | | `symbol` | `"☕ "` | A format string representing the symbol of Java |
| `style` | `"red dimmed"` | 這個模組的風格。 | | `style` | `"red dimmed"` | 這個模組的風格。 |
| `disabled` | `false` | Disables the `java` module. | | `disabled` | `false` | 停用 `java` 模組。 |
### Variables ### Variables
@ -1344,7 +1344,7 @@ 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` 時且數量超過設定值時，顯示工作的數量。
::: warning ::: warning
@ -1473,7 +1473,7 @@ Displays the current Kubernetes context name and, if set, the namespace from the
::: tip ::: tip
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. 這個模組預設是停用的。 想要啟用它的話，請在設定檔中將 `disabled` 設定為 `false`。
::: :::
@ -1512,7 +1512,7 @@ disabled = false
## 換行 ## 換行
The `line_break` module separates the prompt into two lines. `line_break` 模組將提示字元分成兩行。
### 選項 ### 選項
@ -1571,13 +1571,13 @@ format = "via [🌕 $version](bold blue) "
## 記憶體使用量 ## 記憶體使用量
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 ::: tip
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. 這個模組預設是停用的。 想要啟用它的話，請在設定檔中將 `disabled` 設定為 `false`。
::: :::
@ -1695,7 +1695,7 @@ symbol = "🎣 "
## Nix-shell ## 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 環境中顯示。
### 選項 ### 選項
@ -1733,7 +1733,7 @@ format = 'via [☃️ $state( \($name\))](bold blue) '
## NodeJS ## NodeJS
The `nodejs` module shows the currently installed version of NodeJS. By default the module will be shown if any of the following conditions are met: `nodejs` 模組顯示現在安裝的 NodeJS 版本。 By default the module will be shown if any of the following conditions are met:
- 現在資料夾中包含一個 `package.json` 檔案 - 現在資料夾中包含一個 `package.json` 檔案
- The current directory contains a `.node-version` file - The current directory contains a `.node-version` file
@ -1751,7 +1751,7 @@ The `nodejs` module shows the currently installed version of NodeJS. By default
| `detect_files` | `["package.json", ".node-version"]` | Which filenames should trigger this module. | | `detect_files` | `["package.json", ".node-version"]` | Which filenames should trigger this module. |
| `detect_folders` | `["node_modules"]` | Which folders should trigger this module. | | `detect_folders` | `["node_modules"]` | Which folders should trigger this module. |
| `style` | `"bold green"` | 這個模組的風格。 | | `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 `package.json` does not match the NodeJS version. | | `not_capable_style` | `bold red` | The style for the module when an engines property in `package.json` does not match the NodeJS version. |
### Variables ### Variables
@ -1856,7 +1856,7 @@ symbol = "☁️ "
## 套件版本 ## 套件版本
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** – `npm` 套件的版本是從現在資料夾中的 `package.json` 之中擷取出來的 - **npm** – `npm` 套件的版本是從現在資料夾中的 `package.json` 之中擷取出來的
- **cargo** – `cargo` 套件的版本是從現在資料夾中的 `Cargo.toml` 之中擷取出來的 - **cargo** – `cargo` 套件的版本是從現在資料夾中的 `Cargo.toml` 之中擷取出來的
@ -2025,13 +2025,13 @@ If `pyenv_version_name` is set to `true`, it will display the pyenv version name
By default the module will be shown if any of the following conditions are met: By default the module will be shown if any of the following conditions are met:
- 目前資料夾中有一個 `.python-version` 檔案 - 目前資料夾中有一個 `.python-version` 檔案
- The current directory contains a `Pipfile` file - 目前資料夾中有一個 `Pipfile` 檔案
- The current directory contains a `__init__.py` file - The current directory contains a `__init__.py` file
- The current directory contains a `pyproject.toml` file - 目前資料夾中有一個 `pyproject.toml` 檔案
- The current directory contains a `requirements.txt` file - 目前資料夾中有一個 `requirements.txt` 檔案
- The current directory contains a `setup.py` file - 現在資料夾中包含一個 `setup.py` 檔案
- The current directory contains a `tox.ini` file - 目前資料夾中有一個 `tox.ini` 檔案
- The current directory contains a file with the `.py` extension. - 目前資料夾中有一個 `.py` 副檔名的檔案.
- A virtual environment is currently activated - A virtual environment is currently activated
### 選項 ### 選項
@ -2047,7 +2047,7 @@ By default the module will be shown if any of the following conditions are met:
| `detect_extensions` | `[".py"]` | Which extensions should trigger this module | | `detect_extensions` | `[".py"]` | Which extensions should trigger this module |
| `detect_files` | `[".python-version", "Pipfile", "__init__.py", "pyproject.toml", "requirements.txt", "setup.py", "tox.ini"]` | Which filenames should trigger this module | | `detect_files` | `[".python-version", "Pipfile", "__init__.py", "pyproject.toml", "requirements.txt", "setup.py", "tox.ini"]` | Which filenames should trigger this module |
| `detect_folders` | `[]` | Which folders should trigger this module | | `detect_folders` | `[]` | Which folders should trigger this module |
| `disabled` | `false` | Disables the `python` module. | | `disabled` | `false` | 停用 `python` 模組。 |
::: tip ::: tip
@ -2095,7 +2095,7 @@ detect_extensions = []
## Ruby ## Ruby
By default the `ruby` module shows the currently installed version of Ruby. The module will be shown if any of the following conditions are met: By default the `ruby` module shows the currently installed version of Ruby. 這個模組在下列其中一個條件達成時顯示：
- 目前資料夾中有一個 `Gemfile` 檔案 - 目前資料夾中有一個 `Gemfile` 檔案
- The current directory contains a `.ruby-version` file - The current directory contains a `.ruby-version` file
@ -2111,7 +2111,7 @@ By default the `ruby` module shows the currently installed version of Ruby. The
| `detect_files` | `["Gemfile", ".ruby-version"]` | Which filenames should trigger this module. | | `detect_files` | `["Gemfile", ".ruby-version"]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. | | `detect_folders` | `[]` | Which folders should trigger this module. |
| `style` | `"bold red"` | 這個模組的風格。 | | `style` | `"bold red"` | 這個模組的風格。 |
| `disabled` | `false` | Disables the `ruby` module. | | `disabled` | `false` | 停用 `ruby` 模組。 |
### Variables ### Variables
@ -2134,7 +2134,7 @@ symbol = "🔺 "
## Rust ## Rust
By default the `rust` module shows the currently installed version of Rust. The module will be shown if any of the following conditions are met: By default the `rust` module shows the currently installed version of Rust. 這個模組在下列其中一個條件達成時顯示：
- 目前資料夾中有一個 `Cargo.toml` 檔案 - 目前資料夾中有一個 `Cargo.toml` 檔案
- 現在資料夾中包含一個檔案具有 `.rs` 副檔名 - 現在資料夾中包含一個檔案具有 `.rs` 副檔名
@ -2149,7 +2149,7 @@ By default the `rust` module shows the currently installed version of Rust. The
| `detect_files` | `["Cargo.toml"]` | Which filenames should trigger this module. | | `detect_files` | `["Cargo.toml"]` | Which filenames should trigger this module. |
| `detect_folders` | `[]` | Which folders should trigger this module. | | `detect_folders` | `[]` | Which folders should trigger this module. |
| `style` | `"bold red"` | 這個模組的風格。 | | `style` | `"bold red"` | 這個模組的風格。 |
| `disabled` | `false` | Disables the `rust` module. | | `disabled` | `false` | 停用 `rust` 模組。 |
### Variables ### Variables
@ -2215,7 +2215,7 @@ The `shell` module shows an indicator for currently used shell.
::: tip ::: tip
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. 這個模組預設是停用的。 想要啟用它的話，請在設定檔中將 `disabled` 設定為 `false`。
::: :::
@ -2324,7 +2324,7 @@ The `status` module displays the exit code of the previous command. The module w
::: tip ::: tip
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. 這個模組預設是停用的。 想要啟用它的話，請在設定檔中將 `disabled` 設定為 `false`。
::: :::
@ -2377,7 +2377,7 @@ disabled = false
## Swift ## Swift
By default the `swift` module shows the currently installed version of Swift. The module will be shown if any of the following conditions are met: By default the `swift` module shows the currently installed version of Swift. 這個模組在下列其中一個條件達成時顯示：
- The current directory contains a `Package.swift` file - The current directory contains a `Package.swift` file
- The current directory contains a file with the `.swift` extension - The current directory contains a file with the `.swift` extension
@ -2473,33 +2473,33 @@ format = "[🏎💨 $workspace]($style) "
## 時間 ## 時間
The `time` module shows the current **local** time. The `format` configuration value is used by the [`chrono`](https://crates.io/crates/chrono) crate to control how the time is displayed. Take a look [at the chrono strftime docs](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) to see what options are available. `time` 模組顯示目前的**當地**時間. `format` 設定值被 [`chrono`](https://crates.io/crates/chrono) crate 用來控制時間如何顯示。 請看 [chrono 的 strftime 文件](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html)來了解有那些選項可以使用。
::: tip ::: tip
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file. 這個模組預設是停用的。 想要啟用它的話，請在設定檔中將 `disabled` 設定為 `false`。
::: :::
### 選項 ### 選項
| Option | 預設 | 說明 | | Option | 預設 | 說明 |
| ----------------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | ----------------- | ----------------------- | ----------------------------------------------------------------------------------------------------- |
| `format` | `"at [$time]($style) "` | The format string for the module. | | `format` | `"at [$time]($style) "` | The format string for the module. |
| `use_12hr` | `false` | Enables 12 hour formatting | | `use_12hr` | `false` | 啟用 12 小時格式。 |
| `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. | | `time_format` | 請看下列 | 用來顯示時間的 [chrono 格式字串](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html)。 |
| `style` | `"bold yellow"` | The style for the module time | | `style` | `"bold yellow"` | 這個模組的時間的風格。 |
| `utc_time_offset` | `"local"` | Sets the UTC offset to use. Range from -24 &lt; x &lt; 24. Allows floats to accommodate 30/45 minute timezone offsets. | | `utc_time_offset` | `"local"` | 設定相對於 UTC 的時差。 Range from -24 &lt; x &lt; 24. 允許使用浮點數來表示 30/45 分鐘時差的時區。 |
| `disabled` | `true` | Disables the `time` module. | | `disabled` | `true` | 停用 `time` 模組。 |
| `time_range` | `"-"` | Sets the time range during which the module will be shown. Times must be specified in 24-hours format | | `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. If `use_12hr` is `true`, then `time_format` defaults to `"%r"`. 不然的話，它會被預設為 `"%T"`。 Manually setting `time_format` will override the `use_12hr` setting.
### Variables ### Variables
| 變數 | 範例 | 說明 | | 變數 | 範例 | 說明 |
| --------- | ---------- | ----------------------------------- | | --------- | ---------- | ----------------------------------- |
| time | `13:08:10` | The current time. | | 時間 | `13:08:10` | The current time. |
| style\* | | Mirrors the value of option `style` | | style\* | | Mirrors the value of option `style` |
\*: This variable can only be used as a part of a style string \*: This variable can only be used as a part of a style string
@ -2517,14 +2517,14 @@ utc_time_offset = "-5"
time_range = "10:00:00-14:00:00" time_range = "10:00:00-14:00:00"
``` ```
## Username ## 使用者名稱
The `username` module shows active user's username. The module will be shown if any of the following conditions are met: `username` 模組顯示現在使用中的使用者名稱。 這個模組在下列其中一個條件達成時顯示：
- The current user is root - 目前使用者為 root
- The current user isn't the same as the one that is logged in - 目前使用者並非登入時的使用者
- The user is currently connected as an SSH session - 使用者透過 SSH session 進行連線
- The variable `show_always` is set to true - 變數 `show_always` 被設為 true
::: tip ::: tip
@ -2535,12 +2535,12 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
### 選項 ### 選項
| Option | 預設 | 說明 | | Option | 預設 | 說明 |
| ------------- | ----------------------- | ------------------------------------- | | ------------- | ----------------------- | -------------------------- |
| `style_root` | `"bold red"` | The style used when the user is root. | | `style_root` | `"bold red"` | 使用者為 root 時使用的風格。 |
| `style_user` | `"bold yellow"` | The style used for non-root users. | | `style_user` | `"bold yellow"` | 非 root 使用者時使用的風格。 |
| `format` | `"[$user]($style) in "` | The format for the module. | | `format` | `"[$user]($style) in "` | The format for the module. |
| `show_always` | `false` | Always shows the `username` module. | | `show_always` | `false` | 總是顯示 `username` 模組。 |
| `disabled` | `false` | Disables the `username` module. | | `disabled` | `false` | 停用 `username` 模組。 |
### Variables ### Variables
@ -2633,7 +2633,7 @@ format = "[🆅 $repo](bold blue) "
## Zig ## Zig
By default the the `zig` module shows the currently installed version of Zig. The module will be shown if any of the following conditions are met: By default the the `zig` module shows the currently installed version of Zig. 這個模組在下列其中一個條件達成時顯示：
- The current directory contains a `.zig` file - The current directory contains a `.zig` file

2
docs/zh-TW/faq/README.md
View File

@ -92,5 +92,5 @@ If Starship was installed using the `curl | bash` script, the following command
```sh ```sh
# Locate and delete the starship binary # Locate and delete the starship binary
bash -c 'rm "$(which starship)"' sh -c 'rm "$(which starship)"'
``` ```

14
docs/zh-TW/guide/README.md
View File

@ -124,7 +124,7 @@
align="right" align="right"
/> />
**The minimal, blazing-fast, and infinitely customizable prompt for any shell!** **適合任何 shell 的最小、極速、無限客製化的提示字元！**
- **Fast:** it's fast – _really really_ fast! 🚀 - **Fast:** it's fast – _really really_ fast! 🚀
- **Customizable:** configure every aspect of your prompt. - **Customizable:** configure every aspect of your prompt.
@ -152,7 +152,7 @@
1. 安裝 **starship** 執行檔： 1. 安裝 **starship** 執行檔：
#### Install Latest Version #### 安裝最新版本
##### From prebuilt binary, with Shell: ##### From prebuilt binary, with Shell:
@ -163,7 +163,7 @@
To update the Starship itself, rerun the above script. It will replace the current version without touching Starship's configuration. To update the Starship itself, rerun the above script. It will replace the current version without touching Starship's configuration.
#### Install via Package Manager #### 使用套件管理器安裝：
##### Example: [Homebrew](https://brew.sh/): ##### Example: [Homebrew](https://brew.sh/):
@ -217,7 +217,7 @@
#### PowerShell #### PowerShell
將以下內容放到 `Microsoft.PowerShell_profile.ps1` 的結尾。 你可以藉由在 PowerShell 查詢 `$PROFILE` 變數以取得這個檔案的位置。 Typically the path is `~\Documents\PowerShell\Microsoft.PowerShell_profile.ps1` or `~/.config/powershell/Microsoft.PowerShell_profile.ps1` on -Nix. 將以下內容放到 `Microsoft.PowerShell_profile.ps1` 的結尾。 你可以藉由在 PowerShell 查詢 `$PROFILE` 變數以取得這個檔案的位置。 一般來說檔案會出現在 `~\Documents\PowerShell\Microsoft.PowerShell_profile.ps1` 或是在 -Nix 上的話會在 `~/.config/powershell/Microsoft.PowerShell_profile.ps1`。
```powershell ```powershell
Invoke-Expression (&starship init powershell) Invoke-Expression (&starship init powershell)
@ -226,7 +226,7 @@
#### Ion #### Ion
Add the following to the end of `~/.config/ion/initrc`: 將以下內容放到 `~/.config/ion/initrc` 的結尾：
```sh ```sh
# ~/.config/ion/initrc # ~/.config/ion/initrc
@ -237,7 +237,7 @@
#### Elvish #### Elvish
**Warning** Only elvish v0.15 or higher is supported. Add the following to the end of `~/.elvish/rc.elv`: **Warning** Only elvish v0.15 or higher is supported. 將以下內容放到 `~/.elvish/rc.elv` 的結尾：
```sh ```sh
# ~/.elvish/rc.elv # ~/.elvish/rc.elv
@ -248,7 +248,7 @@
#### Tcsh #### Tcsh
Add the following to the end of `~/.tcshrc`: 將以下內容放到 `~/.tcshrc` 的結尾：
```sh ```sh
# ~/.tcshrc # ~/.tcshrc