[Old Thread] epub-fix

chicagofilms · 07-10-2010, 08:59 AM

Can anyone explain a bit more about this? What it does & how to use it?

For instance, will it remove fixed font colors? I'm finding that most of my huge collection of books have the font color set as black & that means in Stanza on iPad, I can't use night mode.

I tried running it on one of my books & just got: OPF contains date 2010-04-16 00:00:00-05:00 that epubcheck does not like

The utility did not seem to do anything else.

My primary goal is an easy way to fix my books that have fixed font colors, styles, etc.

thanks

itimpi · 07-10-2010, 09:00 AM

Have you read the description in the Release Notes?

kovidgoyal · 07-10-2010, 09:02 AM

At the moment it only fixes errors that can cause publishing services to reject epubs. To have it actually fix things you have to run it like this

epub-fix --unmanifested --epubcheck file.epub

Run

epub-fix -h

for details on what it will fix.

chicagofilms · 07-10-2010, 09:08 AM

You mean this:

New tool to help prepare EPUBs for publication
"calibre now contains a new command line tool called epub-fix that can automatically fix common problems in EPUB files that cause them to be rejected by poorly designed publishing services. The tool is plugin based for extensible functionality in the future. Currently, it can fix unmanifested files and workaround the date and svg preserveaspectratio bugs of epubcheck."

It's not very helpful to me. For instance, is my issue a "common problem in EPUB files that cause them to be rejected by poorly designed publishing services"? I don't know. Is the font issue I have the result of "unmanifested files"? I don't know.

I just read books, I don't know all the technical aspects behind creating them. Calibre does all the work for me (Thanks kovidgoyal!). Beyond dropping files in there & converting to epub, I really am not proficient in file formats.

That's why I'm asking for help & more info. Thanks though.

chicagofilms · 07-10-2010, 09:09 AM

Quote:

Originally Posted by kovidgoyal

At the moment it only fixes errors that can cause publishing services to reject epubs. To have it actually fix things you have to run it like this

epub-fix --unmanifested --epubcheck file.epub

Run

epub-fix -h

for details on what it will fix.

OK, thanks.

Mike2753 · 07-12-2010, 04:44 AM

Kovid,

Can you please clarify this in more details

epub-fix --unmanifested --epubcheck file.epub.

Actually I did not understood this path and how I can resolve the unmanifested issues from the epub file.

Many Thanks
Mike

kovidgoyal · 07-12-2010, 10:10 AM

Just run that command, it will fix unmanifested fiels for you

Mike2753 · 07-12-2010, 01:36 PM

Quote:

Originally Posted by kovidgoyal

Just run that command, it will fix unmanifested fiels for you

Kovid,

Thank you for your reply. As i am a newbie, i am really finding it difficult. Is it possible for you to sent few screenshots out here on how to run that command. It will really be a big help.

Thanks,
Mike

Starson17 · 07-12-2010, 02:10 PM

Quote:

Originally Posted by Mike2753

As i am a newbie, i am really finding it difficult. Is it possible for you to sent few screenshots out here on how to run that command. It will really be a big help.

Probably fewer than one in 10,000 of Calibre's users will ever need to use that command and I'd guess the percentage is even lower for newbies. Why do you think you need it? It's not a magic epub fixing program. It handles a few very specific errors.

I'm not trying to be a pain. I'll help you run it if you can explain why you need it. Basically, you run it via the command line, and if you aren't sure what that means, or how to get to the command line, I find it hard to believe you are familiar with the technical details of manifests in an EPUB.

SomeNewGuy · 05-04-2011, 12:36 PM

Can you pleas explain to me, absolute beginner, how to use epub-fix? I don`t even know where is it and how to do it. I`m using Calibre 7.75.

DoctorOhh · 05-04-2011, 07:23 PM

Quote:

Originally Posted by SomeNewGuy

Can you pleas explain to me, absolute beginner, how to use epub-fix? I don`t even know where is it and how to do it. I`m using Calibre 7.75.

Calibre 0.7.75? Just so you know the latest release is 0.7.59. This Friday should see the release of 0.8.0.

Anyways you can find epub-fix.exe in calibre's program directory. Open up a command prompt window and run as stated below to see what it will fix.

Quote:

Originally Posted by kovidgoyal

Run

epub-fix -h

for details on what it will fix.

More info can be found in this section of the manual.

SomeNewGuy · 05-05-2011, 07:15 AM

