키는 소프트웨어 코드 내에서 번역 가능한 텍스트 문자열을 식별하는 데 사용됩니다. 이것은 키(번역 가능한 문자열의 코드 이름)를 사용하여 문자열의 각 필요한 번역이 아닌 한 번만 Phrase에서 참조할 수 있게 합니다.
키는 프로젝트의 서로 다른 언어 로캘에 해당하는 여러 번역과 연결될 수 있습니다. 이 기능은 관계형 데이터베이스의 기본 키와 유사하며, 번역은 키의 속성입니다. 키는 리소스 파일에 저장되며 소스 및 대상 언어를 식별하는 데 사용됩니다.
키를 사용하면 로컬라이제이션 관리 플랫폼이 코드를 제시하지 않고도 번역자에게 번역 가능한 텍스트를 제공할 수 있습니다.
키는 일반적으로 프로젝트에 추가할 필요가 없으며, 리소스 파일이 프로젝트 페이지의 탭을 통해 업로드될 때 이상적으로 생성됩니다.
키가 업로드되거나 생성되지 않도록 하려면 차단 키 기능을 사용하십시오. 차단된 키가 이미 존재하는 경우, 편집기에서 번역할 수 없습니다.
키를 내보내기에서 제외하려면 키 제외 기능을 사용하십시오. 제외된 키는 편집기에서 번역할 수 없습니다.
프로젝트의 키는 프로젝트 페이지의 섹션 또는 문자열 편집기 창 상단에서 더 보기/키 복제를 선택하여 복제할 수 있습니다.
하나 이상의 프로젝트에서 동일한 값을 가진 서로 다른 번역 키는 콘텐츠 업데이트를 자동화하기 위해 연결될 수 있습니다. 연결된 키는 프로젝트 간의 일관성을 보장하고 동일한 콘텐츠에 대한 반복 작업을 제거하는 데 사용됩니다.
키에 대한 변경 사항은 문자열 편집기의 사이드바 활동 창에서 되돌릴 수 있습니다.
참고
리포지토리(GitHub, GitLab 등)와 작업할 때 키를 삭제하면, 키는 Phrase와 리포지토리 모두에서 삭제되어야 영구적으로 삭제됩니다. 이는 Phrase 또는 리포지토리에서의 오류나 사고로 인해 키가 우발적으로 삭제되는 것을 방지하기 위함입니다.
문자열에서 키는 업로드된 파일의 형식에 따라 다양한 유형일 수 있습니다:
-
문자열(기본)
참고
번역가는 옵션이 고급 프로젝트 설정에서 활성화되지 않는 한 문자열 키만 편집할 수 있습니다.
-
정렬
-
부울
-
Markdown
-
번호
키 유형은 섹션의 편집자 사이드바에 표시됩니다.
키 이름은 하나의 프로젝트 내에서 고유해야 합니다.
키 이름을 지정하는 여러 전략이 있습니다:
키가 업로드되지 않은 경우 수동으로 생성할 수 있습니다.
키를 생성하려면 다음 단계를 따르십시오:
편집기 또는 탭에서 키를 삭제하면 해당 키의 모든 관련 번역이 삭제되며 복구할 수 없습니다.
10,000개 이상의 키가 있는 프로젝트에서는 언급되지 않은 키가 추가 업로드에서 계산되지 않습니다. 언급되지 않은 키는 현재 업로드에 포함되지 않지만 여전히 프로젝트에 존재하는 키입니다.
차단은 전체 키가 프로젝트에 추가되는 것을 방지합니다. 차단된 키의 이름이 업로드된 파일에 나타나면 해당 키는 생략되고 프로젝트에 추가되지 않습니다.
차단은 프로젝트에서 키를 생략하여 전혀 관리되지 않도록 하는 데 사용됩니다.
일반적으로 차단된 키:
-
날짜 및 시간 형식 문자열.
-
구성을 포함하는 키.
-
Phrase gem으로 관리할 때 문제를 일으키는 키.
처리되거나 유지 관리되지 않는 별도의 언어 파일에서 차단된 키를 관리합니다.
이 키는 문제를 일으킬 수 있으며, 사용되는 경우 프로젝트가 생성될 때 차단해야 합니다.
-
activemodel.errors* -
숫자.형식* -
숫자.통화* -
number.percentage* -
datetime.prompts*
키를 차단하려면 다음 단계를 따르세요:
-
프로젝트 페이지에서 탭을 선택합니다.
-
차단된 키 목록에 키 추가를 클릭합니다.
창이 열립니다.
-
키의 이름 또는 정규 표현식 (regex)을 제공하고 저장을 클릭합니다.
키가 목록에 추가됩니다.
키는 나중에 클릭하여 수정하거나
삭제할 수 있습니다.
일부 키는 특정 언어에서 제외해야 할 수 있으며 제외된 것으로 표시할 수 있습니다. 이 키는 업로드되어 프로젝트 내에 존재하지만 무시됩니다.
제외된 번역은 다음과 같습니다:
-
관련 언어의 내보내기에서 제외됩니다.
-
관련 언어 보고서에서 제외됩니다.
내용이 비어 있으면 번역되지 않은 것으로 계산되지 않습니다.
-
번역 편집기에서 보이지만 편집할 수 없습니다.
제외 옵션:
-
번역 편집기에서 언어 내의 단일 번역을 제외합니다.
-
번역 편집기에서 언어 내의 여러 번역을 제외합니다.
-
키를 생성하거나 편집할 때 언어를 선택하여 여러 번역을 제외합니다.
키를 제외하려면 다음 단계를 따르십시오:
키는 편집자 키 목록에서 개별적으로 또는 대량으로 제외할 수 있으며, 키를 선택하고 메뉴를 사용하면 됩니다.