<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 file for applicable license.  -->

<reference id="ID" rev="2.5">
  <title>DITA Open Toolkit <keyword keyref="maintenance-version"/> Release Notes</title>

  <abstract>
    <shortdesc>DITA Open Toolkit <keyword keyref="maintenance-version"/> is a maintenance release that fixes issues
      reported in DITA-OT <keyword keyref="release"/>, which includes <ph conref="#highlights/summary"/>.</shortdesc>
    <note type="tip"><ph conref="../resources/conref-task.dita#ID/download-ot"/></note>
  </abstract>

  <reference id="v254">
    <title>Maintenance Release <keyword keyref="maintenance-version"/></title>
    <refbody>
      <section>
        <p>DITA Open Toolkit Release <keyword keyref="maintenance-version"/> includes the following bug fixes.</p>
        <ul>
          <li id="2772">In DITA-OT 2.5, external cross references to DITA topics, such as
            <codeph>&lt;xref href="http://example.com/onlineTopic.dita" scope="external"&gt;</codeph>,
            result in build failures due to an improperly set XSLT variable.
            <xref href="https://github.com/dita-ot/dita-ot/issues/2772" format="html" scope="external">#2772</xref>
          </li>
          <li id="2795">External links inside of <xmlelement>related-links</xmlelement> are dropped from PDF
            output in DITA-OT 2.4 and 2.5. These links now appear using the <xmlatt>href</xmlatt> attribute
            value as link text, as in earlier releases.
            <xref href="https://github.com/dita-ot/dita-ot/issues/2795" format="html" scope="external">#2795</xref>,
            <xref href="https://github.com/dita-ot/dita-ot/pull/2802" format="html" scope="external">#2802</xref>
          </li>
          <li id="2800">In DITA-OT 2.5, cross references within the same document, such as
            <codeph>&lt;xref href="#topicid/sampleFigure"/&gt;</codeph>, cause build errors
            when the build parameter <parmname>onlytopic.in.map</parmname> is set to true.
            <xref href="https://github.com/dita-ot/dita-ot/issues/2800" format="html" scope="external">#2800</xref>
          </li>
          <li id="2801">In DITA-OT 2.4 and 2.5, the <xmlelement>property</xmlelement> in reference topics resulted in an
            "Ambiguous rule match" message from Saxon when building HTML5. This message has been removed.
            <xref href="https://github.com/dita-ot/dita-ot/pull/2801" format="html" scope="external">#2801</xref>
          </li>
          <li id="2803">In earlier releases, plugins that contributed variables (or strings) did not work
            when the variables were contributed with mixed case (such as <codeph>pt-BR</codeph> instead of
            <codeph>pt-pt</codeph>. This has been fixed, so that the case of <xmlatt>xml:lang</xmlatt> is
            ignored when contributing variables.
            <xref href="https://github.com/dita-ot/dita-ot/issues/2226" format="html" scope="external">#2226</xref>,
            <xref href="https://github.com/dita-ot/dita-ot/issues/2790" format="html" scope="external">#2790</xref>,
            <xref href="https://github.com/dita-ot/dita-ot/pull/2803" format="html" scope="external">#2803</xref>
          </li>
          <li id="2805">In earlier releases, when <codeph>chunk="by-topic"</codeph> was specified on a 
            <xmlelement>topicref</xmlelement> element that did not specify the <xmlatt>href</xmlatt> attribute, 
            the build would end in a null pointer error. This error has been removed and the build will continue.
            <xref href="https://github.com/dita-ot/dita-ot/pull/2805" format="html" scope="external">#2805</xref>
          </li>
          <li id="2806">In earlier releases, when a map reference (such as <xmlelement>mapref</xmlelement>) 
            referenced a map in a subdirectory, and that referenced map included elements with <xmlatt>conref</xmlatt>
            attributes, the step that resolved map references did not properly adjust paths in
            <xmlatt>conref</xmlatt>, resulting in unresolvable content references. This has been fixed, and
            <xmlatt>conref</xmlatt> attributes in nested maps in subdirectories resolve properly.
            <xref href="https://github.com/dita-ot/dita-ot/pull/2806" format="html" scope="external">#2806</xref>
          </li>
        </ul>
        <p>For the complete list of changes since the previous release, see the<commit_msg>Use earliest issue as list item ID<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 file for applicable license.  -->

<reference id="ID" rev="2.5">
  <title>DITA Open Toolkit <keyword keyref="maintenance-version"/> Release Notes</title>

  <abstract>
    <shortdesc>DITA Open Toolkit <keyword keyref="maintenance-version"/> is a maintenance release that fixes issues
      reported in DITA-OT <keyword keyref="release"/>, which includes <ph conref="#highlights/summary"/>.</shortdesc>
    <note type="tip"><ph conref="../resources/conref-task.dita#ID/download-ot"/></note>
  </abstract>

  <reference id="v254">
    <title>Maintenance Release <keyword keyref="maintenance-version"/></title>
    <refbody>
      <section>
        <p>DITA Open Toolkit Release <keyword keyref="maintenance-version"/> includes the following bug fixes.</p>
        <ul>
          <li id="2772">In DITA-OT 2.5, external cross references to DITA topics, such as
            <codeph>&lt;xref href="http://example.com/onlineTopic.dita" scope="external"&gt;</codeph>,
            result in build failures due to an improperly set XSLT variable.
            <xref href="https://github.com/dita-ot/dita-ot/issues/2772" format="html" scope="external">#2772</xref>
          </li>
          <li id="2795">External links inside of <xmlelement>related-links</xmlelement> are dropped from PDF
            output in DITA-OT 2.4 and 2.5. These links now appear using the <xmlatt>href</xmlatt> attribute
            value as link text, as in earlier releases.
            <xref href="https://github.com/dita-ot/dita-ot/issues/2795" format="html" scope="external">#2795</xref>,
            <xref href="https://github.com/dita-ot/dita-ot/pull/2802" format="html" scope="external">#2802</xref>
          </li>
          <li id="2800">In DITA-OT 2.5, cross references within the same document, such as
            <codeph>&lt;xref href="#topicid/sampleFigure"/&gt;</codeph>, cause build errors
            when the build parameter <parmname>onlytopic.in.map</parmname> is set to true.
            <xref href="https://github.com/dita-ot/dita-ot/issues/2800" format="html" scope="external">#2800</xref>
          </li>
          <li id="2801">In DITA-OT 2.4 and 2.5, the <xmlelement>property</xmlelement> in reference topics resulted in an
            "Ambiguous rule match" message from Saxon when building HTML5. This message has been removed.
            <xref href="https://github.com/dita-ot/dita-ot/pull/2801" format="html" scope="external">#2801</xref>
          </li>
          <li id="2226">In earlier releases, plugins that contributed variables (or strings) did not work
            when the variables were contributed with mixed case (such as <codeph>pt-BR</codeph> instead of
            <codeph>pt-pt</codeph>. This has been fixed, so that the case of <xmlatt>xml:lang</xmlatt> is
            ignored when contributing variables.
            <xref href="https://github.com/dita-ot/dita-ot/issues/2226" format="html" scope="external">#2226</xref>,
            <xref href="https://github.com/dita-ot/dita-ot/issues/2790" format="html" scope="external">#2790</xref>,
            <xref href="https://github.com/dita-ot/dita-ot/pull/2803" format="html" scope="external">#2803</xref>
          </li>
          <li id="2805">In earlier releases, when <codeph>chunk="by-topic"</codeph> was specified on a 
            <xmlelement>topicref</xmlelement> element that did not specify the <xmlatt>href</xmlatt> attribute, 
            the build would end in a null pointer error. This error has been removed and the build will continue.
            <xref href="https://github.com/dita-ot/dita-ot/pull/2805" format="html" scope="external">#2805</xref>
          </li>
          <li id="2806">In earlier releases, when a map reference (such as <xmlelement>mapref</xmlelement>) 
            referenced a map in a subdirectory, and that referenced map included elements with <xmlatt>conref</xmlatt>
            attributes, the step that resolved map references did not properly adjust paths in
            <xmlatt>conref</xmlatt>, resulting in unresolvable content references. This has been fixed, and
            <xmlatt>conref</xmlatt> attributes in nested maps in subdirectories resolve properly.
            <xref href="https://github.com/dita-ot/dita-ot/pull/2806" format="html" scope="external">#2806</xref>
          </li>
        </ul>
        <p>For the complete list of changes since the previous release, see the
{'fraction_non_alphanumeric': 0.1358197693219791, 'fraction_numerical': 0.027810714670690954, 'mean_word_length': 3.0998674326115774, 'pattern_counts': {'":': 0, '<': 193, '<?xml version=': 2, '>': 193, 'https://': 20, 'lorem ipsum': 0, 'www.': 0, 'xml': 44}, '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': '1172078', 'n_tokens_mistral': 2959, 'n_tokens_neox': 2768, 'n_words': 793}