페이지 템플릿

페이지를 만들 때 템플릿을 선택해야 합니다. 페이지 템플릿은 새 페이지의 기반으로 사용됩니다. 템플릿은 결과 페이지의 구조, 초기 콘텐츠 및 사용할 수 있는 구성 요소(디자인 속성)를 정의합니다. 여기에는 다음과 같은 몇 가지 이점이 있습니다.

• 페이지 템플릿을 사용하면 전문 작성자는 다음과 같은 작업을 수행할 수 있습니다 템플릿 만들기 및 편집.
  • 이러한 전문 작성자를 라고 합니다. 템플릿 작성자
  • 템플릿 작성자는 의 멤버여야 합니다. template-authors 그룹입니다.
• 페이지 템플릿에서 만든 모든 페이지에 대한 동적 연결은 유지됩니다. 이렇게 하면 템플릿에 대한 모든 변경 사항이 페이지 자체에 반영됩니다.
• 페이지 템플릿 을 사용하면 페이지 구성 요소를 보다 일반적으로 사용할 수 있으므로 맞춤화 없이 핵심 페이지 구성 요소를 사용할 수 있습니다.

페이지 템플릿을 사용하면 페이지를 만드는 조각이 구성 요소 내에서 격리됩니다. UI에서 필요한 구성 요소 조합을 구성할 수 있으므로 각 페이지 변형에 대해 새로운 페이지 구성 요소를 개발할 필요가 없습니다.

이 문서는

• 페이지 템플릿 만들기에 대한 개요를 제공합니다.
• 편집 가능한 템플릿을 만드는 데 필요한 관리/개발자 작업에 대해 설명합니다.
• 편집 가능한 템플릿의 기술 정보를 설명합니다
• AEM이 템플릿의 가용성을 평가하는 방법을 설명합니다.

새 템플릿 만들기

페이지 템플릿 만들기는 주로 템플릿 콘솔 및 템플릿 편집기 템플릿 작성자에 의해 제어됩니다. 이 섹션은 이 프로세스에 대한 개요를 제공하며 다음 기술 수준에서 발생하는 사항에 대한 설명을 제공합니다.

편집 가능한 템플릿을 만들 때 다음 작업을 수행하십시오.

1. 만들기 템플릿용 폴더. 이 작업은 필수는 아니지만 모범 사례에 권장됩니다.

2. 선택 템플릿 유형. 이 은(는) 다음을 만들기 위해 복사됩니다. 템플릿 정의.

   노트

   다양한 템플릿 유형이 즉시 제공됩니다. 다음을 수행할 수도 있습니다. 사이트별 템플릿 유형 만들기 필요한 경우.

3. 새 템플릿의 구조, 콘텐츠 정책, 초기 콘텐츠 및 레이아웃을 구성합니다.

   구조

   • 이 구조를 통해 템플릿의 구성 요소와 콘텐츠를 정의할 수 있습니다.
   • 템플릿 구조에 정의된 구성 요소는 결과 페이지 안에서 이동하거나 결과 페이지에서 삭제할 수 없습니다.
   • 페이지 작성자가 구성 요소를 추가 및 제거할 수 있도록 하려면 템플릿에 단락 시스템을 추가하십시오.
   • 초기 콘텐츠를 정의할 수 있도록 하려면 구성 요소 잠금을 해제했다가 다시 잠글 수 있습니다.

   템플릿 작성자가 구조를 정의하는 방법에 대한 자세한 내용은 페이지 템플릿 만들기.

   구조에 대한 기술적인 세부 정보는 를 참조하십시오. 구조 이 문서에서.

   정책

   • 콘텐츠 정책은 구성 요소의 디자인 속성을 정의합니다.

     • 예: 사용 가능한 구성 요소 또는 최소/최대 크기.

   • 이러한 속성은 템플릿(및 템플릿으로 만든 페이지)에 적용될 수 있습니다.

   템플릿 작성자가 정책을 정의하는 방법에 대한 자세한 내용은 페이지 템플릿 만들기.

   정책에 대한 기술적인 세부 정보는 다음을 참조하십시오. 컨텐츠 정책 이 문서에서.

   초기 콘텐츠

   • 초기 콘텐츠 는 템플릿을 기반으로 페이지를 처음 만들 때 표시되는 콘텐츠를 정의합니다.
   • 그런 다음 페이지 작성자는 초기 콘텐츠를 편집할 수 있습니다.

   템플릿 작성자가 구조를 정의하는 방법에 대한 자세한 내용은 페이지 템플릿 만들기.

   초기 콘텐츠에 대한 자세한 내용은 초기 컨텐츠 이 문서에서.

   레이아웃

   • 디바이스 범위에 대한 템플릿 레이아웃을 정의할 수 있습니다.
   • 템플릿에 대한 반응형 레이아웃은 페이지 작성의 경우와 마찬가지로 작동합니다.

   템플릿 작성자가 템플릿 레이아웃을 정의하는 방법에 대한 자세한 내용은 페이지 템플릿 만들기.

   템플릿 레이아웃에 대한 자세한 내용은 레이아웃 이 문서에서.

