docs(i18n): new Crowdin updates (#6716)

* New translations readme.md (Portuguese, Brazilian)

* New translations readme.md (Indonesian)

* New translations readme.md (Bengali)

* New translations readme.md (Sorani (Kurdish))

* New translations readme.md (French)

* New translations readme.md (Spanish)

* New translations readme.md (Arabic)

* New translations readme.md (German)

* New translations readme.md (Italian)

* New translations readme.md (Japanese)

* New translations readme.md (Korean)

* New translations readme.md (Dutch)

* New translations readme.md (Norwegian)

* New translations readme.md (Polish)

* New translations readme.md (Portuguese)

* New translations readme.md (Russian)

* New translations readme.md (Turkish)

* New translations readme.md (Ukrainian)

* New translations readme.md (Chinese Simplified)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Vietnamese)

* New translations readme.md (Portuguese, Brazilian)

* New translations readme.md (Indonesian)

* New translations readme.md (Bengali)

* New translations readme.md (Sorani (Kurdish))

* New translations readme.md (French)

* New translations readme.md (Spanish)

* New translations readme.md (Japanese)

* New translations readme.md (Ukrainian)

* New translations readme.md (Portuguese, Brazilian)

* New translations readme.md (Indonesian)

* New translations readme.md (Ukrainian)

* New translations readme.md (French)

* New translations readme.md (Spanish)

* New translations readme.md (Arabic)

* New translations readme.md (German)

* New translations readme.md (Italian)

* New translations readme.md (Japanese)

* New translations readme.md (Korean)

* New translations readme.md (Dutch)

* New translations readme.md (Norwegian)

* New translations readme.md (Polish)

* New translations readme.md (Portuguese)

* New translations readme.md (Russian)

* New translations readme.md (Turkish)

* New translations readme.md (Ukrainian)

* New translations readme.md (Chinese Simplified)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Vietnamese)

* New translations readme.md (Portuguese, Brazilian)

* New translations readme.md (Indonesian)

* New translations readme.md (Bengali)

* New translations readme.md (Sorani (Kurdish))

* New translations readme.md (Spanish)

* New translations readme.md (Spanish)

* New translations readme.md (Spanish)

* New translations readme.md (Spanish)

* New translations readme.md (Spanish)

* New translations readme.md (Ukrainian)

* New translations readme.md (French)

* New translations readme.md (Spanish)

* New translations readme.md (Arabic)

* New translations readme.md (German)

* New translations readme.md (Italian)

* New translations readme.md (Japanese)

* New translations readme.md (Korean)

* New translations readme.md (Dutch)

* New translations readme.md (Norwegian)

* New translations readme.md (Polish)

* New translations readme.md (Portuguese)

* New translations readme.md (Russian)

* New translations readme.md (Turkish)

* New translations readme.md (Ukrainian)

* New translations readme.md (Chinese Simplified)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Vietnamese)

* New translations readme.md (Portuguese, Brazilian)

* New translations readme.md (Indonesian)

* New translations readme.md (Bengali)

* New translations readme.md (Sorani (Kurdish))

* New translations readme.md (Ukrainian)

* New translations readme.md (French)

* New translations readme.md (Spanish)

* New translations readme.md (Arabic)

* New translations readme.md (German)

* New translations readme.md (Italian)

* New translations readme.md (Japanese)

* New translations readme.md (Korean)

* New translations readme.md (Dutch)

* New translations readme.md (Norwegian)

* New translations readme.md (Polish)

* New translations readme.md (Portuguese)

* New translations readme.md (Russian)

* New translations readme.md (Turkish)

* New translations readme.md (Ukrainian)

* New translations readme.md (Chinese Simplified)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Vietnamese)

* New translations readme.md (Portuguese, Brazilian)

* New translations readme.md (Indonesian)

* New translations readme.md (Bengali)

* New translations readme.md (Sorani (Kurdish))

* New translations readme.md (Ukrainian)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Chinese Traditional)

* New translations tokyo-night.md (Chinese Traditional)

* New translations gruvbox-rainbow.md (Chinese Traditional)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Chinese Traditional)

* New translations bracketed-segments.md (Chinese Traditional)

* New translations nerd-font.md (Chinese Traditional)

* New translations no-runtimes.md (Chinese Traditional)

* New translations plain-text.md (Chinese Traditional)

* New translations pure-preset.md (Chinese Traditional)

* New translations pastel-powerline.md (Chinese Traditional)

* New translations no-nerd-font.md (Chinese Traditional)

* New translations no-empty-icons.md (Chinese Traditional)

* New translations gruvbox-rainbow.md (Chinese Traditional)

* New translations jetpack.md (Chinese Traditional)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Portuguese, Brazilian)

* New translations jetpack.md (Portuguese, Brazilian)

* New translations readme.md (Portuguese, Brazilian)

* New translations readme.md (French)

* New translations pure-preset.md (French)

* New translations tokyo-night.md (French)

* New translations readme.md (Spanish)

* New translations pure-preset.md (Spanish)

* New translations tokyo-night.md (Spanish)

* New translations readme.md (Arabic)

* New translations pure-preset.md (Arabic)

* New translations tokyo-night.md (Arabic)

* New translations readme.md (German)

* New translations pure-preset.md (German)

* New translations tokyo-night.md (German)

* New translations readme.md (Italian)

* New translations pure-preset.md (Italian)

* New translations tokyo-night.md (Italian)

* New translations readme.md (Japanese)

* New translations pure-preset.md (Japanese)

* New translations tokyo-night.md (Japanese)

* New translations readme.md (Korean)

* New translations pure-preset.md (Korean)

* New translations tokyo-night.md (Korean)

* New translations readme.md (Dutch)

* New translations pure-preset.md (Dutch)

* New translations tokyo-night.md (Dutch)

* New translations readme.md (Norwegian)

* New translations pure-preset.md (Norwegian)

* New translations tokyo-night.md (Norwegian)

* New translations readme.md (Polish)

* New translations pure-preset.md (Polish)

* New translations tokyo-night.md (Polish)

* New translations readme.md (Portuguese)

* New translations pure-preset.md (Portuguese)

* New translations tokyo-night.md (Portuguese)

* New translations readme.md (Russian)

* New translations pure-preset.md (Russian)

* New translations tokyo-night.md (Russian)

* New translations readme.md (Turkish)

* New translations pure-preset.md (Turkish)

* New translations tokyo-night.md (Turkish)

* New translations readme.md (Ukrainian)

* New translations pure-preset.md (Ukrainian)

* New translations tokyo-night.md (Ukrainian)

* New translations readme.md (Chinese Simplified)

* New translations pure-preset.md (Chinese Simplified)

* New translations tokyo-night.md (Chinese Simplified)

* New translations readme.md (Chinese Traditional)

* New translations pure-preset.md (Chinese Traditional)

* New translations tokyo-night.md (Chinese Traditional)

* New translations readme.md (Vietnamese)

* New translations pure-preset.md (Vietnamese)

* New translations tokyo-night.md (Vietnamese)

* New translations readme.md (Portuguese, Brazilian)

* New translations pure-preset.md (Portuguese, Brazilian)

* New translations tokyo-night.md (Portuguese, Brazilian)

* New translations readme.md (Indonesian)

* New translations pure-preset.md (Indonesian)

* New translations tokyo-night.md (Indonesian)

* New translations readme.md (Bengali)

* New translations pure-preset.md (Bengali)

* New translations tokyo-night.md (Bengali)

* New translations readme.md (Sorani (Kurdish))

* New translations pure-preset.md (Sorani (Kurdish))

* New translations tokyo-night.md (Sorani (Kurdish))

* New translations readme.md (Ukrainian)

* New translations readme.md (French)

