Inicio Explorar Axuda
Iniciar sesión
bn
/
se
2
0
Fork 0
Ficheiros Incidencias 0 Pull Requests 0 Wiki
Árbore: e89bfafc3a
Ramas Etiquetas
se
/
SE
/
stuff
/
dita-ot-2.3.3
/
doc
/
dev_ref
/
migrating-to-1.5.4.html

migrating-to-1.5.4.html 13 KB
Histórico Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129 
  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 2016"><meta name="DC.rights.owner" content="(C) Copyright 2016"><meta name="DC.Type" content="reference"><meta name="description" content="DITA-OT 1.5.4 adds new extension points to configure behavior based on file extensions, declare print transformation types and add mappings to the PDF configuration catalog file. PDF output supports mirrored page layout and uses new font family definitions. Support for several new languages was added for PDF and XHTML output."><meta name="DC.Relation" scheme="URI" content="../dev_ref/migration.html"><meta name="DC.Format" content="XHTML"><meta name="DC.Identifier" content="ID"><link rel="stylesheet" type="text/css" href="../css/commonltr.css"><link rel="stylesheet" type="text/css" href="../css/dita-ot-doc.css"><title>Migrating to release 1.5.4</title></head><body id="ID"><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 2.3</a></li><li><a href="../release-notes/index.html">Release Notes</a></li><li><a href="../getting-started/index.html">Getting Started</a></li><li><a href="../user-guide/index.html">User Guide</a></li><li><a href="../parameters/index.html">Parameter Reference</a></li><li><a href="../dev_ref/index.html">Developer Reference</a><ul><li><a href="../dev_ref/DITA-OTArchitecture.html">DITA-OT Architecture</a></li><li><a href="../dev_ref/extending-the-ot.html">Extending the DITA-OT</a></li><li><a href="../dev_ref/plugin-creating.html">Creating plug-ins</a></li><li><a href="../dev_ref/plugin-extension-points.html">Extension points</a></li><li><a href="../dev_ref/pdf-customization.html">Customizing PDF output</a></li><li><a href="../dev_ref/migration.html">Migrating customizations</a><ul><li><a href="../dev_ref/migrating-to-2.3.html">To 2.3</a></li><li><a href="../dev_ref/migrating-to-2.2.html">To 2.2</a></li><li><a href="../dev_ref/migrating-to-2.1.html">To 2.1</a></li><li><a href="../dev_ref/migrating-to-2.0.html">To 2.0</a></li><li><a href="../dev_ref/migrating-to-1.8.html">To 1.8</a></li><li><a href="../dev_ref/migrating-to-1.7.html">To 1.7</a></li><li><a href="../dev_ref/migrating-to-1.6.html">To 1.6</a></li><li class="active"><a href="../dev_ref/migrating-to-1.5.4.html">To 1.5.4</a></li></ul></li></ul></li><li><a href="../user-guide/dita-and-dita-ot-resources.html">DITA Resources</a></li></ul></nav><main role="main"><article role="article" aria-labelledby="ariaid-title1">
    7. 

  7. 

  8.   <h1 class="title topictitle1" id="ariaid-title1">Migrating to release 1.5.4</h1>
    9. 

  9. 

  10.   
    11. 

  11. 

  12.   <div class="body refbody"><p class="shortdesc">DITA-OT 1.5.4 adds new extension points to configure behavior based on file extensions, declare print
    13. 

  13.     transformation types and add mappings to the PDF configuration catalog file. PDF output supports mirrored page
    14. 

  14.     layout and uses new font family definitions. Support for several new languages was added for PDF and XHTML
    15. 

  15.     output.</p>
    16. 

  16.     <section class="section" id="ID__section_vc5_gld_g2"><h2 class="title sectiontitle">Configuration properties file changes</h2>
    17. 

  17.       
    18. 

  18.       <p class="p">In previous versions, the <span class="ph filepath">lib/configuration.properties</span> file was generated by the
    19. 

  19.         integration process. Integration has been changed to generate
    20. 

  20.           <span class="ph filepath">lib/org.dita.dost.platform/plugin.properties</span> and the role of the old
    21. 

  21.           <span class="ph filepath">lib/configuration.properties</span> has been changed to contain defaults and configuration
    22. 

  22.         options, such as default language.</p>
    23. 

  23.       <p class="p">The <code class="ph codeph">dita.plugin.org.dita.*.dir</code> properties have been changed to point to the DITA-OT base
    24. 

  24.         directory.</p>
    25. 

  25.       <p class="p">To allow access to configuration files, the <span class="ph filepath">lib</span> directory needs to be added to the Java
    26. 

  26.         classpath.</p>
    27. 

  27.     </section>
    28. 

  28.     <section class="section"><h2 class="title sectiontitle">New plug-in extension points </h2>
    29. 

  29.       
    30. 

  30.       <p class="p">New plug-in extension points have been added allow configuring DITA-OT behavior based on file extensions.</p>
    31. 

  31.       <table class="simpletable" id="ID__simpletable_xym_ryi_uc"><col style="width:33.33333333333333%"><col style="width:33.33333333333333%"><col style="width:33.33333333333333%"><thead><tr class="sthead">
    32. 

  32.           <th class="stentry" id="ID__simpletable_xym_ryi_uc__stentry__1">Extension point</th>
    33. 

  33.           <th class="stentry" id="ID__simpletable_xym_ryi_uc__stentry__2">Description</th>
    34. 

  34.           <th class="stentry" id="ID__simpletable_xym_ryi_uc__stentry__3">Default values</th>
    35. 

  35.         </tr></thead><tbody><tr class="strow">
    36. 

  36.           <td class="stentry" headers="ID__simpletable_xym_ryi_uc__stentry__1"><code class="ph codeph">dita.topic.extension</code></td>
    37. 

  37.           <td class="stentry" headers="ID__simpletable_xym_ryi_uc__stentry__2">DITA topic</td>
    38. 

  38.           <td class="stentry" headers="ID__simpletable_xym_ryi_uc__stentry__3"><span class="ph filepath">.dita</span>, <span class="ph filepath">.xml</span></td>
    39. 

  39.         </tr><tr class="strow">
    40. 

  40.           <td class="stentry" headers="ID__simpletable_xym_ryi_uc__stentry__1"><code class="ph codeph">dita.map.extensions</code></td>
    41. 

  41.           <td class="stentry" headers="ID__simpletable_xym_ryi_uc__stentry__2">DITA map</td>
    42. 

  42.           <td class="stentry" headers="ID__simpletable_xym_ryi_uc__stentry__3"><span class="ph filepath">.ditamap</span></td>
    43. 

  43.         </tr><tr class="strow">
    44. 

  44.           <td class="stentry" headers="ID__simpletable_xym_ryi_uc__stentry__1"><code class="ph codeph">dita.html.extensions</code></td>
    45. 

  45.           <td class="stentry" headers="ID__simpletable_xym_ryi_uc__stentry__2">HTML file</td>
    46. 

  46.           <td class="stentry" headers="ID__simpletable_xym_ryi_uc__stentry__3"><span class="ph filepath">.html</span>, <span class="ph filepath">.htm</span></td>
    47. 

  47.         </tr><tr class="strow">
    48. 

  48.           <td class="stentry" headers="ID__simpletable_xym_ryi_uc__stentry__1"><code class="ph codeph">dita.resource.extensions</code></td>
    49. 

  49.           <td class="stentry" headers="ID__simpletable_xym_ryi_uc__stentry__2">Resource file</td>
    50. 

  50.           <td class="stentry" headers="ID__simpletable_xym_ryi_uc__stentry__3"><span class="ph filepath">.pdf</span>, <span class="ph filepath">.swf</span></td>
    51. 

  51.         </tr></tbody></table>
    52. 

  52.       <p class="p">Both HTML and resource file extensions are used to determine if a file in source is copied to output.</p>
    53. 

  53.       <p class="p">A new plug-in extension point has been added to declare transformation types as print types.</p>
    54. 

  54.       <table class="simpletable" id="ID__simpletable_xts_5wq_rt"><col style="width:50%"><col style="width:50%"><thead><tr class="sthead">
    55. 

  55.           <th class="stentry" id="ID__simpletable_xts_5wq_rt__stentry__1">Extension point</th>
    56. 

  56.           <th class="stentry" id="ID__simpletable_xts_5wq_rt__stentry__2">Description</th>
    57. 

  57.         </tr></thead><tbody><tr class="strow">
    58. 

  58.           <td class="stentry" headers="ID__simpletable_xts_5wq_rt__stentry__1"><code class="ph codeph">dita.transtype.print</code></td>
    59. 

  59.           <td class="stentry" headers="ID__simpletable_xts_5wq_rt__stentry__2">Declare transformation type as a print type.</td>
    60. 

  60.         </tr></tbody></table>
    61. 

  61.       <p class="p">The <code class="ph codeph">print_transtypes</code> property in <span class="ph filepath">integrator.properties</span> has been
    62. 

  62.         deprecated in favor of <code class="ph codeph">dita.transtype.print</code>.</p>
    63. 

  63.     </section>
    64. 

  64.     <section class="section"><h2 class="title sectiontitle">Plugin URI scheme</h2>
    65. 

  65.       
    66. 

  66.       <p class="p">Support for the <span class="keyword">plugin</span> URI scheme has been added to XSLT stylesheets. Plug-ins can refer to
    67. 

  67.         files in other plug-ins without hard-coding relative paths, for example: </p>
    68. 

  68.       <pre class="pre codeblock"><code>&lt;xsl:import href="plugin:org.dita.pdf2:xsl/fo/topic2fo_1.0.xsl"/&gt;</code></pre>
    69. 

  69.     </section>
    70. 

  70.     <section class="section"><h2 class="title sectiontitle">XHTML</h2>
    71. 

  71.       
    72. 

  72.       <p class="p">Support for the following languages has been added:</p>
    73. 

  73.       <ul class="ul">
    74. 

  74.         <li class="li">Indonesian</li>
    75. 

  75.         <li class="li">Kazakh</li>
    76. 

  76.         <li class="li">Malay</li>
    77. 

  77.       </ul>
    78. 

  78.     </section>
    79. 

  79.     <section class="section"><h2 class="title sectiontitle">PDF</h2>
    80. 

  80.       
    81. 

  81.       <p class="p">Support for mirrored page layout was added. The default is the unmirrored layout. The following XSLT
    82. 

  82.         configuration variables have been deprecated:</p>
    83. 

  83.       <ul class="ul" id="ID__ul_hkv_oyj_bd">
    84. 

  84.         <li class="li"><code class="ph codeph">page-margin-left</code></li>
    85. 

  85.         <li class="li"><code class="ph codeph">page-margin-right</code></li>
    86. 

  86.       </ul>
    87. 

  87.       <p class="p">The following variables should be used instead to control page margins:</p>
    88. 

  88.       <ul class="ul" id="ID__ul_yda_wyj_bd">
    89. 

  89.         <li class="li"><code class="ph codeph">page-margin-outside</code></li>
    90. 

  90.         <li class="li"><code class="ph codeph">page-margin-inside</code></li>
    91. 

  91.       </ul>
    92. 

  92.       <p class="p">The <code class="ph codeph">args.bookmap-order</code> property has been added to control how front and back matter are
    93. 

  93.         processed in bookmaps. The default is to reorder the frontmatter content as in previous releases.</p>
    94. 

  94.       <p class="p">A new extension point has been added to add mappings to the PDF configuration catalog file.</p>
    95. 

  95.       <table class="simpletable" id="ID__simpletable_jkf_bxq_rt"><col style="width:50%"><col style="width:50%"><thead><tr class="sthead">
    96. 

  96.           <th class="stentry" id="ID__simpletable_jkf_bxq_rt__stentry__1">Extension point</th>
    97. 

  97.           <th class="stentry" id="ID__simpletable_jkf_bxq_rt__stentry__2">Description</th>
    98. 

  98.         </tr></thead><tbody><tr class="strow">
    99. 

  99.           <td class="stentry" headers="ID__simpletable_jkf_bxq_rt__stentry__1"><code class="ph codeph">org.dita.pdf2.catalog.relative</code></td>
    100. 

  100.           <td class="stentry" headers="ID__simpletable_jkf_bxq_rt__stentry__2">Configuration catalog includes.</td>
    101. 

  101.         </tr></tbody></table>
    102. 

  102.       <p class="p">Support for the following languages has been added:</p>
    103. 

  103.       <ul class="ul">
    104. 

  104.         <li class="li">Finnish</li>
    105. 

  105.         <li class="li">Hebrew</li>
    106. 

  106.         <li class="li">Romanian</li>
    107. 

  107.         <li class="li">Russian</li>
    108. 

  108.         <li class="li">Swedish</li>
    109. 

  109.       </ul>
    110. 

  110.       <p class="p">PDF processing no longer copies images or generates XSL FO to output directory. Instead, the temporary
    111. 

  111.         directory is used for all temporary files and source images are read directly from source directory. The legacy
    112. 

  112.         processing model can be enabled by setting <code class="ph codeph">org.dita.pdf2.use-out-temp</code> to <code class="ph codeph">true</code>
    113. 

  113.         in configuration properties; support for the legacy processing model may be removed in future releases.</p>
    114. 

  114.       <p class="p">Support for FrameMaker index syntax has been disabled by default. To enable FrameMaker index syntax, set
    115. 

  115.           <code class="ph codeph">org.dita.pdf2.index.frame-markup</code> to <code class="ph codeph">true</code> in configuration properties.</p>
    116. 

  116.       <p class="p">A configuration option has been added to disable internationalization (I18N) font processing and use
    117. 

  117.         stylesheet-defined fonts. To disable I18N font processing, set <code class="ph codeph">org.dita.pdf2.i18n.enabled</code> to
    118. 

  118.           <code class="ph codeph">false</code> in configuration properties.</p>
    119. 

  119.       <p class="p">The XSLT parameters <code class="ph codeph">customizationDir</code> and <code class="ph codeph">fileProfilePrefix</code> have been removed
    120. 

  120.         in favor of the <code class="ph codeph">customizationDir.url</code> parameter.</p>
    121. 

  121.       <p class="p">A new shell stylesheet has been added for FOP and other shell stylesheets have also been revised. Plug-ins
    122. 

  122.         which have their own shell stylesheets for PDF processing should make sure all required stylesheets are
    123. 

  123.         imported.</p>
    124. 

  124.       <p class="p">Font family definitions in stylesheets have been changed from Sans, Serif, and Monospaced to sans-serif, serif,
    125. 

  125.         and monospace, respectively. The I18N font processing still uses the old logical names and aliases are used to
    126. 

  126.         map the new names to old ones. </p>
    127. 

  127.     </section>
    128. 

  128.   </div>
    129. 

  129. <nav role="navigation" class="related-links"><div class="familylinks"><div class="parentlink"><strong>Parent topic:</strong> <a class="link" href="../dev_ref/migration.html" title="If you have XSL transformation overrides, plug-ins or other customizations written prior to DITA-OT 2.3, you may need to make changes to ensure your overrides work properly with the latest toolkit versions.">Migrating customizations</a></div></div></nav></article></main></body></html>
    130.