Release Notes ODFToEPub 1.3.7
2 May 2012
1. Requirements
You need OpenOffice.org 3.2 or higher to use the ePub extension. You may also
run it as a stand-alone program. Either double-click the JAR-file or write the
following on the command-line:
> java -jar odf_to_epub.jar
Java 1.5 or higher has to be installed in OpenOffice.org.
2. Installation
Install the extension with the extension manager, which is behind the menu item
Tools->Extension Manager.
3. Changes
3.1 Changes Since Version 1.3.6
Bug fixes
- Exception when converting lengths with an exponential value.
- When the "line-height" property is expressed in percentage in a style it
should not be compared with the parent style.
Minor changes
- Generate "1px" instead of "1.0px" when lengths are too small. Some rendering
engines can't cope with decimals when the unit is "px".
- Allow the "NavigationPoint" style to be at any level in the style hierarchy
in order to detect a navigation point for the TOC.
3.2 Changes Since Version 1.3.5
Bug fixes
- Headings with an outline level higher than 6 are discarded.
3.3 Changes Since Version 1.3.4
Bug fixes
- Cross-references within a book can be wrong when ODF 1.1 style headings
are used, i.e. with numbered lists.
- When using ODF 1.1 style headings, headings with an outline level greater than
1 are ommitted if they are in the same numbered list as a heading with a
higher outline level.
- Shorthand border properties are not split correctly.
3.4 Changes Since Version 1.3.3
Bug fixes
- The property "fo:margin" is mapped to "margin-bottom" instead of "margin".
- Shorthand properties should be split. These are "fo:margin", "fo:border" and
"fo:padding".
3.5 Changes Since Version 1.3.2
Minor changes
- Lift the Java runtime version limit. Any runtime can be used now, including
Java 7.
3.6 Changes Since Version 1.3.1
Bug fixes
- Negative length values are not interpreted correctly.
- Relative lengths in common styles are not calculated relative to the length of
the same property of the parent style.
- The suffix of a heading numbering style is ignored.
Minor changes
- Allow the default author to be overridden by the custom property "Author".
3.7 Changes Since Version 1.3
Bug fixes
- When there is no table of contents the endnotes segment can't be determined,
causing endnotes not to link to the endnotes segment entries.
- Include the MathML DTDs.
3.8 Changes Since Version 1.2.2
Bug fixes
- An exception occurs for headings with a level deeper than 6.
- Take into account the "text-indent" property when correcting the left margin
of list items.
- Left margin correction for list items was only done for the first occurrence
of a style.
- Import external images instead of just referring to them.
- Fix the relative font-size for nested elements.
- Escape font-family names in the CSS-file when necessary.
- The "font-name" style property was wrongly converted to "font-family". It
should be resolved to a font-face.
- The tracked changes element should not be included in the text.
- The text of a footnote which is attached to a heading ends up in the
navigation structure.
- Consider a frame that is anchored as a character as a block-level element if
it contains block-level elements.
- Avoid that a frame inherits the "text-indent" property from a surrounding
paragraph.
Minor changes
- Use an XML-beautifier for the generated entities.
- Take into account the outline level depth when generating the table of
contants.
- Use the table of contents title is there is any.
New features
- Support for the notes-configurations element, which lets you style the
footnotes and endnotes and determine their numbering format.
- Support endnotes.
3.9 Changes Since Version 1.2.1
Minor changes
- Fill in the "title" tag of the generated segments.
- Generate less code for numbered headings.
- Generate a "p" tag when a paragraph doesn't contain block-level elements.
3.10 Changes Since Version 1.2
Bug fixes
- JPEG-images are no longer recognized.
- Cover pages should be shown in Adobe Digital Editions as well as iBooks.
- Text-properties in default style sheets are not read.
Minor changes
- Translate certain custom properties to DublinCore meta-data.
- Always generate proportional font sizes, which makes the result fully
resizable in Adobe Digital Editions.
3.11 Changes Since Version 1.1.3
Bug fixes
- The style sheet file generated.css was not manifested.
- Handle left margins correctly in list items.
- Isolate loaded Java classes in order to avoid conflicts with other
OpenOffice.org extensions.
Minor changes
- Show a message box when an error occurs.
New features
- Batch version for building into applications.
- Horizontal table alignment.
- Proportional treatment of left and right margins of paragraphs. This improves
the reflow of the generated ePub.
- Add ODF custom properties to the ePub meta-data.
- MathML support. However, the e-readers are not yet compliant with inline XML
islands and MathML.
- Frame titles for increased accessibility.
3.12 Changes Since Version 1.1.2
Bug fixes
- Justification and centering doesn't work for headings.
- The default master page is not used to determine the width of tables and
frames.
- Use a colgroup with the "width" attribute set to "0*" for better and more
portable spacing of itemized list labels.
- Exception when a master page doesn't specify an absolute width.
- Fix incorrect ID-format for embedded fonts.
Minor changes
- If an image has the name "Cover" it is used as the cover page instead of the
first entity in the generated document.
- The entities are generated in the root of the container instead of in the
folder "parts". This removes the need for relative URLs containing "../",
which doesn't work on all e-readers.
3.13 Changes Since Version 1.1.1
Bug fixes
- Escape special characters in style names.
- Put quotes around font-family names with spaces.
- Take the book identifier from the ODF-document.
- Compile for Java 1.5.
3.14 Changes Since Version 1.1
Bug fixes
- An Asian CSS style is not generated if there is only the "font-weight-asian"
property.
- If a "span" element has a style without a language code (directly or
indirectly through the parent style), the language code of the surrounding
element should be used.
- Missing Asian Unicode blocks.
- Language code "zxx" and country code "none" are not interpreted correctly.
- Exception while building the spine when the highest outline level is lower
than 1.
- The property "text-line-through-style" with value "none" is translated to
"line-through" instead of "none".
3.15 Changes Since Version 1.0.1
Bug fixes
- The "text-underline-style(-type)" and "text-line-through-style(-type)"
properties are not converted correctly when the value "none" is involved.
- A list style is not applied to the list labels.
- The Dublin Core language element should always be added to the meta data.
- An XHTML part must not have an empty body.
- A computer username with non-ASCII characters prevents the installation of
the license file.
New features
- Support for writing-modes (left-to-right and right-to-left).
- Support for Asian and Complex Text Layout ODF-styles.
- Index of tables.
- Index of illustrations.
- More control over the layout of the generated table of contents, index of
tables, index of illustrations and the alphabetical index.
- Frames can be floated, centered and left or right aligned.
- Improved frame handling. The width of a frame is now proportional to the
width of the surrounding frame or the page gallery.
- Improved image handling. The width of an image is now proportional to the
width of the surrounding frame.
- Improved table handling. The width of an outer table is now proportional to
the width of the page gallery. The column widths have the same proportions as
in the source document.
- Background images for paragraphs.
- Control over what goes into the spine of the book.
- Segmentation control through page breaks.
3.16 Changes Since Version 1.0
Bug fixes
- Generate the "xml:lang" attribute instead of "lang".
- Avoid gaps in the playOrder of the NCX-file.
- Take into account the anchor-type of a frame.
- Work around duplicate index mark ids in OpenOffice.org.
- Use "id" attribute instead of "name" on the "a" element.
- Generate a default "tbody" when there is no table row group in a table.
- Correct references to pictures in the OPF-file.
- Generate nested anchor elements for nested reference marks.
- Replace illegal characters when converting a reference name to an XML-id.
4. Contact Information
Comments and bug reports can be sent to support@pincette.biz. Information about
the application is available at http://www.pincette.biz/odftoepub/.