-
+
diff --git a/docs/fr-FR/config/README.md b/docs/fr-FR/config/README.md
index 2d41980b..d1340577 100644
--- a/docs/fr-FR/config/README.md
+++ b/docs/fr-FR/config/README.md
@@ -98,9 +98,11 @@ prompt_order = [
"golang",
"java",
"nodejs",
+ "php",
"python",
"ruby",
"rust",
+ "terraform",
"nix_shell",
"conda",
"memory_usage",
@@ -272,15 +274,22 @@ prefix = "underwent "
## Conda
-The `conda` module shows the current conda environment, if `$CONDA_DEFAULT_ENV` is set. Note: This does not suppress conda's own prompt modifier, you may want to run `conda config --set changeps1 False`
+The `conda` module shows the current conda environment, if `$CONDA_DEFAULT_ENV` is set.
+
+::: tip
+
+This does not suppress conda's own prompt modifier, you may want to run `conda config --set changeps1 False`.
+
+:::
### Options
-| Variable | Default | Description |
-| ---------- | -------------- | -------------------------------------------- |
-| `symbol` | `"C "` | The symbol used before the environment name. |
-| `style` | `"bold green"` | The style for the module. |
-| `disabled` | `false` | Disables the `conda` module. |
+| Variable | Default | Description |
+| ------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `truncation_length` | `1` | The number of directories the environment path should be truncated to, if the environment was created via `conda create -p [path]`. `0` means no truncation. Also see the [`directory`](#directory) module. |
+| `symbol` | `"C "` | The symbol used before the environment name. |
+| `style` | `"bold green"` | The style for the module. |
+| `disabled` | `false` | Disables the `conda` module. |
### Example
@@ -414,7 +423,7 @@ truncation_symbol = ""
The `git_commit` module shows the active branch of the repo in your current directory.
-::: remarque
+::: tip
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
@@ -425,8 +434,8 @@ This module is disabled by default. To enable it, set `disabled` to `false` in y
| Variable | Default | Description |
| -------------------- | -------------- | ------------------------------------------------ |
| `commit_hash_length` | `7` | The length of the displayed git commit hash. |
-| `prefix` | `(` | Prefix to display immediately before git commit. |
-| `suffix` | `)` | Suffix to display immediately after git commit. |
+| `prefix` | `"("` | Prefix to display immediately before git commit. |
+| `suffix` | `")"` | Suffix to display immediately after git commit. |
| `style` | `"bold green"` | The style for the module. |
| `disabled` | `true` | Disables the `git_commit` module. |
@@ -636,7 +645,7 @@ threshold = 4
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`.
-::: remarque
+::: tip
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
@@ -712,7 +721,7 @@ 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.
-::: remarque
+::: tip
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
@@ -800,6 +809,7 @@ The `package` module is shown when the current directory is the repository for a
- **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
> ⚠️ The version being shown is that of the package whose source code is in your current directory, not your package manager.
@@ -931,11 +941,36 @@ The `rust` module shows the currently installed version of Rust. The module will
symbol = "⚙️ "
```
+## 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. The module will be shown if any of the following conditions are met:
+
+- The current directory contains a `.terraform` folder
+- Current directory contains a file with the `.tf` extension
+
+### Options
+
+| Variable | Default | Description |
+| -------------- | ------------ | ----------------------------------------------------------- |
+| `symbol` | `"💠 "` | The symbol used before displaying the terraform workspace. |
+| `show_version` | `false` | Shows the terraform version. Very slow on large workspaces. |
+| `style` | `"bold 105"` | The style for the module. |
+| `disabled` | `false` | Disables the `terraform` module. |
+
+### Example
+
+```toml
+# ~/.config/starship.toml
+
+[terraform]
+symbol = "🏎💨 "
+```
+
## 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.
-::: remarque
+::: tip
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
diff --git a/docs/fr-FR/guide/README.md b/docs/fr-FR/guide/README.md
index d730530e..267bccf3 100644
--- a/docs/fr-FR/guide/README.md
+++ b/docs/fr-FR/guide/README.md
@@ -2,25 +2,27 @@
+ alt="Starship – Shell prompt multiplatformes" />
+ alt="GitHub Actions état du workflow" />
+ >
-
+ alt="Discuter sur Discord" />
+
+
+
@@ -56,11 +58,11 @@
-
Starship is the minimal, blazing fast, and extremely customizable prompt for any shell! The prompt shows information you need while you're working, while staying sleek and out of the way.
+
Starship est un environnement minimal, extrêmement rapide et extrêmement personnalisable pour n'importe quelle terminale shell! Le prompt affiche les informations dont vous avez besoin pendant que vous travaillez, tout en restant élégant et hors du chemin.
-
+
@@ -71,15 +73,16 @@
- Version actuelle de Go (`🐹`)
- Version actuelle de Java (`☕`)
- Version actuelle de Node.js (`⬢`)
-- Current PHP version (`🐘`)
+- Version actuelle de PHP (`🐘`)
- Version actuelle de Python (`🐍`)
- Version actuelle de Ruby (`💎`)
- Version actuelle de Rust (`🦀`)
-- Current .NET version (`•NET`)
+- Version actuelle de .NET (`•NET`)
- Version actuelle du paquet dans le répertoire courant (`📦`)
- npm (Node.js)
- cargo (Rust)
- poetry (Python)
+ - compositeur (PHP)
- Branche Git actuelle et affichage "riche" du statut du dépôt:
- `=` — Conflits dans les changements
- `⇡` — En avance sur la branche distante
@@ -91,19 +94,19 @@
- `+` — Fichiers ajoutés
- `»` — Fichiers renommés
- `✘` — Fichiers supprimés
-- Current Mercurial branch
+- Branche Mercurial actuelle
- Niveau et état actuels de la batterie
-- `⇡` – charging
-- `⇣` – discharging
-- `•` – fully charged
+- `⇡` – en charge
+- `⇣` – en décharge
+- `•` – entièrement chargé
- Indicateur pour les tâches en arrière-plan (`✦`)
- Cluster et namespace Kubernetes actuels (`☸`)
-- Current Amazon Web Services (AWS) profile (`☁️`)
-- Execution time of the last command
-- Custom environment variable value
+- Profil actuel d'Amazon Web Services/AWS (`☁️`)
+- Temps d'exécution de la dernière commande
+- Valeur des clés d'environnement personnalisée
- Détection de l'environnement Nix-shell
- Affiche le nom de l'utilisateur courant s'il est différent de celui connecté
-- Optional current time in 12/24hr format
+- L'heure courante au format 12/24h (optionel)
## 🚀 Installation
@@ -111,43 +114,43 @@
- Une [police d'écriture Powerline](https://github.com/powerline/fonts) installée et activée dans votre terminal (Par exemple, essayez [Fira Code](https://github.com/tonsky/FiraCode)).
-### Getting Started
+### Démarrage rapide
1. Installer le binaire **starship** :
- #### Install Latest Version
+ #### Installer la dernière version
- ##### With Shell:
+ ##### Avec Shell:
```sh
- curl -fsSL https://starship.rs/install.sh | sh
+ curl -fsSL https://starship.rs/install.sh | bash
```
- #### Install via Package Manager
+ #### Installer via le gestionnaire de paquets
- ##### With [Homebrew](https://brew.sh/):
+ ##### Avec [Homebrew](https://brew.sh/):
```sh
brew install starship
```
- ##### With [Scoop](https://scoop.sh):
+ ##### Avec [Scoop](https://scoop.sh):
```powershell
scoop install starship
```
-1. Add the init script to your shell's config file:
+1. Ajouter le script d'initialization à la fiche config de votre shell:
#### Bash
- Add the following to the end of `~/.bashrc`:
+ Ajouter ce qui suit à la fin de `~/.bashrc`:
```sh
# ~/.bashrc
@@ -158,7 +161,7 @@
#### Fish
- Add the following to the end of `~/.config/fish/config.fish`:
+ Ajoute ce qui suit à la fin de `~/.config/fish/config.fish`:
```sh
# ~/.config/fish/config.fish
@@ -169,7 +172,7 @@
#### Zsh
- Add the following to the end of `~/.zshrc`:
+ Ajouter ce qui suit à la fin de `~/.zshrc`:
```sh
# ~/.zshrc
@@ -180,110 +183,126 @@
#### Powershell
- Add the following to the end of `~\Documents\PowerShell\Microsoft.PowerShell_profile.ps1` (or `~/.config/powershell/Microsoft.PowerShell_profile.ps1` on -Nix):
+ Ajouter ce qui suit à la fin de `~\Documents\PowerShell\Microsoft.PowerShell_profile.ps1` (ou `~/.config/powershell/Microsoft.PowerShell_profile.ps1` sur -Nix):
```sh
# ~\Documents\PowerShell\Profile.ps1
Invoke-Expression (&starship init powershell)
```
+
+ #### Ion
+
+ Ajouter ce qui suit à la fin de `~/.config/ion/initrc`:
+
+ ```sh
+ # ~/.config/ion/initrc
+
+ eval $(starship init ion)
+ ```
+
## 🔧 Configuration
-For details on how to configure Starship, check out our [documentation](https://starship.rs/config/).
+Pour plus de détails sur la configuration de Starship, consultez notre [documentation](https://starship.rs/config/).
-## 🤝 Contributing
+## 🤝Contribution
-We are always looking for contributors of **all skill levels**! If you're looking to ease your way into the project, try out a [good first issue](https://github.com/starship/starship/labels/🌱%20good%20first%20issue).
+Nous sommes toujours à la recherche de contributeurs de **tous les niveaux de compétence**! Si vous cherchez à faciliter votre entrée dans le projet, essayez un [good first issue](https://github.com/starship/starship/labels/🌱%20good%20first%20issue).
-### High Priority Needs
+### Besoins de priorité élevée
-- 👩💼 **Product Manager**
- - We have a GitHub Project and many unorganized/unprioritized features, as well as ideas that haven't yet been made into issues. Starship needs someone to own the product direction!
+- 👩💼**Gestionnaire de produit**
+ - Nous avons un projet GitHub et de nombreuses fonctionnalités non organisées/non priorisées, ainsi que des idées qui n'ont pas encore été faites dans les issues. Starship a besoin de quelqu'un qui deciderait la direction du produit !
- 👩🎨 **Designer**
- - Like making eye-catching websites? Excellent! We are looking to create a beautiful landing page showing off Starship in all its glory. Helping design for Starship's brand is a great opportunity to try out new ideas!
-- 👩💻 **Rust Developer**
- - There is _a lot_ of low-hanging fruit when it comes to writing idiomatic Rust, designing effective Rust architecture, performance optimizations, cross-platform build optimizations, and more! I ([@matchai](https://github.com/matchai)) am a beginner to Rust. Come point us in the right direction!
+ - Vous aimez créer des sites Web attrayantes ? Parfait ! Nous cherchons à créer une belle page d'atterrissage montrant Starship dans toute sa gloire. Aider au design pour Starship est une occasion excellente pour essayer de nouvelles idées!
+- 👩💻**Développeur Rust **
+ - Il y a _beaucoup_ de tâches simples lorsqu'il s'agit d'écrire Rust de façon idiomatique, de concevoir d'une architecture Rust efficace, des optimisations de performances, des optimisations des binaires multi-plateformes et plus encore ! Je ([@matchai](https://github.com/matchai)) suis un débutant de Rust. Venez nous diriger dans la bonne direction!
-If you are interested in helping contribute to starship, please take a look at our [Contributing Guide](https://github.com/starship/starship/blob/master/CONTRIBUTING.md). Also, feel free to drop into our [Discord server](https://discord.gg/8Jzqu3T) and say hi. 👋
+Si vous êtes intéressé à aider à contribuer à Starship, veuillez jeter un coup d'oeil à notre [Guide de contribution](https://github.com/starship/starship/blob/master/CONTRIBUTING.md). Aussi, n'hésitez pas à vous rendre sur notre [serveur Discord](https://discord.gg/8Jzqu3T) pour dire bonjour. 👋
-### Contributors
+### Contributeurs
-Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
+Merci à ces personnes merveilleuses ([clé emojis](https://allcontributors.org/docs/en/emoji-key)) :
@@ -291,23 +310,23 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
-This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
+Ce projet suit la spécification [all-contributors](https://github.com/all-contributors/all-contributors). Des contributions de tout genre bienvenues!
-## 💭 Inspired By
+## 💭Inspiré par
-Please check out these previous works that helped inspire the creation of starship. 🙏
+Voyez ces travaux précédents qui ont contribué à inspirer la création de vaisseau. 🙏
-- **[denysdovhan/spaceship-prompt](https://github.com/denysdovhan/spaceship-prompt)** - A ZSH prompt for astronauts.
+- **[denysdovhan/spaceship-prompt](https://github.com/denysdovhan/spaceship-prompt)** - Un ZSH prompt pour les astronautes.
-- **[denysdovhan/robbyrussell-node](https://github.com/denysdovhan/robbyrussell-node)** - Cross-shell robbyrussell theme written in JavaScript.
+- **[denysdovhan/robbyrussell-node](https://github.com/denysdovhan/robbyrussell-node)** - Thème Cross-shell robbyrussell écrit en JavaScript.
-- **[reujab/silver](https://github.com/reujab/silver)** - A cross-shell customizable powerline-like prompt with icons.
+- **[reujab/silver](https://github.com/reujab/silver)** - Un shell multi-platformes de type powerline personnalisable avec des icônes.
-
+
diff --git a/docs/ja-JP/config/README.md b/docs/ja-JP/config/README.md
index 80cd963e..64da9c37 100644
--- a/docs/ja-JP/config/README.md
+++ b/docs/ja-JP/config/README.md
@@ -98,9 +98,11 @@ prompt_order = [
"golang",
"java",
"nodejs",
+ "php",
"python",
"ruby",
"rust",
+ "terraform",
"nix_shell",
"conda",
"memory_usage",
@@ -273,15 +275,22 @@ prefix = "underwent "
## Conda
-`$CONDA_DEFAULT_ENV`が設定されている場合、`conda`モジュールは現在のcondaの環境を表示します。 Note: これはconda自身の プロンプト修飾子 を抑制しません。`conda config --set changeps1 False` で実行することができます。
+The `conda` module shows the current conda environment, if `$CONDA_DEFAULT_ENV` is set.
+
+::: tip
+
+This does not suppress conda's own prompt modifier, you may want to run `conda config --set changeps1 False`.
+
+:::
### オプション
-| 変数 | デフォルト | 説明 |
-| ---------- | -------------- | -------------------- |
-| `symbol` | `"C "` | 環境名の直前に使用されるシンボルです。 |
-| `style` | `"bold green"` | モジュールのスタイルです。 |
-| `disabled` | `false` | `conda`モジュールを無効にします。 |
+| 変数 | デフォルト | 説明 |
+| ------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `truncation_length` | `1` | The number of directories the environment path should be truncated to, if the environment was created via `conda create -p [path]`. `0` means no truncation. Also see the [`directory`](#directory) module. |
+| `symbol` | `"C "` | The symbol used before the environment name. |
+| `style` | `"bold green"` | The style for the module. |
+| `disabled` | `false` | Disables the `conda` module. |
### 設定例
@@ -296,22 +305,22 @@ style = "dimmed green"
`directory`モジュールには、現在のディレクトリへのパスが表示され、3つの親フォルダは切り捨てられます。 ディレクトリは、現在のgitリポジトリであるとルートとなります。
-fishスタイルのpwdオプションを使用すると、切り捨てられたパスを非表示にする代わりに、オプションで有効にした番号に基づいて各ディレクトリの短縮名が表示されます。
+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.
-例として、`~/Dev/Nix/nixpkgs/pkgs`で、`nixpkgs`がリポジトリルートであり、オプションが`1`に設定されている場合を挙げます。 以前は`nixpkgs/pkgs`でしたが、`~/D/N/nixpkgs/pkgs`が表示されます。
+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`.
### オプション
-| 変数 | デフォルト | 説明 |
-| ------------------- | ------------- | ----------------------------- |
-| `truncation_length` | `3` | 現在のディレクトリを切り捨てる親フォルダーの数です。 |
-| `truncate_to_repo` | `true` | 現在いるgitリポジトリのルートに切り捨てるかどうかです。 |
+| 変数 | デフォルト | 説明 |
+| ------------------- | ------------- | --------------------------------------------------- |
+| `truncation_length` | `3` | 現在のディレクトリを切り捨てる親フォルダーの数です。 |
+| `truncate_to_repo` | `true` | 現在いるgitリポジトリのルートに切り捨てるかどうかです。 |
| `prefix` | `"in "` | Prefix to display immediately before the directory. |
-| `style` | `"bold cyan"` | モジュールのスタイルです。 |
-| `disabled` | `false` | `directory`モジュールを無効にします。 |
+| `style` | `"bold cyan"` | The style for the module. |
+| `disabled` | `false` | Disables the `directory` module. |
-このモジュールは、どのようにディレクトリを表示するかについての高度なオプションをいくつか持っています。
+This module has a few advanced configuration options that control how the directory is displayed.
| 変数 | デフォルト | 説明 |
| --------------------------- | ------ | -------------------------------------------- |
@@ -331,11 +340,11 @@ truncation_length = 8
## 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` を実行するより2倍速く実行できますが、.NET project一般的でないディレクトリlayoutの場合は間違ったバージョンが示されてしまうことがあります。 速度よりも精度が重要な場合は、次の方法でメカニズムを無効にできます。 モジュールオプションで`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.
### オプション
@@ -411,13 +420,13 @@ truncation_length = 4
truncation_symbol = ""
```
-## Git Commit
+## Git コミット
The `git_commit` module shows the active branch of the repo in your current directory.
::: tip
-このモジュールはデフォルトで無効になっています。 有効にするには、設定ファイルで`disabled`を`false`に設定します。
+This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
:::
@@ -426,8 +435,8 @@ The `git_commit` module shows the active branch of the repo in your current dire
| 変数 | デフォルト | 説明 |
| -------------------- | -------------- | ------------------------------------------------ |
| `commit_hash_length` | `7` | The length of the displayed git commit hash. |
-| `prefix` | `(` | Prefix to display immediately before git commit. |
-| `suffix` | `)` | Suffix to display immediately after git commit. |
+| `prefix` | `"("` | Prefix to display immediately before git commit. |
+| `suffix` | `")"` | Suffix to display immediately after git commit. |
| `style` | `"bold green"` | モジュールのスタイルです。 |
| `disabled` | `true` | Disables the `git_commit` module. |
@@ -443,7 +452,7 @@ commit_hash_length = 4
## Git の進行状態
-`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.
### オプション
@@ -557,9 +566,9 @@ deleted = "🗑"
symbol = "🏎💨 "
```
-## Mercurial Branch
+## Mercurial ブランチ
-The `hg_branch` module shows the active branch of the repo in your current directory.
+` hg_branch `モジュールは、現在のディレクトリにあるリポジトリのアクティブなブランチを示します。
### オプション
@@ -802,6 +811,7 @@ symbol = "🤖 "
- **npm** – `npm`パッケージバージョンは、現在のディレクトリにある`package.json`から抽出されます
- **cargo** – `cargo`パッケージバージョンは、現在のディレクトリにある`Cargo.toml`から抽出されます。
- **poetry** – `poetry`パッケージバージョンは、現在のディレクトリにある`pyproject.toml`から抽出されます
+- **composer** – `composer`パッケージバージョンは、現在のディレクトリにある`composer.json`から抽出されます
> ⚠️ 表示されるバージョンは、パッケージマネージャーではなく、ソースコードが現在のディレクトリにあるパッケージのバージョンです。
@@ -824,10 +834,10 @@ symbol = "🎁 "
## PHP
-The `php` module shows the currently installed version of PHP. 次の条件のいずれかが満たされると、モジュールが表示されます。
+`php`モジュールは、現在インストールされているPHPのバージョンを示します。 次の条件のいずれかが満たされると、モジュールが表示されます。
- カレントディレクトリに`composer.json`ファイルが含まれている
-- The current directory contains a `.php` file
+- カレントディレクトリに`.php`の拡張子のファイルが含まれている
### オプション
@@ -848,13 +858,13 @@ symbol = "🔹 "
## Python
-`python`モジュールは、現在インストールされているPythonのバージョンを示します。
+The `python` module shows the currently installed version of Python.
-`pyenvversionname`が`true`に設定されている場合 、pyenvでのバージョン名が表示されます 。
+If `pyenv_version_name` is set to `true`, it will display the pyenv version name.
-それ以外の場合は、 `python --version`バージョン番号が表示され、アクティブになっている場合は現在のPython仮想環境が表示されます。
+Otherwise, it will display the version number from `python --version` and show the current Python virtual environment if one is activated.
-次の条件のいずれかが満たされると、モジュールが表示されます。
+The module will be shown if any of the following conditions are met:
- カレントディレクトリに`.python-version`ファイルが含まれている
- カレントディレクトリに`requirements.txt`ファイルが含まれている
@@ -933,27 +943,52 @@ symbol = "🔺 "
symbol = "⚙️ "
```
-## 時刻
+## Terraform
-`time`モジュールは、現在の**現地**時間を示します。 `format`設定は、時間の表示方法を制御するために[`chrono`](https://crates.io/crates/chrono)クレートによって使用されます。 使用可能なオプションを確認するには、[chrono strftimeのドキュメント](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html)をご覧ください。
+`terraform`モジュールには、現在選択されているterraformワークスペースとバージョンが表示されます。 デフォルトでは、Terraformのバージョンは表示されません。これは、多くのプラグインが使用されている場合、Terraformの現在のバージョンでは遅いためです。 次の条件のいずれかが満たされると、モジュールが表示されます。
+
+- カレントディレクトリに`.terraform`フォルダが含まれている
+- カレントディレクトリに`.tf`の拡張子のファイルが含まれている
+
+### オプション
+
+| 変数 | デフォルト | 説明 |
+| -------------- | ------------ | --------------------------------------------- |
+| `symbol` | `"💠 "` | Terraform ワークスペースを表示する前に使用される記号です。 |
+| `show_version` | `false` | Terraformのバージョンを表示します。 大きなワークスペースでは非常に遅くなります。 |
+| `style` | `"bold 105"` | モジュールのスタイルです。 |
+| `disabled` | `false` | `terraform`モジュールを無効にします。 |
+
+### 設定例
+
+```toml
+# ~/.config/starship.toml
+
+[terraform]
+symbol = "🏎💨 "
+```
+
+## 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.
::: 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` | この表の下を参照してください | 時刻のフォーマットに使用される[クロノフォーマット文字列](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) です。 |
-| `style` | `bold yellow` | モジュールのスタイルです。 |
-| `disabled` | `true` | `time`モジュールを無効にします。 |
-| `utc_time_offset` | `local` | 使用するUTCオフセットを設定します。 -24から24までの間で設定可能です。 フロートが30/45分のタイムゾーンオフセットに対応できるようにします。 |
+| 変数 | デフォルト | 説明 |
+| ----------------- | ------------- | ------------------------------------------------------------------------------------------------------------------- |
+| `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 |
+| `disabled` | `true` | Disables the `time` module. |
+| `utc_time_offset` | `local` | Sets the UTC offset to use. Range from -24 < x < 24. Allows floats to accommodate 30/45 minute timezone offsets. |
-`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.
### 設定例
@@ -966,25 +1001,25 @@ format = "🕙[ %T ]"
utc_time_offset = -5
```
-## ユーザー名
+## Username
-`username`モジュールには、アクティブなユーザーのユーザー名が表示されます。 次の条件のいずれかが満たされると、モジュールが表示されます。
+The `username` module shows active user's username. The module will be shown if any of the following conditions are met:
-- カレントユーザーが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
-### オプション
+### Options
-| 変数 | デフォルト | 説明 |
-| ------------- | --------------- | ------------------------- |
-| `style_root` | `"bold red"` | ユーザーがrootのときに使用されるスタイルです。 |
-| `style_user` | `"bold yellow"` | 非rootユーザーに使用されるスタイルです。 |
-| `show_always` | `false` | `username`モジュールを常に表示します。 |
-| `disabled` | `false` | `username`モジュールを無効にします。 |
+| Variable | Default | Description |
+| ------------- | --------------- | ------------------------------------- |
+| `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. |
-### 設定例
+### Example
```toml
# ~/.config/starship.toml
diff --git a/docs/ja-JP/faq/README.md b/docs/ja-JP/faq/README.md
index 6d5674be..556ab209 100644
--- a/docs/ja-JP/faq/README.md
+++ b/docs/ja-JP/faq/README.md
@@ -1,27 +1,27 @@
# FAQ
-## What is the configuration used in the demo GIF?
+## デモGIFで使用される構成は何ですか?
-- **Terminal Emulator**: [iTerm2](https://iterm2.com/)
- - **Theme**: Minimal
- - **Color Scheme**: [Snazzy](https://github.com/sindresorhus/iterm2-snazzy)
- - **Font**: [Fira Code](https://github.com/tonsky/FiraCode)
-- **Shell**: [Fish Shell](https://fishshell.com/)
- - **Configuration**: [matchai's Dotfiles](https://github.com/matchai/dotfiles/blob/master/.config/fish/config.fish)
- - **Prompt**: [Starship](https://starship.rs/)
+- **ターミナルエミュレータ**:[ iTerm2 ](https://iterm2.com/)
+ - **テーマ**: Minimal
+ - **カラースキーム**: [Snazzy](https://github.com/sindresorhus/iterm2-snazzy)
+ - **フォント**: [Fira Code](https://github.com/tonsky/FiraCode)
+- **シェル**: [Fish Shell](https://fishshell.com/)
+ - **設定**: [matchaiのDotfiles](https://github.com/matchai/dotfiles/blob/master/.config/fish/config.fish)
+ - **プロンプト**: [Starship](https://starship.rs/)
-## Do `prompt_order` and `.disabled` do the same thing?
+## `prompt_order` と `.disabled` は同じことをしますか?
-Yes, they can both be used to disable modules in the prompt. If all you plan to do is disable modules, `.disabled` is the preferred way to do so for these reasons:
+はい、両方ともプロンプトでモジュールを無効にするために使用できます。 モジュールを無効にするだけの場合は、これらの理由から` .disabled `を無効にする方法をお勧めします。
-- Disabling modules is more explicit than omitting them from the prompt_order
-- Newly created modules will be added to the prompt as Starship is updated
+- モジュールを無効にすると、prompt_orderからモジュールを省略するよりも明確になります。
+- Starshipが更新されると、新しく作成されたモジュールがプロンプトに追加されます
-## The docs say Starship is cross-shell, but it doesn't support X shell. Why?
+## ドキュメントによると、Starshipはクロスシェル対応をしているようですが、Xシェルはサポートしていません。 なぜですか?
-The way Starship is built, it should be possible to add support for virtually any shell. The starship binary is stateless and shell agnostic, so as long as your shell supports prompt customization and shell expansion, Starship can be used.
+Starshipの構築方法は、事実上すべてのシェルのサポートを追加できるはずです。 Starshipのバイナリはステートレスであり、シェルに依存しないため、シェルがプロンプトのカスタマイズとシェルの拡張をサポートしている限り、Starshipを使用できます。
-Here's a small example getting Starship working with bash:
+Starshipをbashで動作させる小さな例を次に示します。
```sh
# Get the status code from the last command executed
@@ -34,12 +34,12 @@ NUM_JOBS=$(jobs -p | wc -l)
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)は、[ Command Durationモジュール](https://starship.rs/config/#Command-Duration)などの高度な機能を可能にし、Starshipが事前にインストールされたBash構成と互換性があるようにするため、少し複雑です。
-For a list of all flags accepted by `starship prompt`, use the following command:
+`Starshipのプロンプト`で受け入れられるすべてのフラグのリストは、次のコマンドを取得できます。
```sh
starship prompt --help
```
-The prompt will use as much context as is provided, but no flags are "required".
+プロンプトは提供されているコンテキストを使用しますが、フラグは「必須」ではありません。
diff --git a/docs/ja-JP/guide/README.md b/docs/ja-JP/guide/README.md
index f2714ec4..98a70e7d 100644
--- a/docs/ja-JP/guide/README.md
+++ b/docs/ja-JP/guide/README.md
@@ -20,7 +20,9 @@
>
-
+
+
+
-
+
diff --git a/docs/ru-RU/config/README.md b/docs/ru-RU/config/README.md
index 61341cae..4d5d370b 100644
--- a/docs/ru-RU/config/README.md
+++ b/docs/ru-RU/config/README.md
@@ -98,9 +98,11 @@ prompt_order = [
"golang",
"java",
"nodejs",
+ "php",
"python",
"ruby",
"rust",
+ "terraform",
"nix_shell",
"conda",
"memory_usage",
@@ -272,15 +274,22 @@ prefix = "underwent "
## Конда
-Модуль `conda` показывает текущее окружение conda, если `$CONDA_DEFAULT_ENV` присвоено значение. Примечание: Это не подавляет модификатор командной строки самой конды, вы можете запустить `conda config --set changeps1 False`
+The `conda` module shows the current conda environment, if `$CONDA_DEFAULT_ENV` is set.
+
+::: tip
+
+This does not suppress conda's own prompt modifier, you may want to run `conda config --set changeps1 False`.
+
+:::
### Опции
-| Переменная | По умолчанию | Описание |
-| ---------- | -------------- | --------------------------------- |
-| `symbol` | `"C "` | Символ перед названием окружения. |
-| `style` | `"bold green"` | Стиль модуля. |
-| `disabled` | `false` | Отключает модуль `conda`. |
+| Переменная | По умолчанию | Описание |
+| ------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `truncation_length` | `1` | The number of directories the environment path should be truncated to, if the environment was created via `conda create -p [path]`. `0` means no truncation. Also see the [`directory`](#directory) module. |
+| `symbol` | `"C "` | The symbol used before the environment name. |
+| `style` | `"bold green"` | The style for the module. |
+| `disabled` | `false` | Disables the `conda` module. |
### Пример
@@ -293,11 +302,11 @@ style = "dimmed green"
## Каталог
-Модуль `directory` показывает путь к вашей текущей директории, усеченной до трех родительских папок. Ваш каталог также будет отсечен до корня git репозитория, в котором вы находитесь.
+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.
-При использовании стиля оболочки fish, вместо скрытия усеченного каталога, вы увидите укороченное имя каталога, зависимое от числа символов вы установите для этой опции.
+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.
-Например, возьмем `~/Dev/Nix/nixpkgs/pkgs` где `nixpkgs` является корневым репозиторием, и в опции установлено `1`. Вы увидите `~/D/N/nixpkgs/pkgs`, а до этого было бы `nixpkgs/pkgs`.
+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`.
### Опции
@@ -306,11 +315,11 @@ style = "dimmed green"
| `truncation_length` | `3` | Количество родительских папок, к которым должен быть усечен текущий каталог. |
| `truncate_to_repo` | `true` | Следует или нет обрезать до корня репозитория git, в котором вы находитесь. |
| `prefix` | `"in "` | Prefix to display immediately before the directory. |
-| `style` | `"bold cyan"` | Стиль модуля. |
-| `disabled` | `false` | Отключает модуль `directory`. |
+| `style` | `"bold cyan"` | The style for the module. |
+| `disabled` | `false` | Disables the `directory` module. |
-Этот модуль имеет несколько расширенных опций конфигурации, которые контролируют отображение каталога.
+This module has a few advanced configuration options that control how the directory is displayed.
| Переменная | По умолчанию | Описание |
| --------------------------- | ------------ | ---------------------------------------------------------------------------------------- |
@@ -330,11 +339,11 @@ truncation_length = 8
## 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.
### Опции
@@ -425,8 +434,8 @@ This module is disabled by default. To enable it, set `disabled` to `false` in y
| Переменная | По умолчанию | Описание |
| -------------------- | -------------- | ------------------------------------------------ |
| `commit_hash_length` | `7` | The length of the displayed git commit hash. |
-| `prefix` | `(` | Prefix to display immediately before git commit. |
-| `suffix` | `)` | Suffix to display immediately after git commit. |
+| `prefix` | `"("` | Prefix to display immediately before git commit. |
+| `suffix` | `")"` | Suffix to display immediately after git commit. |
| `style` | `"bold green"` | Стиль модуля. |
| `disabled` | `true` | Disables the `git_commit` module. |
@@ -800,6 +809,7 @@ The `package` module is shown when the current directory is the repository for a
- **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
> ⚠️ The version being shown is that of the package whose source code is in your current directory, not your package manager.
@@ -931,6 +941,31 @@ The `rust` module shows the currently installed version of Rust. The module will
symbol = "⚙️ "
```
+## 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. The module will be shown if any of the following conditions are met:
+
+- The current directory contains a `.terraform` folder
+- Current directory contains a file with the `.tf` extension
+
+### Опции
+
+| Переменная | По умолчанию | Описание |
+| -------------- | ------------ | ----------------------------------------------------------- |
+| `symbol` | `"💠 "` | The symbol used before displaying the terraform workspace. |
+| `show_version` | `false` | Shows the terraform version. Very slow on large workspaces. |
+| `style` | `"bold 105"` | The style for the module. |
+| `disabled` | `false` | Disables the `terraform` module. |
+
+### Пример
+
+```toml
+# ~/.config/starship.toml
+
+[terraform]
+symbol = "🏎💨 "
+```
+
## 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.
@@ -973,16 +1008,16 @@ The `username` module shows active user's username. The module will be shown if
- The user is currently connected as an SSH session
- The variable `show_always` is set to true
-### Опции
+### Options
-| Переменная | По умолчанию | Описание |
+| Variable | Default | Description |
| ------------- | --------------- | ------------------------------------- |
| `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. |
-### Пример
+### Example
```toml
# ~/.config/starship.toml
diff --git a/docs/ru-RU/guide/README.md b/docs/ru-RU/guide/README.md
index fddc27c6..0997663c 100644
--- a/docs/ru-RU/guide/README.md
+++ b/docs/ru-RU/guide/README.md
@@ -20,16 +20,18 @@
>
-
+
+
+
-
+
diff --git a/docs/zh-CN/config/README.md b/docs/zh-CN/config/README.md
index 1de5d0ee..68399603 100644
--- a/docs/zh-CN/config/README.md
+++ b/docs/zh-CN/config/README.md
@@ -98,9 +98,11 @@ prompt_order = [
"golang",
"java",
"nodejs",
+ "php",
"python",
"ruby",
"rust",
+ "terraform",
"nix_shell",
"conda",
"memory_usage",
@@ -272,15 +274,22 @@ prefix = "underwent "
## Conda
-The `conda` module shows the current conda environment, if `$CONDA_DEFAULT_ENV` is set. Note: This does not suppress conda's own prompt modifier, you may want to run `conda config --set changeps1 False`
+The `conda` module shows the current conda environment, if `$CONDA_DEFAULT_ENV` is set.
+
+::: tip
+
+This does not suppress conda's own prompt modifier, you may want to run `conda config --set changeps1 False`.
+
+:::
### Options
-| Variable | Default | Description |
-| ---------- | -------------- | -------------------------------------------- |
-| `symbol` | `"C "` | The symbol used before the environment name. |
-| `style` | `"bold green"` | The style for the module. |
-| `disabled` | `false` | Disables the `conda` module. |
+| Variable | Default | Description |
+| ------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `truncation_length` | `1` | The number of directories the environment path should be truncated to, if the environment was created via `conda create -p [path]`. `0` means no truncation. Also see the [`directory`](#directory) module. |
+| `symbol` | `"C "` | The symbol used before the environment name. |
+| `style` | `"bold green"` | The style for the module. |
+| `disabled` | `false` | Disables the `conda` module. |
### Example
@@ -425,8 +434,8 @@ This module is disabled by default. To enable it, set `disabled` to `false` in y
| Variable | Default | Description |
| -------------------- | -------------- | ------------------------------------------------ |
| `commit_hash_length` | `7` | The length of the displayed git commit hash. |
-| `prefix` | `(` | Prefix to display immediately before git commit. |
-| `suffix` | `)` | Suffix to display immediately after git commit. |
+| `prefix` | `"("` | Prefix to display immediately before git commit. |
+| `suffix` | `")"` | Suffix to display immediately after git commit. |
| `style` | `"bold green"` | The style for the module. |
| `disabled` | `true` | Disables the `git_commit` module. |
@@ -800,6 +809,7 @@ The `package` module is shown when the current directory is the repository for a
- **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
> ⚠️ The version being shown is that of the package whose source code is in your current directory, not your package manager.
@@ -931,6 +941,31 @@ The `rust` module shows the currently installed version of Rust. The module will
symbol = "⚙️ "
```
+## 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. The module will be shown if any of the following conditions are met:
+
+- The current directory contains a `.terraform` folder
+- Current directory contains a file with the `.tf` extension
+
+### Options
+
+| Variable | Default | Description |
+| -------------- | ------------ | ----------------------------------------------------------- |
+| `symbol` | `"💠 "` | The symbol used before displaying the terraform workspace. |
+| `show_version` | `false` | Shows the terraform version. Very slow on large workspaces. |
+| `style` | `"bold 105"` | The style for the module. |
+| `disabled` | `false` | Disables the `terraform` module. |
+
+### Example
+
+```toml
+# ~/.config/starship.toml
+
+[terraform]
+symbol = "🏎💨 "
+```
+
## 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.
diff --git a/docs/zh-CN/guide/README.md b/docs/zh-CN/guide/README.md
index 2575bb8a..4752eb38 100644
--- a/docs/zh-CN/guide/README.md
+++ b/docs/zh-CN/guide/README.md
@@ -20,7 +20,9 @@
>
-
+
+
+
-
+
diff --git a/docs/zh-TW/config/README.md b/docs/zh-TW/config/README.md
index a2a64f26..08bb2b86 100644
--- a/docs/zh-TW/config/README.md
+++ b/docs/zh-TW/config/README.md
@@ -98,9 +98,11 @@ prompt_order = [
"golang",
"java",
"nodejs",
+ "php",
"python",
"ruby",
"rust",
+ "terraform",
"nix_shell",
"conda",
"memory_usage",
@@ -272,15 +274,22 @@ prefix = "underwent "
## Conda
-如果有設定 `$CONDA_DEFAULT_ENV` 時,`conda` 模組顯示現在 conda 的環境。 注意:這不會抑制 conda 自己的提示字元修飾字,你可能會想執行 `conda config --set changeps1 False`。
+The `conda` module shows the current conda environment, if `$CONDA_DEFAULT_ENV` is set.
+
+::: tip
+
+This does not suppress conda's own prompt modifier, you may want to run `conda config --set changeps1 False`.
+
+:::
### 選項
-| 變數 | 預設 | 說明 |
-| ---------- | -------------- | -------------- |
-| `symbol` | `"C "` | 環境名稱前使用的符號。 |
-| `style` | `"bold green"` | 模組的風格。 |
-| `disabled` | `false` | 停用 `conda` 模組。 |
+| 變數 | 預設 | 說明 |
+| ------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `truncation_length` | `1` | The number of directories the environment path should be truncated to, if the environment was created via `conda create -p [path]`. `0` means no truncation. Also see the [`directory`](#directory) module. |
+| `symbol` | `"C "` | The symbol used before the environment name. |
+| `style` | `"bold green"` | The style for the module. |
+| `disabled` | `false` | Disables the `conda` module. |
### 範例
@@ -293,24 +302,24 @@ style = "dimmed green"
## 資料夾
-`directory` 模組顯示到現在資料夾的路徑,並裁減到前三層資料夾。 你的資料夾也會被裁減到你所在的 git 儲存庫的根目錄。
+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.
-如果正在使用 fish 風格的 pwd 選項,將不會隱藏被裁減的資料夾,而是會根據你在選項中設定的數字看到每一層資料夾的縮寫。
+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.
-例如,給定一個右列的路徑 `~/Dev/Nix/nixpkgs/pkgs` 其中 `nixpkgs` 是儲存庫的根目錄,而且該選項被設定為 `1`。 你會看到 `~/D/N/nixpkgs/pkgs`,而在這個設定之前則是 `nixpkgs/pkgs`。
+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`.
### 選項
-| 變數 | 預設 | 說明 |
-| ------------------- | ------------- | ------------------------- |
-| `truncation_length` | `3` | 到達現在資料夾的路徑中,要被裁減掉的資料夾數目。 |
-| `truncate_to_repo` | `true` | 是否要裁減到你現在所在的 git 儲存庫的根目錄。 |
+| 變數 | 預設 | 說明 |
+| ------------------- | ------------- | --------------------------------------------------- |
+| `truncation_length` | `3` | 到達現在資料夾的路徑中,要被裁減掉的資料夾數目。 |
+| `truncate_to_repo` | `true` | 是否要裁減到你現在所在的 git 儲存庫的根目錄。 |
| `prefix` | `"in "` | Prefix to display immediately before the directory. |
-| `style` | `"bold cyan"` | 這個模組的風格。 |
-| `disabled` | `false` | 停用 `directory` 模組。 |
+| `style` | `"bold cyan"` | The style for the module. |
+| `disabled` | `false` | Disables the `directory` module. |
-這個模組有些進階設定選項可以控制顯示資料夾。
+This module has a few advanced configuration options that control how the directory is displayed.
| 變數 | 預設 | 說明 |
| --------------------------- | ------ | ------------------------------------ |
@@ -330,11 +339,11 @@ truncation_length = 8
## 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.
### 選項
@@ -358,7 +367,7 @@ heuristic = false
## 環境變數
-`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` 選項。
@@ -387,7 +396,7 @@ default = "unknown shell"
## Git 分支
-`git_branch` 模組顯示現在的資料夾中使用中的儲存庫的分支。
+The `git_branch` module shows the active branch of the repo in your current directory.
### 選項
@@ -416,7 +425,7 @@ The `git_commit` module shows the active branch of the repo in your current dire
::: tip
-這個模組預設是停用的。 想要啟用它的話,請在設定檔中將 `disabled` 設定為 `false`。
+This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
:::
@@ -425,8 +434,8 @@ The `git_commit` module shows the active branch of the repo in your current dire
| 變數 | 預設 | 說明 |
| -------------------- | -------------- | ------------------------------------------------ |
| `commit_hash_length` | `7` | The length of the displayed git commit hash. |
-| `prefix` | `(` | Prefix to display immediately before git commit. |
-| `suffix` | `)` | Suffix to display immediately after git commit. |
+| `prefix` | `"("` | Prefix to display immediately before git commit. |
+| `suffix` | `")"` | Suffix to display immediately after git commit. |
| `style` | `"bold green"` | 這個模組的風格。 |
| `disabled` | `true` | Disables the `git_commit` module. |
@@ -442,7 +451,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.
### 選項
@@ -471,7 +480,7 @@ cherry_pick = "🍒 PICKING"
## Git Status
-`git_status` 模組顯示用來表示現在資料夾之中儲存庫狀態的符號。
+The `git_status` module shows symbols representing the state of the repo in your current directory.
### 選項
@@ -529,7 +538,7 @@ deleted = "🗑"
## Golang
-`golang` 模組顯示現在安裝的 Golang 版本。 這個模組在下列其中一個條件達成時顯示:
+The `golang` module shows the currently installed version of Golang. The module will be shown if any of the following conditions are met:
- 現在資料夾中含有一個 `go.mod` 檔案
- 現在資料夾中含有一個 `go.sum` 檔案
@@ -583,7 +592,7 @@ truncation_symbol = ""
## 主機名稱
-`hostname` 模組顯示系統的主機名稱。
+The `hostname` module shows the system hostname.
### 選項
@@ -611,7 +620,7 @@ disabled = false
## 工作
-`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.
### 選項
@@ -634,11 +643,11 @@ threshold = 4
## 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.
:::
@@ -663,7 +672,7 @@ disabled = false
## 換行
-`line_break` 模組將提示字元分成兩行。
+The `line_break` module separates the prompt into two lines.
### 選項
@@ -682,7 +691,7 @@ disabled = true
## 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.
### 選項
@@ -708,13 +717,13 @@ pure_msg = "pure shell"
## 記憶體使用量
-`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.
:::
@@ -746,7 +755,7 @@ style = "bold dimmed green"
## Java
-`java` 模組顯示現在安裝的 Java 版本。 這個模組在下列其中一個條件達成時顯示:
+The `java` module shows the currently installed version of Java. 這個模組在下列其中一個條件達成時顯示:
- 現在資料夾中包含一個 `pom.xml`、`build.gradle` 或 `build.sbt` 檔案
- 現在資料夾中包含一個檔案具有 `.java`、`.class` 或 `.jar` 副檔名
@@ -770,7 +779,7 @@ symbol = "🌟 "
## NodeJS
-`nodejs` 模組顯示現在安裝的 NodeJS 版本。 這個模組在下列其中一個條件達成時顯示:
+The `nodejs` module shows the currently installed version of NodeJS. The module will be shown if any of the following conditions are met:
- 現在資料夾中包含一個 `package.json` 檔案
- 現在資料夾中包含一個 `node_modules` 資料夾
@@ -795,11 +804,12 @@ symbol = "🤖 "
## 套件版本
-The `package` 模組在現在資料夾是一個套件的儲藏庫時出現,並顯示他的現在版本。 這個模組目前支援 `npm`、`cargo` 與 `poetry` 套件。
+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`, and `poetry` packages.
- **npm** – `npm` 套件的版本是從現在資料夾中的 `package.json` 之中擷取出來的
- **cargo** – `cargo` 套件的版本是從現在資料夾中的 `Cargo.toml` 之中擷取出來的
- **poetry** – `poetry` 套件的版本是從現在資料夾中的 `pyproject.toml` 之中擷取出來的
+- **composer** – The `composer` package version is extracted from the `composer.json` present in the current directory
> ⚠️ 顯示出來的版本是從你的現在資料夾之中擷取出來的,並非從套件管理員取得。
@@ -822,7 +832,7 @@ symbol = "🎁 "
## PHP
-The `php` module shows the currently installed version of PHP. 這個模組在下列其中一個條件達成時顯示:
+The `php` module shows the currently installed version of PHP. The module will be shown if any of the following conditions are met:
- 現在資料夾中含有一個 `composer.json` 檔案
- The current directory contains a `.php` file
@@ -846,13 +856,13 @@ symbol = "🔹 "
## Python
-`python` 模組顯示現在安裝的 Python 版本
+The `python` module shows the currently installed version of Python.
-如果 `pyenv_version_name` 的值為 `true`, 會顯示 pyenv 內的版本名稱
+If `pyenv_version_name` is set to `true`, it will display the pyenv version name.
-要不然就會顯示 `python -version` 的版本和有啟用的 Python 虛擬環境版本
+Otherwise, it will display the version number from `python --version` and show the current Python virtual environment if one is activated.
-這個模組在下列其中一個條件達成時顯示:
+The module will be shown if any of the following conditions are met:
- 目前資料夾中有一個 `.python-version` 檔案
- 目前資料夾中有一個 `requirements.txt` 檔案
@@ -885,7 +895,7 @@ pyenv_prefix = "foo "
## Ruby
-`ruby` 模組顯示現在安裝的 Ruby 版本。 這個模組在下列其中一個條件達成時顯示:
+The `ruby` module shows the currently installed version of Ruby. The module will be shown if any of the following conditions are met:
- 目前資料夾中有一個 `Gemfile` 檔案
- 目前資料夾中有一個 `.rb` 檔案
@@ -909,7 +919,7 @@ symbol = "🔺 "
## Rust
-`rust` 模組顯示現在安裝的 Rust 版本。 這個模組在下列其中一個條件達成時顯示:
+The `rust` module shows the currently installed version of Rust. The module will be shown if any of the following conditions are met:
- 目前資料夾中有一個 `Cargo.toml` 檔案
- 現在資料夾中包含一個檔案具有 `.rs` 副檔名
@@ -931,27 +941,52 @@ symbol = "🔺 "
symbol = "⚙️ "
```
-## 時間
+## Terraform
-`time` 模組顯示目前的**當地**時間. `format` 設定值被 [`chrono`](https://crates.io/crates/chrono) crate 用來控制時間如何顯示。 請看 [chrono 的 strftime 文件](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html)來了解有那些選項可以使用。
+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. The module will be shown if any of the following conditions are met:
+
+- The current directory contains a `.terraform` folder
+- Current directory contains a file with the `.tf` extension
+
+### 選項
+
+| 變數 | 預設 | 說明 |
+| -------------- | ------------ | ----------------------------------------------------------- |
+| `symbol` | `"💠 "` | The symbol used before displaying the terraform workspace. |
+| `show_version` | `false` | Shows the terraform version. Very slow on large workspaces. |
+| `style` | `"bold 105"` | The style for the module. |
+| `disabled` | `false` | Disables the `terraform` module. |
+
+### 範例
+
+```toml
+# ~/.config/starship.toml
+
+[terraform]
+symbol = "🏎💨 "
+```
+
+## 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.
::: 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` | 這個模組的時間的風格。 |
-| `disabled` | `true` | 停用 `time` 模組。 |
-| `utc_time_offset` | `local` | 設定相對於 UTC 的時差。 範圍 -24 < x < 24。 允許使用浮點數來表示 30/45 分鐘時差的時區。 |
+| 變數 | 預設 | 說明 |
+| ----------------- | ------------- | ------------------------------------------------------------------------------------------------------------------- |
+| `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 |
+| `disabled` | `true` | Disables the `time` module. |
+| `utc_time_offset` | `local` | Sets the UTC offset to use. Range from -24 < x < 24. Allows floats to accommodate 30/45 minute timezone offsets. |
-如果 `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.
### 範例
@@ -964,25 +999,25 @@ format = "🕙[ %T ]"
utc_time_offset = -5
```
-## 使用者名稱
+## Username
-`username` 模組顯示現在使用中的使用者名稱。 這個模組在下列其中一個條件達成時顯示:
+The `username` module shows active user's username. The module will be shown if any of the following conditions are met:
-- 目前使用者為 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
-### 選項
+### Options
-| 變數 | 預設 | 說明 |
-| ------------- | --------------- | ------------------- |
-| `style_root` | `"bold red"` | 使用者為 root 時使用的風格。 |
-| `style_user` | `"bold yellow"` | 非 root 使用者時使用的風格。 |
-| `show_always` | `false` | 總是顯示 `username` 模組。 |
-| `disabled` | `false` | 停用 `username` 模組。 |
+| Variable | Default | Description |
+| ------------- | --------------- | ------------------------------------- |
+| `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. |
-### 範例
+### Example
```toml
# ~/.config/starship.toml
diff --git a/docs/zh-TW/guide/README.md b/docs/zh-TW/guide/README.md
index 72dfc260..4b1b1860 100644
--- a/docs/zh-TW/guide/README.md
+++ b/docs/zh-TW/guide/README.md
@@ -20,7 +20,9 @@
>
-
+
+
+