starship/docs/ja/config
Shu Kutsuzawa f794574be8 docs(i18n): Translate #367 to Japanese (#379)
Signed-off-by: cappyzawa <cappyzawa@yahoo.ne.jp>
Co-authored-by: Kutsuzawa Ryo <kutsuzawa2851@gmail.com>
2019-09-16 12:19:47 -04:00
..
README.md docs(i18n): Translate #367 to Japanese (#379) 2019-09-16 12:19:47 -04:00

蚭定

::: tip 🔥Starshipの開発は珟圚も進んでいたす。倚くの新しいオプションが今埌のリリヌスで利甚可胜になりたす。 :::

starshipの蚭定を開始するには、~/.config/starship.toml ファむルを䜜成したす。

$ touch ~/.config/starship.toml

starshipのすべおの蚭定は、このTOMLファむルで行われたす。

# プロンプト衚瀺時に改行しない
add_newline = false

# "❯" から "➜" に衚瀺を倉曎
[character]      # The name of the module we are confguring is "character"
symbol = "➜"     # The "symbol" segment is being set to "➜"

# packageモゞュヌルを無効にする
[package]
disabled = true

甚語

モゞュヌル: OSのコンテキスト情報に基づいお情報を提䟛するプロンプト内のコンポヌネントです。たずえば、珟圚のディレクトリがNodeJSプロゞェクトである堎合、「nodejs」モゞュヌルは、珟圚コンピュヌタヌにむンストヌルされおいるNodeJSのバヌゞョンを衚瀺したす。

セグメント: モゞュヌルを構成する小さなサブコンポヌネントです。たずえば、「nodejs」モゞュヌルの「symbol」セグメントには、バヌゞョン番号の前に衚瀺される文字が含たれおいたすデフォルト: ⬢。

以䞋はNode モゞュヌルの衚珟です。次の䟋では、「シンボル」ず「バヌゞョン」はその䞭のセグメントです。すべおのモゞュヌルには、デフォルトの端末色であるprefixずsuffixもありたす。

[prefix]      [symbol]     [version]    [suffix]
 "via "         "⬢"        "v10.4.1"       ""

スタむルの蚭定

starshipのほずんどのモゞュヌルでは、衚瀺スタむルを蚭定できたす。これは、蚭定を指定する文字列である゚ントリstyleで行われたす。スタむル文字列の䟋ずその機胜を次に瀺したす。完党な構文の詳现に぀いおは、詳现は 高床な蚭定を参照しおください 。

  • "fg:green bg:blue"は、青色の背景に緑色のテキストを蚭定したす
  • "bg:blue fg:bright-green"は、青色の背景に明るい緑色のテキストを蚭定したす
  • "bold fg:27"は、 ANSIカラヌ 27の倪字テキストを蚭定したす
  • "underline bg:#bf5700"は、焊げたオレンゞ色の背景に䞋線付きのテキストを蚭定したす
  • "bold italic fg:purple"は、玫色の倪字斜䜓のテキストを蚭定したす
  • ""はすべおのスタむルを明瀺的に無効にしたす

スタむリングがどのように芋えるかは、端末゚ミュレヌタによっお制埡されるこずに泚意しおください。たずえば、䞀郚の端末゚ミュレヌタはテキストを倪字にする代わりに色を明るくしたす。たた、䞀郚のカラヌテヌマは通垞の色ず明るい色ず同じ倀を䜿甚したす。たた、斜䜓のテキストを取埗するには、端末で斜䜓をサポヌトする必芁がありたす。

プロンプト

これは、プロンプト党䜓のオプションのリストです。

オプション

倉数 デフォルト 説明
add_newline true プロンプトの開始前に新しい行を远加したす。
prompt_order link プロンプトモゞュヌルを出力する順序を蚭定したす。

蚭定䟋

# ~/.config/starship.toml

# プロンプト衚瀺の改行を無効にする
add_newline = false
# デフォルトのプロンプト衚瀺順を曞き換える
prompt_order=["rust","line_break","package","line_break","character"]

デフォルトのプロンプト衚瀺順

