부록 id195AD0L60Y4

변환을 위한 InDesign 파일 준비 id195DBF0045Z

InDesign은 작성자에게 매력적이고 복잡한 문서를 만들 수 있는 다양한 기능을 제공합니다. 따라서 문서의 여러 부분이 시각적으로 페이지에 배치되지만 이러한 텍스트 프레임 간에 흐름을 제공하려고 시도하지 않는 경우가 많습니다. 텍스트 프레임의 '읽기 순서'이(가) 정의되지 않은 경우 IDML 파일에 의미 있는 순서를 따르지 않을 수 있는 스토리가 포함됩니다. 최종 결과는 임의의 순서로 단락, 표 및 그래픽이 있는 하나 이상의 DITA 주제가 됩니다.

DITA 편집기에서 DITA 컨텐트를 적절한 순서로 편집할 수 있지만 IDML 파일을 생성하기 전에 InDesign 파일을 수정하는 것이 훨씬 쉽습니다. 이 작업은 소스 문서의 모양을 변경하지 않고 수행할 수 있습니다. 또한 읽기 순서를 적절히 정의하여 소스 문서에 액세스할 수 있는 이점이 있습니다.

텍스트 프레임 스레딩

InDesign은 한 프레임을 다른 프레임에 연결하는 과정에서 '스레딩' ​이라는 용어를 사용합니다. 텍스트 프레임 스레딩에 대한 자세한 내용은 InDesign 설명서의 텍스트 스레딩 항목을 참조하십시오.

겹치는 프레임

일부 InDesign 문서에서는 레이아웃으로 인해 스레드되지 않은 겹치는 프레임을 사용합니다. 이 콘텐츠를 주 스레드로 병합하는 것은 매우 어려울 수 있습니다. 가장 좋은 방법은 DITA 환경에서 결과를 편집하는 것입니다.

InDesign 스토리

InDesign 문서의 각 스레드된 콘텐츠 흐름은 'story'입니다. 최상의 결과를 얻으려면 스토리 수를 제한적으로 유지하는 것이 좋습니다. 그러나 문서의 일부 부분이 DITA 출력에 필요하지 않을 수 있습니다. 예를 들어 페이지 바닥글은 거의 필요하지 않지만, 신중하게 다루지 않을 경우 주제 중간에 표시될 수 있습니다.

문서에서 필요하지 않은 텍스트를 제외하는 가장 쉬운 방법은 원하지 않는 콘텐츠에만 사용되는 특수 단락 태그 ​를 문서에 제공하는 것입니다. 예를 들어 바닥글에 대해 [기본 단락] ​을(를) 다시 사용하는 대신 전용 바닥글 태그를 만듭니다. 그런 다음 MapStyle 파일에서 다음과 같이 삭제할 바닥글 단락을 설정하기만 하면 됩니다.

<paraRule style="Footer" local="0" refactor="drop">
   <attributeRules createID="false"/>
</paraRule>

DITA doctype에 매핑

소스 문서에는 항목의 시작을 표시할 수 있는 단락 스타일 또는 요소가 하나 이상 있어야 합니다. 문서에서 제목1 ​을(를) 문서의 최상위 제목 이름으로 사용하는 것이 일반적입니다. 그런 다음 해당 스타일에서 특정 DITA doctype으로의 매핑을 만들 수 있습니다. 문서가 잘 정리되어 있고 Heading1 ​의 사용이 전체적으로 일정하다면 좋은 결과를 얻을 수 있을 것입니다.

여러 DITA doctype

머리글1 단락 중 일부를 다른 DITA doctype으로 변환해야 하는 경우 InDesign에서 단락 스타일을 복제합니다. 이러한 스타일에서 Heading1_genTask 또는 Heading1_troubleshooting ​과 같은 이름을 쉽게 인식할 수 있도록 하십시오. 그런 다음 아래와 같이 mapStyle 파일을 설정합니다.

<doctypes>
   <doctypeParaRule style="Heading1" local="0" mapToDoctype="concept">
      <attributeRules createID="true"/>
   </doctypeParaRule>
   <doctypeParaRule style="Heading1_genTask" local="0" mapToDoctype=" generalTask">
      <attributeRules createID="true"/>
   </doctypeParaRule>
   <doctypeParaRule style="Heading1_troubleshooting" local="0"mapToDoctype=" troubleshooting">
      <attributeRules createID="true"/>
   </doctypeParaRule>
</doctypes>

구조화된 InDesign 문서

