지역화된 언어
Logto는 다양한 사전 정의된 언어를 지원하며, 추가로 113개의 언어 태그를 제공합니다. 이 강력한 도구를 통해 로그인 경험을 사용자 정의하고, 자신의 언어 옵션과 번역을 생성하고 관리할 수 있습니다.
Logto Console 에서의 사용자 정의 단계
코딩 없이 Logto Console 에서 언어 설정을 쉽게 사용자 정의하세요.
- 이동 경로: Console > Sign-in experience > Content > Languages.
- 언어 관리: "Manage language" 버튼을 클릭하여 언어 라이브러리에 접근하세요.
- 기존 언어 편집: Logto에서 제공하는 언어의 번역을 사용자 정의하세요. 이 언어들은 삭제할 수 없지만, 변경 사항은 기본 값을 덮어씁니다.
- 새로운 언어 추가: "Add language" 버튼을 클릭하고, 언어 태그를 선택한 후 번역을 제공하고, 변경 사항을 저장하여 새로운 언어를 추가하세요.
- 자동 감지 활성화: 활성화되면, 사용자의 기기 설정에 따라 사용자의 선호 언어로 로그인 페이지를 자동으로 표시합니다.
- 기본 언어 설정: 언어 라이브러리에서 기본 언어를 선택할 수 있습니다. 감지된 사용자 언어가 현재 언어 라이브러리에 포함되지 않은 경우 사용됩니다.
언어를 관리할 때 이해해야 할 몇 가지 주요 용어는 다음과 같습니다:
| 정의 | 설명 |
|---|---|
| 언어 태그 | 언어 태그는 콘텐츠의 언어를 식별합니다. 언어 태그는 언어 코드 (예: en, fr, zh)와 국가 / 지역 코드 (예: US, UK, KR)로 구성되며 하이픈으로 구분됩니다. 언어 태그는 다음과 같이 보입니다: en-US. |
| Logto 제공 언어 | Logto 제공 언어는 Logto 공식 언어이며 Logto 원본 코드 베이스에 저장됩니다. |
| 추가된 언어 | 추가된 언어는 사용자가 추가한 언어입니다. |
| Logto 소스 값 | Logto 소스 값은 사용자가 사용자 정의하지 않은 Logto에서 제공한 값입니다. |
| 사용자 정의 값 | 사용자 정의 값은 사용자가 이미 사용자 정의한 값입니다. Logto 소스 값이 덮어씌워집니다. |
Management API 를 사용한 사용자 정의
Management API PUT /api/custom-phrases/{languageTag}를 사용하여 언어 번역을 사용자 정의할 수 있습니다. API 요청 본문은 다음과 같은 부분적 로케일 객체입니다:
{
"input": { "username": "Username", "password": "Password" },
"secondary": {
"social_bind_with": "Already had an account? Sign in to link {{methods, list(type: disjunction;)}} with your social identity."
},
"action": { "sign_in": "Sign in" },
"error": {
"general_required": "{{types, list(type: disjunction;)}} is required"
},
"list": { "or": "or" },
"user_scopes": {
"descriptions": { "custom_data": "Your custom data" }
}
}
모든 사용자 정의 가능한 콘텐츠를 보려면 소스 코드를 참조하세요.
또한 PATCH /api/sign-in-exp API 를 사용하여 언어 감지 정책을 제어할 수 있습니다.
사용 사례
추가된 언어가 최종 고객에게 어떻게 나타날까요?
예를 들어, 기본 언어가 영어이고 자동 감지가 켜져 있는 웹사이트가 있다고 가정해봅시다. 일본에서 온 사용자가 귀하의 사이트를 방문하여 계정을 만들기로 결정합니다. 그 / 그녀가 일본어를 앱 언어로 사용하지만 Logto가 아직 해당 언어를 지원하지 않는 경우, 로그인 화면은 영어로 나타납니다.
Logto 로그인 경험 i18n은 사용자 정의된 언어를 가능하게 합니다.
ja 언어 태그를 클릭하여 자신의 일본어 번역을 추가하세요.
이렇게 하면 일본에서 귀하의 사이트에 접속하는 사용자가 방금 영어에서 번역한 일본어로 콘텐츠를 읽을 수 있게 됩니다.
자주 묻는 질문
내가 추가한 언어가 Logto 제공 언어가 되면 어떻게 되나요?
왼쪽의 언어 태그 옆에 Logto 제공 태그가 나타나며, 추가한 언어는 더 이상 제거할 수 없게 됩니다. 수정된 값은 계속 작동하며 원래 Logto 값을 대체합니다. 사용자 제공 값을 지우면 Logto의 기본 구성에서 제공하는 값을 사용할 수 있습니다.
사용자 정의 값을 몇 개만 추가했다면 어떻게 되나요?
최종 사용자가 보는 것은 두 열이 병합된 결과입니다. Logto가 제공한 원본 콘텐츠 복사본의 일부만 조정하고 싶다고 가정해봅시다. 귀하의 가입 화면과 Logto가 제공한 화면의 유일한 차이점은 편집한 키일 것입니다. 나머지 콘텐츠는 변경되지 않습니다.
관련 리소스
애플리케이션에서 아랍어 및 RTL (오른쪽에서 왼쪽으로) 언어 레이아웃 지원