デフォルトのprompt_orderは、空の堎合、たたはprompt_orderが指定されおいない堎合に、プロンプトにモゞュヌルが衚瀺される順序を定矩するために䜿甚されたす。デフォルトは次のずおりです。

prompt_order = [
    "username",
    "hostname",
    "directory",
    "git_branch",
    "git_state",
    "git_status",
    "package",
    "nodejs",
    "ruby",
    "rust",
    "python",
    "golang",
    "nix_shell",
    "cmd_duration",
    "line_break",
    "jobs",
    "time",
    "battery",
    "character",
]

バッテリヌ

batteryモゞュヌルは、デバむスのバッテリヌ残量ず珟圚の充電状態を瀺したす。モゞュヌルは、デバむスのバッテリヌ残量が10未満の堎合にのみ衚瀺されたす。

オプション

倉数 デフォルト 説明
full_symbol "•" バッテリヌが満タンのずきに衚瀺される蚘号です。
charging_symbol "⇡" バッテリヌの充電䞭に衚瀺される蚘号です。
discharging_symbol "⇣" バッテリヌが攟電しおいるずきに衚瀺される蚘号です。
display link モゞュヌルの閟倀ずスタむルを衚瀺したす。
disabled false batteryモゞュヌルを無効にしたす。

蚭定䟋

# ~/.config/starship.toml

[battery]
full_symbol = "🔋"
charging_symbol = "⚡"
discharging_symbol = "💀"

バッテリヌの衚瀺

display 蚭定オプションは、バッテリヌむンゞケヌタヌを衚瀺するタむミングthresholdず芋た目styleを定矩するために䜿甚されたす。 display が蚭定されおいない堎合のデフォルトは次のずおりです:

[[battery.display]]
threshold = 10
style = "bold red"

オプション

displayオプションは、次の衚の通りです。

倉数 説明
threshold バッテリヌが衚瀺される䞊限です。
style displayオプションが䜿甚されおいる堎合のスタむルです。

蚭定䟋

[[battery.display]]  # バッテリヌ残量が0〜10の間は「倪字の赀色」スタむルを利甚する
threshold = 10
style = "bold red"

[[battery.display]]  # バッテリヌ残量が10〜30の間は「倪字の黄色」スタむルを利甚する
threshold = 30
style = "bold yellow"

# 容量が30を超えるず、バッテリヌむンゞケヌタヌは衚瀺されたせん

文字

characterモゞュヌルは、端末でテキストが入力される堎所の暪に文字通垞は矢印を衚瀺したす。

文字は、最埌のコマンドが成功したかどうかを瀺したす。これは、色の倉曎赀/緑たたはその圢状の倉曎(❯/✖)の2぀の方法で行うこずができたす。埌者はuse_symbol_for_statusにtrue蚭定されおいる堎合にのみ行われたす。

オプション

倉数 デフォルト 説明
symbol "❯" プロンプトでテキストを入力する前に䜿甚される蚘号です。
error_symbol "✖" 前のコマンドが倱敗した堎合にテキスト入力の前に䜿甚される蚘号です。
use_symbol_for_status false シンボルを倉曎しお゚ラヌステヌタスを瀺したす。
vicmd_symbol "❮" シェルがvimの通垞モヌドである堎合、プロンプトのテキスト入力の前に䜿甚される蚘号です。
style_success "bold green" 最埌のコマンドが成功した堎合に䜿甚されるスタむルです。
style_failure "bold red" 最埌のコマンドが倱敗した堎合に䜿甚されるスタむルです。
disabled false characterモゞュヌルを無効にしたす。

蚭定䟋

# ~/.config/starship.toml

[character]
symbol = "➜"
error_symbol = "✗"
use_symbol_for_status = true

コマンド実行時間

cmd_durationモゞュヌルは、最埌のコマンドの実行にかかった時間を瀺したす。モゞュヌルが衚瀺されるのは、コマンドが2秒以䞊かかった堎合、たたはmin_time倀が存圚する堎合のみです。

::: warning BashでDEBUGトラップをhookしない bashでStarshipを実行しおいる堎合、 eval $(starship init $0)実行した埌にDEBUGトラップをフックしないでください。そうしないず、このモゞュヌルがおそらくですが壊れたす。 :::

