언어
언어는 이해의 장벽이 될 수 있습니다. Tuist가 가능한 많은 사람에게 접근 가능하도록 하고 싶습니다. Tuist가 아직 지원하지 않는 언어를 사용한다면, 영어 소스와 번역 파이프라인을 구동하는 로컬라이제이션 컨텍스트를 개선하여 Tuist가 해당 언어를 지원하도록 도울 수 있습니다.
언어 지원은 지속적인 노력이 필요하므로, 유지 관리를 도와줄 기여자가 있을 때 새로운 언어를 추가합니다. 현재 지원되는 언어는 다음과 같습니다:
- 영어
- 스페인어
- 일본어
- 조지아어
- 한국어
- 러시아어
- 광둥어
- 중국어(간체)
- 중국어(번체)
새로운 언어 요청하기
Tuist가 새로운 언어를 지원하면 도움이 될 것이라고 생각한다면, 커뮤니티와 논의하기 위해 커뮤니티 포럼에 새 주제를 생성해 주세요.
도움 방법#
Tuist의 언어 지원은 리포지토리에서 관리됩니다. 기여자가 영어 소스와 번역 컨텍스트를 업데이트하면, 번역 파이프라인이 자동으로 로컬라이즈된 파일을 생성합니다.
워크플로는 다음과 같습니다:
- 영어 소스 콘텐츠를 업데이트합니다.
- 번역자가 더 많은 지침이 필요하다면 관련
L10N.md컨텍스트를 업데이트합니다. - 해당 소스 변경 사항을 포함하여 풀 리퀘스트를 엽니다.
- 변경 사항이
main에 병합되면, 번역 워크플로가 대상.po파일을 다시 생성하고 번역된 업데이트를 포함하여 후속 풀 리퀘스트를 엽니다.
생성된 로컬라이즈된 콘텐츠 수정 금지
생성된 로컬라이즈된 콘텐츠를 직접 편집하지 마세요. 대신 영어 소스와 언어 컨텍스트를 업데이트하세요.
L10N.md 구조#
L10N.md 파일은 번역 모델로 전송되는 컨텍스트를 정의합니다. 이를 이해하는 가장 쉬운 방법은 다양한 디렉터리 수준에 존재할 수 있는 범위 지정된 언어 지침으로 생각하는 것입니다.
예를 들어:
plaintext
.
|-- L10N.md
|-- server
| |-- L10N.md
| |-- L10N
| | `-- es.md
| `-- priv
| `-- gettext
| `-- marketing.pot
디렉터리 컨텍스트#
번역 스크립트는 리포지토리 루트에서 번역 대상 디렉터리까지 이동하며 해당 경로에서 발견되는 모든 L10N.md 파일을 결합합니다.
위의 예시에서:
L10N.md는 전역적으로 적용됩니다.server/L10N.md는 서버별 컨텍스트를 추가합니다.server/L10N/es.md는 해당 영역에 대한 스페인어 전용 재정의 사항을 추가합니다.
즉, 컨텍스트를 적절한 위치에 배치할 수 있습니다:
- 루트 디렉터리에 리포지토리 전체 지침
- 하위 디렉터리에 영역별 지침
L10N/<locale>.md에 언어별 지침