Troubleshooting Guide: Sigil is a fantastic Open-Source program, but deciphering the errors can be a challenge. Even when using the pre-made e-book formatting templates in our eBook Formatting Kit, errors still happen.
VIDEO:
Click image for larger view
OPF Error Message:
“This resource is reachable but not present in the OPF <manifest>. “Reachable” means that a reference of come kind that points to this resource exists in the ebpub.”
A common problem is the name of the file is incorrect. In the figure above, the problem is the epub is looking for the headshot.jpg graphic in the “images” folder.
Note the images folder in the error is lowercase. In SIGIL the images folder is labeled with a cap “I” — Images.
Example HTML Code:
<div><img alt=”Erik G. Smith” height=”198″ src=”../images/headshot.jpg” title=”author” width=”150″ /></div>Error
The name of the folder reference in the link has to match EXACTLY!
../images/headshot.jpg
Correction
../Images/headshot.jpg
Corrected HTML Code:
<div><img alt=”Erik G. Smith” height=”198″ src=”../Images/headshot.jpg” title=”author” width=”150″ /></div>
Table of Contents
Click image for larger view
A very common error is when renaming your xhtml pages. Rule of thumb: keep them all lower case and no spaces or dashes.
Click image for larger view
Error
The named page (on left of screen) is Chapter2.xhtml, with a cap “C”.
The link in the toc is pointing to a page chapter2.xhtml, with a lowercase ‘c’.
The name of the page and the link reference have to match EXACTLY!
Correction
Rename your pages to match the link using a lowercase ‘c’ or redo your TOC links to match the page name, using a cap ‘C’.
Page: chapter2.xhtml, Link: <p><a href=”../Text/chapter2.xhtml“>Chapter 2</a></p>
OR
Page: Chapter2.xhtml, Link: <p><a href=”../Text/Chapter2.xhtml“>Chapter 2</a></p>
I got this error, but unfortunately the “file” is OEBPS/Text/ which is just the top container (and indeed the “line” is N/A). I did not mess with names, the only funny thing I did is to create a .xhtml with the chapter breaks already in (using
<hr class=”sigilChapterBreak” /&rt; ) and then split chapters within Sigil.
(no, actually I edited UUID in toc.ncx and content.opf: I copy-and-pasted it to be sure it is the same and added some metadata)
Any idea?
ciao, .mau.
.mau,
When you get an error like this but the page/location is N/A it could be that you are linking to a page that does not exist. If you manually edited the OPF, that may be the problem. Did you run the file through epubcheck? Epubcheck Online Validator: http://validator.idpf.org/
Sigil uses Flightcrew which is a different program. Very good, but Epubcheck may give more information as to the location of the error. The only way I could tell for sure is to see your file.
You do not need to manually edit your OPF file. Sigil automatically adds the pages, images, etc. I do not recommend even opening the OPF unless you are well versed in HTML/XML.
Feel free to send it to me at blog (at) unrulyguides.com. I’ll take a look.
Suzanne