홈 탐색 도움말
로그인
bn
/
se
2
0
포크 0
파일 이슈 0 풀 리퀘스트 0 위키
트리: a4b429aad5
브랜치 태그
se
/
SE
/
schema
/
WPS_Functions
/
dita-ot
/
dita-ot-3.3.3
/
doc
/
topics
/
dita2dita.html

dita2dita.html 6.5 KB
히스토리 Raw

1234567891011121314151617181920212223242526272829303132333435363738394041 
  1. <!DOCTYPE html
    2. 

  2.   SYSTEM "about:legacy-compat">
    3. 

  3. <html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="UTF-8"><meta name="copyright" content="(C) Copyright 2019"><meta name="DC.rights.owner" content="(C) Copyright 2019"><meta name="DC.type" content="topic"><meta name="description" content="The dita transformation generates normalized topics and maps from DITA input. The normalized output includes the results of DITA Open Toolkit pre-processing operations, which resolve map references, keys, content references, code references and push metadata back and forth between maps and topics."><meta name="DC.subject" content="command, dita, normalized DITA, transformations, DITA, normalized, metadata, map, topic, plug-ins, dita2dita, relationship tables"><meta name="keywords" content="command, dita, normalized DITA, transformations, DITA, normalized, metadata, map, topic, plug-ins, dita2dita, relationship tables"><meta name="DC.relation" scheme="URI" content="../topics/output-formats.html"><meta name="DC.relation" scheme="URI" content="../parameters/parameters-base.html"><meta name="DC.format" content="HTML5"><meta name="DC.identifier" content="normalized-dita"><link rel="stylesheet" type="text/css" href="../css/commonltr.css"><link rel="stylesheet" type="text/css" href="../css/dita-ot-doc.css"><title>Normalized DITA</title></head><body id="normalized-dita"><header role="banner"><div class="header">
    4. 

  4.   <p>DITA Open Toolkit</p>
    5. 

  5.   <hr>
    6. 

  6. </div></header><nav role="toc"><ul><li><a href="../index.html">DITA Open Toolkit 3.3</a></li><li><a href="../release-notes/index.html">Release Notes</a></li><li><a href="../topics/installing-client.html">Installing DITA-OT</a></li><li><a href="../topics/alternative-input-formats.html">Authoring formats</a></li><li><a href="../topics/building-output.html">Building output</a><ul><li><a href="../topics/build-using-dita-command.html">Using the dita command</a></li><li><a href="../topics/publishing-with-ant.html">Using Ant</a></li><li><a href="../reference/java-api.html">Using the Java API</a></li><li><a href="../topics/output-formats.html">Output formats</a><ul><li><a href="../topics/dita2pdf.html">PDF</a></li><li><a href="../topics/dita2html5.html">HTML5</a></li><li><a href="../topics/dita2eclipsehelp.html">Eclipse help</a></li><li><a href="../topics/dita2htmlhelp.html">HTML Help</a></li><li><a href="../topics/dita2markdown.html">Markdown</a></li><li class="active"><a href="../topics/dita2dita.html">Normalized DITA</a></li><li><a href="../topics/dita2tocjs.html">TocJS</a></li><li><a href="../topics/dita2troff.html">troff</a></li><li><a href="../topics/dita2xhtml.html">XHTML</a></li></ul></li></ul></li><li><a href="../parameters/index.html">Setting parameters</a></li><li><a href="../topics/customizing.html">Customizing DITA-OT</a></li><li><a href="../topics/troubleshooting-overview.html">Troubleshooting</a></li><li><a href="../reference/index.html">Reference</a></li><li><a href="../topics/dita-and-dita-ot-resources.html">Resources</a></li></ul></nav><main role="main"><article role="article" aria-labelledby="ariaid-title1">
    7. 

  7.   <h1 class="title topictitle1" id="ariaid-title1">Normalized DITA</h1>
    8. 

  8.   
    9. 

  9.   
    10. 

  10. 

  11.   <div class="body"><p class="shortdesc">The <code class="ph codeph">dita</code> transformation generates normalized topics and maps from DITA input. The
    12. 

  12.     normalized output includes the results of DITA Open Toolkit pre-processing operations, which resolve map references,
    13. 

  13.     keys, content references, code references and push metadata back and forth between maps and topics.</p>
    14. 

  14.     <p class="p">In comparison to the source DITA files, the normalized DITA files are modified in the following ways:</p>
    15. 

  15.     <ul class="ul">
    16. 

  16.       <li class="li">References from one DITA map to another are resolved</li>
    17. 

  17.       <li class="li">Map-based links, such as those generated by map hierarchy and relationship tables, are added to the
    18. 

  18.         topics.</li>
    19. 

  19.       <li class="li">Link text is resolved.</li>
    20. 

  20.       <li class="li">Map attributes that cascade are made explicit on child elements.</li>
    21. 

  21.       <li class="li">Map metadata such as index entries and copyrights are pushed into topics.</li>
    22. 

  22.       <li class="li">Topic metadata such as navigation titles, link text and short descriptions are pulled from topics into the
    23. 

  23.         map.</li>
    24. 

  24.       <li class="li">XML comments are removed.</li>
    25. 

  25.     </ul>
    26. 

  26.     <section class="section" id="normalized-dita__applications"><h2 class="title sectiontitle">Applications</h2>
    27. 

  27.       
    28. 

  28.       <p class="p">Normalized output may be useful in situations where post-processing of DITA content is required, but the
    29. 

  29.         downstream systems are limited in their ability to resolve DITA references.</p></section>
    30. 

  30.     <section class="section" id="normalized-dita__generating-normalized-dita-output"><h2 class="title sectiontitle">Generating normalized DITA output</h2>
    31. 

  31.       
    32. 

  32.       <p class="p">Run the <span class="keyword cmdname">dita</span> command and set the value of the output <span class="keyword parmname">--format</span> option to
    33. 

  33.           <span class="keyword option">dita</span>:</p><pre class="pre codeblock"><code><span class="ph filepath"><var class="keyword varname">dita-ot-dir</var>/bin/<span class="keyword cmdname">dita</span></span> <span class="keyword parmname">--input</span>=<var class="keyword varname">input-file</var> <span class="keyword parmname">--format</span>=<span class="keyword option">dita</span></code></pre>
    34. 

  34.       <p class="p">where:</p>
    35. 

  35.       <ul class="ul">
    36. 

  36.         <li class="li"><span class="ph filepath"><var class="keyword varname">dita-ot-dir</var></span> is the DITA-OT installation directory.</li><li class="li"><var class="keyword varname">input-file</var> is the DITA map or DITA file that you want to
    37. 

  37.               process.</li>
    38. 

  38.       </ul>
    39. 

  39.     </section>
    40. 

  40.   </div>
    41. 

  41. <nav role="navigation" class="related-links"><div class="familylinks"><div class="parentlink"><strong>Parent topic:</strong> <a class="link" href="../topics/output-formats.html" title="DITA Open Toolkit ships with several core transformations that generate different output formats from DITA content. Each transformation represents an implementation of the processing that is defined by OASIS in the DITA specification.">DITA-OT transformations (output formats)</a></div></div><div class="linklist relinfo relref"><strong>Related reference</strong><br><ul class="linklist"><li class="linklist"><a class="link" href="../parameters/parameters-base.html" title="Certain parameters apply to all transformations that DITA Open Toolkit supports.">Common parameters</a></li></ul></div></nav></article></main></body></html>
    42.