View Full Version : ETI eBook Publisher : bug reports / workarounds / update requests


zelda_pinwheel
03-24-2008, 07:34 PM
while we were discussing workarounds for a bug in eBook Publisher program in a different thread (http://www.mobileread.com/forums/showthread.php?t=22209), we thought it might be constructive to pool our knowledge in one single thread. we are also hoping this thread will catch Garth Conboy's eye ;) for hypothetical future versions of the application.

This thread is for :

1. reporting bugs in the soft
2. sharing workarounds
3. suggestions for improvements, for (hypothetical) future versions.

To keep it easy to navigate, maybe use the title of the post to indicate what bug / workaround / feature request you're talking about.

zelda_pinwheel
03-24-2008, 07:37 PM
the USABLE screen size of the eb1150 (for a full-screen image, for example), is approximately 310 x 430 px, taking into account the space taken up by running headers in "smallfont" or size "small" text, and small side margins.

DaleDe
03-24-2008, 07:55 PM
I have a whole list of requests for improvements in eBook Publisher on my web site.

Dale

zelda_pinwheel
03-24-2008, 08:08 PM
if you place an image in your book, which is larger than the maximum screen size of 310 x 430 px (for a 1150 .imp), eBook Publisher will automatically scale the image to fit the screen.

BUG : it will only scale horizontally, not vertically. this means, if your image is tall and narrow, it will fill the screen from side to side but the bottom will be cut off.

WORKAROUNDS : found after much discussion over here (http://www.mobileread.com/forums/showthread.php?t=22209)
1. resize your image to 430 px max height (for 1150). this is the cleanest solution, especially if you are *only* making an eb1150 version .imp file.

OR

2. add empty side margins to your file, so that it is PROPORTIONAL (homothetic) to the max 1150 screen size of 310 x 430. this can easily be done in Photoshop or other image-editing software, including with batch treatment. THE KEY IS TO RESPECT THE HEIGHT:WIDTH RATIO ; size is immaterial. see practical method below.

NOTE : this workaround will allow you to use the same set of images for the creation of an eb1150 AND 1200 version .imp file, provided that in the 1200 version you add 2ems of margin to the left and right of each full-screen image.

PHOTOSHOP WORKFLOW FOR THIS METHOD :
1. open the image you want to resize (img1).

2. create a "dummy" image* (File>newfile) of 310 x 430 px.

3. select img1, and open the image size dialogue box (ctrl + alt + i). copy the current HEIGHT (ex : 800px), cancel.

4. select dummy image* : open image size, verify that the dimensions are linked ("scale proportionately"), paste the height of other image (800px). The dummy image will automatically be resized. Copy the resulting adjusted WIDTH (for 800px height, width will be 577px), cancel.

*The dummy image is only to simplify things by letting Photoshop do all the math. if you like calculating things, by all means skip the dummy image and figure it out yourself.

5. back to img1, canvas size (ctrl + alt + c), verify that the canvas will be enlarged from the center out and fill color is white, paste new WIDTH (577px), OK.

You can also make a photoshop script for automating this process, if you have a lot of images which are all close to the same height (best results if images have less than 20% variation in height). If height varies wildly, FIRST average out heights by reducing the images (constrain proportions) to the same height.

If you are making an imp 1200 version as well, add 2 em margins to the left and right of each image. you can easily do this by editing the html code of your 1200 version and doing a search and replace (ctrl + H) :
for example, search ><img (the end of the opening p or div container tag, the beginning of the opening img tag)
replace with style="margin-left:2em; margin-right:2em"><img

i recommend doing all the code cleanup on the 1150 version *first* ; then save the html / opf, make the book, close. then MAKE A COPY of the html file adding "_1200" to the filename. then you import this file into the _1200 opf which mobi2imp has conveniently created for you, instead of the original html, and add all the margins to the images. this way, you have 2 separate files to address the different format, but you only do the work once.

zelda_pinwheel
03-24-2008, 08:09 PM
I have a whole list of requests for improvements in eBook Publisher on my web site.

Dale

by all means, add the link to this thread. here we can all collaborate and also offer workarounds and solutions we have found.

nrapallo
03-24-2008, 08:13 PM
I was converting some .prc to .imp recently and came across a situation where eBook Publisher died without so much as a good-bye! :(

The culprit is reproduced here (in bold):<html>
<head>
</head>
<body>
<p>Html documents with this entity &# 20; bomb! No output produced by eBook Publisher v2.2.5</p>
</body>
</html>


Note for display purposes, I put a space between '#' and '2' which should be removed!

I think the author of the .prc wanted to use spaces HTML code '&# 32;' and typed the hex code 20 instead.

BTW, HTML char codes are the &words; used to represent specific characters, for example: '&' is represented by '&#amp;'
is represented by '&#copy';

See the HTML Characters (http://wiki.mobileread.com/wiki/ISO-8859-1) wiki for more information or Special Characters (http://wiki.mobileread.com/wiki/Special_characters) wiki for more advanced uses.

zelda_pinwheel
03-24-2008, 08:14 PM
BUG : you cannot specify a margin (or padding) for the "img" tag, either in the css in the head of the document, or inside the individual img tags.

WORKAROUND : add the code using the "style" tag to the container (p or div tag), for example :
<p style="margin-left:2em; margin-right:2em"><img border="0" hspace="0" src="img1.jpg" /></p>

The obvious disadvantage being that you must treat each image individually, rather than just adding one line of css code to the head of your document.

nrapallo
03-24-2008, 08:18 PM
I have issues with the href links being case sensitive:

<a href="#WORD">link</a> cannot find <a name="Word"> later on in the html code.

nrapallo
03-24-2008, 08:33 PM
BUG : you cannot specify a margin (or padding) for the "img" tag, either in the css in the head of the document, or inside the individual img tags.

WORKAROUND : add the code using the "style" tag to the container (p or div tag), for example :
<p style="margin-left:2em; margin-right:2em"><img border="0" hspace="0" src="img1.jpg" /></p>

The obvious disadvantage being that you must treat each image individually, rather than just adding one line of css code to the head of your document.

Likewise, for <p> the margin-bottom is simply ignored. The margin-top needs something to "push-off' like a <div>&zwnj;</div>. This bug has been around for a long time and is discussed in the Stylesheets chapter of the 'REBTestDocSrc.imp' posted here (http://www.mobileread.com/forums/showthread.php?t=21062).

nrapallo
03-24-2008, 09:11 PM
BUG: Missing fraction support for say one-half or three-quarters

WORKAROUND: The &frasl; character allows you to create fractions that flow more proportionately with the surrounding text. 1/2 vs. <sup class="frac">1</sup>&frasl;<sub class="frac">2</sub> and
3/4 vs. <sup class="frac">3</sup>&frasl;<sub class="frac">4</sub>

- another method using small text yields 1/2 or 3/4: <small>1</small>&frasl;<small>2</small> or
<small>3</small>&frasl;<small>4</small>

- and another method using a mixture yields 1/2 or 3/4: <sup>1</sup>/<small>2</small> or
<sup>3</sup>/<small>4</small>

- and another method using a mixture yields 1/2 or 3/4: <sup>1</sup>&frasl;<small>2</small> or
<sup>3</sup>&frasl;<small>4</small>

- and another simple method using just <SMALL> yields 1/2 or 3/4: <small>1/2</small> or
<small>3/4</small>

nrapallo
04-01-2008, 12:10 AM
Mobipocket Creator can read .opf projects created by eBook Publisher, but not the other way round. It appears that Mobipocket Creator strips all the data within the <x-metadata> ... </x-metadata> block except for an embedded cover.

However, eBook Publisher requires its standard information there.

Solution, just insert the following text into the .opf created by Mobipocket Creator, then load in eBook Publisher and adjust Edition Settings to your liking:

<x-metadata>
<meta name="x-SBP-logging" content="on"/>
<meta name="x-SBP-encrypt" content="off"/>
<meta name="x-SBP-compress" content="on"/>
<meta name="x-SBP-widow" content="0"/>
<meta name="x-SBP-orphan" content="0"/>
<meta name="x-SBP-zoomstate" content="both"/>
<meta name="x-SBP-undlinks" content="on"/>
<meta name="x-SBP-csssupport" content="2"/>
<meta name="x-SBP-projectversion" content="1"/>
<meta name="x-SBP-RLEtrigger" content="25"/>
<meta name="x-SBP-devicemodel" content="gs"/>
<meta name="x-Gemstar-Initial-Content" content="false"/>
<meta name="x-Gemstar-Require-ISBN" content="false"/>
<meta name="x-Gemstar-KeepAnchorLinks" content="false"/>
<meta name="x-Gemstar-PreScaleImages" content="true"/>
<meta name="x-Gemstar-ColorDepth" content="0"/>
<meta name="x-Gemstar-Grayscale" content="false"/>
<meta name="x-Gemstar-ConvertToJPEG" content="true"/>
<meta name="x-Gemstar-CreatedBy" content="2.2.4.5"/>
<meta name="x-SBPNuvo-Build-ID" content="ebook:guid-03d46d97e9524b0b8befb1c6b98f8ada"/>
<meta name="x-SBPNuvo-Timestamp" content="108-02-14T12:31:20Z"/>
<meta name="x-SBPNuvo-Content-Is-Periodical" content="no"/>
<meta name="x-Gemstar-PriceBinding" content="no"/>
<meta name="x-SBP-destdir" content="."/>
<meta name="x-SBP-category" content="General Interest"/>
<meta name="x-Gemstar-ModifiedBy" content="2.2.4.5"/>
</x-metadata>
Another reason eBook Publisher may complain and refuse to load is if the media type of '.html' items within the <manifest> block is not the following:
media-type="text/x-oeb1-document"
If not, change all '.html' item media-types to the above, save the .opf and load it in eBook Publisher. You should now have a .opf project file that will load in eBook Publisher!

zelda_pinwheel
04-05-2008, 11:22 AM
Currently eBook Publisher does not support many many special glyphs, of the kind used in phonetic transcriptions (e.g. pronunciation guides in dictionaries) for example or the special characters used in writing in Esperanto (i hear...) and presumably some other languages.

It would be nice if the next version could support a wider range of properly coded unicode characters / html entities ; the only thing more frustrating than seeing "Unknown named entity (& thorn ;) encountered. Replacing with '?' " in the output window, is seeing "Legal Unicode value encountered for a glyph we do not support. Replacing with '?' "

Additional font support would be really nice as well ; even if only Arial and Times New Roman were added, the glyph support would probably be pretty exhaustive from them alone, and in addition these are good basic fonts for formatting body text which also have true bold and italic forms (this is important).

Ideally, it would be really brilliant to be able to load your own choice of True Type or Open Type fonts ; apart from the comfort and pleasure of reading a really well-drawn font, this would also allow you to support whatever glyphs you needed by simple adding the proper font.

nrapallo
06-10-2008, 08:36 AM
For creating your own .imp ebooks from .html source, the most powerful software to use is eBook_Publisher. It has a steep learning curve, but what powerful software doesn't.

To create .imp ebooks from (hyperlinked/CSS) .html source file(s), start eBook Publisher and follow these steps:

- First, eBook Publisher requires that you to create a New Project (.opf file) using the File menu item.

- Next, you should enter the ebook details using Edition Setting... under the Project menu and save it using the name of your resulting .imp ebook. Ensure you uncheck "Require ISBN", enter Title, Author and Bookshelf Category at a minimum as these are required entries.

- Next, you can Add Files... any source .html, just change the file-requester's filetype from *.odf to *.html.

- Next make sure you change the Build Target from the default "OEBFF: All Targets" to "Grayscale Half-VGA" for the eBookwise 1150 .imp format.

- Last, select Build Edition... and determine if the Processing Successful message appears as the last line of the Errors and Messages window. If not, you may need to tweak your source .html and repeat Build Edition... until you are satisfied with the .imp output.

To get the .imp file onto the reader, just follow this (http://www.mobileread.com/forums/showthread.php?p=152902#post152902).

Obviously, this is just a very cursory step-by-step, but it should point you in the right direction. And yes, you will benefit by reading the eBook Publisher 2.1 documentation/manual (User's Guide).

Anyone having any problems/issues, should post a question in a new thread in the Fictionwise forum.

nrapallo
01-27-2009, 05:03 PM
eBook Technologies, Inc. (formerly ETI (www.eBooktechnologies.com)-acquired in 2011 by Google http://ebooktechnologies.com/) has released a new version of their eBook Publisher software (http://www.ebooksystem.net/support_publisher_download.htm) (v2.3.8) that is now able to load and save .epub ebooks.

However, there is no direct device support for .epub ebooks (they still need to be converted to .imp, which in turn are exploded into .res folders within the hardware reading device-EBW1150 or REB12000).

What this means is that .imp ebooks can now be created directly from .epub ebooks. However, .epub ebooks may employ advanced coding/CSS styles which are not easily converted for use on the ETI devices. As a result, there still may be some hand-editing that will have to be done to make sure certain CSS styles are "useable" within .imp ebooks.

Workarounds will be found to make the .epub to .imp process much more effective and should you have one, please post it here, to allow others to gain insights without all the frustration that's usually encountered.

Here's a starting tip to deal with loading/unpacking .epub ebooks:To open a .epub ebook, use the File menu item Open... and ensure the Files of type Archive files (.epub, .oeb) is selected. When the OCF Container Settings screen opens up, click the Unpack button and make a new folder to hold the unpacked ebook contents and save the .opf file within there!

A new instance of eBook Publisher will load and be ready to convert that .epub ebook to .imp (be sure to change the Edition Settings... to your preferences). Just close the first instance of the eBook Publisher that remained open.

Happy converting!

p.s. here's What's New:RELEASE NOTES
eBook Technologies, Inc. --------------- eBook Publisher version 2.3
==================================================

What's New?
--------------------------------------------------------------------
Version 2.3 contains the following major improvements over version 2.2:

- Bulk Convert and eBook Publisher now support conversion from .docx format.

- Bulk Convert and eBook Publisher now support conversion from .pptx format.

- Bulk Convert and eBook Publisher now produce .epub files in all situations
where they used to produce .oeb files.

- Bulk Convert and eBook Publisher now support conversion from .epub
format. Files will be accepted in either .epub or .oeb format interchangeably.
It is therefore possible to easily migrate from OEBFF based workflows to EPUB
based workflows.

- Oversized images are now scaled down when they exceed the page height.

- Mapping of non-ASCII characters has been improved. Most non-ASCII
characters are mapped to provide a visually recognizable equivalent.

DaleDe
01-27-2009, 05:57 PM
Fantastic, not just ePUB conversion I see but many other improvements and even a modern Mac version. Great job eBook Technologies.

Dale

zelda_pinwheel
01-27-2009, 06:01 PM
brilliant news !! it's great to see ETI is still developping for their products, it would be a shame for them to be left in a corner somewhere. not that epub support is a suprise from Garth Conboy, of course, but i's a very welcome addition nonetheless. thanks ETI ! nice work ! and thanks Nick for the news !

nrapallo
01-27-2009, 06:09 PM
Fantastic, not just ePUB conversion I see but many other improvements and even a modern Mac version. Great job eBook Technologies.

Dale

Dale:

For the Mac version above, are you referring to the Beta Mac OS X Publication Tools? Does this also support .epub conversions?

nrapallo
01-27-2009, 06:18 PM
not that epub support is a suprise from Garth Conboy, of course, but i's a very welcome addition nonetheless. thanks ETI ! nice work ! and thanks Nick for the news !

Yes, Garth is right in the midst of this .epub standard and where we NEED him to be! Just a note that, John Rivlin, co-founder of ETI is also a major reason this new version has been released.

Kudos to the ETI Guys!

DaleDe
01-27-2009, 06:48 PM
Dale:

For the Mac version above, are you referring to the Beta Mac OS X Publication Tools? Does this also support .epub conversions?

I haven't tried it myself but the openness of having mac versions is good for the industry.

Dale

nrapallo
01-27-2009, 08:40 PM
I haven't tried it myself but the openness of having mac versions is good for the industry.

Dale

Oh, another tidbit, Garth is a Mac person; John is more Windows inclined.

Even though I used, for Business, the very first Apple Macintosh and the early IBM XT/AT's, I consider myself more Windows literate.

For personal use, I am only a Windows person (ever since I begrudgingly left the Amiga platform... :cool: ).

DaleDe
01-28-2009, 10:40 AM
Is there any documentation on this version available anywhere? It looks like you can create ePUB ebooks with it, and retrieve ePUB back into the Publisher environment. The choice to select ePUB has a icon beside it that can be used to view the document but it chops the right edge off all the pages in my system. Is there something that can be done about that? The windows install now redirects all ePUB to the publisher but I can fix that.

Dale

nrapallo
01-28-2009, 01:06 PM
Is there any documentation on this version available anywhere?

No, there isn't anything specific to this version in their Documentation other than the What's New in v2.3 blurb. The rest of their eBook Publisher Windows.doc wasn't updated to include any .epub specific issues. Just follow the old way of doing things, in the documentation, using .oeb (OEBFF) files. They do say that the two (.epub and .oeb) are dealt with interchangeably. It's not .epub specific, but should help cope with them.

It looks like you can create ePUB ebooks with it, and retrieve ePUB back into the Publisher environment. The choice to select ePUB has a icon beside it that can be used to view the document but it chops the right edge off all the pages in my system. Is there something that can be done about that?

You're referring to the Preview target icon on the OCF Container Settings screen. If I set it to Color VGA I get the REB1200 preview. However, I too get that problem when I set it to Grayscale Half-VGA. It doesn't seem to allow a EBW1150 preview. This I think is a bug. (Hey, isn't that what this thread is for!)

The windows install now redirects all ePUB to the publisher but I can fix that.

Dale

Can you try the Mac software and gives us an idea/feedback how it works? That software though has been out for a while, so I don't think it has full .epub support, if any. I'm curious to know what the differences are between the Windows and Mac versions. No one has ever mentioned using it before. :dunno:

DaleDe
01-28-2009, 01:19 PM
Sorry I do not have a mac.

Dale

pilotbob
01-28-2009, 01:43 PM
Sorry I do not have a mac.


We are sad for you. :rolleyes:

BOb

DaleDe
01-28-2009, 01:46 PM
We are sad for you. :rolleyes:

BOb

Well, Bob, welcome to the thread. I guess you are nominated to test the eBook Publisher mac edition!

Dale

pilotbob
01-28-2009, 02:08 PM
Well, Bob, welcome to the thread. I guess you are nominated to test the eBook Publisher mac edition!

Dale

Isn't that kind of difficult when I don't have an ETI device? (I know you are sad for me. :smack:)

BOb

nrapallo
01-28-2009, 02:27 PM
Sorry I do not have a mac.

Dale

:smack: Oops, thought you did! :chinscratch: Who else out there uses a Mac and could try this out, for purely academic reasons.... :dunno: ;)

Isn't that kind of difficult when I don't have an ETI device? (I know you are sad for me. :smack:)

BOb


Hi BOb!

Not really. Any .imp ebooks produced can be viewed with the supplied viewer (if there is one, we don't really have any feedback on this yet) or even posted here :snicker: .

Screenshots would be nice, then you could uninstall the software. You can check our wiki (eBook Publisher) for a Windows screenshot of the program.

If you would like some help getting started, I'm a request away.....

Thanks!

zelda_pinwheel
01-28-2009, 02:28 PM
Isn't that kind of difficult when I don't have an ETI device? (I know you are sad for me. :smack:)

BOb

yes we are. :D

but you could test the software without having a device ; just use the built-in simulator.

edit : oops, nick was faster.

pilotbob
01-28-2009, 04:58 PM
but you could test the software without having a device ; just use the built-in simulator.


I'll give it a whack when I get a chance.

Basically, what do you want me to try. Load an ePub book and then try to view it? Perhaps compare the view with the ePub being viewed in Stanza or Calibre perhaps?

BOb

nrapallo
01-28-2009, 05:11 PM
I'll give it a whack when I get a chance.

Basically, what do you want me to try. Load an ePub book and then try to view it? Perhaps compare the view with the ePub being viewed in Stanza or Calibre perhaps?

BOb

The viewing, I think, is currently a bit broken.

But if you could generate a .imp ebook from a widely available source, like REBTestDocSrc.zip (http://www.mobileread.com/forums/attachment.php?attachmentid=10794&d=1203826248) and then compare that to an existing .imp, like those here (http://www.mobileread.com/forums/showthread.php?t=21062), then that would be better. Just load the REBtestdoc.opf and build the Grayscale Half-VGA (i.e. EBW1150) target. See sample images from the PC viewer program below.

I don't know if the Mac version even has any support yet for .epub ebooks. That's what you may be able to confirm for us.

Otherwise, earlier in this thread, I explained how to create a .imp ebook (http://www.mobileread.com/forums/showthread.php?p=196829#post196829) from a .html source. See if you can follow it and post your results. Again, I'm here for some hand-holding (in a platonic-way :rolleyes:).

Thanks for taking this on!

DaleDe
01-28-2009, 05:35 PM
Isn't that kind of difficult when I don't have an ETI device? (I know you are sad for me. :smack:)

BOb

There is no need for an ETI device. The new ePUB format does not work with ETI devices anyway.

I have found the ePUB creation does not build a correct TOC in the ePUB file (.ncx) and thus ADE will not read the file. It opens it but does not display any pages. I do not know if the Sony reader will read it. I have found that the eBook Viewer that is part of Calibre will read the file. I haven't tried FBReader yet.

Dale

nrapallo
01-28-2009, 05:39 PM
There is no need for an ETI device. The new ePUB format does not work with ETI devices anyway.

I have found the ePUB creation does not build a correct TOC in the ePUB file (.ncx) and thus ADE will not read the file. It opens it but does not display any pages. I do not know if the Sony reader will read it. I have found that the eBook Viewer that is part of Calibre will read the file. I haven't tried FBReader yet.

Dale

I hope it's ADE that's the culprit here and not ETI! :chinscratch:

pilotbob
01-28-2009, 05:40 PM
Ok,

So I need a good test plan with well written test cases.

BOb

nrapallo
01-28-2009, 05:45 PM
Ok,

So I need a good test plan with well written test cases.

BOb

Only need one test case to start off with. For now, the one I previously posted (http://www.mobileread.com/forums/showthread.php?p=338051#post338051) may be the best test case to try.

DaleDe
01-28-2009, 05:49 PM
I hope it's ADE that's the culprit here and not ETI! :chinscratch:

FBReader 0.10.2 on windows behaves like ADE but does not show any errors.

Dale

nrapallo
01-28-2009, 05:51 PM
FBReader 0.10.2 on windows behaves like ADE.

Dale

:angry: Industry Standard NOT!

Hopefully, these are growing pains and we will eventually get there!

nrapallo
02-20-2009, 07:59 AM
I have found the ePUB creation does not build a correct TOC in the ePUB file (.ncx) and thus ADE will not read the file. It opens it but does not display any pages. I do not know if the Sony reader will read it. I have found that the eBook Viewer that is part of Calibre will read the file. I haven't tried FBReader yet.

Dale

A updated version 2.3.9 has been released, which seems to properly generate and include the .ncx file into .epubs. I don't know though if this will help ADE/FBReader open/read the eBook Publisher created .epubs.

Not sure what else has been changed in this version but I like the fact that new versions are coming out... (can't wait for v2.3.10 ;) )

zelda_pinwheel
02-20-2009, 08:26 AM
A updated version 2.3.9 has been released, which seems to properly generate and include the .ncx file into .epubs. I don't know though if this will help ADE/FBReader open/read the eBook Publisher created .epubs.

Not sure what else has been changed in this version but I like the fact that new versions are coming out... (can't wait for v2.3.10 ;) )
me too ! :) off to download the new version. thanks for the info !

nrapallo
02-20-2009, 08:37 AM
me too ! :) off to download the new version. thanks for the info !

:smack: The new version's .epubs still don't seem to open in ADE. :chinscratch:

zelda_pinwheel
02-20-2009, 09:22 AM
:smack: The new version's .epubs still don't seem to open in ADE. :chinscratch:

arg ! :smack: so close, and yet still so far... well, as you said, at least we know they're working on it, and that is good news. i guess we just have to keep watching...