Transifex로 Bahmni를 번역하기 위한 개발자 노트

1. 영어 이외 언어의 번역은 OpenMRS 관리자가 OpenMRS 팀 아래에서 관리하는 Transifex 웹사이트의 Bahmni 프로젝트를 통해 진행해야 합니다. 개발팀은 모든 locale_en.json 파일을 관리하고 Transifex는 그 밖의 locale_<lang>.json 파일을 관리합니다. 새 메시지는 계속 소스 코드의 locale_en.json 파일에 추가해야 합니다. 기존 영어 메시지도 이전과 마찬가지로 소스 코드의 locale_en.json 파일에서 수정합니다.관련 문서: Bahmni project on the Transifex website

새 locale_<lang>.json 파일 집합이 있는 앱을 추가하면 Transifex도 구성해야 합니다. 아래 내용을 참조하십시오.

1. Bahmni Transifex 프로젝트는 OpenMRS 프로젝트 아래에 있습니다. 대부분의 어휘와 용어가 유사하므로 Bahmni와 OpenMRS 팀이 번역자를 공유하고 여러 OpenMRS 배포판에서 번역 제안을 공유할 수 있습니다. Bahmni Transifex 프로젝트 아래에는 locale_en.json 파일마다 하나씩 여러 리소스가 있습니다.

1. 번역을 언제 어떻게 검토하고 코드베이스로 가져올지 절차를 정의하고 문서화합니다. 검토된 번역을 자동으로 가져오도록 빌드 파이프라인을 구성합니다.

새 locale_<lang>.json 파일 집합이 있는 앱을 추가하면 Transifex에 새 리소스로 추가하고 코드베이스의 .tx/config 파일에도 추가해야 합니다.

먼저 Transifex에 리소스를 추가합니다. 이 작업에는 유지관리자 권한이 필요합니다.

1. https://www.transifex.com/openmrs/bahmni/content/ 로 이동해 Add Resource를 선택하고 초기 locale_en.json을 Key-Value JSON 파일로 업로드합니다. 새로 만든 리소스의 Settings에서 범주를 추가합니다. 예를 들어 핵심 Bahmni 애플리케이션의 일부라면 "core"를 사용합니다. https://www.transifex.com/openmrs/bahmni/content/ 로 돌아가 Auto Update Resources를 클릭하고 locale_en.json 파일의 "raw" GitHub 링크를 입력합니다.

다음으로 .tx/config 파일을 업데이트합니다. openmrs-module-bahmniapps 루트에서 Transifex 클라이언트 앱을 사용할 수 있습니다.관련 문서: transifex client

Transifex 클라이언트 앱을 꼭 사용할 필요는 없습니다. .tx/config에서 기존 리소스 설명을 복사하고 붙여 넣어 편집해도 됩니다.

그런 다음 변경 사항을 GitHub에 푸시합니다.

transifex.sh 스크립트는 번역할 소스 파일을 Transifex로 푸시하거나 번역된 파일을 Transifex에서 로컬 저장소로 가져오는 도구입니다.

Transifex CLI 스크립트를 사용하기 전에 다음 요구 사항을 충족하는지 확인합니다.

1. Transifex CLI: 스크립트를 사용하려면 Transifex CLI 도구가 설치되어 있어야 합니다. 설치되어 있지 않으면 스크립트가 자동으로 다운로드하여 설치합니다. 저장소에 Transifex 구성 파일(".tx/config")이 있어야 합니다. 이 파일에는 Transifex 프로젝트에 필요한 구성 설정이 포함되어야 합니다.

Transifex CLI 스크립트를 사용하려면 다음 단계를 따릅니다.

1단계: 스크립트 다운로드

스크립트를 로컬 저장소에 다운로드합니다. bahmni-infra-utils 저장소에서 스크립트 코드를 다운로드하여 "transifex.sh"처럼 ".sh" 확장자의 파일로 저장합니다.관련 문서: bahmni-infra-utils repository

2단계: 권한 설정

터미널에서 다음 명령을 실행하여 스크립트를 실행 가능하게 만듭니다.

3단계: 스크립트 실행

번역 소스 파일을 Transifex에 푸시하려면 "push" 인수로 스크립트를 실행합니다.

Transifex에서 번역을 가져오려면 "pull" 인수로 스크립트를 실행합니다.

참고: 스크립트 파일이 다른 디렉터리에 있다면 "./transifex.sh"를 실제 경로로 바꾸십시오.

• 로컬에서 Transifex 설정: https://developers.transifex.com/docs/cli. Transifex push 및 pull 스크립트는 bahmni-infra-utils 저장소를 참조하십시오. .tx/config 폴더가 있는 Bahmni 저장소 목록은 관련 링크를 참조하십시오. Transifex에서 가져오려면 tx pull -l <lang>을 실행합니다(https://developers.transifex.com/docs/cli#pulling-files-from-transifex 참조). GitHub Actions로 Transifex에 문자열 푸시를 자동화하려면 PR https://github.com/Bahmni/openmrs-module-bahmniapps/pull/707 을 참조하십시오. GitHub Actions로 매월 한 번 Transifex 번역을 가져오려면 PR https://github.com/Bahmni/openmrs-module-bahmniapps/pull/863 을 참조하십시오.