언어 변수 지원

AEM Guides에서는 언어 변수를 사용하는 기능을 제공합니다. 언어 변수를 사용하여 PDF 출력에서 지역화된 문자열을 정의하거나 출력 템플릿에서 정적 텍스트를 지역화할 수 있습니다. CSS 스타일을 사용하여 CSS에서 오는 문자열을 현지화할 수 있습니다.

PDF 출력에서 언어 변수 사용

언어 변수를 사용하여 Note, Caution 및 Warning과 같은 기본 제공 레이블이나 PDF 출력의 정적 텍스트의 지역화된 버전을 정의할 수 있습니다. 변수 이름은 모든 언어에 대해 동일하지만 다양한 언어에 대해 다른 값을 가질 수 있습니다. 이러한 변수의 값을 하나 이상의 언어로 업데이트할 수 있으며 현지화된 값은 PDF 출력에서 자동으로 선택됩니다.

예를 들어 다음과 같은 방법으로 레이블을 표시할 수 있습니다 Note PDF 출력에서:

  • 영어: 참고

  • 프랑스어: Remarque

  • 독일어: Hinweis

언어 변수가 포함된 문서에 대한 출력

영어, 프랑스어 및 독일어 샘플 노트입니다.

NOTE
변수에 대한 값이 특정 언어로 정의되지 않은 경우 AEM Guides는 UI(애플리케이션의 사용자 인터페이스) 언어에서 문자열을 대체 메커니즘으로 선택합니다.
UI의 언어로 값을 정의하지 않은 경우 영어(en_us), 아니면 영어(en) 값을 지정하고 PDF 출력에 동일한 값을 표시합니다.

언어 변수 유형

AEM Guides에서는 응용 프로그램 변수와 사용자 변수의 두 가지 유형을 지원합니다.

애플리케이션 변수

AEM Guides는 사전 정의된 애플리케이션 변수 또는 기본 애플리케이션 변수 집합을 제공합니다. 사전 정의된 이러한 변수를 사용하여 AEM Guides와 관련된 문서에 대한 정보를 추가할 수 있습니다. 예를 들어 chapter-number 변수에 가 포함되어 있으면 페이지가 속한 챕터 번호가 표시됩니다. 다음 author-label 변수는 문서 작성자의 이름을 표시합니다.

NOTE
응용 프로그램 변수의 값을 재정의할 수 있습니다.

사용자 변수

새 언어 변수를 만들 수도 있습니다. 예를 들어 문서에 대한 게시자 레이블에 대해 사용자 변수 Publisher를 만들 수 있습니다.

NOTE
사용자 변수를 만들고 응용 프로그램 변수를 편집하려면 관리 권한이 있어야 합니다.

언어 변수 창

선택한 언어에 대한 언어 변수를 추가하고 봅니다.

새 언어 변수 추가

  1. 웹 편집기에서 출력 탭으로 이동합니다.

  2. 선택 언어 변수 {width="25"} 왼쪽 패널에서

  3. 선택 편집 을(를) 열려면 언어 변수 창. 선택한 언어에 있는 응용 프로그램 및 사용자 변수는 알파벳 순서로 나열됩니다. 선택한 언어에 따라 값이 표시됩니다. 예를 들어 프랑스어를 선택하면 "Tip"이 "Conseil"로 표시됩니다.

  4. 다음에서 언어 드롭다운에서 변수를 편집할 언어를 선택합니다.

    note note
    NOTE
    원하는 언어를 볼 수 없는 경우 언어 변수 설정. 설정 선택 {width="25"} 을(를) 열려면 언어 변수 설정 대화 상자.
  5. 에 변수 이름을 입력합니다. 이름 열 및 열 값 열.

    note note
    NOTE
    모든 HTML 콘텐츠를 변수 값으로 사용하여 특정 서식으로 변수 값을 표시할 수 있습니다. 예를 들어 다음을 추가할 수 있습니다 <b> 을 변수 값에 태깅하여 게시자를 굵게 표시합니다.
  6. 선택 언어 변수 추가 {width="25"} 를 클릭하여 선택한 언어에 새 언어 변수를 추가합니다. 한 언어에 변수를 추가하면 모든 언어에 자동으로 추가됩니다. 기존 변수와 이름이 같은 변수는 만들 수 없습니다. 오류가 표시됩니다.

NOTE
을 선택하지 않는 경우 언어 변수 추가: 변수가 만들어지지 않고 목록에 추가됩니다

