chore(docs): i18n sync (#15417)

2026-02-28 15:27:11 -06:00
parent 971bd30516
commit e1e18c7abd
174 changed files with 6358 additions and 4392 deletions
@@ -3,28 +3,27 @@ title: 테마
 description: 내장 테마를 선택하거나 자신만의 테마를 정의하세요.
 ---

-opencode를 사용하면 여러 내장 테마 중 하나에서 선택할 수 있으며 terminal 테마에 적응하는 테마를 사용하거나 사용자 정의 테마를 정의 할 수 있습니다.
+OpenCode를 사용하면 여러 내장 테마 중 하나에서 선택할 수 있으며 terminal 테마에 적응하는 테마를 사용하거나 사용자 정의 테마를 정의 할 수 있습니다.

-기본적으로 opencode는 자체 `opencode` 테마를 사용합니다.
+기본적으로 OpenCode는 자체 `opencode` 테마를 사용합니다.

 ---

 ## 터미널 요구 사항

-자신의 풀 컬러 팔레트로 올바르게 표시하려면 terminal을 지원해야합니다 ** truecolor** (24 비트 색상). 대부분의 현대 terminal은 기본적으로 이것을 지원합니다, 그러나 당신은 그것을 가능하게 할 필요가 있을지도 모릅니다:
+테마가 전체 색상 팔레트로 올바르게 표시되려면 터미널이 **truecolor** (24비트 색상)를 지원해야 합니다. 대부분의 최신 터미널은 기본적으로 이를 지원하지만, 활성화해야 할 수도 있습니다:

-**체크 지원**: `echo $COLORTERM` - 그것은 `truecolor` 또는 `24bit`를 출력해야 합니다
+- **지원 확인**: `echo $COLORTERM` 실행 - `truecolor` 또는 `24bit`가 출력되어야 합니다.
+- **truecolor 활성화**: 셸 프로필에서 환경 변수 `COLORTERM=truecolor`를 설정하십시오.
+- **터미널 호환성**: 터미널 에뮬레이터가 24비트 색상을 지원하는지 확인하십시오 (iTerm2, Alacritty, Kitty, Windows Terminal 및 최신 버전의 GNOME Terminal 등 대부분의 최신 터미널이 지원함).

- ** truecolor 사용 가능**: shell 프로파일에서 환경 변수 `COLORTERM=truecolor`를 설정
- **Terminal 호환성 **: terminal 에뮬레이터 지원 24 비트 색상 (iTerm2, Alacritty, Kitty, Windows Terminal 및 GNOME Terminal의 최신 버전)
-
-truecolor 지원 없이, 테마는 감소된 색깔 정확도로 나타날지도 모릅니다 또는 가장 가까운 256 색깔 대류로 뒤떨어질지도 모릅니다.
+truecolor 지원이 없으면 테마가 감소된 색상 정확도로 표시되거나 가장 가까운 256색 근사치로 대체될 수 있습니다.

 ---

 ## 내장 테마

-opencode는 여러 내장 테마와 함께 제공됩니다.
+OpenCode는 여러 내장 테마와 함께 제공됩니다.

 | 이름                   | 설명                                                                |
 | ---------------------- | ------------------------------------------------------------------- |
@@ -46,27 +45,27 @@ opencode는 여러 내장 테마와 함께 제공됩니다.

 ## 시스템 테마

-`system` 테마는 terminal의 색깔 계획에 자동적으로 적응시키기 위하여 디자인됩니다. 고정 색상을 사용하는 전통적인 테마와 달리, system 테마:
+`system` 테마는 터미널의 색상 스키마에 자동으로 적응하도록 설계되었습니다. 고정 색상을 사용하는 기존 테마와 달리, system 테마는:

- **그레이스케일**: terminal의 배경 색상을 기반으로 사용자 정의 회색 가늠자를 만들고 최적의 대조를 보장합니다.
- ** ANSI 색상 사용 ** : terminal의 색상 팔레트를 존중하는 구문 강조 및 UI 요소에 대한 표준 ANSI 색상 (0-15).
- ** terminal 기본 사항**: `none` 텍스트 및 배경 색상을 사용하여 terminal의 네이티브 외관을 유지합니다.
+- **그레이스케일 생성**: 터미널의 배경 색상을 기반으로 사용자 정의 그레이스케일을 생성하여 최적의 대비를 보장합니다.
+- **ANSI 색상 사용**: 구문 강조 및 UI 요소에 표준 ANSI 색상(0-15)을 활용하여 터미널의 색상 팔레트를 존중합니다.
+- **터미널 기본값 유지**: 텍스트 및 배경 색상에 `none`을 사용하여 터미널의 기본 모양을 유지합니다.

-시스템 테마는 사용자를위한 것입니다 :
+시스템 테마는 다음과 같은 사용자에게 적합합니다:

- opencode가 terminal의 외관과 일치해야 합니다.
- 사용자 정의 terminal 색상 구성
- 모든 terminal 응용 분야의 일관된 모습
+- OpenCode가 터미널의 모양과 일치하기를 원하는 경우
+- 사용자 정의 터미널 색상 스키마를 사용하는 경우
+- 모든 터미널 애플리케이션에서 일관된 모양을 선호하는 경우

 ---

 ## 테마 사용

-테마를 `/theme` 명령어로 선택하여 테마를 선택할 수 있습니다. 또는 [config](/docs/config)에서 지정할 수 있습니다.
+`/theme` 명령어로 테마 선택기를 불러와 테마를 선택할 수 있습니다. 또는 `tui.json`에서 지정할 수 있습니다.

-```json title="opencode.json" {3}
+```json title="tui.json" {3}
 {
-  "$schema": "https://opencode.ai/config.json",
+  "$schema": "https://opencode.ai/tui.json",
  "theme": "tokyonight"
 }
 ```
@@ -75,32 +74,35 @@ opencode는 여러 내장 테마와 함께 제공됩니다.

 ## 사용자 정의 테마

-opencode는 사용자가 쉽게 테마를 만들 수 있도록 유연한 JSON 기반 테마 시스템을 지원합니다.
+OpenCode는 사용자가 쉽게 테마를 만들고 사용자 정의할 수 있도록 유연한 JSON 기반 테마 시스템을 지원합니다.

 ---

-##### 계층 구조
+### 계층 구조

-테마는 다음과 같은 순서에서 여러 디렉토리에서로드됩니다. 나중에 감독은 이전 것을 무시합니다.
+테마는 다음 순서대로 여러 디렉토리에서 로드되며, 나중 디렉토리가 이전 디렉토리를 덮어씁니다:

-1.**Built-in themes** - 이것은 바이너리에 내장되어 있습니다. 2. **사용자 설정 디렉토리 ** - `~/.config/opencode/themes/*.json` 또는 `$XDG_CONFIG_HOME/opencode/themes/*.json`에서 정의 3. ** 루트 디렉토리 ** - `<project-root>/.opencode/themes/*.json`에서 정의 4. **현재 작업 디렉토리 ** - `./.opencode/themes/*.json`에서 정의
+1. **내장 테마 (Built-in themes)** - 바이너리에 내장되어 있습니다.
+2. **사용자 설정 디렉토리 (User config directory)** - `~/.config/opencode/themes/*.json` 또는 `$XDG_CONFIG_HOME/opencode/themes/*.json`에 정의됩니다.
+3. **프로젝트 루트 디렉토리 (Project root directory)** - `<project-root>/.opencode/themes/*.json`에 정의됩니다.
+4. **현재 작업 디렉토리 (Current working directory)** - `./.opencode/themes/*.json`에 정의됩니다.

-여러 디렉토리가 같은 이름을 가진 테마를 포함한다면, 더 높은 우선 순위를 가진 디렉토리의 테마가 사용됩니다.
+여러 디렉토리에 같은 이름의 테마가 있는 경우, 더 높은 우선 순위를 가진 디렉토리의 테마가 사용됩니다.

 ---

 ### 테마 만들기

-사용자 정의 테마를 만들려면 테마 디렉토리 중 하나에서 JSON 파일을 만듭니다.
+사용자 정의 테마를 만들려면 테마 디렉토리 중 하나에 JSON 파일을 만듭니다.

-사용자 넓은 테마:
+사용자 전역 테마:

 ```bash no-frame
 mkdir -p ~/.config/opencode/themes
 vim ~/.config/opencode/themes/my-theme.json
 ```

-프로젝트 별 테마.
+프로젝트별 테마:

 ```bash no-frame
 mkdir -p .opencode/themes
@@ -111,35 +113,34 @@ vim .opencode/themes/my-theme.json

 ### JSON 형식

-테마는 유연한 JSON 형식을 사용하여 지원:
+테마는 다음을 지원하는 유연한 JSON 형식을 사용합니다:

-**Hex 색상**: `"#ffffff"`
-
- ** ANSI 색상**: `3` (0-255)
- ** 색상 참조 ** : `"primary"` 또는 사용자 정의 정의
- ** 어두운 / 조명 변형 ** : `{"dark": "#000", "light": "#fff"}`
- ** 색상 없음 ** : `"none"` - terminal의 기본 색상 또는 투명 사용
+- **Hex 색상**: `"#ffffff"`
+- **ANSI 색상**: `3` (0-255)
+- **색상 참조**: `"primary"` 또는 사용자 정의 정의
+- **다크/라이트 변형**: `{"dark": "#000", "light": "#fff"}`
+- **색상 없음**: `"none"` - 터미널의 기본 색상 또는 투명 사용

 ---

 ### 색상 정의

-`defs` 단면도는 선택적이고 당신은 주제에서 참조될 수 있는 재사용할 수 있는 색깔을 정의할 수 있습니다.
+`defs` 섹션은 선택 사항이며 테마 내에서 참조할 수 있는 재사용 가능한 색상을 정의할 수 있습니다.

 ---

-## 터미널 기본값
+### 터미널 기본값

-특별한 가치 `"none"`는 terminal의 기본 색깔을 상속하기 위하여 어떤 색깔든지를 위해 사용될 수 있습니다. 이것은 특히 당신의 terminal의 색깔 계획과 이음새가 없는 혼합 테마 창조를 위해 유용합니다:
+`"none"`이라는 특별한 값은 모든 색상에 대해 터미널의 기본 색상을 상속하는 데 사용할 수 있습니다. 이는 특히 터미널의 색상 스키마와 매끄럽게 어우러지는 테마를 만들 때 유용합니다:

- `"text": "none"` - terminal의 기본 전경 색상 사용
- `"background": "none"` - terminal의 기본 배경 색상 사용
+- `"text": "none"` - 터미널의 기본 전경색 사용
+- `"background": "none"` - 터미널의 기본 배경색 사용

 ---

 ### 예제

-사용자 정의 테마의 예입니다 :
+사용자 정의 테마의 예입니다:

 ```json title="my-theme.json"
 {