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

버전
문서 링크
기초 구성 요소
여기 클릭
핵심 구성 요소
이 문서

오른쪽에서 왼쪽 쓰기 언어 지원 기능은 얼리어답터 프로그램에서 사용할 수 있습니다. 공식 이메일 ID에서 aem-forms-ea@adobe.com에 작성하여 얼리어답터 프로그램에 참여하고 기능에 대한 액세스를 요청할 수 있습니다.

AEM Forms은 영어(en), 스페인어(es), 프랑스어(fr), 이탈리아어(it), 독일어(de), 일본어(ja), 포르투갈어-브라질어(pt-BR), 중국어(zh-CN), 중국어-대만(zh-TW) 및 한국어(ko-KR) 로케일을 즉시 지원합니다. 힌디어(hi_IN)와 같은 더 많은 로케일에 대한 지원을 추가할 수도 있습니다. 이러한 로케일을 추가하여 적응형 Forms을 아랍어, 페르시아어, 우르두어 등과 같은 RTL(오른쪽에서 왼쪽으로 쓰기) 언어로 표시할 수도 있습니다.

적응형 양식에 대해 선택한 로케일은 어떻게 됩니까?

적응형 Forms에 대한 로케일 추가를 시작하기 전에 적응형 양식에 대해 로케일이 선택되는 방법에 대한 이해를 구축하십시오. 적응형 양식이 렌더링될 때 해당 로케일을 식별하고 선택하는 두 가지 방법이 있습니다.

  • 사용 locale URL의 선택기: 적응형 양식을 렌더링할 때 시스템은 다음을 검사하여 요청된 로케일을 식별합니다 [로케일] 적응형 양식 URL의 선택기. URL은 http:/ 형식을 따릅니다.[AEM Forms 서버 URL]/content/forms/af/[afName].[로케일].html?wcmmode=disabled. 사용 [로케일] 선택기를 사용하여 적응형 양식을 캐싱할 수 있습니다. (예: URL) www.example.com/content/forms/af/contact-us.hi.html?wcmmmode=disabled 힌디어로 양식을 렌더링합니다.

  • 아래 나열된 순서대로 매개 변수를 검색합니다.

    • 사용 afAcceptLang요청 매개 변수: 사용자의 브라우저 로케일을 재정의하려면 afAcceptLang 요청 매개 변수를 전달할 수 있습니다. 예를 들어 https://'[server]:[port]'/<contextPath>/<formFolder>/<formName>.html?wcmmode=disabled&afAcceptLang=ca-fr URL은 AEM Forms 서버가 캐나다 프랑스어 로케일로 양식을 렌더링하도록 강제합니다.

    • 브라우저 로케일 사용(Accept-Language 헤더): 시스템은 를 사용하여 요청에 지정된 사용자의 브라우저 로케일도 고려합니다. Accept-Language 머리글입니다.

    요청된 로케일에 대한 클라이언트 라이브러리(라이브러리를 만들고 사용하는 프로세스는 이 문서의 뒷부분에서 다룹니다)를 사용할 수 없는 경우 시스템에서 로케일 내 언어 코드에 대한 클라이언트 라이브러리가 있는지 확인합니다. 예를 들어 요청된 로케일이 en_ZA (남아프리카 영어) 및 클라이언트 라이브러리가 없습니다. en_ZA, 적응형 양식은 사용 가능한 경우 en(영어)용 클라이언트 라이브러리를 사용합니다. 둘 다 검색되지 않는 경우 적응형 양식은 다음에 대한 사전을 찾습니다. en 로케일.

    로케일이 식별되면 적응형 양식은 해당 양식 특정 사전을 선택합니다. 요청된 로케일에 대한 사전을 찾을 수 없는 경우 기본적으로 적응형 양식이 작성된 언어의 사전을 사용합니다.

    로케일 정보를 사용할 수 없는 경우 적응형 양식은 양식 개발 중에 사용되는 언어인 원래 언어로 표시됩니다

사전 요구 사항 prerequistes