언어 변수 내보내기 및 가져오기

Experience Manager 안내서에서는 선택한 언어로 된 언어 변수를 내보내고 가져올 수 있도록 지원합니다. 정의된 값과 함께 모든 언어 변수를 쉽게 내보낼 수 있습니다. 여기에는 애플리케이션 변수와 사용자 변수가 모두 포함됩니다. 내보낸 파일을 사용하여 값을 원하는 대로 변경하거나 다른 언어로 현지화하십시오.

언어 변수가 포함된 XML 파일을 가져올 수도 있습니다. Experience Manager 안내서는 응용 프로그램 변수와 사용자 변수를 모두 포함하여 이미 정의된 언어 변수만 가져옵니다. 아직 정의되지 않은 변수는 가져오지 않습니다.

언어 변수 내보내기

언어의 언어 변수를 내보내려면 드롭다운에서 언어를 선택하고 을 선택합니다 내보내기 내보내기 아이콘 {width="25"}.
이 형식은 XML 파일을 만듭니다 language_variable_<ln> 위치 <ln> 는 선택한 언어의 코드입니다. 예를 들어, language_variable_en.xml 영어 및 language_variable_fr.xml 프랑스어.

NOTE
언어 변수에 저장되지 않은 변경 사항이 있으면 내보낼 수 없습니다. 변경 사항을 저장하여 활성화됨 보기 내보내기 가져오기 아이콘 {width="25"} 아이콘.

언어 변수 가져오기

언어 변수를 가져오려면 다음을 수행하십시오.

  1. 드롭다운에서 언어를 선택하고 가져오기 {width="25"}
  2. 언어 변수가 포함된 XML을 찾아 선택합니다. 예: language_variable_en.xml.
    다음 형식으로 XML 파일을 가져올 수 있습니다.
<?xml version="1.0" encoding="UTF-8"?>
<variables>
<variable id="note-important">Important: </variable>
<variable id="note-caution">Avertir: </variable>
<variable id="image-with-text">Text and image &lt;img src=&quot;/content/dam/assets/images/image_with_text.png&quot; /&gt; </variable>
</variables>

파일을 가져오면 ID가 동일한 변수를 가져옵니다. 선택한 언어의 변수 값은 XML 파일의 변수 값으로 업데이트됩니다. 업데이트된 변수 수에 대한 메시지가 표시됩니다.

NOTE
  • 파일이 XML 파일이 아니거나 파일에 언어 변수와 매핑되지 않는 잘못된 형식이 포함되어 있으면 XML 파일에 문제가 있다는 오류가 표시됩니다. >
  • 파일에 동일한 ID를 가진 변수가 없으면 가져온 파일에 일치하는 언어 변수가 없다는 경고가 표시됩니다.

언어 변수 옵션

변수를 마우스로 가리키면 옵션 메뉴 판

언어 변수의 옵션 메뉴

사용​ 옵션 ​언어 변수를 삭제, 미리보기 또는 복제하는 메뉴입니다.

응용 프로그램 변수와 사용자 변수를 모두 미리 볼 수 있습니다. 변수의 값이 출력에 표시되는 방식을 보려면 을 선택합니다. 미리 보기 다음에서 옵션 선택한 변수의 메뉴입니다.
다음을 선택할 수도 있습니다. 삭제 또는 복제 사용자 변수. 한 언어에서 변수를 삭제하면 모든 언어에서 자동으로 삭제됩니다.

응용 프로그램 변수 편집 또는 되돌리기

응용 프로그램 변수의 값을 편집할 수도 있습니다. 나중에 응용 프로그램 변수를 원래 값으로 되돌릴 수 있습니다. 변수 되돌리기 {width="25"} 변경된 값이 있는 응용 프로그램 변수에 대해 나타납니다.

출력 템플릿에서 언어 변수 사용

현지화된 문서에 언어 변수를 추가해야 합니다. 현지화된 문서의 여러 페이지에 표시되는 페이지 레이아웃 내에 이러한 언어 변수를 삽입할 수 있습니다. 예를 들어 의 언어 변수를 추가할 수 있습니다. author-name 페이지 레이아웃의 머리글 영역(또는 바닥글이나 본문 같은 다른 부분)에 나타납니다.

pdf의 페이지 레이아웃

프랑스어용으로 생성된 PDF 출력에 현지화된 작성자 및 브랜드 이름.

