1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
|
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xml:lang="en-us" lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<meta name="copyright" content="(C) Copyright 2005"/>
<meta name="DC.rights.owner" content="(C) Copyright 2005"/>
<meta name="DC.Type" content="reference"/>
<meta name="DC.Title" content="DITA Open Toolkit Release 1.5.4"/>
<meta name="DC.Format" content="XHTML"/>
<meta name="DC.Identifier" content="rel1.5.4"/>
<link rel="stylesheet" type="text/css" href="resource/commonltr.css"/>
<title>DITA Open Toolkit Release 1.5.4</title>
</head>
<body id="rel1.5.4">
<h1 class="title topictitle1">DITA Open Toolkit Release 1.5.4</h1>
<div class="topic reference nested1" id="general-enhancements-and-changes"><h2 class="title topictitle2">General Enhancements and Changes</h2>
<div class="body refbody"><div class="section" id="general-enhancements-and-changes__section_vc5_gld_g2"><h3 class="title sectiontitle">Configuration file for defaults</h3>
<p class="p">In previous versions, <span class="ph filepath">lib/configuration.properties</span> was generated
by integration process. Integration has been changed to generate
<span class="ph filepath">lib/org.dita.dost.platform/plugin.properties</span> and the role of the
old <span class="ph filepath">lib/configuration.properties</span> has been changed to contain
defaults and configuration options, such as default language.</p>
</div>
<div class="section"><h3 class="title sectiontitle">Plug-in extension point for file extension configuration</h3>
<p class="p">New plug-in extension points have been added allow configuring DITA-OT behaviour based
on file extensions.</p>
<table cellpadding="4" cellspacing="0" summary="" id="general-enhancements-and-changes__simpletable_xym_ryi_uc" border="1" class="simpletable"><tr class="sthead"><th valign="bottom" align="left" id="d26e37" class="stentry">Extension point</th>
<th valign="bottom" align="left" id="d26e39" class="stentry">Description</th>
<th valign="bottom" align="left" id="d26e41" class="stentry">Default values</th>
</tr>
<tr class="strow"><td valign="top" headers="d26e37" class="stentry"><samp class="ph codeph">dita.topic.extension</samp></td>
<td valign="top" headers="d26e39" class="stentry">DITA topic</td>
<td valign="top" headers="d26e41" class="stentry"><span class="ph filepath">.dita</span>, <span class="ph filepath">.xml</span></td>
</tr>
<tr class="strow"><td valign="top" headers="d26e37" class="stentry"><samp class="ph codeph">dita.map.extensions</samp></td>
<td valign="top" headers="d26e39" class="stentry">DITA map</td>
<td valign="top" headers="d26e41" class="stentry"><span class="ph filepath">.ditamap</span></td>
</tr>
<tr class="strow"><td valign="top" headers="d26e37" class="stentry"><samp class="ph codeph">dita.html.extensions</samp></td>
<td valign="top" headers="d26e39" class="stentry">HTML file</td>
<td valign="top" headers="d26e41" class="stentry"><span class="ph filepath">.html</span>, <span class="ph filepath">.htm</span></td>
</tr>
<tr class="strow"><td valign="top" headers="d26e37" class="stentry"><samp class="ph codeph">dita.resource.extensions</samp></td>
<td valign="top" headers="d26e39" class="stentry">Resource file</td>
<td valign="top" headers="d26e41" class="stentry"><span class="ph filepath">.pdf</span>, <span class="ph filepath">.swf</span></td>
</tr>
</table>
<p class="p">Both HTML and resource file extensions are used to determine if a
file in source is copied to output.</p>
<p class="p">New plug-in extension point has been added to allow declaring transtypes as print types.</p>
<table cellpadding="4" cellspacing="0" summary="" border="1" class="simpletable"><tr class="sthead"><th valign="bottom" align="left" id="d26e96" class="stentry">Extension point</th>
<th valign="bottom" align="left" id="d26e98" class="stentry">Description</th>
</tr>
<tr class="strow"><td valign="top" headers="d26e96" class="stentry"><samp class="ph codeph">dita.transtype.print</samp></td>
<td valign="top" headers="d26e98" class="stentry">Declare transtype as a print type.</td>
</tr>
</table>
</div>
<div class="section"><h3 class="title sectiontitle">Strict integration mode</h3>
<p class="p">Two modes have been added to integration process: lax and strict. In strict mode the
processing will fail if any errors are encountered. In lax mode an error message may be
thrown for an error and the integration process will try to run to the end, even if
there are errors that were unrecoverable. The default mode is lax.</p>
<div class="note note"><span class="notetitle">Note:</span> In lax mode, even if the process runs to the end and reports a successful result,
DITA-OT may not be able to function correctly because of e.g. corrupted plug-in files or
unprocessed template files.</div>
</div>
<div class="section" id="general-enhancements-and-changes__section_dcd_yhr_wc"><h3 class="title sectiontitle">Code reference charset support</h3>
<p class="p">Encoding of the code reference target file can be set using the <samp class="ph codeph">format</samp>
attribute, for example </p>
<pre class="pre codeblock"><coderef href="unicode.txt" format="txt; charset=UTF-8"/> </pre>
</div>
<div class="section"><h3 class="title sectiontitle">Plugin URI scheme</h3>
<p class="p">Support for <span class="keyword">plugin</span> URI scheme has been added to XSLT stylesheets.
Plug-ins can refer to files in other plug-ins without hard coding relative paths, for
example </p>
<pre class="pre codeblock"><xsl:import href="plugin:org.dita.pdf2:xsl/fo/topic2fo_1.0.xsl"/></pre>
</div>
<div class="section" id="general-enhancements-and-changes__section_mdj_zcw_td"><h3 class="title sectiontitle">PDF</h3>
<p class="p">Support for mirrored page layout has been added. The default is the unmirrored
layout.</p>
<p class="p">The <samp class="ph codeph">args.bookmap-order</samp> property has been added to control how front
and back matter are processed in bookmaps. The default is to reorder the frontmatter
content as in previous releases.</p>
<p class="p">A new extension point has been added to add mappings to the PDF configuration catalog
file.</p>
<table cellpadding="4" cellspacing="0" summary="" border="1" class="simpletable"><tr class="sthead"><th valign="bottom" align="left" id="d26e165" class="stentry">Extension point</th>
<th valign="bottom" align="left" id="d26e167" class="stentry">Description</th>
</tr>
<tr class="strow"><td valign="top" headers="d26e165" class="stentry"><samp class="ph codeph">org.dita.pdf2.catalog.relative</samp></td>
<td valign="top" headers="d26e167" class="stentry">Configuration catalog includes.</td>
</tr>
</table>
<p class="p">Support for the following languages has been added:</p>
<ul class="ul"><li class="li">Finnish</li>
<li class="li">Hebrew</li>
<li class="li">Romanian</li>
<li class="li">Russian</li>
<li class="li">Swedish</li>
</ul>
<p class="p">PDF processing no longer copies images or generates XSL FO to output directory.
Instead, the temporary directory is used for all temporary files and source images are
read directly from source directory. The legacy processing model can be enabled by setting
<samp class="ph codeph">org.dita.pdf2.use-out-temp</samp> to <samp class="ph codeph">true</samp> in configuration
properties; support for the legacy processing model may be removed in future releases.</p>
<p class="p">Support for FrameMaker index syntax has been disabled by default. To enable FrameMaker
index syntax, set <samp class="ph codeph">org.dita.pdf2.index.frame-markup</samp> to <samp class="ph codeph">true</samp> in
configuration properties.</p>
<p class="p">A configuration option has been added to disable I18N font processing and use
stylesheet defined fonts. To disable I18N font processing, set
<samp class="ph codeph">org.dita.pdf2.i18n.enabled</samp> to <samp class="ph codeph">false</samp> in configuration
properties</p>
</div>
<div class="section" id="general-enhancements-and-changes__section_cnx_gmd_g2"><h3 class="title sectiontitle">XHTML</h3>
<p class="p">Support for the following languages has been added:</p>
<ul class="ul"><li class="li">Indonesian</li>
<li class="li">Kazakh</li>
<li class="li">Malay</li>
</ul>
</div>
</div>
</div>
<div class="topic reference nested1" id="reference_yvj_ttj_bd"><h2 class="title topictitle2">Migration from previous releases</h2>
<div class="body refbody"><div class="section">
<p class="p">The <samp class="ph codeph">print_transtypes</samp> property in <span class="ph filepath">integrator.properties</span> has been deprecated in favor of <samp class="ph codeph">dita.transtype.print</samp> plug-in extension point.</p>
<p class="p">The <samp class="ph codeph">dita.plugin.org.dita.*.dir</samp> properties have been changed to point
to DITA-OT base directory.</p>
</div>
<div class="section"><h3 class="title sectiontitle">PDF</h3><p class="p">Support for mirrored page layout was added and the following
XSLT configuration variables have been
deprecated:</p>
<ul class="ul" id="reference_yvj_ttj_bd__ul_hkv_oyj_bd"><li class="li"><samp class="ph codeph">page-margin-left</samp></li>
<li class="li"><samp class="ph codeph">page-margin-right</samp></li>
</ul>
<p class="p">The following variables should be used instead to control page margins:</p>
<ul class="ul" id="reference_yvj_ttj_bd__ul_yda_wyj_bd"><li class="li"><samp class="ph codeph">page-margin-outside</samp></li>
<li class="li"><samp class="ph codeph">page-margin-inside</samp></li>
</ul>
<p class="p">XSLT Parameters <samp class="ph codeph">customizationDir</samp> and
<samp class="ph codeph">fileProfilePrefix</samp> have been removed in favor of
<samp class="ph codeph">customizationDir.url</samp> parameter.</p>
<p class="p">A new shell stylesheet has been added for FOP and other shell stylesheets have also
been revised. Plug-ins which have their own shell stylesheets for PDF processing should
make sure all required stylesheets are imported.</p>
<p class="p">Font family definitions in stylesheets have been changed from Sans, Serif, and
Monospaced to sans-serif, serif, and monospace, respectively. The I18N font processing
still uses the old logical names and aliases are used to map the new names to old ones. </p>
</div>
</div>
</div>
<div class="topic reference nested1" id="reference_r2v_pdv_j2">
<h2 class="title topictitle2">SourceForge trackers</h2>
<div class="body refbody">
<div class="section"><h3 class="title sectiontitle">Feature requests</h3>
<ul class="ul">
<li class="li">3333697 Add strict mode processing (Milestone 1)</li>
<li class="li">3336630 Add resource file extension configuration (Milestone 1)</li>
<li class="li">3323776 Base HTML stylesheets (Milestone 1)</li>
<li class="li">3355860 Enable defining code ref target encoding (Milestone 1)</li>
<li class="li">3393969 Make default TocJS output more usable (Milestone 3)</li>
<li class="li">3394708 cfg/catalog.xml should be an extension point (Milestone 4)</li>
<li class="li">3411030 Add args.fo.userconfig to PDF2 (Milestone 5)</li>
<li class="li">3411961 Change margin-* to space-* property (Milestone 5)</li>
<li class="li">3412144 Add FOP specific shell to PDF2 (Milestone 5)</li>
<li class="li">3413215 Add schemas for PDF2 configuration files (Milestone 5)</li>
<li class="li">3414416 Support bookmap order in PDF2 front and back matter (Milestone 5)</li>
<li class="li">3413933 Fix inconsistencies in PDF2 page headers (Milestone 5)</li>
<li class="li">3418877 Mechanism to refer to other plug-ins in XSLT (Milestone 5)</li>
<li class="li">3411476 Add extension point for print type declaration (Milestone 6)</li>
<li class="li">3392891 Copy the graphic files to the temporary folder (Milestone 6)</li>
<li class="li">3429290 Remove unused Apache Commons Logging JAR (Milestone 6)</li>
<li class="li">3434640 Add XHTML NLS support for Indonesian, Malay, Kazakh (Milestone 6) </li>
<li class="li">3435528 Add base configuration file (Milestone 7)</li>
<li class="li">3432219 Refector dita.list read and write (Milestone 7)</li>
<li class="li">3401849 PDF2: runtime switch for localization post-processing (Milestone 7)</li>
<li class="li">3438361 Add "tocjs" transform to demo script (Milestone 7)</li>
<li class="li">3341648 Clean HTML and XHTML stylesheets (Milestone 8)</li>
<li class="li">3343562 Java clean-up (Milestone 8)</li>
<li class="li">3346094 Improve test coverage (Milestone 8)</li>
<li class="li">3372147 Improve logging (Milestone 8)</li>
<li class="li">3373416 Refactor PDF attribute sets (Milestone 8)</li>
<li class="li">3376114 Improve PDF page layout configuration (Milestone 8)</li>
<li class="li">3415269 Support for more languages in the PDF transform (Milestone 8)</li>
<li class="li">3412211 Refactor PDF index stylesheet for XSL 1.1 support (Milestone 8)</li>
<li class="li">3425838 General PDF2 improvements (Milestone 8)</li>
<li class="li">3428152 General I18N improvements (Milestone 8)</li>
<li class="li">3429390 General XHTML improvements (Milestone 8)</li>
<li class="li">3438790 Clean up build_demo script (Milestone 8)</li>
<li class="li">3440826 Dutch patch for feature request 3415269 (Milestone 8)</li>
<li class="li">1785391 Make Java code thread-safe (in progress)</li>
</ul>
</div>
<div class="section"><h3 class="title sectiontitle">Patches</h3>
<ul class="ul">
<li class="li">2963037 PDF changes to fix index rendering of colon (bug 2879196) (Milestone 7)</li>
</ul>
</div>
<div class="section"><h3 class="title sectiontitle">Bugs</h3>
<ul class="ul">
<li class="li">2714699 FO plug-in doesn't support specialized index elements (Milestone 1)</li>
<li class="li">2848636 Duplicate key definitions should produce info messages (Milestone 1)</li>
<li class="li">3353955 Frontmatter child order is not retained in PDF2 (Milestone 1)</li>
<li class="li">3354301 XRef with conreffed phrases not properly generate HTML link (Milestone 1)</li>
<li class="li">3281074 Bad attribute being applied to fo:bookmark-title element (Milestone 2)</li>
<li class="li">3344142 Conref Push order of validation (Milestone 2)</li>
<li class="li">3358377 Cryptic error message when DITA Map has "bookmap" extension (Milestone 3)</li>
<li class="li">3384673 ODF transtype no longer embeds images in output (OT 1.5.3) (Milestone 3)</li>
<li class="li">3394000 TocJS needs cleanup for several minor bugs (Milestone 3)</li>
<li class="li">3392718 TOCJS sample should not require ant target (Milestone 3)</li>
<li class="li">3389277 DocBook transform redundantly nests Related Links (Milestone 3)</li>
<li class="li">3105339 '<' and '>' characters in a title cause tocjs trouble (Milestone 3)</li>
<li class="li">3104497 tocjs JavaScripts don't work in Japanese environment (Milestone 3)</li>
<li class="li">3394130 Remove outdated developer documentation (Milestone 3)</li>
<li class="li">3397165 chunk on topichead not honored (Milestone 4)</li>
<li class="li">3397501 Custom reltable column headers are reversed (Milestone 4)</li>
<li class="li">3397495 Relcolspec with <title> does not generate link group headers (Milestone 4)</li>
<li class="li">3399030 <ph> Elements not flagged with alt-text in HTML output (Milestone 4)</li>
<li class="li">3396884 NPE in EclipseIndexWriter.java<Merges,setLogger for AbstractIndexWriters (Milestone 4)</li>
<li class="li">3398004 -d64 flag to JVM not allowed for Windows JVMs (Milestone 4)</li>
<li class="li">3401323 Fix PDF nested variable handling (Milestone 4)</li>
<li class="li">3401721 Processing broken for <topicsetref> elements (Milestone 4)</li>
<li class="li">3404049 Setting of clean_temp is backwards (Milestone 4)</li>
<li class="li">3386590 Product name repeated hundreds of times in PDF (Milestone 4)</li>
<li class="li">3405417 Shortdesc output twice when using abstract (Milestone 4)</li>
<li class="li">3402165 wrong image output dir if using generate.copy.outer=2 (Milestone 4)</li>
<li class="li">2837095 Positions of index and TOC in bookmaps are ignored (Milestone 5)</li>
<li class="li">3414826 DITA OT not handling image path with chunking turned on (Milestone 5)</li>
<li class="li">3411767 Not so meaningful messages given by ImgUtils (Milestone 5)</li>
<li class="li">3405851 Incorrect entry@colname in merged XML with row and colspan (Milestone 5)</li>
<li class="li">3406357 Custom profiling issue (Milestone 5)</li>
<li class="li">3413203 Remove references to OpenTopic in PDF2 (Milestone 5)</li>
<li class="li">3414270 @props specialization not used in map (Milestone 5)</li>
<li class="li">3383618 Attribute 'link-back' cannot occur at element 'fo:index-key (Milestone 5)</li>
<li class="li">3418953 Scale computation for XHTML uncorrectly looks up images (Milestone 6)</li>
<li class="li">3413229 onlytopic.in.map & symlink (Milestone 6)</li>
<li class="li">3423537 Additional line breaks in <menucascade> should be ignored (Milestone 6)</li>
<li class="li">3423672 Problems with refs to images outside the DITA Map directory (Milestone 6)</li>
<li class="li">2879663 indexterm/keyword causees NullPointerException (Milestone 7)</li>
<li class="li">2879196 Colon character in <indexterm> causes nesting in output (Milestone 7)</li>
<li class="li">3179018 Indexterm with only nested subelement results in NPE (Milestone 7)</li>
<li class="li">3432267 Task example title processing incorrect for PDF (Milestone 7)</li>
<li class="li">3430302 Unitless images sizes in throw errors (Milestone 7)</li>
<li class="li">3429845 No variables for Warning (Milestone 7)</li>
<li class="li">3428871 topicmerge gives incomplete topicref when reference or topic (Milestone 7)</li>
<li class="li">3132976 Duplicate index text in index page (Milestone 7)</li>
<li class="li">2795649 Java topicmerge ignores xml:lang (Milestone 7)</li>
<li class="li">3431798 Relative CSS paths incorrectly computed for @copy-of (Milestone 7)</li>
<li class="li">3438421 Remove transtype default (Milestone 7)</li>
<li class="li">2866342 Nested see also is ignored (Milestone 8)</li>
<li class="li">1844429 PDF2: Non-DITA link broken unless marked external (Milestone 8)</li>
<li class="li">3270616 "lcTime" not displayed in PDF output (Milestone 8)</li>
<li class="li">3388668 Data in figure captions not suppressed in xrefs (Milestone 8)</li>
<li class="li">3429824 topicmerge gives wrong topicref with nested topics (Milestone 8)</li>
<li class="li">3414332 PDF2 variable string translations missing (Milestone 8)</li>
<li class="li">3323806 Improve Java logging and exception handling (Milestone 8)</li>
<li class="li">3426920 Image files not copied or referenced correctly for eclipse (Milestone 8)</li>
<li class="li">3445159 entry/@colname has been removed! (Milestone 8)</li>
<li class="li">3447732 Bug in handling of longdescref (Milestone 8)</li>
<li class="li">3452510 Ant parameter customization.dir not documented anywhere (Milestone 8)</li>
<li class="li">3451621 Revisions on <plentry> use wrong image for nested <pd> (Milestone 8)</li>
</ul>
</div>
</div>
</div>
</body>
</html>
|
