설명서AEM GuidesAEM Guides 설명서

사용자 지정 DITA-OT 및 DITA 특수화 사용 id181GAJ0005Z

Last update: Fri Jan 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • Experienced
  • Admin

DITA Open Toolkit (DITA-OT)는 DITA 맵 및 주제 컨텐츠를 처리하는 Java 기반 오픈 소스 도구 세트입니다. AEM Guides를 사용하면 사용자 지정 DITA-OT 플러그인을 쉽게 가져오고 사용할 수 있습니다. 가져온 후에는 사용자 지정 DITA-OT 플러그인을 사용하여 모든 형식의 출력을 생성하도록 AEM Guides를 구성할 수 있습니다. 출력을 생성할 때 DITA-OT 옵션을 선택하면 AEM Guides에서 사용자 지정 DITA-OT 플러그인을 사용하여 필요한 출력을 생성합니다.

출력을 게시하는 동안 Ant 매개 변수를 처리하려는 경우 AEM Guides를 사용하면 쉽게 수행할 수 있습니다. 사용할 Ant 매개 변수를 지정하고 게시 프로세스에서 동일한 매개 변수를 처리할 수 있습니다.

NOTE
AEM Guides는 DITA-OT 버전 3.3.2와 함께 제공됩니다. 그러나 AEM Guides는 DITA-OT 버전 1.7 이상을 지원합니다. DITA-OT 버전의 전체 목록에 대해서는 DITA-OT 버전.
TIP
다음을 참조하십시오. DITA-OT 프로필 구성 및 사용자 지정 DITA-OT 사용 ​사용자 지정 DITA-OT 플러그인 사용에 대한 우수 사례를 보려면 우수 사례 안내서의 섹션을 참조하십시오.

사용자 지정 DITA-OT 플러그인 사용 id181NH1020L7

사용자 지정 DITA-OT 플러그인을 AEM 저장소에 업로드하여 게시하는 데 사용자 지정 DITA-OT 플러그인을 사용할 수 있습니다. 기본적으로 AEM Guides에는 콘텐츠를 편집하고 게시하는 데 사용할 기본 템플릿의 구성이 포함된 사전 구성된 프로필이 포함되어 있습니다. 문서 및 사용자 지정 DITA-OT 플러그인을 편집하여 콘텐츠를 게시하는 동안 사용할 사용자 지정 템플릿으로 사용자 지정 프로필을 만들 수 있습니다.

AEM Guides에서 사용할 수 있는 기본 DITA-OT 패키지에는 MathML 방정식 렌더링을 지원하지 않는 Apache FOP XSL-FO 프로세서가 함께 제공됩니다. 콘텐츠에서 MathML 방정식을 사용하는 경우 Apache FOP용 MathML 렌더링 엔진 플러그인을 통합했는지 또는 다른 XSL-FO 프로세서를 사용했는지 확인하십시오.