4. 템플릿을 활성화한 다음 특정 콘텐츠 트리에 대해 허용합니다.

   • 페이지 작성자가 템플릿을 사용하거나 사용할 수 없게 하기 위해 템플릿을 활성화하거나 비활성화할 수 있습니다.
   • 특정 페이지 분기에서 템플릿을 사용하거나 사용할 수 없게 지정할 수 있습니다.

   템플릿 작성자가 템플릿을 활성화하는 방법에 대한 자세한 내용은 페이지 템플릿 만들기.

   템플릿 활성화에 대한 기술적인 세부 정보는 다음을 참조하십시오. 템플릿 활성화 및 허용이 문서의 e

5. 콘텐츠 페이지를 만드는 데 사용합니다.

   • 템플릿을 사용하여 페이지를 만들 때 정적 템플릿과 편집 가능한 템플릿 간에 눈에 보이는 차이점이 없고 표시가 없습니다.
   • 페이지 작성자의 경우 프로세스가 투명합니다.

   페이지 작성자가 템플릿을 사용하여 페이지를 만드는 방법에 대한 자세한 내용은 을 참조하십시오. 페이지 생성 및 구성.

   편집 가능한 템플릿을 사용하여 페이지를 만드는 방법에 대한 자세한 내용은 결과 컨텐츠 페이지 이 문서에서.

템플릿 폴더

템플릿을 구성하기 위해 다음 폴더를 사용할 수 있습니다.

• global
• 사이트별

표준 AEM 인스턴스에서 global 폴더가 템플릿 콘솔에 이미 있습니다. 이 폴더는 기본 템플릿을 보유하며, 현재 폴더에 정책 및/또는 템플릿 유형을 찾을 수 없는 경우 폴백으로 작동합니다. 이 폴더에 기본 템플릿을 추가하거나 폴더를 만들 수 있습니다(권장).

템플릿 유형 및 정책은 다음 우선 순위에 따라 모든 폴더에 상속됩니다.

1. 현재 폴더
2. 현재 폴더의 상위
3. /conf/global
4. /apps
5. /libs

허용된 모든 항목의 목록이 만들어집니다. 구성이 겹치는 경우( path/ label)에서 현재 폴더에 가장 가까운 인스턴스만 사용자에게 표시됩니다.

폴더를 만들려면 다음 작업을 수행할 수 있습니다.

• 프로그래밍 방식으로 또는 CRXDE Lite 사용
• 사용 구성 브라우저

CRXDE Lite 사용

1. 프로그래밍 방식으로 또는 CRXDE Lite을 사용하여 인스턴스에 대해 새 폴더(/conf%20%EC%95%84%EB%9E%98%EC%97%90?lang=ko)를 만들 수 있습니다.

   다음 구조를 사용해야 합니다.

   /conf
       <your-folder-name> [sling:Folder]
           settings [sling:Folder]
               wcm [cq:Page]
                   templates [cq:Page]
                   policies [cq:Page]
   

