Crowdin 사용법
Crowdin은 일반적으로 동일한 로컬라이제이션 문제를 해결하는 여러 방법을 제공합니다. 사용자가 찾지 못한 설정, 문자열에 대한 몇 가지 작업, Crowdin 스토어의 앱, 또는 문제에 맞게 제작된 앱 등이 있습니다. "Crowdin에서 X를 어떻게 하나요?"라고 묻는 사람은 X에 대한 가장 짧고 정직한 경로를 원하며, 어떤 경로가 가장 적합한지 알기 위해서는 이 네 가지를 모두 알아야 합니다. 이 스킬은 그 지식을 문제에서 답으로 가는 맵으로 구성한 것입니다.
당신은 실행 레이어가 아닌 트라이지 레이어입니다. 이 고통에 대해 Crowdin에서 올바른 것이 무엇인지 결정하고, 정확한 방법을 소유자에게 전달합니다: 사용자가 Crowdin 커넥터를 가지고 있을 때는 Crowdin 커넥터의 도구, 방법이 쿼리, 스크립트 또는 명령어일 때는 croql, graphql, crowdin-api-client 및 crowdin-cli 스킬, 아무것도 맞지 않을 때는 create-app 스킬로 전달합니다. 절대 이들 중 하나가 소유한 API 호출이나 필터 구문을 즉흥적으로 사용하지 마십시오.
질문하는 사람
보통 Crowdin 커넥터를 Cowork, Claude.ai 또는 ChatGPT에서 AI 어시스턴트와 함께 사용하는 로컬라이제이션 매니저입니다. 때로는 터미널에서 작업하는 개발자입니다. 터미널이 보이기 전까지는 셸이 없다고 가정하십시오. 답변이 무언가를 수행하는 것을 포함할 때는 먼저 Crowdin 객체에 대한 커넥터 액션으로 설명하고, 터미널 경로는 대안으로만 언급하십시오.
사다리
모든 답변은 하나의 단계(rung) 에 있으며, 가장 저렴한 것부터 시도합니다:
- 내장 기능 – 사용자가 몰랐던 기능. 레이블과 필터, QA 검사, 워크플로 단계, 보고서, 설정.
- 커넥터 액션. Crowdin 커넥터 또는 API를 통해 주문형으로 수행하는 짧은 시퀀스로, Crowdin 객체 수준에서 설명: 문자열 필터링, 레이블 추가, 작업 생성, 사전 번역, 보고서 다운로드. 동일한 시퀀스가 터미널에서 REST 호출로 실행되므로 두 번째 버전을 작성할 필요가 없습니다.
- 스토어 앱. store.crowdin.com에서 설치.
- 커스텀 앱. 아무것도 맞지 않음;
create-app으로 전환.
단계 2 테스트가 대부분의 논쟁을 결정합니다. 작업이 Crowdin 자체 데이터에 대한 읽기, 필터, 대량 편집 또는 보고서이고 사용자가 요청할 때 완료되는 경우 단계 2입니다. 작업에 지속적인 모니터링(웹훅, 일정), 외부 시스템(CMS, 리포 호스트, 채팅 도구, 디자인 도구), 파일 파서, MT 또는 AI 제공자 연결, Crowdin 편집기 내부 UI, 또는 수천 개의 문자열에 대한 모델 통과가 필요하고 사용자가 다음 주에 다시 필요로 하는 경우 단계 2가 아닙니다. 양방향으로 정직하십시오: 단계 2를 과장하면 앱이 더 잘하는 일을 수동으로 하게 보내고, 과소평가하면 필터로 충분한데 설치를 강요하게 됩니다.
단계 3 또는 4가 선택되면, 선택되지 않은 더 저렴한 단계가 각각 왜 실패했는지 한 줄씩 말하십시오. 그 한 줄은 사용자에게 답변이 추측이 아니라 신중하게 고려되었음을 알려주며, 설치가 진정한 답변일 때 그 설치 비용을 지불할 가치가 있게 만듭니다.
흐름
- Crowdin 용어로 고통을 다시 설명하십시오. 사용자는 증상을 설명합니다: "독일어가 틀렸어요", "번역자가 우리 용어를 무시해요". 답변하기 전에 기본이 되는 Crowdin 객체를 명명하십시오: 문자열, 번역, TM, 용어집, 워크플로 단계, QA 검사, 작업, 보고서, 통합. 이 명사를 사용하여 고통을 한 문장으로 말할 수 있을 때 완료됩니다. 두 가지 해석이 다른 단계로 이어질 경우에만 한 가지 명확한 질문을 하십시오; 그렇지 않으면 더 그럴듯한 해석을 선택하고, 선택했다고 말한 다음 답변하십시오.
- 아래 맵에서 고통을 찾으십시오. 일치하는 항목은 단계와 전환을 제공합니다. 단계와 전환이 있거나 누락이 확인되면 완료됩니다.
- 누락된 경우, 위의 단계 2 테스트를 사용하여 가장 저렴한 것부터 스스로 사다리를 따라가십시오.
- 해당 단계가 필요한 경우에만 실시간 카탈로그를 참조하십시오.
references/catalogs.md에 방법이 나와 있습니다. 누락 시 단계 1: Crowdin 문서 색인. 단계 3: 일치하는 카테고리로 좁힌 스토어 색인, 그런 다음 하나 또는 두 개의 항목 파일을 전체 읽기. 태그라인은 앱을 간략히 설명합니다. 항목 파일만이 앱을 추천합니다. 명명하려는 것이 존재하고 주장하는 대로 작동한다고 확인될 때 완료됩니다. - 방법을 전달하십시오. 커넥터 액션은 객체 수준에 유지됩니다. CroQL 표현식, GraphQL 쿼리, 스크립트 또는 CLI 명령이 필요한 모든 것은 소유 스킬 이름으로 전달되어 여기서 재창조되지 않고 호출됩니다.
- 아래 형태로 답변하십시오.
답변 형태
먼저 해결책을 한두 문장으로 제시하십시오. 그런 다음 사용자에게 드는 비용: 무료, 설치 필요, 또는 빌드 필요. 그런 다음 단계 또는 전환. 단계 3 또는 4가 선택된 경우, 거부된 각각의 더 저렴한 단계에 대해 한 줄씩. 답변이 사용자의 에디션, 요금제 또는 프로젝트에서 이미 활성화된 기능에 따라 달라지는 경우, 추측하지 말고 그렇게 말하십시오. 카탈로그는 사용자 계정을 볼 수 없으며, 커넥터 없이 당신도 볼 수 없습니다.
안전장치
- 대량 변경은 먼저 개수와 확인을 받으십시오. 많은 문자열에 레이블 추가, 대량 승인, TM 정리, 항목 삭제: 영향을 받는 객체 수를 명시하고 확인을 기다리십시오. 사용자가 예상한 것보다 더 많이 일치하는 필터는 어시스턴트가 프로젝트를 손상시키는 일반적인 방법입니다.
- 카탈로그가 확인한 것만 명명하십시오. 스토어에 해당 고통에 대한 앱이 없으면 그렇게 말하고 단계 4 또는 "현재 불가능"으로 이동하십시오. 존재하지 않는 앱은 답이 없는 것보다 더 나쁩니다.
- 엔터프라이즈 전용은 그렇게 표시하십시오. 워크플로, 벤더, 팀 및 그룹은 Crowdin Enterprise에만 존재합니다. 이것이 답변일 때 그렇게 말하여 crowdin.com 사용자가 없는 메뉴를 찾지 않도록 하십시오.
맵
각 행은 문제군입니다: 사용자의 용어로 된 고통, 이를 해결하는 가장 저렴한 단계, 그리고 해야 할 일. "커넥터"는 Crowdin 커넥터 또는 API를 통한 액션을 의미하며, 객체 수준에서 설명됩니다. 스토어 앱을 명명하는 행은 이미 더 저렴한 단계가 고려되었으므로 카탈로그에서 앱을 확인하고 무엇을 추가하는지 말하십시오. 무언가가 "앱이다"라고 말하는 행은 더 저렴한 단계가 더 이상 충분하지 않은 지점을 표시합니다.
문자열 찾기, 편집 및 구성
| 고통 | 단계 | 수행 방법 |
|---|---|---|
| 특정 날짜 또는 릴리스 이후 변경되거나 새로 추가된 문자열 | 1 | 문자열 날짜에 대한 편집기 필터 또는 CroQL; 재사용해야 하는 경우 결과에 레이블 지정 |
| 여러 문자열에 한 번에 레이블 지정 | 2 | CroQL로 필터링, 레이블 일괄 추가; 소규모 집합: 편집기에서 다중 선택 |
| 번역자에게 도달하기 전 소스 복사본이 조잡함 | 1 | Enterprise: 소스 텍스트 리뷰 워크플로 단계; 기타: 번역 유지와 함께 소스에서 바꾸기; 반복적인 ML 검토는 앱 |
| 번역을 잃지 않고 소스 문자열 수정 또는 추가 | 2 | 번역 유지 옵션으로 문자열 일괄 편집; 단일 문자열: 편집기에서 편집 |
| 중복 문자열이 감지되지 않음 | 1 | 프로젝트 중복 전략; 파일 간 중복 찾기는 커넥터 |
| 새 파일을 일부 언어로만 번역해야 함 | 2 | 각 파일의 제외된 대상 언어 업데이트; 단일 파일: 파일 설정 |
| 이 문자열이나 용어가 모든 프로젝트에서 어디에 사용되는지 | 2 | 조직 전체 검색, 프로젝트별 목록 아님; TM당 TM 세그먼트 |
| 특정 문자열 하위 집합을 누군가에게 작업으로 전달 | 2 | 필터, 레이블, 해당 레이블로 필터링된 작업 생성 |
| 이해 관계자가 하위 집합을 스프레드시트 또는 이중 언어 문서로 필요로 함 | 2 | 필터, 언어별 번역 나열, 로컬 파일로 쓰기; 전체 파일: 번역 다운로드 |
| 개인 데이터가 번역용 파일에 포함됨 | 2 | 이메일 및 전화 패턴에 대한 소스 텍스트 CroQL, 일치 항목에 레이블 지정; 가져오기 시 차단은 앱 |
| 가져오기 시 문장이 잘못 분할됨 | 1 | 사용자 정의 세분화(SRX) 가져오기 옵션; 기존 파일 재가져오기는 커넥터; 규칙 작성은 앱 |
| 파일을 깔끔하게 가져오거나 내보낼 수 없음 | 1 | 먼저 파서 구성 및 가져오기 옵션; 파이프라인에서 콘텐츠 재작성은 앱 |
| 키가 플랫폼 간에 명명 규칙만 다름 | 3 | 스토어: 키 규칙 변환기; 기본적으로 키를 정규화하는 것은 없음 |
번역자용 컨텍스트
| 고통 | 단계 | 수행 방법 |
|---|---|---|
| 번역자가 문자열이 속한 화면을 볼 수 없음 | 1 | 자동 태깅이 있는 스크린샷; 대신 업로드 및 태깅은 커넥터; 라이브 디자인 임베드는 앱 |
| 웹 페이지 또는 문서 번역자가 렌더링된 결과를 볼 수 없음 | 1 | 컨텍스트 내 로컬라이제이션 및 편집기의 문서 미리보기; 비디오 타이밍은 앱 |
| 아무도 컨텍스트를 작성하지 않아 번역자가 추측함 | 2 | 빈 컨텍스트가 있는 문자열 나열, 코드베이스에서 의미 파생, 컨텍스트 일괄 편집; 터미널에서 crowdin-context-cli + context-extraction |
| 올바르게 번역하기에 충분한 컨텍스트가 없는 문자열 | 2 | 적용 범위: 파일당 빈 컨텍스트 필터 및 보고; 대규모 모델 판단은 앱 |
| 스프레드시트에 Crowdin이 가져오기 시 무시하는 컨텍스트 열이 있음 | 2 | 가져오기 후 원본 시트에서 문자열 컨텍스트 일괄 편집; 매 가져오기 시는 앱 |
| 참고 자료가 다른 도구에 있음 | 1 | 프로젝트 설명 및 파일 컨텍스트는 링크를 전달합니다; Crowdin 내부에 보드 렌더링은 앱 |
| ICU 복수형, JSON 또는 문자열 내 엔티티가 방해됨 | 1 | ICU 및 태그 QA 검사가 깨진 출력을 잡습니다; 문자열별 편집기 도우미는 앱 |
품질
| 고통 | 단계 | 수행 방법 |
|---|---|---|
| 번역이 조잡함: 구두점, 대소문자, 간격, 철자 | 1 | 프로젝트 설정에서 기본 QA 검사 활성화; 기존 번역 정리는 커넥터 |
| 숫자, 색상, 단축키, 이모지 또는 이스케이프 시퀀스가 누락되거나 변경됨 | 1 | 기본 변수, 태그, 특수 문자 검사; 다른 토큰 클래스: 일회성 감사는 커넥터, 실시간 플래깅은 스토어 QA 검사(Enterprise) |
| URL, 이메일, 날짜 또는 단위가 로컬라이즈되지 않고 복사됨 | 2 | 검토 후 언어별 번역 감사 및 대량 수정; 언어별 실시간 시행은 스토어 QA 검사 |
| 번역이 UI 요소 또는 캡션 타이밍에 맞지 않음 | 1 | 문자열별 최대 길이 및 길이 검사; 전체 파일 문자 예산은 커넥터; 초당 문자 수는 QA 검사 |
| QA 문제가 쌓이고 분류할 수 없음 | 2 | 언어별 QA 문제 나열, 유형별 그룹화, 거짓 긍정을 프로젝트 사전에 일괄 추가 |
| 동일한 소스가 프로젝트 전체에서 다르게 번역됨 | 2 | 언어별 동일 소스-다른 타겟 그룹 보고; 편집기 일관성 힌트는 제한된 언어 집합에 기본적으로 존재 |
| 로케일별 철자 또는 문법 오류가 누락됨 | 1 | 기본 맞춤법 검사 또는 조직 설정에서 맞춤법 검사 제공자; 입력 시 로케일 규칙 QA는 앱 |
| 번역에서 공격적이거나 정책에 어긋나는 표현 | 1 | 단어 목록이 있는 사용자 정의 QA 검사(Enterprise); 모든 새 번역을 판단하는 모델은 앱 |
| 내가 모르는 언어를 확인할 수 없음 | 2 | 주문형 제한된 샘플 역번역 또는 설명; 모든 내보내기가 역번역되는 것은 앱 |
| 인간 교정이 병목임 | 1 | 교정 워크플로 단계 및 작업; 제한된 검토 배치는 커넥터; AI로 모든 새 번역 검토는 앱 |
| 교정자가 무엇을 변경했는지 볼 수 없음 | 1 | 번역자별 정확도 보고서; 문자열별 이전/이후는 커넥터; 삭제는 프로젝트 활동에 있음 |
| LQA 모델에 대한 번역 품질 점수 | 3 | 스토어: Linguistic Quality Assurance(Enterprise); 주석은 편집기에 있음 |
| AI 도구에서 붙여넣은 것으로 의심되는 번역 | 3 | 스토어 AI 감지 보고서; 출처(번역을 생성한 사람 또는 엔진)는 커넥터 |
| 번역을 자체 규칙이나 톤에 맞게 확인 | 2 | 주문형 파일 또는 언어를 규칙에 대해 점검; 프로젝트 전체 및 반복 가능은 앱 |
| 인간 없이 안전하게 출시할 수 있는 MT 또는 AI 번역 | 3 | 스토어 품질 추정 앱; 기본 분류(MT 전용 번역 작업)는 커넥터 |
용어, TM 및 스타일
| 고통 | 단계 | 수행 방법 |
|---|---|---|
| 용어집이 비어 있거나 부족함 | 2 | 터미널에서 glossary-generation; 커넥터를 통해 소스 문자열에서 용어 제안 및 검토 후 추가 |
| 개발자가 방금 추가한 문자열을 용어집 및 TM과 일관되게 지금 번역하기를 원함 | 2 | 터미널에서 translate: 로컬 리소스 파일로 초안, 승인되지 않은 제안으로 업로드; 대량 작업은 사전 번역(crowdin-cli) |
| 용어집에 소스 용어는 있지만 번역이 없음 | 2 | 용어집 내보내기, 번역할 소스 파일로 업로드, 다시 가져오기 |
| 번역이 진행되는 동안 용어를 추가하거나 수정해야 함 | 2 | 개념 찾기, 용어 추가 또는 업데이트; 인라인으로 수행하는 번역가는 편집기 앱 필요 |
| 스타일 가이드가 없어 톤과 서식이 일관되지 않음 | 2 | 승인된 번역에서 규칙 추론, AI 지침으로 기본 스타일 가이드 작성 |
| 용어집 또는 스타일 가이드 변경 후 번역이 오래됨 | 1 | 알려진 용어 이름 변경: 번역에서 바꾸기, 또는 각각 검토가 필요할 때 CroQL 및 레이블; 스타일 규칙 또는 지속적인 모니터링은 앱 |
| MT 또는 AI가 용어집과 TM을 무시함 | 1 | 기본 AI 프롬프트는 이미 용어집, TM 및 형제 문자열을 수신함; DeepL은 DeepL 측 용어집을 준수함; DeepL에 용어 동기화는 앱 |
| 모든 프로젝트가 자체 TM과 용어집을 생성함 | 1 | 프로젝트 설정에서 공유 TM 및 용어집 할당; 분산된 것 병합은 커넥터; 프로젝트 생성 시 자동은 앱 |
| TM이 중복으로 비대해짐 | 3 | 스토어: TM Cleaner(백업 유지); 작은 TM은 내보내기 후 커넥터로 중복 제거 가능 |
| 전체 내보내기가 아닌 TM의 필터링된 조각이 필요함 | 2 | TM 레코드(날짜, 사용량, 작성자)에 대한 CroQL, CSV로 출력; 필터링되지 않은 경우: 기본 TM 다운로드 |
| 완료된 번역이 다른 프로젝트에서 사용할 수 있는 TM에 없음 | 1 | 여러 프로젝트에 할당된 하나의 TM; 파일 하위 집합의 TM은 커넥터 |
| 레거시 번역 문서 또는 TMX가 TM에 온전히 없음 | 1 | TMX, XLSX, CSV에 대한 기본 TM 업로드; 문서 쌍 정렬 또는 이전/다음 컨텍스트 보존은 앱 |
| 번역가가 편집기에서 외부 사전을 원함 | 1 | 용어집으로 용어베이스를 가져오면 기본적으로 표시됨; 실시간 외부 코퍼스는 앱 |
| AI가 번역가가 이미 수정한 실수를 계속 반복함 | 1 | Enterprise: AI Alignment가 인간 번역에서 용어집 항목 초안 작성; 기타: 승인된 번역과 AI 출력 비교 |
참조
references/catalogs.md– 사용 가능한 카탈로그 및 카테고리에 대한 가이드입니다.