76 lines
No EOL
12 KiB
XML
76 lines
No EOL
12 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE reference
|
|
PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
|
|
<reference xmlns:ditaarch="http://dita.oasis-open.org/architecture/2005/" id="rel1.5.3" ditaarch:DITAArchVersion="1.2"><title>DITA Open Toolkit Release 1.5.3</title><shortdesc>Release 1.5.3 is a maintenance release based on the final version of the DITA 1.2
|
|
standard.</shortdesc><refbody><section>
|
|
<p>Version 1.5.3 contains many enhancements, user patches, bug fixes, and significant
|
|
updates to the documentation.</p>
|
|
|
|
<p>Release 1.5.3 was developed using a series of test builds
|
|
released to the community every three weeks. Each item in the list
|
|
below indicates which test build first contained the update. The
|
|
eighth public build was the final build, released as the
|
|
DITA-OT 1.5.3 final stable build.</p>
|
|
</section><section>
|
|
<title>General Enhancements and Changes</title>
|
|
<dl><dlentry id="topic_mxs_vps_qc"><dt>Base plug-ins</dt><dd><p>In earlier releases of OT, configuration parameters were hardcoded into Ant files and
|
|
Java code. Starting from version 1.5.3 OT has externalized base configurations into base
|
|
plug-ins in plugins folder. Base plug-in identifiers and folder names start with
|
|
<codeph>org.dita</codeph>: </p>
|
|
<ul><li>org.dita.base</li><li>org.dita.docbook</li><li>org.dita.eclipsecontent</li><li>org.dita.eclipsehelp</li><li>org.dita.htmlhelp</li><li>org.dita.javahelp</li><li>org.dita.odt</li><li>org.dita.pdf</li><li>org.dita.troff</li><li>org.dita.wordrtf</li><li>org.dita.xhtml</li></ul>
|
|
<p>For backwards compatibility, only configuration files were moved to plug-in folders,
|
|
the actual code and resource files were left in original locations.</p>
|
|
<p>Installations of OT may remove base plug-ins in order to remove funtionality, but the
|
|
<codeph>org.dita.base</codeph> plug-in must be retained as it contains
|
|
configuration for base functionality such as catalog files and preprocessing.</p></dd></dlentry><dlentry id="topic_uxs_vps_qc"><dt>Plug-ing configuration changes</dt><dd>
|
|
<p>The plug-in configuration file <filepath>plugin.xml</filepath> has support for new
|
|
syntax, where the old</p>
|
|
<codeblock xml:space="preserve"><feature extension="foo" value="bar.xml" type="file"/></codeblock>
|
|
<p>can be written as</p>
|
|
<codeblock xml:space="preserve"><feature extension="foo" file="bar.xml"/></codeblock>
|
|
<p>The new <codeph>file</codeph> attribute only supports a single file, not a comma
|
|
separated list like the value attribute.</p><p>In previous releases multiple feature elements with the same
|
|
extension ID were not supported. In release 1.5.3 multiple definitions are combined,
|
|
thus</p>
|
|
<codeblock xml:space="preserve"><feature extension="foo" value="bar,baz"/></codeblock>
|
|
<p>can also be written as </p>
|
|
<codeblock xml:space="preserve"><feature extension="foo" value="bar"/>
|
|
<feature extension="foo" value="baz"/></codeblock>
|
|
<p>Plug-in extension points can be added with</p>
|
|
<codeblock xml:space="preserve"><extension-point id="<i>extension-id</i>" name="<i>human readable name</i>"/></codeblock>
|
|
<p>Plug-ins <b>should</b> declare all extension points they support. In version 1.5.3
|
|
undeclared extension points are supported, but a warning is thrown when running
|
|
integration in verbose mode. Support for undeclared extension points <b>may</b> be
|
|
removed in future releases.</p>
|
|
</dd></dlentry><dlentry id="topic_cys_vps_qc"><dt>PDF2 changes</dt><dd>
|
|
<p>Support for the format attribute in PDF2 variable files has been remove as
|
|
redundant. The same functionality as </p>
|
|
<codeblock xml:space="preserve"><variable id="foo" format="bar">baz</variable> </codeblock>
|
|
<p>can be implemented with e.g. </p>
|
|
<codeblock xml:space="preserve"><variable id="foo.bar">baz</variable> </codeblock>
|
|
<p>PDF2 no longer logs a warning about PDF2 plug-in replacing the legacy PDF
|
|
transformation type.</p>
|
|
<p>Support for flagging has been added.</p>
|
|
<p>Version of FOP that comes with Full Easy Install has been updated from 0.95 to
|
|
1.0.</p>
|
|
</dd></dlentry><dlentry id="topic_oys_vps_qc"><dt>Filtering configuration</dt><dd><p>List of transtypes which are considered to be print types has been moved to
|
|
<filepath>integrator.properties</filepath> with the property name
|
|
<codeph>print_transtypes</codeph>. In previous releases this list was hardcoded
|
|
into Java code. Configuring print transtypes is currently not possible in plug-in
|
|
configuration files.</p></dd></dlentry><dlentry><dt>Java API changes</dt><dd>
|
|
<p>Multiple Java classes have been changed from public non-final into package-private
|
|
final. This enables clearer distinction between public and internal API, and forbits
|
|
subclassing classes which have not been designed and documented for
|
|
extensibility.</p>
|
|
</dd></dlentry></dl>
|
|
</section><section>
|
|
<title>SourceForge Enhancements Added</title>
|
|
<ol id="ol_ghy_svh_pc"><li>3177971 Improve plugin configuration file (Milestone 2) </li><li>3178275 Add xsl:import extension point to PDF2 topic merge XSL (Milestone 3)</li><li>3182113 Add common attribute processing to PDF2 plugin (Milestone 3)</li><li>3185914 Improve integration loggin (Milestone 3)</li><li>3189073 Plugin location should be available as Ant property (Milestone 3)</li><li>3126848 Repository cleanup (Milestone 3)</li><li>3204188 Support for defining extension point (Milestone 4)</li><li>3213163 Clean PDF2 build and integration scripts (Milestone 4)</li><li>3227387 Need extension to pass user param to dita.map.xhtml.toc targ (Milestone 4) </li><li>3231695 Use an XML serializer object for writing XML (Milestone 4) </li><li>3256796 Remove lecagy PDF code from xsl (Milestone 4)</li><li>3283638 Remove format attribute support from PDF2 vars (Milestone 5)</li><li>3285716 Clean up PDF2 build files (Milestone 5)</li><li>3286085 Add output and temp dir params to PDF2 (Milestone 5)</li><li>3293738 Use extensible pipeline task implementation (Milestone 6)</li><li>3271552 ${args.xsl.pdf} as an absolut path not supported (Milestone 6)</li><li>3033000 update to Apache FOP 1.0 release (Milestone 6) </li><li>3213324 Separate FOP/XEP/AXF stylesheets in PDF2 (Milestone 6) </li><li>3302779 Dependency extension points for PDF2 formatting (Milestone 7) </li><li>3304945 Allow setting local overrides with properties file (Milestone 7) </li><li>3190356 Pluginize DITA-OT base configuration files (Milestone 8)</li><li>3167087 Reduce static variable usage in Java code (Milestone 8)</li><li>3158929 Java clean-up (Milestone 8)</li><li>3194917 Change Java API to be more final and non-public (Milestone 8)</li><li>3197328 Refactor writers for cleaner XML serialization (Milestone 8) </li><li>3199755 Improve log integration (Milestone 8) </li><li>3296040 Refactor PDF2 build files (Milestone 8)</li><li>3306146 PDF2 stylesheet refactoring (Milestone 8)</li><li>3304447 Add support for selecting output format in PDF2 (Milestone 8)</li><li>3310476 Add plug-in ID and version syntax check (Milestone 8)</li><li>3309275 Warning reported by Apache FOP on any topic (Milestone 8)</li><li>3305843 Support list of tables/figures in PDF2 (Milestone 8)</li></ol>
|
|
</section><section>
|
|
<title>SourceForge Patches Added</title>
|
|
<ol id="ol_iky_svh_pc"><li>3123507 String concat in map2plugin (Milestone 1)</li><li>3110513 HTML XSLT uses complex casts (Milestone 1)</li><li>3097677 Add property to reload XHTML stylesheets (Milestone 1) </li><li>3106659 Added topicgroup elements to tocjs (Milestone 1)</li><li>3109051 RestoreEntity duplicates functionality (Milestone 1)</li><li>3107755 Configure templates with integrator properties (Milestone 1)</li><li>3142967 IndexTermReader leaves tab characters in terms (Milestone 1)</li><li>3140543 Add missing Commons Codec JAR into compile classpath for buildPackage.xml
|
|
(Milestone 1)</li><li>3087664 Clean plugin configuration parser (Milestone 1)</li><li>3145258 Plug-in integrator code clean-up (Milestone 2)</li><li>3147226 Use common directory layout for Junit (Milestone 2) </li><li>3062765 Fix unit test file paths to be platform dependent (Milestone 2)</li><li>3164523 Refactor platform Java code (Milestone 2)</li><li>3160801 Improve unit test coverage (Milestone 8)</li><li>3189026 Avoid strings where other types are more appropriate (Milestone 8)</li></ol>
|
|
</section><section>
|
|
<title>SourceForge Bugs Fixed</title>
|
|
<ol id="ol_zly_svh_pc"><li>3114411 keyref links don't work for HTML Help (Milestone 1)</li><li>3126578 Chunking Issues in DITA 1.5.1 (Milestone 1)</li><li>3109616 More Antenna House Path Problems (Milestone 1)</li><li>3155375 Incorrect way to specify recognized image extensions(Milestone 2)</li><li>3157890 Navtitle Construction Does not Preserve Markup (Milestone 2)</li><li>3155848 xml decl in ditaval file not closed properly (Milestone 2)</li><li>3162808 Chunking remaps in-file <xref> to invalid value (Milestone 2)</li><li>3164866 Upper letter estensions (Milestone 2)</li><li>3165307 Add boilerplate to Java files (Milestone 2)</li><li>2793836 CHM Index terms come out with extra spaces (Milestone 2)</li><li>3165762 Initializer XMLReader without modifying system variables (Milestone 2)</li><li>3175328 Imagemap alt text gets extra text (Milestone 2)</li><li>3085106 FO: topicmerge drops id on map/topicref without href. (Milestone 2)</li><li>3147328 Error in commons.xsl: getTopicrefShortdesc (Milestone 2)</li><li>3130724 Error in tables.xsl: fix-relcolwidth (Milestone 2)</li><li>3174906 Normalize Map and Bookmap titles for JavaHelp output (Milestone 3)</li><li>3178361 Conkeyref push fails when equivalent conref push succeeds (Milestone 3)</li><li>3180681 PDF2: Inconsistent template import / include. (Milestone 3)</li><li>3191701 Conref Push to Same File Fails (Milestone 3)</li><li>3191704 Push Replace Results in Pushed element Being removed (Milestone 3)</li><li>3189883 MapLinksReader should not be namespace aware (Milestone 3)</li><li>3164587 Warnings issued by Saxon 9.3.0.4 when publishing to PDF (Milestone 3)</li><li>3159001 Clean unit tests (Milestone 4) </li><li>3199985 @chunk : xrefs and links break (Milestone 4)</li><li>3206158 Inconsistent message DOTJ038W (Milestone 4)</li><li>3206373 Better handling of referenced SVG images (Milestone 4)</li><li>3279539 Out of memory error from move-meta module (Milestone 5)</li><li>3281108 Fallback to $locale when xml:lang value is wrong format (Milestone 5)</li><li>3286679 ODT output transform deletes too many files (Milestone 6)</li><li>3287609 Chunking rewrites image based on map directory (Milestone 6)</li><li>3288639 Conref code improperly generalizes map domain elements (Milestone 6)</li><li>3294295 PDF2 indexing and I18N fails with missing languages (Milestone 6)</li><li>3294864 tocjs-demo: tocjs.ditamap is referencing a missing file (Milestone 6)</li><li>3297930 PDF2: axf specific templates can't be overridden. (Milestone 7) </li><li>2001271 DITA-OT documentation wants Ant 1.6.5 (Milestone 8) </li><li>3136773 Incorrect version reported in log file (Milestone 8) </li><li>3260746 Topichead not processed the same as title-only topic (Milestone 8) </li><li>3315029 Garbled character problem in Japanese HTMLHelp (Milestone 8) </li><li>3308775 Keyref map in grandparent folder fails (Milestone 8) </li></ol>
|
|
</section></refbody></reference> |