2. 그런 다음 폴더 루트 노드에서 다음 속성을 정의할 수 있습니다.

   <your-folder-name> [sling:Folder]

   • 이름: jcr:title
   • 유형: String
   • 값: 폴더에 표시할 제목 템플릿 콘솔.

3. 표준 작성 권한 및 권한(예: content-authors) 이제 그룹을 할당하고 작성자가 새 폴더에 템플릿을 만들 수 있는 필수 액세스 권한(ACL)을 정의해야 합니다.

   다음 template-authors group은 할당해야 하는 기본 그룹입니다. 섹션 보기 ACL 및 그룹 을 참조하십시오.

구성 브라우저 사용

1. 다음으로 이동 전역 탐색 > 도구 > 구성 브라우저.

   기존 폴더는 다음을 포함하여 왼쪽에 나열됩니다. global 폴더를 삭제합니다.

2. 만들기​를 클릭합니다.

3. 다음에서 구성 만들기 대화 상자에서 다음 필드를 구성해야 합니다.

   • 제목: 구성 폴더의 제목 제공
   • 편집 가능한 템플릿: 이 폴더 내에서 편집 가능한 템플릿을 허용하려면 선택

4. 만들기​를 클릭합니다

ACL 및 그룹

CRXDE를 통해 또는 구성 브라우저를 통해 템플릿 폴더가 만들어지면 적절한 보안을 위해 템플릿 폴더의 적절한 그룹에 대해 ACL을 정의해야 합니다.

의 템플릿 폴더 WKND 자습서 를 예로 사용할 수 있습니다.

템플릿-작성자 그룹

다음 template-authors group 은 템플릿에 대한 액세스를 관리하는 데 사용되는 그룹이며, AEM과 함께 기본으로 제공되지만 는 비어 있습니다. 프로젝트/사이트의 그룹에 사용자를 추가해야 합니다.

다음 표에서는 템플릿 편집에 필요한 권한에 대해 자세히 설명합니다.

이 기본값 template-authors 그룹은 프로젝트 설정만 다룹니다. template-authors 구성원은 모든 템플릿에 액세스하고 작성할 수 있습니다. 템플릿에 대한 액세스를 구분하기 위해 여러 템플릿 작성자 그룹이 필요한 보다 복잡한 설정의 경우 더 많은 사용자 지정 템플릿 작성자 그룹을 만들어야 합니다. 그러나 템플릿 작성자 그룹에 대한 권한은 여전히 동일합니다.

템플릿 유형

템플릿을 만들 때 템플릿 유형을 지정해야 합니다.

• 템플릿 유형은 템플릿에 템플릿을 효과적으로 제공합니다. 템플릿을 만들 때 선택한 템플릿 유형의 구조 및 초기 콘텐츠를 사용하여 새 템플릿을 만듭니다.

  • 템플릿 유형이 복사되어 템플릿이 생성됩니다.
  • 복사가 발생하면 템플릿과 템플릿 유형 간의 유일한 연결은 정보 제공을 위한 정적 참조입니다.

• 템플릿 유형을 사용하면 다음을 정의할 수 있습니다.

  • 페이지 구성 요소의 리소스 유형입니다.
  • 템플릿 편집기에서 허용되는 구성 요소를 정의하는 루트 노드의 정책입니다.
  • 템플릿 유형에서 반응형 그리드에 대한 중단점과 모바일 에뮬레이터의 설정을 정의하는 것이 좋습니다.

• AEM에서는 HTML5 페이지 및 적응형 양식 페이지와 같이 바로 사용할 수 있는 다양한 템플릿 유형을 제공합니다.

  • 추가 예는 의 일부로 제공됩니다. WKND 자습서.

• 템플릿 유형은 일반적으로 개발자에 의해 정의됩니다.

기본 제공 템플릿 유형은 아래에 저장됩니다.

• /libs/settings/wcm/template-types

사이트별 템플릿 유형은 다음과 유사한 위치에 저장해야 합니다.

• /apps/settings/wcm/template-types

사용자 정의된 템플릿 유형에 대한 정의는 사용자 정의 폴더(권장) 또는 global. 예:

• /conf/<my-folder-01>/<my-folder-02>/settings/wcm/template-types
• /conf/<my-folder>/settings/wcm/template-types
• /conf/global/settings/wcm/template-types

템플릿 유형 만들기

다른 템플릿의 기반으로 사용할 수 있는 템플릿을 생성한 경우 이 템플릿을 템플릿 유형으로 복사할 수 있습니다.

1. 임의의 페이지 템플릿처럼 템플릿을 만듭니다. 여기에 문서화되어 있음템플릿 유형의 기반으로 사용됩니다.
2. CRXDE Lite을 사용하여 templates 에 대한 노드 template-types 노드 아래의 템플릿 폴더.
3. 에서 템플릿 삭제 templates 노드 아래의 템플릿 폴더.
4. 아래에 있는 템플릿 사본에서 template-types 노드, 모두 삭제 cq:template 및 cq:templateType 모든 속성 jcr:content 노드.

GitHub에서 사용 가능한 편집 가능한 예제 템플릿을 기준으로 자체 템플릿 유형을 개발할 수도 있습니다.

GITHUB의 코드

이 페이지의 코드는 GitHub에서 확인할 수 있습니다

• GitHub에서 aem-sites-example-custom-template-type 프로젝트 열기
• 다음으로 프로젝트 다운로드 ZIP 파일

템플릿 정의

편집 가능한 템플릿에 대한 정의가 저장됩니다 사용자 정의 폴더 (권장) 또는 global. 예:

• /conf/<my-folder>/settings/wcm/templates
• /conf/<my-folder-01>/<my-folder-02>/settings/wcm/templates
• /conf/global/settings/wcm/templates

템플릿의 루트 노드가 유형입니다. cq:Template 의 뼈대 구조:

<template-name>
  initial
    jcr:content
      root
        <component>
        ...
        <component>
  jcr:content
    @property status
  policies
    jcr:content
      root
        @property cq:policy
        <component>
          @property cq:policy
        ...
        <component>
          @property cq:policy
  structure
    jcr:content
      root
        <component>
        ...
        <component>
      cq:responsive
        breakpoints
  thumbnail.png

주요 요소는 다음과 같습니다.

