JetBrains Translation 플러그인에 DeepL 한국어 API 기여한 이야기

DeepL이라는 번역 서비스가 있다. 우리에게는 구글 번역과 파파고가 익숙하지만, 번역 품질만 놓고 보면 DeepL이 최강자라고 생각한다.

그동안 DeepL은 한국어 번역은 지원하면서도 개발용 API에서는 한국어를 제공하지 않았다. 그러다 한국어 개발 API가 정식 오픈했고, 그 김에 젯브레인의 번역 플러그인으로 유명한 Translation에 기여를 하게 됐다.

별로 한 것도 없는데 기여자 목록에 이름이 표시되니 기분이 좋더라.

---

Translation 플러그인이란

JetBrains IDE(IntelliJ, PhpStorm, WebStorm 등)에서 쓰는 번역 플러그인이다. 코드 안에서 단어나 문장을 선택하고 단축키를 누르면 바로 번역이 뜬다.

• 변수명·함수명을 지을 때 적절한 영단어 찾기
• 영문 라이브러리 문서나 주석을 읽을 때
• 커밋 메시지나 PR 설명을 영어로 쓸 때
• TTS로 발음까지 들을 수 있다

브라우저로 창을 전환하지 않고 에디터 안에서 끝난다는 게 핵심이다. 사소해 보이지만 흐름이 안 끊긴다는 차이가 크다.

왜 DeepL인가

플러그인은 구글, 마이크로소프트, 유다오, 알리 등 여러 번역 엔진을 지원한다. 그중 DeepL을 굳이 쓰는 이유는 이렇다.

• 문맥을 살린다. 문장 단위로 자연스럽게 재구성하는 경향이 강하다. 기술 문서처럼 문장이 긴 텍스트에서 차이가 난다.
• 어투 선택이 가능하다. 격식체/비격식체를 지정할 수 있어서 문서 성격에 맞출 수 있다.
• 무료 API 플랜이 있다. 월 50만 자까지 무료다. 개인이 IDE에서 쓰는 정도면 충분히 여유롭다.

설정하는 법

1. DeepL API 키 발급

DeepL 개발자 사이트에서 API Free 플랜에 가입하면 인증 키를 받을 수 있다. 무료 플랜 키는 끝에 :fx 가 붙는데, 이게 붙어 있으면 무료 엔드포인트로 요청이 나간다.

2. 플러그인 설치

Settings > Plugins > Marketplace
→ "Translation" 검색 후 설치

3. 번역 엔진 설정

Settings > Tools > Translation
→ Translation Engine: DeepL
→ Auth Key 입력

4. 단축키

Ctrl/Cmd + Ctrl + U   # 선택 영역 번역 (기본값)
Ctrl/Cmd + Ctrl + I   # 번역 창 열기

기본 단축키가 다른 것과 충돌하는 경우가 있으니 Settings > Keymap에서 "Translate"로 검색해 원하는 조합으로 바꾸면 된다.

오픈소스 기여, 생각보다 문턱이 낮다

이번 기여를 계기로 느낀 건, 오픈소스 기여가 대단한 기능을 새로 만드는 것만은 아니라는 점이다.

실제로 기여로 인정되는 것들은 이렇게 다양하다.

• 언어·로케일 추가 — 이번 경우처럼 지원 언어 목록에 항목 하나 추가
• 문서 수정 — README 오타, 설치 안내 보완, 번역
• 버그 리포트 — 재현 방법을 정확히 적은 이슈 하나가 큰 도움이 된다
• 테스트 추가 — 커버되지 않은 케이스
• 의존성 업데이트 — 라이브러리 버전 올리고 동작 확인

시작하기 좋은 지점은 자기가 실제로 쓰는 도구다. 쓰다가 불편한 걸 발견했을 때가 기여할 타이밍이다. 코드베이스에 대한 맥락이 이미 있으니 진입 장벽이 훨씬 낮다.

첫 기여 순서

• 이슈 트래커에서 good first issue, help wanted 라벨을 찾는다
• 작업 전에 이슈에 코멘트를 남긴다. 중복 작업을 막을 수 있다
• CONTRIBUTING.md를 먼저 읽는다. 커밋 컨벤션과 PR 규칙이 적혀 있다
• PR은 작게. 하나의 PR은 하나의 목적만
• 리뷰 코멘트에 방어적으로 반응하지 않는다

기여자 목록에 이름이 올라가는 건 생각보다 기분 좋은 일이다. 그리고 그 기록은 남는다. 이력서에 링크 하나 붙일 수 있다는 실질적인 이점도 있다.

정리

• DeepL 한국어 개발 API가 정식 오픈했고, JetBrains Translation 플러그인에 반영에 기여했다
• 번역 품질과 무료 플랜(월 50만 자) 덕에 IDE 안에서 쓰기 좋다
• 설정은 API 키 발급 → 플러그인 설치 → 엔진 선택, 세 단계
• 오픈소스 기여는 대단한 기능 추가만이 아니다. 내가 쓰는 도구의 불편함에서 시작하면 된다