핵심 구성 요소 기반 적응형 양식의 로케일 추가 supporting-new-locales-for-adaptive-forms-localization

URL 로캘 선택기([로캘]):

시스템은 [locale] 선택기를 사용하여 URL 내에 지정된 로케일의 우선 순위를 지정합니다. 이 형식을 사용하면 캐싱의 성능을 높일 수 있습니다.

형식: URL은 http:/[AEM Forms 서버 URL]/content/forms/af/[afName] 형식을 따릅니다.[locale].html?wcmmode=disabled.

예: https://[server]/content/forms/af/contact-us.hi.html은 힌디어로 양식을 렌더링합니다.

afAcceptLang 요청 매개 변수:

사용자의 브라우저 로캘을 재정의하려면 URL에서 afAcceptLang 매개 변수를 사용할 수 있습니다.

예: https://[server]/forms/af/survey.ca-fr.html?afAcceptLang=ca-fr은 양식이 캐나다 프랑스어로 렌더링되도록 합니다.

사용자의 브라우저 로케일(Accept-Language 헤더):

다른 로케일을 지정하지 않으면 AEM Forms에서는 Accept-Language 헤더를 사용하여 보낸 사용자의 브라우저 로케일을 고려합니다.

명령줄 또는 터미널 창을 엽니다.

저장소를 저장할 컴퓨터에서 원하는 위치(예: /adaptive-forms-core-components)로 이동합니다.

다음 명령을 실행하여 저장소를 복제합니다.

git clone https://github.com/adobe/aem-core-forms-components.git

이 명령은 저장소를 다운로드하고 컴퓨터에 aem-core-forms-components 폴더를 만듭니다. 이 안내서에서는 이 폴더를 [Adaptive Forms Core Components repository](으)로 참조합니다.

명령줄을 열고 AEM as a Cloud Service 저장소를 저장할 디렉터리(예: /cloud-service-repository/)를 선택합니다.

아래 명령을 실행하여 저장소를 복제합니다.

git clone https://git.cloudmanager.adobe.com/<organization-name>/<program id>/

Git 저장소를 복제하려면 다음 정보가 필요합니다.

• 조직 이름: Adobe Experience Manager as a Cloud Service(AEM as a Cloud Service) 내에서 팀이나 프로젝트를 식별합니다.

• 프로그램 ID: 리포지토리와 연결된 프로그램을 지정합니다.

• 자격 증명: 저장소에 안전하게 액세스하려면 사용자 이름과 암호(또는 개인 액세스 토큰)가 필요합니다.

이 정보를 찾을 수 있는 위치

이러한 세부 정보를 찾는 방법에 대한 단계별 지침은 Adobe Experience League 문서 "Git 액세스"를 참조하십시오.

프로젝트가 준비되었습니다!

명령이 성공적으로 완료되면 로컬 디렉터리에 새 폴더가 생성됩니다. 이 폴더의 이름은 프로그램 이름을 따라 지정합니다(예: program-id). 이 폴더에는 AEM as a Cloud Service Git 저장소에서 다운로드한 모든 파일과 코드가 포함되어 있습니다.

이 안내서에서는 이 폴더를 [AEMaaCS project directory](으)로 지칭합니다.

편집기에서 저장소 폴더를 엽니다.

Guide Localization Service.cfg.json 파일을 찾습니다. 이 파일은 AEM Forms 애플리케이션에서 지원하는 로케일을 제어합니다. 이 파일을 편집하여 새 로케일을 추가할 수 있습니다.

