---
title: Lingo.dev + .csv (데이터)
---

**Lingo.dev CLI**는 특정 구조를 가진 CSV 파일을 번역합니다. 이 도구는 제공된 CSV 파일에 각 대상 로케일의 번역 열을 추가하여 업데이트합니다. CLI는 정확한 CSV 형식과 구분 기호를 유지하고, UTF-8 및 다양한 문자 인코딩을 안전하게 처리하며, Excel, Google Sheets 및 데이터베이스 가져오기와 원활하게 작동합니다.

## CSV 번역 작동 방식

CSV 파일은 다음 구조를 가져야 합니다:

- `KEY`라는 이름의 첫 번째 열
- 소스 로케일 열(예: `en`)

CLI는 제공된 CSV 파일을 확장하여 각 대상 로케일(예: `es`, `fr`)에 대한 열을 포함시킵니다. 원본 콘텐츠는 보존되면서 각 대상 로케일에 대한 번역이 채워집니다.

### 예시: 소스 및 출력

**입력 파일(영어 소스):**

```csv
KEY,en
dashboard.title,Dashboard
greeting.message,Hello world!
button.label,Submit
```

**출력 파일(스페인어 및 프랑스어로 번역 후):**

```csv
KEY,en,es,fr
dashboard.title,Dashboard,Panel de control,Tableau de bord
greeting.message,Hello world!,¡Hola mundo!,Bonjour le monde!
button.label,Submit,Enviar,Soumettre
```

- `KEY` 열은 보존됩니다.
- 소스 로케일 열(`en`)은 변경되지 않습니다.
- 각 대상 로케일(`es`, `fr`)에 대한 새 열이 추가되고 번역이 채워집니다.

## 빠른 설정

CSV 번역을 구성하려면 `i18n.json`에 CSV 파일용 버킷을 추가하세요:

```json
{
  "locale": {
    "source": "en",
    "targets": ["es", "fr"]
  },
  "buckets": {
    "csv": {
      "include": ["i18n/data.csv"]
    }
  }
}
```

## CSV 데이터 번역

```bash
npx lingo.dev@latest i18n
```

CLI는 대상 열의 텍스트 콘텐츠를 번역하는 동안 CSV 구조, 헤더 및 데이터 유형을 보존합니다.

## 고급 기능

### 사용자 정의 구분 기호 지원

다양한 CSV 방언과 함께 작동합니다:

- **쉼표로 구분**: `value1,value2,value3`
- **세미콜론으로 구분**: `value1;value2;value3`
- **탭으로 구분**: `value1\tvalue2\tvalue3`

## 고급 구성

### 다중 CSV 파일

```json
"csv": {
  "include": [
    "i18n/data.csv",
    "content/static/*.csv"
  ]
}
```
