DITA_v1-3-support.dita 6.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
  3. <!--This file is part of the DITA Open Toolkit project. See the accompanying LICENSE.md file for applicable licenses.-->
  4. <concept id="dita-13-spec-support" xml:lang="en-US">
  5. <title>DITA 1.3 support</title>
  6. <shortdesc><ph id="shortdesc-ph">DITA Open Toolkit <keyword keyref="release"/> provides processing support for the
  7. OASIS DITA 1.3 specification. Initial preview support for this specification was added in version 2.0 of the
  8. toolkit; version 2.2 extends this foundation to support key scopes and branch filtering along with additional DITA
  9. 1.3 features.</ph></shortdesc>
  10. <conbody>
  11. <p id="p">Because DITA 1.3 is fully backwards compatible with previous DITA DTDs and schemas, DITA-OT 2.2 provides
  12. the 1.3 materials as the default DTDs for processing. The XML Catalog resolution maps any references for
  13. unversioned DITA doctypes to the 1.3 DTDs. All processing ordinarily dependent on the 1.0, 1.1, or 1.2 definitions
  14. continues to work as usual, and any documents that make use of the newer DITA 1.3 elements or attributes will be
  15. supported with specific new processing.</p>
  16. <section>
  17. <title>Initial Preview Support for DITA 1.3 in DITA-OT 2.0</title>
  18. <p>The following DITA 1.3 features were implemented in version 2.0 of the toolkit. Issue numbers correspond to the
  19. tracking number in the <ph>
  20. <xref keyref="dita-ot-issues" scope="external">GitHub issues tracker</xref></ph>.</p>
  21. <ul>
  22. <li>Support DITA 1.3 link syntax (milestone 2)
  23. <xref href="https://github.com/dita-ot/dita-ot/issues/1649" format="html" scope="external">#1649</xref></li>
  24. <li>Support DITA 1.3 cascade attribute (milestone 2)
  25. <xref href="https://github.com/dita-ot/dita-ot/issues/1636" format="html" scope="external">#1636</xref></li>
  26. <li>Implement DITA 1.3 profiling (milestone 2)
  27. <xref href="https://github.com/dita-ot/dita-ot/issues/1635" format="html" scope="external">#1635</xref></li>
  28. <li>Add new DITA 1.3 highlighting elements (milestone 4)
  29. <xref href="https://github.com/dita-ot/dita-ot/issues/1651" format="html" scope="external">#1651</xref></li>
  30. <li> Add DITA 1.3 markup and xml domain support (milestone 4)
  31. <xref href="https://github.com/dita-ot/dita-ot/issues/1652" format="html" scope="external">#1652</xref></li>
  32. <li> Add DITA 1.3 <xmlelement>div</xmlelement> element (milestone 4) <xref
  33. href="https://github.com/dita-ot/dita-ot/issues/1654" format="html" scope="external">#1654</xref></li>
  34. </ul>
  35. </section>
  36. <section>
  37. <title>Additional DITA 1.3 support in DITA-OT 2.2</title>
  38. <p>The following DITA 1.3 features were implemented in version 2.2 of the toolkit.</p>
  39. <note type="important" id="2094">The DITA 1.3 grammars are now used as the default DTDs for processing
  40. <xref href="https://github.com/dita-ot/dita-ot/issues/2094" scope="external" format="html">#2094</xref></note>
  41. <ul>
  42. <li id="1969">Initial implementation of DITA 1.3 branch filtering
  43. <xref href="https://github.com/dita-ot/dita-ot/pull/1969" scope="external" format="html">#1969</xref>,
  44. <xref href="https://github.com/dita-ot/dita-ot/issues/1637" scope="external" format="html">#1637</xref>
  45. <p>The implementation is a separate module that is run before keyref processing. The process
  46. <ul>
  47. <li>Splits branches so that each branch contains a single ditavalref </li>
  48. <li>Generates <xmlatt>copy-to</xmlatt> attributes for each branch-generated
  49. <xmlelement>topicref</xmlelement>
  50. </li>
  51. <li>Filters the map based on branch filters </li>
  52. <li>Rewrites duplicate generated copy-to targets with a numbered <tt>-#</tt> suffix </li>
  53. <li>Copies and filters generated copy-to targets </li>
  54. <li>Filters topics that were not branch-generated </li>
  55. </ul>
  56. </p>
  57. </li>
  58. <li id="1979">Initial support for DITA 1.3 key scopes, including multiple scope names in a single
  59. <xmlatt>keyscope</xmlatt> attribute
  60. <xref href="https://github.com/dita-ot/dita-ot/pull/1979" scope="external" format="html">#1979</xref>,
  61. <xref href="https://github.com/dita-ot/dita-ot/issues/1648" scope="external" format="html">#1648</xref>,
  62. <xref href="https://github.com/dita-ot/dita-ot/issues/2004" scope="external" format="html">#2004</xref>
  63. </li>
  64. <li id="1783">The <xmlatt>keyref</xmlatt> attribute is now supported on <xmlelement>object</xmlelement> elements
  65. <xref href="https://github.com/dita-ot/dita-ot/issues/1783" scope="external" format="html">#1783</xref>
  66. </li>
  67. <li id="1968">Processing order has been revised to process any same topic fragments used in conrefs before the
  68. conref phase, to enable content references to elements in the same topic using a reference such as
  69. <codeph>&lt;p&#xA0;conref="#./ID"/></codeph> as reported in
  70. <xref href="https://github.com/dita-ot/dita-ot/pull/1649" scope="external" format="html">#1649</xref>.
  71. <xref href="https://github.com/dita-ot/dita-ot/pull/1968" scope="external" format="html">#1968</xref>
  72. </li>
  73. </ul>
  74. <note>For the latest status information on DITA 1.3-related features, see the
  75. <xref href="https://github.com/dita-ot/dita-ot/issues?q=label%3A%22DITA+1.3%22+is%3Aclosed" scope="external"
  76. format="html">DITA 1.3 label</xref> in the GitHub issues tracker.</note>
  77. </section>
  78. </conbody>
  79. <related-links>
  80. <link format="html"
  81. href="http://docs.oasis-open.org/dita/dita/v1.3/os/part3-all-inclusive/dita-v1.3-os-part3-all-inclusive.html"
  82. scope="external">
  83. <linktext>DITA Version 1.3 Part 3: All-Inclusive Edition (HTML)</linktext>
  84. </link>
  85. <link format="pdf"
  86. href="http://docs.oasis-open.org/dita/dita/v1.3/os/part3-all-inclusive/dita-v1.3-os-part3-all-inclusive.pdf"
  87. scope="external">
  88. <linktext>DITA Version 1.3 Part 3: All-Inclusive Edition (PDF)</linktext>
  89. </link>
  90. <link format="zip" href="http://docs.oasis-open.org/dita/dita/v1.3/os/dita-v1.3-os.zip" scope="external">
  91. <linktext>DITA Version 1.3 (Distribution ZIP of the DITA source)</linktext>
  92. </link>
  93. <link format="html" href="https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita-adoption"
  94. scope="external">
  95. <linktext>DITA Adoption Technical Committee</linktext>
  96. <desc>Contains links to many white papers about using new DITA 1.3 features.</desc>
  97. </link>
  98. </related-links>
  99. </concept>