147 lines
9.2 KiB
Markdown
147 lines
9.2 KiB
Markdown
# Налаштування командного рядка
|
||
|
||
Ця сторінка описує опції командного рядка Spaceship.
|
||
|
||
## Термінологія
|
||
|
||
Командний рядок складається з **секцій**. Всі секції поєднуються в [**послідовність командного рядка**](#prompt-order).
|
||
|
||
Під час процесу відображення командний рядок проходить по послідовності та викликає кожну секцію. Якщо ви хочете додати власну секцію – додайте її в послідовність. Ви можете додавати чи вилучати секціїї з послідовності командного рядка в будь-який час.
|
||
|
||
Типова секція складається з **префіксу**, **символу**, **змісту** та **суфіксу**. Символ та зміст виділяються **кольором**. Ось приклад для секції `package`:
|
||
|
||
```
|
||
is 📦 3.16.5
|
||
```
|
||
|
||
У наведеному вище, `is` є префіксом, `📦` символом, `3.16.5` змістом, а `` (пробіл) суфіксом.
|
||
|
||
Кожна складова секції може бути налаштована за допомогою відповідних **опцій**. Опції це звичайні змінні середовища з такою сигнатурою: `SPACESHIP_<SECTION>_<OPTION>`:
|
||
|
||
```zsh
|
||
# SPACESHIP_<SECTION>_<OPTION>
|
||
SPACESHIP_PACKAGE_PREFIX="via·"
|
||
SPACESHIP_PACKAGE_SUFFIX=" "
|
||
SPACESHIP_PACKAGE_COLOR="green"
|
||
```
|
||
|
||
У прикладі вище `PACKAGE` це **секція**, а `PREFIX`, `SUFFIX` та `COLOR` це **опції** для префіксу, суфіксу та кольору відповідно.
|
||
|
||
!!! info
|
||
Допускається використання [базових кольорів](https://wiki.archlinux.org/index.php/zsh#Colors) або [кольорових кодів](https://upload.wikimedia.org/wikipedia/commons/1/15/Xterm_256color_chart.svg).
|
||
|
||
## Послідовність командного рядка
|
||
|
||
**Послідовність командного рядка** визначає порядок, в якому секції виконуються і відображаються. Порядок секцій у командному рядку контролюється опцією `SPACESHIP_PROMPT_ORDER`.
|
||
|
||
За замовчуванням, порядок секцій наступний:
|
||
|
||
```zsh
|
||
SPACESHIP_PROMPT_ORDER=(
|
||
time # Time stamps section
|
||
user # Username section
|
||
dir # Current directory section
|
||
host # Hostname section
|
||
git # Git section (git_branch + git_status)
|
||
hg # Mercurial section (hg_branch + hg_status)
|
||
package # Package version
|
||
node # Node.js section
|
||
bun # Bun section
|
||
deno # Deno section
|
||
ruby # Ruby section
|
||
python # Python section
|
||
elm # Elm section
|
||
elixir # Elixir section
|
||
xcode # Xcode section
|
||
swift # Swift section
|
||
golang # Go section
|
||
php # PHP section
|
||
rust # Rust section
|
||
haskell # Haskell Stack section
|
||
java # Java section
|
||
lua # Lua section
|
||
dart # Dart section
|
||
julia # Julia section
|
||
crystal # Crystal section
|
||
docker # Docker section
|
||
aws # Amazon Web Services section
|
||
gcloud # Google Cloud Platform section
|
||
venv # virtualenv section
|
||
conda # conda virtualenv section
|
||
dotnet # .NET section
|
||
kubectl # Kubectl context section
|
||
terraform # Terraform workspace section
|
||
ibmcloud # IBM Cloud section
|
||
exec_time # Execution time
|
||
async # Async jobs indicator
|
||
line_sep # Line break
|
||
battery # Battery level and status
|
||
jobs # Background jobs indicator
|
||
exit_code # Exit code section
|
||
char # Prompt character
|
||
)
|
||
```
|
||
|
||
Ви можете додавати та видаляти секції за допомогою команд `spaceship add` та `spaceship remove` таким чином:
|
||
|
||
```zsh
|
||
# Видаляє секцію git з командного рядка
|
||
spaceship remove git
|
||
|
||
# Додає секцію git до командного рядка
|
||
spaceship add git
|
||
```
|
||
|
||
### Послідовність правого командного рядка
|
||
|
||
Також ви можете додавати секції праворуч від командного рядка, вказуючи їх у опції `SPACESHIP_RPROMPT_ORDER`. За замовчуванням, `SPACESHIP_RPROMPT_ORDER` – порожній масив.
|
||
|
||
## Налаштування секцій
|
||
|
||
Ви можете налаштовувати кожну секцію командного рядка за допомогою опцій секції. Подивіться документацію секцій для отримання додаткової інформації.
|
||
|
||
Крім використання вбудованих секцій, ви можете додавати сторонні секції або створити власні.
|
||
|
||
[Подивитися вбудовані секції](/sections ""){.md-button} [Подивитися всі секції](/registry ""){.md-button}
|
||
|
||
## Налаштування командного рядка
|
||
|
||
Ця група налаштувань визначає поведінку командного рядка і стандартні параметри відображення секцій.
|
||
|
||
| Змінна | За замовчуванням | Пояснення |
|
||
|:------------------------------------ |:----------------:| ------------------------------------------------- |
|
||
| `SPACESHIP_PROMPT_ASYNC` | `true` | Чи відображати командний рядок асинхронно |
|
||
| `SPACESHIP_PROMPT_ADD_NEWLINE` | `true` | Додає символ нового рядка перед кожним запитом |
|
||
| `SPACESHIP_PROMPT_SEPARATE_LINE` | `true` | Розтягнути командний рядок на два рядки |
|
||
| `SPACESHIP_PROMPT_FIRST_PREFIX_SHOW` | `false` | Показати префікс першої секції в командному рядку |
|
||
| `SPACESHIP_PROMPT_PREFIXES_SHOW` | `true` | Чи показувати префікси секцій |
|
||
| `SPACESHIP_PROMPT_SUFFIXES_SHOW` | `true` | Чи показувати суфікси секцій |
|
||
| `SPACESHIP_PROMPT_DEFAULT_PREFIX` | `via·` | Префікс за замовчуванням для секцій |
|
||
| `SPACESHIP_PROMPT_DEFAULT_SUFFIX` | `` | Суфікс за замовчуванням для секцій |
|
||
|
||
Трохи більше про ці налаштування:
|
||
|
||
### Асинхронне відображення
|
||
|
||
Опція `SPACESHIP_PROMPT_ASYNC` визначає, чи має командний рядок відображатися асинхронно, чи ні. За замовчуванням, він відображається асинхронно.
|
||
|
||
Синхронні секції показуються миттєво. Асинхронні секції обробляються у фоні та показуються коли інформація готова до відображення.
|
||
|
||
[Cекція `async`](/sections/async) заміняє асинхронні секції, поки вони завантажуються.
|
||
|
||
### Відступи командного рядка
|
||
|
||
Spaceship додає порожній рядок між запитами. Ви можете вимкнути цю поведінку, змінивши значення опції `SPACESHIP_PROMPT_ADD_NEWLINE` на `false`.
|
||
|
||
Командний рядок також виділяється новим рядком якщо `SPACESHIP_PROMPT_SEPARATE_LINE` має значення `true`.
|
||
|
||
### Відображення префіксу першої секції
|
||
|
||
Spaceship приховує префікс першої секції командного рядка. Ви можете увімкнути цю поведінку, встановивши `SPACESHIP_PROMPT_FIRST_PREFIX_SHOW` у `true`.
|
||
|
||
### Відображення префіксів та суфіксів
|
||
|
||
Ви можете вимкнути відображення префіксів та суфіксів, встановивши `SPACESHIP_PROMPT_PREFIXES_SHOW` та `SPACESHIP_PROMPT_SUFFIXES_SHOW` у `false`.
|
||
|
||
Додатково ви можете змінити префікс та суфікс за замовчуванням за допомогою опцій `SPACESHIP_PROMPT_DEFAULT_PREFIX` та `SPACESHIP_PROMPT_DEFAULT_SUFFIX`. Ці значення будуть використані для відображення префіксів або суфіксів, якщо не встановлено відповідні опції секції.
|