와 같은 언어 변수를 삽입하려면 copyright-label 헤더 영역에서 다음 단계를 수행합니다.

  1. 편집에 필요한 페이지 레이아웃을 엽니다.

    note note
    NOTE
    보기 페이지 레이아웃 사용자 지정 사용자 지정 또는 편집을 위한 페이지 레이아웃을 열기 위한 섹션입니다.
  2. 변수를 삽입하도록 활성화하려면 헤더를 선택합니다.

  3. 선택 변수 삽입 {width="25"} 을 클릭합니다.

  4. 다음에서 변수 삽입 팝업에서 삽입할 언어 변수의 이름을 선택하고 삽입 을 눌러 헤더 영역에 삽입합니다.

    note note
    NOTE
    텍스트 상자에 검색 문자열을 입력할 수도 있습니다. 주어진 문자열을 포함하는 변수 이름은 필터링되고 목록에 표시됩니다.
    선택한 언어 변수가 헤더 영역에 삽입됩니다.

헤더 영역에 변수 삽입

다음 copyright-label 이(가) 헤더 영역에 추가되었습니다.

언어 변수에 콘텐츠 스타일 적용

언어 변수에 지정하는 값 외에 HTML 태그를 사용하여 특정 서식으로 변수 값을 표시할 수도 있습니다. 예를 들어 의 값을 publisher-label 굵게.

  • 다음을 사용하여 값의 스타일 서식을 지정할 수도 있습니다. 태그에 가깝게 배치하십시오. 예를 들어 페이지 번호 언어 변수를 사용하여 영어의 로마 숫자 형식으로 페이지 번호를 표시하고 다른 언어의 형식을 지정할 수 있습니다.

    영어 값:
    <span data-field="page-number" data-format="upper-roman">1</span>

    타밀에 대한 값:
    <span data-field="page-number" data-format="tamil">1</span>

마찬가지로 언어 변수를 추가하고 페이지 레이아웃의 필드 삽입 기능에 나열된 다른 필드의 서식을 지정할 수 있습니다. 필드 추가에 대한 자세한 내용은 필드 및 메타데이터 추가.

  • 값에 현지화된 이미지를 추가할 수도 있습니다. 예를 들어 장 번호 언어로 이미지 아이콘을 추가하고 PDF 출력에 아이콘의 현지화된 이미지를 가져올 수 있습니다.

    영어의 경우 이미지에 대한 변수 값은 다음과 같습니다 <img src="banner-en.jpg">, 그리고 독일어의 동일한 변수에 대해 다음과 같을 수 있습니다. <img src="banner-de.jpg">. 그래서 언어에 따라 이미지를 포착합니다.

CSS 스타일을 사용하여 문자열 현지화

CSS 스타일을 사용하여 장, 섹션, 그림, 표 등 일련 번호에 사용된 문자열을 현지화할 수도 있습니다. 이러한 문자열은 CSS 파일에서 가져오므로 언어 변수를 사용하여 현지화할 수 없습니다. 이러한 문자열을 현지화하려면 현지화할 각 언어의 CSS 스타일을 만들 수 있습니다.
예를 들어 다음 CSS를 사용하여 챕터 접두어와 해당 숫자 형식을 다양한 언어로 표시할 수 있습니다.
예를 들어 다음 CSS를 사용하여 독일어로 챕터를 Hoofdstuk로 표시하고 소수점 형식으로 챕터 번호를 표시할 수 있습니다. 일본어의 경우 일본어 숫자 형식을 사용하여 목차에 챕터 번호를 표시할 수 있습니다.

// for English
h1:before {
  counter-increment: h11;
  content: "Chapter " counter(h11, decimal)".";
}

// for German
:root:lang(de) h1:before {
  content: "Hoofdstuk " counter(h11, decimal)".";
}

// for Japanese
:root:lang(ja) h1:before {
  content: "章 " counter(h11, japanese-formal)".";
}

다음 스크린샷은 독일어 및 일본어 PDF 출력으로 현지화된 문자열을 표시합니다.

언어 변수가 있는 일본어 출력 언어 변수가 있는 독일어 출력

접두어 서식 지정

CSS 스타일을 사용하여 접두사의 서식을 지정할 수도 있습니다. 예를 들어 레이블 형식을 지정할 수 있습니다 Note 다양한 언어의 PDF 출력에 빨간색으로 표시.

.note .prefix-content
{
color: red;
}
recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178