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

Go Back   MobileRead Forums > E-Book Software > Sigil

Notices

Reply
 
Thread Tools Search this Thread
Old 01-12-2019, 11:21 PM   #1
Gregg Bell
Gregg Bell
Gregg Bell ought to be getting tired of karma fortunes by now.Gregg Bell ought to be getting tired of karma fortunes by now.Gregg Bell ought to be getting tired of karma fortunes by now.Gregg Bell ought to be getting tired of karma fortunes by now.Gregg Bell ought to be getting tired of karma fortunes by now.Gregg Bell ought to be getting tired of karma fortunes by now.Gregg Bell ought to be getting tired of karma fortunes by now.Gregg Bell ought to be getting tired of karma fortunes by now.Gregg Bell ought to be getting tired of karma fortunes by now.Gregg Bell ought to be getting tired of karma fortunes by now.Gregg Bell ought to be getting tired of karma fortunes by now.
 
Gregg Bell's Avatar
 
Posts: 2,148
Karma: 3741360
Join Date: Jan 2013
Location: Itasca, Illinois
Device: Kindle Touch 7, Sony PRS300, Fire HD8 Tablet
problem with error RSC-005

I took a short Word .doc, turned it into an .odt in LO then turned that into an .html and opened that in Sigil. When I ran the Epub check I got this:



I couldln't figure out what it wanted. Thanks.
Gregg Bell is offline   Reply With Quote
Old 01-13-2019, 12:28 AM   #2
theducks
Well trained by Cats
theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.
 
theducks's Avatar
 
Posts: 22,636
Karma: 22515576
Join Date: Aug 2009
Location: (The original) Silicon Valley, USA
Device: K4NT, Galaxy Tab A, Kobo Aura2
Quote:
Originally Posted by Gregg Bell View Post
I took a short Word .doc, turned it into an .odt in LO then turned that into an .html and opened that in Sigil. When I ran the Epub check I got this:



I couldln't figure out what it wanted. Thanks.
I don't think you can have a naked guide section.
Set the starting semantics (semantics fills in the guide entries) or remove the unused tags
theducks is offline   Reply With Quote
Advert
Old 01-13-2019, 12:37 AM   #3
DNSB
Bibliophagist
DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.
 
DNSB's Avatar
 
Posts: 5,464
Karma: 25244745
Join Date: Jul 2010
Location: Vancouver
Device: Kobo Aura One, Aura H2O, Aura HD, Nexus 7 HD, iPad Air, Tolino epos
Quote:
Originally Posted by Gregg Bell View Post
I took a short Word .doc, turned it into an .odt in LO then turned that into an .html and opened that in Sigil. When I ran the Epub check I got this:
<image deleted for repetition>
I couldn't figure out what it wanted. Thanks.
It wants reference items between the <guide> and </guide>. They may be useful if you are uploading to Kindlegen where you can define the cover, TOC and start of reading location. Most epub reading systems disregard them.

Sample from content.opf in a book I was recently editing:
Code:
  <guide>
    <reference type="toc" title="Table of Contents" href="Text/part0001.xhtml"/>
    <reference type="text" title="Beginning" href="Text/part0004.xhtml"/>
    <reference type="cover" title="Cover" href="Text/titlepage.xhtml"/>
  </guide>
Personally, the few times that error has come up, I've simply copied/pasted the above lines and then edited the hrefs. It's easier for me than right-clicking on multiple files and adding the appropriate semantic.

Edit: If you are feeling really bored, here's the link to the Epub 2.0.1 spec item: Section 2.6: Guide

Last edited by DNSB; 01-13-2019 at 03:52 PM. Reason: Added link to EPUB 2.0.1 Guide entry
DNSB is offline   Reply With Quote
Old 01-13-2019, 10:07 AM   #4
DiapDealer
Grand Sorcerer
DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.
 
DiapDealer's Avatar
 
Posts: 19,647
Karma: 100081276
Join Date: Jan 2010
Device: Nexus 7, Kindle Fire HD
That error is actually pretty new. Whatever version of EpubCheck came with the previous version of Doitsu's plugin didn't flag the empty guide element as an error in epub2. It's a little odd that it does flag it as an error given the wording of the spec:

Quote:
Within the package there may be one guide element, containing one or more reference elements.

Reading Systems are not required to use the guide element in any way.
It's (the guide element) deprecated (and completely optional) in epub3.

EpubCheck doesn't bark at all if the guide element is left out entirely, but of course Sigil adds it back in during its parsing. I wonder what changed to make them start flagging empty guides in epub2? That basically renders Sigil's default blank epub2 as invalid right out of the gate.

Last edited by DiapDealer; 01-13-2019 at 04:29 PM.
DiapDealer is offline   Reply With Quote
Old 01-13-2019, 03:51 PM   #5
DNSB
Bibliophagist
DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.
 
DNSB's Avatar
 