사용자 지정 DITA-OT 플러그인을 AEM 저장소에 업로드하려면 다음 단계를 수행하십시오.

  1. 시작 이메일에 공유된 링크에서 DITA-OT.zip 파일을 다운로드합니다.

  2. 시스템에서 zip 파일의 컨텐츠를 추출합니다.

  3. DITA-OT 플러그인 통합자 메커니즘을 사용하여 새 버전의 DITA-OT를 사용자 지정 DITA-OT 플러그인과 통합합니다.

  4. 동일한 이름 ( )을 유지하며 ZIP 파일을 다시 생성합니다.DITA-OT.ZIP및 폴더 구조입니다.

  5. 업데이트된 ZIP 파일을 다시 AEM 저장소에 업로드합니다.

    ZIP 파일을 업로드하기 전에 다음 사항을 확인하십시오.

    • Mac/Linux OS에서 통합자 (사용자 정의 플러그인\ 설치)를 실행하여 파일 구분 기호 관련 문제를 방지합니다. Windows 및 Linux OS의 파일 구분 기호가 다르므로 Mac/Linux OS에 통합된 플러그인은 Windows 및 Linux 설치와 모두 호환됩니다.
    • 다음을 확인합니다. DITA-OT.ZIP 파일에는 모든 관련 플러그인 및 파일이 있는 "DITA-OT"라는 폴더가 있습니다.
    • 다음을 확인: DITA-OT.ZIP 만든 파일은 mimeType: "nt:file" (AEM에 업로드할 때 기본 ZIP 파일 유형에 해당됨). WebDAV 도구 또는 코드 배포를 사용하여 이 ZIP 파일을 AEM의 원하는 경로로 업로드합니다. (이 ZIP은 AEM 컨텐츠 패키지가 아니라 아카이브 파일이므로 AEM 패키지 관리자를 사용하여 이 ZIP 파일을 배포하지 마십시오.)
    note note
    NOTE
    기본 DITA-OT 패키지를 덮어쓰지 않는 것이 좋습니다. 플러그인 /var/dxml/dita_resources/dita-ot 폴더가 포함된 사용자 지정 DITA-OT 패키지를 업로드해야 합니다. Cloud Manager 파이프라인을 사용하여 수행할 수도 있습니다. 다음을 참조하십시오. AEM에 as a Cloud Service 배포 자세한 내용은 AEM 설명서 를 참조하십시오.

  6. 기본 프로파일을 편집하거나, 새 프로파일을 만들거나, 기본 프로파일에서 설정을 복제하여 새 프로파일을 만들 수 있습니다.

    note note
    NOTE
    기본 프로파일을 업데이트할 수는 있지만 삭제할 수는 없습니다. 그러나 새로 만드는 모든 프로필은 편집하고 삭제할 수 있습니다.

  7. 사용자 지정 DITA-OT 플러그인을 사용하도록 다음 속성을 구성합니다.

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2 18-row-2 19-row-2
    속성 이름 설명
    프로필 속성
    프로필 이름 이 프로필의 고유한 이름을 제공하십시오.
    출력 재사용 (선택 사항) 프로필이 기존 프로필을 기반으로 하는 경우 이 옵션을 선택합니다. 이 옵션을 선택하면 AEM Guides에서 DITA-OT 패키지의 내용을 다시 추출하지 않고 기존 DITA-OT 패키지를 다시 사용합니다.
    프로필 추출 경로 (선택 사항) 디스크에서 DITA-OT를 유지할 경로를 지정합니다. 기본적으로 AEM Guides는 저장소에 DITA-OT 패키지를 번들로 제공하고 이 경로의 디스크에서 추출됩니다.
    참고 기존 시스템 변수나 속성을 사용하여 이 경로를 정의할 수 있습니다. 설명 보기 DITA-OT 환경 변수 속성을 참조하십시오.
    할당된 경로 (선택 사항) 이 프로파일을 적용할 수 있는 콘텐츠 저장소의 경로를 지정합니다. 여러 위치를 지정할 수 있습니다.
    DITA-OT 속성
    DITA-OT 시간 초과 (선택 사항) AEM Guides가 DITA-OT 플러그인의 응답을 기다리는 시간 (초)을 지정합니다. 지정된 시간에 응답이 없으면 AEM Guides가 게시 작업을 종료하고 작업에 실패로 플래그가 지정됩니다. 또한 출력 생성 로그 파일에서 오류 로그를 사용할 수 있습니다.
    기본값: 300초 (5분)
    DITA-OT PDF 인수 PDF 출력을 생성하기 위해 사용자 지정 DITA-OT 플러그인에서 처리하는 명령줄 인수를 지정합니다. 모든 사용자 지정 DITA-OT 프로파일에 대해 다음 명령줄 인수를 지정합니다.-lib plugins/org.dita.pdf2.fop/lib/
    DITA-OT AEM 인수 (선택 사항) AEM Site 출력을 생성하기 위해 사용자 지정 DITA-OT 플러그인에서 처리하는 사용자 지정 명령줄 인수를 지정합니다.
    DITA-OT 라이브러리 경로 (선택 사항) DITA-OT 플러그인의 추가 라이브러리 경로를 지정합니다.
    DITA-OT 빌드 XML (선택 사항) 사용자 지정된 DITA-OT 플러그인과 함께 번들로 제공되는 사용자 지정 Ant 빌드 스크립트의 경로를 지정합니다. 이 경로는 파일 시스템의 DITA-OT 디렉토리에 상대적입니다.
    DITA-OT Ant 스크립트 폴더 (선택 사항) DITA-OT Ant 스크립트 폴더의 경로를 지정합니다. 이 경로는 파일 시스템의 DITA-OT 디렉토리에 상대적입니다.
    DITA-OT 환경 변수 (선택 사항) DITA-OT 프로세스에 전달할 환경 변수를 지정합니다. 기본적으로 AEM Guides는 네 개의 변수( ANT_OPTS, ANT_HOME, PATH, 및 CLASSPATH.
    기존 시스템 환경 변수 또는 속성을 재사용하여 새 환경 변수를 작성할 수 있습니다. 예를 들어 JAVA_HOME 시스템에 정의된 시스템 변수로서 새 환경 변수를 정의하려는 경우 JAVA_BIN 다음을 사용하여 빌드됨 JAVA_HOME. 그런 다음 의 정의를 추가할 수 있습니다. JAVA_BIN 다음으로:JAVA_BIN= ${JAVA_HOME}/bin
    참고: Java 시스템 속성을 사용하여 환경 변수를 작성할 수도 있습니다. 예를 들어 AEM 시작 스크립트가 Java 시스템 속성을 정의하는 경우 java.io.tmpdir 임시 디렉터리에 대해 이 속성을 사용하여 새 변수를 다음과 같이 정의할 수 있습니다. ${java.io.tmpdir}/fmdita/dita_ot.
    중요 사항: 기존 시스템 변수나 속성을 재사용하려면 ${}.
    DITA-OT 출력 덮어쓰기 DITA-OT 출력을 덮어쓸지 여부를 선택합니다. 이 옵션을 선택한 상태로 유지합니다.
    AEM DITA-OT Zip 경로 사용자 지정 DITA-OT.zip 파일이 AEM 저장소에 저장되는 전체 경로를 지정합니다.
    DITA-OT 플러그인 경로 사용자 지정 플러그인의 경로입니다. 이 플러그인은 기본 DITA-OT 패키지와 자동으로 통합됩니다.
    카탈로그 통합 (선택 사항) AEM 저장소의 사용자 지정 DTD 및 XSD catalog.xml 파일 경로. DITA-OT 패키지에서 카탈로그가 누락된 경우에만 제공해야 합니다. 이러한 카탈로그는 플러그인으로서 기본 DITA-OT에 자동으로 통합됩니다.
    시스템 ID 카탈로그 추가 (선택 사항) 카탈로그에 누락된 공개 ID 항목이 있거나 DITA 파일이 업로드된 서버 경로를 기준으로 한 시스템 ID만 사용하는 경우에만 이 옵션을 선택합니다.
    DITA-OT 임시 경로 처리를 위해 DITA 파일을 복사하는 임시 위치입니다. DITA-OT에서 파일을 처리하기 전에 이 임시 위치에 복사됩니다. 기본적으로 임시 저장소 위치는 다음과 같습니다.
    <*AEM-Install*>/crx-quickstart/profiles/ditamaps
    중요 사항: 기본 경로를 변경하지 말아야 합니다.
    note note
    NOTE
    AEM Guides 설치 관리자는 사용자 지정 DITA-OT 플러그인 파일의 경로를 지정하는 데 사용할 수 있는 두 개의 환경 변수를 만듭니다. 이러한 환경 변수는 다음과 같습니다. DITAOT\_DIR파일 시스템의 DITA-OT 디렉토리 경로를 포함하는 DITAMAP\_DIR: 파일 시스템에서 DITA 맵 컨텐트를 추출하는 경로가 포함됩니다.

  8. 클릭 완료 을 클릭하여 프로필을 저장합니다.

DITA 특수화 통합 id211MB0E00XA

DITA 특수화는 새 요소를 추가하거나 기존 요소를 제거하여 새 DITA 구조를 만드는 프로세스입니다. 새 DITA 요소를 만들려면 기존 DITA 요소를 기준으로 사용하고 작성 요구 사항에 따라 수정할 수 있습니다. 본질적으로 DITA 특수화를 사용하면 기존 DITA 아키텍처의 이점을 유지하면서 비즈니스 요구 사항을 충족하는 사용자 정의 정보 모델을 만들 수 있습니다.

프로파일 기능을 사용하여 사용자 정의 DITA 특수화 설정을 저장할 수 있습니다. 그런 다음 사용자 지정 DITA 콘텐츠를 작성 및 게시할 때 이러한 설정을 사용할 수 있습니다. AEM Guides를 사용하면 사용자 지정 DTD/XSD에서 공개 ID와 시스템 ID를 사용할 수 있습니다.

NOTE
AEM Guides 웹 편집기는 XSD를 지원하지 않습니다.

새 프로파일을 만들고 AEM Guides에서 특수 DTD 및 XSD를 사용하도록 구성하려면 다음 단계를 수행하십시오.

  1. 특수 DTD 및 XSD가 포함된 로컬 컴퓨터에 특수 폴더를 만듭니다.

  2. 에서 DTD 세부 사항을 지정합니다. catalog.xml 특수화 폴더에도 포함되어야 하는 파일입니다.

    note note
    NOTE
    DITA 1.3의 경우 DTD의 기본 위치 catalog.xml AEM 저장소의 파일: /libs/fmdita/dita_resources/DITA-1.3/dtd/catalog.xml.

  3. 에서 XSD 세부 사항을 지정합니다. catalog.xml 특수화 폴더에도 포함되어야 하는 파일입니다.

    note note
    NOTE
    DITA 1.3의 경우 AEM 저장소의 XSD catalog.xml 파일에 대한 기본 위치는 다음과 같습니다. /libs/fmdita/dita_resources/DITA-1.3/xsd/catalog.xml.

  4. 폴더를 다음 위치에 업로드합니다.

    /var/dxml/dita_resources

  5. 맨 위에 있는 Adobe Experience Manager 링크를 클릭하고 도구.

  6. 선택 안내서 ​을 클릭합니다.

  7. 을(를) 클릭합니다​ DITA 프로파일 타일.

  8. 기본 프로파일을 편집하거나, 새 프로파일을 만들거나, 기본 프로파일에서 설정을 복제하여 새 프로파일을 만들 수 있습니다.

    note note
    NOTE
    기본 프로파일은 삭제할 수 없습니다. 그러나 새로 만드는 모든 프로필은 편집하고 삭제할 수 있습니다.

  9. 다음에서 스키마 > 카탈로그 설정, 사용자 지정 DTD 및 XSD의 경로 지정 catalog.xml AEM 저장소의 파일입니다.

  10. 다음 항목 선택 시스템 ID 카탈로그 추가 옵션을 선택합니다.

    note note
    NOTE
    카탈로그에 누락된 공용 ID 항목이 있거나 DITA 파일이 업로드된 로컬 파일 경로를 기준으로 하는 시스템 ID만 사용하는 경우에만 이 옵션을 선택합니다.

    프로파일 페이지의 다른 속성에 대한 자세한 내용은 6단계 / 사용자 지정 DITA-OT 플러그인 사용 섹션.

  11. 클릭 완료 을 클릭하여 프로필을 저장합니다.

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178