측정할 번역 수집하기
지원되는 소스를 선택하고 측정에 필요한 텍스트, 리비전, 맥락을 보존하세요.
팀에서 이미 만들고 있는 번역으로 측정을 시작할 수 있습니다. 승인된 텍스트는 기존처럼 저장소나 번역 관리 시스템에서 관리하고, 검사에 사용할 수 있도록 제공할 방법을 선택하세요.
측정은 식별 가능한 버전을 단위로 삼는 것이 좋습니다. 평가 후 메시지가 바뀌어도 이전 결과는 여전히 이전 문구에 대한 평가입니다. 원문과 번역문의 리비전을 함께 보관하면 최신 콘텐츠로 당시 근거를 재구성할 필요 없이 원래 근거를 다시 확인할 수 있습니다.
워크플로에 맞는 소스 선택 #
| 시작점 | 측정 방법 |
|---|---|
| Crowdin 활동 | Crowdin 연결을 마친 뒤 이벤트 측정을 설정하고, 생성된 레이더 이벤트와 결과를 확인하세요. 레이더 화면을 이용하려면 레이더 접근 권한이 필요합니다. |
| GitHub 커밋 | GitHub App 연결을 마친 뒤 원문과 번역문 경로를 설정하세요. 기본 브랜치에서 지원되는 로컬라이제이션 키가 변경되면 이벤트가 생성됩니다. |
| Zendesk 도움말 센터 | Zendesk를 연결하세요. 게시된 문서가 변경되면 각 언어에 해당하는 원문 또는 번역 이벤트가 생성됩니다. |
| 로컬 번역 파일 | 평가기와 모델을 설정한 뒤 lingo score를 사용하세요. 결과는 레이더 이벤트 기록과 별도로 로컬에 저장됩니다. |
| Lingo.dev 번역 | 완료된 로컬라이제이션은 각각 이미 이벤트로 기록되어 있습니다. 엔진, 언어, 표본을 선택하는 방법은 Lingo.dev 번역 검토에서 확인하세요. |
다른 소스를 사용한다면 전송을 자동화하기 전에 Lingo.dev에 문의해 이벤트 수집을 준비하세요.
GitHub 및 Zendesk 활동 수집 #
GitHub에서는 대상 저장소에 앱을 설치하고 Lingo.dev 조직에 연결하세요. 원문 로캘, 번역 대상 로캘, 원문 파일 패턴을 지정한 .lingo/config.json을 커밋하세요. 이 경로를 기준으로 원문 변경과 번역문 변경을 구분합니다. 기본 브랜치의 커밋으로 설정된 로컬라이제이션 키가 변경되면 이벤트를 확인하세요. 커밋 하나에서 여러 키와 언어에 대한 이벤트가 생성될 수 있습니다.
GitHub 활동을 수집할 때는 JSON, JSONC, YAML, 루트 키가 있는 YAML, 안드로이드 리소스, 애플 .strings, Flutter ARB, PHP, 타입스크립트 파일을 읽습니다. 변경 사항이 이벤트로 생성되는 과정은 저장소 변경 사항에서 확인하세요.
Zendesk에서는 도움말 센터 연결을 승인하고 사용할 언어를 활성화하세요. 레이더는 게시된 문서의 활동을 언어별로 기록합니다. 이벤트를 열어 문서 식별 정보, 로캘, 텍스트가 Zendesk와 일치하는지 비교하세요. 활동을 수집하는 것만으로 번역 동기화가 실행되거나 새 번역 문서가 게시되지는 않습니다.
어느 연결을 사용하든 승인된 번역은 원래 시스템에 그대로 유지됩니다. 측정은 기록된 이벤트를 검사할 뿐, 게시 단계가 되지는 않습니다.
측정 전 제공업체 기록 가져오기 #
필요한 제공업체 기록을 선택하세요.
- GitHub: 저장소의 기본 브랜치에서 최근 커밋을 최대 5,000개까지 가져옵니다. 각 커밋은 해당 리비전에 저장된
.lingo/config.json을 기준으로 읽습니다. 해당 설정이 만들어지기 전의 커밋에서는 이벤트가 생성되지 않습니다. - Zendesk: 기존 문서, 섹션, 카테고리의 현재 게시 버전을 언어별로 가져오며, 마지막 업데이트 날짜를 기준으로 기록합니다. 이전 리비전과 초안 버전은 수집 대상에서 제외됩니다.
GitHub 또는 Zendesk를 새로 연결하면 기록 가져오기가 자동으로 시작됩니다. 연결의 설정 탭에서 진행 상황을 확인하세요. 나중에 가져오기를 시작하거나 다시 시도하려면 다음 단계를 따르세요.
- 스튜디오의 연결됨에서 저장소나 도움말 센터를 선택한 다음 설정 탭을 여세요.
- GitHub의 커밋 기록 또는 Zendesk의 도움말 센터 기록에서 기록 가져오기를 선택하세요.
- 가져오기 진행 상황을 확인하세요. 수집 대기 중인 제공업체 항목 수가 표시됩니다.
- 측정하려는 이벤트가 레이더 → 로그에 표시될 때까지 기다린 다음 날짜, 로캘, 텍스트를 확인하세요.
제공업체 이벤트를 대상으로 실행되는 측정에서는 백필 탭의 이벤트 가져오기도 사용할 수 있습니다. 여기에는 연결된 GitHub 저장소와 Zendesk 도움말 센터가 표시됩니다. 기록을 가져올 때는 측정을 실행하지 않고 수집만 합니다. 원하는 이벤트가 표시되면 측정을 활성화하고 해당 기간에 대한 과거 데이터 평가를 시작하세요.
백필 후 가져온 이벤트가 더 표시되면 아직 측정하지 않은 이벤트만을 활성화한 뒤 백필을 다시 실행하세요. 가져오기에 실패하면 진행 상황을 확인하고 같은 설정 탭에서 다시 시도하세요. 측정의 백필과 결과는 가져오기와 별도로 확인하세요.
비교 자료 보존 #
원본 시스템 식별자, 콘텐츠 식별자, 번역 대상 로캘, 번역문 리비전을 함께 보관하세요. 의미를 검사하려면 해당 원문 리비전도 추가하세요. 편집을 측정하려면 편집된 번역문의 바탕이 된 초안을 보관하세요.
예를 들어 자체 추적 기록에서 delivery.promise, 로캘 fr, 리비전 42의 조합으로 특정 카탈로그 항목을 식별할 수 있습니다. 리비전 43에서는 약속하는 내용이 달라질 수 있습니다.
워크플로에서 작성 주체 정보를 제공한다면 사람, 모델, 기계 번역 제공업체, 번역 메모리 재사용 중 무엇인지 기록하세요. 출처를 알 수 없다면 알 수 없는 상태로 남겨 두세요. 제공업체에서 번역을 승인한 사용자가 반드시 그 번역을 작성한 사람이나 모델인 것은 아닙니다.
선택한 질문에 필요한 근거 제공 #
무엇을 수집할지는 기준에 따라 달라집니다. 맞춤법 검사는 번역문만으로도 가능합니다. 의미 검사에는 서로 대응하는 원문과 번역문, 모호함을 해소할 맥락이 필요합니다. 용어 검사에는 적용할 용어와 그 사용 범위가 필요합니다. 플레이스홀더 검사에는 플레이스홀더가 따라야 할 규약이 필요하고, 편집 거리 측정에는 실제 초안과 번역문 쌍이 필요합니다.
번역에 원문 리비전이 없다면 의미 검사에서 미평가 사례로 남겨 두고, 판단하기 전에 원문을 확보하세요.
수집된 이벤트 하나 확인 #
- 연결된 소스에서 테스트 활동을 만들기 전에 선택한 측정을 설정하세요.
- 해당 이벤트를 찾으세요. 로캘, 텍스트, 출처, 확인 가능한 초안을 자체 기록과 비교하세요.
- 측정 결과를 열고 텍스트 옆의 기준을 읽어 보세요. 결과가 반환되었는지, 해당 없음으로 반환되었는지, 아니면 완료되지 않았는지 확인하세요.
- 이벤트와 측정의 식별 정보를 평가된 리비전과 함께 보관하세요. 승인된 수정 사항은 텍스트를 관리하는 시스템에 반영하세요.
로컬 점수 평가를 사용한다면 저장된 결과를 입력 파일 및 평가기 설정과 함께 확인하세요. 이 방식으로는 레이더 이벤트가 생성되지 않습니다.
반복 실행하는 워크플로에서는 무엇을 선택하고 수집하고 측정했는지 기록을 남기세요. 파이프라인에서 번역 측정에서는 재시도와 변경된 리비전 처리를 포함한 수집 및 복구 방법을 다룹니다.