diff --git a/docs/de-DE/config/README.md b/docs/de-DE/config/README.md
index 91af3605..e6302361 100644
--- a/docs/de-DE/config/README.md
+++ b/docs/de-DE/config/README.md
@@ -113,6 +113,7 @@ prompt_order = [
"haskell",
"java",
"julia",
+ "nim",
"nodejs",
"ocaml",
"php",
@@ -376,9 +377,18 @@ For example, given `~/Dev/Nix/nixpkgs/pkgs` where `nixpkgs` is the repo root, an
| Variable | Standardwert | Beschreibung |
| --------------------------- | ------------ | ---------------------------------------------------------------------------------------- |
+| `substitutions` | | A table of substitutions to be made to the path. |
| `fish_style_pwd_dir_length` | `0` | The number of characters to use when applying fish shell pwd path logic. |
| `use_logical_path` | `true` | Displays the logical path provided by the shell (`PWD`) instead of the path from the OS. |
+`substitutions` allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories (i.e. Java). Note that this will disable the fish style PWD.
+
+```toml
+[directory.substitutions]
+"/Volumes/network/path" = "/net"
+"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`.
@@ -444,7 +454,7 @@ heuristic = false
## Elixir
-The `elixir` module shows the currently installed version of Elixir and Erlang/OTP. Das Modul wird nur dann angezeigt, wenn eine der folgenden Bedingungen zutrifft:
+The `elixir` module shows the currently installed version of Elixir and Erlang/OTP. Das Modul wird gezeigt, wenn mindestens einer der folgenden Punkte erfüllt ist:
- Das aktuelle Verzeichnis enthält eine `mix.exs`-Datei.
@@ -548,7 +558,7 @@ symbol = "e "
## Git-Branch
-Das `git_branch`-Modul zeigt den aktiven Git-Branch des Repositories im aktuellen Verzeichnis an.
+The `git_branch` module shows the active branch of the repo in your current directory.
### Optionen
@@ -685,7 +695,7 @@ deleted = "🗑"
## Golang
-Das `golang`-Modul zeigt die aktuell installierte Version von Golang. Das Modul wird gezeigt, wenn mindestens einer der folgenden Punkte erfüllt ist:
+The `golang` module shows the currently installed version of Golang. Das Modul wird gezeigt, wenn mindestens einer der folgenden Punkte erfüllt ist:
- Das aktuelle Verzeichnis enthält eine `go.mod`-Datei
- Das aktuelle Verzeichnis enthält eine `go.sum`-Datei
@@ -738,7 +748,7 @@ symbol = " "
## Hostname
-Das `hostname`-Modul zeigt den Hostnamen des Systems an.
+The `hostname` module shows the system hostname.
### Optionen
@@ -758,15 +768,15 @@ Das `hostname`-Modul zeigt den Hostnamen des Systems an.
[hostname]
ssh_only = false
-prefix = "10218;"
-suffix = " 10219;"
+prefix = "⟪"
+suffix = "⟫"
trim_at = ".companyname.com"
disabled = false
```
## Java
-Das `java` Modul zeigt die derzeit installierte Version von Java an. Das Modul wird gezeigt, wenn mindestens einer der folgenden Punkte erfüllt ist:
+The `java` module shows the currently installed version of Java. Das Modul wird gezeigt, wenn mindestens einer der folgenden Punkte erfüllt ist:
- The current directory contains a `pom.xml`, `build.gradle.kts`, `build.sbt` or `.java-version` file
- The current directory contains a file with the `.java`, `.class`, `.gradle` or `.jar` extension
@@ -839,9 +849,9 @@ symbol = "∴ "
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`.
-::: Tipp
+::: tip
-Dieses Modul ist standardmäßig deaktiviert. Setze in deiner Konfiguration `disabled` auf `false` um es zu aktivieren.
+This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
:::
@@ -869,7 +879,7 @@ disabled = false
## Zeilenumbruch
-Das `line_break`-Modul unterteilt den Prompt in zwei Zeilen.
+The `line_break` module separates the prompt into two lines.
### Optionen
@@ -888,13 +898,13 @@ disabled = true
## Speicherauslastung
-Das `memory_usage` Modul zeigt den aktuellen Systemspeicher und die swap-Nutzung an.
+The `memory_usage` module shows current system memory and swap usage.
-Standardmäßig wird die swap-Nutzung angezeigt, wenn der gesamte System-swap nicht Null ist.
+By default the swap usage is displayed if the total system swap is non-zero.
-::: Tipp
+::: tip
-Dieses Modul ist standardmäßig deaktiviert. Setze in deiner Konfiguration `disabled` auf `false` um es zu aktivieren.
+This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
:::
@@ -950,20 +960,46 @@ truncation_length = 4
truncation_symbol = ""
```
-## Nix-Shell
+## Nim
-Das `nix_shell`-Modul zeigt die nix-shell Umgebung an. Das Modul wird angezeigt, wenn es sich in einer nix-Shell-Umgebung befindet.
+The `nim` module shows the currently installed version of Nim. Das Modul wird gezeigt, wenn mindestens einer der folgenden Punkte erfüllt ist:
+- The current directory contains a `nim.cfg` file
+- The current directory contains a file with the `.nim` extension
+- The current directory contains a file with the `.nims` extension
+- The current directory contains a file with the `.nimble` extension
+
+### Optionen
+
+| Variable | Standardwert | Beschreibung |
+| ---------- | --------------- | ----------------------------------------------------- |
+| `symbol` | `"👑 "` | The symbol used before displaying the version of Nim. |
+| `style` | `"bold yellow"` | Stil für dieses Modul. |
+| `disabled` | `false` | Disables the `nim` module. |
+
+### Beispiel
+
+```toml
+# ~/.config/starship.toml
+
+[nim]
+style = "yellow"
+symbol = "🎣 "
+```
+
+## Nix-shell
+
+The `nix_shell` module shows the nix-shell environment. The module will be shown when inside a nix-shell environment.
### Optionen
| Variable | Standardwert | Beschreibung |
| ------------ | ------------- | ------------------------------------------------- |
-| `use_name` | `false` | Namen der nix-Shell anzeigen. |
-| `impure_msg` | `"impure"` | Passt die "impure"-Nachricht an. |
-| `pure_msg` | `"pure"` | Passt die "pure"-Nachricht an. |
+| `use_name` | `false` | Display the name of the nix-shell. |
+| `impure_msg` | `"impure"` | Customize the "impure" msg. |
+| `pure_msg` | `"pure"` | Customize the "pure" msg. |
| `symbol` | `"❄️ "` | The symbol used before displaying the shell name. |
| `style` | `"bold blue"` | Stil für dieses Modul. |
-| `disabled` | `false` | Deaktiviert das `nix_shell`-Modul. |
+| `disabled` | `false` | Disables the `nix_shell` module. |
### Beispiel
@@ -980,20 +1016,20 @@ symbol = "☃️ "
## NodeJS
-Das `nodejs`-Modul zeigt die aktuell installierte Version von NodeJS. Das Modul wird gezeigt, wenn mindestens einer der folgenden Punkte erfüllt ist:
+The `nodejs` module shows the currently installed version of NodeJS. Das Modul wird gezeigt, wenn mindestens einer der folgenden Punkte erfüllt ist:
-- Das aktuelle Verzeichnis enthält eine `package.json`-Datei
+- The current directory contains a `package.json` file
- The current directory contains a `.node-version` file
-- Das aktuelle Verzeichnis enthält ein `node_modules`-Verzeichnis
-- Das aktuelle Verzeichnis enthält eine Datei mit der `.js`-Erweiterung
+- The current directory contains a `node_modules` directory
+- The current directory contains a file with the `.js` extension
### Optionen
-| Variable | Standardwert | Beschreibung |
-| ---------- | -------------- | ------------------------------------------------- |
-| `symbol` | `"⬢ "` | Symbol das vor der NodeJS-Version angezeigt wird. |
-| `style` | `"bold green"` | Stil für dieses Modul. |
-| `disabled` | `false` | Deaktiviert das `nodejs`-Modul. |
+| Variable | Standartwert | Beschreibung |
+| ---------- | -------------- | -------------------------------------------------------- |
+| `symbol` | `"⬢ "` | The symbol used before displaying the version of NodeJS. |
+| `style` | `"bold green"` | Stil für dieses Modul. |
+| `disabled` | `false` | Disables the `nodejs` module. |
### Beispiel
@@ -1004,13 +1040,13 @@ Das `nodejs`-Modul zeigt die aktuell installierte Version von NodeJS. Das Modul
symbol = "🤖 "
```
-## Paketversion
+## Package Version
-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` and `mix` packages.
+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` and `mix` packages.
-- **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
-- **poetry** – Die `poetry` Paketversion wird aus der `pyproject.toml` gelesen, das sich im aktuellen Verzeichnis befindet
+- **npm** – The `npm` package version is extracted from the `package.json` present in the current directory
+- **cargo** – The `cargo` package version is extracted from the `Cargo.toml` present in the current directory
+- **poetry** – The `poetry` package version is extracted from the `pyproject.toml` present in the current directory
- **composer** – The `composer` package version is extracted from the `composer.json` present in the current directory
- **gradle** – The `gradle` package version is extracted from the `build.gradle` present
- **julia** - The package version is extracted from the `Project.toml` present
@@ -1020,12 +1056,12 @@ Das `Package` Modul wird angezeigt, wenn das aktuelle Verzeichnis das Repository
### Optionen
-| Variable | Standartwert | Beschreibung |
-| ----------------- | ------------ | --------------------------------------------------------- |
-| `symbol` | `"📦 "` | Symbol das vor der Paketversion angezeigt wird. |
-| `style` | `"bold 208"` | Stil für dieses Modul. |
-| `display_private` | `false` | Enable displaying version for packages marked as private. |
-| `disabled` | `false` | Deaktiviert das `package`-Modul. |
+| Variable | Standardwert | Beschreibung |
+| ----------------- | ------------ | ---------------------------------------------------------- |
+| `symbol` | `"📦 "` | The symbol used before displaying the version the package. |
+| `style` | `"bold 208"` | Stil für dieses Modul. |
+| `display_private` | `false` | Enable displaying version for packages marked as private. |
+| `disabled` | `false` | Disables the `package` module. |
### Beispiel
@@ -1066,19 +1102,19 @@ symbol = "🐪 "
## PHP
-Das `php`-Modul zeigt die aktuell installierte Version von PHP. Das Modul wird gezeigt, wenn mindestens einer der folgenden Punkte erfüllt ist:
+The `php` module shows the currently installed version of PHP. Das Modul wird gezeigt, wenn mindestens einer der folgenden Punkte erfüllt ist:
-- Das aktuelle Verzeichnis enthält eine `composer.json`-Datei
+- The current directory contains a `composer.json` file
- The current directory contains a `.php-version` file
-- Das aktuelle Verzeichnis enthält eine `.php`-Datei
+- The current directory contains a `.php` file
### Optionen
-| Variable | Standardwert | Beschreibung |
-| ---------- | ------------ | ---------------------------------------------- |
-| `symbol` | `"🐘 "` | Symbol das vor der PHP-Version angezeigt wird. |
-| `style` | `"bold 147"` | Stil für dieses Modul. |
-| `disabled` | `false` | Deaktiviert das `php`-Modul. |
+| Variable | Standardwert | Beschreibung |
+| ---------- | ------------ | ----------------------------------------------------- |
+| `symbol` | `"🐘 "` | The symbol used before displaying the version of PHP. |
+| `style` | `"bold 147"` | Stil für dieses Modul. |
+| `disabled` | `false` | Disables the `php` module. |
### Beispiel
@@ -1097,26 +1133,26 @@ If `pyenv_version_name` is set to `true`, it will display the pyenv version name
Das Modul wird gezeigt, wenn mindestens einer der folgenden Punkte erfüllt ist:
-- Das aktuelle Verzeichnis enthält eine `.python-version`-Datei
-- Das aktuelle Verzeichnis enthält eine `requirements.txt`-Datei
-- Das aktuelle Verzeichnis enthält eine `pyproject.toml`-Datei
+- The current directory contains a `.python-version` file
+- The current directory contains a `requirements.txt` file
+- The current directory contains a `pyproject.toml` file
- The current directory contains a file with the `.py` extension (and `scan_for_pyfiles` is true)
-- Das aktuelle Verzeichnis enthält eine `Pipfile`-Datei
-- Das aktuelle Verzeichnis enthält eine `tox.ini`-Datei
-- Das aktuelle Verzeichnis enthält eine `setup.py`-Datei
+- The current directory contains a `Pipfile` file
+- The current directory contains a `tox.ini` file
+- The current directory contains a `setup.py` file
- The current directory contains a `__init__.py` file
-- Ein virtualenv ist momentan aktiv
+- A virtual environment is currently activated
### Optionen
-| Variable | Standardwert | Beschreibung |
-| -------------------- | --------------- | -------------------------------------------------------------------------- |
-| `symbol` | `"🐍 "` | Symbol das vor der Python-Version angezeigt wird. |
-| `pyenv_version_name` | `false` | Verwende `pyenv` um die Python-Versionzu beziehen. |
-| `pyenv_prefix` | `"pyenv "` | Prefix zur Anzeige der pyenv-Version (Standard: `pyenv MY_VERSION`) |
-| `scan_for_pyfiles` | `true` | If false, Python files in the current directory will not show this module. |
-| `style` | `"bold yellow"` | Stil für dieses Modul. |
-| `disabled` | `false` | Deaktiviert das `python`-Modul. |
+| Variable | Standardwert | Beschreibung |
+| -------------------- | --------------- | --------------------------------------------------------------------------- |
+| `symbol` | `"🐍 "` | The symbol used before displaying the version of Python. |
+| `pyenv_version_name` | `false` | Use pyenv to get Python version |
+| `pyenv_prefix` | `"pyenv "` | Prefix before pyenv version display (default display is `pyenv MY_VERSION`) |
+| `scan_for_pyfiles` | `true` | If false, Python files in the current directory will not show this module. |
+| `style` | `"bold yellow"` | Stil für dieses Modul. |
+| `disabled` | `false` | Disables the `python` module. |
### Beispiel
@@ -1131,19 +1167,19 @@ pyenv_prefix = "foo "
## Ruby
-Das `ruby` Modul zeigt die derzeit installierte Version von Ruby an. Das Modul wird gezeigt, wenn mindestens einer der folgenden Punkte erfüllt ist:
+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
+- The current directory contains a `Gemfile` file
- The current directory contains a `.ruby-version` file
-- Das aktuelle Verzeichnis enthält eine `.rb`-Datei
+- The current directory contains a `.rb` file
### Optionen
-| Variable | Standardwert | Beschreibung |
-| ---------- | ------------ | ----------------------------------------------- |
-| `symbol` | `"💎 "` | Symbol das vor der Ruby-Version angezeigt wird. |
-| `style` | `"bold red"` | Stil für dieses Modul. |
-| `disabled` | `false` | Deaktiviert das `ruby`-Modul. |
+| Variable | Standardwert | Beschreibung |
+| ---------- | ------------ | ------------------------------------------------------ |
+| `symbol` | `"💎 "` | The symbol used before displaying the version of Ruby. |
+| `style` | `"bold red"` | Stil für dieses Modul. |
+| `disabled` | `false` | Disables the `ruby` module. |
### Beispiel
@@ -1156,18 +1192,18 @@ symbol = "🔺 "
## Rust
-Das `rust` Modul zeigt die derzeit installierte Version von Rust an. Das Modul wird gezeigt, wenn mindestens einer der folgenden Punkte erfüllt ist:
+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 Datei mit der `.rs`-Erweiterung
+- The current directory contains a `Cargo.toml` file
+- The current directory contains a file with the `.rs` extension
### Optionen
-| Variable | Standardwert | Beschreibung |
-| ---------- | ------------ | ----------------------------------------------- |
-| `symbol` | `"🦀 "` | Symbol das vor der Rust-Version angezeigt wird. |
-| `style` | `"bold red"` | Stil für dieses Modul. |
-| `disabled` | `false` | Deaktiviert das `rust`-Modul. |
+| Variable | Standardwert | Beschreibung |
+| ---------- | ------------ | ------------------------------------------------------ |
+| `symbol` | `"🦀 "` | The symbol used before displaying the version of Rust. |
+| `style` | `"bold red"` | Stil für dieses Modul. |
+| `disabled` | `false` | Disables the `rust` module. |
### Beispiel
@@ -1204,19 +1240,19 @@ symbol = "📦 "
## Terraform
-Das `Terraform` Modul zeigt den aktuell ausgewählten terraform Arbeitsbereich und die Version an. Standardmäßig wird die Terraform-Version nicht angezeigt, da dies bei aktuellen Versionen von Terraform langsam ist, wenn viele Plugins verwendet werden. Das Modul wird gezeigt, wenn mindestens einer der folgenden Punkte erfüllt ist:
+The `terraform` module shows the currently selected terraform workspace and version. By default the terraform version is not shown, since this is slow on current versions of terraform when a lot of plugins are in use. Das Modul wird gezeigt, wenn mindestens einer der folgenden Punkte erfüllt ist:
-- Das aktuelle Verzeichnis enthält eine `.terraform`-Datei
-- Das aktuelle Verzeichnis enthält eine Datei mit der `.tf`-Erweiterung
+- The current directory contains a `.terraform` folder
+- Current directory contains a file with the `.tf` extension
### Optionen
-| Variable | Standardwert | Beschreibung |
-| -------------- | ------------ | -------------------------------------------------------------------------------------- |
-| `symbol` | `"💠 "` | Das Symbol das vor dem Terraform-Workspacenamen angezeigt wird. |
-| `show_version` | `false` | Blendet die Terraform Versionsnummer ein. Kann In großen Workspaces sehr langsam sein. |
-| `style` | `"bold 105"` | Stil für dieses Modul. |
-| `disabled` | `false` | Deaktiviert das `terraform` Modul. |
+| Variable | Standartwert | Beschreibung |
+| -------------- | ------------ | ----------------------------------------------------------- |
+| `symbol` | `"💠 "` | The symbol used before displaying the terraform workspace. |
+| `show_version` | `false` | Shows the terraform version. Very slow on large workspaces. |
+| `style` | `"bold 105"` | Stil für dieses Modul. |
+| `disabled` | `false` | Disables the `terraform` module. |
### Beispiel
@@ -1227,27 +1263,28 @@ Das `Terraform` Modul zeigt den aktuell ausgewählten terraform Arbeitsbereich u
symbol = "🏎💨 "
```
-## Zeit
+## Time
-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.
+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.
-::: Tipp
+::: tip
-Dieses Modul ist standardmäßig deaktiviert. Setze in deiner Konfiguration `disabled` auf `false` um es zu aktivieren.
+This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
:::
### Optionen
-| Variable | Standartwert | Beschreibung |
-| ----------------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------- |
-| `use_12hr` | `false` | Aktiviert 12-Stunden-Format |
-| `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"` | Stil für dieses Modul |
-| `utc_time_offset` | `"local"` | Verwendetes Zeitzonen-Offset. Liegt zwischen -24 < x < 24. Allows floats to accommodate 30/45 minute timezone offsets. |
-| `disabled` | `true` | Deaktiviert das `time`-Modul. |
+| Variable | Standartwert | Beschreibung |
+| ----------------- | --------------- | ------------------------------------------------------------------------------------------------------------------- |
+| `use_12hr` | `false` | Enables 12 hour formatting. |
+| `format` | see below | The [chrono format string](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) used to format the time. |
+| `style` | `"bold yellow"` | The style for the module time. |
+| `utc_time_offset` | `"local"` | Sets the UTC offset to use. Range from -24 < x < 24. Allows floats to accommodate 30/45 minute timezone offsets. |
+| `disabled` | `true` | Disables the `time` module. |
+| `time_range` | `"-"` | Sets the time range during which the module will be shown. Times must be specified in 24-hours format |
-Wird `use_12hr` auf `true` gestellt, nimmt `format` automatisch den Wert `"%r"` an. Andernfalls ist es standardmäßig `"%T"`. Wird hingegen `format` gesetzt, so überschreibt dies die Einstellung `use_12hr`.
+If `use_12hr` is `true`, then `format` defaults to `"%r"`. Otherwise, it defaults to `"%T"`. Manually setting `format` will override the `use_12hr` setting.
### Beispiel
@@ -1258,25 +1295,26 @@ Wird `use_12hr` auf `true` gestellt, nimmt `format` automatisch den Wert `"%r"`
disabled = false
format = "🕙[ %T ]"
utc_time_offset = "-5"
+time_range = "10:00:00-14:00:00"
```
## Username
-Das `username` Modul zeigt den Namen des aktiven Benutzers. Das Modul wird gezeigt, wenn mindestens einer der folgenden Punkte erfüllt ist:
+The `username` module shows active user's username. Das Modul wird gezeigt, wenn mindestens einer der folgenden Punkte erfüllt ist:
-- Der aktuelle Benutzer ist root
-- Der aktuelle Benutzer ist nicht der eingeloggte Benutzer
-- Der Benutzer ist aktuell via SSH verbunden
-- Die Variable `show_always` ist auf true gesetzt
+- The current user is root
+- The current user isn't the same as the one that is logged in
+- The user is currently connected as an SSH session
+- The variable `show_always` is set to true
### Optionen
-| Variable | Standartwert | Beschreibung |
-| ------------- | --------------- | ---------------------------------------------- |
-| `style_root` | `"bold red"` | Stil wenn der Benutzer unter root läuft. |
-| `style_user` | `"bold yellow"` | Stil wenn der Benutzer nicht unter root läuft. |
-| `show_always` | `false` | Immer das `username` Modul anzeigen. |
-| `disabled` | `false` | Deavktiviert das `username` Modul. |
+| Variable | Standartwert | Beschreibung |
+| ------------- | --------------- | ------------------------------------- |
+| `style_root` | `"bold red"` | The style used when the user is root. |
+| `style_user` | `"bold yellow"` | The style used for non-root users. |
+| `show_always` | `false` | Always shows the `username` module. |
+| `disabled` | `false` | Disables the `username` module. |
### Beispiel
@@ -1321,13 +1359,13 @@ 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 `when` command returns 0
-::: Tipp
+::: tip
Multiple custom modules can be defined by using a `.`.
:::
-::: Tipp
+::: tip
The order in which custom modules are shown can be individually set by setting `custom.foo` in `prompt_order`. By default, the `custom` module will simply show all custom modules in the order they were defined.
@@ -1335,20 +1373,46 @@ The order in which custom modules are shown can be individually set by setting `
### Optionen
-| Variable | Standartwert | Beschreibung |
-| -------------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
-| `command` | | The command whose output should be printed. |
-| `when` | | A shell command used as a condition to show the module. The module will be shown if the command returns a `0` status code. |
-| `shell` | | The path to the shell to use to execute the command. If unset, it will fallback to STARSHIP_SHELL and then to "sh". |
-| `beschreibung` | `"このモジュールは、どのようにディレクトリを表示するかについての高度なオプションをいくつか持っています。
-| 変数 | デフォルト | 説明 |
-| --------------------------- | ------ | -------------------------------------------- |
-| `fish_style_pwd_dir_length` | `0` | fish shellのpwdパスロジックを適用するときに使用する文字数です。 |
-| `use_logical_path` | `true` | OSからのパスの代わりに、シェル(`PWD`) によって提供される論理パスを表示します。 |
+| 変数 | デフォルト | 説明 |
+| --------------------------- | ------ | ---------------------------------------------------------------------------------------- |
+| `substitutions` | | A table of substitutions to be made to the path. |
+| `fish_style_pwd_dir_length` | `0` | The number of characters to use when applying fish shell pwd path logic. |
+| `use_logical_path` | `true` | Displays the logical path provided by the shell (`PWD`) instead of the path from the OS. |
+
+`substitutions` allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories (i.e. Java). Note that this will disable the fish style PWD.
+
+```toml
+[directory.substitutions]
+"/Volumes/network/path" = "/net"
+"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`.
@@ -394,7 +404,7 @@ truncation_length = 8
## 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コンテキストを表示します。
### オプション
@@ -403,7 +413,7 @@ The `docker_context` module shows the currently active [Docker context](https://
| `symbol` | `"🐳 "` | The symbol used before displaying the Docker context . |
| `only_with_files` | `false` | Only show when there's a `docker-compose.yml` or `Dockerfile` in the current directory. |
| `style` | `"bold blue"` | モジュールのスタイルです。 |
-| `disabled` | `true` | Disables the `docker_context` module. |
+| `disabled` | `true` | `docker_context`モジュールを無効にします。 |
### 設定例
@@ -471,7 +481,7 @@ symbol = "🔮 "
- カレントディレクトリに`elm.json`ファイルが含まれている
- カレントディレクトリに`elm-package.json`ファイルが含まれている
-- The current directory contains a `.elm-version` file
+- カレントディレクトリに`.elm-version`ファイルが含まれている
- カレントディレクトリに`elm-stuff`フォルダが含まれている
- カレントディレクトリに`*.elm`ファイルが含まれている
@@ -692,7 +702,7 @@ deleted = "🗑"
- カレントディレクトリに`glide.yaml`ファイルが含まれている
- カレントディレクトリに`Gopkg.yml`ファイルが含まれている
- カレントディレクトリに`Gopkg.lock`ファイルが含まれている
-- The current directory contains a `.go-version` file
+- カレントディレクトリに`.go-version`ファイルが含まれている
- カレントディレクトリに`Godeps`ファイルが含まれている
- カレントディレクトリに`.go`の拡張子のファイルが含まれている
@@ -768,7 +778,7 @@ disabled = false
`java`モジュールは、現在インストールされているJavaのバージョンを示します。 次の条件のいずれかが満たされると、モジュールが表示されます。
-- The current directory contains a `pom.xml`, `build.gradle.kts`, `build.sbt` or `.java-version` file
+- カレントディレクトリに `pom.xml`, `build.gradle.kts`, `build.sbt` ,もしくは`.java-version`が含まれている
- カレントディレクトリに拡張子が`.java`, `.class`, `.gradle`, もしくは`.jar`のファイルが含まれている
### オプション
@@ -869,7 +879,7 @@ disabled = false
## 改行
-`line_break`モジュールは、プロンプトを2行に分割します。
+The `line_break` module separates the prompt into two lines.
### オプション
@@ -888,14 +898,13 @@ disabled = true
## メモリ使用量
-`memory_usage 0>モジュールは、現在のシステムメモリとスワップ使用量を示します。
デフォルトでは、システムスワップの合計がゼロ以外の場合、スワップ使用量が表示されます。
+By default the swap usage is displayed if the total system swap is non-zero. -::: tip
+::: tip -このモジュールはデフォルトで無効になっています。
-有効にするには、設定ファイルでdisabled`を`false`に設定します。
+このモジュールはデフォルトで無効になっています。 有効にするには、設定ファイルで`disabled`を`false`に設定します。
:::
@@ -928,7 +937,7 @@ style = "bold dimmed green"
## Mercurial ブランチ
-` hg_branch `モジュールは、現在のディレクトリにあるリポジトリのアクティブなブランチを示します。
+The `hg_branch` module shows the active branch of the repo in your current directory.
### オプション
@@ -951,20 +960,46 @@ truncation_length = 4
truncation_symbol = ""
```
+## Nim
+
+The `nim` module shows the currently installed version of Nim. 次の条件のいずれかが満たされると、モジュールが表示されます。
+- The current directory contains a `nim.cfg` file
+- The current directory contains a file with the `.nim` extension
+- The current directory contains a file with the `.nims` extension
+- The current directory contains a file with the `.nimble` extension
+
+### オプション
+
+| 変数 | デフォルト | 説明 |
+| ---------- | --------------- | ----------------------------------------------------- |
+| `symbol` | `"👑 "` | The symbol used before displaying the version of Nim. |
+| `style` | `"bold yellow"` | モジュールのスタイルです。 |
+| `disabled` | `false` | Disables the `nim` module. |
+
+### 設定例
+
+```toml
+# ~/.config/starship.toml
+
+[nim]
+style = "yellow"
+symbol = "🎣 "
+```
+
## Nix-shell
-`nix_shell`モジュールは、nix-shell環境を示しています。 このモジュールは、nixシェル環境内にあるときに表示されます。
+The `nix_shell` module shows the nix-shell environment. The module will be shown when inside a nix-shell environment.
### オプション
| 変数 | デフォルト | 説明 |
| ------------ | ------------- | ------------------------------------------------- |
-| `use_name` | `false` | nix-shellの名前を表示します。 |
-| `impure_msg` | `"impure"` | impureメッセージをカスタマイズします。 |
-| `pure_msg` | `"pure"` | pureメッセージをカスタマイズします。 |
+| `use_name` | `false` | Display the name of the nix-shell. |
+| `impure_msg` | `"impure"` | Customize the "impure" msg. |
+| `pure_msg` | `"pure"` | Customize the "pure" msg. |
| `symbol` | `"❄️ "` | The symbol used before displaying the shell name. |
| `style` | `"bold blue"` | モジュールのスタイルです。 |
-| `disabled` | `false` | `nix_shell`モジュールを無効にします。 |
+| `disabled` | `false` | Disables the `nix_shell` module. |
### 設定例
@@ -981,20 +1016,20 @@ symbol = "☃️ "
## NodeJS
-`nodejs`モジュールは、現在インストールされているNodeJSのバージョンを示します。 次の条件のいずれかが満たされると、モジュールが表示されます。
+The `nodejs` module shows the currently installed version of NodeJS. 次の条件のいずれかが満たされると、モジュールが表示されます。
-- カレントディレクトリに`package.json`ファイルが含まれている
+- The current directory contains a `package.json` file
- The current directory contains a `.node-version` file
-- カレントディレクトリに`node_modules`ディレクトリが含まれている
-- カレントディレクトリに`.js`の拡張子のファイルが含まれている
+- The current directory contains a `node_modules` directory
+- The current directory contains a file with the `.js` extension
### オプション
-| 変数 | デフォルト | 説明 |
-| ---------- | -------------- | ----------------------------- |
-| `symbol` | `"⬢ "` | NodeJSのバージョンを表示する前に使用される記号です。 |
-| `style` | `"bold green"` | モジュールのスタイルです。 |
-| `disabled` | `false` | `nodejs`モジュールを無効にします。 |
+| 変数 | デフォルト | 説明 |
+| ---------- | -------------- | -------------------------------------------------------- |
+| `symbol` | `"⬢ "` | The symbol used before displaying the version of NodeJS. |
+| `style` | `"bold green"` | モジュールのスタイルです。 |
+| `disabled` | `false` | Disables the `nodejs` module. |
### 設定例
@@ -1005,14 +1040,14 @@ symbol = "☃️ "
symbol = "🤖 "
```
-## パッケージのバージョン
+## Package Version
-`package`モジュールは、現在のディレクトリがパッケージのリポジトリである場合に表示され、現在のバージョンが表示されます。 The module currently supports `npm`, `cargo`, `poetry`, `composer`, `gradle`, `julia` and `mix` packages.
+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` and `mix` packages.
-- **npm** – `npm`パッケージバージョンは、現在のディレクトリにある`package.json`から抽出されます
-- **cargo** – `cargo`パッケージバージョンは、現在のディレクトリにある`Cargo.toml`から抽出されます。
-- **poetry** – `poetry`パッケージバージョンは、現在のディレクトリにある`pyproject.toml`から抽出されます
-- **composer** – `composer`パッケージバージョンは、現在のディレクトリにある`composer.json`から抽出されます
+- **npm** – The `npm` package version is extracted from the `package.json` present in the current directory
+- **cargo** – The `cargo` package version is extracted from the `Cargo.toml` present in the current directory
+- **poetry** – The `poetry` package version is extracted from the `pyproject.toml` present in the current directory
+- **composer** – The `composer` package version is extracted from the `composer.json` present in the current directory
- **gradle** – The `gradle` package version is extracted from the `build.gradle` present
- **julia** - The package version is extracted from the `Project.toml` present
- **mix** - The `mix` package version is extracted from the `mix.exs` present
@@ -1021,12 +1056,12 @@ symbol = "🤖 "
### オプション
-| 変数 | デフォルト | 説明 |
-| ----------------- | ------------ | --------------------------------------------------------- |
-| `symbol` | `"📦 "` | パッケージのバージョンを表示する前に使用される記号です。 |
-| `style` | `"bold 208"` | モジュールのスタイルです。 |
-| `display_private` | `false` | Enable displaying version for packages marked as private. |
-| `disabled` | `false` | `package` モジュールを無効にします。 |
+| 変数 | デフォルト | 説明 |
+| ----------------- | ------------ | ---------------------------------------------------------- |
+| `symbol` | `"📦 "` | The symbol used before displaying the version the package. |
+| `style` | `"bold 208"` | モジュールのスタイルです。 |
+| `display_private` | `false` | Enable displaying version for packages marked as private. |
+| `disabled` | `false` | Disables the `package` module. |
### 設定例
@@ -1067,19 +1102,19 @@ symbol = "🐪 "
## PHP
-`php`モジュールは、現在インストールされているPHPのバージョンを示します。 次の条件のいずれかが満たされると、モジュールが表示されます。
+The `php` module shows the currently installed version of PHP. 次の条件のいずれかが満たされると、モジュールが表示されます。
-- カレントディレクトリに`composer.json`ファイルが含まれている
+- The current directory contains a `composer.json` file
- The current directory contains a `.php-version` file
-- カレントディレクトリに`.php`の拡張子のファイルが含まれている
+- The current directory contains a `.php` file
### オプション
-| 変数 | デフォルト | 説明 |
-| ---------- | ------------ | -------------------------- |
-| `symbol` | `"🐘 "` | PHPのバージョンを表示する前に使用される記号です。 |
-| `style` | `"bold 147"` | モジュールのスタイルです。 |
-| `disabled` | `false` | `php`モジュールを無効にします。 |
+| 変数 | デフォルト | 説明 |
+| ---------- | ------------ | ----------------------------------------------------- |
+| `symbol` | `"🐘 "` | The symbol used before displaying the version of PHP. |
+| `style` | `"bold 147"` | モジュールのスタイルです。 |
+| `disabled` | `false` | Disables the `php` module. |
### 設定例
@@ -1098,26 +1133,26 @@ If `pyenv_version_name` is set to `true`, it will display the pyenv version name
次の条件のいずれかが満たされると、モジュールが表示されます。
-- カレントディレクトリに`.python-version`ファイルが含まれている
-- カレントディレクトリに`requirements.txt`ファイルが含まれている
-- カレントディレクトリに`pyproject.toml`ファイルが含まれている
+- The current directory contains a `.python-version` file
+- The current directory contains a `requirements.txt` file
+- The current directory contains a `pyproject.toml` file
- The current directory contains a file with the `.py` extension (and `scan_for_pyfiles` is true)
-- カレントディレクトリに`Pipfile`ファイルが含まれている
-- カレントディレクトリに`tox.ini`ファイルが含まれている
-- カレントディレクトリに`setup.py`ファイルが含まれている
+- The current directory contains a `Pipfile` file
+- The current directory contains a `tox.ini` file
+- The current directory contains a `setup.py` file
- The current directory contains a `__init__.py` file
-- 仮想環境がアクティブである
+- A virtual environment is currently activated
### オプション
-| 変数 | デフォルト | 説明 |
-| -------------------- | --------------- | -------------------------------------------------------------------------- |
-| `symbol` | `"🐍 "` | Pythonのバージョンを表示する前に使用される記号です。 |
-| `pyenv_version_name` | `false` | pyenvを使用してPythonバージョンを取得します |
-| `pyenv_prefix` | `"pyenv "` | pyenvバージョン表示の前のprefix (デフォルトの表示は`pyenv MY_VERSION`) です |
-| `scan_for_pyfiles` | `true` | If false, Python files in the current directory will not show this module. |
-| `style` | `"bold yellow"` | モジュールのスタイルです。 |
-| `disabled` | `false` | `python`モジュールを無効にします。 |
+| 変数 | デフォルト | 説明 |
+| -------------------- | --------------- | --------------------------------------------------------------------------- |
+| `symbol` | `"🐍 "` | The symbol used before displaying the version of Python. |
+| `pyenv_version_name` | `false` | Use pyenv to get Python version |
+| `pyenv_prefix` | `"pyenv "` | Prefix before pyenv version display (default display is `pyenv MY_VERSION`) |
+| `scan_for_pyfiles` | `true` | If false, Python files in the current directory will not show this module. |
+| `style` | `"bold yellow"` | モジュールのスタイルです。 |
+| `disabled` | `false` | Disables the `python` module. |
### 設定例
@@ -1132,19 +1167,19 @@ pyenv_prefix = "foo "
## Ruby
-`ruby`モジュールは、現在インストールされているRubyのバージョンを示します。 次の条件のいずれかが満たされると、モジュールが表示されます。
+The `ruby` module shows the currently installed version of Ruby. 次の条件のいずれかが満たされると、モジュールが表示されます。
-- カレントディレクトリに`Gemfile`ファイルが含まれている
+- The current directory contains a `Gemfile` file
- The current directory contains a `.ruby-version` file
-- カレントディレクトリに`.rb`の拡張子のファイルが含まれている
+- The current directory contains a `.rb` file
### オプション
-| 変数 | デフォルト | 説明 |
-| ---------- | ------------ | --------------------------- |
-| `symbol` | `"💎 "` | Rubyのバージョンを表示する前に使用される記号です。 |
-| `style` | `"bold red"` | モジュールのスタイルです。 |
-| `disabled` | `false` | `ruby`モジュールを無効にします。 |
+| 変数 | デフォルト | 説明 |
+| ---------- | ------------ | ------------------------------------------------------ |
+| `symbol` | `"💎 "` | The symbol used before displaying the version of Ruby. |
+| `style` | `"bold red"` | モジュールのスタイルです。 |
+| `disabled` | `false` | Disables the `ruby` module. |
### 設定例
@@ -1157,18 +1192,18 @@ symbol = "🔺 "
## Rust
-`rust`モジュールには、現在インストールされているRustのバージョンが表示されます。 次の条件のいずれかが満たされると、モジュールが表示されます。
+The `rust` module shows the currently installed version of Rust. 次の条件のいずれかが満たされると、モジュールが表示されます。
-- カレントディレクトリに`Cargo.toml`ファイルが含まれている
-- カレントディレクトリに`.rs`の拡張子のファイルが含まれている
+- The current directory contains a `Cargo.toml` file
+- The current directory contains a file with the `.rs` extension
### オプション
-| 変数 | デフォルト | 説明 |
-| ---------- | ------------ | --------------------------- |
-| `symbol` | `"🦀 "` | Rustのバージョンを表示する前に使用される記号です。 |
-| `style` | `"bold red"` | モジュールのスタイルです。 |
-| `disabled` | `false` | `rust`モジュールを無効にします。 |
+| 変数 | デフォルト | 説明 |
+| ---------- | ------------ | ------------------------------------------------------ |
+| `symbol` | `"🦀 "` | The symbol used before displaying the version of Rust. |
+| `style` | `"bold red"` | モジュールのスタイルです。 |
+| `disabled` | `false` | Disables the `rust` module. |
### 設定例
@@ -1205,19 +1240,19 @@ symbol = "📦 "
## Terraform
-`terraform`モジュールには、現在選択されているterraformワークスペースとバージョンが表示されます。 デフォルトでは、Terraformのバージョンは表示されません。これは、多くのプラグインが使用されている場合、Terraformの現在のバージョンでは遅いためです。 次の条件のいずれかが満たされると、モジュールが表示されます。
+The `terraform` module shows the currently selected terraform workspace and version. By default the terraform version is not shown, since this is slow on current versions of terraform when a lot of plugins are in use. 次の条件のいずれかが満たされると、モジュールが表示されます。
-- カレントディレクトリに`.terraform`フォルダが含まれている
-- カレントディレクトリに`.tf`の拡張子のファイルが含まれている
+- The current directory contains a `.terraform` folder
+- Current directory contains a file with the `.tf` extension
### オプション
-| 変数 | デフォルト | 説明 |
-| -------------- | ------------ | --------------------------------------------- |
-| `symbol` | `"💠 "` | Terraform ワークスペースを表示する前に使用される記号です。 |
-| `show_version` | `false` | Terraformのバージョンを表示します。 大きなワークスペースでは非常に遅くなります。 |
-| `style` | `"bold 105"` | モジュールのスタイルです。 |
-| `disabled` | `false` | `terraform`モジュールを無効にします。 |
+| 変数 | デフォルト | 説明 |
+| -------------- | ------------ | ----------------------------------------------------------- |
+| `symbol` | `"💠 "` | The symbol used before displaying the terraform workspace. |
+| `show_version` | `false` | Shows the terraform version. Very slow on large workspaces. |
+| `style` | `"bold 105"` | モジュールのスタイルです。 |
+| `disabled` | `false` | Disables the `terraform` module. |
### 設定例
@@ -1228,9 +1263,9 @@ symbol = "📦 "
symbol = "🏎💨 "
```
-## 時刻
+## Time
-`time`モジュールは、現在の**現地**時間を示します。 `format`設定は、時間の表示方法を制御するために[`chrono`](https://crates.io/crates/chrono)クレートによって使用されます。 使用可能なオプションを確認するには、[chrono strftimeのドキュメント](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html)をご覧ください。
+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
@@ -1240,15 +1275,16 @@ symbol = "🏎💨 "
### オプション
-| 変数 | デフォルト | 説明 |
-| ----------------- | --------------- | ------------------------------------------------------------------------------------------------- |
-| `use_12hr` | `false` | 12時間のフォーマットを有効にします。 |
-| `format` | この表の下を参照してください | 時刻のフォーマットに使用される[クロノフォーマット文字列](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) です。 |
-| `style` | `"bold yellow"` | モジュールのスタイルです。 |
-| `utc_time_offset` | `"local"` | 使用するUTCオフセットを設定します。 -24から24までの間で設定可能です。 フロートが30/45分のタイムゾーンオフセットに対応できるようにします。 |
-| `disabled` | `true` | `time`モジュールを無効にします。 |
+| 変数 | デフォルト | 説明 |
+| ----------------- | --------------- | ------------------------------------------------------------------------------------------------------------------- |
+| `use_12hr` | `false` | Enables 12 hour formatting. |
+| `format` | see below | The [chrono format string](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) used to format the time. |
+| `style` | `"bold yellow"` | The style for the module time. |
+| `utc_time_offset` | `"local"` | Sets the UTC offset to use. Range from -24 < x < 24. Allows floats to accommodate 30/45 minute timezone offsets. |
+| `disabled` | `true` | Disables the `time` module. |
+| `time_range` | `"-"` | Sets the time range during which the module will be shown. Times must be specified in 24-hours format |
-`use_12hr` が `true` の場合、`format` のデフォルトは `"%r"` です。 それ以外の場合、デフォルトは`"%T"`です。 `format`を手動で設定すると、`use_12hr`の設定が上書きされます。
+If `use_12hr` is `true`, then `format` defaults to `"%r"`. Otherwise, it defaults to `"%T"`. Manually setting `format` will override the `use_12hr` setting.
### 設定例
@@ -1259,25 +1295,26 @@ symbol = "🏎💨 "
disabled = false
format = "🕙[ %T ]"
utc_time_offset = "-5"
+time_range = "10:00:00-14:00:00"
```
-## ユーザー名
+## Username
-`username`モジュールには、アクティブなユーザーのユーザー名が表示されます。 次の条件のいずれかが満たされると、モジュールが表示されます。
+The `username` module shows active user's username. 次の条件のいずれかが満たされると、モジュールが表示されます。
-- カレントユーザーがroot
-- カレントユーザーが、ログインしているユーザーとは異なる
-- ユーザーがSSHセッションとして接続されている
-- `show_always`変数がtrueに設定されている
+- The current user is root
+- The current user isn't the same as the one that is logged in
+- The user is currently connected as an SSH session
+- The variable `show_always` is set to true
### オプション
-| 変数 | デフォルト | 説明 |
-| ------------- | --------------- | ------------------------- |
-| `style_root` | `"bold red"` | ユーザーがrootのときに使用されるスタイルです。 |
-| `style_user` | `"bold yellow"` | 非rootユーザーに使用されるスタイルです。 |
-| `show_always` | `false` | `username` モジュールを常に表示します。 |
-| `disabled` | `false` | `username` モジュールを無効にします。 |
+| 変数 | デフォルト | 説明 |
+| ------------- | --------------- | ------------------------------------- |
+| `style_root` | `"bold red"` | The style used when the user is root. |
+| `style_user` | `"bold yellow"` | The style used for non-root users. |
+| `show_always` | `false` | Always shows the `username` module. |
+| `disabled` | `false` | Disables the `username` module. |
### 設定例
@@ -1340,8 +1377,8 @@ The order in which custom modules are shown can be individually set by setting `
| ------------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `command` | | The command whose output should be printed. |
| `when` | | A shell command used as a condition to show the module. The module will be shown if the command returns a `0` status code. |
-| `shell` | | The path to the shell to use to execute the command. If unset, it will fallback to STARSHIP_SHELL and then to "sh". |
-| `説明` | `"
Этот модуль имеет несколько расширенных опций конфигурации, которые контролируют отображение каталога.
-| Переменная | По умолчанию | Описание |
-| --------------------------- | ------------ | --------------------------------------------------------------------------------- |
-| `fish_style_pwd_dir_length` | `0` | Количество символов, используемых при использовании логики создания пути из fish. |
-| `use_logical_path` | `true` | Отображает логический путь от оболочки (`PWD`) вместо пути от ОС. |
+| Переменная | По умолчанию | Описание |
+| --------------------------- | ------------ | ---------------------------------------------------------------------------------------- |
+| `substitutions` | | A table of substitutions to be made to the path. |
+| `fish_style_pwd_dir_length` | `0` | The number of characters to use when applying fish shell pwd path logic. |
+| `use_logical_path` | `true` | Displays the logical path provided by the shell (`PWD`) instead of the path from the OS. |
-`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`.
+`substitutions` allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories (i.e. Java). Note that this will disable the fish style PWD.
+
+```toml
+[directory.substitutions]
+"/Volumes/network/path" = "/net"
+"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` | `0` | 使用 fish shell 当前目录路径逻辑时每个省略目录名使用的字符数。 |
-| `use_logical_path` | `true` | 显示由 shell 提供的逻辑路径(`PWD`)而不是 OS 提供的路径。 |
+| 字段 | 默认值 | 描述 |
+| --------------------------- | ------ | ---------------------------------------------------------------------------------------- |
+| `substitutions` | | A table of substitutions to be made to the path. |
+| `fish_style_pwd_dir_length` | `0` | The number of characters to use when applying fish shell pwd path logic. |
+| `use_logical_path` | `true` | Displays the logical path provided by the shell (`PWD`) instead of the path from the OS. |
+
+`substitutions` allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories (i.e. Java). Note that this will disable the fish style PWD.
+
+```toml
+[directory.substitutions]
+"/Volumes/network/path" = "/net"
+"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`.
@@ -416,11 +426,11 @@ symbol = "🐋 "
## Dotnet
-`dotnet` 模块显示与当前目录下使用的 .NET Core SDK 相关联的版本。 如果当前目录已被绑定了一个版本的 SDK,则显示被帮定的版本。 否则此组件将显示最新安装的 SDK 版本。
+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.
-此组件只会在以下文件之一出现在当前目录中时显示:`global.json`,`project.json`,`*.sln`,`*.csproj`,`*.fsproj`,`*.xproj`。 为了正确使用此组件,您还需要安装 .NET Core 命令行工具。
+This module will only be shown in your prompt when one of the following files are present in the current directory: `global.json`, `project.json`, `*.sln`, `*.csproj`, `*.fsproj`, `*.xproj`. You'll also need the .NET Core command-line tools installed in order to use it correctly.
-在内部,此组件使用自己的版本检测机制。 一般来说此组件是直接执行 `dotnet --version` 的两倍快,但当你的 .NET 项目使用了不常见的目录布局时此组件可能显示一个错误的版本。 如果相比于速度您更需要正确的版本号,您可以在组件设置中设置 `heuristic = false` 来禁用该机制。
+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.
### 配置项
@@ -444,7 +454,7 @@ heuristic = false
## Elixir
-The `elixir` module shows the currently installed version of Elixir and Erlang/OTP. 此组件将在符合以下任意条件时显示:
+The `elixir` module shows the currently installed version of Elixir and Erlang/OTP. 此组件将在符合以下任意条件之一时显示:
- 当前目录包含一个 `mix.exs` 文件.
@@ -495,7 +505,7 @@ symbol = " "
## Environment Variable
-`env_var` 组件显示选定的环境变量的当前值。 此组件只有满足以下条件之一时才会被显示:
+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:
- 设置的 `variable` 是一个已存在的环境变量
- 未定义 `variable`,但定义了 `default`
@@ -548,7 +558,7 @@ symbol = "e "
## Git Branch
-`git_branch` 组件显示当前目录的 git 仓库的活动分支。
+The `git_branch` module shows the active branch of the repo in your current directory.
### 配置项
@@ -573,7 +583,7 @@ truncation_symbol = ""
## Git Commit
-`git_commit` 组件显示当前目录的 git 仓库的当前提交的哈希值。
+The `git_commit` module shows the current commit hash of the repo in your current directory.
### 配置项
@@ -597,7 +607,7 @@ commit_hash_length = 4
## Git State
-`git_state` 组件会显示当前目录在哪个 git 仓库中,以及正在进行的操作,例如:_REBASING_,_BISECTING_ 等。 进度信息(例如 REBASING 3/10)如果存在则也会被显示。
+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.
### 配置项
@@ -626,7 +636,7 @@ cherry_pick = "🍒 PICKING"
## Git Status
-`git_status`组件通过相应的符号显示您当前目录中 git 仓库的状态。
+The `git_status` module shows symbols representing the state of the repo in your current directory.
### 配置项
@@ -685,7 +695,7 @@ deleted = "🗑"
## Golang
-`golang` 组件显示当前安装的 Golang 版本。 此组件将在符合以下任意条件之一时显示:
+The `golang` module shows the currently installed version of Golang. 此组件将在符合以下任意条件之一时显示:
- 当前目录包含 `go.mod` 文件
- 当前目录包含 `go.sum` 文件
@@ -714,7 +724,7 @@ symbol = "🏎💨 "
```
## Haskell
-`haskell` 组件显示当前安装的 Haskell Stack 版本。 此组件将在符合以下任意条件之一时显示:
+The `haskell` module shows the currently installed version of Haskell Stack version. 此组件将在符合以下任意条件之一时显示:
- 当前目录包含 `stack.yaml` 文件
@@ -738,7 +748,7 @@ symbol = " "
## Hostname
-`hostname` 组件显示系统主机名。
+The `hostname` module shows the system hostname.
### 配置项
@@ -766,7 +776,7 @@ disabled = false
## Java
-`java` 组件显示当前安装的 Java 版本。 此组件将在符合以下任意条件之一时显示:
+The `java` module shows the currently installed version of Java. 此组件将在符合以下任意条件之一时显示:
- The current directory contains a `pom.xml`, `build.gradle.kts`, `build.sbt` or `.java-version` file
- 当前目录包含一个扩展名为 `.java`,`.class`,`.gradle` 或 `.jar` 的文件
@@ -790,7 +800,7 @@ symbol = "🌟 "
## Jobs
-`jobs` 组件显示当前正在运行的任务数量。 仅当有后台任务运行时,此组件才会显示。 如果有超过 1 个作业,模块将显示正在运行的作业数量,如果配置了 `threshold` 字段,则使用它作为显示作业数量的下限。
+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.
### 配置项
@@ -837,11 +847,11 @@ symbol = "∴ "
```
## Kubernetes
-显示当前的 Kubernetes 上下文名以及,如果有相关设置,则显示来自 kubeconig 文件的命名空间。 命名空间需要在 kubeconfig 文件中设置,这可以通过 `kubectl config set-context starship-cluster --namespace astronaut` 完成。 如果设置了环境变量 `$KUBECONFIG`,此组件将使用该值,否则会使用 `~/.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
-此组件默认被禁用。 若要启用此组件,请在配置文件中设置 `disable` 字段为 `false`。
+This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
:::
@@ -869,7 +879,7 @@ disabled = false
## Line Break
-`line_break` 组件将提示分隔为两行。
+The `line_break` module separates the prompt into two lines.
### 配置项
@@ -888,13 +898,13 @@ disabled = true
## Memory Usage
-`memory_usage` 组件显示当前系统内存和交换区使用情况。
+The `memory_usage` module shows current system memory and swap usage.
-默认情况下,如果系统交换区使用不为 0,则会显示交换区使用情况。
+By default the swap usage is displayed if the total system swap is non-zero.
::: tip
-此组件默认被禁用。 若要启用此组件,请在配置文件中设置 `disable` 字段为 `false`。
+This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
:::
@@ -927,7 +937,7 @@ style = "bold dimmed green"
## Mercurial Branch
-`hg_branch` 组件显示当前目录的 hg 仓库的活动分支。
+The `hg_branch` module shows the active branch of the repo in your current directory.
### 配置项
@@ -950,20 +960,46 @@ truncation_length = 4
truncation_symbol = ""
```
+## Nim
+
+The `nim` module shows the currently installed version of Nim. 此组件将在符合以下任意条件之一时显示:
+- The current directory contains a `nim.cfg` file
+- The current directory contains a file with the `.nim` extension
+- The current directory contains a file with the `.nims` extension
+- The current directory contains a file with the `.nimble` extension
+
+### 配置项
+
+| 字段 | 默认值 | 描述 |
+| ---------- | --------------- | ----------------------------------------------------- |
+| `symbol` | `"👑 "` | The symbol used before displaying the version of Nim. |
+| `style` | `"bold yellow"` | 此组件的样式。 |
+| `disabled` | `false` | Disables the `nim` module. |
+
+### 示例
+
+```toml
+# ~/.config/starship.toml
+
+[nim]
+style = "yellow"
+symbol = "🎣 "
+```
+
## Nix-shell
-`nix_shell` 组件显示 nix-shell 环境。 当处于一个 nix-shell 环境中时,此组件会被显示。
+The `nix_shell` module shows the nix-shell environment. The module will be shown when inside a nix-shell environment.
### 配置项
| 字段 | 默认值 | 描述 |
| ------------ | ------------- | ------------------------------------------------- |
-| `use_name` | `false` | 显示 nix-shell 的名称。 |
-| `impure_msg` | `"impure"` | 自定义“impure”消息。 |
-| `pure_msg` | `"pure"` | 自定义“pure”消息。 |
+| `use_name` | `false` | Display the name of the nix-shell. |
+| `impure_msg` | `"impure"` | Customize the "impure" msg. |
+| `pure_msg` | `"pure"` | Customize the "pure" msg. |
| `symbol` | `"❄️ "` | The symbol used before displaying the shell name. |
| `style` | `"bold blue"` | 此组件的样式。 |
-| `disabled` | `false` | 禁用 `nix_shell` 组件。 |
+| `disabled` | `false` | Disables the `nix_shell` module. |
### 示例
@@ -980,20 +1016,20 @@ symbol = "☃️ "
## NodeJS
-`nodejs` 组件显示当前安装的 NodeJS 版本。 此组件将在符合以下任意条件之一时显示:
+The `nodejs` module shows the currently installed version of NodeJS. 此组件将在符合以下任意条件之一时显示:
-- 当前目录包含 `package.json` 文件
+- The current directory contains a `package.json` file
- The current directory contains a `.node-version` file
-- 当前目录包含 `node_modules` 目录
-- 当前目录包含一个使用 `.js` 扩展名的文件
+- The current directory contains a `node_modules` directory
+- The current directory contains a file with the `.js` extension
### 配置项
-| 字段 | 默认值 | 描述 |
-| ---------- | -------------- | -------------------------- |
-| `symbol` | `"⬢ "` | 这个字段的内容会显示在当前 NodeJS 版本之前。 |
-| `style` | `"bold green"` | 此组件的样式。 |
-| `disabled` | `false` | 禁用 `nodejs` 组件。 |
+| 字段 | 默认值 | 描述 |
+| ---------- | -------------- | -------------------------------------------------------- |
+| `symbol` | `"⬢ "` | The symbol used before displaying the version of NodeJS. |
+| `style` | `"bold green"` | 此组件的样式。 |
+| `disabled` | `false` | Disables the `nodejs` module. |
### 示例
@@ -1006,12 +1042,12 @@ symbol = "🤖 "
## Package Version
-当前目录是软件包的代码仓库时,将显示 `package` 组件,并显示软件包当前版本。 The module currently supports `npm`, `cargo`, `poetry`, `composer`, `gradle`, `julia` and `mix` packages.
+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` and `mix` packages.
-- **npm** —— `npm` 软件包版本从当前目录下的 `package.json` 中得到
-- **cargo** —— `cargo` 软件包的版本从当前目录下的 `Cargo.toml` 中得到
-- **poetry** —— `poetry` 软件包版本从当前目录下的 `pyproject.toml` 中得到
-- **composer** —— `composer` 软件包版本从当前目录下的 `composer.json` 中得到
+- **npm** – The `npm` package version is extracted from the `package.json` present in the current directory
+- **cargo** – The `cargo` package version is extracted from the `Cargo.toml` present in the current directory
+- **poetry** – The `poetry` package version is extracted from the `pyproject.toml` present in the current directory
+- **composer** – The `composer` package version is extracted from the `composer.json` present in the current directory
- **gradle** – The `gradle` package version is extracted from the `build.gradle` present
- **julia** - The package version is extracted from the `Project.toml` present
- **mix** - The `mix` package version is extracted from the `mix.exs` present
@@ -1020,12 +1056,12 @@ symbol = "🤖 "
### 配置项
-| 字段 | 默认值 | 描述 |
-| ----------------- | ------------ | --------------------------------------------------------- |
-| `symbol` | `"📦 "` | 这个字段的内容会显示在当前软件包版本之前。 |
-| `style` | `"bold 208"` | 此组件的样式。 |
-| `display_private` | `false` | Enable displaying version for packages marked as private. |
-| `disabled` | `false` | 禁用 `package` 组件。 |
+| 字段 | 默认值 | 描述 |
+| ----------------- | ------------ | ---------------------------------------------------------- |
+| `symbol` | `"📦 "` | The symbol used before displaying the version the package. |
+| `style` | `"bold 208"` | 此组件的样式。 |
+| `display_private` | `false` | Enable displaying version for packages marked as private. |
+| `disabled` | `false` | Disables the `package` module. |
### 示例
@@ -1066,19 +1102,19 @@ symbol = "🐪 "
## PHP
-`php` 组件显示当前安装的 PHP 版本。 此组件将在符合以下任意条件时显示:
+The `php` module shows the currently installed version of PHP. 此组件将在符合以下任意条件之一时显示:
-- 当前目录包含一个 `composer.json` 文件
+- The current directory contains a `composer.json` file
- The current directory contains a `.php-version` file
-- 当前目录包含一个 `.php` 文件
+- The current directory contains a `.php` file
### 配置项
-| 字段 | 默认值 | 描述 |
-| ---------- | ------------ | ----------------------- |
-| `symbol` | `"🐘 "` | 这个字段的内容会显示在当前 PHP 版本之前。 |
-| `style` | `"bold 147"` | 此组件的样式。 |
-| `disabled` | `false` | 禁用 `php` 组件。 |
+| 字段 | 默认值 | 描述 |
+| ---------- | ------------ | ----------------------------------------------------- |
+| `symbol` | `"🐘 "` | The symbol used before displaying the version of PHP. |
+| `style` | `"bold 147"` | 此组件的样式。 |
+| `disabled` | `false` | Disables the `php` module. |
### 示例
@@ -1097,26 +1133,26 @@ If `pyenv_version_name` is set to `true`, it will display the pyenv version name
此组件将在符合以下任意条件之一时显示:
-- 当前目录包含 `.python-version` 文件
-- 当前目录包含 `requirements.txt` 文件
-- 当前目录包含 `pyproject.toml` 文件
+- The current directory contains a `.python-version` file
+- The current directory contains a `requirements.txt` file
+- The current directory contains a `pyproject.toml` file
- The current directory contains a file with the `.py` extension (and `scan_for_pyfiles` is true)
-- 当前目录包含 `Pipfile` 文件
-- 当前目录包含一个 `tox.ini` 文件
-- 当前目录包含一个 `setup.py` 文件
+- The current directory contains a `Pipfile` file
+- The current directory contains a `tox.ini` file
+- The current directory contains a `setup.py` file
- The current directory contains a `__init__.py` file
-- 当前处于一个活跃的 python 虚拟环境中
+- A virtual environment is currently activated
### 配置项
-| 字段 | 默认值 | 描述 |
-| -------------------- | --------------- | -------------------------------------------------------------------------- |
-| `symbol` | `"🐍 "` | 这个字段的内容会显示在当前 Python 版本之前。 |
-| `pyenv_version_name` | `false` | 使用 pyenv 获取 Python 版本 |
-| `pyenv_prefix` | `"pyenv "` | 在 pyenv 版本前显示的前缀(默认显示 `pyenv MY_VERSION`) |
-| `scan_for_pyfiles` | `true` | If false, Python files in the current directory will not show this module. |
-| `style` | `"bold yellow"` | 此组件的样式。 |
-| `disabled` | `false` | 禁用 `python` 组件。 |
+| 字段 | 默认值 | 描述 |
+| -------------------- | --------------- | --------------------------------------------------------------------------- |
+| `symbol` | `"🐍 "` | The symbol used before displaying the version of Python. |
+| `pyenv_version_name` | `false` | Use pyenv to get Python version |
+| `pyenv_prefix` | `"pyenv "` | Prefix before pyenv version display (default display is `pyenv MY_VERSION`) |
+| `scan_for_pyfiles` | `true` | If false, Python files in the current directory will not show this module. |
+| `style` | `"bold yellow"` | 此组件的样式。 |
+| `disabled` | `false` | Disables the `python` module. |
### 示例
@@ -1131,11 +1167,11 @@ pyenv_prefix = "foo "
## Ruby
-`ruby` 组件显示当前安装的 Ruby 版本。 此组件将在符合以下任意条件之一时显示:
+The `ruby` module shows the currently installed version of Ruby. 此组件将在符合以下任意条件之一时显示:
-- 当前目录包含 `Gemfile` 文件
+- The current directory contains a `Gemfile` file
- The current directory contains a `.ruby-version` file
-- 当前目录包含 `.rb` 文件
+- The current directory contains a `.rb` file
### 配置项
@@ -1143,7 +1179,7 @@ pyenv_prefix = "foo "
| ---------- | ------------ | ------------------------------------------------------ |
| `symbol` | `"💎 "` | The symbol used before displaying the version of Ruby. |
| `style` | `"bold red"` | 此组件的样式。 |
-| `disabled` | `false` | 禁用 `ruby` 组件。 |
+| `disabled` | `false` | Disables the `ruby` module. |
### 示例
@@ -1156,18 +1192,18 @@ symbol = "🔺 "
## Rust
-`rust` 组件显示当前安装的 Rust 版本。 此组件将在符合以下任意条件之一时显示:
+The `rust` module shows the currently installed version of Rust. 此组件将在符合以下任意条件之一时显示:
-- 当前目录包含 `Cargo.toml` 文件
-- 当前目录包含一个使用 `.rs` 扩展名的文件
+- The current directory contains a `Cargo.toml` file
+- The current directory contains a file with the `.rs` extension
### 配置项
-| 字段 | 默认值 | 描述 |
-| ---------- | ------------ | ------------------------ |
-| `symbol` | `"🦀 "` | 这个字段的内容会显示在当前 Rust 版本之前。 |
-| `style` | `"bold red"` | 此组件的样式。 |
-| `disabled` | `false` | 禁用 `rust` 组件。 |
+| 字段 | 默认值 | 描述 |
+| ---------- | ------------ | ------------------------------------------------------ |
+| `symbol` | `"🦀 "` | The symbol used before displaying the version of Rust. |
+| `style` | `"bold red"` | 此组件的样式。 |
+| `disabled` | `false` | Disables the `rust` module. |
### 示例
@@ -1204,19 +1240,19 @@ symbol = "📦 "
## Terraform
-`terraform` 组件显示当前选定的 terraform 工作区和版本。 默认情况下不会显示 terraform 版本,因为当使用大量插件时,当前版本 terraform 查询版本号很慢。 此组件将在符合以下任意条件之一时显示:
+The `terraform` module shows the currently selected terraform workspace and version. By default the terraform version is not shown, since this is slow on current versions of terraform when a lot of plugins are in use. 此组件将在符合以下任意条件之一时显示:
-- 当前目录包含 `.terraform` 目录
-- 当前目录包含一个使用 `.tf` 扩展名的文件
+- The current directory contains a `.terraform` folder
+- Current directory contains a file with the `.tf` extension
### 配置项
-| 字段 | 默认值 | 描述 |
-| -------------- | ------------ | -------------------------------- |
-| `symbol` | `"💠 "` | 这个字段的内容会显示在当前 terraform 工作区之前。 |
-| `show_version` | `false` | 显示 terraform 版本信息。 在大型工作空间中非常缓慢。 |
-| `style` | `"bold 105"` | 此组件的样式。 |
-| `disabled` | `false` | 禁用 `terraform` 组件。 |
+| 字段 | 默认值 | 描述 |
+| -------------- | ------------ | ----------------------------------------------------------- |
+| `symbol` | `"💠 "` | The symbol used before displaying the terraform workspace. |
+| `show_version` | `false` | Shows the terraform version. Very slow on large workspaces. |
+| `style` | `"bold 105"` | 此组件的样式。 |
+| `disabled` | `false` | Disables the `terraform` module. |
### 示例
@@ -1229,25 +1265,26 @@ symbol = "🏎💨 "
## Time
-`time` 组件显示当前的 **本地** 时间。 `format` 字段值会提供给 [`chrono`](https://crates.io/crates/chrono) crate 用来控制时间显示方式。 请参阅 [chrono strftime 文档](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) 以了解可用格式选项。
+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
-此组件默认被禁用。 若要启用此组件,请在配置文件中设置 `disable` 字段为 `false`。
+This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
:::
### 配置项
-| 字段 | 默认值 | 描述 |
-| ----------------- | --------------- | ----------------------------------------------------------------------------------------- |
-| `use_12hr` | `false` | 启用 12 小时格式 |
-| `format` | 见下文解释 | 用来格式化时间显示的 [chrono 格式字符串](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) |
-| `style` | `"bold yellow"` | 显示时间的样式。 |
-| `utc_time_offset` | `"local"` | 设置所用 UTC 偏移量。 范围是 -24 < x < 24。 允许使用浮点数来得到 30/45 分钟的时区偏移。 |
-| `disabled` | `true` | 禁用 `time` 组件。 |
+| 字段 | 默认值 | 描述 |
+| ----------------- | --------------- | ------------------------------------------------------------------------------------------------------------------- |
+| `use_12hr` | `false` | Enables 12 hour formatting. |
+| `format` | see below | The [chrono format string](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) used to format the time. |
+| `style` | `"bold yellow"` | The style for the module time. |
+| `utc_time_offset` | `"local"` | Sets the UTC offset to use. Range from -24 < x < 24. Allows floats to accommodate 30/45 minute timezone offsets. |
+| `disabled` | `true` | Disables the `time` module. |
+| `time_range` | `"-"` | Sets the time range during which the module will be shown. Times must be specified in 24-hours format |
-如果 `use_12hr` 为 `true`,则`format` 默认值为 `"%r"`。 否则,其默认值为 `"%T"`。 手动设置 `format` 将使 `use_12hr` 被忽略。
+If `use_12hr` is `true`, then `format` defaults to `"%r"`. Otherwise, it defaults to `"%T"`. Manually setting `format` will override the `use_12hr` setting.
### 示例
@@ -1258,25 +1295,26 @@ symbol = "🏎💨 "
disabled = false
format = "🕙[ %T ]"
utc_time_offset = "-5"
+time_range = "10:00:00-14:00:00"
```
## Username
-`username` 组件显示当前活跃的用户名。 此组件将在符合以下任意条件之一时显示:
+The `username` module shows active user's username. 此组件将在符合以下任意条件之一时显示:
-- 当前用户是 root
-- 当前用户与登录用户不相同
-- 用户正通过 SSH 会话连接访问
-- 字段 `show_always` 被设置为 true
+- The current user is root
+- The current user isn't the same as the one that is logged in
+- The user is currently connected as an SSH session
+- The variable `show_always` is set to true
### 配置项
-| 字段 | 默认值 | 描述 |
-| ------------- | --------------- | ------------------- |
-| `style_root` | `"bold red"` | 当前用户为 root 时使用的样式。 |
-| `style_user` | `"bold yellow"` | 非 root 用户使用的样式。 |
-| `show_always` | `false` | 总是显示 `username` 组件。 |
-| `disabled` | `false` | 禁用 `username` 组件。 |
+| 字段 | 默认值 | 描述 |
+| ------------- | --------------- | ------------------------------------- |
+| `style_root` | `"bold red"` | The style used when the user is root. |
+| `style_user` | `"bold yellow"` | The style used for non-root users. |
+| `show_always` | `false` | Always shows the `username` module. |
+| `disabled` | `false` | Disables the `username` module. |
### 示例
@@ -1339,8 +1377,8 @@ The order in which custom modules are shown can be individually set by setting `
| ------------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `command` | | The command whose output should be printed. |
| `when` | | A shell command used as a condition to show the module. The module will be shown if the command returns a `0` status code. |
-| `shell` | | The path to the shell to use to execute the command. If unset, it will fallback to STARSHIP_SHELL and then to "sh". |
-| `描述` | `"這個模組有些進階設定選項可以控制顯示資料夾。
-| 變數 | 預設 | 說明 |
-| --------------------------- | ------ | ------------------------------------ |
-| `fish_style_pwd_dir_length` | `0` | 當使用 fish shell 的 pwd 路徑邏輯時使用的字元數量。 |
-| `use_logical_path` | `true` | 顯示 shell (`PWD`) 提供的邏輯路徑,而不是 OS 的路徑。 |
+| 變數 | 預設 | 說明 |
+| --------------------------- | ------ | ---------------------------------------------------------------------------------------- |
+| `substitutions` | | A table of substitutions to be made to the path. |
+| `fish_style_pwd_dir_length` | `0` | The number of characters to use when applying fish shell pwd path logic. |
+| `use_logical_path` | `true` | Displays the logical path provided by the shell (`PWD`) instead of the path from the OS. |
+
+`substitutions` allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories (i.e. Java). Note that this will disable the fish style PWD.
+
+```toml
+[directory.substitutions]
+"/Volumes/network/path" = "/net"
+"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`.
@@ -416,11 +426,11 @@ symbol = "🐋 "
## Dotnet
-`dotnet` 模組顯示現在資料夾使用的 .NET Core SDK 的版本。 如果這個資料夾已經選定一個 SDK,則顯示這個 SDK 的版本。 如果沒有的話,則顯示最新安裝的 SDK 版本。
+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.
-這個模組只會在下列檔案出現在你的現在資料夾中時,顯示在你的提示字元:`global.json`、`project.json`、`*.sln`、`*.csproj`、`*.fsproj`、`*.xproj`。 你也會需要安裝 .NET Core 文字命令工具來正確使用這個模組。
+This module will only be shown in your prompt when one of the following files are present in the current directory: `global.json`, `project.json`, `*.sln`, `*.csproj`, `*.fsproj`, `*.xproj`. You'll also need the .NET Core command-line tools installed in order to use it correctly.
-這個模組內部是使用它自己的機制來偵測版本。 一般來說這個模組有 `dotnet --version` 的兩倍快,但是它可能會在你的 .NET 專案有不尋常的資料夾結構時顯示不正確的版本。 如果精確度比速度更重要的話,你可以藉由設定模組中的 `heuristic = false` 選項來停用這個功能。
+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.
### 選項
@@ -495,7 +505,7 @@ symbol = " "
## 環境變數
-`env_var`模組顯示一個選擇的環境變數的現在數值。 這個模組只在下列條件其中之一達到時顯示:
+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:
- `variable` 設定選項符合一個存在的環境變數。
- 沒有設定 `variable` 選項,但是有設定 `default` 選項。
@@ -548,7 +558,7 @@ symbol = "e "
## Git 分支
-`git_branch` 模組顯示現在的資料夾中使用中的儲存庫的分支。
+The `git_branch` module shows the active branch of the repo in your current directory.
### 選項
@@ -597,7 +607,7 @@ commit_hash_length = 4
## Git State
-`git_state` 模組會顯示在 git 儲存庫中的資料夾內,以及會在有作業正在進行時顯示,像是:_REBASING_、_BISECTING_ 等等。 如果有進展的資訊 (像是 REBASING 3/10),也會一併顯示出來。
+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.
### 選項
@@ -626,7 +636,7 @@ cherry_pick = "🍒 PICKING"
## Git Status
-`git_status` 模組顯示用來表示現在資料夾之中儲存庫狀態的符號。
+The `git_status` module shows symbols representing the state of the repo in your current directory.
### 選項
@@ -685,7 +695,7 @@ deleted = "🗑"
## Golang
-`golang` 模組顯示現在安裝的 Golang 版本。 這個模組在下列其中一個條件達成時顯示:
+The `golang` module shows the currently installed version of Golang. 這個模組在下列其中一個條件達成時顯示:
- 現在資料夾中含有一個 `go.mod` 檔案
- 現在資料夾中含有一個 `go.sum` 檔案
@@ -738,7 +748,7 @@ symbol = " "
## 主機名稱
-`hostname` 模組顯示系統的主機名稱。
+The `hostname` module shows the system hostname.
### 選項
@@ -766,7 +776,7 @@ disabled = false
## Java
-`java` 模組顯示現在安裝的 Java 版本。 這個模組在下列其中一個條件達成時顯示:
+The `java` module shows the currently installed version of Java. 這個模組在下列其中一個條件達成時顯示:
- The current directory contains a `pom.xml`, `build.gradle.kts`, `build.sbt` or `.java-version` file
- The current directory contains a file with the `.java`, `.class`, `.gradle` or `.jar` extension
@@ -790,7 +800,7 @@ symbol = "🌟 "
## 工作
-`jobs` 模組顯示現在正在執行中的工作。 這個模組只會在有背景工作正在執行時顯示。 這個模組會在工作數量超過一個,或者有設定 `threshold` 時且數量超過設定值時,顯示工作的數量。
+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.
### 選項
@@ -837,11 +847,11 @@ symbol = "∴ "
```
## Kubernetes
-顯示現在 Kubernetes 主體名稱以及從 kubeconfig 檔案來的名稱空間 (如果有設定的話)。 The namespace needs to be set in the kubeconfig file, this can be done via `kubectl config set-context starship-cluster --namespace astronaut`. 如果有設定 `$KUBECONFIG` 環境變數,這個模組就會使用設定值;如果沒有,它就會使用 `~/.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
-這個模組預設是停用的。 想要啟用它的話,請在設定檔中將 `disabled` 設定為 `false`。
+This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
:::
@@ -869,7 +879,7 @@ disabled = false
## 換行
-`line_break` 模組將提示字元分成兩行。
+The `line_break` module separates the prompt into two lines.
### 選項
@@ -888,13 +898,13 @@ disabled = true
## 記憶體使用量
-`memory_usage` 模組顯示現在系統記憶體與 swap 的使用量。
+The `memory_usage` module shows current system memory and swap usage.
-預設 swap 使用量會在系統總 swap 使用量不為 0 時顯示出來。
+By default the swap usage is displayed if the total system swap is non-zero.
::: tip
-這個模組預設是停用的。 想要啟用它的話,請在設定檔中將 `disabled` 設定為 `false`。
+This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
:::
@@ -950,20 +960,46 @@ truncation_length = 4
truncation_symbol = ""
```
+## Nim
+
+The `nim` module shows the currently installed version of Nim. 這個模組在下列其中一個條件達成時顯示:
+- The current directory contains a `nim.cfg` file
+- The current directory contains a file with the `.nim` extension
+- The current directory contains a file with the `.nims` extension
+- The current directory contains a file with the `.nimble` extension
+
+### 選項
+
+| 變數 | 預設 | 說明 |
+| ---------- | --------------- | ----------------------------------------------------- |
+| `symbol` | `"👑 "` | The symbol used before displaying the version of Nim. |
+| `style` | `"bold yellow"` | 這個模組的風格。 |
+| `disabled` | `false` | Disables the `nim` module. |
+
+### 範例
+
+```toml
+# ~/.config/starship.toml
+
+[nim]
+style = "yellow"
+symbol = "🎣 "
+```
+
## Nix-shell
-`nix_shell` 模組顯示 nix-shell 環境。 這個模組會在 nix-shell 環境中顯示。
+The `nix_shell` module shows the nix-shell environment. The module will be shown when inside a nix-shell environment.
### 選項
| 變數 | 預設 | 說明 |
| ------------ | ------------- | ------------------------------------------------- |
-| `use_name` | `false` | 顯示 nix-shell 的名稱。 |
-| `impure_msg` | `"impure"` | 自定義「impure」訊息。 |
-| `pure_msg` | `"pure"` | 自定義「pure」訊息。 |
+| `use_name` | `false` | Display the name of the nix-shell. |
+| `impure_msg` | `"impure"` | Customize the "impure" msg. |
+| `pure_msg` | `"pure"` | Customize the "pure" msg. |
| `symbol` | `"❄️ "` | The symbol used before displaying the shell name. |
| `style` | `"bold blue"` | 這個模組的風格。 |
-| `disabled` | `false` | 停用 `nix_shell` 模組。 |
+| `disabled` | `false` | Disables the `nix_shell` module. |
### 範例
@@ -980,20 +1016,20 @@ symbol = "☃️ "
## NodeJS
-`nodejs` 模組顯示現在安裝的 NodeJS 版本。 這個模組在下列其中一個條件達成時顯示:
+The `nodejs` module shows the currently installed version of NodeJS. 這個模組在下列其中一個條件達成時顯示:
-- 現在資料夾中包含一個 `package.json` 檔案
+- The current directory contains a `package.json` file
- The current directory contains a `.node-version` file
-- 現在資料夾中包含一個 `node_modules` 資料夾
-- 現在資料夾中包含一個檔案具有 `.js` 副檔名
+- The current directory contains a `node_modules` directory
+- The current directory contains a file with the `.js` extension
### 選項
-| 變數 | 預設 | 說明 |
-| ---------- | -------------- | -------------------- |
-| `symbol` | `"⬢ "` | 在顯示 NodeJS 版本之前用的符號。 |
-| `style` | `"bold green"` | 這個模組的風格。 |
-| `disabled` | `false` | 停用 `nodejs` 模組。 |
+| 變數 | 預設 | 說明 |
+| ---------- | -------------- | -------------------------------------------------------- |
+| `symbol` | `"⬢ "` | The symbol used before displaying the version of NodeJS. |
+| `style` | `"bold green"` | 這個模組的風格。 |
+| `disabled` | `false` | Disables the `nodejs` module. |
### 範例
@@ -1004,13 +1040,13 @@ symbol = "☃️ "
symbol = "🤖 "
```
-## 套件版本
+## Package Version
-The `package` 模組在現在資料夾是一個套件的儲藏庫時出現,並顯示他的現在版本。 The module currently supports `npm`, `cargo`, `poetry`, `composer`, `gradle`, `julia` and `mix` packages.
+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` and `mix` packages.
-- **npm** – `npm` 套件的版本是從現在資料夾中的 `package.json` 之中擷取出來的
-- **cargo** – `cargo` 套件的版本是從現在資料夾中的 `Cargo.toml` 之中擷取出來的
-- **poetry** – `poetry` 套件的版本是從現在資料夾中的 `pyproject.toml` 之中擷取出來的
+- **npm** – The `npm` package version is extracted from the `package.json` present in the current directory
+- **cargo** – The `cargo` package version is extracted from the `Cargo.toml` present in the current directory
+- **poetry** – The `poetry` package version is extracted from the `pyproject.toml` present in the current directory
- **composer** – The `composer` package version is extracted from the `composer.json` present in the current directory
- **gradle** – The `gradle` package version is extracted from the `build.gradle` present
- **julia** - The package version is extracted from the `Project.toml` present
@@ -1020,12 +1056,12 @@ The `package` 模組在現在資料夾是一個套件的儲藏庫時出現,並
### 選項
-| 變數 | 預設 | 說明 |
-| ----------------- | ------------ | --------------------------------------------------------- |
-| `symbol` | `"📦 "` | 顯示在套件的版本之前的符號。 |
-| `style` | `"bold 208"` | 這個模組的風格。 |
-| `display_private` | `false` | Enable displaying version for packages marked as private. |
-| `disabled` | `false` | 停用 `package` 模組。 |
+| 變數 | 預設 | 說明 |
+| ----------------- | ------------ | ---------------------------------------------------------- |
+| `symbol` | `"📦 "` | The symbol used before displaying the version the package. |
+| `style` | `"bold 208"` | 這個模組的風格。 |
+| `display_private` | `false` | Enable displaying version for packages marked as private. |
+| `disabled` | `false` | Disables the `package` module. |
### 範例
@@ -1068,7 +1104,7 @@ symbol = "🐪 "
The `php` module shows the currently installed version of PHP. 這個模組在下列其中一個條件達成時顯示:
-- 現在資料夾中包含一個 `composer.json` 檔案
+- The current directory contains a `composer.json` file
- The current directory contains a `.php-version` file
- The current directory contains a `.php` file
@@ -1097,26 +1133,26 @@ If `pyenv_version_name` is set to `true`, it will display the pyenv version name
這個模組在下列其中一個條件達成時顯示:
-- 目前資料夾中有一個 `.python-version` 檔案
-- 目前資料夾中有一個 `requirements.txt` 檔案
-- 目前資料夾中有一個 `pyproject.toml` 檔案
+- The current directory contains a `.python-version` file
+- The current directory contains a `requirements.txt` file
+- The current directory contains a `pyproject.toml` file
- The current directory contains a file with the `.py` extension (and `scan_for_pyfiles` is true)
-- 目前資料夾中有一個 `Pipfile` 檔案
-- 目前資料夾中有一個 `tox.ini` 檔案
-- 現在資料夾中包含一個 `setup.py` 檔案
+- The current directory contains a `Pipfile` file
+- The current directory contains a `tox.ini` file
+- The current directory contains a `setup.py` file
- The current directory contains a `__init__.py` file
- A virtual environment is currently activated
### 選項
-| 變數 | 預設 | 說明 |
-| -------------------- | --------------- | -------------------------------------------------------------------------- |
-| `symbol` | `"🐍 "` | 顯示在 Python 版本之前的符號。 |
-| `pyenv_version_name` | `false` | 使用 pyenv 取得 Python 的版本。 |
-| `pyenv_prefix` | `"pyenv "` | 顯示在 pyenv 版本之前的前綴 (預設顯示是 `pyenv MY_VERSION`)。 |
-| `scan_for_pyfiles` | `true` | If false, Python files in the current directory will not show this module. |
-| `style` | `"bold yellow"` | 這個模組的風格。 |
-| `disabled` | `false` | 停用 `python` 模組。 |
+| 變數 | 預設 | 說明 |
+| -------------------- | --------------- | --------------------------------------------------------------------------- |
+| `symbol` | `"🐍 "` | The symbol used before displaying the version of Python. |
+| `pyenv_version_name` | `false` | Use pyenv to get Python version |
+| `pyenv_prefix` | `"pyenv "` | Prefix before pyenv version display (default display is `pyenv MY_VERSION`) |
+| `scan_for_pyfiles` | `true` | If false, Python files in the current directory will not show this module. |
+| `style` | `"bold yellow"` | 這個模組的風格。 |
+| `disabled` | `false` | Disables the `python` module. |
### 範例
@@ -1131,19 +1167,19 @@ pyenv_prefix = "foo "
## Ruby
-`ruby` 模組顯示現在安裝的 Ruby 版本。 這個模組在下列其中一個條件達成時顯示:
+The `ruby` module shows the currently installed version of Ruby. 這個模組在下列其中一個條件達成時顯示:
-- 目前資料夾中有一個 `Gemfile` 檔案
+- The current directory contains a `Gemfile` file
- The current directory contains a `.ruby-version` file
-- 目前資料夾中有一個 `.rb` 檔案
+- The current directory contains a `.rb` file
### 選項
-| 變數 | 預設 | 說明 |
-| ---------- | ------------ | ----------------- |
-| `symbol` | `"💎 "` | 顯示在 Ruby 版本之前的符號。 |
-| `style` | `"bold red"` | 這個模組的風格。 |
-| `disabled` | `false` | 停用 `ruby` 模組。 |
+| 變數 | 預設 | 說明 |
+| ---------- | ------------ | ------------------------------------------------------ |
+| `symbol` | `"💎 "` | The symbol used before displaying the version of Ruby. |
+| `style` | `"bold red"` | 這個模組的風格。 |
+| `disabled` | `false` | Disables the `ruby` module. |
### 範例
@@ -1156,18 +1192,18 @@ symbol = "🔺 "
## Rust
-`rust` 模組顯示現在安裝的 Rust 版本。 這個模組在下列其中一個條件達成時顯示:
+The `rust` module shows the currently installed version of Rust. 這個模組在下列其中一個條件達成時顯示:
-- 目前資料夾中有一個 `Cargo.toml` 檔案
-- 現在資料夾中包含一個檔案具有 `.rs` 副檔名
+- The current directory contains a `Cargo.toml` file
+- The current directory contains a file with the `.rs` extension
### 選項
-| 變數 | 預設 | 說明 |
-| ---------- | ------------ | ----------------- |
-| `symbol` | `"🦀 "` | 顯示在 Rust 版本之前的符號。 |
-| `style` | `"bold red"` | 這個模組的風格。 |
-| `disabled` | `false` | 停用 `rust` 模組。 |
+| 變數 | 預設 | 說明 |
+| ---------- | ------------ | ------------------------------------------------------ |
+| `symbol` | `"🦀 "` | The symbol used before displaying the version of Rust. |
+| `style` | `"bold red"` | 這個模組的風格。 |
+| `disabled` | `false` | Disables the `rust` module. |
### 範例
@@ -1227,27 +1263,28 @@ The `terraform` module shows the currently selected terraform workspace and vers
symbol = "🏎💨 "
```
-## 時間
+## Time
-`time` 模組顯示目前的**當地**時間. `format` 設定值被 [`chrono`](https://crates.io/crates/chrono) crate 用來控制時間如何顯示。 請看 [chrono 的 strftime 文件](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html)來了解有那些選項可以使用。
+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
-這個模組預設是停用的。 想要啟用它的話,請在設定檔中將 `disabled` 設定為 `false`。
+This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
:::
### 選項
-| 變數 | 預設 | 說明 |
-| ----------------- | --------------- | -------------------------------------------------------------------------------------- |
-| `use_12hr` | `false` | 啟用 12 小時格式。 |
-| `format` | 請看下列 | 用來顯示時間的 [chrono 格式字串](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html)。 |
-| `style` | `"bold yellow"` | 這個模組的時間的風格。 |
-| `utc_time_offset` | `"local"` | 設定相對於 UTC 的時差。 範圍 -24 < x < 24。 允許使用浮點數來表示 30/45 分鐘時差的時區。 |
-| `disabled` | `true` | 停用 `time` 模組。 |
+| 變數 | 預設 | 說明 |
+| ----------------- | --------------- | ------------------------------------------------------------------------------------------------------------------- |
+| `use_12hr` | `false` | Enables 12 hour formatting. |
+| `format` | see below | The [chrono format string](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) used to format the time. |
+| `style` | `"bold yellow"` | The style for the module time. |
+| `utc_time_offset` | `"local"` | Sets the UTC offset to use. Range from -24 < x < 24. Allows floats to accommodate 30/45 minute timezone offsets. |
+| `disabled` | `true` | Disables the `time` module. |
+| `time_range` | `"-"` | Sets the time range during which the module will be shown. Times must be specified in 24-hours format |
-如果 `use_12hr` 是 `true` 的話,`format` 會被預設為 `"%r"`。 不然的話,它會被預設為 `"%T"`。 手動設定 `format` 的設定值會覆寫 `use_12hr` 的設定。
+If `use_12hr` is `true`, then `format` defaults to `"%r"`. Otherwise, it defaults to `"%T"`. Manually setting `format` will override the `use_12hr` setting.
### 範例
@@ -1258,25 +1295,26 @@ symbol = "🏎💨 "
disabled = false
format = "🕙[ %T ]"
utc_time_offset = "-5"
+time_range = "10:00:00-14:00:00"
```
-## 使用者名稱
+## Username
-`username` 模組顯示現在使用中的使用者名稱。 這個模組在下列其中一個條件達成時顯示:
+The `username` module shows active user's username. 這個模組在下列其中一個條件達成時顯示:
-- 目前使用者為 root
-- 目前使用者並非登入時的使用者
-- 使用者透過 SSH session 進行連線
-- 變數 `show_always` 被設為 true
+- The current user is root
+- The current user isn't the same as the one that is logged in
+- The user is currently connected as an SSH session
+- The variable `show_always` is set to true
### 選項
-| 變數 | 預設 | 說明 |
-| ------------- | --------------- | ------------------- |
-| `style_root` | `"bold red"` | 使用者為 root 時使用的風格。 |
-| `style_user` | `"bold yellow"` | 非 root 使用者時使用的風格。 |
-| `show_always` | `false` | 總是顯示 `username` 模組。 |
-| `disabled` | `false` | 停用 `username` 模組。 |
+| 變數 | 預設 | 說明 |
+| ------------- | --------------- | ------------------------------------- |
+| `style_root` | `"bold red"` | The style used when the user is root. |
+| `style_user` | `"bold yellow"` | The style used for non-root users. |
+| `show_always` | `false` | Always shows the `username` module. |
+| `disabled` | `false` | Disables the `username` module. |
### 範例
@@ -1339,8 +1377,8 @@ The order in which custom modules are shown can be individually set by setting `
| ------------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `command` | | The command whose output should be printed. |
| `when` | | A shell command used as a condition to show the module. The module will be shown if the command returns a `0` status code. |
-| `shell` | | The path to the shell to use to execute the command. If unset, it will fallback to STARSHIP_SHELL and then to "sh". |
-| `說明` | `"