برای تنظیم کردن استارشیپ کافیه فایل زیر رو ایجاد کنید(اگر وجود نداره) و چیزایی که دوست دارید رو اونجا قرار بدید.
~/.config/starship.toml
اینجا من قصد ندارم خیلی درباره تنظیم کردنش حرف بزنم، فقط چیزای ساده رو میگم. برای تنظیمات بیشتر به سایتش مراجعه کنید.
اول با prompt شروع کنیم. اینو رو داخل فایل قرار بدید(اگر میخواید از ظاهر پیشفرض استفاده کنید، ازین قسمت رد بشید)
format = '''
[┌───────────────────>](bold green)
[│](bold green)$directory
[└─>](bold green) '''
تغییرات رو ذخیره کنید. میبینید که ظاهر پوسته عوض شده!
همین الان میتونید رنگ هارو عوض کنید یا شکل رو تغییر بدید. اگر میخواید از کاراکتر های خاص استفاده کنید
این صفحه ویکیپدیا منبع خوبیه. فقط کافیه کاراکتر موردنظر رو کپی کنید و جای دلخواه قرار بدید.
برای رنگ میتونید ازین رنگها بصورت مستفیم استفاده کنید:
black, red, green, blue, yellow, purple, cyan, white
برای ظاهر هم میتونید ازینا استفاده کنید:
bold, italic, underline, dimmed, inverted, blink, hidden, strikethrough
مثلا میتونید اینجوری تعیین کنید: (italic purple) و البته با کد هگزادسیمال ( bold fg:#123456)
با قرار دادن این خط میتونید تنظیم کنید که یک خط خالی قبل از هر prompt نمایش داده بشه یا نه
add_newline = false
اگر لپتاپ یا موبایل دارید و میخواید باطری رو داخل prompt ببینید اینهارو اضافه کنید
[battery]
disabled = false
full_symbol = '🔋 '
charging_symbol = '⚡️ '
discharging_symbol = '💀 '
[[battery.display]]
threshold = 70
style = 'bold red'
شکل ایموجیها و ظاهر رو به دلخواه میتونید تغییر بدید. مفدار threshold تعیینکننده حداکثر مقداری هست که ماژول باطری فعال میشه(باطری نمایش داده میشه) که من اینجا 70 گذاشتم. یعنی اگر باظری زیر 70 درصد بود نمایش بده.
برای تغییر کاراکتری که وضعیت اجرای دستور قبلی رو نمایش میده، کد زیر رو قرار بدید
[character]
success_symbol = '[➜](bold green) '
error_symbol = '[✗](bold red) '
میتونید برای حالت اجرای درست و اجرای با خطا از کاراکترهای یکسان یا متفاوت به دلخواه استفاده کنید.
برای تغییر نمایش مسیری که داخلش هستید از کد زیر استفاده کنید
[directory]
truncation_length = 3
truncation_symbol = '…/'
truncation_length تعیین کننده عمقی هست که اسم دایرکتوریها نمایش داده میشه. اینجا اگر بیشتر از 3 دایرکتوری از home پایینتر رفته باشید، مقدار truncation_symbol رو نمایش میده و بعد 3 دایرکتوری آخر رو.
مثلا اینجوری میشه:
~/.cache/yay/jcal/.git ==> …/jcal/.git
میتونید برای نمایش home از کاراکتر دلخواه استفاده کنید، کافیه همینجا متغیر home_symbol رو تنظیم کنید.
اگر میخواید زمان رو نمایش بدید:
[time]
disabled = false
format = '🕙[\[ $time \]]($style) '
time_format = '%T'
اگر میخواید زمان اجرای دستور قبلی رو ببینید:
[cmd_duration]
disabled = false
format = "[took](yellow) [$duration]($style)"
min_time = 250
show_notifications = true
min_time_to_notify = 8_000
اینحا مقدار min_time به میلی ثانیه هست و تعیین کننده حداقل زمانیه که این ماژول فعال میشه.
مقدار min_time_to_notify مقداری هست که بعد از اون براتون یک اعلان میاد که دستوری که داشتید اجرا میکردید تموم شده. باید show_notifications رو true بذارید تا اعلان نمایش داده بشه.
اگر ظاهر اصلی prompt رو تغییر داده باشید متوجه میشید که تغییراتی که اعمال کردید نمایش داده نمیشن!! دلیلش اینه که باید محل قرارگیری ماژول هارو تعیین کنید. برای اینکار کافیه در قسمت format که اول این ارسال گفنم، در جای دلخواه اسم ماژول رو قرار بدید. یادتون نره قبلش علامت $ رو بذارید.
مثلا:
format = '''
[┌───────────────────>](bold green)$cmd_duration
[│](bold green)$directory
[└─>](bold green)$time$battery '''
تمام ماژول هایی که گفتم، متغیر style رو دارن که با تنظیم کردنش میتونید ظاهر اون ماژول رو تغییر بدید. همون bold green
دقت کنید بعضی ماژولها بصورت پیشفرض فعال نیستن و باید با قرار دادن disabled = false فعالشون کنید.
تنظیمات خیلی بیشتری میتونید اعمال کنید. خیلی از ماژولها رو فقط کافیه اسمشون رو در جای دلخواه قرار بدید تا کار کنه.
اگر میخواید یک symbol تعریف کنید و همونجا ظاهرش رو تعیین کنید(مثل کاری که برای character انجام دادیم) شکل، نوشته یا علامت هارو باید بین "[]" قرار بدید و استایل موردنظر رو بین "()". در غیر اینصورت شکل رو بصورت یک رشته عادی تعریف کنید و ظاهر رو داخل متغیر style.
اینجا میتونید تنظیمات من رو ببینید.