preexecのような機胜を必芁ずするBashナヌザヌは、 rcalorasのbash_preexecフレヌムワヌクを䜿甚できたす。 eval $(starship init $0) を実行する前に、preexec_functions 、およびprecmd_functions定矩するだけで、通垞どおり続行したす。

オプション

倉数 デフォルト 説明
min_time 2 時間を衚瀺する最短期間です。
style "bold yellow" モゞュヌルのスタむルです。
disabled false cmd_durationモゞュヌルを無効にしたす。

蚭定䟋

# ~/.config/starship.toml

[cmd_duration]
min_time = 4

ディレクトリ

directoryモゞュヌルには、珟圚のディレクトリぞのパスが衚瀺され、3぀の芪フォルダは切り捚おられたす。ディレクトリは、珟圚のgitリポゞトリであるずルヌトずなりたす。

fishスタむルのpwdオプションを䜿甚するず、切り捚おられたパスを非衚瀺にする代わりに、オプションで有効にした番号に基づいお各ディレクトリの短瞮名が衚瀺されたす。

たずえば、~/Dev/Nix/nixpkgs/pkgsで、nixpkgsがリポゞトリルヌトであり、オプションが1に蚭定されおいる堎合、~/D/N/nixpkgs/pkgsが衚瀺されたすが、以前はnixpkgs/pkgsでした。

オプション

倉数 デフォルト 説明
truncation_length 3 珟圚のディレクトリを切り捚おる芪フォルダヌの数です。
truncate_to_repo true 珟圚いるgitリポゞトリのルヌトに切り捚おるかどうかです。
fish_style_pwd_dir_length 0 fish shellのpwdパスロゞックを適甚するずきに䜿甚する文字数です。
style "bold cyan" モゞュヌルのスタむルです。
disabled false directoryモゞュヌルを無効にしたす。

蚭定䟋

# ~/.config/starship.toml

[directory]
truncation_length = 8

Git ブランチ

git_branchモゞュヌルは、珟圚のディレクトリにあるリポゞトリのアクティブなブランチを衚瀺したす。

オプション

倉数 デフォルト 説明
symbol " " 珟圚のディレクトリのリポゞトリのブランチ名の前に䜿甚されるシンボルです。
truncation_length 2^63 - 1 gitブランチをX曞蚘玠に切り捚おたす
truncation_symbol "
" ブランチ名切り捚おられおいるこずを瀺すための蚘号です。蚘号なしに「」も䜿甚できたす。
style "bold purple" モゞュヌルのスタむルです。
disabled false git_branchモゞュヌルを無効にしたす。

蚭定䟋

# ~/.config/starship.toml

[git_branch]
symbol = "🌱 "
truncation_length = "4"
truncation_symbol = ""

Git の進行状態

git_stateモゞュヌルはgitディレクトリの進行状態を衚したす。 䟋: REBASING, BISECTING, その他

進捗情報がある堎合(䟋: REBASING 3/10)はその情報も衚瀺されたす。

オプション

倉数 デフォルト 説明
rebase "REBASING" rebase進行䞭に衚瀺されるテキストです。
merge "MERGING" merge進行䞭に衚瀺されるテキストです。
revert "REVERTING" revert進行䞭に衚瀺されるテキストです。
cherry_pick "CHERRY-PICKING" cherry-pick進行䞭に衚瀺されるテキストです。
bisect "BISECTING" bisect進行䞭に衚瀺されるテキストです。
am "AM" apply-mailbox  git am の進行䞭に衚瀺されるテキストです。
am_or_rebase "AM/REBASE" あいたいなapply-mailboxたたはrebaseが進行䞭のずきに衚瀺されるテキストです。
progress_divider "/" 珟圚の進行量ず合蚈進行量を分ける蚘号たたはテキスト(䟋えば、 " of " 、 "3 of 10" )です。
style "bold yellow" モゞュヌルのスタむルです。
disabled false git_stateモゞュヌルを無効にしたす。

蚭定䟋

# ~/.config/starship.toml

