plugin-extension-points-general.dita 5.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
  3. <!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
  4. <reference id="plugin-general-extension-points">
  5. <title>General extension points</title>
  6. <shortdesc>These extension points enable you to extend DITA-OT. You can add Ant targets or imports; add a Java library
  7. to the <parmname>classpath</parmname> parameter; add a new transformation type; extend a catalog file; add new
  8. diagnostic messages, and more.</shortdesc>
  9. <prolog>
  10. <metadata>
  11. <keywords>
  12. <indexterm>deprecated features<indexterm><parmname>dita.conductor.target</parmname></indexterm></indexterm>
  13. <indexterm>deprecated features<indexterm><parmname>dita.specialization.catalog</parmname></indexterm></indexterm>
  14. </keywords>
  15. </metadata>
  16. </prolog>
  17. <refbody>
  18. <section>
  19. <dl>
  20. <dlentry id="ant.import">
  21. <dt><parmname>ant.import</parmname></dt>
  22. <dd conaction="pushreplace" conref="extension-points-in-org.dita.base.dita#org.dita.base-ext/ant.import.desc"
  23. >Adds an Ant import to the main Ant build file.</dd>
  24. </dlentry>
  25. <dlentry>
  26. <dt><parmname>dita.conductor.lib.import</parmname></dt>
  27. <dd conaction="pushreplace"
  28. conref="extension-points-in-org.dita.base.dita#org.dita.base-ext/dita.conductor.lib.import.desc">Adds a Java
  29. library to the DITA-OT classpath.</dd>
  30. </dlentry>
  31. <dlentry>
  32. <dt importance="deprecated"><parmname>dita.conductor.target</parmname></dt>
  33. <dd conaction="pushreplace"
  34. conref="extension-points-in-org.dita.base.dita#org.dita.base-ext/dita.conductor.target.desc">Adds an Ant
  35. import to the main Ant build file.
  36. <p>
  37. <note type="attention">This extension point is deprecated; use <codeph>ant.import</codeph> instead.</note>
  38. </p>
  39. </dd>
  40. </dlentry>
  41. <dlentry>
  42. <dt><parmname>dita.conductor.target.relative</parmname></dt>
  43. <dd conaction="pushreplace"
  44. conref="extension-points-in-org.dita.base.dita#org.dita.base-ext/dita.conductor.target.relative.desc">Adds
  45. an Ant import to the main Ant build file.
  46. <p>
  47. <note type="tip">As of DITA-OT 3.0, the <codeph>ant.import</codeph> extension point can be used
  48. instead.</note>
  49. </p>
  50. </dd>
  51. </dlentry>
  52. <dlentry>
  53. <dt><parmname>dita.conductor.transtype.check</parmname></dt>
  54. <dd conaction="pushreplace"
  55. conref="extension-points-in-org.dita.base.dita#org.dita.base-ext/dita.conductor.transtype.check.desc">
  56. <p>Adds a new value to the list of valid transformation types.</p>
  57. <note type="tip">This extension point is still supported for backwards compatibility, but since DITA-OT 2.1,
  58. any new customizations should instead use the <xmlelement>transtype</xmlelement> element in the
  59. <xref keyref="plugin-configfile"/> to define a new transformation.</note>
  60. </dd>
  61. </dlentry>
  62. <dlentry importance="deprecated">
  63. <dt><parmname>dita.specialization.catalog</parmname></dt>
  64. <dd conaction="pushreplace"
  65. conref="extension-points-in-org.dita.base.dita#org.dita.base-ext/dita.specialization.catalog.desc">Adds the
  66. content of a catalog file to the main DITA-OT catalog file. <note type="attention">This extension point is
  67. deprecated; use <codeph>dita.specialization.catalog.relative</codeph> instead.</note></dd>
  68. </dlentry>
  69. <dlentry>
  70. <dt><parmname>dita.specialization.catalog.relative</parmname></dt>
  71. <dd conaction="pushreplace"
  72. conref="extension-points-in-org.dita.base.dita#org.dita.base-ext/dita.specialization.catalog.relative.desc"
  73. >Adds the content of a catalog file to the main DITA-OT catalog file.</dd>
  74. </dlentry>
  75. <dlentry>
  76. <dt><parmname>dita.transtype.print</parmname></dt>
  77. <dd conaction="pushreplace"
  78. conref="extension-points-in-org.dita.base.dita#org.dita.base-ext/dita.transtype.print.desc">Defines a
  79. transformation as a print type.<draft-comment author="Kristen Eberlein" time="31 March 2013">What does this
  80. actually do? Does this interact with using the deprecated <xmlatt>print</xmlatt>
  81. attribute?</draft-comment></dd>
  82. </dlentry>
  83. <dlentry>
  84. <dt><parmname>dita.xsl.messages</parmname></dt>
  85. <dd conaction="pushreplace"
  86. conref="extension-points-in-org.dita.base.dita#org.dita.base-ext/dita.xsl.messages.desc">Adds new diagnostic
  87. messages to DITA-OT.</dd>
  88. </dlentry>
  89. <dlentry>
  90. <dt><parmname>org.dita.pdf2.catalog.relative</parmname></dt>
  91. <dd conaction="pushreplace"
  92. conref="extension-points-in-org.dita.pdf2.dita#org.dita.pdf2-ext/org.dita.pdf2.catalog.relative.desc">Adds
  93. the content of a catalog file to the main catalog file for the PDF plug-in.</dd>
  94. </dlentry>
  95. </dl>
  96. </section>
  97. </refbody>
  98. </reference>