starship/docs/ko-KR/migrating-to-0.45.0

v0.45.0으로 마이그레이션

Starship v0.45.0은 대규모 v1.0.0을 준비하기 위한 주요 변경 사항이 포함된 릴리스입니다. 더 높은 수준의 사용자 정의를 허용하기 위해 프롬프트에서 구성이 수행되는 방식에 대한 몇 가지 주요 변경 사항을 적용했습니다.

이 가이드는 주요 변경 사항을 안내하기 위한 것입니다.

prompt_order가 최상위 format으로 대체되었습니다.

v0.45.0 이전에는 prompt_order가 Starship에서 렌더링되어야 하는 순서대로 모듈 이름 배열을 허용했습니다.

Starship v0.45.0은 대신 format 값을 허용하여 모듈 자체 외부에서 프롬프트를 사용자 정의할 수 있습니다.

v0.45.0 이전 구성 예시

prompt_order = [
  "username",
  "hostname",
  "directory",
  "git_branch",
  "git_commit",
  "git_state",
  "git_status",
  "cmd_duration",
  "custom",
  "line_break",
  "jobs",
  "battery",
  "time",
  "character",
]

v0.45.0 구성 예시

format = """
  $username\
  $hostname\
  $directory\
  $git_branch\
  $git_commit\
  $git_state\
  $git_status\
  $cmd_duration\
  $custom\
  $line_break\
  $jobs\
  $battery\
  $time\
  $character\
  """

모듈 prefix 및 suffix가 format으로 대체되었습니다.

v0.45.0 이전에는 일부 모듈이 모듈이 렌더링되는 방식을 스타일링하기 위해 prefix 및/또는 suffix를 허용했습니다.

Starship v0.45.0은 대신 format 값을 허용하여 모듈이 렌더링되는 방식을 더욱 사용자 정의할 수 있습니다. 컨텍스트 기반 변수에 대한 접두사 및 접미사를 정의하는 대신, 이제 변수를 모듈의 출력을 나타내는 형식 문자열 내에서 대체할 수 있습니다.

v0.45.0 이전 구성 예시

[cmd_duration]
prefix = "took "

v0.45.0 구성 예시

[cmd_duration]
# $duration – 명령 지속 시간 (예: "15s")
# $style    – 모듈의 기본 스타일 (예: "bold yellow")
format = "took [$duration]($style) "

영향을 받는 모듈

문자

제거된 속성	대체
기호	success_symbol
use_symbol_for_status	error_symbol
style_success	success_symbol
style_failure	error_symbol

기본 구성 변경 사항

[character]
-- symbol = "❯"
-- error_symbol = "✖"
-- use_symbol_for_status = true
-- vicmd_symbol = "❮"
++ success_symbol = "[❯](bold green)"
++ error_symbol = "[❯](bold red)"
++ vicmd_symbol = "[❮](bold green)"

이전에는 use_symbol_for_status 속성이 마지막 명령이 0이 아닌 상태 코드를 반환했을 때 error_symbol을 표시하도록 프롬프트를 구성하는 데 사용되었습니다.

v0.45.0 릴리스에서는 이제 0이 아닌 상태 코드 후에 항상 error_symbol을 사용하여 use_symbol_for_status 및 error_symbol 속성을 통합합니다.

이전 use_symbol_for_status = true 구성을 사용하도록 프롬프트를 구성하려면 구성 파일에 다음을 추가하세요.

[character]
error_symbol = "[✖](bold red)"

참고: character 요소는 자동으로 뒤에 공백을 추가하므로 다른 format 문자열과 달리 위 예시에서는 특별히 추가하지 않습니다.

명령 지속 시간

제거된 속성	대체
prefix	format

기본 구성 변경 사항

[cmd_duration]
-- prefix = "took "
++ format = "took [$duration]($style) "

디렉토리

제거된 속성	대체
prefix	format

기본 구성 변경 사항

[directory]
-- prefix = "in "
++ format = "[$path]($style)[$read_only]($read_only_style) "

환경 변수

제거된 속성	대체
prefix	format
suffix	format

기본 구성 변경 사항

[env_var]
-- prefix = ""
-- suffix = ""
++ format = "with [$env_value]($style) "

Git 커밋

제거된 속성	대체
prefix	format
suffix	format

기본 구성 변경 사항

[git_commit]
-- prefix = "("
-- suffix = ")"
++ format = '[\]($hash\)]($style) '

Git 상태

제거된 속성	대체
prefix	format
suffix	format
show_sync_count	format

기본 구성 변경 사항

[git_status]
-- prefix = "["
-- suffix = "]"
-- show_sync_count = false
++ format = '([\\\[$all_status$ahead_behind\\\]]($style) )'

이전에는 show_sync_count 속성이 브랜치가 원격 브랜치보다 앞서거나 뒤처진 커밋 수를 표시하도록 프롬프트를 구성하는 데 사용되었습니다.

v0.45.0 릴리스에서는 이를 ahead, behind, diverged의 세 가지 개별 속성으로 대체했습니다.

이전 show_sync_count = true 구성을 사용하도록 프롬프트를 구성하려면 구성 파일에 다음을 설정하세요.

[git_status]
ahead = "⇡${count}"
diverged = "⇕⇡${ahead_count}⇣${behind_count}"
behind = "⇣${count}"

호스트 이름

제거된 속성	대체
prefix	format
suffix	format

기본 구성 변경 사항

[hostname]
-- prefix = ""
-- suffix = ""
++ format = "[$hostname]($style) in "

Singularity

제거된 속성	대체
label	format
prefix	format
suffix	format

기본 구성 변경 사항

[singularity]
-- prefix = ""
-- suffix = ""
++ format = '[$symbol\\\[$env\\\]]($style) '

시간

제거된 속성	대체
format	time_format

기본 구성 변경 사항

[time]
-- format = "🕙[ %T ]"
++ time_format = "%T"
++ format = "at 🕙[$time]($style) "

사용자 지정 명령

제거된 속성	대체
prefix	format
suffix	format

기본 구성 변경 사항

[custom.example]
-- prefix = ""
-- suffix = ""
++ format = "[$symbol$output]($style) "