Register Guidelines E-Books Search Today's Posts Mark Forums Read

Go Back   MobileRead Forums > E-Book Formats > ePub

Notices

Reply
 
Thread Tools Search this Thread
Old 08-05-2009, 10:12 AM   #1
Nate the great
Sir Penguin of Edinburgh
Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.
 
Nate the great's Avatar
 
Posts: 10,388
Karma: 3161371
Join Date: Apr 2007
Location: DC Metro area
Device: Shake a stick plus 1
OPF & guide

Does anyone know if there is Epub reading software that uses the guide tags of the OPF file? I'd like to know if I can leave it undeveloped.

Thank you.
Nate the great is offline   Reply With Quote
Old 08-05-2009, 10:17 AM   #2
JSWolf
Resident Curmudgeon
JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.
 
JSWolf's Avatar
 
Posts: 36,469
Karma: 17660776
Join Date: Nov 2006
Location: Roslindale, Massachusetts
Device: Sony Reader PRS-650, iPad, nook STR
Here is from the most recent conversion using Calibre from MS Reader to ePub and the guide tags are used.

Code:
  <guide>
    <reference href="titlepage.xhtml" type="cover" title="Cover"/>
    <reference href="huntersthe_split_0.html#cop" type="copyright-page" title="Copyright link"/>
    <reference href="huntersthe_split_5.html#contents" type="toc" title="Table of Contents"/>
    <reference href="huntersthe_split_0.html#cop" type="title-page" title="About this title link"/>
  </guide>
JSWolf is offline   Reply With Quote
Old 08-05-2009, 10:24 AM   #3
Nate the great
Sir Penguin of Edinburgh
Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.
 
Nate the great's Avatar
 
Posts: 10,388
Karma: 3161371
Join Date: Apr 2007
Location: DC Metro area
Device: Shake a stick plus 1
Quote:
Originally Posted by JSWolf View Post
Here is from the most recent conversion using Calibre from MS Reader to ePub and the guide tags are used.

Code:
  <guide>
    <reference href="titlepage.xhtml" type="cover" title="Cover"/>
    <reference href="huntersthe_split_0.html#cop" type="copyright-page" title="Copyright link"/>
    <reference href="huntersthe_split_5.html#contents" type="toc" title="Table of Contents"/>
    <reference href="huntersthe_split_0.html#cop" type="title-page" title="About this title link"/>
  </guide>
I just checked, and I beleive that was copied over from the OPF inside the MSReader ebook. Just becuase it's there doesn't mean anything uses it.
Nate the great is offline   Reply With Quote
Old 08-05-2009, 11:36 AM   #4
kovidgoyal
creator of calibre
kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.
 
kovidgoyal's Avatar
 
Posts: 25,620
Karma: 4998447
Join Date: Oct 2006
Location: Mumbai, India
Device: Various
calibre uses the type="cover" entry in <guide> in epub books to know if the first entry in the spine is a cover or not. So if the user specifies their own cover and then re-converts, the original cover is replaced instead of becmoing the second item in the spine
kovidgoyal is offline   Reply With Quote
Old 08-05-2009, 11:38 AM   #5
Valloric
Created Sigil, FlightCrew
Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.
 
Valloric's Avatar
 
Posts: 1,978
Karma: 350515
Join Date: Feb 2008
Device: Sony Reader PRS 505
Quote:
Originally Posted by Nate the great View Post
Does anyone know if there is Epub reading software that uses the guide tags of the OPF file? I'd like to know if I can leave it undeveloped.
The guide section is in OPF 2.0 for backwards compatibility reasons, I think. From the OPF spec:

Quote:
Originally Posted by OPF 2.0
Reading Systems are not required to use the guide element in any way.
Because of this, few reading systems will support it. It also (poorly) duplicates the functionality of the NCX, that is, a presentable Table Of Contents. It's pretty much useless.

BTW Sigil doesn't create it and it will strip it from your input epub if it has one.
Valloric is offline   Reply With Quote
Old 08-05-2009, 11:44 AM   #6
kovidgoyal
creator of calibre
kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.
 
kovidgoyal's Avatar
 
Posts: 25,620
Karma: 4998447
Join Date: Oct 2006
Location: Mumbai, India
Device: Various
Quote:
Originally Posted by Valloric View Post
BTW Sigil doesn't create it and it will strip it from your input epub if it has one.
Could you change that to leave type="cover" alone, there's no other way to know if the first element in the spine is a cover or not.
kovidgoyal is offline   Reply With Quote
Old 08-05-2009, 11:49 AM   #7
Valloric
Created Sigil, FlightCrew
Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.
 
Valloric's Avatar
 
Posts: 1,978
Karma: 350515
Join Date: Feb 2008
Device: Sony Reader PRS 505
Quote:
Originally Posted by kovidgoyal View Post
Could you change that to leave type="cover" alone, there's no other way to know if the first element in the spine is a cover or not.
Create an issue for it and I'll see what I can do.
Valloric is offline   Reply With Quote
Old 08-05-2009, 12:18 PM   #8
Nate the great
Sir Penguin of Edinburgh
Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.
 
Nate the great's Avatar
 
Posts: 10,388
Karma: 3161371
Join Date: Apr 2007
Location: DC Metro area
Device: Shake a stick plus 1
Quote:
Originally Posted by kovidgoyal View Post
calibre uses the type="cover" entry in <guide> in epub books to know if the first entry in the spine is a cover or not. So if the user specifies their own cover and then re-converts, the original cover is replaced instead of becmoing the second item in the spine
I don't like how you generate the cover, but since this is relatively easy to accommodate I will.
Nate the great is offline   Reply With Quote
Old 08-05-2009, 12:20 PM   #9
JSWolf
Resident Curmudgeon
JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.
 
