콘텐츠로 이동

언어

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

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

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

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

도움 주는 방법#

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

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

  1. 영어 소스 콘텐츠를 업데이트합니다.
  2. 번역자가 더 많은 지침이 필요하다면 관련 L10N.md 컨텍스트를 업데이트합니다.
  3. 해당 소스 변경 사항을 포함하여 풀 리퀘스트를 엽니다.
  4. 변경 사항이 main에 병합되면, Glossia는 변경된 부분을 번역하고 업데이트된 로컬라이즈된 파일로 번역 풀 리퀘스트를 열어 둡니다.
생성된 로컬라이즈 콘텐츠 수정 금지

생성된 로컬라이즈 콘텐츠를 직접 편집하지 마세요. 대신 영어 소스와 언어 컨텍스트를 업데이트하세요.

L10N.md 구조#

L10N.md 파일은 Glossia가 번역할 때 사용하는 컨텍스트를 정의합니다. 이를 디렉터리 수준별로 존재할 수 있는 범위가 지정된 언어 지침으로 생각하는 것이 가장 쉽습니다.

예를 들어:

plaintext
.
|-- L10N.md
|-- server
| |-- L10N.md
| |-- L10N
| | `-- es.md
| `-- priv
| `-- gettext
| `-- marketing.pot

디렉터리 컨텍스트#

Glossia는 리포지토리 루트에서 번역 대상 디렉터리까지 내려가며 해당 경로에서 발견하는 모든 L10N.md 파일을 결합합니다.

위 예시에서:

  • L10N.md는 전역적으로 적용됩니다.
  • server/L10N.md는 서버별 컨텍스트를 추가합니다.
  • server/L10N/es.md는 해당 영역에 대한 스페인어 전용 재정의 사항을 추가합니다.

즉, 컨텍스트를 적절한 위치에 배치할 수 있습니다:

  • 루트 디렉터리에 리포지토리 전체 지침
  • 하위 디렉터리에 영역별 지침
  • L10N/<locale>.md에 언어별 지침