UI 문자열 다국어화 internationalizing-ui-strings

Java 및 Javascript API를 사용하면 다음 유형의 리소스에서 문자열을 국제화할 수 있습니다.

국제화 및 현지화 프로세스에 대한 개요는 다음을 참조하십시오 구성 요소 다국어화.

Java 및 JSP 코드에서 문자열 다국어화 internationalizing-strings-in-java-and-jsp-code

다음 com.day.cq.i18n Java 패키지를 사용하면 UI에 현지화된 문자열을 표시할 수 있습니다. 다음 I18n 클래스는 get AEM 사전에서 현지화된 문자열을 검색하는 메서드입니다. 의 유일한 필수 매개 변수 get 메서드는 영어로 문자열 리터럴입니다. UI의 기본 언어는 영어입니다. 다음 예제에서는 단어를 현지화합니다 Search:

i18n.get("Search");

영어로 문자열을 식별하는 것은 ID가 문자열을 식별하고 런타임 시 문자열을 참조하는 데 사용되는 일반적인 국제 프레임워크와 다릅니다. 영어 문자열 리터럴을 사용하면 다음과 같은 이점이 있습니다.

사용자 언어 확인 determining-the-user-s-language

사용자가 선호하는 언어를 결정하는 방법에는 두 가지가 있습니다.

사용자 계정의 언어 속성은 신뢰할 수 있으므로 선호되는 방법입니다. 그러나 이 메서드를 사용하려면 사용자가 로그인해야 합니다.

I18n Java 개체 만들기 creating-the-i-n-java-object

I18n 클래스는 두 개의 생성자를 제공합니다. 사용자의 기본 언어를 결정하는 방법에 따라 사용할 생성자가 결정됩니다.

사용자 계정에 지정된 언어로 문자열을 표시하려면 가져온 후 다음 생성자를 사용하십시오 com.day.cq.i18n.I18n):

I18n i18n = new I18n(slingRequest);

생성자는 SlingHTTPRequest 사용자의 언어 설정을 검색하는 중입니다.

페이지 로케일을 사용하여 언어를 결정하려면 먼저 요청된 페이지의 언어에 대한 ResourceBundle을 가져와야 합니다.

Locale pageLang = currentPage.getLanguage(false);
ResourceBundle resourceBundle = slingRequest.getResourceBundle(pageLang);
I18n i18n = new I18n(resourceBundle);

문자열 다국어화 internationalizing-a-string

를 사용하십시오 get 의 방법 I18n 문자열을 국제화하는 개체입니다. 의 유일한 필수 매개 변수 get 메서드는 국제화할 문자열입니다. 이 문자열은 번역기 사전의 문자열에 해당합니다. get 메서드는 사전에서 문자열을 검색하고 현재 언어에 대한 번역을 반환합니다.

의 첫 번째 인수 get 메서드는 다음 규칙을 준수해야 합니다.

i18n.get("Enter a search keyword");

번역 힌트 사용 using-translation-hints

을(를) 지정합니다. 번역 힌트 사전에서 중복 문자열을 구분하기 위해 국제화된 문자열입니다. 의 두 번째 선택적 매개 변수를 사용합니다 get 번역 힌트를 제공하는 방법입니다. 번역 힌트는 사전에 있는 항목의 Comment 속성과 정확히 일치해야 합니다.

예를 들어 디시플레이션에 문자열이 포함되어 있습니다 Request 두 번: 한 번이면 동사이고 한 번이면 명사로 쓸 수 있다. 다음 코드에는 번역 힌트가 의 인수로 포함되어 있습니다 get 메서드:

i18n.get("Request","A noun, as in a request for a web page");

현지화된 문장에 변수 포함 including-variables-in-localized-sentences

현지화된 문자열에 변수를 포함하여 문장에 컨텍스트 의미를 구축합니다. 예를 들어, 웹 애플리케이션에 로그인하면 홈 페이지에 "Welcome back Administrator"라는 메시지가 표시됩니다. 받은 편지함에 메시지가 2개 있습니다." 페이지 컨텍스트는 사용자 이름과 메시지 수를 결정합니다.

사전에서로 지정하는 경우 변수는 대괄호로 묶인 색인으로 문자열로 표현됩니다. 변수의 값을 인수의 인수로 지정합니다. get 메서드를 사용합니다. 인수는 번역 힌트 다음에 배치되며 색인은 인수의 순서에 해당합니다.