JSWolf's Avatar
 
Posts: 36,469
Karma: 17660776
Join Date: Nov 2006
Location: Roslindale, Massachusetts
Device: Sony Reader PRS-650, iPad, nook STR
Quote:
Originally Posted by Nate the great View Post
I don't like how you generate the cover, but since this is relatively easy to accommodate I will.
How would you generate the cover?
JSWolf is offline   Reply With Quote
Old 08-05-2009, 12:41 PM   #10
Nate the great
Sir Penguin of Edinburgh
Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.
 
Nate the great's Avatar
 
Posts: 10,388
Karma: 3161371
Join Date: Apr 2007
Location: DC Metro area
Device: Shake a stick plus 1
Quote:
Originally Posted by JSWolf View Post
How would you generate the cover?
There are several possibilities:

autodetection,
have a check box in the spine creation step for "first item is a cover",
prompt the user to add it it by hand,
and I'm sure there are a couple other ways it could be done.
Nate the great is offline   Reply With Quote
Old 08-05-2009, 12:42 PM   #11
Nate the great
Sir Penguin of Edinburgh
Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.Nate the great ought to be getting tired of karma fortunes by now.
 
Nate the great's Avatar
 
Posts: 10,388
Karma: 3161371
Join Date: Apr 2007
Location: DC Metro area
Device: Shake a stick plus 1
BTW, I wouldn't generate the cover; I'd simply create a reference to it if it existed.
Nate the great is offline   Reply With Quote
Old 08-05-2009, 02:17 PM   #12
kovidgoyal
creator of calibre
kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.
 
kovidgoyal's Avatar
 
Posts: 25,620
Karma: 4998447
Join Date: Oct 2006
Location: Mumbai, India
Device: Various
Whether the cover is generated or not is immaterial, the point is that given an epub file, if the user wants software to automatically replace the existing cover the only way the software can know that the file has an existing cover is via the guide.

This is not an issue for an editing software like Sigil, since the user can just manually remove the cover, but it is for an automatic converter like calibre.
kovidgoyal is offline   Reply With Quote
Old 08-05-2009, 02:38 PM   #13
Valloric
Created Sigil, FlightCrew
Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.
 
Valloric's Avatar
 
Posts: 1,978
Karma: 350515
Join Date: Feb 2008
Device: Sony Reader PRS 505
Quote:
Originally Posted by kovidgoyal View Post
This is not an issue for an editing software like Sigil, since the user can just manually remove the cover, but it is for an automatic converter like calibre.
This leads me to my main problem with this idea: I can't force the user to place a chapter break after an image and then somehow semantically mark this chapter/XHTML file as one containing the cover only. How would such a UI option even look like? How would it be presented to the user in a simple and understandable way? And honestly, why should the user care? If I were creating an epub book and would have no intention of messing with it in calibre, I would not do this. It would have no tangible benefit to me.

I also wouldn't want to do this automatically on export, not in an editor. An editor (unlike a converter) should never change the structure of the document the user sees in the editor. WYSIWYG means something very specific.

I would welcome suggestions on how could this be handled, because I can't see how it can be.
Valloric is offline   Reply With Quote
Old 08-05-2009, 02:39 PM   #14
ahi
Wizard
ahi ought to be getting tired of karma fortunes by now.ahi ought to be getting tired of karma fortunes by now.ahi ought to be getting tired of karma fortunes by now.ahi ought to be getting tired of karma fortunes by now.ahi ought to be getting tired of karma fortunes by now.ahi ought to be getting tired of karma fortunes by now.ahi ought to be getting tired of karma fortunes by now.ahi ought to be getting tired of karma fortunes by now.ahi ought to be getting tired of karma fortunes by now.ahi ought to be getting tired of karma fortunes by now.ahi ought to be getting tired of karma fortunes by now.
 
Posts: 1,792
Karma: 507333
Join Date: May 2009
Device: none
Quote:
Originally Posted by kovidgoyal View Post
Whether the cover is generated or not is immaterial, the point is that given an epub file, if the user wants software to automatically replace the existing cover the only way the software can know that the file has an existing cover is via the guide.

This is not an issue for an editing software like Sigil, since the user can just manually remove the cover, but it is for an automatic converter like calibre.
Wouldn't a first page consisting solely of an image be a reasonably certain indication that it is a cover... regardless of whether the metadata also attests it to be?

- Ahi
ahi is offline   Reply With Quote
Old 08-05-2009, 02:51 PM   #15
Valloric
Created Sigil, FlightCrew
Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.Valloric ought to be getting tired of karma fortunes by now.
 
Valloric's Avatar
 
Posts: 1,978
Karma: 350515
Join Date: Feb 2008
Device: Sony Reader PRS 505
Quote:
Originally Posted by ahi View Post
Wouldn't a first page consisting solely of an image be a reasonably certain indication that it is a cover... regardless of whether the metadata also attests it to be?
Define "first page".

Also, what happens when the user loads in an epub comic book?
Valloric is offline   Reply With Quote
Reply

Thread Tools Search this Thread
Search this Thread:

Advanced Search

Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
Free Book (Kindle) - Periodic Table & Acupressure Guide koland Deals, Freebies, and Resources (No Self-Promotion) 0 09-15-2010 10:56 PM
Adding a <reference> item to <guide> in OPF file GRiker Sigil 2 04-12-2010 01:06 PM
EFF's guide to e-book buying & privacy grimo1re News 52 12-25-2009 08:17 PM
HTML, NCX & OPF --> MESS pakiyabhai Workshop 2 12-22-2009 10:43 AM
Can html2epub create the OPF & NCX files? Acey Calibre 4 11-17-2008 12:33 AM


All times are GMT -4. The time now is 04:42 PM.


MobileRead.com is a privately owned, operated and funded community.