콘텐츠로 이동

언어

언어는 이해의 장벽이 될 수 있습니다. Tuist가 가능한 많은 사람에게 접근 가능하도록 하고 싶습니다. Tuist가 아직 지원하지 않는 언어를 사용한다면, 영어 소스와 번역 파이프라인을 구동하는 로컬라이제이션 컨텍스트를 개선하여 Tuist가 해당 언어를 지원하도록 도울 수 있습니다.

언어 지원은 지속적인 노력이 필요하므로, 유지 관리를 도와줄 기여자가 있을 때 새로운 언어를 추가합니다. 현재 지원되는 언어는 다음과 같습니다:

  • 영어
  • 스페인어
  • 일본어
  • 조지아어
  • 한국어
  • 러시아어
  • 광둥어
  • 중국어(간체)
  • 중국어(번체)
새로운 언어 요청하기

Tuist가 새로운 언어를 지원하면 도움이 될 것이라고 생각한다면, 커뮤니티와 논의하기 위해 커뮤니티 포럼에 새 주제를 생성해 주세요.

도움 방법#

Tuist의 언어 지원은 리포지토리에서 관리됩니다. 기여자가 영어 소스와 번역 컨텍스트를 업데이트하면, 번역 파이프라인이 자동으로 로컬라이즈된 파일을 생성합니다.

워크플로는 다음과 같습니다:

  1. 영어 소스 콘텐츠를 업데이트합니다.
  2. 번역자가 더 많은 지침이 필요하다면 관련 L10N.md 컨텍스트를 업데이트합니다.
  3. 해당 소스 변경 사항을 포함하여 풀 리퀘스트를 엽니다.
  4. 변경 사항이 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에 언어별 지침