HitKeep i18n
이 스킬은 HitKeep에서 사용자에게 보이는 대시보드 텍스트나 로케일별 형식을 변경할 때 사용합니다.
HitKeep의 대시보드는 UI 사본에 Transloco JSON 파일을 사용하고, 로케일 인식 형식 지정을 위해 @jsverse/transloco-locale과 브라우저 Intl API를 사용합니다. PrimeNG 라벨은 활성 Transloco 언어에서 동기화됩니다.
공개 표면
대시보드 번역 파일은 다음 위치에 있습니다.
frontend/dashboard/public/i18n/en.jsonfrontend/dashboard/public/i18n/de.jsonfrontend/dashboard/public/i18n/es.jsonfrontend/dashboard/public/i18n/fr.jsonfrontend/dashboard/public/i18n/it.jsonfrontend/dashboard/public/i18n/nl.jsonfrontend/dashboard/public/i18n/pt.json
대시보드는 현재 다음 언어 ID를 노출합니다.
en, de, es, fr, it, nl, pt
형식 로케일 매핑은 frontend/dashboard/src/app/app.config.ts에 구성되어 있습니다.
en -> en-US
de -> de-DE
es -> es-ES
fr -> fr-FR
it -> it-IT
nl -> nl-NL
pt -> pt-BR
Angular 로케일 도우미만으로 새로운 지원 언어를 유추하지 마십시오. Transloco 구성, 로케일 JSON 파일, 형식 매핑 및 제품 문서가 모두 일치하는 경우에만 지원되는 대시보드 언어를 추가하거나 변경하십시오.
워크플로
- 새 키를 만들기 전에 기존 기능 키를 검색합니다.
- 사용자에게 표시되는 Angular 템플릿 텍스트는
TranslocoPipe뒤에 배치합니다. - TypeScript에서 계산된 라벨에는
TranslocoService를 사용합니다. - 동일한 키 경로를 7개 로케일 JSON 파일 모두에 추가합니다.
- 키 이름을 의미론적으로 유지하고 기능별로 그룹화합니다.
- 보간 변수를 정확히 유지합니다. 변수 이름을 번역하거나 플레이스홀더 구문을 변경하지 마십시오.
- 계산된 옵션 라벨의 경우 활성 언어에 의존하여 언어 전환 후 라벨이 다시 계산되도록 합니다.
- 날짜, 숫자, 백분율 및 기간의 경우 수동 문자열 형식 지정 대신 기존 로케일 서비스 또는 도우미를 선호합니다.
- PrimeNG 로케일 텍스트는 하드코딩된 컴포넌트 라벨 대신 기존 동기화 서비스를 통해 흐르도록 합니다.
- 버튼, 탭, 칩, 테이블 열 및 모바일 레이아웃에 맞게 라벨을 충분히 짧게 유지합니다.
검사할 유용한 위치:
frontend/dashboard/src/app/app.config.tsfrontend/dashboard/src/app/transloco-loader.tsfrontend/dashboard/src/app/core/i18n/frontend/dashboard/scripts/check-i18n-locales.mjsfrontend/dashboard/scripts/sync-i18n-locales.mjs
번역 품질 기준
개별 영어 단어가 아닌 제품 UI를 번역합니다.
- 독일어: 자연스러운 제품 독일어와
Ä,Ö,Ü,ä,ö,ü,ß와 같은 올바른 문자를 사용합니다. - 스페인어: 악센트,
ñ, 필요한 경우 여는 구두점(예:¿Seguro?)을 사용합니다. - 프랑스어: 악센트와 아포스트로피를 자연스럽게 사용합니다(예:
paramètres,sécurité,l'adresse e-mail). - 이탈리아어: 필요한 경우 악센트를 사용하며, 특히
attività,città,perché,può,è와 같은 끝 강세 단어에 사용합니다. - 네덜란드어: 대시보드 용어를 자연스럽고 간결하게 유지합니다. 사이트, 팀, 목표, 퍼널, 공유 링크 및 API 클라이언트에 대해 기존 용어를 재사용합니다.
- 포르투갈어: 제품이 명시적으로 로케일 대상을 변경하지 않는 한 기존 브라질 포르투갈어 형식 컨텍스트(
pt-BR)를 사용합니다. 올바른 악센트를 사용하여 자연스러운 포르투갈어를 사용합니다.
모든 언어에서 분석 용어를 일관되게 유지합니다. 저장소에 이미 "사이트", "팀", "이벤트", "목표", "퍼널", "공유 링크", "API 클라이언트", "QR 캠페인" 또는 "기회"에 대한 용어가 있는 경우 이를 재사용합니다.
검사
번역 변경 후 로케일 검사를 실행합니다.
cd frontend/dashboard && npm run i18n:check
키 형태 변형이 의심되는 경우 동기화 스크립트를 실행하고 결과 변경 사항을 검토한 후 유지합니다.
cd frontend/dashboard && node scripts/sync-i18n-locales.mjs
대시보드 파일에 대한 형식 검사를 실행합니다.
cd frontend/dashboard && npm run fmt:check
언어 전환에 의존하는 UI 동작의 경우 해당 동작을 소유한 컴포넌트 또는 서비스 근처에 집중된 테스트를 추가하거나 업데이트합니다.
리뷰용 출력
i18n 변경을 보고할 때 다음을 포함합니다.
변경된 키:
- <키 경로>
업데이트된 로케일:
- en, de, es, fr, it, nl, pt
검사:
- <명령어 및 결과>
주의 사항:
- <레이아웃, 표현 또는 리뷰 노트>
실제로 발생하지 않은 경우 번역이 원어민에 의해 검토되었다고 주장하지 마십시오.