summaryrefslogtreecommitdiffstats
path: root/docs/zh-TW/config/README.md
diff options
context:
space:
mode:
authorMatan Kushner <hello@matchai.dev>2022-08-14 15:31:27 -0400
committerGitHub <noreply@github.com>2022-08-14 15:31:27 -0400
commit47f22c82c498518c1fbfb6e75f1ff0424699f785 (patch)
tree9e552877c9c17edcf93dcd2ce7accefa2010cdaa /docs/zh-TW/config/README.md
parent37f350a476d74683c0950dbf809bb2d007595577 (diff)
docs(i18n): new Crowdin updates (#4124)
Diffstat (limited to 'docs/zh-TW/config/README.md')
-rw-r--r--docs/zh-TW/config/README.md127
1 files changed, 98 insertions, 29 deletions
diff --git a/docs/zh-TW/config/README.md b/docs/zh-TW/config/README.md
index 00fe85ed0..50f28ff67 100644
--- a/docs/zh-TW/config/README.md
+++ b/docs/zh-TW/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"]
+```
+
## 提示字元
以下是針對提示字元內容的設定。
@@ -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:
+
+- 現在資料夾中含有一個 `bun.lockb` 檔案
+- 現在資料夾中含有一個 `bunfig.toml` 檔案
+
+### 選項
+
+| 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 Node.js. |
+| `detect_extensions` | `[]` | Which extensions should trigger this module. |
+| `detect_files` | `["bun.lockb", "bunfig.toml"]` | Which filenames should trigger this module. |
+| `detect_folders` | `[]` | Which folders should trigger this module. |
+| `style` | `"bold red"` | 這個模組的風格。 |
+| `disabled` | `false` | Disables the `bun` module. |
+
+### Variables
+
+| 變數 | 範例 | 說明 |
+| --------- | -------- | ------------------------------------ |
+| 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
+
+### 範例
+
+```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.
@@ -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. By default the module will be shown if any of the following conditions are met:
-- The current directory contains a `daml.yaml` file
+- 現在資料夾中含有一個 `daml.yaml` 檔案
### 選項
@@ -851,7 +903,7 @@ The `dart` module shows the currently installed version of [Dart](https://dart.d
- The current directory contains a file with `.dart` extension
- The current directory contains a `.dart_tool` directory
-- The current directory contains a `pubspec.yaml`, `pubspec.yml` or `pubspec.lock` file
+- 現在資料夾中包含一個 `pubspec.yaml`、`pubspec.yml` 或 `pubspec.lock` 檔案
### 選項
@@ -1986,18 +2038,23 @@ Displays the current [Kubernetes context](https://kubernetes.io/docs/concepts/co
這個模組預設是停用的。 想要啟用它的話,請在設定檔中將 `disabled` 設定為 `false`。
+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.
+
:::
### 選項
-| Option | 預設 | 說明 |
-| ----------------- | ---------------------------------------------------- | --------------------------------------------------------------------- |
-| `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"` | 這個模組的風格。 |
-| `context_aliases` | | Table of context aliases to display. |
-| `user_aliases` | | Table of user aliases to display. |
-| `disabled` | `true` | Disables the `kubernetes` module. |
+| Option | 預設 | 說明 |
+| ------------------- | ---------------------------------------------------- | --------------------------------------------------------------------- |
+| `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"` | 這個模組的風格。 |
+| `context_aliases` | | Table of context aliases to display. |
+| `user_aliases` | | Table of user aliases to display. |
+| `detect_extensions` | `[]` | Which extensions should trigger this module. |
+| `detect_files` | `[]` | Which filenames should trigger this module. |
+| `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`
### 選項
@@ -2589,6 +2656,7 @@ By default the module will be shown if any of the following conditions are met:
| `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"` | 這個模組的風格。 |
+| `search_upwards` | `true` | Enable discovery of pulumi config files in parent directories. |
| `disabled` | `false` | Disables the `pulumi` module. |
### Variables
@@ -3158,22 +3226,23 @@ The `status` module displays the exit code of the previous command. If $success_
### 選項
-| Option | 預設 | 說明 |
-| ----------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------- |
-| `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"` | 這個模組的風格。 |
-| `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. |
+| Option | 預設 | 說明 |
+| --------------------------- | ------------------------------------------------------------------------------------ | --------------------------------------------------------------------- |
+| `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"` | 這個模組的風格。 |
+| `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` | Disables the `status` module. |
### Variables