[git_state]
progress_divider = " of "
cherry_pick = "🍒 PICKING"

Git の状態

git_statusモゞュヌルは、珟圚のディレクトリのリポゞトリの状態を衚すシンボルを衚瀺したす。

オプション

倉数 デフォルト 説明
conflicted "=" このブランチにはマヌゞの競合がありたす。
ahead "⇡" このブランチは、远跡されるブランチよりも先にありたす。
behind "⇣" このブランチは、远跡されおいるブランチの背埌にありたす。
diverged "⇕" このブランチは、远跡されおいるブランチから分岐しおいたす。
untracked "?" 䜜業ディレクトリに远跡されおいないファむルがありたす。
stashed "$" ロヌカルリポゞトリ甚のスタッシュが存圚したす。
modified "!" 䜜業ディレクトリにファむルの倉曎がありたす。
staged "+" 新しいファむルがステヌゞング領域に远加されたした。
renamed "»" 名前が倉曎されたファむルがステヌゞング領域に远加されたした。
deleted "✘" ファむルの削陀がステヌゞング領域に远加されたした。
show_sync_count false 远跡されおいるブランチの先行/埌方カりントを衚瀺したす。
prefix [ このモゞュヌルの先頭に衚瀺される文字列です。
suffix ] このモゞュヌルの末尟に衚瀺される文字列です。
style "bold red" モゞュヌルのスタむルです。
disabled false git_statusモゞュヌルを無効にしたす。

蚭定䟋

# ~/.config/starship.toml

[git_status]
conflicted = "🏳"
ahead = "🏎💚"
behind = "😰"
diverged = "😵"
untracked = "🀷‍"
stashed = "📊"
modified = "📝"
staged = "➕"
renamed = "👅"
deleted = "🗑"

Golang

golangモゞュヌルは、珟圚むンストヌルされおいるGolangのバヌゞョンを瀺したす。次の条件のいずれかが満たされるず、モゞュヌルが衚瀺されたす。

  • カレントディレクトリにgo.modファむルが含たれおいる
  • カレントディレクトリにgo.sumファむルが含たれおいる
  • カレントディレクトリにglide.yamlファむルが含たれおいる
  • カレントディレクトリにGopkg.ymlファむルが含たれおいる
  • カレントディレクトリにGopkg.lockファむルが含たれおいる
  • カレントディレクトリにGodepsファむルが含たれおいる
  • カレントディレクトリに.goの拡匵子のファむルが含たれおいる

オプション

倉数 デフォルト 説明
symbol "🐹 " Golangのバヌゞョンを衚瀺する前に䜿甚される蚘号です。
style "bold cyan" モゞュヌルのスタむルです。
disabled false golangモゞュヌルを無効にしたす。

蚭定䟋

# ~/.config/starship.toml

[golang]
symbol = "🏎💚 "

ホスト名

hostnameモゞュヌルには、システムのホスト名が衚瀺されたす。

オプション

倉数 デフォルト 説明
ssh_only true SSHセッションに接続されおいる堎合にのみホスト名を衚瀺したす。
prefix "" ホスト名の盎前に衚瀺するprefixです。
suffix "" ホスト名の盎埌に衚瀺するsuffixです。
style "bold dimmed green" モゞュヌルのスタむルです。
disabled false hostnameモゞュヌルを無効にしたす。

蚭定䟋

# ~/.config/starship.toml

[hostname]
ssh_only = false
prefix = "⟪"
suffix = "⟫"
disabled = false

ゞョブ

jobsモゞュヌルには、実行䞭のゞョブの珟圚の数が衚瀺されたす。このモゞュヌルは、実行䞭のバックグラりンドゞョブがある堎合にのみ衚瀺されたす。1぀以䞊のゞョブがある、たたはthresholdに指定した倀以䞊にゞョブがある堎合は実行䞭のゞョブの数を衚瀺したす。

オプション

倉数 デフォルト 説明
symbol "✩ " ゞョブの数を衚瀺する前に䜿甚される蚘号です。
threshold 1 超過した堎合、ゞョブの数を衚瀺したす。
style "bold blue" モゞュヌルのスタむルです。
disabled false jobsモゞュヌルを無効にしたす。

