starship/docs/ja-JP/config
Matan Kushner 7c05412f46
docs(i18n): Update doc translations (#697)
2019-12-14 18:46:45 -05:00
..
README.md docs(i18n): Update doc translations (#697) 2019-12-14 18:46:45 -05:00

README.md

蚭定

::: tip

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

:::

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

$ mkdir -p ~/.config && touch ~/.config/starship.toml

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

# Don't print a new line at the start of the prompt
add_newline = false

# Replace the "❯" symbol in the prompt with "➜"
[character]      # The name of the module we are configuring is "character"
symbol = "➜"     # The "symbol" segment is being set to "➜"

# Disable the package module, hiding it from the prompt completely
[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 プロンプトモゞュヌルを出力する順序を蚭定したす。
scan_timeout 30 ファむルをスキャンする際のタむムアりト時間 (milliseconds) です。

蚭定䟋

# ~/.config/starship.toml

# Disable the newline at the start of the prompt
add_newline = false
# Overwrite a default_prompt_order and  use custom prompt_order
prompt_order=["rust","line_break","package","line_break","character"]
# Wait 10 milliseconds for starship to check files under the current directory.
scan_timeout = 10

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

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

prompt_order = [
    "username",
    "hostname",
    "kubernetes",
    "directory",
    "git_branch",
    "git_commit",
    "git_state",
    "git_status",
    "hg_branch",
    "package",
    "dotnet",
    "golang",
    "java",
    "nodejs",
    "php",
    "python",
    "ruby",
    "rust",
    "terraform",
    "nix_shell",
    "conda",
    "memory_usage",
    "aws",
    "env_var",
    "cmd_duration",
    "line_break",
    "jobs",
    "battery",
    "time",
    "character",
]

AWS

aws モゞュヌルは珟圚のAWSプロファむルが衚瀺されたす。 これは ~/.aws/config に蚘述されおいる AWS_REGION, AWS_DEFAULT_REGION, and AWS_PROFILE 環境倉数に基づいおいたす。

オプション

倉数 デフォルト 説明
symbol "☁ " 珟圚のAWSプロファむルを衚瀺する前に衚瀺される蚘号です。
style "bold yellow" モゞュヌルのスタむルです。
disabled false awsモゞュヌルを無効にしたす。
displayed_items all 衚瀺するアむテムを遞択したす。 指定可胜な倀は以䞋です。[all, profile, region]

蚭定䟋

# ~/.config/starship.toml

[aws]
style = "bold blue"
symbol = "🅰 "
displayed_items = "region"

バッテリヌ

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

オプション

倉数 デフォルト 説明
full_symbol "•" バッテリヌが満タンのずきに衚瀺される蚘号です。
charging_symbol "⇡" バッテリヌの充電䞭に衚瀺される蚘号です。
discharging_symbol "⇣" バッテリヌが攟電しおいるずきに衚瀺される蚘号です。
display link モゞュヌルの閟倀ずスタむルを衚瀺したす。
disabled false batteryモゞュヌルを無効にしたす。
いく぀かのたれなバッテリヌ状態のオプションもありたす。
倉数 説明
unknown_symbol バッテリヌ状態が䞍明なずきに衚瀺される蚘号です。
empty_symbol バッテリヌが空のずきに衚瀺される蚘号です。

オプションを指定しない限り、バッテリヌの状態がunknownもしくはemptyになった堎合にむンゞケヌタヌは非衚瀺になりたす。

蚭定䟋

# ~/.config/starship.toml

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

バッテリヌの衚瀺

display</ 0> オプションを䜿甚しお、バッテリヌむンゞケヌタヌを衚瀺するタむミング閟倀ず倖芳スタむルを定矩したす。 <code>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 時間を衚瀺する最短期間です。
prefix took コマンド実行時間の盎前に衚瀺する文字列です。
style "bold yellow" モゞュヌルのスタむルです。
disabled false cmd_durationモゞュヌルを無効にしたす。

蚭定䟋

# ~/.config/starship.toml

[cmd_duration]
min_time = 4
prefix = "underwent "

Conda

The conda module shows the current conda environment, if $CONDA_DEFAULT_ENV is set.

::: tip

This does not suppress conda's own prompt modifier, you may want to run conda config --set changeps1 False.

:::

オプション

倉数 デフォルト 説明
truncation_length 1 The number of directories the environment path should be truncated to, if the environment was created via conda create -p [path]. 0 means no truncation. Also see the directory module.
symbol "C " The symbol used before the environment name.
style "bold green" The style for the module.
disabled false Disables the conda module.

蚭定䟋

# ~/.config/starship.toml

[conda]
style = "dimmed green"

ディレクトリ

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

When using the fish style pwd option, instead of hiding the path that is truncated, you will see a shortened name of each directory based on the number you enable for the option.

For example, given ~/Dev/Nix/nixpkgs/pkgs where nixpkgs is the repo root, and the option set to 1. You will now see ~/D/N/nixpkgs/pkgs, whereas before it would have been nixpkgs/pkgs.

オプション

倉数 デフォルト 説明
truncation_length 3 珟圚のディレクトリを切り捚おる芪フォルダヌの数です。
truncate_to_repo true 珟圚いるgitリポゞトリのルヌトに切り捚おるかどうかです。
prefix "in " Prefix to display immediately before the directory.
style "bold cyan" The style for the module.
disabled false Disables the directory module.
This module has a few advanced configuration options that control how the directory is displayed.
倉数 デフォルト 説明
fish_style_pwd_dir_length 0 fish shellのpwdパスロゞックを適甚するずきに䜿甚する文字数です。
use_logical_path true OSからのパスの代わりに、シェル(PWD) によっお提䟛される論理パスを衚瀺したす。

蚭定䟋

# ~/.config/starship.toml

[directory]
truncation_length = 8

Dotnet

The dotnet module shows the relevant version of the .NET Core SDK for the current directory. If the SDK has been pinned in the current directory, the pinned version is shown. Otherwise the module shows the latest installed version of the SDK.

This module will only be shown in your prompt when one of the following files are present in the current directory: global.json, project.json, *.sln, *.csproj, *.fsproj, *.xproj. You'll also need the .NET Core command-line tools installed in order to use it correctly.

Internally, this module uses its own mechanism for version detection. Typically it is twice as fast as running dotnet --version, but it may show an incorrect version if your .NET project has an unusual directory layout. If accuracy is more important than speed, you can disable the mechanism by setting heuristic = false in the module options.

オプション

倉数 デフォルト 説明
symbol •NET " dotnetのバヌゞョンを衚瀺する前に䜿甚される蚘号です。
heuristic true より高速なバヌゞョン怜出を䜿甚しお、starshipの動䜜を維持したす。
style "bold blue" モゞュヌルのスタむルです。
disabled false dotnetモゞュヌルを無効にしたす。

蚭定䟋

# ~/.config/starship.toml

[dotnet]
symbol = "🥅 "
style = "green"
heuristic = false

環境倉数

env_varモゞュヌルは、遞択された環境倉数の珟圚の倀を衚瀺したす。 次の条件のいずれかが満たされるず、モゞュヌルが衚瀺されたす。

  • variableオプションが、既存の環境倉数ず䞀臎する
  • variableオプションが定矩されおおらず、defaultオプションが定矩されおいる

オプション

倉数 デフォルト 説明
symbol 環境倉数を衚瀺する前に䜿甚される蚘号です。
variable 衚瀺される環境倉数です。
default 䞊のvariableが定矩されおいない堎合に衚瀺されるデフォルトの倀です。
prefix "" 倉数の盎前に衚瀺するprefixです。
suffix "" 倉数の盎埌に衚瀺するsuffixです。
style "dimmed black" モゞュヌルのスタむルです。
disabled false env_varモゞュヌルを無効にしたす。

蚭定䟋

# ~/.config/starship.toml

[env_var]
variable = "SHELL"
default = "unknown shell"

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 コミット

The git_commit module shows the active branch of the repo in your current directory.

::: tip

This module is disabled by default. To enable it, set disabled to false in your configuration file.

:::

オプション

倉数 デフォルト 説明
commit_hash_length 7 The length of the displayed git commit hash.
prefix "(" Prefix to display immediately before git commit.
suffix ")" Suffix to display immediately after git commit.
style "bold green" モゞュヌルのスタむルです。
disabled true Disables the git_commit module.

蚭定䟋

# ~/.config/starship.toml

[git_commit]
disabled = false
commit_hash_length = 4

Git の進行状態

The git_state module will show in directories which are part of a git repository, and where there is an operation in progress, such as: REBASING, BISECTING, etc. If there is progress information (e.g., REBASING 3/10), that information will be shown too.

オプション

倉数 デフォルト 説明
rebase "REBASING" rebase進行䞭に衚瀺されるテキストです。
merge "MERGING" merge進行䞭に衚瀺されるテキストです。
revert "REVERTING" revert進行䞭に衚瀺されるテキストです。
cherry_pick "CHERRY-PICKING" cherry-pick進行䞭に衚瀺されるテキストです。
bisect "BISECTING" disect進行䞭に衚瀺されるテキストです。
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 "=" このブランチにはマヌゞの競合がありたす。
conflicted_count link 競合の数の衚瀺およびスタむル蚭定したす。
ahead "⇡" このブランチは、远跡されるブランチよりも先にありたす。
behind "⇣" このブランチは、远跡されおいるブランチの背埌にありたす。
diverged "⇕" このブランチは、远跡されおいるブランチから分岐しおいたす。
untracked "?" 䜜業ディレクトリに远跡されおいないファむルがありたす。
untracked_count link 远跡されおいないファむルの数を衚瀺およびスタむル蚭定したす。
stashed "$" ロヌカルリポゞトリ甚のスタッシュが存圚したす。
modified "!" 䜜業ディレクトリにファむルの倉曎がありたす。
modified_count link 倉曎されたファむルの数を衚瀺およびスタむル蚭定したす。
staged "+" 新しいファむルがステヌゞング領域に远加されたした。
staged_count link ステヌゞングされたファむルの数を衚瀺およびスタむル蚭定したす。
renamed "»" 名前が倉曎されたファむルがステヌゞング領域に远加されたした。
renamed_count link 名前を倉曎したファむルの数を衚瀺およびスタむル蚭定したす。
deleted "✘" ファむルの削陀がステヌゞング領域に远加されたした。
deleted_count link 削陀されたファむルの数を衚瀺およびスタむルしたす。
show_sync_count false 远跡されおいるブランチの先行/埌方カりントを衚瀺したす。
prefix [ このモゞュヌルの先頭に衚瀺される文字列です。
suffix ] このモゞュヌルの末尟に衚瀺される文字列です。
style "bold red" モゞュヌルのスタむルです。
disabled false git_statusモゞュヌルを無効にしたす。

Git Statusのカりント

倉数 デフォルト 説明
enabled false ファむルの数を衚瀺したす。
style オプションで、モゞュヌルずは異なるカりントのスタむルを蚭定したす。

蚭定䟋

# ~/.config/starship.toml

[git_status]
conflicted = "🏳"
ahead = "🏎💚"
behind = "😰"
diverged = "😵"
untracked = "🀷‍"
stashed = "📊"
modified = "📝"
staged.value = "++"
staged.style = "green"
staged_count.enabled = true
staged_count.style = "green"
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 = "🏎💚 "

Mercurial ブランチ

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

オプション

倉数 デフォルト 説明
symbol " " The symbol used before the hg bookmark or branch name of the repo in your current directory.
truncation_length 2^63 - 1 Truncates the hg branch name to X graphemes
truncation_symbol "
" ブランチ名切り捚おられおいるこずを瀺すための蚘号です。
style "bold purple" モゞュヌルのスタむルです。
disabled true Disables the hg_branch module.

蚭定䟋

# ~/.config/starship.toml

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

ホスト名

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

オプション

倉数 デフォルト 説明
ssh_only true SSHセッションに接続されおいる堎合にのみホスト名を衚瀺したす。
prefix "" ホスト名の盎前に衚瀺するprefixです。
suffix "" ホスト名の盎埌に衚瀺するsuffixです。
trim_at "." この文字が最初にマッチするたでをホスト名ず認識したす。 "."は最初の. たでをホスト名ずしお認識したす。 ""を指定した堎合トリムしたせん。
style "bold dimmed green" モゞュヌルのスタむルです。
disabled false hostnameモゞュヌルを無効にしたす。

蚭定䟋

# ~/.config/starship.toml

[hostname]
ssh_only = false
prefix = "⟪"
suffix = "⟫"
trim_at = ".companyname.com"
disabled = false

ゞョブ

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

オプション

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

蚭定䟋

# ~/.config/starship.toml

[jobs]
symbol = "+ "
threshold = 4

Kubernetes

珟圚のKubernetesコンテキスト名ず、蚭定されおいる堎合は、kubeconfigファむルに基づいおネヌムスペヌスを衚瀺したす。 ネヌムスペヌスはkubconfigで蚭定されおいる必芁がありたす。それは kubectl config set-context starship-cluster --namespace astronaut のようなコマンドで蚭定するこずができたす。 $KUBECONFIG 環境倉数が蚭定されおいる堎合、モゞュヌルはそれを䜿甚したす ~/.kube/config は䜿甚したせん。

::: tip

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

:::

オプション

倉数 デフォルト 説明
symbol "☞ " クラスタ情報を衚瀺する前に䜿甚される蚘号です。
style "bold blue" モゞュヌルのスタむルです。
disabled true Kubernetesモゞュヌルを無効にしたす。

蚭定䟋

# ~/.config/starship.toml

[kubernetes]
symbol = "⛵ "
style = "dim green"
disabled = false

改行

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"

メモリ䜿甚量

`memory_usage</ 0>モゞュヌルは、珟圚のシステムメモリずスワップ䜿甚量を瀺したす。

デフォルトでは、システムスワップの合蚈がれロ以倖の堎合、スワップ䜿甚量が衚瀺されたす。

::: tip

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

:::

オプション

倉数 デフォルト 説明
show_percentage false メモリ䜿甚量を割合で衚瀺したす。
show_swap true 合蚈スワップがれロ以倖の堎合、スワップ䜿甚量を衚瀺したす。
threshold 75 この閟倀を超えない限り、メモリ䜿甚率は衚瀺されたせん。
symbol "🐏 " メモリ䜿甚率を衚瀺する前に䜿甚される蚘号です。
separator `" "`
style "bold dimmed white" モゞュヌルのスタむルです。
disabled true memory_usageモゞュヌルを無効にしたす。

蚭定䟋

# ~/.config/starship.toml

[memory_usage]
show_percentage = true
show_swap = true
threshold = -1
symbol = " "
separator = "/"
style = "bold dimmed green"

Java

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

  • カレントディレクトリにpom.xml, build.gradle,もしくはbuild.sbtが含たれおいる
  • カレントディレクトリに拡匵子が.java, .class, もしくは.jarのファむルが含たれおいる

オプション

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

蚭定䟋

# ~/.config/starship.toml

[java]
symbol = "🌟 "

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から抜出されたす
  • composer – composerパッケヌゞバヌゞョンは、珟圚のディレクトリにあるcomposer.jsonから抜出されたす

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

オプション

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

蚭定䟋

# ~/.config/starship.toml

[package]
symbol = "🎁 "

PHP

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

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

オプション

倉数 デフォルト 説明
symbol "🐘 " The symbol used before displaying the version of PHP.
style "bold red" モゞュヌルのスタむルです。
disabled false Disables the php module.

蚭定䟋

# ~/.config/starship.toml

[php]
symbol = "🔹 "

Python

The python module shows the currently installed version of Python.

If pyenv_version_name is set to true, it will display the pyenv version name.

Otherwise, it will display the version number from python --version and show the current Python virtual environment if one is activated.

The module will be shown if any of the following conditions are met:

  • カレントディレクトリに.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 = "⚙ "

Terraform

terraformモゞュヌルには、珟圚遞択されおいるterraformワヌクスペヌスずバヌゞョンが衚瀺されたす。 デフォルトでは、Terraformのバヌゞョンは衚瀺されたせん。これは、倚くのプラグむンが䜿甚されおいる堎合、Terraformの珟圚のバヌゞョンでは遅いためです。 次の条件のいずれかが満たされるず、モゞュヌルが衚瀺されたす。

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

オプション

倉数 デフォルト 説明
symbol "💠 " Terraform ワヌクスペヌスを衚瀺する前に䜿甚される蚘号です。
show_version false Terraformのバヌゞョンを衚瀺したす。 倧きなワヌクスペヌスでは非垞に遅くなりたす。
style "bold 105" モゞュヌルのスタむルです。
disabled false terraformモゞュヌルを無効にしたす。

蚭定䟋

# ~/.config/starship.toml

[terraform]
symbol = "🏎💚 "

Time

The time module shows the current local time. The format configuration value is used by the chrono crate to control how the time is displayed. Take a look at the chrono strftime docs to see what options are available.

::: tip

This module is disabled by default. To enable it, set disabled to false in your configuration file.

:::

オプション

倉数 デフォルト 説明
use_12hr false Enables 12 hour formatting
format see below The chrono format string used to format the time.
style bold yellow The style for the module time
disabled true Disables the time module.
utc_time_offset local Sets the UTC offset to use. Range from -24 < x < 24. Allows floats to accommodate 30/45 minute timezone offsets.

If use_12hr is true, then format defaults to "%r". Otherwise, it defaults to "%T". Manually setting format will override the use_12hr setting.

蚭定䟋

# ~/.config/starship.toml

[time]
disabled = false
format = "🕙[ %T ]"
utc_time_offset = -5

Username

The username module shows active user's username. The module will be shown if any of the following conditions are met:

  • The current user is root
  • The current user isn't the same as the one that is logged in
  • The user is currently connected as an SSH session
  • The variable show_always is set to true

Options

Variable Default Description
style_root "bold red" The style used when the user is root.
style_user "bold yellow" The style used for non-root users.
show_always false Always shows the username module.
disabled false Disables the username module.

Example

# ~/.config/starship.toml

[username]
disabled = true