Posts: 5,464
Karma: 25244745
Join Date: Jul 2010
Location: Vancouver
Device: Kobo Aura One, Aura H2O, Aura HD, Nexus 7 HD, iPad Air, Tolino epos
Quote:
Originally Posted by DiapDealer View Post
That error is actually pretty new. Whatever version of EpubCheck came with the previous version of Doitsu's plugin didn't flag the empty guide element as an error in epub2. It's a little odd that it does flag it as error given the wording of the spec:
Quote:
Within the package there may be one guide element, containing one or more reference elements.
Emphasis added.
From how I read the spec, no guide element is fine. If you have a guide element, it must have at least one reference element. The only three references I worry about are the ones mentioned as being used by Amazon and then only for books that will be uploaded to Amazon.
DNSB is offline   Reply With Quote
Advert
Old 01-13-2019, 04:38 PM   #6
DiapDealer
Grand Sorcerer
DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.DiapDealer ought to be getting tired of karma fortunes by now.
 
DiapDealer's Avatar
 
Posts: 19,647
Karma: 100081276
Join Date: Jan 2010
Device: Nexus 7, Kindle Fire HD
I understand why they may not want an empty guide section, I just don't understand why now (the end of Nov 2018). It wasn't an error until EpubCheck 4.1. The wording of the 2.01 spec hasn't changed, so why, suddenly, has their interpretation of it? Sigil's created tons of epubs with empty guide items that all passed EpubCheck cleanly up until nearly the end of 2018. It doesn't make sense a lot of sense to me. But then, it clearly doesn't have to.
DiapDealer is offline   Reply With Quote
Old 01-13-2019, 06:01 PM   #7
KevinH
Wizard
KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.
 
Posts: 3,173
Karma: 1957622
Join Date: Nov 2009
Device: many
This was only an error under epub3. Code was addd to OPFParser.cpp to skip xml generation of an empty guide but only for epub3. So something changed the epub2 interpretation un epubcheck.

See src/ResourceObjects/OPFParser.cpp
Code:
if ((m_guide.size() > 0) || (m_package.m_version.startsWith("2"))) {
    xmlres << "  <guide>\n";
    foreach(GuideEntry ge, m_guide) {
      xmlres << ge.convert_to_xml();
    }
    xmlres << "  </guide>\n";
  }
So we could remove the check above for epub2 that allows empty guide items.
That said, epubcheck should not be changing how it checks epub2 after the fact unless it is a bug (and it was not under epub2).
KevinH is online now   Reply With Quote
Old 01-13-2019, 06:49 PM   #8
Gregg Bell
Gregg Bell
Gregg Bell ought to be getting tired of karma fortunes by now.Gregg Bell ought to be getting tired of karma fortunes by now.Gregg Bell ought to be getting tired of karma fortunes by now.Gregg Bell ought to be getting tired of karma fortunes by now.Gregg Bell ought to be getting tired of karma fortunes by now.Gregg Bell ought to be getting tired of karma fortunes by now.Gregg Bell ought to be getting tired of karma fortunes by now.Gregg Bell ought to be getting tired of karma fortunes by now.Gregg Bell ought to be getting tired of karma fortunes by now.Gregg Bell ought to be getting tired of karma fortunes by now.Gregg Bell ought to be getting tired of karma fortunes by now.
 
Gregg Bell's Avatar
 
Posts: 2,148
Karma: 3741360
Join Date: Jan 2013
Location: Itasca, Illinois
Device: Kindle Touch 7, Sony PRS300, Fire HD8 Tablet
Thanks a lot guys. I deleted the guide tags but when I saved it they came back. So I added a Copyright Page and a Title Page and saved and then I had that stuff in the guide tags and Epub Check was happy. (And so was I. )
Gregg Bell is offline   Reply With Quote
Old 01-14-2019, 02:15 PM   #9
KevinH
Wizard
KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.
 
Posts: 3,173
Karma: 1957622
Join Date: Nov 2009
Device: many
BTW, this change to epubcheck was made because of this bug report:

https://github.com/w3c/epubcheck/issues/663

So we will need to remove empty guide elements for epub2 as well. This will probably impact plugin code that generates the opf on the fly as well.

I will look into making those fixes in time for our next release.

KevinH
KevinH is online now   Reply With Quote
Old 01-14-2019, 02:47 PM   #10
KevinH
Wizard
KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.
 
Posts: 3,173
Karma: 1957622
Join Date: Nov 2009
Device: many
FWIW, I just pushed fixes for this to remove empty guide elements for epub2 (already happened under epub3) so that Sigil generates empty epubs that will pass epubcheck 4..

So this should be fixed in master.
KevinH is online now   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
strange SVG error/positioning problem psychovertical ePub 2 10-11-2018 11:59 AM
Young Adult Belka, W.: 005 - Kapitän Merling und seine Familie. V1.1 [German] 03.12.2017 Zentaurus ePub Books 0 12-03-2017 05:47 PM
ERROR:Problem starting the wireless device mariaclaudia Devices 15 10-27-2017 09:15 AM
Help - Error - Re-installation question/problem Tej Devices 4 06-03-2017 04:37 AM
PRS-T1 File to Unroot T1 1.0.005? Rizla Sony Reader Dev Corner 0 06-27-2014 03:31 PM


All times are GMT -4. The time now is 11:40 PM.


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