i18n.get("Welcome back {0}. You have {1} messages.", "user name, number of messages", user.getDisplayName(), numItems);

국제화 문자열 및 번역 힌트는 사전의 문자열과 주석과 정확히 일치해야 합니다. 지역화 힌트를 생략하려면 null 값을 두 번째 인수로서 반환합니다.

정적 Get 메서드 사용 using-the-static-get-method

다음 I18N 클래스는 정적 정의 get 적은 수의 문자열을 현지화해야 할 때 유용한 방법입니다. 개체의 매개 변수 외에도 get 메서드를 사용하는 경우 정적 메서드는 SlingHttpRequest 개체 또는 ResourceBundle 사용 중인 사용자(사용자의 선호 언어를 결정하는 방법에 따라)를 지정합니다.

Javascript 코드에서 문자열 다국어화 internationalizing-strings-in-javascript-code

Javascript API를 사용하여 클라이언트에서 문자열을 현지화할 수 있습니다. 과 함께 Java 및 JSP 코드에서 Javascript API를 사용하면 현지화, 현지화 힌트 제공 및 현지화된 문자열에 변수를 포함할 문자열을 식별할 수 있습니다.

다음 granite.utils 클라이언트 라이브러리 폴더 는 Javascript API를 제공합니다. API를 사용하려면 페이지에 이 클라이언트 라이브러리 폴더를 포함하십시오. 지역화 함수는 Granite.I18n 네임스페이스.

현지화된 문자열을 제공하기 전에 Granite.I18n.setLocale 함수 위에 있어야 합니다. 함수에는 인수로 로케일의 언어 코드가 필요합니다.

Granite.I18n.setLocale("fr");

현지화된 문자열을 제공하려면 Granite.I18n.get 함수:

Granite.I18n.get("string to localize");

다음 예제에서는 문자열 "Welcome back"을 국제화 합니다.

Granite.I18n.setLocale("fr");
Granite.I18n.get("string to localize", [variables], "localization hint");

함수 매개 변수는 Java I18n.get 메서드와 다릅니다.

다음 예제에서는 Javascript를 사용하여 "Welcome back Administrator"를 현지화합니다. 받은 편지함에 메시지가 2개 있습니다." 문장:

Granite.I18n.setLocale("fr");
Granite.I18n.get("Welcome back {0}. You have {1} new messages in your inbox.", [username, numMsg], "user name, number of messages");

JCR 노드에서 문자열 다국어화 internationalizing-strings-from-jcr-nodes

UI 문자열은 종종 JCR 노드 속성을 기반으로 합니다. 예: jcr:title 페이지의 속성은 일반적으로 페이지의 컨텐츠로 사용됩니다 h1 요소를 생성하지 않습니다. 다음 I18n 클래스는 getVar 이러한 문자열을 현지화하는 방법입니다.

다음 JSP 스크립트는 jcr:title 저장소에서 속성을 설정하고 페이지에 현지화된 문자열을 표시합니다.

<% title = properties.get("jcr:title", String.class);%>
<h1><%=i18n.getVar(title) %></h1>

JCR 노드에 대한 번역 힌트 지정 specifying-translation-hints-for-jcr-nodes

과 유사함 Java API의 번역 힌트를 지정하면 사전에서 중복 문자열을 구분하는 번역 힌트를 제공할 수 있습니다. 번역 힌트를 국제화된 속성을 포함하는 노드의 속성으로 제공합니다. 힌트 속성의 이름은 국제화된 속성 이름과 _commentI18n 접미사:

${prop}_commentI18n

예: cq:page 노드에는 현지화 중인 jcr:title 속성이 포함되어 있습니다. 힌트는 jcr:title_commentI18n이라는 속성의 값으로 제공됩니다.

국제화 적용 범위 테스트 testing-internationalization-coverage

UI에서 모든 문자열을 국제화했는지 테스트합니다. 가리킬 문자열을 보려면 사용자 언어를 zz_ZZ로 설정하고 웹 브라우저에서 UI를 엽니다. 국제화된 문자열은 다음 형식으로 stub 변환이 표시됩니다.

USR_*Default-String*_尠

다음 이미지는 AEM 홈 페이지의 stub 번역을 보여 줍니다.

사용자의 언어를 설정하려면 사용자 계정에 대한 환경 설정 노드의 언어 속성을 구성합니다.

사용자의 환경 설정 노드에는 다음과 같은 경로가 있습니다.

/home/users/<letter>/<hash>/preferences