Llewellyn
/
starship
mirror of https://github.com/Llewellynvdm/starship.git
1
0
Fork 0
Code Issues Releases Activity

New translations readme.md (French)

This commit is contained in:
Matan Kushner 2023-11-02 18:23:20 +09:00
parent 8c4d11f2f1
commit 12da8720ae
1 changed files with 144 additions and 137 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -206,6 +206,13 @@ Voici la liste des options de configuration globales de l'invite de commandes.
| `add_newline` | `true` | Insère une ligne vide entre les invites du shell. |
| `palette` | `''` | Sets which color palette from `palettes` to use. |
| `palettes` | `{}` | Collection of color palettes that assign [colors](/advanced-config/#style-strings) to user-defined names. Note that color palettes cannot reference their own color definitions. |
| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. |
::: tip
If you have symlinks to networked filesystems, consider setting `follow_symlinks` to `false`.
:::
### Exemple
@ -237,7 +244,7 @@ mustard = '#af8700'
### Format par Défaut
Le `format` par défaut est utilisé pour définir le format de l'invite, si il est vide ou mal `formaté`. La valeur par défaut est la suivante :
The default `format` is used to define the format of the prompt, if empty or no `format` is provided. The default is as shown:
```toml
format = '$all'
@ -331,7 +338,7 @@ $shell\
$character"""
```
Si vous voulez étendre le format par défaut, pour pouvoir utiliser `$all` ; les modules que vous ajouter explicitement au format ne seront pas dupliqués. Par ex.
If you just want to extend the default format, you can use `$all`; modules you explicitly add to the format will not be duplicated. Eg.
```toml
# Move the directory to the second line
@ -344,11 +351,11 @@ The `aws` module shows the current AWS region and profile and an expiration time
The module will display a profile only if its credentials are present in `~/.aws/credentials` or if a `credential_process`, `sso_start_url`, or `sso_session` are defined in `~/.aws/config`. Alternatively, having any of the `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, or `AWS_SESSION_TOKEN` env vars defined will also suffice. If the option `force_display` is set to `true`, all available information will be displayed even if no credentials per the conditions above are detected.
Lorsque vous utilisez [aws-vault](https://github.com/99designs/aws-vault) le profil est lu à partir de la variable d'environnement `AWS_VAULT` et la date d'expiration des identifiants est lue à partir de la variable d'environnement `AWS_SESSION_EXPIRATION`.
When using [aws-vault](https://github.com/99designs/aws-vault) the profile is read from the `AWS_VAULT` env var and the credentials expiration date is read from the `AWS_SESSION_EXPIRATION` env var.
Lorsque vous utilisez [awsu](https://github.com/kreuzwerker/awsu) le profil est lu depuis la variable d'environnement `AWSU_PROFILE`.
When using [awsu](https://github.com/kreuzwerker/awsu) the profile is read from the `AWSU_PROFILE` env var.
Lorsque vous utilisez [AWSume](https://awsu.me) le profil est lu à partir de la variable d'environnement `AWSUME_PROFILE` et la date d'expiration des identifiants est lue à partir de la variable d'environnement `AWSUME_EXPIRATION`.
When using [AWSume](https://awsu.me) the profile is read from the `AWSUME_PROFILE` env var and the credentials expiration date is read from the `AWSUME_EXPIRATION` env var.
When using [saml2aws](https://github.com/Versent/saml2aws) the expiration information obtained from `~/.aws/credentials` falls back to the `x_security_token_expires` key.
@ -424,7 +431,7 @@ Enterprise_Naming_Scheme-voidstars = 'void**'
## Azure
Le module `azure` affiche l'abonnement Azure actuel. This is based on showing the name of the default subscription or the username, as defined in the `~/.azure/azureProfile.json` file.
The `azure` module shows the current Azure Subscription. This is based on showing the name of the default subscription or the username, as defined in the `~/.azure/azureProfile.json` file.
### Options
@ -473,7 +480,7 @@ very-long-subscription-name = 'vlsn'
## Battery
Le module `battery` montre à quel point la batterie de l'appareil est chargée et son état de charge actuel. Ce module n'est visible que lorsque la batterie de l'appareil est inférieure à 10%.
The `battery` module shows how charged the device's battery is and its current charging status. The module is only visible when the device's battery is below 10%.
### Options
@ -501,7 +508,7 @@ discharging_symbol = '💀 '
### Indicateur de batterie
L'option de configuration `display` est utilisée pour définir quand l'indicateur de batterie doit être affiché (threshold), quel symbole doit être utilisé (symbol) et à quoi il ressemble (style). Si aucun `display` n'est fourni. La valeur par défaut est la suivante :
The `display` configuration option is used to define when the battery indicator should be shown (threshold), which symbol would be used (symbol), and what it would like (style). If no `display` is provided. The default is as shown:
```toml
[[battery.display]]
@ -509,11 +516,11 @@ threshold = 10
style = 'bold red'
```
La valeur par défaut pour les options `charging_symbol` et `discharging_symbol` est respectivement la valeur des options `charging_symbol` et `discharging_symbol` du module `battery`.
The default value for the `charging_symbol` and `discharging_symbol` option is respectively the value of `battery`'s `charging_symbol` and `discharging_symbol` option.
#### Options
L'option `display` est un tableau des propriétés suivantes.
The `display` option is an array of the following table.
| Option | Défaut | Description |
| -------------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------- |
@ -539,7 +546,7 @@ discharging_symbol = '💦'
## Buf
Le module `buf` affiche la version de [Buf](https://buf.build) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `buf` module shows the currently installed version of [Buf](https://buf.build). By default, the module is shown if all of the following conditions are met:
- La commande [`buf`](https://github.com/bufbuild/buf) est installée.
- Le dossier actuel contient un fichier de configuration [`buf.yaml`](https://docs.buf.build/configuration/v1/buf-yaml), [`buf.gen.yaml`](https://docs.buf.build/configuration/v1/buf-gen-yaml) ou [`buf.work.yaml`](https://docs.buf.build/configuration/v1/buf-work-yaml).
@ -578,7 +585,7 @@ symbol = '🦬 '
## Bun
The `bun` module shows the currently installed version of the [bun](https://bun.sh) JavaScript runtime. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `bun` module shows the currently installed version of the [bun](https://bun.sh) JavaScript runtime. By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier `bun.lockb`
- Le dossier courant contient un fichier `bunfig.toml`
@ -617,7 +624,7 @@ format = 'via [🍔 $version](bold green) '
## C
Le module `c` affiche des informations à propos de votre compilateur C. Par défaut, ce module sera affiché si le dossier courant contient un fichier `.c` ou `.h`.
The `c` module shows some information about your C compiler. By default the module will be shown if the current directory contains a `.c` or `.h` file.
### Options
@ -642,15 +649,15 @@ Le module `c` affiche des informations à propos de votre compilateur C. Par dé
| symbole | | Reflète la valeur de l'option `symbol` |
| style | | Reflète la valeur de l'option `style` |
Notez que `version` n’est pas dans le format par défaut.
NB that `version` is not in the default format.
### Commandes
L’option `commands` accepte une liste de commandes pour déterminer la version du compilateur et son nom.
The `commands` option accepts a list of commands to determine the compiler version and name.
Each command is represented as a list of the executable name, followed by its arguments, usually something like `['mycc', '--version']`. Starship essayera d'exécuter chaque commande jusqu'à obtenir un résultat sur STDOUT.
Each command is represented as a list of the executable name, followed by its arguments, usually something like `['mycc', '--version']`. Starship will try executing each command until it gets a result on STDOUT.
Si un compilateur C n’est pas supporté par ce module, vous pouvez demander son ajout en [créant un ticket sur GitHub](https://github.com/starship/starship/).
If a C compiler is not supported by this module, you can request it by [raising an issue on GitHub](https://github.com/starship/starship/).
### Exemple
@ -663,14 +670,14 @@ format = 'via [$name $version]($style)'
## Caractère
Le module `character` affiche un caractère (en général une flèche) à côté de là où vous entrez le texte dans votre terminal.
The `character` module shows a character (usually an arrow) beside where the text is entered in your terminal.
Le caractère vous dira si la dernière commande a été réussie ou pas. Il peut faire ça de deux façons:
The character will tell you whether the last command was successful or not. It can do this in two ways:
- en changeant de couleur(`red`/`green`)
- en changeant de forme (`❯`/`✖`)
Par défaut, il ne change que de couleur. Si vous désirez également changer sa forme, jetez un à [cet exemple](#with-custom-error-shape).
By default it only changes color. If you also want to change its shape take a look at [this example](#with-custom-error-shape).
::: warning
@ -730,7 +737,7 @@ vimcmd_symbol = '[V](bold green) '
## CMake
Le module `cmake` affiche la version de [CMake](https://cmake.org/) installée. Par défaut, le module s’activera si l’une de ces conditions est remplie:
The `cmake` module shows the currently installed version of [CMake](https://cmake.org/). By default the module will be activated if any of the following conditions are met:
- Le dossier courant contient un fichier `CMakeLists.txt`
- Le dossier courant contient un fichier `CMakeCache.txt`
@ -760,7 +767,7 @@ Le module `cmake` affiche la version de [CMake](https://cmake.org/) installée.
## COBOL / GNUCOBOL
Le module `cobol` affiche la version de COBOL installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `cobol` module shows the currently installed version of COBOL. By default, the module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier finissant par `.cob` ou `.COB`
- Le dossier courant contiens un fichier finissant par `.cbl` ou `.CBL`
@ -790,15 +797,15 @@ Le module `cobol` affiche la version de COBOL installée. Par défaut, le module
## Temps d'exécution
Le module `cmd_duration` montre le temps qu'a pris la dernière commande pour s'exécuter. Le module ne sera affiché que si la commande a pris plus de deux secondes, ou plus que la valeur `min_time`, si elle existe.
The `cmd_duration` module shows how long the last command took to execute. The module will be shown only if the command took longer than two seconds, or the `min_time` config value, if it exists.
::: warning N'accrochez pas la trappe DEBUG en Bash
::: warning Do not hook the DEBUG trap in Bash
Si vous utilisez starship avec `bash`, n'interceptez pas `DEBUG` après avoir exécuté `eval $(starship init $0)`, ou ce module **ne fonctionnera pas**.
If you are running Starship in `bash`, do not hook the `DEBUG` trap after running `eval $(starship init $0)`, or this module **will** break.
:::
Les utilisateurs de Bash qui ont besoin de fonctionnalité pré-exec peuvent utiliser [rcaloras's bash_preexec framework](https://github.com/rcaloras/bash-preexec). Définissez simplement les tableaux `preexec_functions` et `precmd_functions` avant d'exécuter `eval $(starship init $0)`, puis procédez comme d'habitude.
Bash users who need preexec-like functionality can use [rcaloras's bash_preexec framework](https://github.com/rcaloras/bash-preexec). Simply define the arrays `preexec_functions` and `precmd_functions` before running `eval $(starship init $0)`, and then proceed as normal.
### Options
@ -834,11 +841,11 @@ format = 'underwent [$duration](bold yellow)'
## Conda
Le module `conda` affiche l’environnement [Conda](https://docs.conda.io/en/latest/) courant, si `$CONDA_DEFAULT_ENV` est définie.
The `conda` module shows the current [Conda](https://docs.conda.io/en/latest/) environment, if `$CONDA_DEFAULT_ENV` is set.
::: tip
Cela ne supprime pas le modificateur d'invite de conda, vous pourriez vouloir exécuter `conda config --set changeps1 False` pour le désactiver.
This does not suppress conda's own prompt modifier, you may want to run `conda config --set changeps1 False`.
:::
@ -874,7 +881,7 @@ format = '[$symbol$environment](dimmed green) '
## Conteneur
Le module `container` affiche un symbole et le nom du conteneur, si vous êtes dans un conteneur.
The `container` module displays a symbol and container name, if inside a container.
### Options
@ -906,7 +913,7 @@ format = '[$symbol \[$name\]]($style) '
## Crystal
Le module `crystal` affiche la version de [Crystal](https://crystal-lang.org/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `crystal` module shows the currently installed version of [Crystal](https://crystal-lang.org/). By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier `shard.yml`
- Le dossier courant contient un fichier `.cr`
@ -945,7 +952,7 @@ format = 'via [✨ $version](bold blue) '
## Daml
The `daml` module shows the currently used [Daml](https://www.digitalasset.com/developers) SDK version when you are in the root directory of your Daml project. The `sdk-version` in the `daml.yaml` file will be used, unless it's overridden by the `DAML_SDK_VERSION` environment variable. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `daml` module shows the currently used [Daml](https://www.digitalasset.com/developers) SDK version when you are in the root directory of your Daml project. The `sdk-version` in the `daml.yaml` file will be used, unless it's overridden by the `DAML_SDK_VERSION` environment variable. By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier `daml.yaml`
@ -983,7 +990,7 @@ format = 'via [D $version](bold bright-green) '
## Dart
Le module `dart` affiche la version de [Dart](https://dart.dev/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `dart` module shows the currently installed version of [Dart](https://dart.dev/). By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier avec l’extension `.dart`
- Le dossier courant contient un fichier `.dart_tool`
@ -1023,7 +1030,7 @@ format = 'via [🔰 $version](bold red) '
## Deno
Le module `deno` affiche la version de [Deno](https://deno.land/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `deno` module shows you your currently installed version of [Deno](https://deno.land/). By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier `deno.json`, `deno.jsonc`, `mod.ts`, `mod.js`, `deps.ts` ou `deps.js`
@ -1059,11 +1066,11 @@ format = 'via [🦕 $version](green bold) '
## Dossier
Le module `directory` affiche le chemin du dossier courant, tronqué à 3 dossiers parents. Votre dossier sera également tronqué à la racine du repo git dans lequel vous vous trouvez actuellement.
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.
When using the `fish_style_pwd_dir_length` option, instead of hiding the path that is truncated, you will see a shortened name of each directory based on the number you enable for the option.
Par exemple, `~/Dev/Nix/nixpkgs/pkgs` où `nixpkgs` est la racine du repo, et l'option définie à `1`. Vous verrez maintenant `~/D/N/nixpkgs/pkgs`, alors que vous auriez vu `nixpkgs/pkgs` avant.
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`.
### Options
@ -1084,7 +1091,7 @@ Par exemple, `~/Dev/Nix/nixpkgs/pkgs` où `nixpkgs` est la racine du repo, et l'
| `use_os_path_sep` | `true` | Utiliser le séparateur de chemin du système d’exploitation au lieu de toujours utiliser `/` (par ex. `\` sous Windows) |
<details>
<summary>Ce module possède quelques options de configuration avancées qui contrôlent l'affichage du répertoire.</summary>
<summary>This module has a few advanced configuration options that control how the directory is displayed.</summary>
| Options avancées | Défaut | Description |
| --------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@ -1092,7 +1099,7 @@ Par exemple, `~/Dev/Nix/nixpkgs/pkgs` où `nixpkgs` est la racine du repo, et l'
| `fish_style_pwd_dir_length` | `0` | Le nombre de caractères à utiliser lors de l'application de la logique de troncature du pwd de fish. |
| `use_logical_path` | `true` | Si `true` affiche le chemin logique issu du shell via `PWD` ou `--logical-path`. Si `false` renvoie plutôt le chemin du système de fichiers physique avec les liens symboliques résolus. |
`substitutions` vous permet de définir des remplacements arbitraires pour les chaînes littérales qui apparaissent dans le chemin, par exemple pour de longs préfixes de réseau ou des répertoires de développement (ex. Java). Notez que cela désactivera la PWD de style fish.
`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]
@ -1100,7 +1107,7 @@ Par exemple, `~/Dev/Nix/nixpkgs/pkgs` où `nixpkgs` est la racine du repo, et l'
'src/com/long/java/path' = 'mypath'
```
`fish_style_pwd_dir_leng` interagit avec les options de troncature d'une manière qui peut être surprenante au début : si elle n'est pas nulle, les composantes du chemin qui seraient normalement tronquées sont affichées à la place avec autant de caractères. For example, the path `/built/this/city/on/rock/and/roll`, which would normally be displayed 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. Pour `fish_style_pwd_dir_length = 2`, ce serait `/bu/th/ci/on/rock/and/roll`.
`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 `rock/and/roll`, would be displayed as `/b/t/c/o/rock/and/roll` with `fish_style_pwd_dir_length = 1`--the path components that would normally be removed are displayed with a single character. For `fish_style_pwd_dir_length = 2`, it would be `/bu/th/ci/on/rock/and/roll`.
</details>
@ -1114,9 +1121,9 @@ Par exemple, `~/Dev/Nix/nixpkgs/pkgs` où `nixpkgs` est la racine du repo, et l'
*: Cette variable peut uniquement être utilisée dans une chaine de style
<details>
<summary>Les dépôts Git peuvent avoir des variables additionnelles.</summary>
<summary>The git repos have additional variables.</summary>
Considérons le chemin `/path/to/home/git_repo/src/lib`
Let us consider the path `/path/to/home/git_repo/src/lib`
| Variable | Exemple | Description |
| ------------------ | --------------------- | --------------------------------------- |
@ -1140,7 +1147,7 @@ truncation_symbol = '…/'
## Contexte Docker
Le module `docker_context` affiche le [context Docker](https://docs.docker.com/engine/context/working-with-contexts/) actif, si sa valeur est différente de `default` ou si les variables d’environnement `DOCKER_MACHINE_NAME`, `DOCKER_HOST` ou `DOCKER_CONTEXT` sont définies (puisqu’elles sont utilisées pour changer le contexte utilisé).
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` or if the `DOCKER_MACHINE_NAME`, `DOCKER_HOST` or `DOCKER_CONTEXT` environment variables are set (as they are meant to override the context in use).
### Options
@ -1176,9 +1183,9 @@ format = 'via [🐋 $context](blue bold)'
## Dotnet
Le module `dotnet` montre la version pertinente du [SDK .NET Core](https://dotnet.microsoft.com/) pour le répertoire courant. Si le SDK a été épinglé dans le répertoire courant, la version épinglée est affichée. Sinon, le module affiche la dernière version installée du SDK.
The `dotnet` module shows the relevant version of the [.NET Core SDK](https://dotnet.microsoft.com/) 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.
Par défaut, ce module ne sera affiché dans votre invite que lorsqu'un ou plusieurs des fichiers suivants sont présents dans le répertoire courant :
By default this module will only be shown in your prompt when one or more of the following files are present in the current directory:
- `global.json`
- `project.json`
@ -1189,11 +1196,11 @@ Par défaut, ce module ne sera affiché dans votre invite que lorsqu'un ou plusi
- `*.fsproj`
- `*.xproj`
Vous aurez également besoin du SDK .NET Core pour pouvoir l'utiliser correctement.
You'll also need the .NET Core SDK installed in order to use it correctly.
En interne, ce module utilise son propre mécanisme de détection de version. Généralement, il est deux fois plus rapide que d'exécuter `dotnet --version`, mais il peut afficher une version incorrecte si votre projet .NET a une arborescence inhabituelle. Si la précision est plus importante que la vitesse, vous pouvez désactiver le mécanisme en définissant `heuristic = false` dans les options du module.
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.
Le module affichera aussi le Moniker de Framework Cible (<https://docs.microsoft.com/en-us/dotnet/standard/frameworks#supported-target-frameworks>) quand il y a un fichier `.csproj` dans le dossier courant.
The module will also show the Target Framework Moniker (<https://docs.microsoft.com/en-us/dotnet/standard/frameworks#supported-target-frameworks>) when there is a `.csproj` file in the current directory.
### Options
@ -1233,7 +1240,7 @@ heuristic = false
## Elixir
Le module `elixir` affiche la version de [Elixir](https://elixir-lang.org/) et [Erlang/OTP](https://erlang.org/doc/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `elixir` module shows the currently installed version of [Elixir](https://elixir-lang.org/) and [Erlang/OTP](https://erlang.org/doc/). By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier `mix.exs`.
@ -1272,7 +1279,7 @@ symbol = '🔮 '
## Elm
Le module `elm` affiche la version de [Elm](https://elm-lang.org/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `elm` module shows the currently installed version of [Elm](https://elm-lang.org/). By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier `elm.json`
- Le dossier courant contient un fichier `elm-package.json`
@ -1314,7 +1321,7 @@ format = 'via [ $version](cyan bold) '
## Variable d'environnement
Le module `env_var` affiche la valeur actuelle de la variable d’environnement choisie. Le module sera affiché si l'une de ces conditions est remplie:
The `env_var` module displays the current value of a selected environment variables. The module will be shown only if any of the following conditions are met:
- L'option `variable` correspond à une variable d'environnement existante
- L'option `variable` n'est pas définie, mais l'option `default` l'est
@ -1327,9 +1334,9 @@ The order in which env_var modules are shown can be individually set by includin
::: tip
Plusieurs variables d’environnement peuvent être affichées en utilisant un `.`. (voir exemple). Si l’option de configuration `variable` n’est pas définie, le module affichera la valeur de la variable dont le nom est le texte après le caractère `.`.
Multiple environmental variables can be displayed by using a `.`. (see example) If the `variable` configuration option is not set, the module will display value of variable under the name of text after the `.` character.
Exemple : la configuration suivante va afficher la valeur de la variable d’environnement UTILISATEUR
Example: following configuration will display value of USER environment variable
```toml
# ~/.config/starship.toml
@ -1371,7 +1378,7 @@ variable = 'SHELL'
default = 'unknown shell'
```
Afficher plusieurs variables d’environnement:
Displaying multiple environmental variables:
```toml
# ~/.config/starship.toml
@ -1385,7 +1392,7 @@ default = 'unknown user'
## Erlang
Le module `erlang` affiche la version de [Erlang/OTP](https://erlang.org/doc/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `erlang` module shows the currently installed version of [Erlang/OTP](https://erlang.org/doc/). By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier `rebar.config`.
- Le dossier courant contient un fichier `erlang.mk`.
@ -1424,7 +1431,7 @@ format = 'via [e $version](bold red) '
## Fennel
The `fennel` module shows the currently installed version of [Fennel](https://fennel-lang.org). Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `fennel` module shows the currently installed version of [Fennel](https://fennel-lang.org). By default the module will be shown if any of the following conditions are met:
- The current directory contains a file with the `.fnl` extension
@ -1462,7 +1469,7 @@ symbol = '⫰ '
## Remplissage
Le module `fill` remplit l’espace restant sur la ligne avec un symbole. Si plusieurs modules `fill` sont présents sur une ligne, ils divisent de manière égale l’espace entre eux. C’est utile pour aligner d’autres modules.
The `fill` module fills any extra space on the line with a symbol. If multiple `fill` modules are present in a line they will split the space evenly between them. This is useful for aligning other modules.
### Options
@ -1483,7 +1490,7 @@ symbol = '-'
style = 'bold green'
```
Produit une invite qui ressemble à :
Produces a prompt that looks like:
```
AA -------------------------------------------- BB -------------------------------------------- CC
@ -1562,7 +1569,7 @@ format = '[+$added]($added_style)/[-$deleted]($deleted_style) '
## Google Cloud (`gcloud`)
Le module `gcloud` affiche la version de la commande [`gcloud`](https://cloud.google.com/sdk/gcloud) installée. Ceci est basé sur les fichiers `~/.config/gcloud/active_config` et `~/.config/gcloud/configurations/config_{CONFIG NAME}` et la variable d'environnement `CLOUDSDK_CONFIG`.
The `gcloud` module shows the current configuration for [`gcloud`](https://cloud.google.com/sdk/gcloud) CLI. This is based on the `~/.config/gcloud/active_config` file and the `~/.config/gcloud/configurations/config_{CONFIG NAME}` file and the `CLOUDSDK_CONFIG` env var.
When the module is enabled it will always be active, unless `detect_env_vars` has been set in which case the module will only be active be active when one of the environment variables has been set.
@ -1638,7 +1645,7 @@ very-long-project-name = 'vlpn'
## Branche Git
Le module `git_branch` affiche la branche active du dépôt dans le dossier courant.
The `git_branch` module shows the active branch of the repo in your current directory.
### Options
@ -1680,7 +1687,7 @@ ignore_branches = ['master', 'main']
## Commit Git
Le module `git_commit` affiche le hash du commit courant et l’étiquette (s’il y en a) du dépôt dans le dossier courant.
The `git_commit` module shows the current commit hash and also the tag (if any) of the repo in your current directory.
### Options
@ -1717,7 +1724,7 @@ tag_symbol = '🔖 '
## État Git
Le module `git_state` s'affichera dans les répertoires qui font partie d'un dépôt git, dans lesquels une opération est en cours, comme : _REBASING_, _BISECTING_, etc. S'il y a des informations de progression (par exemple, REBASING 3/10), ces informations seront également affichées.
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.
### Options
@ -1757,11 +1764,11 @@ cherry_pick = '[🍒 PICKING](bold red)'
## Métriques Git
Le module `git_metrics` affiche le nombre de lignes ajoutées et supprimées dans le dépôt Git courant.
The `git_metrics` module will show the number of added and deleted lines in the current git repository.
::: tip
Ce module est désactivé par défaut. Pour l'activer, configurez `disabled` sur `false` dans votre fichier de configuration.
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
:::
@ -1799,11 +1806,11 @@ format = '[+$added]($added_style)/[-$deleted]($deleted_style) '
## Statut Git
Le module `git_status` affiche des symboles représentant l’état du dépôt dans le dossier courant.
The `git_status` module shows symbols representing the state of the repo in your current directory.
::: tip
Le module Statut Git est très lent dans les dossiers Windows (par exemple sous `/mnt/c/`) dans un environnement WSL. Vous pouvez désactiver le module ou utiliser l’option `windows_starship` pour utiliser un exécutable Starship natif pour calculer le `git_status` pour ces chemins.
The Git Status module is very slow in Windows directories (for example under `/mnt/c/`) when in a WSL environment. You can disable the module or use the `windows_starship` option to use a Windows-native Starship executable to compute `git_status` for those paths.
:::
@ -1831,7 +1838,7 @@ Le module Statut Git est très lent dans les dossiers Windows (par exemple sous
### Variables
Les variables suivantes peuvent être utilisées pour la valeur de `format`:
The following variables can be used in `format`:
| Variable | Description |
| -------------- | --------------------------------------------------------------------------------------------------------------------- |
@ -1849,14 +1856,14 @@ Les variables suivantes peuvent être utilisées pour la valeur de `format`:
*: Cette variable peut uniquement être utilisée dans une chaine de style
Les variables suivantes peuvent être utilisées pour la valeur de `diverged`:
The following variables can be used in `diverged`:
| Variable | Description |
| -------------- | ------------------------------------------------- |
| `ahead_count` | Nombre de commits en avance sur la branche suivie |
| `behind_count` | Nombre de commits en retard sur la branche suivie |
Les variables suivantes peuvent êtres utilisées dans `conflicted`, `ahead`, `behind`, `untracked`, `stashed`, `modified`, `staged`, `renamed` et `deleted`:
The following variables can be used in `conflicted`, `ahead`, `behind`, `untracked`, `stashed`, `modified`, `staged`, `renamed` and `deleted`:
| Variable | Description |
| -------- | --------------------------------------- |
@ -1881,7 +1888,7 @@ renamed = '👅'
deleted = '🗑'
```
Afficher le nombre de commits en avance/en retard par rapport à la branche suivie
Show ahead/behind count of the branch being tracked
```toml
# ~/.config/starship.toml
@ -1892,7 +1899,7 @@ diverged = '⇕⇡${ahead_count}⇣${behind_count}'
behind = '⇣${count}'
```
Utiliser un exécutable Starship Windows pour les chemins Windows dans WSL
Use Windows Starship executable on Windows paths in WSL
```toml
# ~/.config/starship.toml
@ -1903,7 +1910,7 @@ windows_starship = '/mnt/c/Users/username/scoop/apps/starship/current/starship.e
## Go
Le module `golang` affiche la version de [Go](https://golang.org/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `golang` module shows the currently installed version of [Go](https://golang.org/). By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier `go.mod`
- Le dossier courant contient un fichier `go.sum`
@ -1994,7 +2001,7 @@ format = 'via [🐂](yellow bold) '
The `gradle` module shows the version of the [Gradle Wrapper](https://docs.gradle.org/current/userguide/gradle_wrapper.html) currently used in the project directory.
Par défaut, le module sera affiché si l’une de ces conditions est remplie:
By default the module will be shown if any of the following conditions are met:
- The current directory contains a `gradle/wrapper/gradle-wrapper.properties` directory.
- The current directory contains a file ending with `.gradle` or `.gradle.kts`.
@ -2027,9 +2034,9 @@ The `gradle` module is only able to read your Gradle Wrapper version from your c
## Haskell
Le module `haskell` affiche la version de GHC et/ou l’instantané Stack sélectionnée.
The `haskell` module finds the current selected GHC version and/or the selected Stack snapshot.
Par défaut, le module sera affiché si l’une de ces conditions est remplie:
By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier `stack.yaml`
- Le dossier courant contient un fichier `.hs`, `.cabal` ou `.hs-boot`
@ -2060,7 +2067,7 @@ Par défaut, le module sera affiché si l’une de ces conditions est remplie:
## Haxe
The `haxe` module shows the currently installed version of [Haxe](https://haxe.org/). Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `haxe` module shows the currently installed version of [Haxe](https://haxe.org/). By default the module will be shown if any of the following conditions are met:
- The current directory contains a `project.xml`, `Project.xml`, `application.xml`, `haxelib.json`, `hxformat.json` or `.haxerc` file
- The current directory contains a `.haxelib` or a `haxe_libraries` directory
@ -2100,7 +2107,7 @@ format = "via [⌘ $version](bold fg:202) "
## Helm
Le module `helm` affiche la version de [Helm](https://helm.sh/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `helm` module shows the currently installed version of [Helm](https://helm.sh/). By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier `helmfile.yaml`
- Le dossier courant contient un fichier `Chart.yaml`
@ -2139,7 +2146,7 @@ format = 'via [⎈ $version](bold white) '
## Nom d'hôte
Le module `hostname` affiche le nom d’hôte du système system.
The `hostname` module shows the system hostname.
### Options
@ -2190,7 +2197,7 @@ disabled = false
## Java
Le module `java` affiche la version de [Java](https://www.oracle.com/java/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `java` module shows the currently installed version of [Java](https://www.oracle.com/java/). By default the module will be shown if any of the following conditions are met:
- The current directory contains a `pom.xml`, `build.gradle.kts`, `build.sbt`, `.java-version`, `deps.edn`, `project.clj`, `build.boot`, or `.sdkmanrc` file
- Le dossier courant contient un fichier avec l’extension `.java`, `.class`, `.gradle`, `.jar`, `.clj` ou `.cljc`
@ -2229,9 +2236,9 @@ symbol = '🌟 '
## Jobs
Le module `jobs` affiche le nombre de tâches en cours. Le module ne sera affiché que s'il y a des tâches de fond. Le module affichera le nombre de tâches en cours d’exécution s’il y en a au moins 2, ou plus que la valeur `threshold`, si elle existe. Le monde affichera un symbole s’il y a au moins 1 tâche, ou plus que la valeur de `symbol_threshold`, si elle existe. Vous pouvez définir les deux valeurs à 0 pour _toujours_ montrer le symbole et le nombre de tâches, même s’il n’y a aucune tâche en cours d’exécution.
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 are at least 2 jobs, or more than the `number_threshold` config value, if it exists. The module will show a symbol if there is at least 1 job, or more than the `symbol_threshold` config value, if it exists. You can set both values to 0 in order to _always_ show the symbol and number of jobs, even if there are 0 jobs running.
Le fonctionnement par défaut est:
The default functionality is:
- 0 tâche -> Rien n’est affiché.
- 1 tâche -> `symbol` est affiché.
@ -2239,13 +2246,13 @@ Le fonctionnement par défaut est:
::: warning
Ce module n'est pas pris en charge sur tcsh et nu.
This module is not supported on tcsh and nu.
:::
::: warning
L’option `threshold` est dépréciée, mais si vous voulez l’utiliser, le module affichera le nombre de tâches en cours s’il y a plus d'une tâche, ou plus que la valeur de `threshold`, si elle existe. Si `threshold` est définie à 0, alors le module s'affichera également lorsqu'il n'y a pas de tâches de fond en cours.
The `threshold` option is deprecated, but if you want to use it, 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. If `threshold` is set to 0, then the module will also show when there are 0 jobs running.
:::
@ -2261,7 +2268,7 @@ L’option `threshold` est dépréciée, mais si vous voulez l’utiliser, le mo
| `style` | `'bold blue'` | Le style pour le module. |
| `disabled` | `false` | Désactive le module `jobs`. |
*: Cette option is dépréciée, utilisez les options `number_threshold` et `symbol_threshold` à la place.
*: This option is deprecated, please use the `number_threshold` and `symbol_threshold` options instead.
### Variables
@ -2286,7 +2293,7 @@ symbol_threshold = 0
## Julia
Le module `julia` affiche la version de [Julia](https://julialang.org/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `julia` module shows the currently installed version of [Julia](https://julialang.org/). By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier `Project.toml`
- Le dossier courant contient un fichier `Manifest.toml`
@ -2326,7 +2333,7 @@ symbol = '∴ '
## Kotlin
Le module `kotlin` affiche la version de [Kotlin](https://kotlinlang.org/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `kotlin` module shows the currently installed version of [Kotlin](https://kotlinlang.org/). By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier `.kt` ou `.kts`
@ -2373,11 +2380,11 @@ kotlin_binary = 'kotlinc'
## Kubernetes
Afficher le nom du [contexte Kubernetes](https://kubernetes.io/docs/concepts/configuration/organize-cluster-access-kubeconfig/#context) courant, et, si défini, l’espace de nom, l’utilisateur, et le cluster depuis le fichier kubeconfig. L'espace de noms doit être défini dans le fichier kubeconfig, ce qui peut être fait via `kubectl config set-context starship-cluster --namespace astronaut`. Similarly, the user and cluster can be set with `kubectl config set-context starship-context --user starship-user` and `kubectl config set-context starship-context --cluster starship-cluster`. Si la variable d'environnement `$KUBECONFIG` est définie, le module l'utilisera, sinon il utilisera le fichier `~/.kube/config`.
Displays the current [Kubernetes context](https://kubernetes.io/docs/concepts/configuration/organize-cluster-access-kubeconfig/#context) name and, if set, the namespace, user and cluster from the kubeconfig file. The namespace needs to be set in the kubeconfig file, this can be done via `kubectl config set-context starship-context --namespace astronaut`. Similarly, the user and cluster can be set with `kubectl config set-context starship-context --user starship-user` and `kubectl config set-context starship-context --cluster starship-cluster`. If the `$KUBECONFIG` env var is set the module will use that if not it will use the `~/.kube/config`.
::: tip
Ce module est désactivé par défaut. Pour l'activer, configurez `disabled` sur `false` dans votre fichier de configuration.
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
When the module is enabled it will always be active, unless any of `detect_extensions`, `detect_files` or `detect_folders` have been set in which case the module will only be active in directories that match those conditions.
@ -2489,7 +2496,7 @@ context_alias = "gke-$cluster"
## Saut de ligne
Le module `line_break` sépare l'invite en deux lignes.
The `line_break` module separates the prompt into two lines.
### Options
@ -2508,7 +2515,7 @@ disabled = true
## IP locale
Le module `localip` affiche l’adresse IPv4 de l’interface réseau principale.
The `localip` module shows the IPv4 address of the primary network interface.
### Options
@ -2541,7 +2548,7 @@ disabled = false
## Lua
Le module `lua` affiche la version de [Lua](http://www.lua.org/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `lua` module shows the currently installed version of [Lua](http://www.lua.org/). By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier `.lua-version`
- Le dossier courant contient un dossier `lua`
@ -2582,13 +2589,13 @@ format = 'via [🌕 $version](bold blue) '
## Utilisation mémoire
Le module `memory_usage` affiche la mémoire système actuelle et l'utilisation de swap.
The `memory_usage` module shows current system memory and swap usage.
Par défaut, l'utilisation du swap est affichée si le swap total du système n'est pas nul.
By default the swap usage is displayed if the total system swap is non-zero.
::: tip
Ce module est désactivé par défaut. Pour l'activer, configurez `disabled` sur `false` dans votre fichier de configuration.
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
:::
@ -2613,7 +2620,7 @@ Ce module est désactivé par défaut. Pour l'activer, configurez `disabled` sur
| symbole | `🐏` | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` |
*: Cette variable peut uniquement être utilisée dans une chaine de style *\*: Les informations sur le fichier SWAP est uniquement affichée si détectée sur le système courant
*: This variable can only be used as a part of a style string *\*: The SWAP file information is only displayed if detected on the current system
### Exemple
@ -2705,7 +2712,7 @@ truncation_symbol = ''
## Nim
Le module `nim` affiche la version de [Nim](https://nim-lang.org/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `nim` module shows the currently installed version of [Nim](https://nim-lang.org/). By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier `nim.cfg`
- Le dossier courant contient un fichier avec l’extension `.nim`
@ -2747,7 +2754,7 @@ symbol = '🎣 '
## Nix-shell
Le module `nix_shell` affiche la version de l’environnement [nix-shell](https://nixos.org/guides/nix-pills/developing-with-nix-shell.html). Ce module s’affichera quand vous serez à l’intérieur d’un environnement nix-shell.
The `nix_shell` module shows the [nix-shell](https://nixos.org/guides/nix-pills/developing-with-nix-shell.html) environment. The module will be shown when inside a nix-shell environment.
### Options
@ -2788,7 +2795,7 @@ format = 'via [☃️ $state( \($name\))](bold blue) '
## Node.js
Le module `nodejs` affiche la version de [Node.js](https://nodejs.org/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `nodejs` module shows the currently installed version of [Node.js](https://nodejs.org/). By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier `package.json`
- Le dossier courant contient un fichier `.node-version`
@ -2833,7 +2840,7 @@ format = 'via [🤖 $version](bold green) '
## OCaml
Le module `ocaml` affiche la version de [OCaml](https://ocaml.org/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `ocaml` module shows the currently installed version of [OCaml](https://ocaml.org/). By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier avec l’extension `.opam` ou un dossier `_opam`
- Le répertoire courant contient un répertoire `esy.lock`
@ -2961,7 +2968,7 @@ The [os_info](https://lib.rs/crates/os_info) crate used by this module is known
::: tip
Ce module est désactivé par défaut. Pour l'activer, configurez `disabled` sur `false` dans votre fichier de configuration.
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
:::
@ -3107,7 +3114,7 @@ format = 'via [🎁 $version](208 bold) '
## Perl
Le module `perl` affiche la version de [Perl](https://www.perl.org/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `perl` module shows the currently installed version of [Perl](https://www.perl.org/). By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier `Makefile.PL` ou `Build.PL`
- Le dossier courant contient un fichier `cpanfile` ou `cpanfile.snapshot`
@ -3147,7 +3154,7 @@ format = 'via [🦪 $version]($style) '
## PHP
Le module `php` affiche la version de [PHP](https://www.php.net/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `php` module shows the currently installed version of [PHP](https://www.php.net/). By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier `composer.json`
- Le dossier courant contient un fichier `.php-version`
@ -3206,11 +3213,11 @@ The `pulumi` module shows the current username, selected [Pulumi Stack](https://
::: tip
Par défaut, la version de Pulumi n'est pas affichée, car cela prendre un ordre de magnitude plus de temps à charger que la plupart des plugins (~70ms). Si vous voulez quand même l’activer, [suivez l’exemple montré plus bas](#with-pulumi-version).
By default the Pulumi version is not shown, since it takes an order of magnitude longer to load then most plugins (~70ms). If you still want to enable it, [follow the example shown below](#with-pulumi-version).
:::
Par défaut, le module sera affiché si l’une de ces conditions est remplie:
By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient soit un `Pulumi.yaml`, soit un `Pulumi.yml`
- A parent directory contains either `Pulumi.yaml` or `Pulumi.yml` unless `search_upwards` is set to `false`
@ -3260,7 +3267,7 @@ format = '[$symbol$stack]($style) '
## PureScript
Le module `purescript` affiche la version de [PureScript](https://www.purescript.org/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `purescript` module shows the currently installed version of [PureScript](https://www.purescript.org/) version. By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier `spago.dhall`
- Le dossier courant contient un fichier avec l’extension `.purs`
@ -3299,11 +3306,11 @@ format = 'via [$symbol$version](bold white)'
## Python
Le module `python` affiche la version de [Python](https://www.python.org/) installée et l’[environnement virtual Python](https://docs.python.org/tutorial/venv.html) actif s’il y en a un.
The `python` module shows the currently installed version of [Python](https://www.python.org/) and the current [Python virtual environment](https://docs.python.org/tutorial/venv.html) if one is activated.
Si `pyenv_version_name` est défini à `true`, il affichera le nom de la version de pyenv. Sinon, il affichera le numéro de version que donne `python --version`.
If `pyenv_version_name` is set to `true`, it will display the pyenv version name. Otherwise, it will display the version number from `python --version`.
Par défaut, le module sera affiché si l’une de ces conditions est remplie:
By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier `.python-version`
- Le dossier courant contient un fichier `Pipfile`
@ -3333,7 +3340,7 @@ Par défaut, le module sera affiché si l’une de ces conditions est remplie:
::: tip
La variable `python_binary` accepte soit une chaine, soit une liste de chaines de caractères. Starship essayera d'exécuter chaque binaire jusqu'à obtenir un résultat. Notez que vous ne pouvez modifier que le binaire que Starship exécute pour obtenir la version de Python, mais pas les arguments utilisés.
The `python_binary` variable accepts either a string or a list of strings. Starship will try executing each binary until it gets a result. Note you can only change the binary that Starship executes to get the version of Python not the arguments that are used.
The default values and order for `python_binary` was chosen to first identify the Python version in a virtualenv/conda environments (which currently still add a `python`, no matter if it points to `python3` or `python2`). This has the side effect that if you still have a system Python 2 installed, it may be picked up before any Python 3 (at least on Linux Distros that always symlink `/usr/bin/python` to Python 2). If you do not work with Python 2 anymore but cannot remove the system Python 2, changing this to `'python3'` will hide any Python version 2, see example below.
@ -3389,7 +3396,7 @@ python_binary = ['./venv/bin/python', 'python', 'python3', 'python2']
## R
Le module `rlang` affiche la version de [R](https://www.r-project.org/) installée. Le module sera affiché si l'une de ces conditions est remplie:
The `rlang` module shows the currently installed version of [R](https://www.r-project.org/). The module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier avec l’extension `.R`.
- Le dossier courant contient un fichier avec l’extension `.Rd`.
@ -3431,7 +3438,7 @@ format = 'with [📐 $version](blue bold) '
## Raku
The `raku` module shows the currently installed version of [Raku](https://www.raku.org/). Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `raku` module shows the currently installed version of [Raku](https://www.raku.org/). By default the module will be shown if any of the following conditions are met:
- The current directory contains a `META6.json` file
- The current directory contains a `.p6`, `.pm6`, `.raku`, `.rakumod` or `.pod6`
@ -3469,7 +3476,7 @@ format = 'via [🦪 $version]($style) '
## Red
Par défaut, le module `red` affiche la version de [Red](https://www.red-lang.org/) installée. Le module sera affiché si l'une de ces conditions est remplie:
By default the `red` module shows the currently installed version of [Red](https://www.red-lang.org/). The module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier avec l’extension `.red` ou `.reds`
@ -3507,14 +3514,14 @@ symbol = '🔴 '
## Ruby
Le module `ruby` affiche la version de [Ruby](https://www.ruby-lang.org/) installée. Le module sera affiché si l'une de ces conditions est remplie:
By default the `ruby` module shows the currently installed version of [Ruby](https://www.ruby-lang.org/). The module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier `Gemfile`
- Le dossier courant contient un fichier `.ruby-version`
- Le dossier courant contient un fichier `.rb`
- La variable d’environnement `RUBY_VERSION` ou `RBENV_VERSION` est définie
Starship obtient la version actuelle de Ruby en exécutant `ruby -v`.
Starship gets the current Ruby version by running `ruby -v`.
### Options
@ -3551,7 +3558,7 @@ symbol = '🔺 '
## Rust
Le module `rust` affiche la version de [Rust](https://www.rust-lang.org/) installée. Le module sera affiché si l'une de ces conditions est remplie:
By default the `rust` module shows the currently installed version of [Rust](https://www.rust-lang.org/). The module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier `Cargo.toml`
- Le dossier courant contient un fichier avec l’extension `.rs`
@ -3592,7 +3599,7 @@ format = 'via [⚙️ $version](red bold)'
## Scala
Le module `scale` affiche la version de [Scala](https://www.scala-lang.org/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `scala` module shows the currently installed version of [Scala](https://www.scala-lang.org/). By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier `build.sbt`, `.scalaenv` ou `.sbtenv`
- Le dossier courant contient un fichier avec l’extension `.scala` ou `.sbt`
@ -3632,11 +3639,11 @@ symbol = '🌟 '
## Shell
Le module `shell` affiche un indicateur en fonction du shell actuellement utilisé.
The `shell` module shows an indicator for currently used shell.
::: tip
Ce module est désactivé par défaut. Pour l'activer, configurez `disabled` sur `false` dans votre fichier de configuration.
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
:::
@ -3734,7 +3741,7 @@ threshold = 0
## Singularity
Le module `singularity` affiche l’image [Singularity](https://sylabs.io/singularity/) courante, quand vous êtes à l’intérieur d’un conteneur et que `$SINGULARITY_NAME` est définie.
The `singularity` module shows the current [Singularity](https://sylabs.io/singularity/) image, if inside a container and `$SINGULARITY_NAME` is set.
### Options
@ -3804,7 +3811,7 @@ format = "via [S $version](blue bold)"
## Spack
Le module `spack` affiche l’environnement [Spack](https://spack.readthedocs.io/en/latest/) courant, si `$SPACK_ENV` est définie.
The `spack` module shows the current [Spack](https://spack.readthedocs.io/en/latest/) environment, if `$SPACK_ENV` is set.
### Options
@ -3837,11 +3844,11 @@ format = '[$symbol$environment](dimmed blue) '
## Statut
Le module `status` affiche le code de sortie de la commande précédente. Si $success_symbol est vide (par défaut), ce module sera affiché uniquement quand le code de sortie n’est pas `0`. Le code de statut est converti en entier signé 32 bits.
The `status` module displays the exit code of the previous command. If $success_symbol is empty (default), the module will be shown only if the exit code is not `0`. The status code will cast to a signed 32-bit integer.
::: tip
Ce module est désactivé par défaut. Pour l'activer, configurez `disabled` sur `false` dans votre fichier de configuration.
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
:::
@ -3898,11 +3905,11 @@ disabled = false
## Sudo
Le moduel `sudo` affiche si les identifiants sudo sont actuellement en cache. Le module sera uniquement affiché si les identifiants sont en cache.
The `sudo` module displays if sudo credentials are currently cached. The module will only be shown if credentials are cached.
::: tip
Ce module est désactivé par défaut. Pour l'activer, configurez `disabled` sur `false` dans votre fichier de configuration.
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
:::
@ -3947,7 +3954,7 @@ disabled = false
## Swift
Par défaut, le module `swift` affiche la version de [Swift](https://swift.org/) installée. Le module sera affiché si l'une de ces conditions est remplie:
By default the `swift` module shows the currently installed version of [Swift](https://swift.org/). The module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier `Package.swift`
- Le dossier courant contient un fichier avec l’extension `.swift`
@ -3986,15 +3993,15 @@ format = 'via [🏎 $version](red bold)'
## Terraform
Le module `terraform` affiche [l’espace de travail Terraform](https://www.terraform.io/docs/language/state/workspaces.html) sélectionné et sa version.
The `terraform` module shows the currently selected [Terraform workspace](https://www.terraform.io/docs/language/state/workspaces.html) and version.
::: tip
Par défaut, la version de Terraform n’est pas affichée, car elle est lente pour les versions actuelles de Terraform quand beaucoup de plugins sont utilisés. Si vous voulez quand même l’activer, [suivez l’exemple montré plus bas](#with-terraform-version).
By default the Terraform version is not shown, since this is slow for current versions of Terraform when a lot of plugins are in use. If you still want to enable it, [follow the example shown below](#with-terraform-version).
:::
Par défaut, le module sera affiché si l’une de ces conditions est remplie:
By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient un dossier `.terraform`
- Le dossier courant contient un fichier avec l’extension `.tf`, `.tfplan` ou `.tfstate`
@ -4045,11 +4052,11 @@ format = '[🏎💨 $workspace]($style) '
## Date et Heure
Le module `time` affiche la date et heure **locale**. La valeur de `format` est utilisée par le package [`chrono`](https://crates.io/crates/chrono) pour contrôler la façon dont l'heure est affichée. Consultez la [doc de chrono strftime](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) pour découvrir les options disponibles.
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
Ce module est désactivé par défaut. Pour l'activer, configurez `disabled` sur `false` dans votre fichier de configuration.
This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
:::
@ -4065,7 +4072,7 @@ Ce module est désactivé par défaut. Pour l'activer, configurez `disabled` sur
| `disabled` | `true` | Désactive le module `time`. |
| `time_range` | `'-'` | Définit la plage de temps pendant laquelle le module sera affiché. Les heures doivent être spécifiées au format 24 heures |
If `use_12hr` is `true`, then `time_format` defaults to `'%r'`. Otherwise, it defaults to `'%T'`. Définir manuellement `time_format` outrepasse le paramètre `use_12hr`.
If `use_12hr` is `true`, then `time_format` defaults to `'%r'`. Otherwise, it defaults to `'%T'`. Manually setting `time_format` will override the `use_12hr` setting.
### Variables
@ -4091,7 +4098,7 @@ time_range = '10:00:00-14:00:00'
## Nom d'utilisateur
Le module `username` affiche le nom de l’utilisateur actif. Le module sera affiché si l'une de ces conditions est remplie:
The `username` module shows active user's username. The module will be shown if any of the following conditions are met:
- L'utilisateur courant est root/admin
- L'utilisateur courant est différent de celui connecté
@ -4136,7 +4143,7 @@ show_always = true
## Vagrant
Le module `vagrant` affiche la version de [Vagrant](https://www.vagrantup.com/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `vagrant` module shows the currently installed version of [Vagrant](https://www.vagrantup.com/). By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier `Vagrantfile`
@ -4174,7 +4181,7 @@ format = 'via [⍱ $version](bold white) '
## V
Le module `vlang` affiche la version de [V](https://vlang.io/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:
The `vlang` module shows you your currently installed version of [V](https://vlang.io/). By default the module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier avec l’extension `.v`
- Le dossier courant contient un fichier `v.mod`, `vpkg.json` ou `.vpkg-lock.json`
@ -4242,7 +4249,7 @@ format = '[🆅 $repo](bold blue) '
## Zig
By default the `zig` module shows the currently installed version of [Zig](https://ziglang.org/). Le module sera affiché si l'une de ces conditions est remplie:
By default the `zig` module shows the currently installed version of [Zig](https://ziglang.org/). The module will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier `.zip`
@ -4280,9 +4287,9 @@ symbol = '⚡️ '
## Commandes personnalisées
Les modules `custom` affichent la sortie d’une commande arbitaitre.
The `custom` modules show the output of some arbitrary commands.
Ces modules seront affichés si l'une de ces conditions est remplie:
These modules will be shown if any of the following conditions are met:
- Le dossier courant contient un fichier dont le nom est dans `detect_files`
- Le dossier courant contient un dossier dont le nom est dans `detect_folders`
@ -4292,7 +4299,7 @@ Ces modules seront affichés si l'une de ces conditions est remplie:
::: tip
Plusieurs modules personnalisés peuvent être définis en utilisant un `.`.
Multiple custom modules can be defined by using a `.`.
:::
@ -4348,7 +4355,7 @@ Format strings can also contain shell specific prompt sequences, e.g. [Bash](htt
#### Commandes shell personnalisées
`shell` accepte une liste de chaînes non vide, où:
`shell` accepts a non-empty list of strings, where:
- La première chaîne est le chemin vers le shell à utiliser pour exécuter la commande.
- Other following arguments are passed to the shell.