[
https://issues.apache.org/jira/browse/DERBY-1992?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13189180#comment-13189180
]
Kim Haase commented on DERBY-1992:
----------------------------------
Wow, the PDF file looks a lot better than the ones produced by the old toolkit.
(There are still some problems with words that overflow columns, but those are
probably insoluble.)
The lack of support for " " reveals that they still haven't fixed the bug
that whitespace between a <ph> element and another element is ignored. If you
remove the " " here, you get "DerbyConnection" in the output.
<ph conref="../conrefs.dita#prod/productshortname"></ph> <i>Connection</i>
Also, the attempt to force four spaces doesn't show up in the output:
the CHAR(6) value '18 ' (18 followed by four spaces)
These are the only two occurrences of " " in the Reference Manual. The
Getting Started guide has 11, and Tools has 5; the other 3 books have none.
Maybe we can figure out a way to define this character?
The HTML looks exactly as it does now, as far as I can tell. The TOC page fails
accessibility standards (see DERBY-5135 and sub-tasks) because the html element
lacks a lang attribute; the other pages have this, though. The tables fail
because of the empty summary attribute. I'm pretty sure the DITA DTD still
doesn't support a summary attribute in the table source. (We had to add a
template to one of the XSL stylesheets to generate one in the output.)
It would be helpful to see the output from a book with figures (the Tuning or
Developer's guide) to make sure those come out all right.
So in general, they've improved the PDF output considerably, and there's not
much change in the HTML.
> Upgrade to DITA Open Toolkit to the latest version
> --------------------------------------------------
>
> Key: DERBY-1992
> URL: https://issues.apache.org/jira/browse/DERBY-1992
> Project: Derby
> Issue Type: Improvement
> Components: Build tools
> Affects Versions: 11.0.0.0
> Reporter: Laura Stewart
> Assignee: Laura Stewart
> Fix For: 11.0.0.0
>
> Attachments: refderby-raw-dita1_5_4.pdf,
> refderby-raw-xhtml-dita1_5_4.zip
>
>
> There are major improvements in the DITA Open Toolkit, including improvements
> in
> the display of index entries. Derby is currently on version 1.1.2.1 and
> needs to upgrade to a later version of
> the DITA Open Toolkit. The latest version of the DITA Open Toolkit can be
> found here: http://sourceforge.net/projects/dita-ot/
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators:
https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira
