출력 생성 설정 구성 id181AI0B0E30

AEM Guides에는 출력 생성 프로세스를 사용자 정의할 수 있는 다양한 구성 옵션이 포함되어 있습니다. 이 항목에서는 출력 생성 프로세스를 설정하는 데 도움이 되는 모든 구성 및 사용자 정의에 대해 설명합니다.

DITA 맵 대시보드에서 기준선 탭 구성 id223MD0D0YRM

DITA 맵 대시보드에서 기준선 탭을 숨기려면 다음 단계를 수행합니다.

기존 AEM 사이트 내에서 혼합 게시 구성 id1691I0V0MGR

DITA 콘텐츠가 포함된 AEM Site가 있는 경우 DITA 콘텐츠를 사이트 내의 사전 정의된 위치에 게시하도록 AEM Site 출력을 구성할 수 있습니다. 예를 들어 AEM 사이트 페이지의 다음 스크린샷에서는 ditacontent 노드가 DITA 콘텐츠를 저장하도록 예약되어 있습니다.

페이지의 나머지 노드는 AEM Site 편집기에서 직접 작성합니다. DITA 콘텐츠를 사전 정의된 위치에 게시하도록 게시 설정을 구성하면 AEM Guides 게시 프로세스에서 기존의 비 DITA 콘텐츠를 수정하지 않아도 됩니다.

사전 정의된 노드에 DITA 컨텐트를 게시할 수 있도록 기존 사이트에서 다음 구성을 수행해야 합니다.

기존 사이트의 템플릿 속성을 구성하려면 다음 단계를 수행하십시오.

다음에 사이트의 템플릿 구성을 사용하여 DITA 콘텐츠를 게시하면 해당 콘텐츠가 topicContentNode 및 topicHeadNode 속성에 지정된 노드에 게시됩니다.

AEM 사이트 출력 사용자 지정 id166TG0B30WR

AEM Guides은 다음 형식의 출력 만들기를 지원합니다.

AEM Site 출력의 경우 출력 작업이 다른 디자인 템플릿을 할당할 수 있습니다. 이러한 디자인 템플릿은 DITA 콘텐츠를 다른 레이아웃으로 렌더링할 수 있습니다. 예를 들어 내부 및 외부 대상에 대해 서로 다른 디자인 템플릿을 지정할 수 있습니다.

AEM Guides에서 사용자 지정된 DITA Open Toolkit (DITA-OT) 플러그인을 사용할 수도 있습니다. 이러한 사용자 지정 DITA-OT 플러그인을 업로드하여 특정 방식으로 PDF 출력을 생성할 수 있습니다.

출력 생성을 위한 디자인 템플릿 맞춤화 customize_xml-add-on

AEM Guides에서는 사전 정의된 디자인 템플릿 세트를 사용하여 AEM Site 출력을 생성합니다. AEM Guides 디자인 템플릿을 사용자 지정하여 회사 브랜딩에 맞는 출력을 생성할 수 있습니다. 디자인 템플릿은 다양한 스타일 (CSS), 스크립트 (서버측과 클라이언트측), 리소스 (이미지, 로고 및 기타 에셋) 및 이러한 모든 리소스를 하나로 묶는 JCR 노드의 컬렉션입니다. 디자인 템플릿은 두 개의 JCR 노드만 사용하거나 스타일, 리소스 및 JCR 노드의 복잡한 조합을 사용하는 단일 서버측 스크립트처럼 단순할 수 있습니다. 디자인 템플릿은 AEM Site 출력을 생성하는 동안 AEM Guides 게시 하위 시스템에서 사용되며 생성된 출력의 구조, 모양 및 느낌을 제어합니다.

서버에서 디자인 템플릿 리소스를 배치해야 하는 위치에는 제한이 없지만, 일반적으로 함수에 따라 논리적으로 구성됩니다. 예를 들어 기본 템플릿의 모든 JavaScript 및 CSS 파일이 /etc/designs/fmdita/clientlibs/siteoutput/default 폴더에 저장되어 있습니다. 이러한 파일은 위치에 관계없이 JCR 노드 컬렉션에 의해 함께 연결됩니다. 이러한 JCR 노드와 파일은 함께 전체 디자인 템플릿을 구성합니다.

AEM Guides과 함께 제공되는 기본 디자인 템플릿을 사용하면 랜딩, 주제 및 검색 페이지 구성 요소를 사용자 정의할 수 있습니다. 기본 설계와 해당 참조 템플릿의 복사본을 만들고 다른 구성 요소를 지정하여 원하는 출력을 생성할 수 있습니다.

다음 단계를 수행하여 AEM Site 출력 생성에 사용할 고유한 디자인 템플릿을 지정합니다.

자세한 내용은 첫 번째 Adobe Experience Manager 웹 사이트 만들기 및 AEM에서 자체 웹 사이트 개발 기본 사항을 참조하십시오.

AEM 사이트 출력 생성에 문서 제목 사용

AEM Site 출력을 생성할 때 URL을 생성하는 방식은 콘텐츠의 검색 기능에 중요한 역할을 합니다. UUID 기반 파일 이름을 사용하는 경우 파일의 UUID를 기반으로 URL을 생성하면 검색하기 쉽지 않습니다. 관리자 또는 게시자는 AEM Site 출력에 대한 URL을 생성하는 방법을 제어할 수 있습니다. AEM Guides은 UUID 기반 파일 이름이 아닌 파일의 제목을 사용하여 AEM 사이트 출력의 URL을 생성하도록 선택할 수 있는 구성을 제공합니다. 기본적으로 UUID 기반 파일 시스템의 경우 이 옵션이 켜져 있습니다. 이는 UUID 기반 파일 시스템에 대한 AEM Site 출력을 생성할 때 파일의 제목이 파일의 UUID가 아닌 URL을 생성하는 데 사용됨을 의미했습니다.

구성 파일을 만들려면 구성 재정의의 지침을 사용하십시오. AEM Site 출력에서 URL 생성을 구성하려면 구성 파일에서 다음 (property) 세부 정보를 제공합니다.

문서 제목을 사용하도록 AEM 사이트 출력의 URL을 구성합니다.

AEM Site 출력의 URL에서 문서 제목을 사용할 수 있습니다. 파일 이름이 존재하지 않거나 모든 특수 문자가 포함되어 있는 경우 AEM Site 출력의 URL에서 특수 문자를 구분 기호로 대체하도록 시스템을 구성할 수 있습니다. 첫 번째 하위 항목의 이름으로 바꾸도록 구성할 수도 있습니다.

페이지 이름을 구성하려면 다음 단계를 수행하십시오.

예를 들어 <topichead>의 @navtitle ​에 모든 특수 문자가 있고 aemsite.pagetitle 속성을 true로 설정한 경우 기본적으로 구분 기호를 사용합니다. nodename.systemDefinedPageName 속성을 true로 설정하면 첫 번째 하위 주제의 이름이 표시됩니다.

항목을 만들고 AEM 사이트 출력을 게시하기 위한 파일 이름 정리 규칙 구성 id2164D0KD0XA

관리자는 파일 이름에 사용할 수 있는 유효한 특수 문자 목록을 정의하여 AEM Site 출력의 URL을 형성할 수 있습니다. 이전 릴리스에서는 사용자가 @, $, > 등의 특수 문자가 포함된 파일 이름을 정의할 수 있었습니다. 이러한 특수 문자로 인해 AEM Site 페이지를 생성할 때 URL이 인코딩되었습니다.

3.8 릴리스부터 파일 이름에 사용할 수 있는 특수 문자 목록을 정의하는 구성이 추가되었습니다. 기본적으로 올바른 파일 이름 구성에는 "a-z A-Z 0-9 - _"이(가) 포함되어 있습니다. 이는 파일을 만드는 동안 파일 제목에 특수 문자를 사용할 수 있지만 내부적으로 파일 이름에 하이픈 (-)으로 대체됩니다. 예를 들어 파일 제목을 Introduction 1 또는 Introduction@1으로 지정할 수 있습니다. 이 두 경우에 대해 생성되는 해당 파일 이름은 Introduction-1입니다.

올바른 문자 목록을 정의할 때 이러한 문자 "*/:[\]|#%{}?&<>"/+" 및 a space은(는) 항상 하이픈 (-)으로 대체됩니다.

구성 파일을 만들려면 구성 재정의의 지침을 사용하십시오. 구성 파일에서 다음 (property) 세부 정보를 입력하여 파일 이름 및 AEM Site 출력에 유효한 특수 문자를 구성합니다.

파일 이름에서 소문자 사용, 잘못된 문자를 처리하는 구분 기호, 파일 이름에 사용할 수 있는 최대 문자 수와 같은 다른 속성을 구성할 수도 있습니다. 이러한 속성을 구성하려면 구성 파일에 다음 키 값 쌍을 추가합니다.

AEM 사이트 노드 구조의 평면화 구성

AEM Site 출력을 생성하면 주제의 모든 요소에 대한 노드가 내부적으로 생성됩니다. 수천 개의 주제가 있는 DITA 맵의 경우 이 노드 구조가 너무 깊어질 수 있습니다. 이러한 유형의 깊게 중첩된 노드 구조는 더 큰 사이트에 대해 성능 문제가 발생할 수 있습니다. 다음 스냅샷은 AEM 사이트 출력에 대해 깊게 중첩된 노드 구조를 표시합니다.

위의 스냅숏에서는 모든 p 요소 및 후속 하위 요소에 대해 노드가 만들어지고 주제에 사용되는 다른 모든 요소에 대해 유사한 구조가 만들어지는 것을 확인합니다.

AEM Guides을 사용하면 AEM 사이트 출력의 노드 구조를 내부적으로 만드는 방법을 구성할 수 있습니다. 지정된 요소에서 노드 구조를 평면화할 수 있습니다. 즉, 주 요소로 간주될 요소를 정의할 수 있으며 해당 요소 내의 모든 하위 요소가 주 요소와 병합됩니다. 예를 들어 p 요소를 병합하기로 결정한 경우 p 요소 내에 나타나는 모든 요소는 기본 p 요소와 병합됩니다. p 요소 내의 하위 요소에 대해서는 별도의 메모가 만들어지지 않습니다. 다음 스냅숏은 p 요소에서 병합된 노드 구조를 표시합니다.

AEM 사이트 노드 구조를 제거하려면 다음 단계를 수행하십시오.

이제 AEM Site 출력을 생성하면 p 요소 내의 노드가 병합되고 p 요소 자체에 저장됩니다. CRXDE에서 p 요소에 대한 새 병합 속성을 찾을 수 있습니다.

AEM Site 출력의 콘텐츠 내에서 문자열을 검색합니다

기본적으로 AEM Site 출력 내에서만 제목의 문자열을 검색할 수 있습니다. 제목과 AEM Site 출력의 콘텐츠 또는 본문 모두에서 문자열을 검색하도록 시스템을 구성할 수 있습니다.

검색을 활성화하려면 AEM 사이트 노드 구조의 병합을 구성해야 합니다.

주의:

병합된 콘텐츠를 최대 1MB까지 검색할 수 있습니다. 예를 들어 이전 스크린샷에서 <p> 태그 아래의 컨텐츠가 1Mb 미만인지 검색할 수 있습니다.

AEM 사이트 노드 구조의 병합을 방지합니다

AEM Site 출력에서 평면화할 노드를 지정하는 것과 유사하게 이 구성에서 제외할 요소를 지정할 수도 있습니다. 예를 들어 body 요소의 노드를 병합하려고 하지만 body 내의 table 요소를 병합하지 않으려는 경우 table 요소의 정의 내에 exclude 속성을 추가할 수 있습니다.

병합에서 table 요소를 제외하려면 table 요소의 정의에 다음 속성을 추가하십시오.

<preventancestorflattening>true|false</preventancestorflattening>

AEM Site 출력에서 삭제된 페이지에 대한 버전 관리 구성

기존 출력 페이지 설정에 대해 삭제 및 ​만들기​ ​ ​옵션이 선택된 AEM 사이트 출력을 생성하면 삭제되는 페이지에 대한 버전이 만들어집니다. 삭제하기 전에 버전 생성을 중단하도록 시스템을 구성할 수 있습니다.

삭제할 페이지에 대한 버전 만들기를 중지하려면 다음 단계를 수행하십시오.

Experience Manager Guides으로 사용자 지정 재작성기 설정 custom-rewriter

Experience Manager Guides에는 교차 맵(서로 다른 두 맵의 주제 간 링크)의 경우 생성되는 링크를 처리하기 위한 사용자 지정 sling rewriter 모듈이 있습니다. 이 재작성기 구성은 다음 경로에 설치됩니다.
/apps/fmdita/config/rewriter/fmdita-crossmap-link-patcher

코드베이스에 다른 사용자 지정 sling 재작성기가 있는 경우, Experience Manager Guides sling 재작성기는 'order' 50을 사용하므로 50보다 큰 'order' 값을 사용하십시오. 재정의하려면 50 이상의 값이 필요합니다. 자세한 내용은 출력 다시 쓰기 파이프라인을 참조하십시오.

DITA-OT를 통해 출력을 게시할 때 메타데이터 사용 id191LF0U0TY4

AEM Guides에서는 DITA-OT를 사용하여 출력을 게시하는 동안 사용자 지정 메타데이터를 전달하는 방법을 제공합니다. 관리자 및 게시자는 게시된 출력에서 사용자 지정 메타데이터를 구성하고 사용하려면 다음 작업을 수행해야 합니다.

시스템에 필요한 메타데이터를 추가하려면 다음 단계를 수행하십시오.

이제 모든 DITA 맵에 대한 속성 페이지에 새 매개변수가 표시됩니다.

그런 다음 DITA 맵 콘솔에서 사용자 지정 메타데이터를 사용할 수 있도록 해야 합니다. DITA 맵 대시 보드에서 사용자 정의 메타데이터를 사용할 수 있도록 하려면 다음 단계를 수행하십시오.

이제 사용자 지정 메타데이터가 DITA 맵 콘솔의 속성 드롭다운 목록에 표시됩니다.

마지막으로 게시자는 게시된 출력에 사용자 지정 메타데이터를 포함해야 합니다. 출력을 생성하는 동안 사용자 지정 메타데이터를 처리하려면 다음 단계를 수행하십시오.

선택한 속성/메타데이터는 게시 프로세스에 전달되고 최종 출력에서 사용할 수 있습니다.

처리를 위해 DITA-OT로 전달되는 메타데이터의 유효성 검사

DITA-OT에 전달된 메타데이터 값의 유효성을 검사하기 위해 클라우드 지원 jar를 사용하는 로컬 환경을 사용할 수 있습니다. 클라우드에서 로컬 파일 시스템에 액세스할 수 없으므로 메타데이터 파일의 유효성을 검사하는 유일한 방법은 cloud ready jar를 통해서입니다.

AEM 구성 요소를 사용하여 DITA 요소 매핑 사용자 정의 id1679J600HEL

AEM Guides의 DITA 요소는 해당 AEM 구성 요소에 매핑됩니다. AEM Guides은 게시 및 검토와 같은 워크플로에서 이 매핑을 사용하여 DITA 요소를 해당 AEM 구성 요소로 변환합니다. 패키지 관리자를 사용하여 액세스할 수 있는 elementmapping.xml 파일에 매핑이 정의되어 있습니다.

미리 정의된 DITA 요소 매핑을 사용하거나 DITA 요소를 사용자 정의 AEM 구성 요소에 매핑할 수 있습니다. 사용자 지정 AEM 구성 요소를 사용하려면 elementmapping.xml 파일의 구조를 이해해야 합니다.

elementmapping.xml 구조

elementmapping.xml 구조에 대한 높은 수준의 개요가 아래에 설명되어 있습니다.

DITA 요소 스키마

다음은 elementmapping.xml 파일의 DITA 요소 스키마의 예입니다.

<ditaelement>
    <name>element_name</name>
    <class>element_class</class>
    <componentpath>fmdita/components/dita/component_name</componentpath>
    <type>COMPOSITE|STANDALONE</type>
    <attributeprop>propname_a</attributeprop>
    <textprop>propname_t</textprop>
    <xmlprop>propname_x</xmlprop>
    <xpath>xpath expression string</xpath>
    <target>head|para</target>
    <wrapelement>div</wrapelement>
    <wrapclass>class_name</wrapclass>
    <attributemap>
        <attribute from="attrname"         to="propname"         ispath="true|false"         rel="source|target" />
    </attributemap>
    <skip>true|false</skip>
</ditaelement>

다음 표에서는 DITA 요소 스키마의 요소에 대해 설명합니다.

추가 참고 사항

DITA 맵 콘솔 사용자 정의 id188HC08M0CZ

AEM Guides은 DITA 맵 콘솔의 기능을 확장할 수 있는 유연성을 제공합니다. 예를 들어 AEM Guides에서 사용할 수 있는 보고서와 다른 보고서 세트가 있는 경우 그러한 보고서를 맵 콘솔에 추가할 수 있습니다. 맵 콘솔을 사용자 정의하려면 필요한 기능을 수행하는 코드가 포함된 AEM 클라이언트 라이브러리 (또는 ClientLib)를 만들어야 합니다.

