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/vi-VN | |
parent | 37f350a476d74683c0950dbf809bb2d007595577 (diff) |
docs(i18n): new Crowdin updates (#4124)
Diffstat (limited to 'docs/vi-VN')
-rw-r--r-- | docs/vi-VN/advanced-config/README.md | 55 | ||||
-rw-r--r-- | docs/vi-VN/config/README.md | 133 | ||||
-rw-r--r-- | docs/vi-VN/presets/bracketed-segments.md | 4 | ||||
-rw-r--r-- | docs/vi-VN/presets/nerd-font.md | 4 | ||||
-rw-r--r-- | docs/vi-VN/presets/no-runtimes.md | 4 | ||||
-rw-r--r-- | docs/vi-VN/presets/pastel-powerline.md | 4 | ||||
-rw-r--r-- | docs/vi-VN/presets/plain-text.md | 4 | ||||
-rw-r--r-- | docs/vi-VN/presets/pure-preset.md | 4 |
8 files changed, 180 insertions, 32 deletions
diff --git a/docs/vi-VN/advanced-config/README.md b/docs/vi-VN/advanced-config/README.md index a2c17a47c..3d3fd48c6 100644 --- a/docs/vi-VN/advanced-config/README.md +++ b/docs/vi-VN/advanced-config/README.md @@ -8,6 +8,52 @@ Các tùy chỉnh được mô tả trong phần này có thể sẽ thay đổi ::: +## 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 @@ Chuỗi kiểu là một danh sách các từ, được phân cách bởi khoả - `underline` - `dimmed` - `đảo ngược` +- `blink` +- `hidden` +- `strikethrough` - `bg:<color>` - `fg:<color>` - `<color>` @@ -201,3 +250,9 @@ Một quy định màu có thể là một trong các thứ sau: - Một số nằm giữa 0-255. Cái này quy định một [mã màu ANSI 8-bit](https://i.stack.imgur.com/KTSQa.png). Nếu nhiều màu được quy định cho màu chữ/màu nền, cái cuối cùng trong chuỗi sẽ được ưu tiên. + +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/vi-VN/config/README.md b/docs/vi-VN/config/README.md index efda87403..8d50bdf28 100644 --- a/docs/vi-VN/config/README.md +++ b/docs/vi-VN/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 Cái này là danh sách các tuỳ chọn cho cấu hình prompt-wide. @@ -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""" ``` @@ -304,7 +317,7 @@ When using [AWSume](https://awsu.me) the profile is read from the `AWSUME_PROFIL *: Biến này có thể chỉ được sử dụng như một phần của style string -### Các ví dụ +### Các vị dụ #### Hiển thị mọi thứ @@ -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. Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn: + +- Đường dẫn hiện tại chứa một tập tin `bun.lockb` +- Đường dẫn hiện tại chứa một tập tin `bunfig.toml` + +### Các tuỳ chọn + +| Tuỳ chọn | Mặc định | Mô tả | +| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- | +| `format` | `"via [$symbol($version )]($style)"` | Định dạng cho module. | +| `version_format` | `"v${raw}"` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | +| `symbol` | `"🍞 "` | A format string representing the symbol of Node.js. | +| `detect_extensions` | `[]` | Những tiện ích mở rộng nào sẽ kích hoạt mô-đun này. | +| `detect_files` | `["bun.lockb", "bunfig.toml"]` | Những tên tệp nào sẽ kích hoạt mô-đun này. | +| `detect_folders` | `[]` | Những thư mục nào sẽ kích hoạt mô-đun này. | +| `style` | `"bold red"` | Kiểu cho module. | +| `disabled` | `false` | Disables the `bun` module. | + +### Các biến + +| Biến | Ví dụ | Mô tả | +| --------- | -------- | -------------------------------- | +| version | `v0.1.4` | The version of `bun` | +| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | +| style\* | | Giá trị ghi đè của `style` | + +*: Biến này có thể chỉ được sử dụng như một phần của style string + +### Ví dụ + +```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. @@ -561,7 +613,7 @@ Mặc định, nó chỉ thay đổi màu. If you also want to change its shape | ------ | ----- | ----------------------------------------------------------------------------- | | symbol | | Một phản ánh của một trong `success_symbol`, `error_symbol` or `vicmd_symbol` | -### Các ví dụ +### Các vị dụ #### Có tuỳ chỉnh hình dạng lỗi @@ -811,7 +863,7 @@ format = "via [✨ $version](bold blue) " 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. Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn: -- The current directory contains a `daml.yaml` file +- Đường dẫn hiện tại chứa một tập tin `daml.yaml` ### Các tuỳ chọn @@ -1336,7 +1388,7 @@ Mô đun `gcloud` hiển thị cấu hình hiện tại của [`gcloud`](https:/ *: Biến này có thể chỉ được sử dụng như một phần của style string -### Các ví dụ +### Các vị dụ #### Hiển thị tài khoản và dự án @@ -1986,18 +2038,23 @@ Displays the current [Kubernetes context](https://kubernetes.io/docs/concepts/co Mặc định, mô đun này được vô hiệu. Để kích hoạt nó, thiết lập `disabled` sang `false` trong tập tin cấu hình của bạn. +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. + ::: ### Các tuỳ chọn -| Tuỳ chọn | Mặc định | Mô tả | -| ----------------- | ---------------------------------------------------- | --------------------------------------------------------------------- | -| `symbol` | `"☸ "` | A format string representing the symbol displayed before the Cluster. | -| `format` | `'[$symbol$context( \($namespace\))]($style) in '` | Định dạng cho module. | -| `style` | `"cyan bold"` | Kiểu cho module. | -| `context_aliases` | | Table of context aliases to display. | -| `user_aliases` | | Table of user aliases to display. | -| `disabled` | `true` | Disables the `kubernetes` module. | +| Tuỳ chọn | Mặc định | Mô tả | +| ------------------- | ---------------------------------------------------- | --------------------------------------------------------------------- | +| `symbol` | `"☸ "` | A format string representing the symbol displayed before the Cluster. | +| `format` | `'[$symbol$context( \($namespace\))]($style) in '` | Định dạng cho module. | +| `style` | `"cyan bold"` | Kiểu cho module. | +| `context_aliases` | | Table of context aliases to display. | +| `user_aliases` | | Table of user aliases to display. | +| `detect_extensions` | `[]` | Những tiện ích mở rộng nào sẽ kích hoạt mô-đun này. | +| `detect_files` | `[]` | Những tên tệp nào sẽ kích hoạt mô-đun này. | +| `detect_folders` | `[]` | Những thư mục nào nên kích hoạt các mô đun này. | +| `disabled` | `true` | Disables the `kubernetes` module. | ### Các biến @@ -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 Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn: - 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` ### Các tuỳ chọn @@ -2589,6 +2656,7 @@ Mặc định module sẽ được hiển thị nếu có bất kì điều ki | `version_format` | `"v${raw}"` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | | `symbol` | `" "` | A format string shown before the Pulumi stack. | | `style` | `"bold 5"` | Kiểu cho module. | +| `search_upwards` | `true` | Enable discovery of pulumi config files in parent directories. | | `disabled` | `false` | Disables the `pulumi` module. | ### Các biến @@ -3032,7 +3100,7 @@ Mặc định, mô đun này được vô hiệu. Để kích hoạt nó, thiế *: Biến này có thể chỉ được sử dụng như một phần của style string -### Các ví dụ +### Các vị dụ ```toml # ~/.config/starship.toml @@ -3158,22 +3226,23 @@ Mặc định, mô đun này được vô hiệu. Để kích hoạt nó, thiế ### Các tuỳ chọn -| Tuỳ chọn | Mặc định | Mô tả | -| ----------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------- | -| `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"` | Kiểu cho 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` | `|` | | -| `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. | +| Tuỳ chọn | Mặc định | Mô tả | +| --------------------------- | ------------------------------------------------------------------------------------ | --------------------------------------------------------------------- | +| `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"` | Kiểu cho 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>|</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. | ### Các biến diff --git a/docs/vi-VN/presets/bracketed-segments.md b/docs/vi-VN/presets/bracketed-segments.md index 6f5ab8a6d..36d3ef2c8 100644 --- a/docs/vi-VN/presets/bracketed-segments.md +++ b/docs/vi-VN/presets/bracketed-segments.md @@ -8,6 +8,10 @@ This preset changes the format of all the built-in modules to show their segment ### Cấu hình +```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/vi-VN/presets/nerd-font.md b/docs/vi-VN/presets/nerd-font.md index f333b1ba0..f2299291e 100644 --- a/docs/vi-VN/presets/nerd-font.md +++ b/docs/vi-VN/presets/nerd-font.md @@ -12,6 +12,10 @@ This preset changes the symbols for each module to use Nerd Font symbols. ### Cấu hình +```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/vi-VN/presets/no-runtimes.md b/docs/vi-VN/presets/no-runtimes.md index 351bed7c1..6d4cc904f 100644 --- a/docs/vi-VN/presets/no-runtimes.md +++ b/docs/vi-VN/presets/no-runtimes.md @@ -8,6 +8,10 @@ This preset hides the version of language runtimes. If you work in containers or ### Cấu hình +```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/vi-VN/presets/pastel-powerline.md b/docs/vi-VN/presets/pastel-powerline.md index c8570b4de..c98b10a23 100644 --- a/docs/vi-VN/presets/pastel-powerline.md +++ b/docs/vi-VN/presets/pastel-powerline.md @@ -12,6 +12,10 @@ This preset is inspired by [M365Princess](https://github.com/JanDeDobbeleer/oh-m ### Cấu hình +```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/vi-VN/presets/plain-text.md b/docs/vi-VN/presets/plain-text.md index 0ed3d690b..3798b0637 100644 --- a/docs/vi-VN/presets/plain-text.md +++ b/docs/vi-VN/presets/plain-text.md @@ -8,6 +8,10 @@ This preset changes the symbols for each module into plain text. Great if you do ### Cấu hình +```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/vi-VN/presets/pure-preset.md b/docs/vi-VN/presets/pure-preset.md index 375adea38..f346ec70c 100644 --- a/docs/vi-VN/presets/pure-preset.md +++ b/docs/vi-VN/presets/pure-preset.md @@ -8,6 +8,10 @@ This preset emulates the look and behavior of [Pure](https://github.com/sindreso ### Cấu hình +```sh +starship preset pure-preset > ~/.config/starship.toml +``` + [Click to download TOML](/presets/toml/pure-preset.toml) <<< @/.vuepress/public/presets/toml/pure-preset.toml |