InDesign은 XML과 느슨한 관계를 맺고 있습니다. 문서에는 XML DTD가 포함될 수 있으며 기본 스토리가 해당 DTD에 대해 유효할 수도 있지만, 일부 내용이 XML이지만 DTD가 포함되지 않은 하이브리드 문서를 만들 수도 있습니다. 이는 DITA로 성공적으로 변환하는 데 바람직하지 않은 경우입니다. 문서에 XML 부분이 포함되어 있는 경우 출력을 XML에 저장하고 결과를 수용할 수 있는지 확인합니다. 그렇지 않으면 DITA 컨텐트에도 잘못된 컨텐트가 포함되거나 완전히 실패할 수 있습니다.

표 서식

InDesign 테이블 서식 지정 규칙에서 DITA의 동일한 테이블 서식 지정으로의 변환은 복잡한 프로세스입니다. 이는 DITA에서 사용되는 Oasis (CALS) 테이블 모델에서 제공하는 기본 옵션과 비교하여 소스 파일에서 사용할 수 있는 서식 기능이 풍부하기 때문입니다. [InDesign]는 [왼쪽 맞춤] 및 [오른쪽 맞춤]을 허용하지만 [균등 배치] 텍스트가 텍스트 방향에 따라 항상 균등 배치되지만, [세로 및 가로 텍스트 맞춤]이 제공되어 유사한 결과를 얻을 수 있습니다.

InDesign이 열 및 행 구분 기호를 처리하는 것이 Oasis 테이블 모델의 기본 옵션보다 훨씬 더 효율적입니다. InDesign은 테두리 유형 (단색 또는 패턴), 테두리 두께, 테두리 색상, 테두리 색조, 테두리 간격 색상 및 테두리 간격 색조의 네 가지 셀 테두리를 제공합니다. 이러한 모든 항목은 0 또는 1만 선택할 수 있는 각 셀 (entry element)의 오른쪽과 아래쪽에 있는 테두리에 매핑해야 합니다. 테두리를 숨기거나 테두리를 표시합니다.

InDesign의 국경 통제는 다음 수준에서 적용할 수 있습니다.

DITA에 대한 InDesign 변환 프로세스는 다음과 같이 테두리 결정을 적용합니다.

교대 패턴

InDesign 표 스타일을 사용하면 열과 셀 규칙이 교대 패턴을 따르도록 할 수 있습니다. 이 기능은 변환을 위해 지원되지만, 한 패턴 그룹이 결정 (1)을 표시하도록 매핑되고 다른 패턴 그룹이 결정 (0)을 숨기도록 매핑될 때만 결과가 명확해집니다.

InDesign-DITA 마이그레이션을 위한 매핑 파일 준비 id194AF0003HT

올바른 DITA 변환에는 소스 문서의 컨텐트와 일치하는 매핑 파일이 필요합니다. 비정형 InDesign 문서의 경우 사용 가능한 모든 단락 스타일과 문자 스타일을 매핑해야 합니다. XML 구조화된 InDesign 문서의 경우 연관된 DTD의 모든 요소를 매핑해야 합니다.

비정형 및 정형 InDesign 문서에 대한 매핑 파일이 다릅니다. 비정형 소스 콘텐츠를 DITA로 변환하는 데 필요한 처리 요구 사항이 복잡하기 때문입니다.