AEM Guides은 맵 콘솔을 사용자 지정할 apps.fmdita.dashboard-extn 범주를 제공합니다. 맵 콘솔이 로드될 때마다 apps.fmdita.dashboard-extn 범주에서 만든 기능이 실행되고 로드됩니다.

출력 생성 중 이미지 렌디션 처리 id177BF0G0VY4

AEM에는 자산을 처리하는 기본 워크플로우 및 미디어 핸들 세트가 포함되어 있습니다. AEM에는 가장 일반적인 MIME 유형에 대한 에셋 처리를 처리하는 미리 정의된 워크플로가 있습니다. 일반적으로 업로드하는 모든 이미지에 대해 AEM은 이진 형식으로 동일한 렌디션을 여러 개 만듭니다. 이러한 렌디션은 크기가 다르고 해상도가 다르며 워터마크가 추가되거나 다른 특성이 변경될 수 있습니다. AEM에서 자산을 처리하는 방법에 대한 자세한 내용은 AEM 설명서에서 미디어 처리기 및 워크플로를 사용하여 Assets 처리를 참조하십시오.

AEM Guides을 사용하면 문서에 대한 출력을 생성할 때 사용할 이미지 렌디션을 구성할 수 있습니다. 예를 들어 기본 이미지 표현물 중 하나를 선택하거나 표현물을 만들어 이를 사용하여 문서를 게시할 수 있습니다. 문서를 게시하기 위한 이미지 렌디션 매핑은 /libs/fmdita/config/ **renditionmap.xml** 파일에 저장됩니다. renditionmap.xml 파일의 스니펫은 다음과 같습니다.

<renditionmap>
   <mapelement>
      <mimetype>image/png</mimetype>
      <rendition output="AEMSITE">cq5dam.web.1280.1280.jpeg</rendition>
      <rendition output="PDF">original</rendition>
      <rendition output="HTML5">cq5dam.web.1280.1280.jpeg</rendition>
      <rendition output="EPUB">cq5dam.web.1280.1280.jpeg</rendition>
      <rendition output="CUSTOM">cq5dam.web.1280.1280.jpeg</rendition>
   </mapelement>
...
</renditionmap>

mimetype 요소는 파일 형식의 MIME 형식을 지정합니다. rendition output 요소는 지정된 출력을 게시하는 데 사용해야 하는 출력 형식 및 렌디션의 이름 (예: cq5dam.web.1280.1280.jpeg)을 지정합니다. AEMSITE, PDF, HTML5, EPUB 및 사용자 지정 등 지원되는 모든 출력 형식에 사용할 이미지 렌디션을 지정할 수 있습니다.

지정된 렌디션이 없으면 AEM Guides 게시 프로세스는 먼저 지정된 이미지의 웹 렌디션을 찾습니다. 웹 렌디션도 찾을 수 없는 경우에는 이미지의 원본 렌디션이 사용됩니다.

출력 기록에 대한 자동 삭제 기간 구성 id19AAI070V8Q

출력을 생성하면 출력 로그와 함께 출력이 생성됩니다. 큰 DITA 맵의 경우 이러한 로그는 저장소에서 많은 공간을 사용할 수 있습니다. 기본적으로 로그는 저장소의 다음 위치에 저장됩니다.

/var/dxml/metadata/outputHistory

일정 기간 동안 모든 로그 파일의 전체 크기가 GB로 증가할 수 있습니다. AEM Guides을 사용하면 이러한 로그 파일을 저장소에 보관하도록 기간을 구성할 수 있습니다. 지정된 기간이 지나면 출력 생성 기록과 함께 로그가 저장소에서 삭제됩니다.

기록 지우기 기능을 구성하면 저장소의 모든 DITA 맵에 대한 출력 생성에 영향을 미칩니다. DITA 맵의 출력 탭에서 기록은 지정된 일 수와 설정에 지정된 시간에 삭제됩니다.

구성 파일을 만들려면 구성 재정의의 지침을 사용하십시오. 출력 기록 및 로그를 제거할 날짜와 시간을 설정하려면 구성 파일에 다음 (property) 세부 정보를 입력하십시오.

최근에 생성된 출력 목록 제한 변경 id1679JH0H0O2

DITA 맵의 출력 탭에 표시되는 생성된 최대 출력 수를 변경할 수 있습니다.

구성 파일을 만들려면 구성 재정의의 지침을 사용하십시오. 구성 파일에서 다음 (property) 세부 정보를 입력하여 목록에 표시할 출력 수를 변경합니다.