• <template-name>

  • [initial](#initial-content)
  • jcr:content
  • [structure](#structure)
  • [policies](#policies)
  • thumbnail.png

jcr:content

이 노드에는 템플릿에 대한 속성이 있습니다.

• 이름: jcr:title
• 이름: status
  • ``유형: String
  • 값: draft, enabled 또는 disabled

구조

결과 페이지의 구조를 정의합니다.

• 초기 콘텐츠와 병합됩니다( /initial)을 클릭하여 페이지를 만듭니다.

• 구조에 대한 변경 사항은 템플릿으로 만든 모든 페이지에 반영됩니다.

• 다음 root ( structure/jcr:content/root) 노드는 결과 페이지에서 사용할 수 있는 구성 요소 목록을 정의합니다.

  • 템플릿 구조에 정의된 구성 요소는 결과 페이지에서 이동하거나 삭제할 수 없습니다.
  • 구성 요소 잠금이 해제된 후 editable 속성이 로 설정되어 있습니다. true.
  • 이미 콘텐츠가 포함된 구성 요소의 잠금이 해제된 후 이 콘텐츠가 로 이동됩니다. initial 분기입니다.

• 다음 cq:responsive 노드는 응답형 레이아웃에 대한 정의를 보관합니다.

초기 콘텐츠

새 페이지가 만들어질 때 갖게 될 초기 콘텐츠를 정의합니다.

• 다음 포함: jcr:content 새 페이지에 복사되는 노드입니다.
• 구조와 병합( /structure)을 클릭하여 페이지를 만듭니다.
• 생성 후 초기 콘텐츠가 변경되면 기존 페이지가 업데이트되지 않습니다.
• 다음 root 노드에는 최종 페이지에서 사용할 수 있는 항목을 정의하는 구성 요소 목록이 있습니다.
• 콘텐츠가 구조 모드의 구성 요소에 추가되고 해당 구성 요소의 잠금이 해제된 경우(또는 반대로) 이 콘텐츠는 초기 콘텐츠로 사용됩니다.

레이아웃

날짜 템플릿 편집 레이아웃을 정의할 수 있습니다, 는 을 사용합니다. 표준 반응형 레이아웃.

컨텐츠 정책

콘텐츠 정책은 구성 요소의 디자인 속성을 정의합니다. 예: 사용 가능한 구성 요소 또는 최소/최대 크기. 이러한 속성은 템플릿(및 템플릿으로 만든 페이지)에 적용될 수 있습니다. 템플릿 편집기에서 컨텐츠 정책을 만들고 선택할 수 있습니다.

• 속성 cq:policy, root 노드
  /conf/<your-folder>/settings/wcm/templates/<your-template>/policies/jcr:content/root
  페이지의 단락 시스템에 대한 콘텐츠 정책에 대한 상대 참조를 제공합니다.

• 속성 cq:policy, 구성 요소 명시적 노드 root개별 구성 요소에 대한 정책 링크를 제공합니다.

• 실제 정책 정의는 아래에 저장됩니다.
  /conf/<your-folder>/settings/wcm/policies/wcm/foundation/components

페이지 정책

페이지 정책에서 다음을 정의할 수 있습니다. 콘텐츠 정책 페이지(main parsys)의 경우 템플릿 또는 결과 페이지에서 참조할 수 있습니다.

템플릿 사용 및 사용 허용

1. 템플릿 활성화

   템플릿을 사용하려면 다음 방법 중 하나로 템플릿을 활성화해야 합니다.

   • 템플릿 활성화 다음에서 템플릿 콘솔.

   • 에서 상태 속성 설정 jcr:content 노드.

     • 예를 들어,

       /conf/<your-folder>/settings/wcm/templates/<your-template>/jcr:content

     • 속성을 정의합니다.

       • 이름: 상태
       • 유형: 문자열
       • 값: enabled

2. 허용된 템플릿

   • 에서 허용되는 템플릿 경로 정의 페이지 속성 하위 분기의 적절한 페이지 또는 루트 페이지

   • 속성을 설정합니다.

     cq:allowedTemplates
     다음에서 jcr:content 필요한 분기의 노드입니다.

   예를 들어, 값이 다음과 같은 경우:

   /conf/<your-folder>/settings/wcm/templates/.*

결과 컨텐츠 페이지

편집 가능한 템플릿에서 만든 페이지:

• 에서 병합되는 하위 트리로 만들어집니다. structure 및 initial 템플릿에서

• 템플릿 및 템플릿 유형에 보관된 정보에 대한 참조가 있습니다. 이 작업은 jcr:content 속성이 있는 노드:

  • cq:template - 실제 템플릿에 대한 동적 참조를 제공합니다. 템플릿 변경 사항을 실제 페이지에 반영할 수 있습니다.

  • cq:templateType - 템플릿 유형에 대한 참조를 제공합니다.

위의 다이어그램은 템플릿, 콘텐츠 및 구성 요소가 상호 관련되는 방법을 보여 줍니다.

• 컨트롤러 - /content/<my-site>/<my-page> - 템플릿을 참조하는 결과 페이지. 콘텐츠는 전체 프로세스를 제어합니다. 정의에 따라 적절한 템플릿과 구성 요소에 액세스합니다.
• 구성 - /conf/<my-folder>/settings/wcm/templates/<my-template> - 템플릿 및 관련 콘텐츠 정책 페이지 구성을 정의합니다.
• 모델 - OSGi 번들 - OSGI 번들 기능을 구현합니다.
• 보기 - /apps/<my-site>/components - 작성 및 게시 환경 모두에서 콘텐츠는 구성 요소에 의해 렌더링됩니다.

페이지를 렌더링할 때:

• 템플릿:

  • 다음 cq:template 속성 jcr:content 해당 페이지에 해당하는 템플릿에 액세스하기 위해 노드가 참조됩니다.

• 구성 요소:

  • 페이지 구성 요소는 structure/jcr:content 이 있는 템플릿의 트리 jcr:content 페이지 트리.
    • 페이지 구성 요소를 사용하면 작성자는 편집 가능 (및 모든 하위 항목)으로 플래그가 지정된 템플릿 구조의 노드만 편집할 수 있습니다.
    • 페이지에서 구성 요소를 렌더링할 때 해당 구성 요소의 상대 경로는 jcr:content 노드, 아래에 있는 동일한 경로 policies/jcr:content 그러면 템플릿의 노드가 검색됩니다.
      • 다음 cq:policy 이 노드의 속성은 실제 콘텐츠 정책을 가리킵니다(즉, 구성 요소에 대한 디자인 구성을 보유함).
        • 이렇게 하면 동일한 콘텐츠 정책 구성을 다시 사용하는 여러 템플릿을 사용할 수 있습니다.

템플릿 가용성

사이트 관리 인터페이스에서 페이지를 만들 때 사용 가능한 템플릿 목록은 새 페이지의 위치와 각 템플릿에 지정된 배치 제한에 따라 다릅니다.

다음 속성은 템플릿 여부를 결정합니다 T 은 새 페이지를 페이지의 하위 페이지로 배치하는 데 사용할 수 있습니다. P. 이러한 각 속성은 경로와의 일치에 사용되는 0개 이상의 정규 표현식을 포함하는 다중 값 문자열입니다.

• 다음 cq:allowedTemplates 의 속성 jcr:content 의 하위 노드 P 또는 의 상위 항목 P.

• 다음 allowedPaths 다음의 속성 T.

• 다음 allowedParents 다음의 속성 T.

• 다음 allowedChildren 템플릿 속성 P.

평가는 다음과 같이 작동합니다.

• 비어 있지 않은 첫 번째 cq:allowedTemplates 다음으로 시작하는 페이지 계층 구조를 오름차순으로 계산하는 동안 속성을 찾았습니다. P 다음 경로에 대해 일치함: T. 일치하는 값이 없으면 T 거부되었습니다.

• If T 이(가) 비어 있지 않습니다. allowedPaths 속성이지만 다음 경로와 일치하는 값은 없습니다. P, T 거부되었습니다.

• 위의 두 속성이 모두 비어 있거나 존재하지 않는 경우 T 와 동일한 애플리케이션에 속해 있지 않으면 거부됩니다. P. T 은(는) 과 동일한 애플리케이션에 속합니다. P 경로의 두 번째 수준 이름인 경우 및 T 은 경로의 두 번째 수준 이름과 동일합니다. P. (예: 템플릿) /apps/wknd/templates/foo 은(는) 페이지와 동일한 애플리케이션에 속합니다 /content/wknd.

• If T 이(가) 비어 있지 않습니다. allowedParents 속성이지만 다음 경로와 일치하는 값은 없습니다. P, T 거부되었습니다.

• 다음의 템플릿인 경우 P 이(가) 비어 있지 않습니다. allowedChildren 속성이지만 다음 경로와 일치하는 값은 없습니다. T, T 거부되었습니다.

• 다른 모든 경우에는 T 허용됩니다.

다음 다이어그램은 템플리트 평가 프로세스를 보여 줍니다.

하위 페이지에 사용되는 템플릿 제한

주어진 페이지에서 하위 페이지를 만드는 데 사용할 수 있는 템플릿을 제한하려면 cq:allowedTemplates 다음의 속성 jcr:content 하위 페이지로 허용할 템플릿 목록을 지정할 페이지의 노드입니다. 예를 들어, 목록의 각 값은 허용된 하위 페이지에 대한 템플릿의 절대 경로여야 합니다 /apps/wknd/templates/page-content.

다음을 사용할 수 있습니다. cq:allowedTemplates 템플릿의 속성 jcr:content 이 템플릿을 사용하는 작성된 모든 페이지에 이 구성을 적용할 노드

예를 들어 템플릿 계층에 대해 제한을 더 추가하려면 allowedParents/allowedChildren 템플릿에 있는 속성입니다. 그런 다음 템플릿 T에서 만든 페이지가 템플릿 T에서 만든 페이지의 상위/하위 페이지가 되도록 명시적으로 지정할 수 있습니다.