연동
팀에서 이미 사용 중인 저장소, 애플리케이션, 콘텐츠 도구에 번역과 측정을 연결하세요.
팀의 콘텐츠는 이미 저장소, 애플리케이션 데이터베이스, 콘텐츠 관리 시스템, 번역 플랫폼 등에 저장되어 있습니다. 연동은 이렇게 진행 중인 작업을 Lingo.dev에 연결합니다. 어떤 콘텐츠를 읽고, 무엇을 계기로 번역이나 측정을 시작하며, 결과를 어디에 표시할지 정합니다.
번역을 위한 연결은 저장해 둔 용어, 지침, 모델 설정을 적용한 로컬라이제이션 엔진으로 원문 콘텐츠를 보냅니다. 저장소 연동은 파일을 반환하고, 콘텐츠 관리 시스템 연동은 콘텐츠의 언어별 버전을 업데이트합니다. 애플리케이션 코드는 저장하거나 제공할 데이터를 받습니다. 측정을 위한 연결은 기존 번역을 원래 시스템에 그대로 둔 채, 해당 번역에 대한 근거 데이터를 가져옵니다.
기존 작업 연결하기 #
어디서 시작할지는 콘텐츠가 변경되는 위치와 작업을 실행할 담당자에 따라 달라집니다.
| 시작점 | 연결 및 결과 |
|---|---|
| GitHub 저장소의 파일 | GitHub App은 설정된 저장소 이벤트에 따라 작동하며, 번역 풀 리퀘스트 또는 원본 풀 리퀘스트의 브랜치로 번역된 커밋을 전달합니다. |
| 자체 지속적 통합 파이프라인의 파일 | GitHub Actions, GitLab CI, Bitbucket Pipelines 또는 빌드카이트에서 CLI를 실행하세요. 실행 작업이 아티팩트를 보관하고 저장소 배포를 제어합니다. |
| 로컬 파일 | CLI는 선택한 파일을 제출하고 번역을 checkout으로 가져옵니다. 커밋 시점은 직접 정합니다. |
| Payload 컬렉션 및 글로벌 | Payload는 선택한 현지화 필드를 동일한 리소스의 대상 로캘로 번역합니다. 수동으로 실행하거나 원문 변경 후에 실행할 수 있습니다. |
| Zendesk 도움말 센터 | Zendesk는 수동 실행을 통해 선택한 카테고리, 섹션, 문서를 도움말 센터의 해당 언어 버전으로 번역합니다. |
| 백엔드에서 관리하는 콘텐츠 | API는 구조화된 애플리케이션 데이터를 받습니다. 작업 추적과 반환된 번역 저장은 직접 작성한 코드에서 처리합니다. |
| Crowdin에서 생성된 번역 | Crowdin은 레이더에서 측정할 수 있도록 지원되는 번역 활동을 보냅니다. 이 연결은 수정 사항을 원래 시스템에 다시 기록하지 않습니다. |
| Jira의 번역 피드백 | Jira 트리아지는 라벨이 지정된 이슈를 살펴보고 검토할 변경 사항을 제안합니다. 저장소를 다시 번역하려면 별도 승인이 필요합니다. |
연동 카탈로그에서 제공업체별 설정과 복구에 필요한 전체 지침을 확인하세요. 지속적 통합 구성 예제는 자체 인프라에서 실행되며, 기본 제공 계정 연결을 생성하지는 않습니다.
에이전트 기반 작업에는 호출자의 권한으로 현지화 작업을 제공하는 MCP를 사용하세요. 리액트 애플리케이션에서 메시지를 표시하려면 리액트 라이브러리를 사용하세요. 다른 연결에서 카탈로그를 생성하더라도 메시지 렌더링과 로캘 선택은 여전히 애플리케이션에서 담당합니다.
변경 사항 하나를 최종 사용 위치까지 따라가기 #
팀원이 확인할 수 있는 원문 변경 사항 하나로 시작하세요. 저장소라면 결제 메시지 하나와 대상 언어 하나로 시작할 수 있습니다. 콘텐츠 관리 시스템이라면 아직 게시하지 않은 문서 하나를 사용할 수 있습니다. 원문 선택, 대상 로캘, 로컬라이제이션 엔진을 설정한 뒤 제공업체의 첫 실행 절차를 따르세요.
결과가 실제로 사용될 위치에서 내용을 확인하세요. 파일은 애플리케이션에서 불러오는 경로와 구조를 갖춰야 합니다. 콘텐츠 관리 시스템의 번역은 의도한 로캘에 속하고 게시 상태도 의도한 대로여야 합니다. 제대로 전달되었는지는 물론 의미도 확인하세요. 그런 다음 한 곳을 수정하고 확정된 문구를 어디에 저장할지 정해, 다음 실행에서 해당 문구를 적절히 처리할 수 있도록 하세요.
워크플로마다 승인 단계가 다릅니다. GitHub App은 번역 비용이 발생하기 전에 동의를 요구하고, 이후 콘텐츠 검토용 풀 리퀘스트를 전달하도록 설정할 수 있습니다. 콘텐츠 관리 시스템 연결은 초안을 저장하거나 바로 게시할 수 있습니다. 각 작업이 이루어지는 위치에서 누가 실행을 승인하고, 누가 번역을 수락하며, 누가 게시할지 정하세요.
궁금한 점을 해결하는 데 필요한 측정 추가하기 #
당장 필요한 일이 기존 번역을 파악하는 것이라면 측정부터 시작하세요. Crowdin은 이벤트 기반 연결을 제공하며, CLI 점수 평가는 로컬 카탈로그를 확인하고 결과를 로컬에 기록합니다. 번역을 생성하는 주체를 바꾸지 않고도 이 방식을 사용할 수 있습니다.
결과는 검사 대상이었던 텍스트와 연결해 두세요. 이전 버전에서 발견된 사항이 현재 게시된 문장에는 더 이상 해당하지 않을 수 있습니다. 번역 수집에서는 이용 가능한 근거 데이터 수집 방식을, 제공업체 페이지에서는 자동으로 들어오는 데이터를 설명합니다. 수정 사항은 확정된 텍스트를 관리하는 시스템을 통해 적용하세요.