매핑 파일의 샘플은 아래에 나와 있습니다.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE styleMap SYSTEM "mapStyle.dtd">
<styleMap xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="mapStyle.xsd" >
   <doctypes>
      <mapDoctypeParaRule root="itpx:stories" mapToDoctype="map">
         <attributeRules createID="true">
            <addNew name="outputclass" value="map"/>
         </attributeRules>
      </mapDoctypeParaRule>
      <doctypeParaRule style="Heading 1" local="0" mapToDoctype="concept">
         <attributeRules createID="true"/>
      </doctypeParaRule>
      <doctypeParaRule style="Heading A" local="0" mapToDoctype="topic">
         <attributeRules createID="true"/>
      </doctypeParaRule>
   </doctypes>
   <wrappingRules>
      <wrap elements="li+" context="number" wrapper="ol">
         <attributeRules createID="true"/>
      </wrap>
      <wrap elements="li+" context="bullet" wrapper="ul">
         <attributeRules createID="true"/>
      </wrap>
   </wrappingRules>
   <paragraphStyleRules>
      <paraRule style="Heading 2" local="0"  mapTo="p">
         <attributeRules createID="true"/>
      </paraRule>
      <paraRule style="Heading 3" local="0"  mapTo="p">
         <attributeRules createID="true"/>
      </paraRule>
      <paraRule style="List Paragraph" local="p[-|-|-|-|-|b|-|-]" context="bullet" mapTo="li">
         <attributeRules createID="true"/>
      </paraRule>
      <paraRule style="List Paragraph" local="p[-|-|-|-|-|n|-|-]" context="number" mapTo="li">
         <attributeRules createID="true"/>
      </paraRule>
      <paraRule style="List Paragraph" local="0" context="bullet" mapTo="li">
         <attributeRules createID="true"/>
      </paraRule>
      <paraRule style="Normal" local="0"  mapTo="p">
         <attributeRules createID="true"/>
      </paraRule>
      <paraRule style="Normal" local="p[-|-|-|-|-|b|-|-]" context="bullet" mapTo="li">
         <attributeRules createID="true"/>
      </paraRule>
      <paraRule style="Title" local="0"  mapTo="p">
         <attributeRules createID="true"/>
      </paraRule>
   </paragraphStyleRules>
   <characterStyleRules>
      <charRule style="Bold" local="0" mapTo="b">
         <attributeRules createID="false"/>
      </charRule>
      <charRule style="Code" local="0" mapTo="codeph">
         <attributeRules createID="false"/>
      </charRule>
      <charRule style="[No character style]" local="c[Bold|-|-|-|-|-|-|-]" mapTo="b">
         <attributeRules createID="false"/>
      </charRule>
      <charRule style="[No character style]" local="c[Italic|-|-|-|-|-|-|-]" mapTo="i">
         <attributeRules createID="false"/>
      </charRule>
   </characterStyleRules>
</styleMap>

매핑 파일은 모든 소스 단락 스타일과 문자 스타일 코드를 나열하는 간단한 구조의 XML 파일입니다. 파일 내용은 아래에 설명되어 있습니다.

스타일 매핑

styleMap 요소에서 매핑 파일의 버전을 기록하기 위해 두 개의 선택적 특성 @map_date 및 @map_version을(를) 지정할 수 있습니다.

문서 유형

doctypes 요소는 지원되는 DITA 맵과 주제 매핑을 나열합니다.

문서 유형 단락 규칙 매핑

mapDoctypeParaRule 요소는 필수입니다. 원본 XML의 루트 요소가 항상 DITA 맵의 루트 map 요소에 매핑되므로 이 요소의 특성을 편집하면 안 됩니다.

문서 유형 단락 규칙

doctypeParaRule 요소는 필수입니다. 이렇게 하면 변환 프로세스에서 새 주제의 시작을 식별할 수 있습니다. 일반적으로 @style 특성은 단독으로 사용되며 @local 특성은 0으로 설정됩니다. 그러나 선택한 스타일에 항상 로컬 서식 재정의가 있는 경우 각 스타일과 로컬 재정의에 대한 규칙을 추가해야 합니다. 이렇게 하면 생성된 매핑 파일에서 다음 항목 또는 유사한 항목을 찾을 수 있음을 쉽게 알 수 있습니다.

<paraRule style="Heading 1" local="0" mapTo="p">
   <attributeRules createID="true"/>
</paraRule>
<paraRule style="Heading 1" local="p[Italic|-|-|-|-|-|-|-]" mapTo="p">
   <attributeRules createID="true"/>
</paraRule>

위의 예에는 @style = "Heading1"에 대한 두 개의 paraRule 요소가 있습니다. 필요에 따라 @mapToDoctype 특성이 설정된 동등한 doctypeParaRule 요소를 만들면 됩니다.

doctypeParaRule에 사용된 특성은 아래에 설명되어 있습니다.

요소 줄바꿈 규칙

요소 줄바꿈 규칙은 일련의 속성 값에 따라 들어오는 문서의 요소를 사전 정의된 요소로 줄바꿈하거나 이동하는 방법을 정의합니다.

wrap요소

선택적 요소입니다. wrap 요소는 래핑되거나 이동할 요소를 나열합니다. 래핑은 일반적으로 일련의 요소에 공통 상위 요소를 지정해야 하는 경우에 사용됩니다. 예를 들어 여러 li 요소가 ol 요소에 래핑됩니다. 또한 wrap은(는) 그림 및 표의 제목과 같은 요소를 이동하는 데 사용할 수 있습니다.

wrap에 사용된 특성은 아래에 설명되어 있습니다.

다음 예제에서는 title 및 image 요소에서 fig 요소를 만드는 방법을 보여 줍니다.

다음 예제에서는 title을(를) table(으)로 이동하는 방법을 보여 줍니다.

단락 스타일 규칙

<paragraphStyleRule> 요소는 아래에 설명되어 있습니다.