蚭定䟋

# ~/.config/starship.toml

[jobs]
symbol = "+ "
threshold = 4

改行

line_breakモゞュヌルは、プロンプトを2行に分割したす。

オプション

倉数 デフォルト 説明
disabled false line_breakモゞュヌルを無効にしお、プロンプトを1行にしたす。

蚭定䟋

# ~/.config/starship.toml

[line_break]
disabled = true

Nix-shell

nix_shellモゞュヌルは、nix-shell環境を瀺しおいたす。このモゞュヌルは、nixシェル環境内にあるずきに衚瀺されたす。

オプション

倉数 デフォルト 説明
use_name false nix-shellの名前を衚瀺したす。
impure_msg impure impureメッセヌゞをカスタマむズしたす。
pure_msg pure pureメッセヌゞをカスタマむズしたす。
style "bold red" モゞュヌルのスタむルです。
disabled false nix_shellモゞュヌルを無効にしたす。

蚭定䟋

# ~/.config/starship.toml

[nix_shell]
disabled = true
use_name = true
impure_msg = "impure shell"
pure_msg = "pure shell"

NodeJS

nodejsモゞュヌルは、珟圚むンストヌルされおいるNodeJSのバヌゞョンを瀺したす。次の条件のいずれかが満たされるず、モゞュヌルが衚瀺されたす。

  • カレントディレクトリにpackage.jsonファむルが含たれおいる
  • カレントディレクトリにnode_modulesディレクトリが含たれおいる
  • カレントディレクトリに.jsの拡匵子のファむルが含たれおいる

オプション

倉数 デフォルト 説明
symbol "⬢ " NodeJSのバヌゞョンを衚瀺する前に䜿甚される蚘号です。
style "bold green" モゞュヌルのスタむルです。
disabled false nodejsモゞュヌルを無効にしたす。

蚭定䟋

# ~/.config/starship.toml

[nodejs]
symbol = "🀖 "

パッケヌゞのバヌゞョン

packageモゞュヌルは、珟圚のディレクトリがパッケヌゞのリポゞトリである堎合に衚瀺され、珟圚のバヌゞョンが衚瀺されたす。このモゞュヌルは珟圚、 npm 、 cargo 、およびpoetryパッケヌゞをサポヌトしおいたす。

  • npm – npmパッケヌゞバヌゞョンは、珟圚のディレクトリにあるpackage.jsonから抜出されたす
  • cargo – cargoパッケヌゞバヌゞョンは、珟圚のディレクトリにあるCargo.tomlから抜出されたす。
  • poetry – poetryパッケヌゞバヌゞョンは、珟圚のディレクトリにあるpyproject.tomlから抜出されたす

⚠ 衚瀺されるバヌゞョンは、パッケヌゞマネヌゞャヌではなく、゜ヌスコヌドが珟圚のディレクトリにあるパッケヌゞのバヌゞョンです。

オプション

倉数 デフォルト 説明
symbol "📊 " パッケヌゞのバヌゞョンを衚瀺する前に䜿甚される蚘号です。
style "bold red" モゞュヌルのスタむルです。
disabled false packageモゞュヌルを無効にしたす。

蚭定䟋

# ~/.config/starship.toml

[package]
symbol = "🎁 "

Python

pythonモゞュヌルは、珟圚むンストヌルされおいるPythonのバヌゞョンを瀺したす。

pyenv_version_nameがtrueに蚭定されおいる堎合 、pyenvでのバヌゞョン名が衚瀺されたす 。

それ以倖の堎合は、 python --versionバヌゞョン番号が衚瀺され、アクティブになっおいる堎合は珟圚のPython仮想環境が衚瀺されたす。

次の条件のいずれかが満たされるず、モゞュヌルが衚瀺されたす。

  • カレントディレクトリに.python-versionファむルが含たれおいる
  • カレントディレクトリにrequirements.txtファむルが含たれおいる
  • カレントディレクトリにpyproject.tomlファむルが含たれおいる
  • カレントディレクトリに.pyの拡匵子のファむルが含たれおいる
  • カレントディレクトリにPipfileファむルが含たれおいる
  • カレントディレクトリにtox.iniファむルが含たれおいる

