문서 번역과 다국어 검토

문서 번역과 다국어 검토

에디터 헤더의 번역 버튼을 열면 현재 문서를 다른 언어로 번역하고 결과를 검토할 수 있다. 기본 흐름은 대상 언어 선택, 로컬 번역 연결 확인, 번역, 검토, 번역본 열기 순서다.

Free와 Pro의 작업 범위

Free에서는 한 번에 현재 Markdown 문서 하나의 번역 초안을 만든다. 같은 문서를 다시 번역하거나 다른 현재 문서에서 새로 실행할 수 있으며 사용량 횟수를 세는 quota는 없다. 대상 언어가 프로젝트 언어로 등록되지 않아도 실행할 수 있고, 현재 문서에서 찾은 용어 후보를 확인해 한 번에 최대 5개의 새 provisional 항목을 수동 저장할 수 있다. 프로젝트 일괄 번역·준비 상태·승인 용어 관리는 이 반복 실행 범위에 포함되지 않는다.

Pro에서는 프로젝트의 변경 문서를 일괄 번역하고, 승인 용어집·사람이 수정한 번역 보호·locale 준비 상태를 함께 관리한다. Pro 작업은 실행 시점의 live entitlement를 확인한다. 확인할 수 없거나 offline이면 현재 문서 Free 흐름만 허용한다.

로컬 번역 연결

기본 경로는 Glif가 서명·검증한 관리형 로컬 번역 패키지다. 대상 언어와 작업 범위를 정한 뒤 준비가 필요할 때만 설치 안내가 열리고, 다운로드·디스크 크기, 로컬 처리, 라이선스와 취소 정책을 확인한 뒤 설치한다. 임의 local endpoint, mutable model tag 또는 model family 일치만으로 준비 완료로 간주하지 않는다.

전체 절차와 현재 release evidence 경계는 문서 번역과 다국어 검토 전체 가이드를 따른다.

외부 제공자 사용

외부 제공자는 고급 설정에서 endpoint, model, API key를 명시적으로 연결한다. HTTP는 loopback 주소에서만 허용하며 원격 제공자는 HTTPS가 필요하다.

외부 제공자를 선택해도 자동으로 원문을 전송하지 않는다. 각 실행에서 제공자와 문서 범위를 확인하고 외부 전송에 다시 동의해야 한다. 대상 언어, 문서 또는 제공자를 바꾸거나 실행이 끝나면 동의는 초기화된다.

번역 결과 검토

완료 카드는 완료·실패·취소를 구분하고 현재 문서에서 다음에 할 행동 하나를 안내한다. 자동 검증을 통과하지 못한 출력은 기존 정상 번역본을 덮어쓰지 않고 검토 필요 상태로 남는다. 오류 상세는 기본 화면에서 내부 경로나 credential을 노출하지 않으며 고급 진단 영역에서만 제한적으로 확인한다.

프로젝트 자동 번역은 사람이 수정한 chunk를 기본적으로 보존한다. 선택한 chunk 재번역이나 전체 재번역은 사용자가 명시적으로 승인한 덮어쓰기 경로다. 외부 제공자 재번역은 사용자가 고른 실행 엔진을 쓰는 경로일 뿐 더 높은 번역 품질을 보장하는 별도 기능으로 표시하지 않는다.

용어집과 충돌

Free의 provisional 용어는 현재 문서 초안 검토를 돕는다. Pro의 승인 용어는 locale pair와 상태를 기준으로 관리하며, 같은 원문에 서로 다른 승인 번역이 있으면 프로젝트 일괄 번역을 차단한다. Free 현재 문서 번역에서는 충돌을 경고하고 결과를 검토 필요로 표시한다.

취소와 복구

실행 중 취소가 승인되면 해당 run은 terminal 상태로 전환되고 이후 결과를 쓰지 않는다. 이미 결과 반영을 시작했거나 terminal 상태면 취소 요청은 승인되지 않으며 완료된 commit을 뒤늦게 취소한 것처럼 표시하지 않는다. 앱이 저장 중 중단되더라도 번역본과 상태 파일은 이전 또는 새 버전 중 하나로 복구되며, 재시작 사이에 사용자가 직접 수정한 번역본은 오래된 recovery journal로 덮어쓰지 않는다.

문제 해결

• 로컬 번역을 준비할 수 없으면 관리형 package를 제공하는 지원 빌드인지 확인한다.
• 외부 제공자가 비활성화되면 endpoint의 HTTPS/loopback 조건, model, API key를 확인하고 명시적으로 연결 테스트를 실행한다.
• 프로젝트 번역이 열리지 않으면 로그인과 live Pro entitlement를 확인한다. Offline fallback은 프로젝트 권한으로 사용하지 않는다.
• 검토 필요 항목은 실패 원인과 retry 가능 여부를 확인한 뒤 해당 문서나 chunk만 다시 실행한다.