se/SE/schema/WPS_Functions/dita-ot/dita-ot-3.5/docsrc/topics/migrating-to-1.5.4.dita

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
<!--  This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license.  -->

<reference id="ID" rev="1.5.4">

  <title>Migrating to release 1.5.4</title>
  <titlealts>
    <navtitle>To 1.5.4</navtitle>
  </titlealts>

  <shortdesc>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.</shortdesc>

  <prolog>
    <metadata>
      <keywords>
        <indexterm>deprecated features
          <indexterm><codeph>print_transtypes</codeph></indexterm></indexterm>
        <indexterm>deprecated features
          <indexterm><codeph>page-margin-left</codeph></indexterm></indexterm>
        <indexterm>deprecated features
          <indexterm><codeph>page-margin-right</codeph></indexterm></indexterm>
        <indexterm>languages
          <indexterm>supported</indexterm></indexterm>
        <indexterm>Finnish</indexterm>
        <indexterm>Hebrew</indexterm>
        <indexterm>Indonesian</indexterm>
        <indexterm>Kazakh</indexterm>
        <indexterm>Malay</indexterm>
        <indexterm>Romanian</indexterm>
        <indexterm>Russian</indexterm>
        <indexterm>Swedish</indexterm>
        <indexterm>I18N
          <indexterm><parmname>org.dita.pdf2.i18n.enabled</parmname></indexterm></indexterm>
      </keywords>
    </metadata>
  </prolog>

  <refbody>
    <section id="section_vc5_gld_g2">
      <title>Configuration properties file changes</title>
      <p>In previous versions, the <filepath>lib/configuration.properties</filepath> file was generated by the
        integration process. Integration has been changed to generate
          <filepath>lib/org.dita.dost.platform/plugin.properties</filepath> and the role of the old
          <filepath>lib/configuration.properties</filepath> has been changed to contain defaults and configuration
        options, such as default language.</p>
      <p>The <codeph>dita.plugin.org.dita.*.dir</codeph> properties have been changed to point to the DITA-OT base
        directory.</p>
      <p>To allow access to configuration files, the <filepath>lib</filepath> directory needs to be added to the Java
        classpath.</p>
    </section>
    <section>
      <title>New plug-in extension points </title>
      <p>New plug-in extension points have been added allow configuring DITA-OT behavior based on file extensions.</p>
      <table outputclass="table-hover" frame="none" colsep="0" rowsep="1">
        <tgroup cols="3">
          <colspec colwidth="1*"/>
          <colspec colwidth="1*"/>
          <colspec colwidth="1*"/>
          <thead>
            <row>
              <entry>Extension point</entry>
              <entry>Description</entry>
              <entry>Default values</entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry><parmname>dita.topic.extension</parmname></entry>
              <entry>DITA topic</entry>
              <entry><filepath>.dita</filepath>, <filepath>.xml</filepath></entry>
            </row>
            <row>
              <entry><parmname>dita.map.extensions</parmname></entry>
              <entry>DITA map</entry>
              <entry><filepath>.ditamap</filepath></entry>
            </row>
            <row>
              <entry><parmname>dita.html.extensions</parmname></entry>
              <entry>HTML file</entry>
              <entry><filepath>.html</filepath>, <filepath>.htm</filepath></entry>
            </row>
            <row>
              <entry><parmname>dita.resource.extensions</parmname></entry>
              <entry>Resource file</entry>
              <entry><filepath>.pdf</filepath>, <filepath>.swf</filepath></entry>
            </row>
          </tbody>
        </tgroup>
      </table>
      <p>Both HTML and resource file extensions are used to determine if a file in source is copied to output.</p>
      <p>A new plug-in extension point has been added to declare transformation types as print types.</p>
      <table outputclass="table-hover" frame="none" colsep="0" rowsep="1">
        <tgroup cols="2">
          <colspec colwidth="1*"/>
          <colspec colwidth="1*"/>
          <thead>
            <row>
              <entry>Extension point</entry>
              <entry>Description</entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry><parmname>dita.transtype.print</parmname></entry>
              <entry>Declare transformation type as a print type.</entry>
            </row>
          </tbody>
        </tgroup>
      </table>
      <p>The <codeph>print_transtypes</codeph> property in <filepath>integrator.properties</filepath> has been
        deprecated in favor of <parmname>dita.transtype.print</parmname>.</p>
    </section>
    <section>
      <title>Plugin URI scheme</title>
      <p>Support for the <keyword>plugin</keyword> URI scheme has been added to XSLT stylesheets. Plug-ins can refer to
        files in other plug-ins without hard-coding relative paths, for example: </p>
      <codeblock outputclass="language-xml" xml:space="preserve">&lt;xsl:import href="plugin:org.dita.pdf2:xsl/fo/topic2fo_1.0.xsl"/&gt;</codeblock>
    </section>
    <section>
      <title>XHTML</title>
      <p>Support for the following languages has been added:</p>
      <ul>
        <li>Indonesian</li>
        <li>Kazakh</li>
        <li>Malay</li>
      </ul>
    </section>
    <section>
      <title>PDF</title>
      <p>Support for mirrored page layout was added. The default is the unmirrored layout. The following XSLT
        configuration variables have been deprecated:</p>
      <ul id="ul_hkv_oyj_bd">
        <li><codeph>page-margin-left</codeph></li>
        <li><codeph>page-margin-right</codeph></li>
      </ul>
      <p>The following variables should be used instead to control page margins:</p>
      <ul id="ul_yda_wyj_bd">
        <li><codeph>page-margin-outside</codeph></li>
        <li><codeph>page-margin-inside</codeph></li>
      </ul>
      <p>The <parmname>args.bookmap-order</parmname> property has been added to control how front and back matter are
        processed in bookmaps. The default is to reorder the frontmatter content as in previous releases.</p>
      <p>A new extension point has been added to add mappings to the PDF configuration catalog file.</p>
      <table outputclass="table-hover" frame="none" colsep="0" rowsep="1">
        <tgroup cols="2">
          <colspec colwidth="1*"/>
          <colspec colwidth="1*"/>
          <thead>
            <row>
              <entry>Extension point</entry>
              <entry>Description</entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry><parmname>org.dita.pdf2.catalog.relative</parmname></entry>
              <entry>Configuration catalog includes.</entry>
            </row>
          </tbody>
        </tgroup>
      </table>
      <p>Support for the following languages has been added:</p>
      <ul>
        <li>Finnish</li>
        <li>Hebrew</li>
        <li>Romanian</li>
        <li>Russian</li>
        <li>Swedish</li>
      </ul>
      <p>PDF processing no longer copies images or generates XSL FO to output directory. Instead, the temporary
        directory is used for all temporary files and source images are read directly from source directory. The legacy
        processing model can be enabled by setting <parmname>org.dita.pdf2.use-out-temp</parmname> to
          <option>true</option> in configuration properties; support for the legacy processing model may be removed in
        future releases.</p>
      <p>Support for FrameMaker index syntax has been disabled by default. To enable FrameMaker index syntax, set
          <parmname>org.dita.pdf2.index.frame-markup</parmname> to <option>true</option> in configuration
        properties.</p>
      <p>A configuration option has been added to disable internationalization (I18N) font processing and use
        stylesheet-defined fonts. To disable I18N font processing, set <parmname>org.dita.pdf2.i18n.enabled</parmname>
        to <codeph>false</codeph> in configuration properties.</p>
      <p>The XSLT parameters <parmname>customizationDir</parmname> and <parmname>fileProfilePrefix</parmname> have been
        removed in favor of the <parmname>customizationDir.url</parmname> parameter.</p>
      <p>A new shell stylesheet has been added for FOP and other shell stylesheets have also been revised. Plug-ins
        which have their own shell stylesheets for PDF processing should make sure all required stylesheets are
        imported.</p>
      <p>Font family definitions in stylesheets have been changed from Sans, Serif, and Monospaced to sans-serif, serif,
        and monospace, respectively. The I18N font processing still uses the old logical names and aliases are used to
        map the new names to old ones. </p>
    </section>
  </refbody>
</reference>