andrei/starship
1
0
Fork 0
mirror of https://github.com/starship/starship.git synced 2026-06-22 02:02:12 +07:00
Code Issues Packages Projects Releases 10 Wiki Activity

docs(i18n): new Crowdin updates (#4355)

Browse Source
This commit is contained in:
Matan Kushner
2022-10-14 21:53:32 -04:00
committed by GitHub
parent dfc9cf6861
commit 74951e630e
89 changed files with 9214 additions and 2495 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/fr-FR/README.md
+2 -3
View File
@@ -55,11 +55,10 @@ description: Starship est une invite minimaliste, ultra-rapide et hautement pers
```sh
brew install starship
```
Avec [Scoop](https://scoop.sh):
With [Winget](https://github.com/microsoft/winget-cli):
```powershell
scoop install starship
winget install starship
```
1. Ajouter le script d’initialisation au fichier configuration de votre shell:
docs/fr-FR/advanced-config/README.md
+45 -19
View File
@@ -54,6 +54,32 @@ end
load(io.popen('starship init cmd'):read("*a"))()
```
## TransientPrompt and TransientRightPrompt in Fish
It is possible to replace the previous-printed prompt with a custom string. This is useful in cases where all the prompt information is not always needed. To enable this, run `enable_transience` in the shell session. To make it permanent, put this statement in your `~/.config/fish/config.fish`. Transience can be disabled on-the-fly with `disable_transience`.
Note that in case of Fish, the transient prompt is only printed if the commandline is non-empty, and syntactically correct.
- By default, the left side of input gets replaced with a bold-green `❯`. To customize this, define a new function called `starship_transient_prompt_func`. For example, to display Starship's `character` module here, you would do
```fish
function starship_transient_prompt_func
starship module character
end
starship init fish | source
enable_transience
```
- By default, the right side of input is empty. To customize this, define a new function called `starship_transient_rprompt_func`. For example, to display the time at which the last command was started here, you would do
```fish
function starship_transient_rprompt_func
starship module time
end
starship init fish | source
enable_transience
```
## Commandes pré-invite et pré-exécution personnalisées dans Cmd
Clink fournit des APIs extrêmement flexibles pour exécuter des commandes pre-invite et pre-exec dans Cmd. Il est assez simple à utiliser avec Starship. Effectuez les modifications suivantes dans votre fichier `starship.lua`, en fonction de vos besoins:
@@ -78,7 +104,7 @@ end
load(io.popen('starship init cmd'):read("*a"))()
```
## Commandes pré-commande et pré-exécution personnalisées en Bash
## Commandes pré-invite et pré-exécution personnalisées en Bash
Bash n'a pas de structure officielle préexec/précmd comme la plupart des autres shells. C'est pourquoi il est difficile de fournir des hooks entièrement personnalisables dans `bash`. Cependant, Starship vous permet dans une certaine mesure d'insérer vos propres fonctions dans la procédure de rendu du prompt :
@@ -115,9 +141,9 @@ function Invoke-Starship-PreCommand {
}
```
## Modifier le titre des fenêtres
## Changer le titre de la fenêtre
Certaines commandes du shell changeront automatiquement le titre de la fenêtre (par exemple, pour refléter votre répertoire de travail). Fish le fait même par défaut. Starship ne fait pas ça, mais c’est assez facile d’ajouter cette fonctionnalité à `bash`, `zsh`, `cmd` ou `powershell`.
Certaines commandes du shell changeront automatiquement le titre de la fenêtre (par exemple, pour refléter le dossier courant). Fish le fait même par défaut. Starship ne fait pas ça, mais c’est assez facile d’ajouter cette fonctionnalité à `bash`, `zsh`, `cmd` ou `powershell`.
Tout d'abord, définissez une fonction de changement de titre de fenêtre (identique en bash et zsh) :
@@ -143,7 +169,7 @@ precmd_functions+=(set_titre_fenetre)
Si vous aimez le résultat, ajoutez ces lignes à votre fichier de configuration shell (`~/.bashrc` ou `~/.zshrc`) pour le rendre permanent.
Par exemple, si vous voulez afficher votre répertoire actuel dans le titre de l'onglet de votre terminal, ajoutez le code suivant à votre `~/.bashrc` ou `~/.zshrc`:
Par exemple, si vous voulez afficher votre dossier courant dans le titre de l'onglet de votre terminal, ajoutez le code suivant à votre `~/.bashrc` ou `~/.zshrc`:
```bash
function set_win_title(){
@@ -224,32 +250,32 @@ continuation_prompt = "▶▶"
## Chaînes de style
Les chaînes de style sont une liste de mots, séparés par des espaces blancs. Les mots ne sont pas sensibles à la casse (` bold ` et ` boLd ` sont considérés comme la même string). Chaque mot peut être l'un des suivants :
Les chaines de style sont une liste de mots séparés par des espaces. Les mots ne sont pas sensibles à la casse (`bold` et `boLd` sont considérés comme la même chaine). Les mots peuvent être :
- `bold`
- `bold (gras)`
- `italic (italique)`
- `underline`
- `dimmed`
- `inverted`
- `underline (souligné)`
- `dimmed (atténué)`
- `inverted (inversé)`
- `blink`
- `hidden`
- `strikethrough`
- `bg:<couleur>`
- `fg:<couleur>`
- `<couleur>`
- `none`
- `bg:<color> (arrière-plan)`
- `fg:<color> (avant-plan)`
- `<color>`
- `none (aucun)`
où `<color>` est un spécificateur de couleur (discuté ci-dessous). `fg:<color>` et `<color>` font actuellement la même chose, bien que cela puisse changer dans le futur. `inverted` permute les couleurs de fond et de premier plan. L'ordre des mots dans le string n'a pas d'importance.
où `<color>` spécifie une couleur (voir ci-dessous). `fg:<color>` and `<color>` font la même chose actuellement, mais cela pourrait changer dans le futur. `inverted` inverse les couleurs d’arrière-plan et d’avant-plan. L’ordre des mots dans la chaine n’a pas d’importance.
La valeur `none` remplace toutes les autres valeurs si elle n'est pas incluse dans un spécificateur `bg:`, de sorte que par exemple `fg: red none fg:blue` créera une chaîne sans style. `bg:none` définit l'arrière plan sur la couleur par défaut, donc `fg:red bg:none` est équivalent à `red` ou `fg:red` et `bg:green fg:red bg:none` est aussi équivalent à `fg:red` ou `red`. Il peut devenir une erreur d'utiliser `none` en conjonction avec d'autres jetons dans le futur.
La valeur `none` écrase toutes les autres dans une chaine si elle ne fait pas partie d’une déclaration `bg:`, donc par exemple `fg:red none fg:blue` va créer une chaine sans style. `bg:none` définit comme arrière-plan la couleur par défaut donc `fg:red bg:none` équivaut à `red` ou `fg:red` et `bg:green fg:red bg:none` équivaut aussi à `fg:red` or `red`. Cela pourrait devenir une erreur d’utiliser `none` avec d’autres mots dans le futur.
Un spécificateur de couleur peut être l'un des éléments suivants :
Une spécification de couleur peut être :
- Une des couleurs de terminal standard: `black` (noir), `red` (rouge), `green` (vert), `blue` (bleu), `yellow` (jaune), `purple` (violet), `cyan` (cyan), `white` (blanc). Vous pouvez éventuellement les préfixer avec `bright-` pour obtenir la version claire (par exemple `bright-white`).
- Un `#` suivi d'un nombre hexadécimal de six chiffres. Ceci spécifie un [ Code hexadécimal de couleur RVB ](https://www.w3schools.com/colors/colors_hexadecimal.asp).
- Un nombre entre 0 et 255. Ceci spécifie un [code de couleur ANSI 8 bits](https://i.stack.imgur.com/KTSQa.png).
- Un `#` suivi d’un nombre hexadécimal de 6 chiffres. Cela spécifie un [code de couleur RGB hexadécimal](https://www.w3schools.com/colors/colors_hexadecimal.asp).
- Un nombre entre 0 et 255. Cela spécifie un [code couleur ANSI 8-bit](https://i.stack.imgur.com/KTSQa.png).
Si plusieurs couleurs sont spécifiées pour le premier plan/arrière-plan, la dernière dans le string prendra la priorité.
Si plusieurs couleurs sont définies pour l’avant-plan/arrière-plan, la dernière dans le chaine sera prioritaire.
Not every style string will be displayed correctly by every terminal. In particular, the following known quirks exist:
docs/fr-FR/config/README.md
+195 -143
View File
@@ -162,13 +162,15 @@ Voici la liste des options de configuration de l'invite en lui-même.
### Options
| Option | Défaut | Description |
| ----------------- | ------------------------------ | --------------------------------------------------------------------------- |
| `format` | [lien](#default-prompt-format) | Configure le format de l'invite. |
| `right_format` | `""` | Voir [Activer le prompt à droite](/advanced-config/#enable-right-prompt) |
| `scan_timeout` | `30` | Délai d'attente pour que starship scanne les fichiers (en millisecondes). |
| `command_timeout` | `500` | Délai maximal pour les commandes exécutées par starship (en millisecondes). |
| `add_newline` | `true` | Insère une ligne vide entre les invites du shell. |
| Option | Défaut | Description |
| ----------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `format` | [lien](#default-prompt-format) | Configure le format de l'invite. |
| `right_format` | `""` | Voir [Activer le prompt à droite](/advanced-config/#enable-right-prompt) |
| `scan_timeout` | `30` | Délai d'attente pour que starship scanne les fichiers (en millisecondes). |
| `command_timeout` | `500` | Délai maximal pour les commandes exécutées par starship (en millisecondes). |
| `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. |
### Exemple
@@ -184,8 +186,18 @@ format = """
# Attendez 10 millisecondes pour que starship vérifie les fichiers dans le répertoire de travail.
scan_timeout = 10
# Désactive la nouvelle ligne au début de l'invite
# Disable the blank line at the start of the prompt
add_newline = false
# Set "foo" as custom color palette
palette = "foo"
# Define custom colors
[palettes.foo]
# Overwrite existing color
blue = "21"
# Define new color
mustard = "#af8700"
```
### Format par Défaut
@@ -252,6 +264,7 @@ $zig\
$buf\
$nix_shell\
$conda\
$meson\
$spack\
$memory_usage\
$aws\
@@ -431,12 +444,12 @@ La valeur par défaut pour les options `charging_symbol` et `discharging_symbol`
L'option `display` est une array de la table suivante.
| Option | Défaut | Description |
| -------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `threshold` | `10` | La limite supérieure pour l'option d'affichage. |
| `style` | `bold red` | Le style de l'option display si elle est utilisée. |
| `charging_symbol` | `-` | Symbole optionnel affiché si l'option display est utilisée, la valeur par défaut est l'option `charging_symbol` du module "battery". |
| `discharging_symbol` | `-` | Symbole optionnel affiché si l'option display est utilisée, la valeur par défaut est l'option `discharging_symbol` du module "battery". |
| Option | Défaut | Description |
| -------------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------- |
| `threshold` | `10` | La limite supérieure pour l'option d'affichage. |
| `style` | `"red bold"` | Le style de l'option display si elle est utilisée. |
| `charging_symbol` | | Symbole optionnel affiché si l'option display est utilisée, la valeur par défaut est l'option `charging_symbol` du module "battery". |
| `discharging_symbol` | | Symbole optionnel affiché si l'option display est utilisée, la valeur par défaut est l'option `discharging_symbol` du module "battery". |
#### Exemple
@@ -462,24 +475,24 @@ Le module `buf` affiche la version de [Buf](https://buf.build) installée. Par d
### Options
| Option | Défaut | Description |
| ------------------- | ------------------------------------------------------------ | ------------------------------------------------------ |
| `format` | `'with [$symbol($version \(Buf $buf_version\) )]($style)'` | Le format du module `buf`. |
| `version_format` | `"v${raw}"` | Le format de la version. |
| `symbol` | `"🦬 "` | Le symbole utilisé avant d’afficher la version de Buf. |
| `detect_extensions` | `[]` | Quelles extensions devraient activer ce module. |
| `detect_files` | `["buf.yaml", "buf.gen.yaml", "buf.work.yaml"]` | Les fichiers qui activent ce module. |
| `detect_folders` | `[]` | Quels dossiers devraient activer ce module. |
| `style` | `"bold blue"` | Le style du module. |
| `disabled` | `false` | Désactive le module `elixir`. |
| Option | Défaut | Description |
| ------------------- | ----------------------------------------------- | ------------------------------------------------------ |
| `format` | `"with [$symbol($version )]($style)"` | Le format du module `buf`. |
| `version_format` | `"v${raw}"` | Le format de la version. |
| `symbol` | `"🦬 "` | Le symbole utilisé avant d’afficher la version de Buf. |
| `detect_extensions` | `[]` | Quelles extensions devraient activer ce module. |
| `detect_files` | `["buf.yaml", "buf.gen.yaml", "buf.work.yaml"]` | Les fichiers qui activent ce module. |
| `detect_folders` | `[]` | Quels dossiers devraient activer ce module. |
| `style` | `"bold blue"` | Le style du module. |
| `disabled` | `false` | Désactive le module `elixir`. |
### Variables
| Variable | Exemple | Description |
| ------------- | -------- | -------------------------------------- |
| `buf_version` | `v1.0.0` | La version de `buf` |
| `symbol` | | Reflète la valeur de l'option `symbol` |
| `style`* | | Reflète la valeur de l'option `style` |
| Variable | Exemple | Description |
| --------- | -------- | -------------------------------------- |
| `version` | `v1.0.0` | La version de `buf` |
| `symbol` | | 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
@@ -609,9 +622,9 @@ Par défaut, il ne change que la couleur. Si vous désirez également changer sa
### Variables
| Variable | Exemple | Description |
| -------- | ------- | --------------------------------------------------------------- |
| symbol | | Reflète sois `success_symbol`, `error_symbol` ou `vicmd_symbol` |
| Variable | Exemple | Description |
| -------- | ------- | -------------------------------------------------------------------------------------------------------- |
| symbol | | A mirror of either `success_symbol`, `error_symbol`, `vimcmd_symbol` or `vimcmd_replace_one_symbol` etc. |
### Exemples
@@ -794,12 +807,12 @@ Le module `container` affiche un symbole et le nom du conteneur, si vous êtes d
### Options
| Option | Défaut | Description |
| ---------- | -------------------------------------- | ---------------------------------------------------- |
| `symbol` | `"⬢"` | Le symbole affiché quand vous êtes dans un conteneur |
| `style` | `"bold red dimmed"` | Le style du module. |
| `format` | `"[$symbol \\[$name\\]]($style) "` | Format du module. |
| `disabled` | `false` | Désactive le module `container`. |
| Option | Défaut | Description |
| ---------- | ---------------------------------- | ---------------------------------------------------- |
| `symbol` | `"⬢"` | Le symbole affiché quand vous êtes dans un conteneur |
| `style` | `"bold red dimmed"` | Le style du module. |
| `format` | `'[$symbol \[$name\]]($style) '` | Format du module. |
| `disabled` | `false` | Désactive le module `container`. |
### Variables
@@ -817,7 +830,7 @@ Le module `container` affiche un symbole et le nom du conteneur, si vous êtes d
# ~/.config/starship.toml
[container]
format = "[$symbol \\[$name\\]]($style) "
format = '[$symbol \[$name\]]($style) '
```
## Crystal
@@ -867,16 +880,16 @@ The `daml` module shows the currently used [Daml](https://www.digitalasset.com/d
### Options
| Option | Défaut | Description |
| ------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------ |
| `format` | `via [$symbol($version )]($style)` | Format du module. |
| `version_format` | `v${raw}` | Le format de la version. Les variables disponibles sont `raw`, `major`, `minor`, & `patch` |
| `symbol` | `"Λ "` | A format string representing the symbol of Daml |
| `style` | `"bold cyan"` | Le style du module. |
| `detect_extensions` | `[]` | Quelles extensions devraient activer ce module. |
| `detect_files` | `["daml.yaml"]` | Les fichiers qui activent ce module. |
| `detect_folders` | `[]` | Les dossiers qui activent ce module. |
| `disabled` | `false` | Disables the `daml` module. |
| Option | Défaut | Description |
| ------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------ |
| `format` | `"via [$symbol($version )]($style)"` | Format du module. |
| `version_format` | `"v${raw}"` | Le format de la version. Les variables disponibles sont `raw`, `major`, `minor`, & `patch` |
| `symbol` | `"Λ "` | A format string representing the symbol of Daml |
| `style` | `"bold cyan"` | Le style du module. |
| `detect_extensions` | `[]` | Quelles extensions devraient activer ce module. |
| `detect_files` | `["daml.yaml"]` | Les fichiers qui activent ce module. |
| `detect_folders` | `[]` | Les dossiers qui activent ce module. |
| `disabled` | `false` | Disables the `daml` module. |
### Variables
@@ -993,7 +1006,7 @@ Par exemple, donné `~/Dev/Nix/nixpkgs/pkgs` où `nixpkgs` est la racine du repo
| `read_only` | `"🔒"` | Le symbole indiquant que le répertoire courant est en lecture seule. |
| `read_only_style` | `"red"` | Le style du symbole en lecture seule. |
| `truncation_symbol` | `""` | Le symbole en préfixe aux chemins tronqués. eg: "…/" |
| `repo_root_style` | `None` | Le style pour la racine du dépôt Git. La valeur par défaut est équivalent à `style`. |
| `repo_root_style` | | Le style pour la racine du dépôt Git. La valeur par défaut est équivalent à `style`. |
| `repo_root_format` | `"[$before_root_path]($style)[$repo_root]($repo_root_style)[$path]($style)[$read_only]($read_only_style) "` | Le format d’un dépôt Git quand `repo_root_style` est défini. |
| `home_symbol` | `"~"` | Le symbole indiquant le répertoire personnel. |
| `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) |
@@ -1480,16 +1493,16 @@ Le module `git_commit` affiche le hash du commit actuel ainsi que le tag (le cas
### Options
| Option | Défaut | Description |
| -------------------- | ---------------------------------- | ------------------------------------------------------------------------------------ |
| `commit_hash_length` | `7` | La longueur du hash affiché du commit git. |
| `format` | `"[\\($hash$tag\\)]($style) "` | Format du module. |
| `style` | `"bold green"` | Le style du module. |
| `only_detached` | `true` | Ne montrer le hash du commit qu'en mode `HEAD` détachée. |
| `tag_disabled` | `true` | Désactive l'affichage des informations du tag dans le module `git_commit`. |
| `tag_max_candidates` | `0` | How many commits to consider for tag display. The default only allows exact matches. |
| `tag_symbol` | `" 🏷 "` | Symbole préfixant les informations affichées concernant le tag |
| `disabled` | `false` | Désactive le module `git_commit`. |
| Option | Défaut | Description |
| -------------------- | ------------------------------ | ------------------------------------------------------------------------------------ |
| `commit_hash_length` | `7` | La longueur du hash affiché du commit git. |
| `format` | `'[\($hash$tag\)]($style) '` | Format du module. |
| `style` | `"bold green"` | Le style du module. |
| `only_detached` | `true` | Ne montrer le hash du commit qu'en mode `HEAD` détachée. |
| `tag_disabled` | `true` | Désactive l'affichage des informations du tag dans le module `git_commit`. |
| `tag_max_candidates` | `0` | How many commits to consider for tag display. The default only allows exact matches. |
| `tag_symbol` | `" 🏷 "` | Symbole préfixant les informations affichées concernant le tag |
| `disabled` | `false` | Désactive le module `git_commit`. |
### Variables
@@ -1567,7 +1580,7 @@ Ce module est désactivé par défaut. Pour l'activer, configurez `disabled` sur
| `added_style` | `"bold green"` | Le style pour le compte des ajouts. |
| `deleted_style` | `"bold green"` | Le style pour le compte des suppressions. |
| `only_nonzero_diffs` | `true` | Afficher le statut seulement pour les items modifiés. |
| `format` | `'([+$added]($added_style) )([-$deleted]($deleted_style) )'` | Format du module. |
| `format` | `"([+$added]($added_style) )([-$deleted]($deleted_style) )"` | Format du module. |
| `disabled` | `true` | Désactive le module `git_metrics`. |
### Variables
@@ -1588,7 +1601,7 @@ Ce module est désactivé par défaut. Pour l'activer, configurez `disabled` sur
[git_metrics]
added_style = "bold blue"
format = '[+$added]($added_style)/[-$deleted]($deleted_style) '
format = "[+$added]($added_style)/[-$deleted]($deleted_style) "
```
## Statut Git
@@ -1690,7 +1703,7 @@ Utiliser un exécutable Starship Windows pour les chemins Windows dans WSL
# ~/.config/starship.toml
[git_status]
windows_starship = '/mnt/c/Users/username/scoop/apps/starship/current/starship.exe'
windows_starship = "/mnt/c/Users/username/scoop/apps/starship/current/starship.exe"
```
## Go
@@ -1852,21 +1865,21 @@ disabled = false
Le module `java` affiche la version actuellement installée de [Java](https://www.oracle.com/java/). Par défaut le module sera activé si au moins l'une des conditions suivantes est remplie:
- Le répertoire actuel contient un fichier `pom.xml`, `build.gradle.kts`, `build.sbt`, `.java-version`, `.deps.edn`, `project.clj`, ou `build.boot`
- The current directory contains a `pom.xml`, `build.gradle.kts`, `build.sbt`, `.java-version`, `deps.edn`, `project.clj`, or `build.boot` file
- Le répertoire actuel contient un fichier avec l'extension `.java`, `.class`, `. gradle`, `.jar`, `.clj`, ou `.cljc`
### Options
| Option | Défaut | Description |
| ------------------- | --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| `format` | `"via [${symbol}(${version} )]($style)"` | Format du module. |
| `version_format` | `"v${raw}"` | Le format de la version. Les variables disponibles sont `raw`, `major`, `minor`, & `patch` |
| `detect_extensions` | `["java", "class", "gradle", "jar", "cljs", "cljc"]` | Quelles extensions devraient activer ce module. |
| `detect_files` | `["pom.xml", "build.gradle.kts", "build.sbt", ".java-version", ".deps.edn", "project.clj", "build.boot"]` | Les fichiers qui activent ce module. |
| `detect_folders` | `[]` | Quels dossiers devraient activer ce module. |
| `symbol` | `"☕ "` | Une chaîne de caractères représentant le symbole de Java |
| `style` | `"red dimmed"` | Le style du module. |
| `disabled` | `false` | Désactive le module `java`. |
| Option | Défaut | Description |
| ------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| `format` | `"via [${symbol}(${version} )]($style)"` | Format du module. |
| `version_format` | `"v${raw}"` | Le format de la version. Les variables disponibles sont `raw`, `major`, `minor`, & `patch` |
| `detect_extensions` | `["java", "class", "gradle", "jar", "cljs", "cljc"]` | Quelles extensions devraient activer ce module. |
| `detect_files` | `["pom.xml", "build.gradle.kts", "build.sbt", ".java-version", "deps.edn", "project.clj", "build.boot"]` | Les fichiers qui activent ce module. |
| `detect_folders` | `[]` | Quels dossiers devraient activer ce module. |
| `symbol` | `"☕ "` | Une chaîne de caractères représentant le symbole de Java |
| `style` | `"red dimmed"` | Le style du module. |
| `disabled` | `false` | Désactive le module `java`. |
### Variables
@@ -2258,9 +2271,48 @@ symbol = " "
style = "bold dimmed green"
```
## Meson
The `meson` module shows the current Meson developer environment status.
By default the Meson project name is displayed, if `$MESON_DEVENV` is set.
### Options
| Option | Défaut | Description |
| ------------------- | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `truncation_length` | `2^32 - 1` | Truncates a project name to `N` graphemes. |
| `truncation_symbol` | `"…"` | The symbol used to indicate a project name was truncated. Vous pouvez utiliser `""` pour ne pas afficher de symbole. |
| `format` | `"via [$symbol$project]($style) "` | Format du module. |
| `symbol` | `"⬢ "` | The symbol used before displaying the project name. |
| `style` | `"blue bold"` | Le style du module. |
| `disabled` | `false` | Disables the `meson` module. |
### Variables
| Variable | Exemple | Description |
| --------- | ---------- | -------------------------------------- |
| project | `starship` | The current Meson project name |
| symbol | `🐏` | 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
### Exemple
```toml
# ~/.config/starship.toml
[meson]
disabled = false
truncation_symbol = "--"
symbol = " "
style = "bold dimmed green"
```
## Branche Mercurial
Le module `hg_branch` affiche la branche active du dépôt dans votre répertoire courant.
Le module `hg_branch` affiche la branche active du dépôt dans le dossier courant.
### Options
@@ -2296,7 +2348,7 @@ truncation_symbol = ""
## Nim
Le module `nim` affiche la version actuellement installée de [Nim](https://nim-lang.org/). Par défaut le module sera activé si au moins l'une des conditions suivantes est remplie:
Le module `nim` affiche la version de [Nim](https://nim-lang.org/) installée. Par défaut le module sera activé si au moins l'une des conditions suivantes est remplie:
- Le dossier courant contient un fichier `nim.cfg`
- Le répertoire actuel contient un fichier avec l'extension `.nim`
@@ -2376,7 +2428,7 @@ format = 'via [☃️ $state( \($name\))](bold blue) '
## Node.js
Le module `nodejs` affiche la version actuellement installée de [Node.js](https://nodejs.org/). Par défaut le module sera activé si au moins l'une des conditions suivantes est remplie:
Le module `nodejs` affiche la version de [Node.js](https://nodejs.org/) installée. Par défaut le module sera activé si au moins l'une des conditions suivantes est remplie:
- Le dossier courant contient un fichier `package.json`
- Le répertoire courant contient un fichier `.node-version`
@@ -2420,7 +2472,7 @@ format = "via [🤖 $version](bold green) "
## OCaml
Le module `ocaml` affiche la version actuellement installée de [OCaml](https://ocaml.org/). Par défaut le module sera activé si au moins l'une des conditions suivantes est remplie:
Le module `ocaml` affiche la version de [OCaml](https://ocaml.org/) installée. Par défaut le module sera activé si au moins l'une des conditions suivantes est remplie:
- Le répertoire courant contient un fichier avec l'extension `.opam` ou le répertoire `_opam`
- Le répertoire courant contient un répertoire `esy.lock`
@@ -2471,12 +2523,12 @@ The `openstack` module shows the current OpenStack cloud and project. The module
### Options
| Option | Défaut | Description |
| ---------- | --------------------------------------------------- | -------------------------------------------------------------- |
| `format` | `"on [$symbol$cloud(\\($project\\))]($style) "` | Format du module. |
| `symbol` | `"☁️ "` | Le symbole utilisé avant d'afficher le cloud OpenStack actuel. |
| `style` | `"bold yellow"` | Le style du module. |
| `disabled` | `false` | Désactive le module `openstack`. |
| Option | Défaut | Description |
| ---------- | ----------------------------------------------- | -------------------------------------------------------------- |
| `format` | `'on [$symbol$cloud(\($project\))]($style) '` | Format du module. |
| `symbol` | `"☁️ "` | Le symbole utilisé avant d'afficher le cloud OpenStack actuel. |
| `style` | `"bold yellow"` | Le style du module. |
| `disabled` | `false` | Désactive le module `openstack`. |
### Variables
@@ -2495,12 +2547,12 @@ The `openstack` module shows the current OpenStack cloud and project. The module
# ~/.config/starship.toml
[openstack]
format = "on [$symbol$cloud(\\($project\\))]($style) "
format = 'on [$symbol$cloud(\($project\))]($style) '
style = "bold yellow"
symbol = "☁️ "
```
## Version du package
## Version du paquet
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`, `nimble`, `cargo`, `poetry`, `python`, `composer`, `gradle`, `julia`, `mix`, `helm`, `shards`, `daml` and `dart` packages.
@@ -2556,7 +2608,7 @@ format = "via [🎁 $version](208 bold) "
## Perl
Le module `perl` affiche la version actuellement installée de [Perl](https://www.perl.org/). Par défaut le module sera activé si au moins l'une des conditions suivantes est remplie:
Le module `perl` affiche la version de [Perl](https://www.perl.org/) installée. Par défaut le module sera activé si au moins l'une des conditions suivantes est remplie:
- Le répertoire courant contient un fichier `Makefile.PL` ou `Build.PL`
- Le répertoire courant contient un fichier `cpanfile` ou `cpanfile.snapshot`
@@ -2596,7 +2648,7 @@ format = "via [🦪 $version]($style) "
## PHP
Le module `php` affiche la version actuellement installée de [PHP](https://www.php.net/). Par défaut le module sera activé si au moins l'une des conditions suivantes est remplie:
Le module `php` affiche la version de [PHP](https://www.php.net/) installée. Par défaut le module sera activé si au moins l'une des conditions suivantes est remplie:
- Le dossier courant contient un fichier `composer.json`
- Le répertoire courant contient un fichier `.php-version`
@@ -2694,7 +2746,7 @@ format = "[$symbol$stack]($style) "
## PureScript
Le module `purescript` affiche la version actuellement installée de [PureScript](https://www.purescript.org/). Par défaut le module sera activé si au moins l'une des conditions suivantes est remplie:
Le module `purescript` affiche la version de [PureScript](https://www.purescript.org/) installée. Par défaut le module sera activé si au moins l'une des conditions suivantes est remplie:
- Le répertoire courant contient un fichier `spago.dhall`
- Le répertoire actuel contient un fichier avec l'extension `.purs`
@@ -2733,7 +2785,7 @@ format = "via [$symbol$version](bold white)"
## Python
Le module `python` affiche la version actuellement installée de [Python](https://www.python.org/) ainsi que la version d'[environnement virtuel Python](https://docs.python.org/tutorial/venv.html) si il y en a un d'activé.
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.
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`.
@@ -2823,7 +2875,7 @@ python_binary = ["./venv/bin/python", "python", "python3", "python2"]
## R
Le module `rlang` affiche la version de [R](https://www.r-project.org/) actuellement installée. Le module s’affiche si l’une de ces conditions est remplie :
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:
- Le répertoire actuel contient un fichier avec l'extension `.R`.
- Le répertoire actuel contient un fichier avec l'extension `.Rd`.
@@ -2903,7 +2955,7 @@ format = "via [🦪 $version]($style) "
## Red
Par défaut, le module `red` affiche la version actuellement installée de [Red](https://www.red-lang.org/). Le module est affiché si l'une de ces conditions est remplie :
Par défaut, le module `red` affiche la version de [Red](https://www.red-lang.org/) installée. Le module est affiché si l'une de ces conditions est remplie :
- Le répertoire actuel contient un fichier avec l'extension `.red` ou `.reds`
@@ -2941,7 +2993,7 @@ symbol = "🔴 "
## Ruby
Par défaut, le module `ruby` affiche la version actuellement installée de [Ruby](https://www.ruby-lang.org/). Le module est affiché si l'une de ces conditions est remplie :
Le module `ruby` affiche la version de [Ruby](https://www.ruby-lang.org/) installée. Le module est affiché si l'une de ces conditions est remplie :
- Le répertoire courant contient un fichier `Gemfile`
- Le répertoire courant contient un fichier `.ruby-version`
@@ -2985,7 +3037,7 @@ symbol = "🔺 "
## Rust
Par défaut, le module `rust` affiche la version actuellement installée de [Rust](https://www.rust-lang.org/). Le module est affiché si l'une de ces conditions est remplie :
Le module `rust` affiche la version de [Rust](https://www.rust-lang.org/) installée. Le module est affiché si l'une de ces conditions est remplie :
- Le répertoire courant contient un fichier `Cargo.toml`
- Le répertoire actuel contient un fichier avec l'extension `.rs`
@@ -3026,7 +3078,7 @@ format = "via [⚙️ $version](red bold)"
## Scala
Le module `scala` affiche la version actuellement installée de [Scala](https://www.scala-lang.org/). Par défaut le module sera activé si au moins l'une des conditions suivantes est remplie:
Le module `scale` affiche la version de [Scala](https://www.scala-lang.org/) installée. Par défaut le module sera activé si au moins l'une des conditions suivantes est remplie:
- Le répertoire courant contient un fichier `build.sbt`, `.scalaenv` ou `.sbtenv`
- Le répertoire actuel contient un fichier avec l'extension `.scala` ou `.sbt`
@@ -3078,16 +3130,16 @@ Ce module est désactivé par défaut. Pour l'activer, configurez `disabled` sur
| Option | Défaut | Description |
| ---------------------- | ------------------------- | ----------------------------------------------------------- |
| `bash_indicator` | `bsh` | Une chaîne de format utilisée pour représenter bash. |
| `fish_indicator` | `fsh` | Une chaîne de format utilisée pour représenter fish. |
| `zsh_indicator` | `zsh` | Une chaîne de format utilisée pour représenter zsh. |
| `powershell_indicator` | `psh` | Une chaîne de format utilisée pour représenter powershell. |
| `ion_indicator` | `ion` | Une chaîne de format utilisée pour représenter ion. |
| `elvish_indicator` | `esh` | Une chaîne de format utilisée pour représenter elvish. |
| `tcsh_indicator` | `tsh` | Une chaîne de format utilisée pour représenter tcsh. |
| `xonsh_indicator` | `xsh` | Chaine de formatage utilisée pour représenter xonsh. |
| `cmd_indicator` | `cmd` | Chaine de formatage utilisée pour représenter cmd. |
| `nu_indicator` | `nu` | Chaine de formatage utilisée pour représenter nu. |
| `bash_indicator` | `"bsh"` | Chaine de formatage utilisée pour représenter bash. |
| `fish_indicator` | `"fsh"` | Chaine de formatage utilisée pour représenter fish. |
| `zsh_indicator` | `"zsh"` | Chaine de formatage utilisée pour représenter zsh. |
| `powershell_indicator` | `"psh"` | Chaine de formatage utilisée pour représenter powershell. |
| `ion_indicator` | `"ion"` | Chaine de formatage utilisée pour représenter ion. |
| `elvish_indicator` | `"esh"` | Chaine de formatage utilisée pour représenter elvish. |
| `tcsh_indicator` | `"tsh"` | Chaine de formatage utilisée pour représenter tcsh. |
| `xonsh_indicator` | `"xsh"` | Chaine de formatage utilisée pour représenter xonsh. |
| `cmd_indicator` | `"cmd"` | Chaine de formatage utilisée pour représenter cmd. |
| `nu_indicator` | `"nu"` | Chaine de formatage utilisée pour représenter nu. |
| `unknown_indicator` | | La valeur par défaut à afficher quand le shell est inconnu. |
| `format` | `"[$indicator]($style) "` | Format du module. |
| `style` | `"white bold"` | Le style du module. |
@@ -3216,7 +3268,7 @@ Le module `spack` affiche l’environnement [Spack](https://spack.readthedocs.io
format = "[$symbol$environment](dimmed blue) "
```
## Status
## 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.
@@ -3228,29 +3280,29 @@ Ce module est désactivé par défaut. Pour l'activer, configurez `disabled` sur
### Options
| Option | Défaut | Description |
| --------------------------- | ------------------------------------------------------------------------------------ | --------------------------------------------------------------------- |
| `format` | `"[$symbol$status]($style) "` | Le format du module |
| `symbol` | `"✖"` | The symbol displayed on program error |
| `success_symbol` | `""` | The symbol displayed on program success |
| `not_executable_symbol` | `"🚫"` | The symbol displayed when file isn't executable |
| `not_found_symbol` | `"🔍"` | The symbol displayed when the command can't be found |
| `sigint_symbol` | `"🧱"` | The symbol displayed on SIGINT (Ctrl + c) |
| `signal_symbol` | `"⚡"` | The symbol displayed on any signal |
| `style` | `"bold green"` | Le style du module. |
| `recognize_signal_code` | `true` | Enable signal mapping from exit code |
| `map_symbol` | `false` | Enable symbols mapping from exit code |
| `pipestatus` | `false` | Enable pipestatus reporting |
| `pipestatus_separator` | <code>&vert;</code> | The symbol used to separate pipestatus segments |
| `pipestatus_format` | `\\[$pipestatus\\] => [$symbol$common_meaning$signal_name$maybe_int]($style)` | The format of the module when the command is a pipeline |
| `pipestatus_segment_format` | | When specified, replaces `format` when formatting pipestatus segments |
| `disabled` | `true` | Désactiver le module `status`. |
| Option | Défaut | Description |
| --------------------------- | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
| `format` | `"[$symbol$status]($style) "` | Le format du module |
| `symbol` | `"✖"` | The symbol displayed on program error |
| `success_symbol` | `""` | The symbol displayed on program success |
| `not_executable_symbol` | `"🚫"` | The symbol displayed when file isn't executable |
| `not_found_symbol` | `"🔍"` | The symbol displayed when the command can't be found |
| `sigint_symbol` | `"🧱"` | The symbol displayed on SIGINT (Ctrl + c) |
| `signal_symbol` | `"⚡"` | The symbol displayed on any signal |
| `style` | `"bold green"` | Le style du module. |
| `recognize_signal_code` | `true` | Enable signal mapping from exit code |
| `map_symbol` | `false` | Enable symbols mapping from exit code |
| `pipestatus` | `false` | Enable pipestatus reporting |
| `pipestatus_separator` | <code>&vert;</code> | The symbol used to separate pipestatus segments (supports formatting) |
| `pipestatus_format` | `'\[$pipestatus\] => [$symbol$common_meaning$signal_name$maybe_int]($style)'` | The format of the module when the command is a pipeline |
| `pipestatus_segment_format` | | When specified, replaces `format` when formatting pipestatus segments |
| `disabled` | `true` | Désactiver le module `status`. |
### Variables
| Variable | Exemple | Description |
| -------------- | ------- | ------------------------------------------------------------------------------------------- |
| status | `127` | Le code de sortie de la dernière commande |
| statut | `127` | Le code de sortie de la dernière commande |
| hex_status | `0x7F` | Le code de sortie de la dernière commande en hexa |
| int | `127` | Le code de sortie de la dernière commande |
| common_meaning | `ERROR` | Signification du code si n’est pas un signal |
@@ -3289,13 +3341,13 @@ Ce module est désactivé par défaut. Pour l'activer, configurez `disabled` sur
### Options
| Option | Défaut | Description |
| --------------- | ----------------------- | ----------------------------------------------------------------- |
| `format` | `[as $symbol]($style)"` | Le format du module |
| `symbol` | `"🧙 "` | Le symbole affiché quand les identifiants sont en cache |
| `style` | `"bold blue"` | Le style du module. |
| `allow_windows` | `false` | Puisque Windows n’a pas de sudo par défaut, désactivé par défaut. |
| `disabled` | `true` | Désactive le module `sudo`. |
| Option | Défaut | Description |
| --------------- | ------------------------ | ----------------------------------------------------------------- |
| `format` | `"[as $symbol]($style)"` | Le format du module |
| `symbol` | `"🧙 "` | Le symbole affiché quand les identifiants sont en cache |
| `style` | `"bold blue"` | Le style du module. |
| `allow_windows` | `false` | Puisque Windows n’a pas de sudo par défaut, désactivé par défaut. |
| `disabled` | `true` | Désactive le module `sudo`. |
### Variables
@@ -3318,7 +3370,7 @@ disabled = false
```
```toml
# Sous Windows
# Sous windows
# $HOME\.starship\config.toml
[sudo]
@@ -3328,7 +3380,7 @@ disabled = false
## Swift
Par défaut, le module `swift` affiche la version actuellement installée de [Swift](https://swift.org/). Le module est affiché si l'une de ces conditions est remplie :
Par défaut, le module `swift` affiche la version de [Swift](https://swift.org/) installée. Le module est affiché si l'une de ces conditions est remplie :
- Le répertoire courant contient un fichier `Package.swift`
- Le répertoire actuel contient un fichier avec l'extension `.swift`
@@ -3426,7 +3478,7 @@ format = "[🏎💨 $workspace]($style) "
## Date et Heure
Le module `time` affiche l'heure actuelle **localement**. La valeur de `format` est utilisée par le package [`chrono`](https://crates.io/crates/chrono) pour contrôler la façon dont l'heure est affichée. Consultez la [doc de chrono strftime](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) pour découvrir les options disponibles.
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.
::: tip
@@ -3443,10 +3495,10 @@ Ce module est désactivé par défaut. Pour l'activer, configurez `disabled` sur
| `time_format` | voir plus bas | Le [format chrono](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) utilisé pour formater l'heure. |
| `style` | `"bold yellow"` | Le style utilisé par le module |
| `utc_time_offset` | `"local"` | Définir le décalage horaire UTC à utiliser. Intervalle de -24 &lt; x &lt; 24. Accepte des nombres décimaux pour s'adapter aux décalages de 30/45 minutes. |
| `disabled` | `true` | Désactiver le module `time`. |
| `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 |
Si `use_12hr` est à `true`, alors `time_format` vaut `"%r"`. Sinon, il est défini comme `"%T"`. Définir manuellement `time_format` outrepasse le paramètre `use_12hr`.
Si `use_12hr` est à `true`, alors `time_format` vaut `"%r"`. Sinon, il vaut `"%T"`. Définir manuellement `time_format` outrepasse le paramètre `use_12hr`.
### Variables
@@ -3472,7 +3524,7 @@ time_range = "10:00:00-14:00:00"
## Nom d'utilisateur
Le module `username` affiche le nom d'utilisateur de l'utilisateur actif. Le module est affiché si l'une de ces conditions est remplie :
Le module `username` affiche le nom de l’utilisateur actif. Le module est affiché si l'une de ces conditions est remplie :
- L'utilisateur courant est root/admin
- L'utilisateur courant est différent de celui connecté
@@ -3493,7 +3545,7 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
| `style_user` | `"bold yellow"` | Le style utilisé pour les utilisateurs non-root. |
| `format` | `"[$user]($style) in "` | Format du module. |
| `show_always` | `false` | Toujours afficher le module `username`. |
| `disabled` | `false` | Désactiver le module `username`. |
| `disabled` | `false` | Désactive le module `username`. |
### Variables
@@ -3510,14 +3562,14 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, `
[username]
style_user = "white bold"
style_root = "black bold"
format = "user: [$user]($style) "
format = "utilisateur: [$user]($style) "
disabled = false
show_always = true
```
## Vagrant
Le module `vagrant` affiche la version actuellement installée de [Vagrant](https://www.vagrantup.com/). Par défaut le module sera activé si au moins l'une des conditions suivantes est remplie:
Le module `vagrant` affiche la version de [Vagrant](https://www.vagrantup.com/) installée. Par défaut le module sera activé si au moins l'une des conditions suivantes est remplie:
- Le répertoire courant contient un fichier `Vagrantfile`
@@ -3623,7 +3675,7 @@ format = "[🆅 $repo](bold blue) "
## Zig
Par défaut, le module `zig` affiche la version actuellement installée de [Zig](https://ziglang.org/). Le module est affiché si l'une de ces conditions est remplie :
Le module `zig` affiche la version de [Zig](https://ziglang.org/) installée. Le module est affiché si l'une de ces conditions est remplie :
- Le répertoire courant contient un fichier `.zig`
@@ -3644,7 +3696,7 @@ Par défaut, le module `zig` affiche la version actuellement installée de [Zig]
| Variable | Exemple | Description |
| --------- | -------- | -------------------------------------- |
| version | `v0.6.0` | La version de `zig` |
| version | `v0.6.0` | La version de `zip` |
| symbol | | Reflète la valeur de l'option `symbol` |
| style\* | | Reflète la valeur de l'option `style` |
@@ -3763,7 +3815,7 @@ Automatic detection of shells and proper parameters addition are currently imple
[custom.foo]
command = "echo foo" # shows output of command
detect_files = ["foo"] # can specify filters but wildcards are not supported
when = """ test "$HOME" == "$PWD" """
when = """ test "$HOME" = "$PWD" """
format = " transcending [$output]($style)"
[custom.time]
docs/fr-FR/guide/README.md
-1
View File
@@ -220,7 +220,6 @@ Vous pouvez aussi installer Starship en utilisant l’un de ces gestionnaires de
| Arch Linux | [Arch Linux Community](https://archlinux.org/packages/community/x86_64/starship) | `pacman -S starship` |
| CentOS 7+ | [Copr](https://copr.fedorainfracloud.org/coprs/atim/starship) | `dnf copr enable atim/starship` <br /> `dnf install starship` |
| Fedora 31+ | [Paquets Fedora](https://src.fedoraproject.org/rpms/rust-starship) | `dnf install starship` |
| NixOS | [nixpkgs](https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/misc/starship/default.nix) | `nix-env -iA nixos.starship` |
| Gentoo | [Paquets Gentoo](https://packages.gentoo.org/packages/app-shells/starship) | `emerge app-shells/starship` |
| Manjaro | | `pacman -S starship` |
| NixOS | [nixpkgs](https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/misc/starship/default.nix) | `nix-env -iA nixpkgs.starship` |