로케일 추가를 시작하기 전에

  • 보다 쉬운 편집을 위해 일반 텍스트 편집기(IDE)를 설치합니다. 이 문서의 예제는 다음을 기반으로 합니다 Microsoft® Visual Studio 코드.

  • 버전 설치 Git: 컴퓨터에서 사용할 수 없는 경우 입니다.

  • 복제 적응형 Forms 핵심 구성 요소 리포지토리. 저장소를 복제하려면 다음을 수행하십시오.

    1. 명령줄 또는 터미널 창을 열고 저장소를 저장할 위치로 이동합니다. 예, /adaptive-forms-core-components

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

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

    저장소에는 로케일을 추가하는 데 필요한 클라이언트 라이브러리가 포함되어 있습니다.

    명령이 성공적으로 실행되면 저장소가 aem-core-forms-components 컴퓨터의 폴더입니다. 이 문서의 나머지 부분에서 폴더는 다음과 같이 표시됩니다. [적응형 Forms 핵심 구성 요소 저장소].

로케일 추가 add-localization-support-for-non-supported-locales

새 로케일에 대한 지원을 추가하려면 다음 단계를 수행합니다.

저장소에 로케일 추가

1. AEM as a Cloud Service Git 저장소 복제 clone-the-repository

  1. 명령줄을 열고 AEM Forms as a Cloud Service 저장소를 저장할 디렉터리(예: /cloud-service-repository/.

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

    code language-shell
    git clone https://git.cloudmanager.adobe.com/<my-org>/<my-program>/
    

    바꾸기 <my-org><my-program> 조직 이름과 프로그램 이름이 있는 위의 URL에서. 조직 이름, 프로그램 이름 또는 Git 저장소의 전체 경로와 저장소 복제에 필요한 자격 증명을 얻는 방법에 대한 자세한 지침은 를 참조하십시오. Git 액세스 기사.

    명령을 성공적으로 완료하면 폴더가 <my-program> 이(가) 만들어졌습니다. 여기에는 Git 저장소에서 복제된 콘텐츠가 포함됩니다. 문서의 나머지 부분에서 폴더는 다음과 같이 표시됩니다. [AEM Forms as a Cloud Service Git repository].

2. 가이드 현지화 서비스에 새 로케일 추가 add-a-locale-to-the-guide-localization-service

  1. 이전 섹션에서 복제된 저장소 폴더를 일반 텍스트 편집기에서 엽니다.

  2. 다음 위치로 이동 [AEM Forms as a Cloud Service Git repository]/ui.config/src/main/content/jcr_root/apps/<appid>/osgiconfig/config 폴더를 삭제합니다. 다음을 찾을 수 있습니다. <appid> 다음에서 archetype.properties 프로젝트의 파일입니다.

  3. 편집할 [AEM Forms as a Cloud Service Git repository]/ui.config/src/main/content/jcr_root/apps/<appid>/osgiconfig/config/Guide Localization Service.cfg.json 페이지를 엽니다. 파일이 없으면 만듭니다. 지원되는 로케일이 있는 샘플 파일은 다음과 같습니다.

    샘플 안내서 Localization Service.cfg.json

  4. 추가 언어의 로케일 코드 예를 들어 힌디어에 대해 'hi'를 추가합니다.

  5. 파일을 저장하고 닫습니다.

3. 로케일을 추가할 클라이언트 라이브러리 만들기

AEM Forms은 새 로케일을 쉽게 추가하는 데 도움이 되는 샘플 클라이언트 라이브러리를 제공합니다. 을(를) 다운로드하고 추가할 수 있습니다. clientlib-it-custom-locale 클라이언트 라이브러리 [적응형 Forms 핵심 구성 요소 저장소] GitHub에서 Forms as a Cloud Service 저장소로 이동합니다. 클라이언트 라이브러리를 추가하려면 다음 단계를 수행합니다.

  1. 을(를) 엽니다 [적응형 Forms 핵심 구성 요소 저장소] 를 입력합니다. 복제된 저장소가 없는 경우 전제 조건 저장소 복제 지침
  2. 다음 위치로 이동 /aem-core-forms-components/it/apps/src/main/content/jcr_root/apps/forms-core-components-it/clientlibs 디렉토리.
  3. 다음을 복사합니다. clientlib-it-custom-locale 디렉토리.
  4. 다음으로 이동 [AEM Forms as a Cloud Service Git repository]/ui.apps/src/main/content/jcr_root/apps/moonlightprodprogram/clientlibs 및 붙여넣기 clientlib-it-custom-locale 디렉토리.

4. 로케일별 파일 만들기 locale-specific-file

  1. 다음으로 이동 [AEM Forms as a Cloud Service Git repository]/ui.apps/src/main/content/jcr_root/apps/<program-id>/clientlibs/clientlib-it-custom-locale/resources/i18n/
  2. 를 찾습니다. GitHub의 영어 로케일 .json 파일제품에 포함된 최신 기본 문자열 세트가 들어 있습니다.
  3. 특정 로케일에 대한 .json 파일을 만듭니다.
  4. 새로 만든 .json 파일에서 영어 로케일 파일의 구조를 미러링합니다.
  5. .json 파일의 영어 문자열을 해당 언어에 해당하는 현지화된 문자열로 바꿉니다.
  6. 파일을 저장하고 닫습니다.

5. 로케일 지원을 사전에 추가합니다 add-locale-support-for-the-dictionary

다음 경우에만 이 단계를 수행하십시오. <locale> 을(를) 추가하고 있는 이(가) 다음에 없습니다. en, de, es, fr, it, pt-br, zh-cn, zh-tw, ja, ko-kr.

  1. [AEM Forms as a Cloud Service Git repository]/ui.content/src/main/content/jcr_root/etc/ 폴더로 이동합니다.

  2. 만들기 etc 폴더 jcr_root 폴더가 아직 없는 경우 입니다.

  3. 폴더 만들기 languages 다음 아래에 etc 폴더가 아직 없는 경우 입니다.

    대체 텍스트

  4. 만들기 .content.xml 파일 아래 languages 폴더를 삭제합니다. 파일에 다음 내용을 추가합니다.

    code language-xml
    <?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]"/>
    
  5. 로케일 코드를 languages 속성. 예를 들어 다음 예제 코드에 hindi에 대한 hi가 추가되었습니다.

    code language-xml
    <?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]"/>
    
  6. 새로 만든 폴더를 filter.xml 아래에 /ui.content/src/main/content/meta-inf/vault/filter.xml 다음으로:

    code language-none
    <filter root="/etc/languages"/>
    

    에서 생성된 폴더 추가 아래에

