dita-v2-0-support.dita 3.8 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677
  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 file for applicable license. -->
  4. <concept id="ID">
  5. <title>DITA 2.0 preview support</title>
  6. <titlealts>
  7. <navtitle>DITA 2.0 preview</navtitle>
  8. </titlealts>
  9. <shortdesc>DITA Open Toolkit <keyword keyref="release"/> provides an initial preview of features for the upcoming
  10. OASIS DITA 2.0 specification. This preliminary processing support is provided on the basis of the latest DRAFT
  11. versions of the DITA 2.0 DTD and RelaxNG grammar files from OASIS (as of March 2020).</shortdesc>
  12. <conbody>
  13. <p id="grammar-files">DITA documents that reference the draft grammar files can be parsed, and where features
  14. overlap with DITA 1.3, those features will work as expected.</p>
  15. <ul>
  16. <li id="3453">
  17. <p>
  18. <ph id="include">The new <xmlelement>include</xmlelement> element can be used to reference text or XML content
  19. from other files. In addition to the processing mandated by the specification, DITA-OT also supports the
  20. character set definition and line range extraction options previously provided for
  21. <xmlelement>coderef</xmlelement> elements (see
  22. <xref keyref="extended-functionality"/>).</ph>
  23. </p>
  24. </li>
  25. <li id="3462">
  26. <p>
  27. <ph id="specializations">The new <xmlatt>specializations</xmlatt> attribute, which replaces the DITA 1.x
  28. <xmlatt>domains</xmlatt> attribute, can now be used as an alternative method of declaring specialized
  29. attributes.</ph>
  30. </p>
  31. </li>
  32. <li id="3463">
  33. <p>
  34. <ph id="outputclass">The <xmlatt>outputclass</xmlatt> attribute can now be specified as a flagging behavior in
  35. DITAVAL files. This allows you to flag an element with a CSS class keyword that will be added to the
  36. <xmlatt>class</xmlatt> attribute value in the generated HTML. Output classes allow you to pick up
  37. pre-defined styles from existing web frameworks, and are more easily overridden with custom CSS files than
  38. the inline <xmlatt>style</xmlatt> attributes generated by DITA 1.x flagging options such as
  39. <xmlatt>color</xmlatt> and <xmlatt>backcolor</xmlatt>.</ph>
  40. </p>
  41. </li>
  42. <li id="3464">
  43. <p>
  44. <ph id="simple-table-titles">Titles can now be specified on simple tables, and
  45. <xmlelement>simpletable</xmlelement> entries now support row and column spanning attributes.</ph>
  46. </p>
  47. </li>
  48. <li id="3483">
  49. <p>
  50. <ph id="topic-based-classes">Where DITA 1.x defined conflicting <xmlatt>class</xmlatt> values for
  51. <xmlelement>linktext</xmlelement>, <xmlelement>shortdesc</xmlelement>, and
  52. <xmlelement>searchtitle</xmlelement> in maps and topics, the new draft of DITA 2.0 uses the topic-based
  53. <xmlatt>class</xmlatt> value in all cases. Processing is updated to recognize the updated value when these
  54. elements are used in maps.</ph>
  55. </p>
  56. </li>
  57. </ul>
  58. <note id="more-to-come">Other new or revised features proposed for DITA 2.0 are not yet supported. Additional
  59. features will be implemented in future versions of DITA-OT as the specification evolves.</note>
  60. <note type="tip">For the latest status information on DITA 2.0-related features and fixes, see the
  61. <xref keyref="dita20-issues"/> in the GitHub issues tracker.</note>
  62. </conbody>
  63. <related-links>
  64. <!--
  65. <link keyref="dita13-spec-all-inclusive"/>
  66. <link keyref="dita13-spec-all-inclusive-pdf"/>
  67. <link keyref="dita13-spec-source"/>
  68. -->
  69. <link keyref="dita-tc"/>
  70. </related-links>
  71. </concept>