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