starship/docs/uk-UA/faq/README.md

Часті питання

Які налаштування використовуються в демо-GIF?

• Емулятор термінала: iTerm2
  • Тема: Minimal
  • Схема кольорів: Snazzy
  • Шрифт: FiraCode Nerd Font
• Оболонка: Fish Shell
  • Налаштування: matchai's Dotfiles
  • Командний рядок: Starship

Як зробити завершення команди як показано в демо-GIF?

Підтримка завершення або автозаповнення, надається вашою оболонкою. У випадку з демо, воно було зроблене у Fish Shell, яке стандартно забезпечує доповнення команд. Якщо ви використовуєте Z Shell (zsh), ви можете глянути на zsh-autosuggions.

Чи format та <module>.disabled верхнього рівня роблять теж саме?

Так, вони обидва можуть використовуватись для вимикання модулів у командному рядку. Якщо ви плануєте вимикати модулі, <module>.disabled є переважним способом бо:

• Вимкнення модулів є більш явною дією аніж приховування їх у format
• Нові створені модулі будуть додані до командного рядка, оскільки Starship оновлюється

В документації йдеться, що Starship є крос-оболонковим. Чому ж тоді моя оболонка не підтримується?

Через те, яким чином Starship побудований, підтримку практично будь-якої оболонки можна достатньо легко додати. Двійковий файл starship не має статусу та не залежить від оболонки, тому Starship можна використовувати, якщо ваша оболонка підтримує оперативне налаштування та розширення оболонки.

Ось маленький приклад того, як зробити так, щоб Starship працював в bash:

# Отримати код статусу виконання з останньої команди
STATUS=$?

# Отримати кількість запущених завдань.
NUM_JOBS=$(jobs -p | wc -l)

# Встановити для командного рядка вивід `starship prompt`
PS1="$(starship prompt --status=$STATUS --jobs=$NUM_JOBS)"

Реалізація Bash створена в Starship є трохи складнішою, щоб дозволити використання додаткових функцій, таких як модуль Command Duration і переконатися, що Starship сумісний із попередньо встановленими конфігураціями Bash.

Для отримання переліку всіх прапорів, які приймаються starship prompt, скористайтесь наступною командою:

starship prompt --help

Командний рядок використовуватиме якомога більше отриманого контексту, однак прапорці не є "обовʼязковими".

Як запустити Starship в дистрибутивах Linux зі старими версіями glibc?

Якщо ви отримуєте помилку_версію 'GLIBC_2.18' не знайдено (потрібна для starship)_при використанні вбудованого бінарного файлу (наприклад, на CentOS 6 або 7), ви можете використовувати бінарний файл скомпільований з підтримкою musl замість glibc:

curl -sS https://starship.rs/install.sh | sh -s -- --platform unknown-linux-musl

Чому я бачу попередження Executing command "..." timed out.?

Starship виконує різні команди, щоб отримати інформацію для показу в командному рядку, наприклад версію програми або поточного статусу git. Щоб переконатися, що starship не підвис, намагаючись виконати ці команди, ми встановлюємо ліміт, якщо виконання команди займе більше часу, starship зупинить виконання команди та видасть попередження, це очікувана поведінка. Цей ліміт часу можна налаштувати за допомогою ключа command_timeout, так що, якщо ви хочете, ви можете збільшити ліміт часу. Ви можете також виконати дії для відлагодження, щоб побачити, яка команда є повільною і подивитися, чи ви можете її оптимізувати. Нарешті ви можете встановити STARSHIP_LOG у error, щоб приховати ці попередження.

Я бачу якісь символи, але не розумію, що вони значать?

Якщо ви бачите символи, які ви не можете розпізнати, ви можете скористатись starship explain, для отримання пояснень для показаних модулів.

Starship робить щось несподіване, як я можу налагодити його?

Ви можете увімкнути журнал налагодження за допомогою змінної оточення STARSHIP_LOG. Ці журнали можуть бути дуже докладними, тому часто корисно використовувати команду module, якщо ви намагаєтеся налагодити певний модуль, наприклад, якщо ви намагаєтеся налагодити rust, ви можете виконати таку команду, щоб отримати журнали трасування та вивід модуля.

env STARSHIP_LOG=trace starship module rust

Якщо Starship працює повільно, ви можете спробувати використати команду timings, щоб побачити, чи є певний модуль або команда, які можна в цьому звинуватити.

env STARSHIP_LOG=trace starship timings

Це виведе журнал трасування та розбивку всіх модулів, для виконання яких знадобилося понад 1 мс, або вони дали певні результати.

Нарешті, якщо ви знайшли помилку, ви можете використати команду bug-report, щоб створити квиток в GitHub.

starship bug-report

Чому я не бачу символу гліфа в командному рядку?

Найпоширенішою причиною цього є неправильна конфігурація системи. Зокрема, деякі дистрибутиви Linux не мають підтримки шрифтів із коробки. Ви повинні переконатись, що:

• Для вашої мови встановлено значення UTF-8, наприклад de_DE.UTF-8 або ja_JP.UTF-8. Якщо LC_ALL не є значенням UTF-8, вам потрібно буде його змінити.
• У вас встановлено шрифт для emoji. Більшість систем стандартно мають шрифт для показу emoji, але деякі (зокрема Arch Linux) — ні. Зазвичай ви можете встановити його через системний менеджер пакунків – noto emoji є популярним вибором.
• Ви використовуєте Nerd Font.

Щоб перевірити свою систему, виконайте наступні команди в терміналі:

echo -e "\xf0\x9f\x90\x8d"
echo -e "\xee\x82\xa0"

У першому рядку має бути емодзі змії, у той час як другий має показати символ гілки (e0a0).

Якщо будь-який символ не показується належним чином, ваша система все ще не налаштована правильно. На жаль, інколи важко налаштувати правильну конфігурацію шрифту. Користувачі в Discord можуть допомогти. Якщо обидва символи відображаються правильно, але ви все одно не бачите їх у starship, надішліть звіт про помилку!

Як видалити Starship?

Starship так само легко видалити, як і встановити.

1. Видаліть усі рядки у конфігурації оболонки (наприклад, ~/.bashrc), які використовуються для ініціалізації Starship.
2. Видаліть двійковий файл Starship.

Якщо Starship був встановлений за допомогою менеджера пакунків, будь ласка, зверніться до документації по їх видаленню.

Якщо Starship було встановлено за допомогою сценарію встановлення, наступна команда видалить двійковий файл:

# Locate and delete the starship binary
sh -c 'rm "$(command -v 'starship')"'

How do I install Starship without sudo?

The shell install script (https://starship.rs/install.sh) only attempts to use sudo if the target installation directory is not writable by the current user. The default installation diretory is the value of the $BIN_DIR environment variable or /usr/local/bin if $BIN_DIR is not set. If you instead set the installation directory to one that is writable by your user, you should be able to install starship without sudo. For example, curl -sS https://starship.rs/install.sh | sh -s -- -b ~/.local/bin uses the -b command line option of the install script to set the installation directory to ~/.local/bin.

For a non-interactive installation of Starship, don't forget to add the -y option to skip the confirmation. Check the source of the installation script for a list of all supported installation options.

When using a package manager, see the documentation for your package manager about installing with or without sudo.