paraRule요소

paraRule 요소는 필수입니다. 모든 단락 스타일에 대한 매핑 규칙을 지정합니다. InDesign 문서에서 모든 텍스트는 단락 스타일의 하위 구조 내에 포함되어 있으며 스타일이 없는 단락의 이름은 [No paragraph style]입니다. 대괄호는 빌트인 InDesign 스타일 이름을 나타냅니다.

paraRule에 사용된 특성은 아래에 설명되어 있습니다.

문자 스타일 규칙

charRule 요소는 아래에 설명되어 있습니다.

charRule요소

선택적 요소입니다.

모든 문자 스타일에 대한 매핑 규칙입니다. InDesign 문서에서 모든 텍스트는 문자 스타일의 하위 요소 내에 포함되어 있습니다.

charRule에 사용된 특성은 아래에 설명되어 있습니다.

특성 규칙

이 요소는 다음 요소 컨텍스트의 하위 요소가 될 수 있습니다.

속성 규칙의 목적은 일치하는 요소의 속성을 관리하는 것입니다.

컨텍스트에 따라 attributeRules 요소에서 다음 특성을 사용할 수 있습니다.

attributeRules에 사용된 특성은 아래에 설명되어 있습니다.

로컬 서식 코드

모든 InDesign 문서에서 단락 스타일과 문자 스타일은 수백 개의 서로 다른 서식 재정의를 전달할 수 있습니다. 이러한 속성의 대부분은 전환 프로세스에서 유용한 역할을 제공하지 않습니다. 하지만 문서의 의미에 영향을 주고 변환 프로세스에 영향을 줘야 하는 서식 지정 기능의 핵심 세트를 확인했습니다.

@local 특성은 8개의 필드가 접두사와 함께 제공되어 서식 재정의 유형을 표시하는 특수 구분 형식으로 제공됩니다. 서식 코드 필드는 아래에 나열되어 있습니다.

이 기능을 신중하게 사용하면 로컬 서식이 손실되어 스타일이 지정된 콘텐츠에서 DITA로 전송되는 품질을 개선하는 데 도움이 될 수 있습니다. 이 예제는 글머리 기호 목록에서 기울임꼴, 16pt 텍스트를 의미하는 것으로 해석할 수 있습니다. p[Italic|16|-|-|-|b|-|-].

구조 매핑

구조 매핑 파일은 모든 소스 요소와 관련 속성 유형을 나열하는 간단한 구조의 스타일 매핑 파일과 유사합니다. 사용할 매핑 파일의 버전을 기록하기 위해 두 개의 특성 @map_date 및 @map_version이(가) 제공됩니다.

문서 유형

doctypes 요소는 지원되는 DITA 맵과 주제 매핑을 나열합니다.

문서 유형 요소 규칙 매핑

mapDoctypeElemRule 요소는 필수입니다. 원본 XML의 루트 요소가 항상 DITA 맵의 루트 map 요소에 매핑되므로 이 요소의 특성을 편집하면 안 됩니다.

요소 줄바꿈 규칙

elementRules요소 모든 요소를 나열합니다.

elementRule요소 elementRule 요소는 필수입니다. 모든 소스 요소에 대한 매핑 규칙입니다. InDesign 문서에 구조화되지 않은 스타일 요소가 포함되어 있지만 '하이브리드 모드' 처리를 사용하지 않는 한 구조화된 컨텐츠에 대해서는 이러한 요소가 무시됩니다.

elementRule에 사용된 특성은 아래에 설명되어 있습니다.

AEM Guides 문제 해결

AEM Guides을 설치하고 구성했으면 문제를 해결할 수 있습니다.

참조 유효성 검사

제공된 스크립트를 실행하여 참조를 확인할 수 있습니다. 이러한 스크립트는 손상된 참조를 식별한 다음 패치하거나 수정하는 데 도움이 될 수 있습니다.

스크립트 유효성 검사

제품 패키지에서 사용할 수 있는 유효성 검사 스크립트를 사용하여 참조를 확인하려면 다음 단계를 수행하십시오.

패치 스크립트

제품 패키지에서 사용할 수 있는 패치 스크립트를 사용하여 끊어진 참조를 패치하려면 다음 단계를 수행하십시오.

로거

아래 제공된 세부 정보에 따라 이 스크립트 실행에 대해 별도의 로거를 만들 수도 있습니다.

작성된 로그 파일은 스크립트 실행과 관련된 모든 정보를 기록하며 브라우저에서 스크립트를 트리거하는 동안 브라우저 세션 시간 초과에 유용합니다.