연동

저장소와 콘텐츠 관리 시스템의 번역을 연동하고, 지속적 통합 환경에서 로컬라이제이션을 실행하고, Crowdin의 근거 자료를 수집하거나 Jira 피드백을 조사하세요.

팀이 콘텐츠를 작성하고 번역하고 검토하는 도구에서 Lingo.dev를 함께 활용하세요. 연결마다 맡은 역할이 다릅니다. 번역된 콘텐츠를 원본 시스템에 반영하는 연결도 있고, 근거 자료를 수집하거나 피드백 조사를 돕는 연결도 있습니다.

기존 시스템에서 콘텐츠 번역하기 #

이러한 기본 연동은 선택한 원본 콘텐츠를 읽어 로컬라이제이션 엔진으로 번역한 뒤, 사용자가 부여한 서비스 접근 권한으로 결과를 원래 시스템에 기록합니다.

연결작업 시작 조건번역 결과가 반영되는 위치
GitHub설정된 저장소 이벤트 또는 범위를 지정한 번역 명령기본 브랜치 변경 사항에 대한 번역 풀 리퀘스트 또는 조건에 맞는 풀 리퀘스트 브랜치의 커밋.
Payload수동 동기화 또는 플러그인의 원본 변경 알림동일한 컬렉션과 글로벌 내에서 선택한 대상 로캘의 현지화 필드.
워드프레스수동 동기화 또는 게시된 글 저장 시 플러그인 알림선택한 언어로 각 게시물에 연결된 폴리랭 또는 WPML 번역본입니다.
Zendesk 도움말 센터수동 동기화선택한 카테고리, 섹션, 문서의 언어별 버전.

접근 범위는 제공업체 설정에서 정합니다. GitHub에서는 저장소와 소스 파일 패턴을 선택합니다. Payload에서는 현지화된 필드가 있는 컬렉션과 글로벌을 선택합니다. 워드프레스에서는 게시물 유형을 선택합니다. Zendesk에서는 카테고리, 섹션, 문서를 각각 선택합니다. 카테고리를 선택해도 하위 항목이 함께 선택되지는 않습니다.

게시 방식도 제공업체마다 다릅니다. Payload의 게시 모드에서는 이미 게시된 문서에 아직 게시하지 않은 수정 사항이 있으면, 이를 게시하거나 되돌리기 전까지 해당 문서에 쓰기 작업을 수행하지 않습니다. 번역을 게시하면 이 수정 사항까지 함께 공개되기 때문입니다. Zendesk에서 초안으로 저장하면 이미 공개된 로캘 버전이 내려가 다시 게시할 때까지 표시되지 않을 수 있습니다. 첫 쓰기 작업 전에 제공업체의 게시 관련 섹션을 확인하세요. 특히 기존 번역이 있다면 꼭 확인해 주세요.

파이프라인에서 번역 실행하기 #

GitHub Actions, GitLab CI, Bitbucket Pipelines, Buildkite는 자체 실행기에서 CLI를 실행합니다. 구성 예시는 다운로드 가능한 아티팩트나 신뢰할 수 있는 단일 브랜치로 시작하므로 저장소 쓰기 권한을 확대하기 전에 결과를 확인할 수 있습니다. .lingo/lock.json를 커밋한 상태에서 lingo check를 실행하면 마지막 번역 이후 원문이 변경되었거나 대상 파일이 누락된 경우 풀 리퀘스트나 병합 요청을 실패로 처리합니다. API 키는 필요하지 않습니다.

일정 관리, 비밀 정보 관리, 결과물 보관, 커밋 또는 풀 리퀘스트 생성은 파이프라인이 담당합니다. Lingo.dev API 키는 번역 권한을, 서비스 인증 정보는 저장소 쓰기 권한을 부여합니다. 지속적 통합 환경에서 번역 자동화하기에서는 원본 리비전, 완성된 결과물, 애플리케이션 검사를 함께 관리하는 방법을 설명합니다.

번역 측정 또는 피드백 조사하기 #

Crowdin은 지원되는 문자열 단위 활동을 레이더로 보냅니다. 번역 생성이나 검토 워크플로를 옮기지 않고도 Crowdin에서 생성된 번역을 살펴볼 수 있습니다. 답을 얻고 싶은 질문에 맞춰 측정을 설정한 다음, 수집된 텍스트와 측정 결과를 확인하세요. 이 연결은 수정된 번역을 Crowdin에 다시 동기화하지 않습니다.

Jira 연동은 보고된 문제에서 시작합니다. lingo 레이블을 추가하면 트리아지 워크플로가 이슈를 살펴보고 용어집, 규칙 또는 브랜드 보이스 변경을 제안하도록 요청할 수 있습니다. 담당자는 각 제안을 적용하거나 기각한 뒤, 영향을 받는 연결된 콘텐츠를 다시 번역할지 선택합니다. Jira 트리아지는 티켓 내용을 로컬라이제이션 프로젝트로 번역하지 않습니다.

범위를 넓히기 전에 첫 실행 완료하기 #

각 서비스 안내 페이지에서는 인증부터 설정, 결과물 확인, 복구까지 소규모로 첫 실행을 진행하는 과정을 안내합니다. 이 과정을 통해 연결이 어떤 내용을 읽고 변경하는지 확인하세요. 연결 사용 가능 여부는 조직 권한과 기능 접근 권한에 따라 달라질 수 있습니다. 서비스 인증 정보만으로는 로컬라이제이션 엔진에 접근할 수 없습니다.

연결 사용을 중단할 때는 새로운 작업을 시작하는 트리거를 중지하고 서비스 인증 정보는 별도로 처리하세요. 연결을 해제해도 이미 전달된 콘텐츠, 게시된 댓글, 기록된 측정값은 되돌려지지 않습니다. 서비스별 복구 섹션에서는 어떤 상태가 유지되고 다시 연결하면 어떻게 되는지 설명합니다.

애플리케이션에서 직접 관리하는 워크플로가 필요하다면 개발자 도구에서 API, CLI, 자바스크립트 인터페이스를 살펴보세요.