• 기존 파일: 파일이 이미 있는 경우 AEM Forms 프로젝트 디렉터리 내에서 해당 파일을 찾습니다. 일반적인 위치는 다음과 같습니다.

  code language-shell
  [AEMaaCS project directory]/ui.config/src/main/content/jcr_root/apps/<appid>/osgiconfig/config`.

  <appid>을(를) 프로젝트별 앱 ID로 바꾸십시오. archetype.properties 파일에서 AEM 프로젝트에 대한 <appid>을(를) 찾을 수 있습니다.

  

• 새 파일: 파일이 없는 경우 위에서 언급한 동일한 위치에 파일을 만들어야 합니다. 복사한 후 이 문서의 파일 이름을 붙여넣지 말고 수동으로 이름을 입력합니다. 파일 이름 Guide Localization Service.cfg.json에 공백이 포함되어 있습니다. 이는 의도적인 것이며 설명서에 오타가 아닙니다.

  지원되는 OOTB 로케일 목록이 있는 샘플 파일은 다음과 같습니다.

  code language-none
  { "supportedLocales":[ "en", "fr", "de", "ja", "pt-br", "zh-cn", "zh-tw", "ko-kr", "it", "es" ] }

원하는 언어의 로케일 코드를 파일에 추가합니다.

1. ISO 639-1 코드 목록을 사용하여 원하는 언어를 나타내는 두 자리 코드를 찾으십시오.

2. Guide Localization Service.cfg.json 파일에 로케일 코드를 포함합니다. 다음은 몇 가지 예입니다.

   • 왼쪽에서 오른쪽 언어:

     • 영어(미국): en-US
     • 스페인어(스페인): es-ES
     • 프랑스어(프랑스): fr-FR

   • 오른쪽에서 왼쪽 쓰기 언어:

     • 아랍어(아랍에미리트): ar-ae
     • 히브리어: he(또는 historical reference)
     • Farsi: fa

변경 후 Guide Localization Service.cfg.json 파일의 형식이 올바른 JSON 파일로 지정되어 있는지 확인하십시오. JSON 형식 지정 시 오류가 발생하여 제대로 작동하지 않을 수 있습니다. 파일을 저장합니다.

샘플 클라이언트 라이브러리를 찾습니다.

[적응형 Forms 핵심 구성 요소 저장소]의 로컬 복사본 내에서 다음 경로로 이동합니다.

    /aem-core-forms-components/it/apps/src/main/content/jcr_root/apps/forms-core-components-it/clientlibs

라이브러리를 복사하여 붙여넣습니다.

1. clientlib-it-custom-locale 폴더를 복사합니다.

   

2. [AEMaaCS 프로젝트 디렉터리] 내에서 다음 디렉터리로 이동합니다.

   code language-none
   /ui.apps/src/main/content/jcr_root/apps/<app-id>/clientlib

   중요: <app-id>을(를) 응용 프로그램의 실제 ID로 바꾸십시오.

3. 복사한 clientlib-it-custom-locale 폴더를 이 디렉터리에 붙여 넣습니다.

   

로케일 디렉토리로 이동합니다.

[AEMaaCS project directory] 내에서 다음 경로로 이동합니다.

    /ui.apps/src/main/content/jcr_root/apps/<program-id>/clientlibs/clientlib-it-custom-locale/resources/i18n/

중요: <program-id>을(를) 실제 응용 프로그램 ID로 바꾸십시오.

샘플 영어 언어 파일을 찾습니다.

AEM Forms은 GitHub에 샘플 영어 로케일 파일(.json)을 제공합니다.

영어 파일에는 참조용 기본 문자열 집합이 포함되어 있습니다. 로케일별 파일은 영어 파일의 구조를 모방해야 합니다.

아랍어, 히브리어, 페르시아어와 같은 언어의 경우, 영어와 같이 왼쪽에서 오른쪽으로(LTR) 대신 오른쪽에서 왼쪽으로(RTL) 텍스트를 읽습니다. 양식이 이러한 언어로 올바르게 표시되도록 하려면 샘플 로케일 파일을 안내서로 사용하는 것이 좋습니다. 이러한 파일은 RTL 언어의 텍스트, 날짜 및 기타 요소 서식을 지정하는 방법에 대한 참조를 제공합니다. 샘플 로케일 파일을 찾을 수 있습니다.

• 아랍어
• 히브리어
• Farsi

이러한 샘플 파일을 활용하면 양식이 RTL 언어로 작업하는 사용자에게 원활한 경험을 제공할 수 있습니다.

로케일 파일 만들기:

1. i18n 디렉터리 내에 새 .json 파일을 만듭니다.
2. 원하는 언어에 적합한 로케일 코드를 사용하여 파일의 이름을 지정합니다(예: 프랑스어의 경우 fr-FR.json, 아랍어의 경우 ar-ae.json). 이 파일의 구조는 영어 로케일 파일을 미러링해야 합니다.

구조 및 번역:

1. 텍스트 편집기에서 새로 만든 파일을 엽니다.

2. 영어 값을 대상 언어에 해당하는 번역으로 바꿉니다.

3. 문자열 번역이 완료되면 파일을 저장합니다.

구성 폴더를 찾습니다.

[AEMaaCS 프로젝트 디렉터리]에서 다음 디렉터리로 이동합니다.

/ui.content/src/main/content/jcr_root/etc

필요한 폴더를 만듭니다(누락된 경우).

etc 폴더가 jcr_root 폴더 내에 없는 경우 만드십시오. etc에서 languages(이)라는 다른 폴더가 없는 경우 폴더를 만드십시오.

로케일 구성 파일을 만듭니다.

languages 폴더 내에서 이름이 .content.xml인 새 파일을 만듭니다. 복사한 후 이 문서의 파일 이름을 붙여넣지 말고 수동으로 이름을 입력합니다.

인 새 파일을 만듭니다.

이 파일을 열고 다음 내용을 붙여 넣어 실제 로케일 코드(예: 아랍어의 경우 ar-ae)로 [LOCALE_CODE]을(를) 바꿉니다.

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:jcr="http://www.jcp.org/jcr/1.0" xmlns:nt="http://www.jcp.org/jcr/nt/1.0"
      jcr:primaryType="nt:unstructured"
      languages="[de,es,fr,it,pt-br,zh-cn,zh-tw,ja,ko-kr,hi]"/>

경고: 기존 목록을 바꾸지 마십시오. 대신 새 로케일 코드를 대괄호 안에 넣고 다음과 같이 쉼표로 구분합니다(예: ar-ae 사용).

languages="[de,es,fr,it,pt-br,zh-cn,zh-tw,ja,ko-kr,hi,ar-ae]"

filter.xml에 새 폴더 포함:

[AEMaaCS 프로젝트 디렉터리]에서 /ui.content/src/main/content/meta-inf/vault/filter.xml 파일로 이동합니다.

파일을 열고 끝에 다음 줄을 추가합니다.

<filter root="/etc/languages"/>

아래에 추가합니다.

파일을 저장합니다.