UI 문자열 및 i18n

UI 문자열은 제품 콘텐츠 번역과 별개입니다. 제품 콘텐츠는 투어, 타일, 이벤트에 사용할 내용을 운영 담당자가 작성합니다. 버튼, 내비게이션, 오류 메시지를 포함한 애플리케이션 문구는 제품 인터페이스 텍스트로 관리합니다.

인터페이스 문구의 작동 방식

Scoutello는 공통 내비게이션, 대시보드 레이블, 게스트 앱 레이블, 마케팅 페이지 등 화면 영역별로 인터페이스 문구를 구성합니다. 이를 통해 각 경험에 필요한 텍스트에 집중할 수 있습니다.

인터페이스 문자열이 누락되면 검토 과정에서 문제를 확인할 수 있어야 합니다. 그래야 게스트나 운영 담당자에게 노출되기 전에 문구를 수정할 수 있습니다.

문구 그룹

문구 그룹을 사용하면 언어 관련 작업에 집중할 수 있습니다.

• 모든 곳에서 재사용되는 공통 기본 문구
• 대시보드 전용 문구
• 게스트 앱 전용 문구
• 성능을 위해 패키지를 분리하는 것이 유리한 경우의 마케팅 또는 랜딩 페이지 전용 번들

문구 추가 또는 변경

새 인터페이스 문구에는 안정적인 번역 키와 중립적인 표현을 사용해야 합니다. 키 추가에 관한 엔지니어링 세부 사항은 내부 온보딩 문서에서 다루며, 공개 문서에서는 예상되는 문구 결과를 설명해야 합니다.

팀에서 내부적으로 따르는 지침은 다음과 같습니다.

• 키를 동적으로 구성하지 않습니다. 정적 분석에서 리터럴 키를 확인할 수 있어야 합니다.
• 번역된 문장을 이어 붙이는 대신 보간 플레이스홀더를 사용합니다.
• 성 중립적인 표현을 사용합니다.
• 독일어 문구에서는 비격식적인 직접 호칭을 피하여 다양한 대상에게 중립적인 어조를 유지합니다.

워크스페이스 자동화는 문구가 변경된 후 로케일 번들이 서로 일치하도록 유지합니다.

UI 문구와 제품 콘텐츠의 차이

• 게시된 페이지에서 게스트가 읽는 운영 담당자 작성 값 → 제품 번역 워크플로
• 애플리케이션 자체에 속하는 레이블 → UI 문자열 워크플로
• 문장이 혼합된 경우 UI 번역에는 고정된 문법을 유지하고, 작성자가 입력한 이름이나 숫자는 변수로 전달합니다.

관련 개념: 번역 작동 방식, 자동 번역, 언어 및 로컬라이제이션.