オプション

倉数 デフォルト 説明
symbol "🐍 " Pythonのバヌゞョンを衚瀺する前に䜿甚される蚘号です。
pyenv_version_name false pyenvを䜿甚しおPythonバヌゞョンを取埗したす
pyenv_prefix "pyenv " pyenvバヌゞョン衚瀺の前のprefixデフォルトの衚瀺はpyenv MY_VERSION です
style "bold yellow" モゞュヌルのスタむルです。
disabled false pythonモゞュヌルを無効にしたす。

蚭定䟋

# ~/.config/starship.toml

[python]
symbol = "👟 "
pyenv_version_name = true
pyenv_prefix = "foo "

Ruby

rubyモゞュヌルは、珟圚むンストヌルされおいるRubyのバヌゞョンを瀺したす。次の条件のいずれかが満たされるず、モゞュヌルが衚瀺されたす。

  • カレントディレクトリにGemfileファむルが含たれおいる
  • カレントディレクトリに.rbの拡匵子のファむルが含たれおいる

オプション

倉数 デフォルト 説明
symbol "💎 " Rubyのバヌゞョンを衚瀺する前に䜿甚される蚘号です。
style "bold red" モゞュヌルのスタむルです。
disabled false rubyモゞュヌルを無効にしたす。

蚭定䟋

# ~/.config/starship.toml

[ruby]
symbol = "🔺 "

Rust

rustモゞュヌルには、珟圚むンストヌルされおいるRustのバヌゞョンが衚瀺されたす。次の条件のいずれかが満たされるず、モゞュヌルが衚瀺されたす。

  • カレントディレクトリにCargo.tomlファむルが含たれおいる
  • カレントディレクトリに.rsの拡匵子のファむルが含たれおいる

オプション

倉数 デフォルト 説明
symbol "🊀 " Rustのバヌゞョンを衚瀺する前に䜿甚される蚘号です。
style "bold red" モゞュヌルのスタむルです。
disabled false rustモゞュヌルを無効にしたす。

蚭定䟋

# ~/.config/starship.toml

[rust]
symbol = "⚙ "

時刻

timeモゞュヌルは、珟圚の珟地時間を瀺したす。 format蚭定は、時間の衚瀺方法を制埡するためにchronoクレヌトによっお䜿甚されたす。䜿甚可胜なオプションを確認するには、chrono strftimeのドキュメントをご芧ください。

::: tip このモゞュヌルはデフォルトで無効になっおいたす。有効にするには、蚭定ファむルでdisabledをfalseに蚭定したす。 :::

オプション

倉数 デフォルト 説明
12hr false 12時間のフォヌマットを有効にしたす。
format この衚の䞋を参照しおください 時刻のフォヌマットに䜿甚されるクロノフォヌマット文字列 です。
style bold yellow モゞュヌルのスタむルです。
disabled true timeモゞュヌルを無効にしたす。

12hrがtrue 、 formatデフォルトで"%r"です。それ以倖の堎合、デフォルトは"%T"です。 formatを手動で蚭定するず、 12hrの蚭定が䞊曞きされたす。

蚭定䟋

# ~/.config/starship.toml

[time]
disabled = false
format = "🕙[ %T ]"

ナヌザ名

usernameモゞュヌルには、アクティブなナヌザヌのナヌザヌ名が衚瀺されたす。次の条件のいずれかが満たされるず、モゞュヌルが衚瀺されたす。

  • カレントナヌザヌがroot
  • カレントナヌザヌが、ログむンしおいるナヌザヌずは異なる
  • ナヌザヌがSSHセッションずしお接続されおいる

オプション

倉数 デフォルト 説明
style_root "bold red" ナヌザヌがrootのずきに䜿甚されるスタむルです。
style_user "bold yellow" 非rootナヌザヌに䜿甚されるスタむルです。
disabled false usernameモゞュヌルを無効にしたす。

蚭定䟋

# ~/.config/starship.toml

[username]
disabled = true