출력 생성 설정 구성 id181AI0B0E30

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

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

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

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

DITA 콘텐츠가 포함된 AEM Site가 있는 경우 DITA 콘텐츠를 사이트 내의 사전 정의된 위치에 게시하도록 AEM Site 출력을 구성할 수 있습니다. 예를 들어 AEM Site 페이지의 다음 스크린샷에서는 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에서 특수 문자를 구분 기호로 대체하도록 시스템을 구성할 수 있습니다. 첫 번째 하위 항목의 이름으로 바꾸도록 구성할 수도 있습니다.

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

예를 들어 @navtitle 위치: <topichead> 에는 모든 특수 문자가 있으며 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 Site 출력의 노드 구조를 내부적으로 만드는 방법을 구성할 수 있습니다. 지정된 요소에서 노드 구조를 평면화할 수 있습니다. 즉, 주 요소로 간주될 요소를 정의할 수 있으며 해당 요소 내의 모든 하위 요소가 주 요소와 병합됩니다. 예를 들어 를 병합하기로 결정한 경우 p 요소를 선택한 다음 내에 나타나는 모든 요소를 p 요소가 main과 병합됩니다. p 요소를 생성하지 않습니다. 내의 하위 요소에 대해서는 별도의 메모가 만들어지지 않습니다. p 요소를 생성하지 않습니다. 다음 스냅샷은 병합된 노드 구조를 표시합니다. p 요소:

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

이제 AEM Site 출력을 생성할 때 p 요소가 병합되고 내부에 저장됩니다. p 요소 자체. 다음에 대한 새 병합 속성을 찾을 수 있습니다. p crxde의 요소입니다.

AEM Site 출력의 컨텐츠 내에서 문자열 검색

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

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

주의:

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

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

AEM Site 출력에서 평면화할 노드를 지정하는 것과 유사하게 이 구성에서 제외할 요소를 지정할 수도 있습니다. 예를 들어 노드를 플랫하려는 경우 body 요소를 생성하지 마십시오. table 다음 내의 요소 body 평면화하려면 table 요소의 정의입니다.

제외하려면 table 요소를 병합하지 않고 다음 속성을 table 요소의 정의:

<preventancestorflattening>true|false</preventancestorflattening>

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

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

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

Experience Manager 안내서를 사용하여 사용자 지정 재작성기 설정 custom-rewriter

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

코드베이스에 다른 사용자 지정 sling 재작성기가 있는 경우 'order' 값: 50보다 큼, Experience Manager Guides sling 재작성기 사용 'order' 50. 재정의하려면 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 요소 스키마

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

<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 설명서에서 참조할 수 있습니다.

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 element는 파일 형식의 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) 세부 정보를 입력하여 목록에 표시할 출력 수를 변경합니다.