diff options
| author | Matan Kushner <hello@matchai.dev> | 2022-10-14 21:53:32 -0400 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2022-10-14 21:53:32 -0400 |
| commit | 74951e630ec6f654e9690d2000f7e88a90a51a0c (patch) | |
| tree | d5322b3e975e3a7af7a660b3955e53cb2a1a52fa | |
| parent | dfc9cf6861c00cd331370f5bdc72eb1db8eba356 (diff) | |
docs(i18n): new Crowdin updates (#4355)
89 files changed, 9214 insertions, 2495 deletions
diff --git a/docs/ar-SA/README.md b/docs/ar-SA/README.md index 8be252222..34c398828 100644 --- a/docs/ar-SA/README.md +++ b/docs/ar-SA/README.md @@ -2,7 +2,7 @@ home: true heroImage: /logo.svg heroText: -tagline: The minimal, blazing-fast, and infinitely customizable prompt for any shell! +tagline: التخصيص البسيط و السريع و الغير محدود لي ال"shell"! actionText: البدء مع Starship ← actionLink: ./guide/ features: @@ -55,11 +55,10 @@ description: Starship is the minimal, blazing fast, and extremely customizable p ```sh brew install starship ``` - - بإستخدام [Scoop](https://scoop.sh): + With [Winget](https://github.com/microsoft/winget-cli): ```powershell - scoop install starship + winget install starship ``` 1. أضف ما يلي إلى ملف تكوين موجه الأوامر الخاص بك: @@ -179,7 +178,7 @@ description: Starship is the minimal, blazing fast, and extremely customizable p #### Cmd - You need to use [Clink](https://chrisant996.github.io/clink/clink.html) (v1.2.30+) with Cmd. Add the following to a file `starship.lua` and place this file in Clink scripts directory: + عليك بإستخدام [Clink](https://chrisant996.github.io/clink/clink.html) (v1.2.30+) مع Cmd. Add the following to a file `starship.lua` and place this file in Clink scripts directory: ```lua -- starship.lua diff --git a/docs/ar-SA/advanced-config/README.md b/docs/ar-SA/advanced-config/README.md index e124bdc0c..6fbbe10b9 100644 --- a/docs/ar-SA/advanced-config/README.md +++ b/docs/ar-SA/advanced-config/README.md @@ -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 +``` + ## 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: diff --git a/docs/ar-SA/config/README.md b/docs/ar-SA/config/README.md index f82fa3f72..e43610027 100644 --- a/docs/ar-SA/config/README.md +++ b/docs/ar-SA/config/README.md @@ -162,13 +162,15 @@ This is the list of prompt-wide configuration options. ### Options -| Option | الافتراضي | الوصف | -| ----------------- | ------------------------------ | ---------------------------------------------------------------- | -| `format` | [link](#default-prompt-format) | Configure the format of the prompt. | -| `right_format` | `""` | See [Enable Right Prompt](/advanced-config/#enable-right-prompt) | -| `scan_timeout` | `30` | Timeout for starship to scan files (in milliseconds). | -| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | -| `add_newline` | `true` | Inserts blank line between shell prompts. | +| Option | الافتراضي | الوصف | +| ----------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `format` | [link](#default-prompt-format) | Configure the format of the prompt. | +| `right_format` | `""` | See [Enable Right Prompt](/advanced-config/#enable-right-prompt) | +| `scan_timeout` | `30` | Timeout for starship to scan files (in milliseconds). | +| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | +| `add_newline` | `true` | Inserts blank line between shell prompts. | +| `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. | ### مثال @@ -186,6 +188,16 @@ scan_timeout = 10 # 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" ``` ### Default Prompt Format @@ -252,6 +264,7 @@ $zig\ $buf\ $nix_shell\ $conda\ +$meson\ $spack\ $memory_usage\ $aws\ @@ -431,12 +444,12 @@ The default value for the `charging_symbol` and `discharging_symbol` option is r The `display` option is an array of the following table. -| Option | الافتراضي | الوصف | -| -------------------- | ---------- | --------------------------------------------------------------------------------------------------------- | -| `threshold` | `10` | The upper bound for the display option. | -| `style` | `bold red` | The style used if the display option is in use. | -| `charging_symbol` | `-` | Optional symbol displayed if display option is in use, defaults to battery's `charging_symbol` option. | -| `discharging_symbol` | `-` | Optional symbol displayed if display option is in use, defaults to battery's `discharging_symbol` option. | +| Option | الافتراضي | الوصف | +| -------------------- | ------------ | --------------------------------------------------------------------------------------------------------- | +| `threshold` | `10` | The upper bound for the display option. | +| `style` | `"red bold"` | The style used if the display option is in use. | +| `charging_symbol` | | Optional symbol displayed if display option is in use, defaults to battery's `charging_symbol` option. | +| `discharging_symbol` | | Optional symbol displayed if display option is in use, defaults to battery's `discharging_symbol` option. | #### مثال @@ -462,24 +475,24 @@ The `buf` module shows the currently installed version of [Buf](https://buf.buil ### Options -| Option | الافتراضي | الوصف | -| ------------------- | ------------------------------------------------------------ | ----------------------------------------------------- | -| `format` | `'with [$symbol($version \(Buf $buf_version\) )]($style)'` | The format for the `buf` module. | -| `version_format` | `"v${raw}"` | The version format. | -| `symbol` | `"🦬 "` | The symbol used before displaying the version of Buf. | -| `detect_extensions` | `[]` | Which extensions should trigger this module. | -| `detect_files` | `["buf.yaml", "buf.gen.yaml", "buf.work.yaml"]` | Which filenames should trigger this module. | -| `detect_folders` | `[]` | Which folders should trigger this modules. | -| `style` | `"bold blue"` | The style for the module. | -| `disabled` | `false` | Disables the `elixir` module. | +| Option | الافتراضي | الوصف | +| ------------------- | ----------------------------------------------- | ----------------------------------------------------- | +| `format` | `"with [$symbol($version )]($style)"` | The format for the `buf` module. | +| `version_format` | `"v${raw}"` | The version format. | +| `symbol` | `"🦬 "` | The symbol used before displaying the version of Buf. | +| `detect_extensions` | `[]` | Which extensions should trigger this module. | +| `detect_files` | `["buf.yaml", "buf.gen.yaml", "buf.work.yaml"]` | Which filenames should trigger this module. | +| `detect_folders` | `[]` | Which folders should trigger this modules. | +| `style` | `"bold blue"` | The style for the module. | +| `disabled` | `false` | Disables the `elixir` module. | ### Variables -| Variable | مثال | الوصف | -| ------------- | -------- | ------------------------------------ | -| `buf_version` | `v1.0.0` | The version of `buf` | -| `symbol` | | Mirrors the value of option `symbol` | -| `style`* | | Mirrors the value of option `style` | +| Variable | مثال | الوصف | +| --------- | -------- | ------------------------------------ | +| `version` | `v1.0.0` | The version of `buf` | +| `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 @@ -609,9 +622,9 @@ By default it only changes color. If you also want to change its shape take a lo ### Variables -| Variable | مثال | الوصف | -| -------- | ---- | --------------------------------------------------------------------- | -| symbol | | A mirror of either `success_symbol`, `error_symbol` or `vicmd_symbol` | +| Variable | مثال | الوصف | +| -------- | ---- | -------------------------------------------------------------------------------------------------------- | +| symbol | | A mirror of either `success_symbol`, `error_symbol`, `vimcmd_symbol` or `vimcmd_replace_one_symbol` etc. | ### Examples @@ -794,12 +807,12 @@ The `container` module displays a symbol and container name, if inside a contain ### Options -| Option | الافتراضي | الوصف | -| ---------- | -------------------------------------- | ----------------------------------------- | -| `symbol` | `"⬢"` | The symbol shown, when inside a container | -| `style` | `"bold red dimmed"` | The style for the module. | -| `format` | `"[$symbol \\[$name\\]]($style) "` | The format for the module. | -| `disabled` | `false` | Disables the `container` module. | +| Option | الافتراضي | الوصف | +| ---------- | ---------------------------------- | ----------------------------------------- | +| `symbol` | `"⬢"` | The symbol shown, when inside a container | +| `style` | `"bold red dimmed"` | The style for the module. | +| `format` | `'[$symbol \[$name\]]($style) '` | The format for the module. | +| `disabled` | `false` | Disables the `container` module. | ### Variables @@ -817,7 +830,7 @@ The `container` module displays a symbol and container name, if inside a contain # ~/.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 | الافتراضي | الوصف | -| ------------------- | ---------------------------------- | ------------------------------------------------------------------------- | -| `format` | `via [$symbol($version )]($style)` | The format for the module. | -| `version_format` | `v${raw}` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | -| `symbol` | `"Λ "` | A format string representing the symbol of Daml | -| `style` | `"bold cyan"` | The style for the module. | -| `detect_extensions` | `[]` | Which extensions should trigger this module. | -| `detect_files` | `["daml.yaml"]` | Which filenames should trigger this module. | -| `detect_folders` | `[]` | Which folders should trigger this module. |