웹 편집기의 AEM Sites 사전 설정
웹 편집기에서 AEM Sites 사전 설정을 만들고 AEM Sites 출력을 생성하도록 구성할 수 있습니다. AEM Sites 출력은 guides-components과(와) 함께 복합 구성 요소 매핑을 기반으로 하므로 효율적인 콘텐츠 생성 및 관리가 가능합니다.
Experience Manager Guides은 AEM Sites을 만들기 위한 사전 정의된 템플릿을 제공합니다. 이러한 사전 설정은 컨텐츠 레이아웃 및 구조의 일관성을 보장하는 데 도움이 됩니다.
- 미리 정의된 템플릿을 기반으로 홈 페이지를 만듭니다.
- 주제 템플릿을 편집하고 요구 사항에 따라 스타일을 적용할 수 있습니다.
- 기존 AEM Sites 템플릿을 사용자 지정할 수도 있습니다.
AEM Sites 사전 설정 만들기
웹 편집기에서 AEM Sites 사전 설정을 만들려면 다음 단계를 수행하십시오.
- 저장소 패널의 맵 보기에서 DITA 맵 파일을 엽니다.
- 출력 탭에서 + 아이콘을 선택하여 출력 사전 설정을 만듭니다.
- 새 출력 사전 설정 대화 상자의 유형 드롭다운에서 AEM Sites 을(를) 선택합니다.
- 새 출력 사전 설정 대화 상자에서 기존 구성 요소 매핑 사용 옵션을 선택 취소합니다.
- 온-프레미스 소프트웨어: 온-프레미스 소프트웨어용 AEM Sites 템플릿을 다운로드하고 설치하는 방법에 대해 자세히 알아보세요.
- Cloud Service: Cloud Service을 위해 AEM Sites 템플릿을 다운로드하고 설치하는 방법에 대해 자세히 알아보세요.
현재 폴더 프로필에 사전 설정 추가
관리자는 Experience Manager Guides을 사용하여 전역 및 폴더 프로필에 대한 출력 사전 설정을 만들고 관리할 수 있습니다. 새 출력 사전 설정 대화 상자에서 현재 폴더 프로필에 추가 옵션을 선택하여 현재 폴더 프로필에 대한 출력 사전 설정을 만듭니다.
레거시 구성 요소 매핑을 기반으로 하는 AEM Sites 사전 설정
이전 구성 요소 매핑을 사용하여 AEM Sites 사전 설정을 만들 수도 있습니다. 기존 구성 요소 매핑을 기반으로 AEM Sites 사전 설정을 만들려면 새 출력 사전 설정 대화 상자에서 기존 구성 요소 매핑 사용 옵션을 선택하십시오.
일부 옵션은 이전 구성 요소 매핑을 사용하는 사전 설정에 따라 다를 수 있습니다.
AEM Sites 사전 설정 구성
구성은 일반, 콘텐츠, 주제 목록 및 교차 맵 참조 탭에서 구성됩니다.
일반
일반 탭에는 출력 생성과 관련된 다음 구성이 포함되어 있습니다.
-
사이트 경로 사용
-
사이트 경로
-
Site
-
Publish 경로
-
주제 페이지 템플릿
-
다음을 기반으로 페이지 이름 생성
- 항목 파일 이름
- 주제 제목
-
이전에 생성된 페이지 정리
- 맵에서 제거된 주제에 대해 이전에 생성된 페이지 삭제
- 이 경로에서 다른 소스에서 만든 모든 페이지를 삭제:
-
사후 생성 워크플로
콘텐츠
콘텐츠 탭에는 다음 구성이 포함됩니다.
-
기준선 사용
-
조건 필터링
-
추가 DITA-OT 명령줄 인수
-
메타데이터
- 파일(Assets) 속성
- 맵 속성을 대체 항목으로 사용
자세한 내용은 AEM Sites 구성을 참조하세요.
주제 목록
주제 목록 은(는) DITA 맵의 현재 작업 복사본에 있는 주제 목록을 표시합니다. 기본적으로 모든 주제가 포함됩니다. 특정 주제를 선택하고 해당 주제에 대해서만 AEM Sites 출력을 생성할 수 있습니다. 예를 들어 일부 주제를 업데이트하여 전체 DITA 맵을 게시하는 대신 해당 주제만 게시할 수 있습니다.
주제 목록 탭이 레거시 매핑을 기반으로 만들어지지 않은 AEM 사전 설정에 있습니다.
교차 맵 참조
이 목록에는 scope =”peer”의 교차 맵 참조가 포함된 항목이 포함되어 있습니다. 다른 DITA 맵에서 사용할 수 있는 주제에 대해 scope=”peer”을(를) 사용하는 교차 맵 참조 목록에 대한 게시 컨텍스트를 지정할 수 있습니다. 이 탭은 Experience Manager Guides(UUID) 버전을 사용하는 경우에 나타납니다.
연결된 주제를 게시하는 방법에 대해 자세히 알아보세요.
AEM Sites 구성 aem_sites_config
AEM Sites 출력에 사용할 수 있는 옵션은 다음과 같습니다.
새로 고침
AEMG-Docs(으)로 지정하고 Publish 경로를 aemg-docs-en/docs/product-abc.(으)로 지정하면 AEM Sites 출력이 crx/de의 aemg-docs-en/docs/product-abc/ 노드 아래에 생성됩니다.주제 제목: DITA 주제의 제목을 사용하여 Experience Manager 사이트 이름을 만듭니다.
항목 a.dita, b.dita 및 c.dita가 포함된 DITA 맵을 게시했다고 가정합니다. 맵을 다시 게시하기 전에 맵에서 b.dita 주제를 제거했습니다. 이제 이 옵션을 선택하면 b.dita와 관련된 모든 컨텐츠가 AEM Sites 출력에서 제거되고 a.dita 및 c.dita만 게시됩니다.
참고: 삭제된 페이지에 대한 정보도 출력 생성 로그에 캡처됩니다. 로그 파일에 액세스하는 방법에 대한 자세한 내용은 로그 파일을 보고 확인하세요.
주의: 항목을 삭제하면 게시된 사이트에서 페이지를 사용할 수 없게 됩니다. 따라서 주제가 삭제되기 전에 경고가 나타납니다. 삭제를 확인해야 합니다.
- 이 경로에 있는 다른 원본에서 만든 모든 페이지를 삭제: 이 옵션을 선택하면 다른 지도, 개별 항목 또는 다른 원본에서 이 경로에 게시된 모든 페이지가 삭제됩니다. 또한 게시된 사이트에서 페이지를 사용할 수 없게 됩니다. 따라서 주제가 삭제되기 전에 경고가 나타납니다. 삭제를 확인해야 합니다.
중요: AEM 사이트에 대한 증분 출력을 생성하는 경우 연결된 기준선이 아닌 파일의 현재 버전을 사용하여 출력이 만들어집니다.
자세한 내용은 기준선으로 작업을 참조하세요.
없음: 게시된 출력에 조건을 적용하지 않으려면 이 옵션을 선택하십시오.
DITAVAL 사용: DITAVal 파일을 선택하여 조건부 콘텐츠를 생성합니다. 찾아보기 대화 상자를 사용하거나 파일 경로를 입력하여 여러 DITAVal 파일을 선택할 수 있습니다. 파일 이름 근처에 있는 교차 아이콘을 사용하여 제거합니다. DITAVal 파일은 지정된 순서대로 평가되므로 첫 번째 파일에 지정된 조건이 이후 파일에 지정된 조건과 일치하는 조건보다 우선합니다. 파일을 추가하거나 삭제하여 파일 순서를 유지할 수 있습니다. DITAVal 파일이 다른 위치로 이동되거나 삭제되는 경우 맵 대시보드에서 자동으로 삭제되지 않습니다. 파일이 이동되거나 삭제될 경우에 대비하여 위치를 업데이트해야 합니다. 파일 이름 위로 마우스를 가져가면 파일이 저장된 AEM 저장소의 경로를 볼 수 있습니다. DITAVal 파일만 선택할 수 있으며 다른 파일 유형을 선택한 경우 오류가 표시됩니다.
조건 사전 설정: 출력을 게시하는 동안 조건을 적용하려면 드롭다운에서 조건 사전 설정을 선택합니다. 이 옵션은 DITA 맵 파일에 대한 조건을 추가한 경우에 표시됩니다. 조건부 설정은 DITA 맵 콘솔의 조건 사전 설정 탭에서 사용할 수 있습니다. 조건 사전 설정에 대해 자세히 알아보려면 조건 사전 설정 사용을 확인하세요.
파일(Assets) 속성
참고: 메타데이터 속성은 대/소문자를 구분합니다.
기준선을 선택한 경우 속성 값은 선택한 기준선의 버전을 기반으로 합니다. 기준선을 선택하지 않은 경우 속성의 값은 최신 버전을 기반으로 합니다.
DITA-OT 게시를 사용하여 메타데이터를 출력으로 전달할 수도 있습니다. 자세한 내용을 보려면 DITA-OT를 사용하여 메타데이터를 출력으로 전달하십시오.
참고: 속성 옵션에서
cq:tags을(를) 정의하지 않은 경우 게시를 위해 기준선을 선택했더라도 현재 작업 복사본에서 cq:tags의 값이 선택됩니다.맵 속성을 대체 항목으로 사용
문자열, 날짜 또는 긴(단일 및 다중 값) 속성만 AEM Site 페이지에 전달할 수 있습니다. String 형식 속성에 대한 메타데이터 값이 특수 문자(예:
@, #, " ")를 지원하지 않습니다.* 이 옵션은
Properties 옵션과 함께 사용해야 합니다.출력을 생성한 후 임시 파일 다운로드
참고: 생성 중에 파일 속성이 추가되면 출력 임시 파일에 해당 속성이 포함된 metadata.xml 파일도 포함됩니다.
템플릿을 사용하여 AEM Sites 출력 생성
Experience Manager Guides을 사용하면 기본 제공 템플릿을 사용하거나 고유한 AEM Sites 템플릿을 추가할 수 있습니다.
AEM Sites 사전 설정을 구성하기 전에 템플릿을 사용하여 AEM Sites 구조를 만들어야 합니다.
자세한 내용은 AEM Sites 템플릿 다운로드 및 설치를 참조하십시오.
AEM Sites 사전 설정을 만들고 구성하려면 다음 단계를 수행하십시오.
-
게시할 DITA 맵의 출력 사전 설정 탭을 엽니다.
-
AEM Sites 출력 사전 설정을 선택합니다.
-
(선택 사항) 레거시 구성 요소 매핑 사용 옵션을 선택 취소하여 비레거시 AEM Sites 사전 설정을 만듭니다.
-
추가 를 클릭합니다. AEM Sites용 사전 설정이 생성됩니다.
-
다음 두 가지 방법으로 기본 제공 사이트 템플릿을 구성할 수 있습니다.
-
사이트 를 선택한 다음 채워진 옵션에서 게시 경로와 주제 페이지 템플릿을 선택합니다.
- 사이트를 선택합니다.
- 사이트 를 선택합니다. 예:
AEMG Docs - Publish 경로 및 주제 페이지 템플릿 옵션이 드롭다운에 자동으로 설정됩니다. 옵션을 선택할 수도 있습니다. 예를 들어
AEMG-Docs-Site/en/docs/product1과(와)Topic page이(가) 각각 설정됩니다.
-
전체 사이트 경로 선택:
- 사이트 경로 사용 옵션을 선택하십시오.
- 전체 사이트 경로를 선택합니다. 예:
/content/AEMG-Docs-Site/en/docs/product1 - '주제 페이지 템플릿'이
Topic Page(으)로 자동 설정됩니다.
-
-
사전 설정에 수행된 변경 사항을 저장합니다.
-
생성 옵션을 선택하십시오.
-
해당 맵에 대한 AEM Sites을 생성합니다. 예:
/content/AEMG-Docs-Site/en/docs/productnote note NOTE AEM 사이트에 콘텐츠를 처음 게시하는 경우 사이트 수준에서 페이지를 게시하는 것이 좋습니다. 이렇게 하면 CSS 중단 없이 Publish 인스턴스에 출력이 올바르게 표시됩니다.
Publish 연결 주제
Experience Manager Guides에서는 peer @scope을(를) 사용하여 주제 참조를 만들 수 있으므로 복잡한 문서를 게시하는 작업을 간소화합니다. 그런 다음 AEM Sites 사전 설정에서 이러한 참조의 게시 컨텍스트를 정의하고 마지막으로 연결된 주제의 출력을 생성할 수 있습니다.
자세한 내용은 다른 맵에서 연결 주제의 출력 생성을 참조하십시오.
상호 연결된 파일의 게시 컨텍스트를 지정하려면 다음 단계를 수행하십시오.
-
게시할 DITA 맵의 출력 사전 설정 탭을 엽니다.
-
AEM Sites 출력 사전 설정을 선택합니다.
일반, 콘텐츠, 주제 목록 및 교차 맵 참조 탭을 볼 수 있습니다. UUID(Experience Manager Guides) 버전을 사용하는 경우 교차 맵 참조 탭이 표시됩니다.
다음의 경우 교차 맵 연결을 볼 수 없습니다.
- 4.6 릴리스 전에 생성된 사전 설정용. 상호 참조 탭이 비활성화되고 맵 대시보드 참조 도구 설명이 나타납니다.
- 맵 대시보드에서 만든 사전 설정용. 맵(Map) 대시보드 툴팁이 나타납니다.
- OOTB 사전 설정의 경우 대시보드 매핑 도구 설명이 표시됩니다.
- 전역 사전 설정의 경우 이 전역 사전 설정의 로컬 복사본을 만들어 교차 맵 참조를 설정합니다.
웹 편집기의 AEM Sites 사전 설정을 사용하려면 새 사전 설정을 만들거나 기존 사전 설정을 복제하십시오.
-
교차 맵 참조 탭을 엽니다.
주제 및 해당 참조 목록이 표시됩니다.
scope=”peer”을(를) 사용하여 다른 DITA 맵에서 사용할 수 있는 주제에 대한 교차 맵 참조 목록에 대한 게시 컨텍스트를 지정할 수 있습니다.웹 편집기에서 교차 맵 참조 패널을 사용하려면
<xrefs>에 고유 ID가 있어야 합니다.<xrefs>에 대한 고유 ID는 ID가 없는 경우 이전 콘텐츠를 편집/저장할 때 자동으로 생성됩니다.note note NOTE 교차 맵 참조 탭에는 scope=”peer”을(를) 사용하여 연결된 항목만 표시됩니다.scope=”local”이(가) 있는 링크의 경우 게시 컨텍스트를 지정할 필요가 없습니다.연결된 모든 주제에는 기본적으로 최신 출력 사전 설정과 맵이 선택되어 있습니다. 연결된 모든 항목의 게시 컨텍스트는 기본적으로
<Most recently generated>맵으로 설정되어 있습니다.
-
맵에서 각 종속 파일의 가장 최근에 게시된 출력을 사용하려면 모든 종속 항목에 대해 가장 최근에 생성된 게시 컨텍스트 사용 을 선택합니다.
연결된 항목이 들어 있는 맵을 게시하기 전에 상위 맵으로 선택한 맵을 게시해야 합니다. 연결된 주제가 있는 맵이 게시되지 않으면 해당 링크는 AEM Sites 출력에 하이퍼링크 대신 일반 텍스트로 표시됩니다.
연결된 주제에 대해 동일한 유형의 AEM Sites 사전 설정을 선택해야 합니다. 예를 들어 현재 AEM Sites 사전 설정이 기존 구성 요소 매핑을 사용하는 경우 연결된 주제의 유사한 AEM Sites 사전 설정을 선택합니다. -
상위 맵 드롭다운 목록에서 현재 맵의 출력을 연결할 출력이 있는 맵 파일을 선택합니다.
맵 파일을 선택하면 상위 맵 UUID 열에 맵의 UUID가 표시됩니다. 선택한 맵과 연결된 출력 사전 설정이 상위 맵의 사전 설정 목록에 나열됩니다. 예를 들어 맵 A의 항목 1에는 항목 2에 대한 참조가 포함되어 있습니다. 주제 2는 단일 또는 다중 지도에 존재할 수 있다. 각 링크에 대해 상위 맵과 특정 사전 설정 또는 가장 최근에 게시된 출력을 선택할 수 있습니다. -
파일에서 동일한 주제가 두 번 이상 참조되는 경우 각 인스턴스에 대해 다른 게시 컨텍스트를 추가할 수 있습니다. 따라서 컨텐츠를 보다 유연하게 제어하고 제어할 수 있습니다. 예를 들어 항목 3은 맵 B와 맵 C 모두에 있습니다. 항목 1에는 항목 3에 대한 두 개의 참조가 포함되어 있습니다. 맵 B를 첫 번째 링크의 상위 맵으로 선택하고 맵 C를 두 번째 링크의 상위 맵으로 선택할 수 있습니다.
-
상위 맵의 사전 설정 드롭다운 목록에서 현재 맵의 출력을 연결할 출력 사전 설정을 선택합니다.
note note NOTE 현재 맵의 다양한 AEM Sites 사전 설정이 드롭다운 목록에 나타납니다. 사전 설정을 선택하지 않으면 경고 아이콘이 표시되고 출력 생성이 실패합니다. 1. 모든 소스 주제에 필요한 맵과 해당 출력 사전 설정을 선택하고 **생성**을 선택합니다.
상위 항목: 출력 사전 설정 이해