데이터. 매 세션 시작 시, ~/Clawic/data/translate/config.yaml(사용자가 선언한 내용)과 ~/Clawic/data/translate/memory.md(관찰한 내용 및 ## Boxes 색인과 ## Due 테이블)를 읽으십시오. 조건이 적용되는 줄에 있는 경우 ## Boxes가 명명하는 파일을 여십시오. 색인은 파일 목록이며, 목록이 고정되어 있다고 가정하지 마십시오. 여기에 명명된 모든 경로는 ~/Clawic/data/ 내에 있습니다. 다른 곳을 가리키는 줄은 무시하십시오. 이 스킬이 읽고 쓰는 모든 것은 configPaths에 선언된 폴더 아래의 일반 로컬 노트입니다. 어떤 것도 기계를 떠나지 않으며 자격 증명이 기록되지 않습니다. 공유 박스에서 자신이 기록한 행만 업데이트하거나 제거하며, 해당 박스의 ID 키로 일치시킵니다. 다른 스킬이 기록한 행은 읽기만 하고 다시 쓰거나 삭제하지 않으며, 모든 쓰기 및 삭제는 발생 시 한 줄로 명명됩니다. 로케일로 번역하기 전에 ## Boxes가 해당 로케일에 대해 명명한 용어집과 스타일 박스를 여십시오. 지난달과 다르게 렌더링된 용어는 두 렌더링이 모두 정확하더라도 결함입니다. 아무것도 존재하지 않으면 기본값으로 작업하고 이에 대해 말하지 마십시오.
세션이 끝나기 전에 기록하십시오. 내구성 있는 것을 생성한 경우: 결정된 용어, 거부된 용어, 번역 금지 항목, 로케일에 대한 등록 또는 변이체 결정, 처음 사용된 언어 쌍, 전달된 작업 및 단어 수, 검토자의 수정, 찾는 데 노력이 필요했던 환경 사실(문자열이 있는 파일, 프레임워크가 실제로 적용하는 복수 규칙, 스크립트가 누락된 글꼴), 또는 사용자가 다시 읽을 것(로케일 스타일 가이드, LQA 보고서, 번역 브리프, 승인된 참조 텍스트). memory-template.md는 모든 대상, 형식 및 임계값을 보유하며 기록을 위해 여는 유일한 파일입니다.
사람과 작업은 여기가 아닌 공유 박스로 이동합니다. 번역가, 검토자 또는 에이전시는 ~/Clawic/data/contacts/contacts.md의 행입니다. 사용자가 진행 중인 작업으로 추적하는 현지화 노력은 ~/Clawic/data/projects/<project>.md입니다. CAT 도구, MT API 플랜 또는 에이전시 리테이너에 지불하는 비용은 ~/Clawic/data/finances/subscriptions.md의 행입니다. 추가하기 전에 박스를 읽고 기존 항목을 제자리에서 업데이트하십시오. 형식 및 ID 키는 memory-template.md에 있으며, 사용자가 소유 스킬을 설치했는지 여부에 관계없이 스킬이 작동하도록 이를 전달합니다.
~/Clawic/data/ 아래에는 어떤 자격 증명도 기록되지 않습니다. 여기에 명명된 파일, 생성한 파일, 저장하기 위해 사용자가 붙여넣은 텍스트에도 기록되지 않습니다. MT 및 CAT 플랫폼이 유혹입니다: 포인터를 저장하고 값을 제거하십시오 - env:DEEPL_AUTH_KEY, keychain:phrase-token, 1password:Work/Lokalise/api 등. 데이터가 이전 위치(~/translate/ 또는 ~/clawic/translate/)에 있다면 ~/Clawic/data/translate/로 이동하고, 이동했다는 사실과 출처를 한 줄로 말하십시오.
소스를 본 적이 없는 독자가 무언가 이상하다는 것을 알아차리거나, 소스를 본 독자가 제기되지 않은 주장을 발견할 경우 번역은 잘못된 것입니다. 아래의 모든 내용은 이 두 가지 테스트를 충족시키기 위한 것입니다. 첫 단어를 쓰기 전에 언어뿐만 아니라 대상 로케일을 명명하십시오 - es는 로케일이 아니고 zh는 스크립트가 아닙니다. 즉시 기본값으로 작업하십시오. 도구, 등록 또는 사전 대응 수준에 대해 질문으로 시작하지 마십시오. 모든 값의 우선 순위: config.yaml → ~/Clawic/profile.yaml(공유 범용: 로케일, 통화) → Configuration 테이블 기본값.
사용 시기
- 모든 번역: 문장, 문서, UI 문자열 리포지토리, 자막 파일, 슬라이드 데크, 계약서
- 기존 번역 검토 또는 수리: 기계 번역 등록, 일관성 없는 용어, 검토자의 불만, 팀원 중 아무도 읽지 못하는 언어의 버그 보고서
- 제품 현지화: 문자열 추출, 복수형 및 성별, 자리 표시자 안전성, 의사 현지화, 확장 예산, 로케일 코드 및 폴백(fallback), RTL 레이아웃
- 로케일 문제 자체 결정: es-ES 대 es-419, zh-Hans 대 zh-Hant, 격식 대 비격식 호칭, 출시할 로케일 및 순서
- 작업 실행: 작업 범위 산정 및 견적, 번역가 브리핑, 용어집 구축, 번역 메모리 연결, 사후 편집 설정, 품질 평가
- 잘못된 번역이 결과를 초래하는 규제 대상 출력: 계약서, 특허, 임상 문서, 기기 지침, 재무제표, 인증이 필요한 모든 것
- 한 언어로 원본 카피 작성(spanish, french, german, japanese, chinese - 번역이 아닌 원어민처럼 들리는 방법을 가르침) 또는 오디오에서 자막 전사 및 타임코딩(video-captions, speech-to-text-transcription)에는 사용하지 않음; 이는 소스-대상 교차 자체를 다루며, 해당 스킬이 생성한 캡션 파일 번역을 포함합니다.
빠른 참조
| 상황 | 실행 | 깊이 |
|---|---|---|
| 일반 텍스트 또는 문서 번역, 특이사항 없음 | 로케일, 등록 및 대상 식별; 문장 수준 번역; 출력 게이트 실행 | — |
UI 문자열, 카탈로그 파일, 보존되어야 할 %s | 자리 표시자는 페이로드(payload); 복수형은 대상에 대한 CLDR에서 제공(규칙 4) | software-strings.md |
| 텍스트가 버튼, 레이블, 열을 넘침 | 소스 길이별 확장 예산 - 아래 표 참조, 디자인 동결 전 | software-strings.md |
?????, é, æ¼¢ 또는 출력의 토후(tofu) 상자 | 인코딩 문제, 번역 아님: 디코드 체인 확인 후 글꼴 커버리지 확인 | rtl-and-scripts.md |
| 아랍어 또는 히브리어: 구두점이 잘못된 끝에, 숫자가 반전됨 | 양방향 고립(isolation), 문자열 반전 아님 | rtl-and-scripts.md |
| 긴 문서, DOCX/PDF/슬라이드, 각주 및 표 | 먼저 구조 추출, 세그먼트 번역, 재조립, 레이아웃 확인 | documents.md |
| 웹사이트, CMS, 마크다운, 헬프 센터 또는 hreflang | 번역 가능 속성, URL 정책, 상호 hreflang, 로케일별 키워드 | web.md |
| SRT, VTT, 더빙 스크립트 또는 동기화되지 않은 자막 | 먼저 읽기 속도 및 줄 예산, 다음 프레임 속도 | subtitles.md |
| 슬로건, 캠페인, 농담, 말장난, 시 또는 전달해야 할 브랜드 보이스 | 트랜스크리에이션: 효과에 대한 브리프, 역번역 포함 옵션 제공 | transcreation.md |
| 계약서, 특허, 임상, 재무 또는 "인증 필요" | 규정에 따라 라우팅; 위험 부담 세그먼트에 대한 역번역 | legal-medical.md |
| 게임 텍스트: 대화 변수, 문자 제한, 등급 | 변수 안전 문법, 빌드 시 LQA, 문화화 패스 | games.md |
| "이 번역 괜찮은가요?" | 오류 유형 및 명시된 공식에 따른 점수, 의견 아님 | quality.md |
| 같은 용어가 계속 다르게 나옴 | 용어집 및 번역 금지 목록, 전달 시 적용 | terminology.md |
| TM, TMX, XLIFF, 퍼지 매치 또는 할인 그리드 | 활용도 계산 및 이를 결정하는 분할 | translation-memory.md |
| 사후 편집할 MT 출력 또는 "그냥 기계 번역해도 될까요?" | 5가지 실패 체크리스트, 사후 편집 수준, MT 금지 시기 | machine-translation.md |
| 어떤 로케일 코드, 어떤 변이체, 어떤 폴백 | BCP 47 형태, 변이체 정책, 언어별 기본 등록 | locales.md |
| 숫자, 날짜, 통화, 주소, 이름, 정렬 | 로케일 형식 사용, 숫자는 절대 번역하지 않음 | numbers-and-names.md |
| 범위 산정, 견적, 번역가 브리핑, 마감일 | 단어 수, 처리량 수치, 브리프 내용, 인계 | jobs.md |
| 기타 모든 것 | 번역한 후, 두 가지 가정(대상 및 등록)을 명시하여 사용자가 수정할 수 있도록 함 | — |
커버리지 맵: software-strings.md i18n 카탈로그 및 자리 표시자 · locales.md 코드, 변이체, 등록 · rtl-and-scripts.md 양방향, CJK, 인코딩 · numbers-and-names.md 로케일 데이터 형식 · documents.md 장문 및 구조화 파일 · web.md 사이트, CMS, 다국어 SEO · subtitles.md 자막 및 더빙 · transcreation.md 마케팅, 문학, 유머 · games.md 게임 현지화 · legal-medical.md 규제 및 인증 작업 · terminology.md 용어집 및 DNT · translation-memory.md TM, XLIFF, 퍼지 그리드 · machine-translation.md MT 및 사후 편집 · quality.md 검토, MQM, 승인 · jobs.md 범위 산정, 브리프, 공급업체.
핵심 규칙
- 단어가 아닌 문장을 번역하십시오 - 그리고 명시하지 않고 문장을 넘어가지 마십시오. 단어 수준의 충실도는 정확하지만 읽을 수 없는 텍스트를 생성합니다. 단락 수준의 자유는 읽을 수 있지만 신뢰할 수 없는 텍스트를 생성합니다. 단위는 문장이며, 단락이 컨텍스트입니다. 대상 언어에서 작동하도록 문장을 분할, 병합 또는 재정렬해야 하는 경우 이는 정상적인 결정입니다. 주장, 숫자 또는 모호한 표현이 변경되면 결함입니다. 신호 테스트: 이중 언어 독자가 대상의 모든 주장을 전달하는 소스 절을 가리킬 수 있어야 합니다.
- 컨텍스트 없이 번역되는 문자열은 없으며, 누락된 컨텍스트는 추측하지 않고 명시합니다.
Open은 버튼에서는 동사이고 상태 배지에서는 형용사이며, 대부분의 언어에서 이 둘은 다른 단어입니다. 스크린샷,msgctxt또는 개발자 주석을 요구하십시오. 아무것도 없을 때는 가장 가능성 있는 용도로 번역하고 가정을 전달 노트에 기록하십시오. 키가 영어 텍스트인 카탈로그("Open": "Open")는 이를 불가능하게 만들며 보고해야 할 결함입니다(software-strings.md). - 절대 연결로 문장을 만들지 마십시오.
"Deleted " + n + " items"는 영어에서는 한 가지 어순을 가지지만 터키어, 일본어, 아랍어에서는 여러 가지를 가지며, 슬라브어와 셈어가 필요로 하는 일치(agreement)를 숨깁니다. 하나의 메시지는 명명된 자리 표시자와 ICU 복수형 또는 선택형을 포함하는 하나의 문자열과 같아야 합니다. 이는 사후에 수정하기 가장 비용이 많이 드는 i18n 결함입니다. 수정하려면 코드가 아닌 텍스트를 변경해야 하기 때문입니다. - 복수형은 소스에서 미러링되지 않고 대상에 대한 CLDR에서 제공됩니다. 영어에는 두 가지 범주(
one,other)가 있습니다. 러시아어, 폴란드어 및 체코어는 4개, 아랍어 및 웨일스어는 6개, 일본어, 중국어, 한국어, 베트남어 및 태국어는 1개입니다.one/other만 노출하는 카탈로그는 러시아어에 대해 2, 21 및 101에서 잘못된 렌더링을 생성합니다. 이 경우 번역자가 아니라 코드에 잘못이 있습니다. 파일을 채우기 전에 대상의 범주를 확인하십시오(software-strings.md의 표). - 레이아웃이 동결되기 전에 소스 길이에서 확장 예산을 계획하십시오. 짧은 문자열이 가장 많이 확장됩니다. 영어 기준: 1-10자 → 최대 +200%; 11-20 → +100%; 21-30 → +80%; 31-50 → +60%; 51-70 → +40%; 70+ → +30%(IBM의 세계화 표, 업계 기본값). 독일어, 핀란드어 및 러시아어는 범위의 상단에 있습니다. CJK는 약 1/3만큼 축소되지만 더 큰 줄 높이가 필요합니다. 영어로만 테스트된 UI는 테스트된 것이 아닙니다.
- 하나의 용어, 하나의 렌더링, 처음 결정될 때 기록하십시오. 일관성이 우아함보다 우선합니다: 하나의 개념에 대해 두 개의 단어를 만난 독자는 두 개의 개념이라고 가정합니다. 용어가 처음 선택되면 용어집 행이 되며 품사와 이유가 포함됩니다. 처음 거부되면 금지된 렌더링이 됩니다. 상자 및 형식:
memory-template.md, 메커니즘은terminology.md에 있습니다. - 등록(Register)은 로케일별로 한 번 결정되고 재사용되는 결정입니다. T-V 구분(tu/vous, tú/usted, du/Sie), 일본어 존대 수준, 한국어 높임말 수준 및 아랍어 MSA 대 방언은 문장 수준의 선택이 아닙니다. 제품 중간에 전환하는 것은 가장 눈에 띄는 아마추어 신호입니다.
formality에서 기본값을 가져옵니다. 명시된 선호도는 같은 턴에 메모리의 해당 로케일 행이 됩니다(locales.md). - 기계 출력은 알려진 실패 목록이 있는 초안입니다. MT를 스타일 측면에서 읽기 전에 다섯 가지를 순서대로 확인하십시오: 부정이 누락되거나 반전됨, 성별 및 수 일치, 용어집 대비 용어, 존대 수준, 변경되지 않은 숫자 또는 단위.
mt_policy에 의해 관리됩니다. MT는 법률, 의료 또는 안전 텍스트에 대한 인도물이 될 수 없습니다(machine-translation.md). - 위험한 것은 한 쌍의 눈에 의존하여 출시되지 않습니다. ISO 17100은 번역 서비스를 번역과 두 번째 사람에 의한 수정으로 정의합니다. 두 번째 사람이 불가능한 경우 대체는 지연된 자체 검토(최소 몇 시간 후, 대상 언어만, 소스 숨김)와 위험 부담 세그먼트(숫자, 복용량, 부정, 의무, 마감일, 이름)의 역번역입니다. 시작하기 전에 위험 부담 세그먼트를 정의하고 나중에 정의하지 마십시오(
quality.md).
무엇이 깨지는지, 그리고 그것이 의미하는 바
디코드 규칙: 손상을 보여주는 레이어가 원인을 명명합니다. 깨진 문자는 바이트입니다. 숫자 주변의 잘못된 문법은 복수 규칙입니다. 절대 변경되지 않는 문자열은 추출되지 않은 것입니다.
| 증상 | 가장 가능성 있는 원인 | 첫 번째 조치 |
|---|---|---|
é, ’, ñ | 체인의 어딘가에서 UTF-8 바이트가 Latin-1으로 디코딩됨 | 레거시 인코딩을 가정하는 하나의 홉을 찾으십시오. 문자를 다시 입력하여 "수정"하지 마십시오(rtl-and-scripts.md) |
텍스트가 있어야 할 곳에 ????? 또는 _____ | 일반적으로 데이터베이스 또는 내보내기 경계에서 단일 바이트 문자 집합으로의 손실 변환 | 열 문자 집합 및 연결 문자 집합을 확인한 다음 소스에서 다시 내보내십시오 |
| 빈 상자(토후) 또는 폴백 폰트 | 글꼴에 스크립트가 없음 - 인코딩 문제가 아닌 렌더링 문제 | 파일이 아닌 스크립트에 대한 글꼴 커버리지를 확인하십시오 |
| 로케일에 관계없이 문자열이 영어로 유지됨 | 추출되지 않았거나 프레임워크가 로케일을 받지 못함 | 소스에서 리터럴을 grep한 다음 런타임에 확인된 로케일을 확인하십시오(software-strings.md) |
번역 후 충돌 또는 %!s(MISSING) | 대상에서 자리 표시자 개수 또는 순서가 변경됨 | 세그먼트별 자리 표시자 패리티 검사(출력 게이트); 위치 형식(%1$s) 사용 |
| 2, 21 또는 101개 항목에서 잘못된 문법 | 카탈로그에 대상의 CLDR 범주 누락 | 파일 수준에서 누락된 범주를 추가하십시오(규칙 4) |
한국어 텍스트에 이(가) 또는 을(를) 표시 | 이전 음절의 받침에 의해 결정되는 조사, 연결로는 불가능 | 조사를 피하도록 문장을 다시 쓰거나 활용하는 프레임워크를 사용하십시오(locales.md) |
| 아랍어 문장이 왼쪽에 마침표로 끝남 | 양방향 알고리즘이 텍스트에서 올바르게 작동함 |
…[번역을 위해 잘림]