diff options
author | Matan Kushner <hello@matchai.dev> | 2022-08-14 15:31:27 -0400 |
---|---|---|
committer | GitHub <noreply@github.com> | 2022-08-14 15:31:27 -0400 |
commit | 47f22c82c498518c1fbfb6e75f1ff0424699f785 (patch) | |
tree | 9e552877c9c17edcf93dcd2ce7accefa2010cdaa /docs/it-IT | |
parent | 37f350a476d74683c0950dbf809bb2d007595577 (diff) |
docs(i18n): new Crowdin updates (#4124)
Diffstat (limited to 'docs/it-IT')
-rw-r--r-- | docs/it-IT/README.md | 6 | ||||
-rw-r--r-- | docs/it-IT/advanced-config/README.md | 55 | ||||
-rw-r--r-- | docs/it-IT/config/README.md | 123 | ||||
-rw-r--r-- | docs/it-IT/presets/bracketed-segments.md | 4 | ||||
-rw-r--r-- | docs/it-IT/presets/nerd-font.md | 4 | ||||
-rw-r--r-- | docs/it-IT/presets/no-runtimes.md | 4 | ||||
-rw-r--r-- | docs/it-IT/presets/pastel-powerline.md | 4 | ||||
-rw-r--r-- | docs/it-IT/presets/plain-text.md | 4 | ||||
-rw-r--r-- | docs/it-IT/presets/pure-preset.md | 4 |
9 files changed, 178 insertions, 30 deletions
diff --git a/docs/it-IT/README.md b/docs/it-IT/README.md index 1f5194b59..a49b1eced 100644 --- a/docs/it-IT/README.md +++ b/docs/it-IT/README.md @@ -10,11 +10,11 @@ features: title: Prima la compatibilità details: Funziona sulle shell e sui sistemi operativi più comuni. Usalo ovunque! - - title: Generato in Rust - details: Sfrutta la velocità e sicurezza migliori di Rust, per rendere il tuo prompt il più veloce e il più affidabile. + title: Scritto in Rust + details: Sfrutta la velocità e sicurezza di Rust, per rendere il tuo prompt il più veloce e il più affidabile. - title: Personalizzabile - details: Ogni più piccolo dettaglio è personalizzabile a piacere, per rendere questo messaggio prompt minimalista o ricco delle funzionalità che desideri. + details: Ogni più piccolo dettaglio è personalizzabile a piacere, per rendere questo prompt minimalista o ricco di tutte le funzionalità che desideri. footer: Licenza ISC | Copyright © 2019-present Starship Collaboratori #Used for the description meta tag, for SEO metaTitle: "Starship: Cross-Shell Prompt" diff --git a/docs/it-IT/advanced-config/README.md b/docs/it-IT/advanced-config/README.md index da1a38f37..3e41f990a 100644 --- a/docs/it-IT/advanced-config/README.md +++ b/docs/it-IT/advanced-config/README.md @@ -8,6 +8,52 @@ Le configurazioni in questa sezione sono soggette a modifiche nelle future versi ::: +## TransientPrompt in PowerShell + +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-TransientPrompt` in the shell session. To make it permanent, put this statement in your `$PROFILE`. Transience can be disabled on-the-fly with `Disable-TransientPrompt`. + +By default, the left side of input gets replaced with `>`. To customize this, define a new function called `Invoke-Starship-TransientFunction`. For example, to display Starship's `character` module here, you would do + +```powershell +function Invoke-Starship-TransientFunction { + &starship module character +} + +Invoke-Expression (&starship init powershell) + +Enable-TransientPrompt +``` + +## TransientPrompt and TransientRightPrompt in Cmd + +Clink allows you to replace the previous-printed prompt with custom strings. This is useful in cases where all the prompt information is not always needed. To enable this, run `clink set prompt.transient <value>` where \<value\> can be one of: + +- `always`: always replace the previous prompt +- `same_dir`: replace the previous prompt only if the working directory is same +- `off`: do not replace the prompt (i.e. turn off transience) + +You need to do this only once. Make the following changes to your `starship.lua` to customize what gets displayed on the left and on the right: + +- By default, the left side of input gets replaced with `>`. To customize this, define a new function called `starship_transient_prompt_func`. This function receives the current prompt as a string that you can utilize. For example, to display Starship's `character` module here, you would do + +```lua +function starship_transient_prompt_func(prompt) + return io.popen("starship module character" + .." --keymap="..rl.getvariable('keymap') + ):read("*a") +end +load(io.popen('starship init cmd'):read("*a"))() +``` + +- By default, the right side of input is empty. To customize this, define a new function called `starship_transient_rprompt_func`. This function receives the current prompt as a string that you can utilize. For example, to display the time at which the last command was started here, you would do + +```lua +function starship_transient_rprompt_func(prompt) + return io.popen("starship module time"):read("*a") +end +load(io.popen('starship init cmd'):read("*a"))() +``` + ## Custom pre-prompt and pre-execution Commands in Cmd Clink provides extremely flexible APIs to run pre-prompt and pre-exec commands in Cmd shell. It is fairly simple to use with Starship. Make the following changes to your `starship.lua` file as per your requirements: @@ -185,6 +231,9 @@ Le stringhe di stile sono un elenco di parole, separate da spazi bianchi. Le par - `underline` - `dimmed` - `inverted` +- `blink` +- `hidden` +- `strikethrough` - `bg:<color>` - `fg:<color>` - `<color>` @@ -201,3 +250,9 @@ Uno colore specifico può essere uno di questi: - Un numero compreso tra 0-255. Specifica un [codice colore ANSI a 8 bit](https://i.stack.imgur.com/KTSQa.png). Se sono specificati più colori per il primo piano/sfondo, l'ultimo nella stringa avrà la priorità. + +Not every style string will be displayed correctly by every terminal. In particular, the following known quirks exist: + +- Many terminals disable support for `blink` by default +- `hidden` is not supported on iTerm (https://gitlab.com/gnachman/iterm2/-/issues/4564). +- `strikethrough` is not supported by the default macOS Terminal.app diff --git a/docs/it-IT/config/README.md b/docs/it-IT/config/README.md index fdaa01b80..d89310343 100644 --- a/docs/it-IT/config/README.md +++ b/docs/it-IT/config/README.md @@ -144,6 +144,18 @@ format = ''' \$''' ``` +### Negative matching + +Many modules have `detect_extensions`, `detect_files`, and `detect_folders` variables. These take lists of strings to match or not match. "Negative" options, those which should not be matched, are indicated with a leading "!" character. The presence of _any_ negative indicator in the directory will result in the module not being matched. + +Extensions are matched against both the characters after the last dot in a filename, and the characters after the first dot in a filename. For example, `foo.bar.tar.gz` will be matched against `bar.tar.gz` and `gz` in the `detect_extensions` variable. Files whose name begins with a dot are not considered to have extensions at all. + +To see how this works in practice, you could match TypeScript but not MPEG Transport Stream files thus: + +```toml +detect_extensions = ["ts", "!video.ts", "!audio.ts"] +``` + ## Prompt This is the list of prompt-wide configuration options. @@ -201,11 +213,9 @@ $git_status\ $hg_branch\ $docker_context\ $package\ -$buf\ $c\ $cmake\ $cobol\ -$container\ $daml\ $dart\ $deno\ @@ -228,6 +238,7 @@ $php\ $pulumi\ $purescript\ $python\ +$raku\ $rlang\ $red\ $ruby\ @@ -238,6 +249,7 @@ $terraform\ $vlang\ $vagrant\ $zig\ +$buf\ $nix_shell\ $conda\ $spack\ @@ -256,6 +268,7 @@ $jobs\ $battery\ $time\ $status\ +$container\ $shell\ $character""" ``` @@ -479,6 +492,45 @@ The `buf` module shows the currently installed version of [Buf](https://buf.buil symbol = "🦬 " ``` +## Bun + +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: + +- The current directory contains a `bun.lockb` file +- The current directory contains a `bunfig.toml` file + +### Opzioni + +| Opzione | Default | Descrizione | +| ------------------- | ------------------------------------ | -------------------------------------------------------------------------------------------- | +| `format` | `"via [$symbol($version )]($style)"` | The format for the module. | +| `version_format` | `"v${raw}"` | Il formato della versione. Le variabili disponibili sono `raw`, `major`, `minore`, & `patch` | +| `symbol` | `"🍞 "` | A format string representing the symbol of Node.js. | +| `detect_extensions` | `[]` | Quali estensioni dovrebbero attivare questo modulo. | +| `detect_files` | `["bun.lockb", "bunfig.toml"]` | Quali nomi di file dovrebbero attivare questo modulo. | +| `detect_folders` | `[]` | Quali cartelle dovrebbero attivare questo modulo. | +| `style` | `"bold red"` | Lo stile per il modulo. | +| `disabled` | `false` | Disables the `bun` module. | + +### Variables + +| Variable | Esempio | Descrizione | +| --------- | -------- | ------------------------------------ | +| version | `v0.1.4` | The version of `bun` | +| symbol | | Mirrors the value of option `symbol` | +| style\* | | Mirrors the value of option `style` | + +*: This variable can only be used as a part of a style string + +### Esempio + +```toml +# ~/.config/starship.toml + +[bun] +format = "via [🍔 $version](bold green) " +``` + ## C 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. @@ -1986,18 +2038,23 @@ Displays the current [Kubernetes context](https://kubernetes.io/docs/concepts/co 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 st in which case the module will only be active in directories that match those conditions. + ::: ### Opzioni -| Opzione | Default | Descrizione | -| ----------------- | ---------------------------------------------------- | --------------------------------------------------------------------- | -| `symbol` | `"☸ "` | A format string representing the symbol displayed before the Cluster. | -| `format` | `'[$symbol$context( \($namespace\))]($style) in '` | The format for the module. | -| `style` | `"cyan bold"` | Lo stile per il modulo. | -| `context_aliases` | | Table of context aliases to display. | -| `user_aliases` | | Table of user aliases to display. | -| `disabled` | `true` | Disables the `kubernetes` module. | +| Opzione | Default | Descrizione | +| ------------------- | ---------------------------------------------------- | --------------------------------------------------------------------- | +| `symbol` | `"☸ "` | A format string representing the symbol displayed before the Cluster. | +| `format` | `'[$symbol$context( \($namespace\))]($style) in '` | The format for the module. | +| `style` | `"cyan bold"` | Lo stile per il modulo. | +| `context_aliases` | | Table of context aliases to display. | +| `user_aliases` | | Table of user aliases to display. | +| `detect_extensions` | `[]` | Quali estensioni dovrebbero attivare questo modulo. | +| `detect_files` | `[]` | Quali nomi di file dovrebbero attivare questo modulo. | +| `detect_folders` | `[]` | Which folders should trigger this modules. | +| `disabled` | `true` | Disables the `kubernetes` module. | ### Variables @@ -2029,6 +2086,16 @@ disabled = false "root/.*" = "root" ``` +Only show the module in directories that contain a `k8s` file. + +```toml +# ~/.config/starship.toml + +[kubernetes] +disabled = false +detect_files = ['k8s'] +``` + #### Regex Matching Additional to simple aliasing, `context_aliases` and `user_aliases` also supports extended matching and renaming using regular expressions. @@ -2579,7 +2646,7 @@ By default the Pulumi version is not shown, since it takes an order of magnitude By default the module will be shown if any of the following conditions are met: - The current directory contains either `Pulumi.yaml` or `Pulumi.yml` -- A parent directory contains either `Pulumi.yaml` or `Pulumi.yml` +- A parent directory contains either `Pulumi.yaml` or `Pulumi.yml` unless `search_upwards` is set to `false` ### Opzioni @@ -2589,6 +2656,7 @@ By default the module will be shown if any of the following conditions are met: | `version_format` | `"v${raw}"` | Il formato della versione. Le variabili disponibili sono `raw`, `major`, `minore`, & `patch` | | `symbol` | `" "` | A format string shown before the Pulumi stack. | | `style` | `"bold 5"` | Lo stile per il modulo. | +| `search_upwards` | `true` | Enable discovery of pulumi config files in parent directories. | | `disabled` | `false` | Disables the `pulumi` module. | ### Variables @@ -3158,22 +3226,23 @@ This module is disabled by default. To enable it, set `disabled` to `false` in y ### Opzioni -| Opzione | Default | Descrizione | -| ----------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------- | -| `format` | `"[$symbol$status]($style) "` | The format of the 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 red"` | Lo stile per il modulo. | -| `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` | `|` | | -| `pipestatus_format` | `\\[$pipestatus\\] => [$symbol$common_meaning$signal_name$maybe_int]($style)` | The format of the module when the command is a pipeline | -| `disabled` | `true` | Disables the `status` module. | +| Opzione | Default | Descrizione | +| --------------------------- | ------------------------------------------------------------------------------------ | --------------------------------------------------------------------- | +| `format` | `"[$symbol$status]($style) "` | The format of the 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 red"` | Lo stile per il modulo. | +| `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>|</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` | Disables the `status` module. | ### Variables diff --git a/docs/it-IT/presets/bracketed-segments.md b/docs/it-IT/presets/bracketed-segments.md index aa7b79107..444004ce7 100644 --- a/docs/it-IT/presets/bracketed-segments.md +++ b/docs/it-IT/presets/bracketed-segments.md @@ -8,6 +8,10 @@ This preset changes the format of all the built-in modules to show their segment ### Configurazione +```sh +starship preset bracketed-segments > ~/.config/starship.toml +``` + [Click to download TOML](/presets/toml/bracketed-segments.toml) <<< @/.vuepress/public/presets/toml/bracketed-segments.toml diff --git a/docs/it-IT/presets/nerd-font.md b/docs/it-IT/presets/nerd-font.md index 2ef8ac933..8af5006bf 100644 --- a/docs/it-IT/presets/nerd-font.md +++ b/docs/it-IT/presets/nerd-font.md @@ -12,6 +12,10 @@ This preset changes the symbols for each module to use Nerd Font symbols. ### Configurazione +```sh +starship preset nerd-font-symbols > ~/.config/starship.toml +``` + [Click to download TOML](/presets/toml/nerd-font-symbols.toml) <<< @/.vuepress/public/presets/toml/nerd-font-symbols.toml diff --git a/docs/it-IT/presets/no-runtimes.md b/docs/it-IT/presets/no-runtimes.md index ef6ee80f7..7cbca9814 100644 --- a/docs/it-IT/presets/no-runtimes.md +++ b/docs/it-IT/presets/no-runtimes.md @@ -8,6 +8,10 @@ This preset hides the version of language runtimes. If you work in containers or ### Configurazione +```sh +starship preset no-runtime-versions > ~/.config/starship.toml +``` + [Click to download TOML](/presets/toml/no-runtime-versions.toml) <<< @/.vuepress/public/presets/toml/no-runtime-versions.toml diff --git a/docs/it-IT/presets/pastel-powerline.md b/docs/it-IT/presets/pastel-powerline.md index d029e2b10..00cd8df70 100644 --- a/docs/it-IT/presets/pastel-powerline.md +++ b/docs/it-IT/presets/pastel-powerline.md @@ -12,6 +12,10 @@ This preset is inspired by [M365Princess](https://github.com/JanDeDobbeleer/oh-m ### Configurazione +```sh +starship preset pastel-powerline > ~/.config/starship.toml +``` + [Click to download TOML](/presets/toml/pastel-powerline.toml) <<< @/.vuepress/public/presets/toml/pastel-powerline.toml diff --git a/docs/it-IT/presets/plain-text.md b/docs/it-IT/presets/plain-text.md index 190a34a8c..a43971e23 100644 --- a/docs/it-IT/presets/plain-text.md +++ b/docs/it-IT/presets/plain-text.md @@ -8,6 +8,10 @@ This preset changes the symbols for each module into plain text. Great if you do ### Configurazione +```sh +starship preset plain-text-symbols > ~/.config/starship.toml +``` + [Click to download TOML](/presets/toml/plain-text-symbols.toml) <<< @/.vuepress/public/presets/toml/plain-text-symbols.toml diff --git a/docs/it-IT/presets/pure-preset.md b/docs/it-IT/presets/pure-preset.md index a16707464..3b797eb3a 100644 --- a/docs/it-IT/presets/pure-preset.md +++ b/docs/it-IT/presets/pure-preset.md @@ -8,6 +8,10 @@ This preset emulates the look and behavior of [Pure](https://github.com/sindreso ### Configurazione +```sh +starship preset pure-preset > ~/.config/starship.toml +``` + [Click to download TOML](/presets/toml/pure-preset.toml) <<< @/.vuepress/public/presets/toml/pure-preset.toml |