1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
|
# Часті питання
## Які налаштування використовуються в демо-GIF?
- **Емулятор термінала**: [iTerm2](https://iterm2.com/)
- **Тема**: Minimal
- **Схема кольорів**: [Snazzy](https://github.com/sindresorhus/iterm2-snazzy)
- **Шрифт**: [FiraCode Nerd Font](https://www.nerdfonts.com/font-downloads)
- **Оболонка**: [Fish Shell](https://fishshell.com/)
- **Налаштування**: [matchai's Dotfiles](https://github.com/matchai/dotfiles/blob/b6c6a701d0af8d145a8370288c00bb9f0648b5c2/.config/fish/config.fish)
- **Командний рядок**: [Starship](https://starship.rs/)
## Як зробити завершення команди як показано в демо-GIF?
Підтримка завершення або автозаповнення, надається вашою оболонкою. У випадку з демо, воно було зроблене у [Fish Shell](https://fishshell.com/), яке стандартно забезпечує доповнення команд. Якщо ви використовуєте Z Shell (zsh), ви можете глянути на [zsh-autosuggions](https://github.com/zsh-users/zsh-autosuggestions).
## Чи `format` та `<module>.`disabled верхнього рівня роблять теж саме?
Так, вони обидва можуть використовуватись для вимикання модулів у командному рядку. Якщо ви плануєте вимикати модулі, `<module>.disabled` є переважним способом бо:
- Вимкнення модулів є більш явною дією аніж приховування їх у `format`
- Нові створені модулі будуть додані до командного рядка, оскільки Starship оновлюється
## В документації йдеться, що Starship є крос-оболонковим. Чому ж тоді моя оболонка не підтримується?
Через те, яким чином Starship побудований, підтримку практично будь-якої оболонки можна достатньо легко додати. Двійковий файл starship не має статусу та не залежить від оболонки, тому Starship можна використовувати, якщо ваша оболонка підтримує оперативне налаштування та розширення оболонки.
Ось маленький приклад того, як зробити так, щоб Starship працював в bash:
```sh
# Отримати код статусу виконання з останньої команди
STATUS=$?
# Отримати кількість запущених завдань.
NUM_JOBS=$(jobs -p | wc -l)
# Встановити для командного рядка вивід `starship prompt`
PS1="$(starship prompt --status=$STATUS --jobs=$NUM_JOBS)"
```
Реалізація [Bash](https://github.com/starship/starship/blob/master/src/init/starship.bash) створена в Starship є трохи складнішою, щоб дозволити використання додаткових функцій, таких як модуль [Command Duration](https://starship.rs/config/#command-duration) і переконатися, що Starship сумісний із попередньо встановленими конфігураціями Bash.
Для отримання переліку всіх прапорів, які приймаються `starship prompt`, скористайтесь наступною командою:
```sh
starship prompt --help
```
Командний рядок використовуватиме якомога більше отриманого контексту, однак прапорці не є "обовʼязковими".
## Як запустити Starship в дистрибутивах Linux зі старими версіями glibc?
Якщо ви отримуєте помилку_версію 'GLIBC_2.18' не знайдено (потрібна для starship)_при використанні вбудованого бінарного файлу (наприклад, на CentOS 6 або 7), ви можете використовувати бінарний файл скомпільований з підтримкою `musl` замість `glibc`:
```sh
curl -sS https://starship.rs/install.sh | sh -s -- --platform unknown-linux-musl
```
## Чому я бачу попередження `Executing command "..." timed out.`?
Starship виконує різні команди, щоб отримати інформацію для показу в командному рядку, наприклад версію програми або поточного статусу git. Щоб переконатися, що starship не підвис, намагаючись виконати ці команди, ми встановлюємо ліміт, якщо виконання команди займе більше часу, starship зупинить виконання команди та видасть попередження, це очікувана поведінка. Цей ліміт часу можна налаштувати за допомогою [ключа `command_timeout`](../config/#prompt), так що, якщо ви хочете, ви можете збільшити ліміт часу. Ви можете також виконати дії для відлагодження, щоб побачити, яка команда є повільною і подивитися, чи ви можете її оптимізувати. Нарешті ви можете встановити `STARSHIP_LOG` у `error`, щоб приховати ці попередження.
## Я бачу якісь символи, але не розумію, що вони значать?
Якщо ви бачите символи, які ви не можете розпізнати, ви можете скористатись `starship explain`, для отримання пояснень для показаних модулів.
## Starship робить щось несподіване, як я можу налагодити його?
Ви можете увімкнути журнал налагодження за допомогою змінної оточення `STARSHIP_LOG`. Ці журнали можуть бути дуже докладними, тому часто корисно використовувати команду `module`, якщо ви намагаєтеся налагодити певний модуль, наприклад, якщо ви намагаєтеся налагодити `rust`, ви можете виконати таку команду, щоб отримати журнали трасування та вивід модуля.
```sh
env STARSHIP_LOG=trace starship module rust
```
Якщо Starship працює повільно, ви можете спробувати використати команду `timings`, щоб побачити, чи є певний модуль або команда, які можна в цьому звинуватити.
```sh
env STARSHIP_LOG=trace starship timings
```
Це виведе журнал трасування та розбивку всіх модулів, для виконання яких знадобилося понад 1 мс, або вони дали певні результати.
Нарешті, якщо ви знайшли помилку, ви можете використати команду `bug-report`, щоб створити квиток в GitHub.
```sh
starship bug-report
```
## Чому я не бачу символу гліфа в командному рядку?
Найпоширенішою причиною цього є неправильна конфігурація системи. Зокрема, деякі дистрибутиви Linux не мають підтримки шрифтів із коробки. Ви повинні переконатись, що:
- Для вашої мови встановлено значення UTF-8, наприклад `de_DE.UTF-8` або `ja_JP.UTF-8`. Якщо `LC_ALL` не є значенням UTF-8, [вам потрібно буде його змінити](https://www.tecmint.com/set-system-locales-in-linux/).
- У вас встановлено шрифт для emoji. Більшість систем стандартно мають шрифт для показу emoji, але деякі (зокрема Arch Linux) — ні. Зазвичай ви можете встановити його через системний менеджер пакунків – [noto emoji](https://www.google.com/get/noto/help/emoji/) є популярним вибором.
- Ви використовуєте [Nerd Font](https://www.nerdfonts.com/).
Щоб перевірити свою систему, виконайте наступні команди в терміналі:
```sh
echo -e "\xf0\x9f\x90\x8d"
echo -e "\xee\x82\xa0"
```
У першому рядку має бути [емодзі змії](https://emojipedia.org/snake/), у той час як другий має показати [символ гілки (e0a0)](https://github.com/ryanoasis/powerline-extra-symbols#glyphs).
Якщо будь-який символ не показується належним чином, ваша система все ще не налаштована правильно. На жаль, інколи важко налаштувати правильну конфігурацію шрифту. Користувачі в Discord можуть допомогти. Якщо обидва символи відображаються правильно, але ви все одно не бачите їх у starship, [надішліть звіт про помилку!](https://github.com/starship/starship/issues/new/choose)
## Як видалити Starship?
Starship так само легко видалити, як і встановити.
1. Видаліть усі рядки у конфігурації оболонки (наприклад, `~/.bashrc`), які використовуються для ініціалізації Starship.
1. Видаліть двійковий файл Starship.
Якщо Starship був встановлений за допомогою менеджера пакунків, будь ласка, зверніться до документації по їх видаленню.
Якщо Starship було встановлено за допомогою сценарію встановлення, наступна команда видалить двійковий файл:
```sh
# Locate and delete the starship binary
sh -c 'rm "$(command -v 'starship')"'
```
## Як встановити Starship без `sudo`?
Скрипт для встановлення оболонки (`https://starship.rs/install.sh`) намагається використовувати `sudo` лише в тому випадку, якщо поточний користувач не може писати в цільову теку. Стандартна тека для встановлення — є значенням змінної `$BIN_DIR` або це `/usr/local/bin`, якщо змінну `$BIN_DIR` не встановлено. Якщо замісць стандартної теки вказати теку, в яку ви можете писати, starship можна встановити без використання `sudo`. Наприклад, `curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin` використовує параметр `-b` для встановлення в теку`~/.local/bin`.
Якщо ви хочете виконати встановлення в повністю автоматичному режимі, не перериваючись на підтвердження в процесі, додайте параметр `-y`. Перегляньте сирці скрипту встановлення для ознайомлення зі всіма можливими параметрами.
У разі використання пакетного менеджера, ознайомтесь з документацією до нього що до можливості встановлення з застосуванням, чи без, `sudo`.
|