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

URL 로케일 선택기 ([로케일]):

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

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

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

afAcceptLang 요청 매개 변수:

사용자의 브라우저 로케일을 재정의하려면 afAcceptLang 매개 변수가 포함된 랜딩 페이지 URL의 매개 변수, URL의 매개 변수, URL의 매개 변수, URL의 매개 변수, URL의 매개 변수, URL의 매개 변수, URL의 매개 변수 등이 포함될 수 있습니다.

예: 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 포함) 다음을 찾을 수 있습니다. <appid> 의 AEM 프로젝트용 archetype.properties 파일.

  

• 새 파일: 파일이 없는 경우 위에 언급된 동일한 위치에 파일을 만들어야 합니다. 복사한 후 이 문서의 파일 이름을 붙여넣지 말고 수동으로 이름을 입력합니다. 파일 이름 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. 사용 코드 목록 원하는 언어를 나타내는 두 글자로 된 코드를 찾습니다.

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 언어의 텍스트, 날짜 및 기타 요소 서식을 지정하는 방법에 대한 참조를 제공합니다. 샘플 로케일 파일을 찾을 수 있습니다.

• 아랍어
• 히브리어
• 페르시아어

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

로케일 파일 만들기:

1. 내에 새 .json 파일 만들기 i18n 디렉토리.
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).

<?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에 새 폴더 포함:

다음 위치로 이동 /ui.content/src/main/content/meta-inf/vault/filter.xml 파일 위치: [AEMaaCS 프로젝트 디렉터리].

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

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

파일을 저장합니다.