andrei/starship
1
0
Fork 0
mirror of https://github.com/starship/starship.git synced 2026-06-21 02:02:14 +07:00
Code Issues Packages Projects Releases 10 Wiki Activity

New translations readme.md (Ukrainian)

Browse Source 
[ci skip]
This commit is contained in:
Matan Kushner
2026-06-12 13:47:54 -04:00
parent 4f17821875
commit 79fec5880a
1 changed files with 177 additions and 108 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/uk-UA/advanced-config/README.md
+177 -108
View File
@@ -1,14 +1,21 @@
# Розширені налаштування
Хоча Starship і універсальна оболонка, іноді необхідно зробити більше ніж просто змінити `star.toml`, щоб можна було робити певні речі. Ця сторінка містить деякі з найбільш докладних методів налаштувань, які використовуються у starship.
While Starship is a versatile shell, sometimes you need to do more than edit
`starship.toml` to get it to do certain things. Ця сторінка містить деякі з найбільш
докладних методів налаштувань, які використовуються у starship.
> [!WARNING] Конфігурації в цьому розділі можуть бути змінені в майбутніх випусках Starship.
## TransientPrompt у PowerShell
Можна замінити попередній командний рядок на власний. Це корисно у випадках, коли вся інформація у ньому не завжди потрібна. Щоб увімкнути це, запустіть `Enable-TransientPrompt` в сеансі оболонки. Щоб зробити цю поведінку постійною, додайте цю команду у ваш `$PROFILE`. Перехідність можна вимкнути на льоту за допомогою `Disable-TransientPrompt`.
Можна замінити попередній командний рядок на власний. Це корисно у випадках, коли вся інформація у ньому не завжди потрібна. 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`.
Типово, ліва частина вводу буде замінена на `>`. Щоб налаштувати це, створіть нову функцію з назвою `Invoke-Starship-TransientFunction`. Наприклад, щоб показати тут модуль Starship `character`, вам потрібно
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 {
@@ -22,15 +29,20 @@ Enable-TransientPrompt
## TransientPrompt та TransientRightPrompt в Cmd
Clink дозволяє замінювати попередньо надрукований командний рядок іншим рядком. Це корисно у випадках, коли вся інформація з командного рядка не потрібна. Щоб увімкнути це, виконайте `clink set prompt.transient <value>`, де \<value\> може бути одним з:
Clink дозволяє замінювати попередньо надрукований командний рядок іншим рядком. Це корисно у випадках, коли вся інформація у ньому не завжди потрібна. To enable
this, run `clink set prompt.transient <value>` where \<value\> can be one of:
- `always`: завжди замінює попередній командний рядок
- `same_dir`: замінює попередній командний рядок тільки якщо робоча тека не змінювалась
- `off`: не змінює командний рядок (тобто функцію вимкнено)
Це треба зробити лише один раз. Зробіть наступні зміни у `starship.lua`, щоб налаштувати, що показується ліворуч і праворуч:
Це треба зробити лише один раз. Make the following changes to your `starship.lua`
to customize what gets displayed on the left and on the right:
- Типово, ліва частина вводу буде замінена на `>`. Щоб налаштувати це, створіть нову функцію з назвою `starship_transient_prompt_func`. Ця функція отримує поточний текст командного рядка, з яким ви зможете працювати. Наприклад, щоб показати тут модуль Starship `character`, вам потрібно
- 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)
@@ -41,7 +53,10 @@ end
load(io.popen('starship init cmd'):read("*a"))()
```
- Типово, права частина вводу є порожньою. Щоб кастомізувати її, створіть нову функцію з назвою `starship_transient_rprompt_func`. Ця функція отримує поточний текст командного рядка, з яким ви зможете працювати. Наприклад, щоб показати час, коли була запущена остання команда, ви можете зробити
- Типово, права частина вводу є порожньою. 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)
@@ -52,11 +67,16 @@ load(io.popen('starship init cmd'):read("*a"))()
## TransientPrompt та TransientRightPrompt у Fish
Можна замінити попередньо надрукований командний рядок на власний. Це корисно у випадках, коли вся інформація з командного рядка не потрібна. Щоб увімкнути це, запустіть `enable_transience` в сеансі оболонки. Щоб зробити цю змінну постійною, додайте цей вираз до ваших налаштувань `~/.config/fish/config.fish`. Перехідність може бути вимкнена за допомогою `disable_transience`.
Можна замінити попередній командний рядок на власний. Це корисно у випадках, коли вся інформація у ньому не завжди потрібна. 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`.
Зверніть увагу, що у випадку Fish, перехідний командний рядок буде надруковано лише тоді, коли командний рядок не порожній та синтаксично правильний.
- Типово, ліва частина вводу буде замінена на зелений символ `❯`. Щоб кастомізувати її, створіть нову функцію з назвою `starship_transient_prompt_func`. Наприклад, щоб показати тут модуль Starship `character`, вам потрібно
- 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
@@ -66,7 +86,9 @@ starship init fish | source
enable_transience
```
- Типово, права частина вводу є порожньою. Щоб кастомізувати її, створіть нову функцію з назвою `starship_transient_rprompt_func`. Наприклад, щоб показати час, коли була запущена остання команда, ви можете зробити
- Типово, права частина вводу є порожньою. 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
@@ -78,19 +100,32 @@ enable_transience
## TransientPrompt та TransientRightPrompt в Bash
[Ble.sh](https://github.com/akinomyoga/ble.sh) v0.4 або вище дозволяє замінювати попередньо надрукований командний рядок іншим рядком. Це корисно у випадках, коли вся інформація з командного рядка не потрібна. Для увімкнення цього додайте до `~/.bashrc` рядок `bleopt prompt_ps1_transient=<value>`:
The [Ble.sh](https://github.com/akinomyoga/ble.sh) framework at v0.4 or higher allows you to replace
the previous-printed prompt with custom strings. Це корисно у випадках, коли вся інформація з командного рядка не потрібна. To enable this, put this in `~/.bashrc`
`bleopt prompt_ps1_transient=<value>`:
\<value\> тут  – це розділений двокрапкою список `always`, `same-dir` та `trim`. Якщо `prompt_ps1_final` порожній і параметр `prompt_ps1_transient` має не пусте значення \<value\>, командний рядок, вказаний у `PS1` буде стертий при виході з поточного командного рядка. Якщо \<value\> містить поле `trim`, тільки останній рядок багаторядкового `PS1` буде збережений, а інші вилучені. В іншому випадку командний рядок буде встановлено перестворено, якщо вказано `PS1=`. Коли поле `same-dir` міститься у \<value\> та поточна тека є відмінною від останньої теки у попередньому виводі командного рядка, параметр `prompt_ps1_transient` не враховується.
The \<value\> here is a colon-separated list of `always`, `same-dir` and `trim`.
When `prompt_ps1_final` is empty and the option `prompt_ps1_transient` has a non-empty \<value\>,
the prompt specified by `PS1` is erased on leaving the current command line.
If \<value\> contains a field `trim`, only the last line of multiline `PS1` is
preserved and the other lines are erased. Otherwise, the command line will be
redrawn as if `PS1=` is specified. When a field `same-dir` is contained in
\<value\> and the current working directory is different from the final directory of
the previous command line, this option `prompt_ps1_transient` is ignored.
Зробіть наступні зміни у `~/.blerc` (або у `~/.config/blesh/init.sh`), щоб налаштувати, що показується ліворуч і праворуч:
- Для налаштування того, чим замінюється ліва частина вводу, налаштуйте параметр `prompt_ps1_final`. Наприклад, щоб показати тут модуль Starship `character`, вам потрібно
- To customize what the left side of input gets replaced with, configure the
`prompt_ps1_final` Ble.sh option. For example, to display Starship's `character`
module here, you would do
```bash
bleopt prompt_ps1_final='$(starship module character)'
```
- Для налаштування того, чим замінюється права частина вводу, налаштуйте параметр `prompt_rps1_final`. Наприклад, щоб показати час, коли була запущена остання команда, ви можете зробити
- To customize what the right side of input gets replaced with, configure the
`prompt_rps1_final` Ble.sh option. For example, to display
the time at which the last command was started here, you would do
```bash
bleopt prompt_rps1_final='$(starship module time)'
@@ -98,9 +133,13 @@ bleopt prompt_rps1_final='$(starship module time)'
## Власні команди pre-prompt та pre-execution в Cmd
Clink забезпечує надзвичайно гнучкий API для виконання команд pre-prompt і pre-exec в Cmd. Його досить просто використовувати в Starship. Зробіть наступні зміни у вашому `starship.lua` відповідно до ваших вимог:
Clink забезпечує надзвичайно гнучкий API для виконання команд pre-prompt і pre-exec в Cmd. Його досить просто використовувати в Starship. Make the following changes
to your `starship.lua` file as per your requirements:
- Для запуску власних функцій прямо перед виводом командного рядка, визначте нову функцію з назвою `starship_preprompt_user_func`. Ця функція отримує поточний текст командного рядка, з яким ви зможете працювати. Наприклад, щоб показати ракету перед командним рядком, ви можете зробити наступне
- To run a custom function right before the prompt is drawn, define a new
function called `starship_preprompt_user_func`. This function receives
the current prompt as a string that you can utilize. For example, to
draw a rocket before the prompt, you would do
```lua
function starship_preprompt_user_func(prompt)
@@ -110,7 +149,10 @@ end
load(io.popen('starship init cmd'):read("*a"))()
```
- Для запуску власних функцій прямо перед виконанням команди, визначте нову функцію з назвою `starship_precmd_user_func`. Ця функція отримує поточний текст команди, з яким ви зможете працювати. Наприклад, для виводу команди, яка буде виконана, вам треба зробити
- To run a custom function right before a command is executed, define a new
function called `starship_precmd_user_func`. This function receives
the current commandline as a string that you can utilize. For example, to
print the command that's about to be executed, you would do
```lua
function starship_precmd_user_func(line)
@@ -122,9 +164,13 @@ load(io.popen('starship init cmd'):read("*a"))()
## Власні команди pre-prompt та pre-execution в Bash
Bash не має офіційної системи preexec/precmd, як більшість інших оболонок. Через це важко забезпечити повністю настроювані гачки для цього в `bash`. Однак, Starship дає можливість вставити свої власні функції в процедуру виводу командного рядка:
Bash не має офіційної системи preexec/precmd, як більшість інших оболонок.
Because of this, it is difficult to provide fully customizable hooks in `bash`.
Однак, Starship дає можливість вставити свої власні функції в процедуру виводу командного рядка:
- Для запуску власних функцій прямо перед виводом командного рядка, визначте нову функцію з назвою `starship_precmd_user_func`. Наприклад, щоб показати ракету перед командним рядком, ви можете зробити наступне
- To run a custom function right before the prompt is drawn, define a new
function and then assign its name to `starship_precmd_user_func`. For example,
to draw a rocket before the prompt, you would do
```bash
function blastoff(){
@@ -133,7 +179,11 @@ function blastoff(){
starship_precmd_user_func="blastoff"
```
- Щоб запустити власну функцію прямо перед запуском команди, можна використати механізм [`DEBUG` trap](https://jichu4n.com/posts/debug-trap-and-prompt_command-in-bash/). Однак, ви **повинні** перехопити сигнал DEBUG _перед_ ініціалізацією Starship! Starship може зберегти значення перехоплення DEBUG, але якщо перехоплення буде перезаписане після початку запуску, деякі функції не працюватимуть.
- To run a custom function right before a command runs, you can use the
[`DEBUG` trap mechanism](https://jichu4n.com/posts/debug-trap-and-prompt_command-in-bash/).
However, you **must** trap the DEBUG signal _before_ initializing Starship!
Starship can preserve the value of the DEBUG trap, but if the trap is overwritten
after starship starts up, some functionality will break.
```bash
function blastoff(){
@@ -147,7 +197,9 @@ set +o functrace
## Власні команди pre-prompt та pre-execution в PowerShell
PowerShell не має офіційної системи preexec/precmd, як більшість інших оболонок. Через це важко забезпечити повністю настроювані гачки для цього в `powershell`. Однак, Starship дає можливість вставити свої власні функції в процедуру виводу командного рядка:
PowerShell не має офіційної системи preexec/precmd, як більшість інших оболонок.
Because of this, it is difficult to provide fully customizable hooks in `powershell`.
Однак, Starship дає можливість вставити свої власні функції в процедуру виводу командного рядка:
Створіть функцію з назвою `Invoke-Starship-PreCommand`
@@ -159,7 +211,9 @@ function Invoke-Starship-PreCommand {
## Зміна заголовка вікна
В деяких оболонках командний рядок автоматично змінює заголовок вікна (наприклад, на назву поточної теки). У Fish це стандартна поведінка. Starship цього не робить, але це досить просто зробити у `bash`, `zsh`, `cmd` або `powershell`.
В деяких оболонках командний рядок автоматично змінює заголовок вікна (наприклад, на назву поточної теки). У Fish це стандартна поведінка.
Starship does not do this, but it's fairly straightforward to add this
functionality to `bash`, `zsh`, `cmd` or `powershell`.
Спочатку визначте функцію зміни заголовка вікна (в bash і zsh – однаково):
@@ -217,9 +271,13 @@ Invoke-Expression (&starship init powershell)
## Командний рядок праворуч {#enable-right-prompt}
Деякі оболонки підтримують вивід командного рядка праворуч. Starship може встановити вміст правої частини командного рядка за допомогою параметра `right_format`. Будь-який модуль, який можна використовувати у `format`, також підтримується у `right_format`. Змінна `$all` міститиме лише модулі, які явно не використовується, а ні в `format`, а ні в `right_format`.
Деякі оболонки підтримують вивід командного рядка праворуч. Starship can
set the content of the right prompt using the `right_format` option. Any module that can be used
in `format` is also supported in `right_format`. The `$all` variable will only contain modules
not explicitly used in either `format` or `right_format`.
Примітка: командний рядок праворуч – це один рядок, що знаходиться праворуч у рядку вводу. Щоб вирівняти модулі праворуч над рядком введення в багаторядковому запиті, перегляньте [модуль `fill`](../config/#fill).
Примітка: командний рядок праворуч – це один рядок, що знаходиться праворуч у рядку вводу. To right align modules above
the input line in a multi-line prompt, see the [`fill` module](../config/#fill).
`right_format` наразі підтримується для таких оболонок: elvish, fish, zsh, xonsh, cmd, nushell, bash.
@@ -243,13 +301,19 @@ right_format = """$all"""
▶ starship on  rprompt [!] is 📦 v0.57.0 via 🦀 v1.54.0 took 17s
```
When using `zsh` (v5.0.5+), the shell adds a default trailing space to the right prompt. This can cause alignment issues specifically when using the Starship `$fill` module. To remove this gap, add the following to your `.zshrc`:
```zsh
ZLE_RPROMPT_INDENT=0
```
## Подовжений ввід
Деякі оболонки підтримують подовження вводу так само як і звичайний ввід в командний рядок. Такий ввід буде показаний замість звичайного, колі користувач ввів символ продовження вводу (наприклад одну ліву дужку чи лапку).
У Starship можна встановити показ продовженого вводу за допомогою параметра `continuation_prompt`. Стандартний командний рядок — `'[∙](bright-black) '`.
Starship can set the continuation prompt using the `continuation_prompt` option. The default prompt is `'[∙](bright-black) '`.
Примітка: `continuation_prompt` слід встановити на літеральний рядок без жодних змінних.
Note: `continuation_prompt` should be set to a literal string without any variables.
Примітка: Подовжений ввід доступний лише для наступних оболонок:
@@ -257,7 +321,7 @@ right_format = """$all"""
- `zsh`
- `PowerShell`
### Приклад
### Рядок стану для Claude Code
```toml
# ~/.config/starship.toml
@@ -270,13 +334,13 @@ continuation_prompt = '▶▶ '
Starship підтримує показ власного рядка стану під час роботи в Claude Code — інструменті командного рядка від Anthropic, призначеному для інтерактивного програмування за допомогою Claude. Ця рядок стану надає інформацію в режимі реального часу про вашу сесію Claude, зокрема про використовувану модель, використання вікна контексту та вартість сесії.
Докладнішу інформацію про функцію рядка стану Claude Code див. у [документації щодо рядка стану Claude Code](https://code.claude.com/docs/en/statusline).
Щоб використовувати Starship як рядок стану Claude Code:
### Встановлення
Щоб використовувати Starship як рядок стану Claude Code:
1. Запустіть `/statusline` в Claude Code і попросіть його налаштувати Starship, або вручну додати наступне на Ваш `.claude/settings.json`:
1. Налаштуйте вигляд рядка стану у файлі `~/.config/starship.toml` (див. розділ [Налаштування](#configuration) нижче)
```json
{
@@ -287,17 +351,17 @@ Starship підтримує показ власного рядка стану п
}
```
2. Налаштуйте вигляд рядка стану у файлі `~/.config/starship.toml` (див. розділ [Налаштування](#configuration) нижче)
2. Customize the statusline appearance in your `~/.config/starship.toml` (see [Configuration](#configuration) below)
### Огляд
При запуску з параметром `starship statusline claude-code` Starship отримує дані сеансу Claude Code через стандартний ввід (stdin) і показує рядок стану, використовуючи спеціальний профіль з назвою `claude-code`.
When invoked with `starship statusline claude-code`, Starship receives Claude Code session data via stdin and renders a statusline using a dedicated profile named `claude-code`.
Профіль містить три спеціалізовані модулі:
Типовий формат профілю:
- `claude_model`: Показує поточну модель, яка використовується в Claude
- `claude_context`: Показує використання контекстного вікна за допомогою візуального індикатора
- `claude_cost`: Показує вартість сеансу та статистичні дані
- `claude_model`: Displays the current Claude model being used
- `claude_context`: Shows context window usage with a visual gauge
- `claude_cost`: Displays session cost and statistics
Типовий формат профілю:
@@ -308,7 +372,7 @@ claude-code = "$claude_model$git_branch$claude_context$claude_cost"
### Налаштування
Ви можете налаштувати рядок стану коду Claude Code змінивши профіль `claude-code` і окремі конфігурації модулів в `~/.config/starship.toml`:
You can customize the Claude Code statusline by modifying the `claude-code` profile and individual module configurations in your `~/.config/starship.toml`:
```toml
# ~/.config/starship.toml
@@ -334,26 +398,26 @@ symbol = "💰 "
### Claude Model
Модуль `claude_model` показує поточну модель Claude, яка використовується в сесії.
#### Параметри
| Параметр | Стандартно | Опис |
| --------------- | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `format` | `'[$symbol$model]($style) '` | Формат модуля. |
| `symbol` | `'🤖 '` | Симовл, який показується перед назвою моделі. |
| `style` | `'bold blue'` | Стиль модуля. |
| `model_aliases` | `{}` | Звʼязує ідентифікатори моделей або їхні назви з коротшими псевдонімами. Спочатку перевіряється ідентифікатор, потім назва. |
| `disabled` | `false` | Вимикає модуль `claude_model`. |
The `claude_model` module displays the current Claude model being used in the session.
#### Змінні
| Змінна | Приклад | Опис |
| --------- | ------------------- | ---------------------------------------- |
| model | `Claude 3.5 Sonnet` | Імʼя поточної моделі |
| model_id | `claude-3-5-sonnet` | ID моделі |
| symbol | | Віддзеркалює значення параметра `symbol` |
| style\* | | Віддзеркалює значення параметра `style` |
| Змінна | Приклад | Опис |
| --------------- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `format` | `'[$symbol$model]($style) '` | Імʼя поточної моделі |
| `symbol` | `'🤖 '` | ID моделі |
| `style` | `'bold blue'` | Віддзеркалює значення параметра `symbol` |
| `model_aliases` | `{}` | Звʼязує ідентифікатори моделей або їхні назви з коротшими псевдонімами. Спочатку перевіряється ідентифікатор, потім назва. |
| `disabled` | `false` | Disables the `claude_model` module. |
#### Змінні
| Змінна | Приклад | Опис |
| ----------------------------- | ------------------- | ------------------------------------ |
| model | `Claude 3.5 Sonnet` | Імʼя поточної моделі |
| model_id | `claude-3-5-sonnet` | ID моделі |
| symbol | | Mirrors the value of option `symbol` |
| style\* | | Mirrors the value of option `style` |
\*: Ця змінна може бути використана лише як частина стилю рядка
@@ -379,30 +443,30 @@ style = "bold cyan"
### Claude Context
Модуль `claude_context` показує використання контекстного вікна у вигляді відсотка і візуального індикатора. Стиль автоматично змінюється на основі налаштованих порогів.
The `claude_context` module displays context window usage as a percentage and visual gauge. Стиль автоматично змінюється на основі налаштованих порогів.
#### Параметри
| Параметр | Стандартно | Опис |
| ---------------------- | --------------------------------- | --------------------------------------------------------------------------- |
| Параметр | Стандартно | Опис |
| ---------------------- | --------------------------------- | ------------------------------------------------------------------------------------------- |
| `format` | `'[$gauge $percentage]($style) '` | Формат модуля. |
| `symbol` | `''` | Символ, який показується перед індикатором. |
| `gauge_width` | `5` | Ширина індикатора в символах. |
| `gauge_full_symbol` | `'█'` | Символ, який використовується для заповнених сегментів індикатора. |
| `gauge_partial_symbol` | `'▒'` | Символ, який використовується для частково заповнених сегментів індикатора. |
| `gauge_empty_symbol` | `'░'` | Символ, який використовується для не заповнених сегментів індикатора. |
| `display` | [дивіться нижче](#display) | Налаштування порогів та стилів. |
| `disabled` | `false` | Вимикає модуль `claude_context`. |
| `display` | [see below](#display) | Налаштування порогів та стилів. |
| `disabled` | `false` | Disables the `claude_context` module. |
##### Display
Параметр `display` — це масив об’єктів, які визначають порогові значення та стилі для різних рівнів використання. Модуль використовує стиль із найвищим порогом відповідності або приховує модуль, якщо `hidden` має значення `true`.
The `display` option is an array of objects that define thresholds and styles for different usage levels. The module uses the style from the highest matching threshold or hides the module if `hidden` is `true`.
| Параметр | Стандартно | Опис |
| ----------- | ------------ | ----------------------------------------------------------------------------------- |
| `threshold` | `0.0` | Мінімальний відсоток використання контекстних вікон, що відповідає цій конфігурації |
| `style` | `bold green` | Значення `style`, якщо ця конфігурація візуалізації має збіг |
| `hidden` | `false` | Приховати цей модуль, якщо він збігається з конфігурацією. |
| `style` | `bold green` | The value of `style` if this display configuration is matched |
| `hidden` | `false` | Приховати цей модуль, якщо він збігається з конфігурацією. |
```toml
[[claude_context.display]]
@@ -424,25 +488,25 @@ style = "bold red"
#### Змінні
| Змінна | Приклад | Опис |
| ---------------------------- | ------- | ------------------------------------------------------------------------- |
| gauge | `██▒░░` | Візуальне представлення використання контексту |
| percentage | `65%` | Використання контексту у відсотках |
| input_tokens | `45.2k` | Загальна кількість input-токенів, використаних у розмові |
| output_tokens | `12.3k` | Загальна кількість output-токенів, використаних у розмові |
| curr_input_tokens | `5.1k` | Кількість input-токенів в останньому API-виклику |
| curr_output_tokens | `1.2k` | Кількість output-токенів в останньому API-виклику |
| Змінна | Приклад | Опис |
| ----------------------------------------------------------------------------------------- | ------- | ------------------------------------------------------------------------- |
| gauge | `██▒░░` | Візуальне представлення використання контексту |
| percentage | `65%` | Використання контексту у відсотках |
| input_tokens | `45.2k` | Загальна кількість input-токенів, використаних у розмові |
| output_tokens | `12.3k` | Загальна кількість output-токенів, використаних у розмові |
| curr_input_tokens | `5.1k` | Кількість input-токенів в останньому API-виклику |
| curr_output_tokens | `1.2k` | Кількість output-токенів в останньому API-виклику |
| curr_cache_creation_tokens | `1.5k` | Кеш з токенів створення з останнього виклику API |
| curr_cache_read_tokens | `23.4k` | Кеш з токенів читання з останнього виклику API |
| total_tokens | `200k` | Загальний розмір контекстного вікна |
| symbol | | Віддзеркалює значення параметра `symbol` |
| style\* | | Повторює стиль, що збігається з відповідним пороговим значення для показу |
| total_tokens | `200k` | Загальний розмір контекстного вікна |
| symbol | | Mirrors the value of option `symbol` |
| style\* | | Повторює стиль, що збігається з відповідним пороговим значення для показу |
\*: Ця змінна може бути використана лише як частина стилю рядка
**Тільки індикатор**
#### Приклади
**Тільки індикатор**
**Докладні відомості про використання токенів**
```toml
# ~/.config/starship.toml
@@ -452,7 +516,7 @@ format = "[$gauge]($style) "
gauge_width = 10
```
**Докладні відомості про використання токенів**
**Власні символи для індикатора**
```toml
# ~/.config/starship.toml
@@ -461,7 +525,7 @@ gauge_width = 10
format = "[$percentage ($input_tokens in / $output_tokens out)]($style) "
```
**Власні символи для індикатора**
**Власні порогові значення**
```toml
# ~/.config/starship.toml
@@ -474,7 +538,7 @@ gauge_width = 10
format = "[$gauge]($style) "
```
**Власні порогові значення**
**Custom thresholds**
```toml
# ~/.config/starship.toml
@@ -498,28 +562,28 @@ style = "bold red"
### Claude Cost
Модуль `claude_cost` показує загальну вартість поточної сесії Claude Code в доларах США. Як і `claude_context`, він підтримує стилізацію на основі порогових значень.
The `claude_cost` module displays the total cost of the current Claude Code session in USD. Like `claude_context`, it supports threshold-based styling.
#### Параметри
| Параметр | Стандартно | Опис |
| ---------- | ---------------------------------- | -------------------------------------------- |
| Параметр | Стандартно | Опис |
| ---------- | ---------------------------------- | ------------------------------------------------------------ |
| `format` | `'[$symbol(\\$$cost)]($style) '` | Формат модуля. |
| `symbol` | `'💰 '` | Символ, який показується перед сумою витрат. |
| `display` | [дивіться нижче](#display-1) | Налаштування порогів та стилів. |
| `disabled` | `false` | Вимикає модуль `claude_cost`. |
| `symbol` | `'💰 '` | Символ, який показується перед сумою витрат. |
| `display` | [see below](#display-1) | Налаштування порогів та стилів. |
| `disabled` | `false` | Disables the `claude_cost` module. |
##### Display
Параметр `display` — це масив об’єктів, які визначають порогові значення та стилі для порогових значень витрат. Модуль використовує стиль із найвищим порогом відповідності або приховує модуль, якщо `hidden` має значення `true`.
The `display` option is an array of objects that define cost thresholds and styles. The module uses the style from the highest matching threshold or hides the module if `hidden` is `true`.
| Параметр | Стандартно | Опис |
| ----------- | ------------ | ------------------------------------------------------------ |
| `threshold` | `0.0` | Мінімальна вартість у доларах США для такої конфігурації |
| `style` | `bold green` | Значення `style`, якщо ця конфігурація візуалізації має збіг |
| `hidden` | `false` | Приховати цей модуль, якщо він збігається з конфігурацією. |
| Параметр | Стандартно | Опис |
| ----------- | ------------ | -------------------------------------------------------------------------- |
| `threshold` | `0.0` | Мінімальна вартість у доларах США для такої конфігурації |
| `style` | `bold green` | The value of `style` if this display configuration is matched |
| `hidden` | `false` | Приховати цей модуль, якщо він збігається з конфігурацією. |
**Стандартні налаштування:**
**Default configuration:**
```toml
[[claude_cost.display]]
@@ -537,19 +601,19 @@ style = "bold red"
#### Змінні
| Змінна | Приклад | Опис |
| ------------- | -------- | ------------------------------------------------------------------------- |
| cost | `1.23` | Загальна вартість сесії у доларах (з центами) |
| duration | `1m 30s` | Загальна тривалість сеансу |
| Змінна | Приклад | Опис |
| ---------------------------------- | -------- | ------------------------------------------------------------------------- |
| cost | `1.23` | Загальна вартість сесії у доларах (з центами) |
| duration | `1m 30s` | Загальна тривалість сеансу |
| api_duration | `45s` | Загальна тривалість API-виклику |
| lines_added | `1.2k` | Загальна кількість доданих рядків коду |
| lines_removed | `500` | Загальна кількість вилучених рядків коду |
| symbol | | Віддзеркалює значення параметра `symbol` |
| style\* | | Повторює стиль, що збігається з відповідним пороговим значення для показу |
| symbol | | Mirrors the value of option `symbol` |
| style\* | | Повторює стиль, що збігається з відповідним пороговим значення для показу |
\*: Ця змінна може бути використана лише як частина стилю рядка
#### Приклади
#### Рядки стилів {#style-strings}
```toml
# ~/.config/starship.toml
@@ -576,9 +640,9 @@ style = "bold red"
format = "[$symbol$cost ($duration)]($style) "
```
## Рядки стилів {#style-strings}
## Рядки стилів
Рядки стилю — список слів, розділених пробілами. Слова не чутливі до регістру (наприклад `bold` і `BoLd` вважаються однаковими). Кожне слово може бути одним з наступних:
Рядки стилю — список слів, розділених пробілами. The words are not case sensitive (i.e. `bold` and `BoLd` are considered the same string). Кожне слово може бути одним з наступних:
- `bold`
- `italic`
@@ -593,20 +657,25 @@ format = "[$symbol$cost ($duration)]($style) "
- `<color>`
- `none`
де `<color>` є специфікацією кольору (обговорюється нижче). `fg:<color>` та `<color>` на цей час роблять те саме, хоча це може змінитися в майбутньому. `<color>` може також мати значення `prev_fg` або `prev_bg`, які обчислюють колір тексту або фону попереднього елемента відповідно, якщо він доступний, або `none` у протилежному випадку. `inverted` замінює кольори тла і тексту. Порядок слів у рядку не має значення.
where `<color>` is a color specifier (discussed below). `fg:<color>` and `<color>` currently do the same thing, though this may change in the future.
`<color>` can also be set to `prev_fg` or `prev_bg` which evaluates to the previous item's foreground or background color respectively if available or `none` otherwise.
`inverted` swaps the background and foreground colors. Порядок слів у рядку не має значення.
Токен `none` перевизначає всі інші токени у рядку, якщо він не є частиною `bg:`, так `fg:red none fg:blue` все одно створить рядок без стилізування. `bg:none` встановлює типовий колір фону, таким чином, `fg:red bg:none` еквівалентно `red` або `fg:red`, а `bg:green fg:red fg:none` також еквівалентно `fg:red` або `red`. Використання `none` у поєднанні з іншими токенами в майбутньому може стати помилкою.
The `none` token overrides all other tokens in a string if it is not part of a `bg:` specifier, so that e.g. `fg:red none fg:blue` will still create a string with no styling. `bg:none` sets the background to the default color so `fg:red bg:none` is equivalent to `red` or `fg:red` and `bg:green fg:red bg:none` is also equivalent to `fg:red` or `red`. It may become an error to use `none` in conjunction with other tokens in the future.
Визначення кольору може бути одним з наступних:
Якщо для тексту та фону задано кілька кольорів, останній в рядку буде мати вищий пріоритет.
- Один за стандартних кольорів термінала: `black`, `red`, `green`, `blue`, `yellow`, `purple`, `cyan`, `white`. Ви можете опціонально додавати префікс `bright-`, щоб отримати яскраву версію (наприклад, `bright-white`).
- `#` за яким йде шестизначний шістнадцятковий код кольору. Цей код вказує на [шістнадцятковий код RGB](https://www.w3schools.com/colors/colors_hexadecimal.asp).
- Число від 0-255. Число визначає [8-бітний код кольору ANSI](https://i.stack.imgur.com/KTSQa.png).
- One of the standard terminal colors: `black`, `red`, `green`, `blue`,
`yellow`, `purple`, `cyan`, `white`. You can optionally prefix these
with `bright-` to get the bright version (e.g. `bright-white`).
- A `#` followed by a six-digit hexadecimal number. This specifies an
[RGB color hex code](https://www.w3schools.com/colors/colors_hexadecimal.asp).
- Число від 0-255. This specifies an [8-bit ANSI Color Code](https://i.stack.imgur.com/KTSQa.png).
Якщо для тексту та фону задано кілька кольорів, останній в рядку буде мати вищий пріоритет.
Не кожен рядок стилю буде правильно показуватись у кожному терміналі. Зокрема, існують такі відомі примхи:
- Багато терміналів стандартно вмикають підтримку `blink`.
- `hidden` [не підтримується в iTerm](https://gitlab.com/gnachman/iterm2/-/issues/4564).
- `strikethrough` не підтримується стандартно в macOS Terminal.app.
- 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.