starship/README.md at 5a988515a061d475bb739d2bf887e35495306c3e

mirror of https://github.com/Llewellynvdm/starship.git synced 2024-11-16 10:05:13 +00:00

- Fix some broken markup on README.md

2020-01-20 13:04:11 -05:00

35 KiB

Raw Blame History

網站 · 安裝 · 設定

Starship 是一個可以用於任何 shell、極小、極快、可高度客製化的提示字元！
這個提示字元顯示你工作時需要的資訊，同時又順暢又不會打擾你。

Starship with iTerm2 and the Snazzy theme

🍬 特色

如果最近一個指令結束時回傳非零的代碼，提示字元將轉成紅色
現在的 Go 版本 (🐹)
Current Java version (☕)
Current Node.js version (⬢)
Current PHP version (🐘)
現在的 Python 版本 (🐍)
現在的 Ruby 版本 (💎)
現在的 Rust 版本 (🦀)
Current .NET version (•NET)
現在資料夾中的組件 (package) 版本 (📦)
- npm (Node.js)
- cargo (Rust)
- poetry (Python)
- composer (PHP)
現在的 Git branch 與豐富的程式庫 (repository) 狀態：
- = — 修改衝突
- ⇡ — 超前遠端 (remote) branch
- ⇣ — 落後遠端 (remote) branch
- ⇕ — 修改發散 (diverge)
- ? — 修改未追蹤
- $ — 隱藏的 (stashed) 修改
- ! — 修改過的檔案
- + — 新增的檔案
- » — 重新命名的檔案
- ✘ — 刪除的檔案
Current Mercurial branch
現在的電池電量與狀態
- ⇡ – charging
- ⇣ – discharging
- • – fully charged
標註背景執行的工作 (✦)
現在的 Kubernetes 叢集以及名稱空間 (Namespace) (☸)
Current Amazon Web Services (AWS) profile (☁️)
Execution time of the last command
Custom environment variable value
偵測 Nix-shell 的環境
會在使用者與登入的使用者不同時顯示使用者名稱
Optional current time in 12/24hr format
Current Terraform Workspace and version (💠)
Current Conda environment (C)

🚀 安裝

先決要求

一個已經安裝並在你的終端機內啟動的 Powerline 字型 (例如，試試看 Fira Code)。

入門

安裝 starship 執行檔：

Install Latest Version

From prebuilt binary, with Shell:
```
curl -fsSL https://starship.rs/install.sh | bash
```
From source on crates.io:
```
cargo install starship
```
Install via Package Manager

With Homebrew:
```
brew install starship
```
With Scoop:
```
scoop install starship
```
將初始化腳本 (script) 加入你的 shell 的設定檔：

Bash

將以下內容放到 ~/.bashrc 的結尾：
```
# ~/.bashrc

eval "$(starship init bash)"
```
Fish

將以下內容放到 ~/.config/fish/config.fish 的結尾：
```
# ~/.config/fish/config.fish

starship init fish | source
```
Zsh

將以下內容放到 ~/.zshrc 的結尾：
```
# ~/.zshrc

eval "$(starship init zsh)"
```
PowerShell

將以下內容放到 ~\Documents\PowerShell\Microsoft.PowerShell_profile.ps1 的結尾 (或是在 -Nix 上的 ~/.config/powershell/Microsoft.PowerShell_profile.ps1)：
```
# ~\Documents\PowerShell\Profile.ps1

Invoke-Expression (&starship init powershell)
```
Ion

Add the following to the end of ~/.config/ion/initrc:
```
# ~/.config/ion/initrc

eval $(starship init ion)
```

🔧 設定

關於如何設定 Starship，請看文件。

🤝 貢獻

我們歡迎具有各式各樣能力的貢獻者！如果你正在尋找容易加入的方法，試試看標註為「good first issue」的 issue。

高優先需求

