Tolgee

Tolgee란

Tolgee(github.com/tolgee/tolgee-platform)는 스스로를 개발자가 즐겁게 쓰는 오픈소스 로컬라이제이션 플랫폼이자 Crowdin, Phrase, Lokalise의 오픈소스 대안이라고 설명합니다. API가 붙은 공유 스프레드시트와 다른 지점은 인컨텍스트 편집입니다. SDK를 설치해 두면 실행 중인 내 앱에서 ALT 또는 Option을 누른 채 요소를 클릭하는 것만으로 그 문자열을 고치는 창이 열리고, JSON이나 PO 파일을 열 필요가 없습니다. README에 따르면 프로덕션에서도 동작하며, API 키를 붙여 넣는 브라우저 확장을 쓰기 때문에 풀 리퀘스트를 열 수 없는 사람도 문장 하나를 고칠 수 있습니다. 여기서 한 번 더 클릭하면 해당 문구가 강조된 앱 스크린샷이 만들어집니다. 번역가가 원래는 짐작으로 채워야 하는 맥락입니다.

나머지는 번역 관리 시스템에 기대하는 기능들이고, 저장소는 어떤 부분이 있는지 구체적으로 적어 두었습니다. 이전에 쓴 번역을 유사도 백분율과 함께 제안하는 번역 메모리, DeepL·Google 번역·AWS Translate를 통한 기계 번역, 새 키가 생성되는 즉시 자동 번역, 그리고 번역별 코멘트와 이력, 누가 무엇을 바꾸거나 검수했는지 남기는 활동 로그입니다. MCP 서버도 있어서 AI 코딩 어시스턴트가 에디터 안에서 키를 검색하고, 번역을 만들고 갱신하고, 언어를 관리하고, 기계 번역을 실행할 수 있습니다. Docker로 자체 호스팅하거나 호스팅형 계정으로 씁니다.

두 번째 언어를 내보낼 때 무엇이 달라지는가

언어를 하나 추가하는 일은 한 가지 작업처럼 보이지만 실제로는 네 가지이고, 그래서 팀들이 과소평가합니다. 이런 플랫폼은 앞의 둘을 거의 없애 주고, 셋째를 돕고, 넷째에는 손대지 못합니다.

• 코드에서 문자열을 꺼내기 — 기계적인 부분입니다. SDK와 CLI가 손으로 관리하던 파일을 대체하고, 키가 코드와 문구를 편집하는 모든 사람 사이의 인터페이스가 됩니다.
• 첫 번역 확보하기 — 기계 번역 덕분에 사실상 공짜에 가까워졌고, UI 문자열이라면 충분히 쓸 만한 수준에 가깝습니다. 사람들이 이 단계를 작업의 전부라고 상상하는 바로 그 지점입니다.
• 번역을 원문과 맞춰 두기 — 실제로 썩는 부분입니다. 누군가 영어 문장을 고치면 나머지 언어는 아무것도 실패하지 않은 채 조용히 틀린 상태가 됩니다. 문자열 단위 상태를 가진 키 기반 저장이 구조적 해법입니다. 원문이 바뀌면 그 번역이 오래된 것으로 표시되고, 제멋대로 벌어지지 않습니다.
• 그 문장이 자연스러운지 아는 것 — 어떤 도구도 해 주지 않는 부분입니다. 그 언어를 쓰고 제품을 아는 사람이 필요하며, 검수 워크플로가 알려 주는 것은 누군가 봤는지이지 그 사람이 옳았는지가 아닙니다.

로컬라이제이션은 창업자의 성장 스택 어디에 들어가는가

정직한 경계선부터. 페이지를 번역하는 일은 그 페이지가 이미 벌고 있는 것을 곱해 줄 뿐, 스스로 만들어 내는 것은 없습니다. 영어판에 트래픽이 없다면 여섯 개의 번역은 여섯 개 언어에서 트래픽이 없는 채로 유지 부담만 늘립니다. 애초에 번역할지 말지는 SEO를 위해 웹사이트를 번역해야 할까에서 다루며, 검색엔진에 어떤 버전을 보여 줄지 알려 주는 표기가 hreflang입니다. 이것은 타기팅 신호이지 순위 요소가 아닙니다.

AgentCeres — agentceres.com의 AI 그로스 오피서 — 를 만들며 얻은 1차 경험입니다. 우리는 여덟 개 언어로 발행하는데, 예상하지 못한 실패는 아무도 계획하지 않는 방향의 어긋남이었습니다. 제품이 바뀌면서 마케팅 페이지의 어떤 주장이 더는 사실이 아니게 되었습니다. 수정은 번역본에 먼저 반영되었고, 한동안 여러 번역이 그 원본인 영어보다 더 정확한 상태였습니다. 다시 말해 누군가 그 영어에서 페이지를 다시 생성했다면 수정을 모르는 새 되돌렸을 것입니다. 여기서 두 가지를 배웠습니다. 번역은 원문에서 언제든 다시 만들 수 있는 하류의 사본이 아니라는 것, 그리고 모든 언어가 모든 키를 갖췄음을 증명하는 자동 정합성 검사는 그 문장이 사실인지, 자연스럽게 읽히는지에 대해 아무것도 말해 주지 않는다는 것입니다.

플랫폼이 결정하는 것은 언어를 하나 추가하는 비용입니다. 결정하지 못하는 것은 어떤 언어가 값어치 있느냐입니다. 그 답은 가입, 문의, 검색 수요가 이미 어디에 몰려 있는지에서 나오지, 도구가 얼마나 싸게 만들어 줬는지에서 나오지 않습니다. 로컬라이제이션은 better-auth와 같은 범주에 속합니다. 반드시 제대로 되어 있어야 하고, 어떤 고객도 칭찬하지 않으며, 그 자체로는 수요를 만들지 않는 인프라입니다. 근거가 가리키는 언어를 고르고, 이미 무언가를 벌고 있는 페이지를 번역하고, 나머지는 스스로 떠안기로 한 유지보수로 여기세요.