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

Які налаштування використовуються в демо-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')"'

Як встановити 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.