👩‍💼 專案管理員
- 我們有一個 GitHub 專案以及許多尚未整理/排序的功能，甚至還有點子尚未被製作成 issue。 Starship 需要有人掌管產品的方向！
👩‍🎨 設計師
- 喜歡製作吸睛的網站？超讚！我們正在想辦法建立一個漂亮的 landing page 來展示 Starship 的美妙。幫助設計 Starship 的商標正好是一個試驗新點子的機會！
👩‍💻 Rust 開發者
- 當正在寫慣用的 Rust 程式碼、設計高效的 Rust 程式架構、效能優化、跨平台建置優化、以及其他很多東西時，可以在這裡看到_許多_唾手可得的東西！我 (@matchai) 是一個 Rust 新手。來為我們指出正確的方向吧！

如果你對貢獻 Starship 有興趣，請看我們的貢獻指南。另外，請不用客氣加入我們的 Discord 伺服器並來問候一下。 👋

貢獻者們

感謝這些優秀的人們 (表情符號索引)：

_{Matan Kushner} 💻 🎨 🤔 🚇 🚧 👀 ⚠️	_{John Letey} 💻 🤔 👀 ⚠️	_{Tim Mulqueen} 💻 🤔 👀 ⚠️	_{Tiffany Le-Nguyen} 🤔 🚧 👀 📖	_Snuggle 🎨 🤔 🚧 👀	_{Ryan Leckey} 👀	_{Youssef Habri} 💻
_{Kevin Song} 🐛 💻 📖 ⚠️	_{Andrew Dassonville} 🐛 💻	_MaT1g3R 💻 📖 ⚠️	_{André Zanellato} 💻 📖 ⚠️	_{Saghm Rossi} 💻 📖 ⚠️	_{Shu Kutsuzawa} 💻 📖 ⚠️ 🌍	_{Saurav Sharma} 💻 📖
_{Thomas O'Donnell} 💻 ⚠️ 📖 👀	_{Bruno Bigras} 💻 👀	_{Neil Kistner} 💻 ⚠️ 👀	_{Quinn Strahl} 💻 ⚠️	_{Titouan Vervack} 💻 ⚠️	_{Francisco Lopes} 💻	_{Andrew Houts} 💻 📖 ⚠️
_{Nick Young} 💻 📖 ⚠️ 👀	_{Gabriel de Perthuis} 💻	_Hofer-Julian 📖	_{Yuji Ueki} 🖋 🌍	_谢祯晖 💻 📖 🌍 👀	_{Kutsuzawa Ryo} 👀 💻 ⚠️ 🌍	_hdevalke 🤔
_{Kuba Clark} 💻 📖 ⚠️	_Gimbar 💻 ⚠️ 📖	_{Tom Hotston} 💻 📖	_{Bijan Chokoufe Nejad} 💻 ⚠️ 👀	_yuri 💻 📖 ⚠️	_{TsubasaKawajiri} 🌍	_{Ryo Yamashita} 💻
_{Thomas Lee} 💻	_(´⌣`ʃƪ) 💻	_{Barnaby Keene} 💻	_{Keith Wade} 💻 ⚠️	_LukeAI 📖	_{Zach Mertes} 💻 📖 ⚠️	_{David Knaack} 💻 📖 ⚠️
_{Carl Summers} 📖	_{Yushan Lin} 🌍	_{Weihang Lo} 🌍	_pinshan 🌍	_{Brian Low} 💻 📖 ⚠️	_{Matias Kotlik} 💻	_marblenix 🚇 💻 ⚠️
_Raidou 💻 ⚠️	_{Luca Greco} 💻 📖 ⚠️	_{Luca Rinaldi} 💻	_{Stephen Ball} 💻 ⚠️ 📖	_{Qingping Hou} 💻 📖 ⚠️	_{Dan Wendorf} 💻 ⚠️	_{Alan Pope} 🚇
_BuggStream 💻 📖	_{Jon Grythe Stødle} 💻 ⚠️	_{Jason Etcovitch} 🐛	_{Etienne Mabille} 💻	_{AppleTheGolden} 💻 📖	_{Mike Sampson} 💻 📖 ⚠️	_{Dominik Braun} 💻
_{David Hewson} 💻