6. 변경 사항을 커밋하고 파이프라인을 배포합니다. commit-changes-in-repo-deploy-pipeline

새 로케일을 추가한 후 GIT 저장소에 변경 사항을 커밋합니다. 전체 스택 파이프라인을 사용하여 코드를 배포합니다. 학습 파이프라인 설정 방법 새 로케일 지원을 추가합니다.

파이프라인 실행이 완료되면 새로 추가된 로케일을 사용할 수 있습니다.

새로 추가된 로케일이 있는 적응형 양식 미리 보기 use-added-locale-in-af

새로 추가된 로케일을 사용하여 적응형 양식을 미리 보려면 다음 단계를 수행하십시오.

  1. AEM Forms as a Cloud Service 인스턴스에 로그인합니다.
  2. 다음으로 이동 Forms > Forms 및 문서.
  3. 적응형 양식을 선택하고 사전 추가사전을 번역 프로젝트에 추가 마법사가 나타납니다.
  4. 다음을 지정합니다. 프로젝트 제목 및 선택 타겟 언어 드롭다운 메뉴 아래의 사전을 번역 프로젝트에 추가 마법사.
  5. 클릭 완료 생성된 번역 프로젝트를 실행합니다.
  6. 적응형 양식을 선택하고 HTML으로 미리 보기.
  7. 추가 &afAcceptLang=<locale-name> 를 입력합니다.
  8. 페이지를 새로 고치면 적응형 양식이 지정된 로케일로 렌더링됩니다.

새로운 현지화 기능 지원을 위한 모범 사례 best-practices

  • Adobe은 적응형 양식을 만든 후 번역 프로젝트를 만들 것을 권장합니다.

  • 기존 적응형 양식에 새 필드를 추가하는 경우:

    • 기계 번역용: 사전을 다시 만들고 번역 프로젝트 실행. 번역 프로젝트를 만든 후 적응형 양식에 추가된 필드는 번역되지 않은 상태로 유지됩니다.
    • 사람 번역용: 의 UI를 사용하여 사전을 내보냅니다. [AEM Forms Server]/libs/cq/i18n/gui/translator.html. 새로 추가된 필드의 사전을 업데이트하고 업로드합니다.

더 보기

추가 참조 see-also

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab