<commit_before><?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.md file for applicable licenses.-->

<reference id="rel2.1" xml:lang="en">
  <title>DITA Open Toolkit 2.1 Release Notes</title>

  <shortdesc>DITA Open Toolkit 2.1 is a maintenance release that includes fixes for reported issues.</shortdesc>

  <!--
  <reference id="releasehighlights">
    <title>Release Highlights</title>
    <refbody>
      <section>
        <p>DITA Open Toolkit Release 2.1 includes the following significant enhancements: <ul>
            <li></li>
          </ul>
        </p>
        <p>For details on these and all other enhancements, see the sections below.</p>
      </section>
    </refbody>
  </reference>
  -->
  <!--
  <reference id="migration">
    <title>Migration From Previous Releases</title>
    <refbody>
      <section>
        <draft-comment author="jelovirt">TODO</draft-comment>
      </section>
    </refbody>
  </reference>
  -->
  <reference id="requirements">
    <title>Requirements</title>
    <refbody>
      <section>
        <draft-comment author="infotexture">Add info on new minimum Java version or any other requirements that have
          changed since previous release.</draft-comment>
        <p>DITA Open Toolkit Release 2.1 requires the Java Runtime Environment (JRE) or Java Development Kit (JDK),
          version <keyword keyref="tool.java.version"/> or later.</p>
      </section>
    </refbody>
  </reference>

  <reference id="rel2.1.issues">
    <title>Resolved Issues</title>
    <shortdesc>The following items are included in DITA Open Toolkit Release 2.1. Issue numbers correspond to the
      tracking number in the <ph><xref keyref="dita-ot-issues" scope="external">GitHub issues
      tracker</xref></ph>.</shortdesc>
    <refbody>
      <!--
      <section>
        <title>Extended Preview Support for DITA 1.3</title>
        <ul>
          <li></li>
        </ul>
      </section>
      -->
      <section>
        <title>Feature Requests</title>
        <p>DITA Open Toolkit Release 2.1 includes the following new features and changes:</p>
        <ul>
          <li>
            <p>In PDF output, inline <codeph>&lt;codeph></codeph> elements in topic titles now inherit the font size
              from the surrounding title text. <ul>
                <li>
                  <xref href="https://github.com/dita-ot/dita-ot/issues/1874" format="html" scope="external">1874</xref>
                  Codephrase used in topic title has very small font </li>
              </ul>
            </p>
          </li>
          <li>
            <p>Image metadata processing has been refactored to improve the processing speed by determining width and
              height without reading the entire image into memory. <ul>
                <li>
                  <xref href="https://github.com/dita-ot/dita-ot/issues/1883" format="html" scope="external">1883</xref>
                  Faster implementation for ImgUtils.getWidth/getHeight </li>
              </ul>
            </p>
          </li>
          <li>
            <p> Obsolete CHM configuration files have been removed from the PDF2 plugin. <ul>
                <li>
                  <xref href="https://github.com/dita-ot/dita-ot/issues/1897" format="html" scope="external">1897</xref>
                  DITA OT 2.1.dev chm properties folder in org.dita.pdf2 </li>
              </ul>
            </p>
          </li>
        </ul>
        <p>Milestone 1 included the following new features and changes:</p>
        <ul>
          <li>
            <p>The <codeph>chapterBody</codeph> XSL template mode has been refactored to create additional HTML5 groups
              in the generated HTML <codeph>&lt;body></codeph> element. </p>
            <p>DITA topics are now mapped to the HTML5 <codeph>&lt;article></codeph> element, DITA
                <codeph>&lt;section></codeph> to <codeph>&lt;section></codeph>, and DITA <codeph>&lt;fig></codeph> to
                <codeph>&lt;figure></codeph>. </p>
            <p>HTML5 <codeph>@aria-labelledby</codeph> accessibility attributes are also generated to associate each
              article with its heading. This helps to improve the accessibility and interoperability of HTML output by
              providing structural information to assistive technologies such as screen readers. <ul>
                <li>
                  <xref href="https://github.com/dita-ot/dita-ot/issues/1179" format="html" scope="external">1179</xref>
                  Added HTML generation extension for body content</li>
              </ul>
            </p>
          </li>
          <li>
            <xref href="https://github.com/dita-ot/dita-ot/issues/1687" format="html" scope="external">1687</xref> More
            recognized default resource extensions in the plugins base</li>
          <li>
            <xref href="https://github.com/dita-ot/dita-ot/issues/1703" format="html" scope="external">1703</xref> Link
            to missing DITAVAL file should show a relevant error code in the console</li>
          <li>
            <xref href="https://github.com/dita-ot/dita-ot/issues/1799" format="html" scope="external">1799</xref> Move
            configuration options to runtime properties</li>
          <li>
            <xref href="https://github.com/dita-ot/dita-ot/issues/1800" format="html" scope="external">1800</xref>
            Remove old Java command line tool</li>
          <li>
            <xref href="https://github.com/dita-ot/dita-ot/issues/1803" format="html" scope="external">1803</xref> Use
            Commons IO</li>
          <li>
            <xref href="https://github.com/dita-ot/dita-ot/issues/1832" format="html" scope="external">1832</xref>
            Remove support for args.odt.img.embed</li>
          <li>
            <xref href="https://github.com/dita-ot/dita-ot/issues/1837" format="html" scope="external">1837</xref>
            Remove keydef processing from XHTML rendering code</li>
          <li>
            <xref href="https://github.com/dita-ot/dita-ot/issues/1847" format="html" scope="external">1847</xref>
            Extension-point for custom DITA parsers</li>
        </ul>
      </section>
      <section>
        <title>Bugs</title>
        <p>DITA Open Toolkit Release 2.1 provides fixes for the following bugs:</p>
        <ul>
          <li><xref href="https://github.com/dita-ot/dita-ot/issues/1513" format="html" scope="external">1513</xref>
            Suspected memory leak in OT bug preprocess</li>
          <li><xref href="https://github.com/dita-ot/dita-ot/issues/1694" format="html" scope="external">1694</xref>
            Cannot convert string to double</li>
          <li><xref href="https://github.com/dita-ot/dita-ot/issues/1854" format="html" scope="external">1854</xref>
            integrator.xml should also load the necessary "commons-io.jar" </li>
          <li><xref href="https://github.com/dita-ot/dita-ot/issues/1870" format="html" scope="external">1870</xref>
            PDF2 output plugin fails rendering tables </li>
          <li><xref href="https://github.com/dita-ot/dita-ot/issues/1872" format="html" scope="external">1872</xref>
            Link to index term repeats itself </li>
          <li><xref href="https://github.com/dita-ot/dita-ot/issues/1877" format="html" scope="external">1877</xref><commit_msg>Annotate additional issues resolved in v2.1<commit_after><?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.md file for applicable licenses.-->

<reference id="rel2.1" xml:lang="en">
  <title>DITA Open Toolkit 2.1 Release Notes</title>

  <shortdesc>DITA Open Toolkit 2.1 is a maintenance release that includes fixes for reported issues.</shortdesc>

  <!--
  <reference id="releasehighlights">
    <title>Release Highlights</title>
    <refbody>
      <section>
        <p>DITA Open Toolkit Release 2.1 includes the following significant enhancements: <ul>
            <li></li>
          </ul>
        </p>
        <p>For details on these and all other enhancements, see the sections below.</p>
      </section>
    </refbody>
  </reference>
  -->
  <!--
  <reference id="migration">
    <title>Migration From Previous Releases</title>
    <refbody>
      <section>
        <draft-comment author="jelovirt">TODO</draft-comment>
      </section>
    </refbody>
  </reference>
  -->
  <reference id="requirements">
    <title>Requirements</title>
    <refbody>
      <section>
        <draft-comment author="infotexture">Add info on new minimum Java version or any other requirements that have
          changed since previous release.</draft-comment>
        <p>DITA Open Toolkit Release 2.1 requires the Java Runtime Environment (JRE) or Java Development Kit (JDK),
          version <keyword keyref="tool.java.version"/> or later.</p>
      </section>
    </refbody>
  </reference>

  <reference id="rel2.1.issues">
    <title>Resolved Issues</title>
    <shortdesc>The following items are included in DITA Open Toolkit Release 2.1. Issue numbers correspond to the
      tracking number in the <ph><xref keyref="dita-ot-issues" scope="external">GitHub issues
      tracker</xref></ph>.</shortdesc>
    <refbody>
      <!--
      <section>
        <title>Extended Preview Support for DITA 1.3</title>
        <ul>
          <li></li>
        </ul>
      </section>
      -->
      <section>
        <title>Feature Requests</title>
        <p>DITA Open Toolkit Release 2.1 includes the following new features and changes:</p>
        <ul>
          <li>
            <p>In PDF output, inline <codeph>&lt;codeph></codeph> elements in topic titles now inherit the font size
              from the surrounding title text. <ul>
                <li>
                  <xref href="https://github.com/dita-ot/dita-ot/issues/1874" format="html" scope="external">1874</xref>
                  Codephrase used in topic title has very small font </li>
              </ul>
            </p>
          </li>
          <li>
            <p>Image metadata processing has been refactored to improve the processing speed by determining width and
              height without reading the entire image into memory. <ul>
                <li>
                  <xref href="https://github.com/dita-ot/dita-ot/issues/1883" format="html" scope="external">1883</xref>
                  Faster implementation for ImgUtils.getWidth/getHeight </li>
              </ul>
            </p>
          </li>
          <li>
            <p> Obsolete CHM configuration files have been removed from the PDF2 plugin. <ul>
                <li>
                  <xref href="https://github.com/dita-ot/dita-ot/issues/1897" format="html" scope="external">1897</xref>
                  DITA OT 2.1.dev chm properties folder in org.dita.pdf2 </li>
              </ul>
            </p>
          </li>
        </ul>
        <p>Milestone 1 included the following new features and changes:</p>
        <ul>
          <li>
            <p>The <codeph>chapterBody</codeph> XSL template mode has been refactored to create additional HTML5 groups
              in the generated HTML <codeph>&lt;body></codeph> element. </p>
            <p>DITA topics are now mapped to the HTML5 <codeph>&lt;article></codeph> element, DITA
                <codeph>&lt;section></codeph> to <codeph>&lt;section></codeph>, and DITA <codeph>&lt;fig></codeph> to
                <codeph>&lt;figure></codeph>. </p>
            <p>HTML5 <codeph>@aria-labelledby</codeph> accessibility attributes are also generated to associate each
              article with its heading. This helps to improve the accessibility and interoperability of HTML output by
              providing structural information to assistive technologies such as screen readers. <ul>
                <li>
                  <xref href="https://github.com/dita-ot/dita-ot/issues/1179" format="html" scope="external">1179</xref>
                  Added HTML generation extension for body content</li>
              </ul>
            </p>
          </li>
          <li>
            <p>Additional file formats referenced from <codeph>&lt;image></codeph> elements are now copied to output.
              Any references that are not DITA, DITA map, or image, are now treated as resources and also copied, so you
              no longer need extra <codeph>&lt;copy></codeph> operations in your project build scripts to include such
              assets in output. <ul>
                <li>
                  <xref href="https://github.com/dita-ot/dita-ot/issues/1687" format="html" scope="external">1687</xref>
                  More recognized default resource extensions in the plugins base</li>
              </ul>
            </p>
          </li>
          <li>
            <p>DITA-OT now fails with a fatal error (DOTA013F) if a specified .ditaval filter file is not available.
              This ensures that unexpected output is not generated if the filter file is missing or invalid. <ul>
                <li>
                  <xref href="https://github.com/dita-ot/dita-ot/issues/1703" format="html" scope="external">1703</xref>
                  Link to missing DITAVAL file should show a relevant error code in the console</li>
              </ul>
            </p>
          </li>
          <li>
            <p>The <parmname>generate-debug-attributes</parmname> and <parmname>processing-mode</parmname> configuration
              options have been moved to runtime properties, so you can now pass these parameters at build time to
              specify whether the <codeph>@xtrf</codeph> and <codeph>@xtrc</codeph> debugging attributes should be
              generated, and how the DITA-OT handles errors and error recovery. For more information, see <xref
                href="../parameters/ant-parameters-base-transformation.dita#ant-parameters-base-transformation">common
                Ant paramters</xref>. <ul>
                <li>
                  <xref href="https://github.com/dita-ot/dita-ot/issues/1799" format="html" scope="external">1799</xref>
                  Move configuration options to runtime properties</li>
              </ul></p>
          </li>
          <li>
            <p>The deprecated Java command line tool has been removed in favor of the <cmdname>dita</cmdname> command introduced
              in DITA-OT 2.0. </p>
            <p>If you previously generated output via a Java command sequence such as
              <codeblock><cmdname>java</cmdname> -jar lib/dost.jar /i:<varname>input-file</varname> /transtype:<varname>transformation-type</varname> /<varname>parameter-name</varname>:<varname>value</varname></codeblock>
              you should now use the following syntax instead: <codeblock><cmdname>dita</cmdname> -f <varname>transformation-type</varname> -i <varname>input-file</varname> -o <varname>output-dir</varname></codeblock>
              <ul>
                <li>
                  <xref href="https://github.com/dita-ot/dita-ot/issues/1800" format="html" scope="external">1800</xref>
                  Remove old Java command line tool </li>
              </ul>
            </p>
          </li>
          <li>
            <xref href="https://github.com/dita-ot/dita-ot/issues/1803" format="html" scope="external">1803</xref> Use
            Commons IO</li>
          <li>
            <xref href="https://github.com/dita-ot/dita-ot/issues/1832" format="html" scope="external">1832</xref>
            Remove support for args.odt.img.embed</li>
          <li>
            <xref href="https://github.com/dita-ot/dita-ot/issues/1837" format="html" scope="external">1837</xref>
            Remove keydef processing from XHTML rendering code</li>
          <li>
            <xref href="https://github.com/dita-ot/dita-ot/issues/1847" format="html" scope="external">1847</xref>
            Extension-point for custom DITA parsers</li>
        </ul>
      </section>
      <section>
        <title>Bugs</title>
        <p>DITA Open Toolkit Release 2.1 provides fixes for the following bugs:</p>
        <ul>
          <li><xref href="https://github.com/dita-ot/dita-ot/issues/1513" format="html" scope="external">1513</xref>
            Suspected memory leak in OT bug preprocess</li>
          <li><xref href="https://github.com/dita-ot/dita-ot/issues/1694" format="html" scope="external">1694</xref>
            Cannot convert string to double</li>
          <li><xref href="https://github.com/dita-ot/dita-ot/issues/1854" format="html" scope="external">1854</xref>
            integrator.xml should also load the necessary "commons-io.jar" </li>
          <li><xref href="https://github.com/dita-ot/dita-ot/issues/1870" format="html" scope="external">1870</xref>
            PDF2 output plugin fails rendering tables </li>
          <li><xref href="https://github.com/dita-ot/dita-ot/issues/1872" format="html" scope="external">1872</xref>
            Link to index term repeats itself </li>
          <li><xref href="https://github.com/dita-ot/dita-ot/issues/1877" format="html" scope="external">1877</xref>
{'fraction_non_alphanumeric': 0.1299444829979181, 'fraction_numerical': 0.020761045570205874, 'mean_word_length': 2.2764304660856385, 'pattern_counts': {'":': 0, '<': 473, '<?xml version=': 2, '>': 489, 'https://': 36, 'lorem ipsum': 0, 'www.': 0, 'xml': 6}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6168871', 'n_tokens_mistral': 5293, 'n_tokens_neox': 4988, 'n_words': 1378}