Thanks I`ll try that, this is the one I found on their site

SomeNewGuy · 05-06-2011, 02:22 PM

OK I have one problem. I guess I need more help with this. I don`t think that I still know how this works. I started the RUN and typed epub-fix -h, but it`s didn`t fixed it. I just need for the ePUB to pass validation, just that. If there is any other way, I`ll try it.

DoctorOhh · 05-06-2011, 04:00 PM

Quote:

Originally Posted by SomeNewGuy

OK I have one problem. I guess I need more help with this. I don`t think that I still know how this works. I started the RUN and typed epub-fix -h, but it`s didn`t fixed it. I just need for the ePUB to pass validation, just that. If there is any other way, I`ll try it.

If you want your ePub to pass validation I would seek help on the specific issues you're having with the ePub in the forum for the validation tool you're using or in either the Sigil forum or the ePub forum.

Starson17 · 05-06-2011, 04:07 PM

Quote:

Originally Posted by SomeNewGuy

OK I have one problem. I guess I need more help with this. I don`t think that I still know how this works. I started the RUN and typed epub-fix -h, but it`s didn`t fixed it. I just need for the ePUB to pass validation, just that. If there is any other way, I`ll try it.

epub-fix -h just gives you help on how to use it. It doesn't fix anything until you specify the book to be fixed. If you ran it directly from the run command, it would have given the help and closed immediately.

Here's what it would have said:

Code:

Usage: epub-fix.exe [options] file.epub

Fix common problems in EPUB files that can cause them to be rejected by poorly designed publishing services.

By default, no fixing is done and messages are printed out for each error detect
ed. Use the options to control which errors are automatically fixed.

Whenever you pass arguments to epub-fix.exe that have spaces in them, enclose the arguments in quotation marks.

Options:
  --version             show program's version number and exit

  -h, --help            show this help message and exit

  --unmanifested        Fix unmanifested files. epub-fix can either add them
                        to the manifest or delete them as specified by the
                        delete unmanifested option.

  --delete-unmanifested
                        Delete unmanifested files instead of adding them to
                        the manifest

  --epubcheck           Workarounds for bugs in the latest release of
                        epubcheck. epubcheck reports many things as errors
                        that are not actually errors. epub-fix will try to
                        detect these and replace them with constructs that
                        epubcheck likes. This may cause significant changes to
                        your epub, complain to the epubcheck project.


Created by Kovid Goyal <kovid@kovidgoyal.net>

07-10-2010, 08:59 AM	#1
chicagofilms Member Posts: 23 Karma: 10 Join Date: Oct 2008 Device: prs-505	[Old Thread] epub-fix Can anyone explain a bit more about this? What it does & how to use it? For instance, will it remove fixed font colors? I'm finding that most of my huge collection of books have the font color set as black & that means in Stanza on iPad, I can't use night mode. I tried running it on one of my books & just got: OPF contains date 2010-04-16 00:00:00-05:00 that epubcheck does not like The utility did not seem to do anything else. My primary goal is an easy way to fix my books that have fixed font colors, styles, etc. thanks

05-06-2011, 02:22 PM	#13
SomeNewGuy Junior Member Posts: 9 Karma: 10 Join Date: May 2011 Device: none	OK I have one problem. I guess I need more help with this. I don`t think that I still know how this works. I started the RUN and typed epub-fix -h, but it`s didn`t fixed it. I just need for the ePUB to pass validation, just that. If there is any other way, I`ll try it. Last edited by SomeNewGuy; 05-06-2011 at 03:45 PM.

Thread Tools	Search this Thread
Show Printable Version Email this Page	Search this Thread: Advanced Search

Similar Threads
Thread	Thread Starter	Forum	Replies	Last Post
How do I fix my epub file to upload on lulu?	sparkletown	Sigil	38	04-04-2011 02:39 PM
[Old Thread] Reading epub on viewer inexplicably changes the time stamp of epub	greenapple	Library Management	20	03-19-2011 10:18 PM
Can I fix ePub page break formatting?	arcane_scholar	Calibre	3	02-02-2011 04:01 PM
How do I use epub-fix?	mrbillb	Calibre	8	09-28-2010 12:55 AM
Lit to Epub... Problem and can't fix?	jotekman	Calibre	6	09-10-2010 04:12 AM

07-10-2010, 09:00 AM	#2
itimpi Wizard Posts: 4,552 Karma: 950151 Join Date: Nov 2008 Device: Sony PRS-950, iphone/ipad (Marvin/iBooks/QuickReader)	Have you read the description in the Release Notes?

07-10-2010, 09:02 AM	#3
kovidgoyal creator of calibre Posts: 43,826 Karma: 22666666 Join Date: Oct 2006 Location: Mumbai, India Device: Various	At the moment it only fixes errors that can cause publishing services to reject epubs. To have it actually fix things you have to run it like this epub-fix --unmanifested --epubcheck file.epub Run epub-fix -h for details on what it will fix.

07-10-2010, 09:08 AM	#4
chicagofilms Member Posts: 23 Karma: 10 Join Date: Oct 2008 Device: prs-505	You mean this: New tool to help prepare EPUBs for publication "calibre now contains a new command line tool called epub-fix that can automatically fix common problems in EPUB files that cause them to be rejected by poorly designed publishing services. The tool is plugin based for extensible functionality in the future. Currently, it can fix unmanifested files and workaround the date and svg preserveaspectratio bugs of epubcheck." It's not very helpful to me. For instance, is my issue a "common problem in EPUB files that cause them to be rejected by poorly designed publishing services"? I don't know. Is the font issue I have the result of "unmanifested files"? I don't know. I just read books, I don't know all the technical aspects behind creating them. Calibre does all the work for me (Thanks kovidgoyal!). Beyond dropping files in there & converting to epub, I really am not proficient in file formats. That's why I'm asking for help & more info. Thanks though.

07-12-2010, 04:44 AM	#6
Mike2753 Junior Member Posts: 4 Karma: 10 Join Date: Jul 2010 Device: none	Kovid, Can you please clarify this in more details epub-fix --unmanifested --epubcheck file.epub. Actually I did not understood this path and how I can resolve the unmanifested issues from the epub file. Many Thanks Mike

07-12-2010, 10:10 AM	#7
kovidgoyal creator of calibre Posts: 43,826 Karma: 22666666 Join Date: Oct 2006 Location: Mumbai, India Device: Various	Just run that command, it will fix unmanifested fiels for you

05-04-2011, 12:36 PM	#10
SomeNewGuy Junior Member Posts: 9 Karma: 10 Join Date: May 2011 Device: none	Can you pleas explain to me, absolute beginner, how to use epub-fix? I don`t even know where is it and how to do it. I`m using Calibre 7.75.

05-05-2011, 07:15 AM	#12
SomeNewGuy Junior Member Posts: 9 Karma: 10 Join Date: May 2011 Device: none	Thanks I`ll try that, this is the one I found on their site

Advert

Advert