* New translations readme.md (Spanish)

* New translations readme.md (Spanish)

* New translations readme.md (Arabic)

* New translations readme.md (Arabic)

* New translations readme.md (German)

* New translations readme.md (German)

* New translations readme.md (Italian)

* New translations readme.md (Italian)

* New translations readme.md (Japanese)

* New translations readme.md (Japanese)

* New translations readme.md (Korean)

* New translations readme.md (Korean)

* New translations readme.md (Dutch)

* New translations readme.md (Dutch)

* New translations readme.md (Norwegian)

* New translations readme.md (Norwegian)

* New translations readme.md (Polish)

* New translations readme.md (Polish)

* New translations readme.md (Portuguese)

* New translations readme.md (Portuguese)

* New translations readme.md (Russian)

* New translations readme.md (Russian)

* New translations readme.md (Turkish)

* New translations readme.md (Turkish)

* New translations readme.md (Ukrainian)

* New translations readme.md (Ukrainian)

* New translations readme.md (Chinese Simplified)

* New translations readme.md (Chinese Simplified)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Vietnamese)

* New translations readme.md (Vietnamese)

* New translations readme.md (Portuguese, Brazilian)

* New translations readme.md (Portuguese, Brazilian)

* New translations readme.md (Indonesian)

* New translations readme.md (Indonesian)

* New translations readme.md (Bengali)

* New translations readme.md (Bengali)

* New translations readme.md (Sorani (Kurdish))

* New translations readme.md (Sorani (Kurdish))

* New translations readme.md (French)

* New translations readme.md (Arabic)

* New translations readme.md (Japanese)

* New translations readme.md (Norwegian)

* New translations readme.md (Turkish)

* New translations readme.md (Chinese Simplified)

* New translations readme.md (Chinese Traditional)

* New translations readme.md (Portuguese, Brazilian)

* New translations readme.md (French)

* New translations readme.md (Korean)

* New translations readme.md (Korean)

* New translations readme.md (Korean)

* New translations readme.md (Korean)

* New translations catppuccin-powerline.md (Korean)
This commit is contained in:
Matan Kushner
2025-10-25 20:33:44 +09:00
committed by GitHub
parent 083870239e
commit 3c366dc87a
184 changed files with 6256 additions and 6172 deletions
+263 -245
View File
@@ -208,11 +208,7 @@ detect_extensions = ['ts', '!video.ts', '!audio.ts']
| `palettes` | `{}` | Колекція колірних палітр, для призначення [кольорів](../advanced-config/#style-strings) до назв визначених користувачем. Зверніть увагу, що кольорові палітри не можуть посилатися на їх власні визначення кольору. |
| `follow_symlinks` | `true` | Перевіряти символічні посилання чи вони посилаються на теки; використовується в таких модулях як git. |
::: tip
Якщо у вас є символічні посилання не мережеві файлові системи, зважте на встановлення `follow_symlink` у `false`.
:::
> [!TIP] Якщо у вас є символічні посилання до мережевих файлових систем, встановіть `follow_symlinks` у `false`.
### Приклад
@@ -249,7 +245,7 @@ mustard = '#af8700'
```toml
format = '$all'
# Which is equivalent to
# Є еквівалентом до
format = """
$username\
$hostname\
@@ -267,6 +263,7 @@ $git_state\
$git_metrics\
$git_status\
$hg_branch\
$hg_state\
$pijul_channel\
$docker_context\
$package\
@@ -281,6 +278,7 @@ $elixir\
$elm\
$erlang\
$fennel\
$fortran\
$gleam\
$golang\
$guix_shell\
@@ -442,6 +440,8 @@ Enterprise_Naming_Scheme-voidstars = 'void**'
Модуль `azure` показує поточну підписку Azure. Інформація заснована на назві стандартної підписки або імені користувача, як визначено у файлі `~/.azure/azureProfile.json`.
> [!TIP] Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
### Параметри
| Змінна | Стандартно | Опис |
@@ -658,15 +658,13 @@ format = 'via [🍔 $version](bold green) '
| symbol | | Віддзеркалює значення параметра `symbol` |
| style | | Віддзеркалює значення параметра `style` |
NB `версія` не має стандартного формату.
### Команди
Параметр `commands` отримує список команд для визначення версії та назви компілятора.
Кожна команда представлена списком з назви виконавчого файлу та аргументів, зазвичай `['myc', '--version']`. Starship спробує виконати кожну команду, поки не отримає результат в STDOUT.
Якщо C-компілятор не підтримується цим модулем, ви можете зробити [запит на GitHub](https://github.com/starship/starship/).
Якщо C-компілятор не підтримується цим модулем, ви можете зробити [запит на GitHub](https://github.com/starship/starship/issues/new/choose).
### Приклад
@@ -679,7 +677,9 @@ format = 'via [$name $version]($style)'
## CPP
The `cpp` module shows some information about your `C++` compiler. By default, the module will be shown if the current directory contains a `.cpp`, `.hpp`, or other `C++`-related files.
Модуль `cpp` показує інформацію про ваш компілятор `C++`. Стандартно модуль буде показаний, якщо поточна тека містить файли `.cpp`, `.hpp`, або інші файли повїязані з `C++`.
> [!TIP] Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
### Параметри
@@ -693,7 +693,7 @@ The `cpp` module shows some information about your `C++` compiler. By default, t
| `detect_folders` | `[]` | В яких теках цей модуль має запускатись. |
| `commands` | `[ [ 'c++', '--version' ], [ 'g++', '--version' ], [ 'clang++', '--version' ] ]` | Як виявити компілятор |
| `style` | `'bold 149'` | Стиль модуля. |
| `disabled` | `true` | Disables the `cpp` module. |
| `disabled` | `true` | Вимикає модуль `cpp`. |
### Змінні
@@ -704,15 +704,13 @@ The `cpp` module shows some information about your `C++` compiler. By default, t
| symbol | | Віддзеркалює значення параметра `symbol` |
| style | | Віддзеркалює значення параметра `style` |
NB `версія` не має стандартного формату.
### Команди
Параметр `commands` отримує список команд для визначення версії та назви компілятора.
Each command is represented as a list of the executable name, followed by its arguments, usually something like `['mycpp', '--version']`. Starship спробує виконати кожну команду, поки не отримає результат в STDOUT.
Кожна команда представлена списком з назви виконавчого файлу та аргументів, зазвичай `['mycpp', '--version']`. Starship спробує виконати кожну команду, поки не отримає результат в STDOUT.
If a C++ compiler is not supported by this module, you can request it by [raising an issue on GitHub](https://github.com/starship/starship/).
Якщо компілятор C++ компілятор не підтримується цим модулем, ви можете зробити [запит на GitHub](https://github.com/starship/starship/issues/new/choose).
### Приклад
@@ -735,11 +733,7 @@ format = 'via [$name $version]($style)'
Стандартно відбувається зміна кольору. Якщо ви також хочете змінювати й символ, подивитися на [цей приклад](#with-custom-error-shape).
::: warning
`vimcmd_symbol` працює лише з cmd, fish та zsh. `vimcmd_replace_one_symbol`, `vimcmd_replace_symbol`, and `vimcmd_visual_symbol` працює лише з fish через [проблему визначення режиму роботи в zsh](https://github.com/starship/starship/issues/625#issuecomment-732454148).
:::
> [!WARNING] `vimcmd_symbol` підтримується лише у cmd, fish та zsh. `vimcmd_replace_one_symbol`, `vimcmd_replace_symbol` та `vimcmd_visual_symbol` підтримуються лише у fish через [проблеми з визначенням режиму у zsh](https://github.com/starship/starship/issues/625#issuecomment-732454148).
### Параметри
@@ -855,11 +849,9 @@ vimcmd_symbol = '[V](bold green) '
Модуль `cmd_duration` показує, скільки часу виконувалась остання команда. Модуль буде показаний лише в тому випадку, якщо на виконання команди пішло понад дві секунди або більше, ніж значення змінної `min_time`, якщо воно задане.
::: warning Не вмикайте DEBUG trap в Bash
Якщо ви запускаєте Starship у `bash`, не вмикайте `DEBUG trap` після запуску `eval $(starship init $0)`, бо цей модуль **не працюватиме**.
:::
> [!WARNING] Не перехоплюйте trap DEBUG у Bash
>
> Якщо ви запускаєте Starship у `bash`, не вмикайте `DEBUG trap` після запуску `eval $(starship init $0)`, бо цей модуль **не працюватиме**.
Користувачі Bash, яким потрібна функція preexec, можуть використовувати [фреймворк bash_preexec від rcaloras](https://github.com/rcaloras/bash-preexec). Просто визначте масиви `preexec_function` і `precmd_functions` перед запуском `eval $(starship init $0)`, а потім продовжуйте як зазвичай.
@@ -899,11 +891,7 @@ format = 'underwent [$duration](bold yellow)'
Модуль `conda` показує інформацію про поточне оточення [Conda](https://docs.conda.io/en/latest/), якщо змінна `$CONDA_DEFAULT_ENV` встановлена.
::: tip
Це не призводить до вимикання власного модифікатора командного рядка в conda. Можливо, вам доведеться виконати `conda config --set changeps1 False`. Якщо ви використовуєте [pixi](https://pixi.sh), ви можете відключити модифікатор запиту pixi, запустивши `pixi config set change-ps1 false`.
:::
> [!TIP] Це не пригнічує власний модифікатор підказки conda, ви можете виконати `conda config --set changeps1 False`. Якщо ви використовуєте [pixi](https://pixi.sh), ви можете відключити модифікатор запиту pixi, використовуючи `pixi config set shell.change-ps1 false`.
### Параметри
@@ -914,7 +902,7 @@ format = 'underwent [$duration](bold yellow)'
| `style` | `'bold green'` | Стиль модуля. |
| `format` | `'via [$symbol$environment]($style) '` | Формат модуля. |
| `ignore_base` | `true` | Ігнорувати середовище `base`. |
| `detect_env_vars` | `["!PIXI_ENVIRONMENT_NAME"]` | Які змінні середовища повинні запускати цей модуль. If it's a pixi environment, this module is not being triggered by default. |
| `detect_env_vars` | `["!PIXI_ENVIRONMENT_NAME"]` | Які змінні середовища повинні запускати цей модуль. Якщо це середовище pixi, цей модуль стандартно не запускається. |
| `disabled` | `false` | Вимикає модуль `conda`. |
### Змінні
@@ -1206,6 +1194,8 @@ truncation_symbol = '…/'
Модуль `direnv` показує статус rc-файла якщо він існує. Статус включає: шлях до файлу rc, чи він завантажений та, чи `direnv` дозволяє його використання.
> [!TIP] Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
### Параметри
| Параметр | Стандартно | Опис |
@@ -1251,16 +1241,16 @@ disabled = false
### Параметри
| Параметр | Стандартно | Опис |
| ------------------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| `format` | `'via [$symbol$context]($style) '` | Формат модуля. |
| `symbol` | `'🐳 '` | Символ, який знаходиться перед Docker context. |
| `only_with_files` | `true` | Показувати, лише коли є збіг |
| `detect_extensions` | `[]` | Які розширення мають запускати цей модуль (потрібно щоб в `only_with_files` було true). |
| `detect_files` | `['docker-compose.yml', 'docker-compose.yaml', 'Dockerfile']` | Які імена файлів мають запускати цей модуль (потрібно щоб в `only_with_files` було true). |
| `detect_folders` | `[]` | Які теки мають запускати цей модуль (потрібно щоб в `only_with_files` було true). |
| `style` | `'blue bold'` | Стиль модуля. |
| `disabled` | `false` | Вимикає модуль `docker_context`. |
| Параметр | Стандартно | Опис |
| ------------------- | -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| `format` | `'via [$symbol$context]($style) '` | Формат модуля. |
| `symbol` | `'🐳 '` | Символ, який знаходиться перед Docker context. |
| `only_with_files` | `true` | Показувати, лише коли є збіг |
| `detect_extensions` | `[]` | Які розширення мають запускати цей модуль (потрібно щоб в `only_with_files` було true). |
| `detect_files` | `['compose.yml', 'compose.yaml', 'docker-compose.yml', 'docker-compose.yaml', 'Dockerfile']` | Які імена файлів мають запускати цей модуль (потрібно щоб в `only_with_files` було true). |
| `detect_folders` | `[]` | Які теки мають запускати цей модуль (потрібно щоб в `only_with_files` було true). |
| `style` | `'blue bold'` | Стиль модуля. |
| `disabled` | `false` | Вимикає модуль `docker_context`. |
### Змінні
@@ -1426,26 +1416,17 @@ format = 'via [ $version](cyan bold) '
- Параметр `variable` відповідає наявній змінній середовища
- Параметр `variable` не визначено, але є параметр `default`
::: tip
> [!TIP] Порядок показу модулів env_var можна встановити індивідуально, включивши `${env_var.foo}` у формат верхнього рівня `format` (оскільки він містить крапку, потрібно використовувати `${...}`). Типово, модуль `env_var` покаже усі модулі env_var, в тому порядку, в якому вони були визначені.
Порядок в якому модуль env_var показується може встановлюватись індивідуально додаванням `${env_var.foo}` в `format` верхнього рівня (через те, що використовуються крапки, потрібно використовувати `${...}`). Типово, модуль `env_var` покаже усі модулі env_var, в тому порядку, в якому вони були визначені.
:::
::: tip
Кілька змінних оточення можуть бути показані за допомоги `.`. (див. приклад) Якщо параметр конфігурації `variable` не встановлено, модуль показуватиме значення змінної під назвою тексту після символу `.`.
Приклад: наступна конфігурація показуватиме значення змінної середовища USER
```toml
# ~/.config/starship.toml
[env_var.USER]
default = 'unknown user'
```
:::
> [!TIP] Кілька змінних середовища можна відобразити за допомогою `.`. (див. приклад) Якщо параметр конфігурації `variable` не задано, модуль виводитиме значення змінної під назвою тексту після символу `.`.
>
> Приклад: наступна конфігурація показуватиме значення змінної середовища USER
>
> ```toml
>
> # ~/.config/starship.toml
>
> [env_var.USER] default = 'unknown user' ```
### Параметри
@@ -1596,10 +1577,49 @@ style = 'bold green'
AA -------------------------------------------- BB -------------------------------------------- CC
```
## Fortran
Модуль `fortran` показує поточну встановлену версію Fortran.
### Параметри
| Параметр | Стандартно | Опис |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| `symbol` | `' '` | Символ, який знаходиться перед версією COBOL. |
| `format` | `'via [$symbol($version )]($style)'` | Формат модуля. |
| `version_format` | `'${raw}'` | Формат версії. Доступні змінні `raw`, `major`, `minor` та `patch` |
| `style` | `'bold purple'` | Стиль модуля. |
| `detect_extensions` | `['f', 'F', 'for', 'FOR', 'ftn', 'FTN', 'f77', 'F77', 'f90', 'F90', 'f95', 'F95','f03', 'F03', 'f08', 'F08', 'f18', 'F18']` | Which extensions should trigger this module. |
| `detect_files` | `['fpm.toml']` | Які імена файлів мають запускати цей модуль. |
| `detect_folders` | `[]` | В яких теках цей модуль має запускатись. |
| `commands` | `[ [ 'gfortran', '--version' ], [ 'flang', '--version' ], [ 'flang-new', '--version' ] ]` | Як виявити компілятор |
| `disabled` | `false` | Вимикає модуль `fortran`. |
### Змінні
| Змінна | Приклад | Опис |
| --------- | -------- | ---------------------------------------- |
| name | gfortran | Назва компілятора |
| version | `14.2.0` | Версія компілятора Fortran |
| symbol | | Віддзеркалює значення параметра `symbol` |
| style\* | | Віддзеркалює значення параметра `style` |
*: Ця змінна може бути використана лише як частина стилю рядка
### Команди
Параметр `commands` отримує список команд для визначення версії та назви компілятора.
Кожна команда представлена списком з назви виконавчого файлу та аргументів, зазвичай `['myfortran', '--version']`. Starship спробує виконати кожну команду, поки не отримає результат в STDOUT.
Якщо компілятор Fortran не підтримується цим модулем, ви можете зробити [запит на GitHub](https://github.com/starship/starship/).
## Fossil Branch
Модуль `fossil_branch` показує назву активної гілки у вашій поточній теці.
> [!TIP] Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
### Параметри
| Параметр | Стандартно | Опис |
@@ -1636,6 +1656,8 @@ truncation_symbol = ''
Модуль `fossil_metrics` покаже кількість доданих та видалених рядків у поточній теці. Потрібна версія Fossil не нижче v2.14 (2021-01-20).
> [!TIP] Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
### Параметри
| Параметр | Стандартно | Опис |
@@ -1759,6 +1781,7 @@ very-long-project-name = 'vlpn'
| `truncation_symbol` | `'…'` | Символ, що використовується для позначення назви гілки, яка була скорочена. Ви можете використовувати `''`, щоб нічого не показувати. |
| `only_attached` | `false` | Показувати назву гілки тільки коли вона не у відʼєднаному від `HEAD` стані. |
| `ignore_branches` | `[]` | Перелік назв, які не треба показувати. Корисно для 'master' або 'main'. |
| `ignore_bare_repo` | `false` | Не показувати, коли в голих репозиторіях. |
| `disabled` | `false` | Вимикає модуль `git_branch`. |
### Змінні
@@ -1866,11 +1889,7 @@ cherry_pick = '[🍒 PICKING](bold red)'
Модуль `git_metrics` покаже кількість доданих та видалених рядків у поточному репозиторії git.
::: tip
Цей модуль типово є вимкненим. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
:::
> [!TIP] Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
### Параметри
@@ -1908,11 +1927,7 @@ format = '[+$added]($added_style)/[-$deleted]($deleted_style) '
Модуль `git_status` показує символ, що описує стан репозиторію в поточній теці.
::: tip
Модуль Git Status дуже повільно працює в теках Windows у середовищі WSL (наприклад, під `/mnt/c/`). Ви можете вимкнути модуль або використати `windows_starship` для використання Windows-версії Starship для тримання `git_status` для цих шляхів.
:::
> [!TIP] Модуль Git Status працює дуже повільно у теках Windows (наприклад, у теках `/mnt/c/`) у середовищі WSL. Ви можете вимкнути модуль або використати `windows_starship` для використання Windows-версії Starship для тримання `git_status` для цих шляхів.
### Параметри
@@ -1925,7 +1940,7 @@ format = '[+$added]($added_style)/[-$deleted]($deleted_style) '
| `diverged` | `'⇕'` | Формат `diverged` |
| `up_to_date` | `''` | Формат `up_to_date` |
| `untracked` | `'?'` | Формат `untracked` |
| `stashed` | `'$'` | Формат `stashed` |
| `stashed` | `'\$'` | Формат `stashed` |
| `modified` | `'!'` | Формат `modified` |
| `staged` | `'+'` | Формат `staged` |
| `renamed` | `'»'` | Формат `renamed` |
@@ -1935,7 +1950,7 @@ format = '[+$added]($added_style)/[-$deleted]($deleted_style) '
| `ignore_submodules` | `false` | Ігнорувати зміни в субмодулях. |
| `disabled` | `false` | Вимикає модуль `git_status`. |
| `windows_starship` | | Використовуйте цей (Linux) шлях до виконуваного файлу у Windows для показу `git_status` у випадку шляхів Windows у WSL. |
| `use_git_executable` | `false` | Do not use `gitoxide` for computing the status, but use the `git` executable instead. |
| `use_git_executable` | `false` | Не використовуйте `gitoxide` для обчислення статусу, натомість використовуйте виконуваний файл `git`. |
### Змінні
@@ -2392,17 +2407,9 @@ symbol = '🌟 '
- 1 завдання -> показується `symbol`.
- 2 чи більше завдань -> показується `symbol` + `число`.
::: warning
> [!WARNING] Цей модуль не підтримується на tcsh.
Модуль не підтримується в tcsh та nu.
:::
::: warning
Параметр `threshold` є застарілим, але якщо ви бажаєте його використовувати, модуль буде показувати кількість запущених завдань, якщо у вас більше одного фонового завдання, або завдань більше за `threshold`. Якщо `threshold` встановлено у 0, то модуль також показуватиметься, коли немає запущених завдань.
:::
> [!WARNING] Параметр `threshold` є застарілим, але якщо ви хочете використовувати його, модуль покаже кількість запущених завдань, якщо їх більш ніж 1, або більше значення конфігурації `threshold`, якщо воно існує. Якщо `threshold` встановлено у 0, то модуль також показуватиметься, коли немає запущених завдань.
### Параметри
@@ -2428,7 +2435,7 @@ symbol = '🌟 '
*: Ця змінна може бути використана лише як частина стилю рядка
### Приклад
### Приклади
```toml
# ~/.config/starship.toml
@@ -2439,6 +2446,14 @@ number_threshold = 4
symbol_threshold = 0
```
#### Зміна процесу групування поведінки у fish
При використанні оболонки Fish, Starship стандартно підраховує **групи завдань** замість окремих ідентифікаторів процесів. Це запобігає надмірному підрахунку, коли конвеєр має кілька процесів, але тільки одну призупинену групу. Щоб повернутися до старого підрахунку на основі PID, додайте наступне до конфігурації оболонки:
```fish
set -g __starship_fish_use_job_groups "false"
```
## Julia
Модуль `julia` показує поточну встановлену версію [Julia](https://julialang.org/). Типово, модуль показується, якщо виконується будь-яка з наступних умов:
@@ -2530,21 +2545,13 @@ kotlin_binary = 'kotlinc'
Показує поточну назву [Kubernetes context](https://kubernetes.io/docs/concepts/configuration/organize-cluster-access-kubeconfig/#context) та, якщо встановлено, простір імен, користувача та кластер з файлу kubeconfig. Простір імен повинен бути встановлений у файлі kubeconfig файл, це можна зробити через `kubectl config set-context starship-context --namespace astronaut`. Так само можна встановити користувача та кластер за допомогою `kubectl config set-context starship-context --user starship-user` та `kubectl config set-context context context context --cluster starship-cluster`, відповідно. Якщо параметр `$KUBECONFIG` встановлено, то модуль буде використовувати його, якщо ні — `~/.kube/config`.
::: tip
Цей модуль типово є вимкненим. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
Коли модуль увімкнено, він завжди буде активним, якщо будь-який з параметрів `detect_env_vars`, `detect_extensions`, `detect_files` або `detect_folders` встановлені, модуль буде активним тільки в теках, що відповідають умовам.
:::
> [!TIP] Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
>
> Коли модуль увімкнено, він завжди буде активним, якщо будь-який з параметрів `detect_env_vars`, `detect_extensions`, `detect_files` або `detect_folders` встановлені, модуль буде активним тільки в теках, що відповідають умовам або якщо одна зі змінних середовища була встановлена.
### Параметри
::: warning
Параметри `context_aliases` та `user_aliases` є застарілими. Використовуйте `contexts` та, відповідно, `context_alias` та `user_alias`, натомість.
:::
> [!WARNING] Параметри `context_aliases` та `user_aliases` є застарілими. Використовуйте `contexts` та, відповідно, `context_alias` та `user_alias`, натомість.
| Параметр | Стандартно | Опис |
| ------------------- | ---------------------------------------------------- | --------------------------------------------------------- |
@@ -2666,6 +2673,8 @@ disabled = true
Модуль `localip` показує IPv4 адресу основного мережевого інтерфейсу.
> [!TIP] Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
### Параметри
| Параметр | Стандартно | Опис |
@@ -2742,11 +2751,7 @@ format = 'via [🌕 $version](bold blue) '
Стандартно використання файлу підкачки показується якщо його розмір не є нульовим.
::: tip
Цей модуль типово є вимкненим. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
:::
> [!TIP] Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
### Параметри
@@ -2826,6 +2831,8 @@ style = 'bold dimmed green'
Модуль `hg_branch` показує активну гілку та вершину репозиторію у вашій поточній теці.
> [!TIP] Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
### Параметри
| Параметр | Стандартно | Опис |
@@ -2859,26 +2866,61 @@ truncation_length = 4
truncation_symbol = ''
```
## Mise
## Стан Mercurial
The `mise` module shows the current mise health as reported by running `mise doctor`.
Модуль `hg_state` показуватиметься в теках, які є частиною сховища mercurial, і в яких виконується операція, наприклад: _REBASING_, _BISECTING_ тощо.
> [!TIP] Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
### Параметри
| Параметр | Стандартно | Опис |
| ------------------ | -------------------------------- | ------------------------------------------------ |
| `symbol` | `'mise '` | The symbol used before displaying _mise_ health. |
| `style` | `'bold purple'` | Стиль модуля. |
| `format` | `'on [$symbol$health]($style) '` | Формат модуля. |
| `healthy_symbol` | `healthy` | The message displayed when _mise_ is healthy. |
| `unhealthy_symbol` | `unhealthy` | The message displayed when _mise_ is unhealthy. |
| `disabled` | `true` | Disables the `mise` module. |
| Параметр | Стандартно | Опис |
| ------------ | --------------------------- | ------------------------------------------ |
| `merge` | `'MERGING'` | Формат рядка під час процесу `merge`. |
| `rebase` | `'REBASING'` | Формат рядка під час процесу `rebase`. |
| `update` | `'UPDATING'` | Формат рядка під час процесу `update`. |
| `bisect` | `'BISECTING'` | Формат рядка під час процесу `bisect`. |
| `shelve` | `'SHELVING'` | Формат рядка під час процесу `shelve`. |
| `graft` | `'GRAFTING'` | Формат рядка під час процесу `graft`. |
| `transplant` | `'TRANSPLANTING'` | Формат рядка під час процесу `transplant`. |
| `histedit` | `'HISTEDITING'` | Формат рядка під час процесу `histedit`. |
| `style` | `'bold yellow'` | Стиль модуля. |
| `format` | `'\([$state]($style)\) '` | Формат модуля. |
| `disabled` | `true` | Вимикає модуль `hg_state`. |
### Змінні
| Змінна | Приклад | Опис |
| ---------------- | ---------- | --------------------------------------- |
| state | `REBASING` | Поточний стан репозиторію |
| progress_current | `1` | Прогрес поточної операції |
| progress_total | `2` | Загальний прогрес операції |
| style\* | | Віддзеркалює значення параметра `style` |
*: Ця змінна може бути використана лише як частина стилю рядка
## Mise
Модуль `mise` показує поточний стан mise, про який повідомляє запуск `mise doctor`.
> [!TIP] Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
### Параметри
| Параметр | Стандартно | Опис |
| ------------------ | -------------------------------- | --------------------------------------------------------- |
| `symbol` | `'mise '` | Символ, який використовується перед показом стану _mise_. |
| `style` | `'bold purple'` | Стиль модуля. |
| `format` | `'on [$symbol$health]($style) '` | Формат модуля. |
| `healthy_symbol` | `healthy` | Повідомлення, яке показується, коли _mise_ справний. |
| `unhealthy_symbol` | `unhealthy` | Повідомлення, яке показується, коли _mise_ несправний. |
| `disabled` | `true` | Вимикає модуль `mise`. |
### Змінні
| Змінна | Приклад | Опис |
| --------- | --------- | ---------------------------------------- |
| health | `healthy` | The health of _mise_ |
| health | `healthy` | Стан справності _mise_ |
| symbol | | Віддзеркалює значення параметра `symbol` |
| style\* | | Віддзеркалює значення параметра `style` |
@@ -3175,7 +3217,7 @@ format = 'via [🐪 $version]($style) '
| ------------------- | ------------------------------------ | -------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | Формат модуля. |
| `show_commit` | `false` | Показує коміт як частину версії. |
| `symbol` | `'Ø '` | Символ, який знаходиться перед версією Zig. |
| `symbol` | `'Ø '` | Символ, який знаходиться перед версією Odin. |
| `style` | `'bold bright-blue'` | Стиль модуля. |
| `disabled` | `false` | Вимикає модуль `odin`. |
| `detect_extensions` | `['odin']` | Які розширення повинні запускати цей модуль. |
@@ -3277,17 +3319,9 @@ symbol = '☁️ '
Модуль `os` показує поточну операційну систему. Інформація про ОС отримується через [os_info](https://lib.rs/crates/os_info).
::: warning
> [!WARNING] Crate [os_info](https://lib.rs/crates/os_info), що використовується цим модулем, може бути не точним в деяких системах.
[os_info](https://lib.rs/crates/os_info), що використовується в цьому модулі, може бути неточним для деяких систем.
:::
::: tip
Цей модуль типово є вимкненим. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
:::
> [!TIP] Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
### Параметри
@@ -3309,6 +3343,7 @@ AlmaLinux = "💠 "
Alpine = "🏔️ "
Amazon = "🙂 "
Android = "🤖 "
AOSC = "🐱 "
Arch = "🎗️ "
Artix = "🎗️ "
Bluefin = "🐟 "
@@ -3352,7 +3387,7 @@ Ubuntu = "🎯 "
Ultramarine = "🔷 "
Unknown = "❓ "
Uos = "🐲 "
Void = " "
Void = " "
Windows = "🪟 "
```
@@ -3387,7 +3422,7 @@ Arch = "Arch is the best! "
## Package Version
Модуль `package` показується, коли поточна тека є сховищем для пакунка, і показує його поточну версію. Наразі модуль підтримує такі пакунки: `npm`, `nimble`, `cargo`, `poetry`, `python`, `composer`, `gradle`, `julia`, `mix`, `helm`, `shards`, `daml` та `dart`.
Модуль `package` показується, коли поточна тека є сховищем для пакунка, і показує його поточну версію. Наразі модуль підтримує такі пакунки: `npm`, `nimble`, `cargo`, `poetry`, `python`, `composer`, `gradle`, `julia`, `mix`, `helm`, `shards`, `galaxy`, `daml` та `dart`.
- [**npm**](https://docs.npmjs.com/cli/commands/npm) — версія пакунка `npm` отримується з `package.json` з поточної теки
- [**JSR**](https://jsr.io/) — версія пакунка `jsr` отримана з файлів `jsr.json`/`jsr.jsonc` чи `deno.json`/`deno.jsonc` у поточній теці
@@ -3403,6 +3438,7 @@ Arch = "Arch is the best! "
- [**Maven**](https://maven.apache.org/) — версія пакунка `maven` отримується з `pom.xml` з поточної теки
- [**Meson**](https://mesonbuild.com/) — версія пакунка `meson` отримується з `meson.build` з поточної теки
- [**Shards**](https://crystal-lang.org/reference/the_shards_command/index.html) — версія пакунка `shards` отримується з `shard.yml` з поточної теки
- [**Galaxy**](https://galaxy.ansible.com/) — версія пакунка `galaxy` отримується з `galaxy.yml` з поточної теки
- [**V**](https://vlang.io) — версія пакунка `vlang` отримується з `v.mod` з поточної теки
- [**SBT**](https://scala-sbt.org) — версія пакунка `sbt` отримується з `build.sbt` з поточної теки
- [**Daml**](https://www.digitalasset.com/developers) — версія пакунка `daml` отримується з `daml.yaml` з поточної теки
@@ -3524,6 +3560,8 @@ format = 'via [🔹 $version](147 bold) '
Модуль `pijul_channel` показує активний канал репозиторію у вашій поточній теці.
> [!TIP] Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
### Параметри
| Параметр | Стандартно | Опис |
@@ -3537,35 +3575,31 @@ format = 'via [🔹 $version](147 bold) '
## Pixi
The `pixi` module shows the installed [pixi](https://pixi.sh) version as well as the activated environment, if `$PIXI_ENVIRONMENT_NAME` is set.
Модуль `pixi` показує встановлену версію [pixi](https://pixi.sh), а також активоване середовище, якщо `$PIXI_ENVIRONMENT_NAME` встановлено.
::: tip
This does not suppress pixi's own prompt modifier, you may want to run `pixi config set change-ps1 false`.
:::
> [!TIP] Це не пригнічує власний модифікатор підказки pixi, ви можете виконати `pixi config set shell.change-ps1 false`.
### Параметри
| Параметр | Стандартно | Опис |
| -------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )(\($environment\) )]($style)'` | Формат модуля. |
| `version_format` | `'v${raw}'` | Формат версії. Доступні змінні `raw`, `major`, `minor` та `patch`. |
| `symbol` | `'🧚 '` | Символ що передує назві оточення. |
| `style` | `'yellow bold' | Стиль модуля. |
| `show_default_environment` | `true` | Whether to indicate that the `default` environment of your project is activated. |
| `pixi_binary` | `['pixi']` | Configures the pixi binary that Starship should execute when getting the version. |
| `detect_extensions` | `[]` | Які розширення повинні запускати цей модуль. |
| `detect_files` | `['pixi.toml']` | Які імена файлів мають запускати цей модуль. |
| `detect_folders` | `['.pixi']` | В яких теках цей модуль має запускатись. |
| `disabled` | `false` | Disables the `pixi` module. |
| Параметр | Стандартно | Опис |
| -------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| `format` | `'via [$symbol($version )(\($environment\) )]($style)'` | Формат модуля. |
| `version_format` | `'v${raw}'` | Формат версії. Доступні змінні `raw`, `major`, `minor` та `patch`. |
| `symbol` | `'🧚 '` | Символ що передує назві оточення. |
| `style` | `'yellow bold'` | Стиль модуля. |
| `show_default_environment` | `true` | Чи вказувати, що у вашому проєкті активовано середовище `default`. |
| `pixi_binary` | `['pixi']` | Налаштовує бінарний файл pixi, який Starship буде використовувати для отримання версії. |
| `detect_extensions` | `[]` | Які розширення повинні запускати цей модуль. |
| `detect_files` | `['pixi.toml']` | Які імена файлів мають запускати цей модуль. |
| `detect_folders` | `[]` | В яких теках цей модуль має запускатись. |
| `disabled` | `false` | Вимикає модуль `pixi`. |
### Змінні
| Змінна | Приклад | Опис |
| ----------- | --------- | ---------------------------------------- |
| version | `v0.33.0` | The version of `pixi` |
| environment | `py311` | The current pixi environment |
| version | `v0.33.0` | Версія `pixi` |
| environment | `py311` | Поточне середовище pixi |
| symbol | | Віддзеркалює значення параметра `symbol` |
| style | | Віддзеркалює значення параметра `style` |
@@ -3582,11 +3616,7 @@ format = '[$symbol$environment](yellow) '
Модуль `pulumi` показує імʼя поточного користувача та версію обраного [Pulumi Stack](https://www.pulumi.com/docs/intro/concepts/stack/).
::: tip
Стандартно версія Pulumi не показується, через те що для цього потрібно набагато більше часу ніж на завантаження більшості втулків (~70ms). Якщо ви все ще хочете увімкнути показ версії, [дивіться приклад нижче](#with-pulumi-version).
:::
> [!TIP] Типово версія Pulumi не показується, оскільки вона завантажується на порядок довше, ніж більшість втулків (~70 мс). Якщо ви все ще хочете увімкнути показ версії, [дивіться приклад нижче](#with-pulumi-version).
Типово, модуль показується, якщо виконується будь-яка з наступних умов:
@@ -3698,27 +3728,23 @@ format = 'via [$symbol$version](bold white)'
### Параметри
| Параметр | Стандартно | Опис |
| -------------------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------- |
| `format` | `'via [${symbol}${pyenv_prefix}(${version} )(\($virtualenv\) )]($style)'` | Формат модуля. |
| `version_format` | `'v${raw}'` | Формат версії. Доступні змінні `raw`, `major`, `minor` та `patch` |
| `symbol` | `'🐍 '` | Формат рядка, що представляє символ Python |
| `style` | `'yellow bold'` | Стиль модуля. |
| `pyenv_version_name` | `false` | Використовувати pyenv для отримання версії Python |
| `pyenv_prefix` | `'pyenv'` | Префікс перед версією pyenv, показується якщо pyenv використовується |
| `python_binary` | `['python', 'python3', 'python2']` | Configures the python binaries that Starship should execute when getting the version. |
| `detect_extensions` | `['py', 'ipynb']` | Які розширення повинні запускати цей модуль |
| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini']` | Назви файлів, які активують модуль |
| `detect_folders` | `[]` | Назви тек, що активують модуль |
| `disabled` | `false` | Вимикає модуль `python`. |
| Параметр | Стандартно | Опис |
| -------------------- | ------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------- |
| `format` | `'via [${symbol}${pyenv_prefix}(${version} )(\($virtualenv\) )]($style)'` | Формат модуля. |
| `version_format` | `'v${raw}'` | Формат версії. Доступні змінні `raw`, `major`, `minor` та `patch` |
| `symbol` | `'🐍 '` | Формат рядка, що представляє символ Python |
| `style` | `'yellow bold'` | Стиль модуля. |
| `pyenv_version_name` | `false` | Використовувати pyenv для отримання версії Python |
| `pyenv_prefix` | `'pyenv'` | Префікс перед версією pyenv, показується якщо pyenv використовується |
| `python_binary` | `['python', 'python3', 'python2']` | Налаштовує бінарні файли python, які Starship буде використовувати для отримання версії. |
| `detect_extensions` | `['py', 'ipynb']` | Які розширення повинні запускати цей модуль |
| `detect_files` | `['.python-version', 'Pipfile', '__init__.py', 'pyproject.toml', 'requirements.txt', 'setup.py', 'tox.ini']` | Назви файлів, які активують модуль |
| `detect_folders` | `[]` | Назви тек, що активують модуль |
| `disabled` | `false` | Вимикає модуль `python`. |
::: tip
Змінна `python_binary` приймає як рядок, так і список рядків. Starship спробує запустити кожен бінарний файл, поки це не дасть результат. Зауважте, що можна змінити двійковий файл, який використовується Starship, щоб отримати версію Python, а не параметрів, які використовуються.
Стандартні значення та порядок для `python_binary` було вибрано так, щоб спочатку ідентифікувати версію Python у середовищах virtualenv/conda (які наразі все ще додають `python`, незалежно від того, чи вказує він на `python3` чи на `python2`). Це може мати побічний ефект: якщо у вас все ще встановлено системний Python 2, він може бути обраний перед будь-яким Python 3 (принаймні в дистрибутивах Linux, які завжди містять символічне посилання `/usr/bin/python` на Python 2). Якщо ви більше не працюєте з Python 2, але не можете видалити системний Python 2, змінивши його на `'python3'`, ви приховаєте будь-яку версію Python 2, див. приклад нижче.
:::
> [!TIP] Змінна `python_binary` приймає або рядок, або список рядків. Starship спробує запустити кожен бінарний файл, поки це не дасть результат. Зауважте, що можна змінити двійковий файл, який використовується Starship, щоб отримати версію Python, а не параметрів, які використовуються.
>
> Стандартні значення та порядок для `python_binary` було вибрано так, щоб спочатку ідентифікувати версію Python у середовищах virtualenv/conda (які наразі все ще додають `python`, незалежно від того, чи вказує він на `python3` чи на `python2`). Це може мати побічний ефект: якщо у вас все ще встановлено системний Python 2, він може бути обраний перед будь-яким Python 3 (принаймні в дистрибутивах Linux, які завжди містять символічне посилання `/usr/bin/python` на Python 2). Якщо ви більше не працюєте з Python 2, але не можете видалити системний Python 2, змінивши його на `'python3'`, ви приховаєте будь-яку версію Python 2, див. приклад нижче.
### Змінні
@@ -4036,11 +4062,7 @@ symbol = '🌟 '
Модуль `shell` показує індикатор поточної оболонки.
::: tip
Цей модуль типово є вимкненим. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
:::
> [!TIP] Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
### Параметри
@@ -4088,6 +4110,8 @@ disabled = false
Модуль `shlvl` показує поточний [`SHLVL`](https://tldp.org/LDP/abs/html/internalvariables.html#SHLVLREF) ('shell level') змінну оточення, якщо він встановлений на число і збігається або перевищує вказаний поріг.
> [!TIP] Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
### Параметри
| Параметр | Стандартно | Опис |
@@ -4242,11 +4266,7 @@ format = '[$symbol$environment](dimmed blue) '
Модуль `status` показує код завершення роботи попередньої команди. Якщо $success_symbol пустий (типово), модуль буде показаний тільки якщо код виходу не `0`. Код status буде перетворений у 32-бітне ціле число.
::: tip
Цей модуль типово є вимкненим. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
:::
> [!TIP] Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
### Параметри
@@ -4305,11 +4325,7 @@ disabled = false
Модуль `sudo` показує, чи облікові дані sudo зараз є в кеші. Модуль показується лише за наявності даних в кеші.
::: tip
Цей модуль типово є вимкненим. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
:::
> [!TIP] Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
### Параметри
@@ -4391,13 +4407,9 @@ format = 'via [🏎 $version](red bold)'
## Terraform
Модуль `terraform` показує поточну вибрану [робочу область Terraform](https://www.terraform.io/docs/language/state/workspaces.html) і версію.
Модуль `terraform` показує поточну вибрану [робочу область Terraform](https://www.terraform.io/docs/language/state/workspaces.html) і версію. Він підтримує як Hashicorp Terraform, так і OpenTofu для виявлення версій.
::: tip
Стандартно версія Terraform не показується, оскільки це повільно для поточних версій Terraform, особливо коли використовується багато втулків. Якщо ви все ще хочете увімкнути показ версії, [дивіться приклад нижче](#with-terraform-version).
:::
> [!TIP] Типово версія Terraform/OpenTofu не показується, оскільки це повільно для поточних версій Terraform, коли використовується багато втулків. Якщо ви все ще хочете увімкнути показ версії, [дивіться приклад нижче](#with-terraform-version).
Типово, модуль показується, якщо виконується будь-яка з наступних умов:
@@ -4406,16 +4418,17 @@ format = 'via [🏎 $version](red bold)'
### Параметри
| Параметр | Стандартно | Опис |
| ------------------- | ------------------------------------ | ----------------------------------------------------------------- |
| `format` | `'via [$symbol$workspace]($style) '` | Формат рядка модуля. |
| `version_format` | `'v${raw}'` | Формат версії. Доступні змінні `raw`, `major`, `minor` та `patch` |
| `symbol` | `'💠'` | Формат рядка, що відображається перед робочою областю terraform. |
| `detect_extensions` | `['tf', 'tfplan', 'tfstate']` | Які розширення повинні запускати цей модуль. |
| `detect_files` | `[]` | Які імена файлів мають запускати цей модуль. |
| `detect_folders` | `['.terraform']` | В яких теках цей модуль має запускатись. |
| `style` | `'bold 105'` | Стиль модуля. |
| `disabled` | `false` | Вимикає модуль `terraform`. |
| Параметр | Стандартно | Опис |
| ------------------- | ------------------------------------------------------- | ----------------------------------------------------------------- |
| `format` | `'via [$symbol$workspace]($style) '` | Формат рядка модуля. |
| `version_format` | `'v${raw}'` | Формат версії. Доступні змінні `raw`, `major`, `minor` та `patch` |
| `symbol` | `'💠'` | Формат рядка, що відображається перед робочою областю terraform. |
| `detect_extensions` | `['tf', 'tfplan', 'tfstate']` | Які розширення повинні запускати цей модуль. |
| `detect_files` | `[]` | Які імена файлів мають запускати цей модуль. |
| `detect_folders` | `['.terraform']` | В яких теках цей модуль має запускатись. |
| `style` | `'bold 105'` | Стиль модуля. |
| `disabled` | `false` | Вимикає модуль `terraform`. |
| `commands` | `[ [ 'terraform', 'version' ], [ 'tofu', 'version' ] ]` | Як визначити версію Terraform. |
### Змінні
@@ -4436,7 +4449,7 @@ format = 'via [🏎 $version](red bold)'
# ~/.config/starship.toml
[terraform]
format = '[🏎💨 $version$workspace]($style) '
format = 'via [$symbol$version $workspace]($style) '
```
#### Без версії Terraform
@@ -4445,18 +4458,14 @@ format = '[🏎💨 $version$workspace]($style) '
# ~/.config/starship.toml
[terraform]
format = '[🏎💨 $workspace]($style) '
format = 'via [$symbol$workspace]($style) '
```
## Time
Модуль `time` показує поточний **місцевий** час. Значення `format` використовується крейтом [`chrono`](https://crates.io/crates/chrono) для визначення формату показу часу. Перегляньте [документацію chrono strftime](https://docs.rs/chrono/0.4.7/chrono/format/strftime/index.html), щоб побачити, які параметри доступні.
::: tip
Цей модуль типово є вимкненим. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
:::
> [!TIP] Типово цей модуль вимкнено. Щоб його увімкнути, встановіть значення параметра `disabled` в `false` у вашому файлі налаштувань.
### Параметри
@@ -4537,11 +4546,7 @@ time_range = '10:00:00-14:00:00'
- Змінна `show_always` встановлена в true
- Масив `detect_env_vars` містить принаймні одну змінну середовища, яку було встановлено
::: tip
Модуль виявляє підключення SSH перевіряючи змінні середовища `SSH_CONNECTION`, `SSH_CLIENT` і `SSH_TTY`. Якщо ваш хост SSH не налаштував ці змінні, одним зі способів розвʼязання проблеми є встановлення для однієї з них фіктивного значення.
:::
> [!TIP] SSH-зʼєднання виявляється шляхом перевірки змінних оточення `SSH_CONNECTION`, `SSH_CLIENT` та `SSH_TTY`. Якщо ваш хост SSH не налаштував ці змінні, одним зі способів розвʼязання проблеми є встановлення для однієї з них фіктивного значення.
### Параметри
@@ -4684,6 +4689,35 @@ format = 'via [V $version](blue bold) '
format = '[🆅 $repo](bold blue) '
```
## XMake
Модуль `xmake` показує поточну встановлену версію [XMake](https://xmake.io/). Типово, модуль показується, якщо виконується будь-яка з наступних умов:
- Поточна тека містить файл `xmake.lua`
### Параметри
| Параметр | Стандартно | Опис |
| ------------------- | ------------------------------------ | ----------------------------------------------------------------- |
| `format` | `'via [$symbol($version )]($style)'` | Формат модуля. |
| `version_format` | `'v${raw}'` | Формат версії. Доступні змінні `raw`, `major`, `minor` та `patch` |
| `symbol` | `'△ '` | Символ, який йде перед версією cmak. |
| `detect_extensions` | `[]` | Які розширення повинні запускати цей модуль |
| `detect_files` | `['xmake.lua']` | Назви файлів, які активують модуль |
| `detect_folders` | `[]` | Назви тек, що активують модуль |
| `style` | `'bold green'` | Стиль модуля. |
| `disabled` | `false` | Вимикає модуль `xmake`. |
### Змінні
| Змінна | Приклад | Опис |
| --------- | -------- | ---------------------------------------- |
| version | `v2.9.5` | Версія xmake |
| symbol | | Віддзеркалює значення параметра `symbol` |
| style\* | | Віддзеркалює значення параметра `style` |
*: Ця змінна може бути використана лише як частина стилю рядка
## Zig
Модуль `zig` показує поточну встановлену версію [Zig](https://ziglang.org/). Модуль показується, якщо виконується будь-яка з наступних умов:
@@ -4734,31 +4768,17 @@ symbol = '⚡️ '
- Команда `when` повертає 0
- Поточна операційна система (std::env::consts::OS) збігається з полем `os`, якщо визначено.
::: tip
> [!TIP] Кілька власних модулів можна визначити за допомогою `.`.
Кілька власних модулів можна визначити за допомогою символу "`.`".
> [!TIP] Порядок показу власних модулів можна встановити індивідуально, включивши `${custom.foo}` у формат верхнього рівня `format` (оскільки він містить крапку, потрібно використовувати `${...}`). Типово, модуль `custom` покаже усі модулі custom, в тому порядку, в якому вони були визначені.
:::
> [!TIP] [Тікет #1252](https://github.com/starship/starship/discussions/1252) містить приклад власних модулів. Якщо у вас є цікавий приклад ще не розкритий там, не соромтеся, поділитися ним!
::: tip
Порядок в якому власні модулі будуть показуватись може бути встановлений індивідуально додаванням `${custom.foo}` до змінної `format` верхнього рівня (через те, що назви містять точки вам треба використовувати`${...}`). Типово, модуль `custom` покаже усі модулі custom, в тому порядку, в якому вони були визначені.
:::
::: tip
[Квиток #1252](https://github.com/starship/starship/discussions/1252) містить приклади власних модулів. Якщо у вас є цікавий приклад ще не розкритий там, не соромтеся, поділитися ним!
:::
::: warning Якщо увімкнено `unsafe_no_escape` або до версії starship v1.20 вивід команди буде виведено без екранування.
Незалежно від результату, який генерує команда, він виводиться в командний рядок у незміненому вигляді. Це означає, що якщо вивід містить специфічні для оболонки інтерпретовані послідовності, вони можуть бути інтерпретовані безпосередньо під час виведення на екран. Залежно від оболонки, це може означати, що, наприклад, рядки, у зворотніх лапках, виконуються оболонкою. Такі послідовності зазвичай залежать від оболонки, наприклад, ви можете написати командний модуль, який пише послідовності для bash, наприклад, `\h`, але цей модуль не працюватиме в оболонці fish або zsh.
Рядок формату також може містити специфічні послідовності командного рядка, наприклад [Bash](https://www.gnu.org/software/bash/manual/html_node/Controlling-the-Prompt.html), [Zsh](https://zsh.sourceforge.io/Doc/Release/Prompt-Expansion.html).
:::
> [!WARNING] Якщо увімкнено `unsafe_no_escape` або до версії starship v1.20 вивід команди буде показано без екранування.
>
> Незалежно від результату, який генерує команда, він виводиться в командний рядок у незміненому вигляді. Це означає, що якщо вивід містить специфічні для оболонки інтерпретовані послідовності, вони можуть бути інтерпретовані безпосередньо під час виведення на екран. Залежно від оболонки, це може означати, що, наприклад, рядки, у зворотніх лапках, виконуються оболонкою. Такі послідовності зазвичай залежать від оболонки, наприклад, ви можете написати командний модуль, який пише послідовності для bash, наприклад, `\h`, але цей модуль не працюватиме в оболонці fish або zsh.
>
> Рядки формату також можуть містити вказані послідовності запиту, наприклад [Bash](https://www.gnu.org/software/bash/manual/html_node/Controlling-the-Prompt.html), [Zsh](https://zsh.sourceforge.io/Doc/Release/Prompt-Expansion.html).
### Параметри
@@ -4808,17 +4828,15 @@ symbol = '⚡️ '
shell = ['pwsh', '-Command', '-']
```
::: warning Переконайтеся, що ваша оболонка завершує процеси правильно
Якщо ви вказуєте власну команду, переконайтеся, що стандартний Shell, який використовується starship, буде виконувати команди з чистим (graceful) завершенням, за допомогою параметра `shell`.
Наприклад, PowerShell потребує параметр `-Command` для виконання однорядкової команди. Пропуск цього параметра може призвести до рекурсивного циклу starship, де оболонка може спробувати знову завантажити повний профіль середовища з самим starship і, отже, повторно виконати власну команду, потрапивши в нескінченний цикл.
Параметри, подібні до `-NoProfile` у PowerShell, також рекомендовані для інших оболонок, щоб уникнути додаткового часу завантаження власного профілю під час кожного виклику Starship.
Наразі реалізовано автоматичне виявлення оболонок і правильне додавання параметрів, але можливо, що охоплено не всі оболонки. [Будь ласка, сповістіть про проблему](https://github.com/starship/starship/issues/new/choose) з подробицями про термінал та конфігурацію автозапуску, якщо ви зіткнулись з таким сценарієм.
:::
> [!WARNING] Переконайтеся, що ваша власна конфігурація оболонки відповідним чином завершує роботу
>
> Якщо ви вказуєте власну команду, переконайтеся, що стандартний Shell, який використовується starship, буде виконувати команди з чистим (graceful) завершенням, за допомогою параметра `shell`.
>
> Наприклад, PowerShell потребує параметр `-Command` для виконання однорядкової команди. Пропуск цього параметра може призвести до рекурсивного циклу starship, де оболонка може спробувати знову завантажити повний профіль середовища з самим starship і, отже, повторно виконати власну команду, потрапивши в нескінченний цикл.
>
> Параметри, подібні до `-NoProfile` у PowerShell, також рекомендовані для інших оболонок, щоб уникнути додаткового часу завантаження власного профілю під час кожного виклику Starship.
>
> Наразі реалізовано автоматичне виявлення оболонок і правильне додавання параметрів, але можливо, що охоплено не всі оболонки. [Будь ласка, сповістіть про проблему](https://github.com/starship/starship/issues/new/choose) з подробицями про термінал та конфігурацію автозапуску, якщо ви зіткнулись з таким сценарієм.
### Приклад