summaryrefslogtreecommitdiffstats
path: root/docs/zh-TW
diff options
context:
space:
mode:
authorMatan Kushner <hello@matchai.dev>2020-06-19 17:05:45 -0400
committerGitHub <noreply@github.com>2020-06-19 17:05:45 -0400
commitee3c0ec9d540898de27b747946764fd8410874eb (patch)
treed77fa5db99584ca16a51bfebbe5f8ff0803834a6 /docs/zh-TW
parent611a754ec75a17d98c27807e943898b9a1ab058f (diff)
docs(i18n): new Crowdin translations (#1325)
Diffstat (limited to 'docs/zh-TW')
-rw-r--r--docs/zh-TW/config/README.md226
-rw-r--r--docs/zh-TW/faq/README.md19
2 files changed, 141 insertions, 104 deletions
diff --git a/docs/zh-TW/config/README.md b/docs/zh-TW/config/README.md
index d3a620b9e..b4b31ad9f 100644
--- a/docs/zh-TW/config/README.md
+++ b/docs/zh-TW/config/README.md
@@ -9,7 +9,7 @@
為了開始設定 Starship,請建立下右檔案: `~/.config/starship.toml`.
```sh
-$ mkdir -p ~/.config && touch ~/.config/starship.toml
+mkdir -p ~/.config && touch ~/.config/starship.toml
```
所有關於 Starship 的設定都在這個 [TOML](https://github.com/toml-lang/toml) 檔案內:
@@ -375,11 +375,11 @@ style = "bold blue"
<details>
<summary>這個模組有些進階設定選項可以控制顯示資料夾。</summary>
-| 變數 | 預設 | 說明 |
-| --------------------------- | ------ | ---------------------------------------------------------------------------------------- |
-| `substitutions` | | A table of substitutions to be made to the path. |
-| `fish_style_pwd_dir_length` | `0` | The number of characters to use when applying fish shell pwd path logic. |
-| `use_logical_path` | `true` | Displays the logical path provided by the shell (`PWD`) instead of the path from the OS. |
+| 變數 | 預設 | 說明 |
+| --------------------------- | ------ | ------------------------------------------------ |
+| `substitutions` | | A table of substitutions to be made to the path. |
+| `fish_style_pwd_dir_length` | `0` | 當使用 fish shell 的 pwd 路徑邏輯時使用的字元數量。 |
+| `use_logical_path` | `true` | 顯示 shell (`PWD`) 提供的邏輯路徑,而不是 OS 的路徑。 |
`substitutions` allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories (i.e. Java). Note that this will disable the fish style PWD.
@@ -426,11 +426,11 @@ symbol = "🐋 "
## Dotnet
-The `dotnet` module shows the relevant version of the .NET Core SDK for the current directory. If the SDK has been pinned in the current directory, the pinned version is shown. Otherwise the module shows the latest installed version of the SDK.
+`dotnet` 模組顯示現在資料夾使用的 .NET Core SDK 的版本。 如果這個資料夾已經選定一個 SDK,則顯示這個 SDK 的版本。 如果沒有的話,則顯示最新安裝的 SDK 版本。
-This module will only be shown in your prompt when one of the following files are present in the current directory: `global.json`, `project.json`, `*.sln`, `*.csproj`, `*.fsproj`, `*.xproj`. You'll also need the .NET Core command-line tools installed in order to use it correctly.
+這個模組只會在下列檔案出現在你的現在資料夾中時,顯示在你的提示字元:`global.json`、`project.json`、`*.sln`、`*.csproj`、`*.fsproj`、`*.xproj`。 你也會需要安裝 .NET Core 文字命令工具來正確使用這個模組。
-Internally, this module uses its own mechanism for version detection. Typically it is twice as fast as running `dotnet --version`, but it may show an incorrect version if your .NET project has an unusual directory layout. If accuracy is more important than speed, you can disable the mechanism by setting `heuristic = false` in the module options.
+這個模組內部是使用它自己的機制來偵測版本。 一般來說這個模組有 `dotnet --version` 的兩倍快,但是它可能會在你的 .NET 專案有不尋常的資料夾結構時顯示不正確的版本。 如果精確度比速度更重要的話,你可以藉由設定模組中的 `heuristic = false` 選項來停用這個功能。
### 選項
@@ -505,7 +505,7 @@ symbol = " "
## 環境變數
-The `env_var` module displays the current value of a selected environment variable. The module will be shown only if any of the following conditions are met:
+`env_var`模組顯示一個選擇的環境變數的現在數值。 這個模組只在下列條件其中之一達到時顯示:
- `variable` 設定選項符合一個存在的環境變數。
- 沒有設定 `variable` 選項,但是有設定 `default` 選項。
@@ -558,7 +558,7 @@ symbol = "e "
## Git 分支
-The `git_branch` module shows the active branch of the repo in your current directory.
+`git_branch` 模組顯示現在的資料夾中使用中的儲存庫的分支。
### 選項
@@ -607,7 +607,7 @@ commit_hash_length = 4
## Git State
-The `git_state` module will show in directories which are part of a git repository, and where there is an operation in progress, such as: _REBASING_, _BISECTING_, etc. If there is progress information (e.g., REBASING 3/10), that information will be shown too.
+`git_state` 模組會顯示在 git 儲存庫中的資料夾內,以及會在有作業正在進行時顯示,像是:_REBASING_、_BISECTING_ 等等。 如果有進展的資訊 (像是 REBASING 3/10),也會一併顯示出來。
### 選項
@@ -636,7 +636,7 @@ cherry_pick = "🍒 PICKING"
## Git Status
-The `git_status` module shows symbols representing the state of the repo in your current directory.
+`git_status` 模組顯示用來表示現在資料夾之中儲存庫狀態的符號。
### 選項
@@ -695,7 +695,7 @@ deleted = "🗑"
## Golang
-The `golang` module shows the currently installed version of Golang. 這個模組在下列其中一個條件達成時顯示:
+`golang` 模組顯示現在安裝的 Golang 版本。 這個模組在下列其中一個條件達成時顯示:
- 現在資料夾中含有一個 `go.mod` 檔案
- 現在資料夾中含有一個 `go.sum` 檔案
@@ -748,7 +748,7 @@ symbol = " "
## 主機名稱
-The `hostname` module shows the system hostname.
+`hostname` 模組顯示系統的主機名稱。
### 選項
@@ -776,7 +776,7 @@ disabled = false
## Java
-The `java` module shows the currently installed version of Java. 這個模組在下列其中一個條件達成時顯示:
+`java` 模組顯示現在安裝的 Java 版本。 這個模組在下列其中一個條件達成時顯示:
- The current directory contains a `pom.xml`, `build.gradle.kts`, `build.sbt` or `.java-version` file
- The current directory contains a file with the `.java`, `.class`, `.gradle` or `.jar` extension
@@ -800,7 +800,7 @@ symbol = "🌟 "
## 工作
-The `jobs` module shows the current number of jobs running. The module will be shown only if there are background jobs running. The module will show the number of jobs running if there is more than 1 job, or more than the `threshold` config value, if it exists.
+`jobs` 模組顯示現在正在執行中的工作。 這個模組只會在有背景工作正在執行時顯示。 這個模組會在工作數量超過一個,或者有設定 `threshold` 時且數量超過設定值時,顯示工作的數量。
### 選項
@@ -847,11 +847,11 @@ symbol = "∴ "
```
## Kubernetes
-Displays the current Kubernetes context name and, if set, the namespace from the kubeconfig file. The namespace needs to be set in the kubeconfig file, this can be done via `kubectl config set-context starship-cluster --namespace astronaut`. If the `$KUBECONFIG` env var is set the module will use that if not it will use the `~/.kube/config`.
+顯示現在 Kubernetes 主體名稱以及從 kubeconfig 檔案來的名稱空間 (如果有設定的話)。 The namespace needs to be set in the kubeconfig file, this can be done via `kubectl config set-context starship-cluster --namespace astronaut`. 如果有設定 `$KUBECONFIG` 環境變數,這個模組就會使用設定值;如果沒有,它就會使用 `~/.kube/config`。
::: tip
-This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
+這個模組預設是停用的。 想要啟用它的話,請在設定檔中將 `disabled` 設定為 `false`。
:::
@@ -879,7 +879,7 @@ disabled = false
## 換行
-The `line_break` module separates the prompt into two lines.
+`line_break` 模組將提示字元分成兩行。
### 選項
@@ -898,13 +898,13 @@ disabled = true
## 記憶體使用量
-The `memory_usage` module shows current system memory and swap usage.
+`memory_usage` 模組顯示現在系統記憶體與 swap 的使用量。
-By default the swap usage is displayed if the total system swap is non-zero.
+預設 swap 使用量會在系統總 swap 使用量不為 0 時顯示出來。
::: tip
-This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
+這個模組預設是停用的。 想要啟用它的話,請在設定檔中將 `disabled` 設定為 `false`。
:::
@@ -988,18 +988,18 @@ symbol = "🎣 "
## Nix-shell
-The `nix_shell` module shows the nix-shell environment. The module will be shown when inside a nix-shell environment.
+`nix_shell` 模組顯示 nix-shell 環境。 這個模組會在 nix-shell 環境中顯示。
### 選項
| 變數 | 預設 | 說明 |
| ------------ | ------------- | ------------------------------------------------- |
-| `use_name` | `false` | Display the name of the nix-shell. |
-| `impure_msg` | `"impure"` | Customize the "impure" msg. |
-| `pure_msg` | `"pure"` | Customize the "pure" msg. |
+| `use_name` | `false` | 顯示 nix-shell 的名稱。 |
+| `impure_msg` | `"impure"` | 自定義「impure」訊息。 |
+| `pure_msg` | `"pure"` | 自定義「pure」訊息。 |
| `symbol` | `"❄️ "` | The symbol used before displaying the shell name. |
| `style` | `"bold blue"` | 這個模組的風格。 |
-| `disabled` | `false` | Disables the `nix_shell` module. |
+| `disabled` | `false` | 停用 `nix_shell` 模組。 |
### 範例
@@ -1016,20 +1016,20 @@ symbol = "☃️ "
## NodeJS
-The `nodejs` module shows the currently installed version of NodeJS. 這個模組在下列其中一個條件達成時顯示:
+`nodejs` 模組顯示現在安裝的 NodeJS 版本。 這個模組在下列其中一個條件達成時顯示:
-- The current directory contains a `package.json` file
+- 現在資料夾中包含一個 `package.json` 檔案
- The current directory contains a `.node-version` file
-- The current directory contains a `node_modules` directory
-- The current directory contains a file with the `.js` extension
+- 現在資料夾中包含一個 `node_modules` 資料夾
+- 現在資料夾中包含一個檔案具有 `.js` 副檔名
### 選項
-| 變數 | 預設 | 說明 |
-| ---------- | -------------- | -------------------------------------------------------- |
-| `symbol` | `"⬢ "` | The symbol used before displaying the version of NodeJS. |
-| `style` | `"bold green"` | 這個模組的風格。 |
-| `disabled` | `false` | Disables the `nodejs` module. |
+| 變數 | 預設 | 說明 |
+| ---------- | -------------- | -------------------- |
+| `symbol` | `"⬢ "` | 在顯示 NodeJS 版本之前用的符號。 |
+| `style` | `"bold green"` | 這個模組的風格。 |
+| `disabled` | `false` | 停用 `nodejs` 模組。 |
### 範例
@@ -1040,13 +1040,13 @@ The `nodejs` module shows the currently installed version of NodeJS. 這個模
symbol = "🤖 "
```
-## Package Version
+## 套件版本
-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`, `cargo`, `poetry`, `composer`, `gradle`, `julia` and `mix` packages.
+The `package` 模組在現在資料夾是一個套件的儲藏庫時出現,並顯示他的現在版本。 The module currently supports `npm`, `cargo`, `poetry`, `composer`, `gradle`, `julia` and `mix` packages.
-- **npm** – The `npm` package version is extracted from the `package.json` present in the current directory
-- **cargo** – The `cargo` package version is extracted from the `Cargo.toml` present in the current directory
-- **poetry** – The `poetry` package version is extracted from the `pyproject.toml` present in the current directory
+- **npm** – `npm` 套件的版本是從現在資料夾中的 `package.json` 之中擷取出來的
+- **cargo** – `cargo` 套件的版本是從現在資料夾中的 `Cargo.toml` 之中擷取出來的
+- **poetry** – `poetry` 套件的版本是從現在資料夾中的 `pyproject.toml` 之中擷取出來的
- **composer** – The `composer` package version is extracted from the `composer.json` present in the current directory
- **gradle** – The `gradle` package version is extracted from the `build.gradle` present
- **julia** - The package version is extracted from the `Project.toml` present
@@ -1056,12 +1056,12 @@ The `package` module is shown when the current directory is the repository for a
### 選項
-| 變數 | 預設 | 說明 |
-| ----------------- | ------------ | ---------------------------------------------------------- |
-| `symbol` | `"📦 "` | The symbol used before displaying the version the package. |
-| `style` | `"bold 208"` | 這個模組的風格。 |
-| `display_private` | `false` | Enable displaying version for packages marked as private. |
-| `disabled` | `false` | Disables the `package` module. |
+| 變數 | 預設 | 說明 |
+| ----------------- | ------------ | --------------------------------------------------------- |
+| `symbol` | `"📦 "` | 顯示在套件的版本之前的符號。 |
+| `style` | `"bold 208"` | 這個模組的風格。 |
+| `display_private` | `false` | Enable displaying version for packages marked as private. |
+| `disabled` | `false` | 停用 `package` 模組。 |
### 範例
@@ -1133,26 +1133,44 @@ If `pyenv_version_name` is set to `true`, it will display the pyenv version name
這個模組在下列其中一個條件達成時顯示:
-- The current directory contains a `.python-version` file
-- The current directory contains a `requirements.txt` file
-- The current directory contains a `pyproject.toml` file
+- 目前資料夾中有一個 `.python-version` 檔案
+- 目前資料夾中有一個 `requirements.txt` 檔案
+- 目前資料夾中有一個 `pyproject.toml` 檔案
- The current directory contains a file with the `.py` extension (and `scan_for_pyfiles` is true)
-- The current directory contains a `Pipfile` file
-- The current directory contains a `tox.ini` file
-- The current directory contains a `setup.py` file
+- 目前資料夾中有一個 `Pipfile` 檔案
+- 目前資料夾中有一個 `tox.ini` 檔案
+- 現在資料夾中包含一個 `setup.py` 檔案
- The current directory contains a `__init__.py` file
- A virtual environment is currently activated
### 選項
-| 變數 | 預設 | 說明 |
-| -------------------- | --------------- | --------------------------------------------------------------------------- |
-| `symbol` | `"🐍 "` | The symbol used before displaying the version of Python. |
-| `pyenv_version_name` | `false` | Use pyenv to get Python version |
-| `pyenv_prefix` | `"pyenv "` | Prefix before pyenv version display (default display is `pyenv MY_VERSION`) |
-| `scan_for_pyfiles` | `true` | If false, Python files in the current directory will not show this module. |
-| `style` | `"bold yellow"` | 這個模組的風格。 |
-| `disabled` | `false` | Disables the `python` module. |
+| 變數 | 預設 | 說明 |
+| -------------------- | --------------- | -------------------------------------------------------------------------- |
+| `symbol` | `"🐍 "` | 顯示在 Python 版本之前的符號。 |
+| `pyenv_version_name` | `false` | 使用 pyenv 取得 Python 的版本。 |
+| `pyenv_prefix` | `"pyenv "` | 顯示在 pyenv 版本之前的前綴 (預設顯示是 `pyenv MY_VERSION`)。 |
+| `scan_for_pyfiles` | `true` | If false, Python files in the current directory will not show this module. |
+| `style` | `"bold yellow"` | 這個模組的風格。 |
+| `disabled` | `false` | 停用 `python` 模組。 |
+
+<details>
+<summary>This module has some advanced configuration options.</summary>
+
+| 變數 | 預設 | 說明 |
+| --------------- | -------- | ----------------------------------------------------------------------------- |
+| `python_binary` | `python` | Configures the python binary that Starship executes when getting the version. |
+
+The `python_binary` variable changes the binary that Starship executes to get the version of Python, it doesn't change the arguments that are used.
+
+```toml
+# ~/.config/starship.toml
+
+[python]
+python_binary = "python3"
+```
+
+</details>
### 範例
@@ -1167,19 +1185,19 @@ pyenv_prefix = "foo "
## Ruby
-The `ruby` module shows the currently installed version of Ruby. 這個模組在下列其中一個條件達成時顯示:
+`ruby` 模組顯示現在安裝的 Ruby 版本。 這個模組在下列其中一個條件達成時顯示:
-- The current directory contains a `Gemfile` file
+- 目前資料夾中有一個 `Gemfile` 檔案
- The current directory contains a `.ruby-version` file
-- The current directory contains a `.rb` file
+- 目前資料夾中有一個 `.rb` 檔案
### 選項
-| 變數 | 預設 | 說明 |
-| ---------- | ------------ | ------------------------------------------------------ |
-| `symbol` | `"💎 "` | The symbol used before displaying the version of Ruby. |
-| `style` | `"bold red"` | 這個模組的風格。 |
-| `disabled` | `false` | Disables the `ruby` module. |
+| 變數 | 預設 | 說明 |
+| ---------- | ------------ | ----------------- |
+| `symbol` | `"💎 "` | 顯示在 Ruby 版本之前的符號。 |
+| `style` | `"bold red"` | 這個模組的風格。 |
+| `disabled` | `false` | 停用 `ruby` 模組。 |
### 範例
@@ -1192,18 +1210,18 @@ symbol = "🔺 "
## Rust
-The `rust` module shows the currently installed version of Rust. 這個模組在下列其中一個條件達成時顯示:
+`rust` 模組顯示現在安裝的 Rust 版本。 這個模組在下列其中一個條件達成時顯示:
-- The current directory contains a `Cargo.toml` file
-- The current directory contains a file with the `.rs` extension
+- 目前資料夾中有一個 `Cargo.toml` 檔案
+- 現在資料夾中包含一個檔案具有 `.rs` 副檔名
### 選項
-| 變數 | 預設 | 說明 |
-| ---------- | ------------ | ------------------------------------------------------ |
-| `symbol` | `"🦀 "` | The symbol used before displaying the version of Rust. |
-| `style` | `"bold red"` | 這個模組的風格。 |
-| `disabled` | `false` | Disables the `rust` module. |
+| 變數 | 預設 | 說明 |
+| ---------- | ------------ | ----------------- |
+| `symbol` | `"🦀 "` | 顯示在 Rust 版本之前的符號。 |
+| `style` | `"bold red"` | 這個模組的風格。 |
+| `disabled` | `false` | 停用 `rust` 模組。 |
### 範例
@@ -1263,28 +1281,28 @@ The `terraform` module shows the currently selected terraform workspace and vers
symbol = "🏎💨 "
```
-## Time
+## 時間
-The `time` module shows the current **local** time. The `format` configuration value is used by the [`chrono`](https://crates.io/crates/chrono) crate to control how the time is displayed. Take a look [at the chrono strftime docs](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) to see what options are available.
+`time` 模組顯示目前的**當地**時間. `format` 設定值被 [`chrono`](https://crates.io/crates/chrono) crate 用來控制時間如何顯示。 請看 [chrono 的 strftime 文件](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html)來了解有那些選項可以使用。
::: tip
-This module is disabled by default. To enable it, set `disabled` to `false` in your configuration file.
+這個模組預設是停用的。 想要啟用它的話,請在設定檔中將 `disabled` 設定為 `false`。
:::
### 選項
-| 變數 | 預設 | 說明 |
-| ----------------- | --------------- | ------------------------------------------------------------------------------------------------------------------- |
-| `use_12hr` | `false` | Enables 12 hour formatting. |
-| `format` | see below | The [chrono format string](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html) used to format the time. |
-| `style` | `"bold yellow"` | The style for the module time. |
-| `utc_time_offset` | `"local"` | Sets the UTC offset to use. Range from -24 < x < 24. Allows floats to accommodate 30/45 minute timezone offsets. |
-| `disabled` | `true` | Disables the `time` module. |
-| `time_range` | `"-"` | Sets the time range during which the module will be shown. Times must be specified in 24-hours format |
+| 變數 | 預設 | 說明 |
+| ----------------- | --------------- | ----------------------------------------------------------------------------------------------------- |
+| `use_12hr` | `false` | Enables 12 hour formatting. |
+| `format` | 請看下列 | 用來顯示時間的 [chrono 格式字串](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html)。 |
+| `style` | `"bold yellow"` | The style for the module time. |
+| `utc_time_offset` | `"local"` | 設定相對於 UTC 的時差。 範圍 -24 < x < 24。 允許使用浮點數來表示 30/45 分鐘時差的時區。 |
+| `disabled` | `true` | 停用 `time` 模組。 |
+| `time_range` | `"-"` | Sets the time range during which the module will be shown. Times must be specified in 24-hours format |
-If `use_12hr` is `true`, then `format` defaults to `"%r"`. Otherwise, it defaults to `"%T"`. Manually setting `format` will override the `use_12hr` setting.
+如果 `use_12hr` 是 `true` 的話,`format` 會被預設為 `"%r"`。 不然的話,它會被預設為 `"%T"`。 手動設定 `format` 的設定值會覆寫 `use_12hr` 的設定。
### 範例
@@ -1298,23 +1316,23 @@ utc_time_offset = "-5"
time_range = "10:00:00-14:00:00"
```
-## Username
+## 使用者名稱
-The `username` module shows active user's username. 這個模組在下列其中一個條件達成時顯示:
+`username` 模組顯示現在使用中的使用者名稱。 這個模組在下列其中一個條件達成時顯示:
-- The current user is root
-- The current user isn't the same as the one that is logged in
-- The user is currently connected as an SSH session
-- The variable `show_always` is set to true
+- 目前使用者為 root
+- 目前使用者並非登入時的使用者
+- 使用者透過 SSH session 進行連線
+- 變數 `show_always` 被設為 true
### 選項
-| 變數 | 預設 | 說明 |
-| ------------- | --------------- | ------------------------------------- |
-| `style_root` | `"bold red"` | The style used when the user is root. |
-| `style_user` | `"bold yellow"` | The style used for non-root users. |
-| `show_always` | `false` | Always shows the `username` module. |
-| `disabled` | `false` | Disables the `username` module. |
+| 變數 | 預設 | 說明 |
+| ------------- | --------------- | ------------------- |
+| `style_root` | `"bold red"` | 使用者為 root 時使用的風格。 |
+| `style_user` | `"bold yellow"` | 非 root 使用者時使用的風格。 |
+| `show_always` | `false` | 總是顯示 `username` 模組。 |
+| `disabled` | `false` | 停用 `username` 模組。 |
### 範例
@@ -1378,7 +1396,7 @@ The order in which custom modules are shown can be individually set by setting `
| `command` | | The command whose output should be printed. |
| `when` | | A shell command used as a condition to show the module. The module will be shown if the command returns a `0` status code. |
| `shell` | | [See below](#custom-command-shell) |
-| `description` | `"<custom module>"` | The description of the module that is shown when running `starship explain`. |
+| `說明` | `"<custom module>"` | The description of the module that is shown when running `starship explain`. |
| `files` | `[]` | The files that will be searched in the working directory for a match. |
| `directories` | `[]` | The directories that will be searched in the working directory for a match. |
| `extensions` | `[]` | The extensions that will be searched in the working directory for a match. |
@@ -1436,7 +1454,7 @@ shell = ["pwsh.exe", "-NoProfile", "-Command", "-"]
The `purescript` module shows the currently installed version of PureScript version. 這個模組在下列其中一個條件達成時顯示:
-- The current directory contains a `spago.dhall` file
+- 現在資料夾中包含一個 `spago.dhall` 檔案
- The current directory contains a \*.purs files
### 選項
diff --git a/docs/zh-TW/faq/README.md b/docs/zh-TW/faq/README.md
index 709a8e8d0..e6daa9855 100644
--- a/docs/zh-TW/faq/README.md
+++ b/docs/zh-TW/faq/README.md
@@ -51,3 +51,22 @@ If you get an error like "*version 'GLIBC_2.18' not found (required by starship)
```sh
curl -fsSL https://starship.rs/install.sh | bash -s -- --platform unknown-linux-musl
```
+
+## Why don't I see a glyph symbol in my prompt?
+
+The most common cause of this is system misconfiguration. Some Linux distros in particular do not come with font support out-of-the-box. You need to ensure that:
+
+ - Your locale is set to a UTF-8 value, like `de_DE.UTF-8` or `ja_JP.UTF-8`. If `LC_ALL` is not a UTF-8 value, [you will need to change it](https://www.tecmint.com/set-system-locales-in-linux/).
+ - You have an emoji font installed. Most systems come with an emoji font by default, but some (notably Arch Linux) do not. You can usually install one through your system's package manager--[noto emoji](https://www.google.com/get/noto/help/emoji/) is a popular choice.
+ - You are using a [powerline-patched font](https://github.com/powerline/fonts).
+
+To test your system, run the following commands in a terminal:
+
+```
+echo -e "\xf0\x9f\x90\x8d"
+echo -e "\xee\x82\xa0"
+```
+
+The first line should produce a [snake emoji](https://emojipedia.org/snake/), while the second should produce a [powerline branch symbol (e0a0)](https://github.com/ryanoasis/powerline-extra-symbols#glyphs).
+
+If either symbol fails to display correctly, your system is still misconfigured. Unfortunately, getting font configuration correct is sometimes difficult. Users on the Discord may be able to help. If both symbols display correctly, but you still don't see them in starship, [file a bug report!](https://github.com/starship/starship/issues/new/choose)