Problem with not referenced files

[Leonatus]

I have produced a lot of epubs by now, in Sigil as well as in Calibre. But this time, I'm coming to my limits. When inserting images or fonts, I receive - in Sigil and in Calibre - those messages:

WARNUNG: Die Datei 3Sternchen.png ist nicht referenziert****[3Sternchen.png]
WARNUNG: Die Datei Exlibris_Bogen_2020.jpg ist nicht referenziert****[Exlibris_Bogen_2020.jpg]
WARNUNG: Die Datei FoglihtenNo04-070.otf ist nicht referenziert****[FoglihtenNo04-070.otf]
WARNUNG: Die Datei W3Ccss.png ist nicht referenziert****[W3Ccss.png]

But in the OPF, they are noticed:

<?xml version='1.0' encoding='utf-8'?>
<package xmlns="http://www.idpf.org/2007/opf" version="2.0" unique-identifier="uuid_id">
  <metadata xmlns:calibre="http://calibre.kovidgoyal.net/2009/metadata" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:dcterms="http://purl.org/dc/terms/" xmlns:opf="http://www.idpf.org/2007/opf" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <dc:title>Die Narrenburg</dc:title>
    <dc:creator opf:role="aut" opf:file-as="Stifter, Adalbert">Adalbert Stifter</dc:creator>
    <dc:date>2013-10-27T23:00:00+00:00</dc:date>
    <dc:contributor opf:role="bkp">calibre (1.8.0) [http://calibre-ebook.com]</dc:contributor>
    <dc:identifier id="uuid_id" opf:scheme="uuid">da7f9ece-e270-4413-a3b7-3376277e4231</dc:identifier>
    <dc:date opf:event="modification">2020-09-09</dc:date>
    <dc:description>&lt;div&gt;
&lt;p&gt;Rechtschreibung aktualisiert.&lt;/p&gt;&lt;/div&gt;</dc:description>
    <dc:language>de</dc:language>
    <dc:identifier opf:scheme="calibre">ba81fe0c-d397-4aa5-bf1a-7622295703f2</dc:identifier>
    <meta content="Narrenburg, Die" name="calibre:title_sort"/>
    <meta content="2013-10-28T17:33:58.150000+00:00" name="calibre:timestamp"/>
    <meta content="{&quot;Adalbert Stifter&quot;: &quot;&quot;}" name="calibre:author_link_map"/>
    <meta content="1.3.0" name="Sigil version"/>
    <meta name="cover" content="Cover.jpg"/>
    <meta name="calibre:user_metadata:#hyph" content="{&quot;is_csp&quot;: false, &quot;is_multiple2&quot;: {}, &quot;is_editable&quot;: true, &quot;is_multiple&quot;: null, &quot;search_terms&quot;: [&quot;#hyph&quot;], &quot;#value#&quot;: null, &quot;column&quot;: &quot;value&quot;, &quot;rec_index&quot;: 22, &quot;datatype&quot;: &quot;enumeration&quot;, &quot;#extra#&quot;: null, &quot;colnum&quot;: 1, &quot;name&quot;: &quot;Silbentrennung&quot;, &quot;kind&quot;: &quot;field&quot;, &quot;category_sort&quot;: &quot;value&quot;, &quot;is_custom&quot;: true, &quot;is_category&quot;: true, &quot;table&quot;: &quot;custom_column_1&quot;, &quot;link_column&quot;: &quot;value&quot;, &quot;label&quot;: &quot;hyph&quot;, &quot;display&quot;: {&quot;description&quot;: &quot;&quot;, &quot;use_decorations&quot;: 2, &quot;enum_values&quot;: [&quot;ja&quot;, &quot;nein&quot;], &quot;enum_colors&quot;: []}}"/>
    <meta name="calibre:user_metadata:#pages" content="{&quot;is_csp&quot;: false, &quot;is_multiple2&quot;: {}, &quot;is_editable&quot;: true, &quot;is_multiple&quot;: null, &quot;search_terms&quot;: [&quot;#pages&quot;], &quot;#value#&quot;: 126, &quot;column&quot;: &quot;value&quot;, &quot;rec_index&quot;: 23, &quot;datatype&quot;: &quot;int&quot;, &quot;#extra#&quot;: null, &quot;colnum&quot;: 3, &quot;name&quot;: &quot;Seiten&quot;, &quot;kind&quot;: &quot;field&quot;, &quot;category_sort&quot;: &quot;value&quot;, &quot;is_custom&quot;: true, &quot;is_category&quot;: false, &quot;table&quot;: &quot;custom_column_3&quot;, &quot;link_column&quot;: &quot;value&quot;, &quot;label&quot;: &quot;pages&quot;, &quot;display&quot;: {&quot;number_format&quot;: &quot;{0:,d}&quot;, &quot;description&quot;: &quot;&quot;}}"/>
  </metadata>
  <manifest>
    <item id="cover.xhtml" href="OEBPS/Text/cover.xhtml" media-type="application/xhtml+xml"/>
    <item id="Titel.xhtml" href="OEBPS/Text/Titel.xhtml" media-type="application/xhtml+xml"/>
    <item id="Impressum.xhtml" href="OEBPS/Text/Impressum.xhtml" media-type="application/xhtml+xml"/>
    <item id="Kapitel_1.xhtml" href="OEBPS/Text/Kapitel_1.xhtml" media-type="application/xhtml+xml"/>
    <item id="Kapitel_2.xhtml" href="OEBPS/Text/Kapitel_2.xhtml" media-type="application/xhtml+xml"/>
    <item id="Kapitel_3.xhtml" href="OEBPS/Text/Kapitel_3.xhtml" media-type="application/xhtml+xml"/>
    <item id="Section0001.xhtml" href="OEBPS/Text/Section0001.xhtml" media-type="application/xhtml+xml"/>
    <item id="Section0002.xhtml" href="OEBPS/Text/Section0002.xhtml" media-type="application/xhtml+xml"/>
    <item id="ncx" href="toc.ncx" media-type="application/x-dtbncx+xml"/>
    <item id="footnotecss" href="footnote.css" media-type="text/css"/>
    <item id="id1" href="kte-css/hyphenation.css" media-type="text/css"/>
    <item id="page_css" href="page_styles.css" media-type="text/css"/>
    <item id="css" href="stylesheet.css" media-type="text/css"/>
    <item id="Cover.jpg" href="Cover.jpg" media-type="image/jpeg"/>
    <item href="3Sternchen.png" id="id" media-type="image/png"/>
    <item href="W3Ccss.png" id="id2" media-type="image/png"/>
    <item href="Exlibris_Bogen_2020.jpg" id="id3" media-type="image/jpeg"/>
    <item href="FoglihtenNo04-070.otf" id="id4" media-type="application/vnd.ms-opentype"/>
  </manifest>
  <spine toc="ncx">
    <itemref idref="cover.xhtml"/>
    <itemref idref="Titel.xhtml"/>
    <itemref idref="Impressum.xhtml"/>
    <itemref idref="Kapitel_1.xhtml"/>
    <itemref idref="Kapitel_2.xhtml"/>
    <itemref idref="Kapitel_3.xhtml"/>
    <itemref idref="Section0001.xhtml"/>
    <itemref idref="Section0002.xhtml"/>
  </spine>
  <guide>
    <reference type="cover" title="Cover" href="OEBPS/Text/cover.xhtml"/>
  </guide>
</package>

I have no idea how to continue. Waht is wrong, please?
(My system is Windows 10, 64 bit, Sigil V. 1.3.0, Calibre V. 4.23)

[DiapDealer]

There's likely a folder hierarchy you're missing. For instance your xhtml files appear to be in the OEBPS/Text folder. Unless the files you inserted are truly in the same folder as the opf.xml file in the epub's zip archive, then that's why you would get the "not referenced" message. They're not manifested correctly.

How did you "insert" the files. It's best to use an inherent "Add Files" feature of Sigil/Calibre, so that all pathing will be automatically handled correctly.

[Leonatus]

Originally Posted by DiapDealer

It's best to use an inherent "Add Files" feature of Sigil/Calibre, so that all pathing will be automatically handled correctly.

Yes, that's what I'm worried about, for I tried in Sigil as well as in Calibre to insert the files in the "classical" ways, as f. e. in Sigil right-clicking on the "Images"-folder->"add existing files" and chosing them from my file system, or right-clicking on the "Fonts"-folder with the same procedure. What is strange to me is that in both platforms, Sigil and Calibre, there is the same result.

[KevinH]

In Sigil's BookBrowser hover over each of the images in question and note the full path of each (or use Sigil's Prefs to make the full path always show). Then check for case differences, folder differences, etc. Are they truly identical?

[KevinH]

Also, could we be misinterpreting those error messages? Could it just be saying no xhtml file (or css file) actually uses (links to) those files? Have you tried using Sigil to insert a link in to one of those images at the end of any of the xhtml files and then repeating the check to see if that resource error message goes away. What does Sigil's Report on Image links say about them?

[Leonatus]

Hm, getting always stranger: I clicked (in Sigil) "Tools"->"Convert to standard Sigil file", and the appearence looked all well, i. e. the assigned fonts appeared as well as the images. But when I clicked "Remove unused media files" those are suggested for removal. And when I run epubcheck, now the message is:

Col: 65: ERROR(RSC-007): Die referenzierte Datei "OEBPS/images/W3Ccss.png" wurde im EPUB nicht gefunden.

(as example, for it's the same with other images. The font, however, has been accepted).
Translation: The refernced file ... has not been found in the EPUB.

[KevinH]

That means your links to the images in your xhtml files do not match with where your images are being placed inside the epub.


Please try again without standardizing. Simply hover over each questionable image noting exactly their full path (or set Sigil's prefs to always show it). Then verify it in the opf is an *identical* match. Then search the xhtml files for that image and check that the link to the image is correct (Or use Sigil's Reports feature to do that).

For example if an image is in OEBPS/Text/ then an xhtml file colocated with it should NOT look like "../Images/blah.png"


Please report back what it tells you.

[Leonatus]

Originally Posted by KevinH

In Sigil's BookBrowser hover over each of the images in question and note the full path of each (or use Sigil's Prefs to make the full path always show). Then check for case differences, folder differences, etc. Are they truly identical?

As far as I can see, they are identical, for example

OEBPS/Images/3Sternchen.png

And the image shows in the book browser!
However, when I replace the ".." in the book browser by "OEBPS", the image vanishes.

[Leonatus]

Originally Posted by KevinH

Then verify it in the opf is an *identical* match. Then search the xhtml files for that image and check that the link to the image is correct (Or use Sigil's Reports feature to do that).

For example if an image is in OEBPS/Text/ then an xhtml file colocated with it should NOT look like "../Images/blah.png"


Please report back what it tells you.

It's truly identical:

<item id="x3Sternchen.png" href="Images/3Sternchen.png" media-type="image/png"/>
    <item id="W3Ccss.png" href="Images/W3Ccss.png" media-type="image/png"/>
    <item id="Exlibris_Bogen_2020.jpg" href="Images/Exlibris_Bogen_2020.jpg" media-type="image/jpeg"/>

In the "HTML-files"-section of the "Reports" feature, there appears the cover, but not the other images.
I just see:
In the "image files"-section appear all images, but the "3Sternche.png" only used once (? - in fact, it should be used 3 times), whereas the other images appear as "0 times used".

[KevinH]

That is completely different from the content.opf shown previously. There the href for your image is incorrect for the path you just showed. That makes it hard to say which is wrong and which is right. You appear to be mixing pre -standardized with post standardized info.

Standardization will move stuff all around, hiding the real issues.


Please post the exact opf manifest section for what you just reported.

Also where in the epub is the opf file found?

If it at the epub root? Or at OEBPS/ or someplace else?

[Leonatus]

In the "image files"-section appear all images, but the "3Sternche.png" only used once (? - in fact, it should be used 3 times), whereas the other images appear as "0 times used".

That has been my fault: In twop chapters the path has been "images" instead of "Images". And - oh wonder - after running epubcheck again, there's no error message any more!

Thank you for your assistance, however! Gratefully appreciated!

[KevinH]

You should never be adding the ../ to any link unless it really lies up one folder in the path or down from there.. Sigil will handle setting the path from the opf to the file correctly. Using insert Image will insert it into your xhtml so that the true path from that xhtml to your image is correctly determined. No editing of the link to the image need be done.

[KevinH]

Glad to hear you have figured it out.

[DiapDealer]

And the fonts not working can easily be explained by the paths in the css font-face declarations not matching their actual locations in the archive. Sigil will adjust css urls if they're changed (as long as they're initially correct), but adding font-files to the epub won't set up the initial css font-face rules. If you manually made the @font-face urls point to ../Fonts/xxxx.otf, but the actual font-files were added to the root of the archive (in a non-standard epub), that would explain why 1) your embedded fonts wouldn't render, and 2) why Epubcheck barked about them being unreferenced, and 3) why standardizing the epub structure suddenly made them work. The standardization moved the font files to where your initially incorrect css @font-face rules had indicated they were.

When manually adding urls to xhtml/css, you can no longer assume that font-files will be in a "../Fonts" folder and image-files will be in an "../Images" folder (or that xhtml files will be in "../Text"). They could be added anywhere in a non-standard epub.

You have to either take the time to figure out where your targets actually ARE in the epub archive before manually adding/editing urls to them in xhtml/css, or you need to get in the habit of always standardizing epubs before doing any editing, if you want things to be where they traditionally always have been in the past.

[Leonatus]

@DiapDealer: I fear I didn't really understand: How do I add a font correctly to a standard epub in Sigil? Until now, I used the "CssFromFont"-Plugin, and there (in the css) the @font-face urls always point to ../Fonts/xxxx.otf. Or, I made it manually, as you described. Then, it sometimes occurred that I had to remove the ".." and insert again in order to make the font show correctly.
This all I had tried in vain in this case. Why, on a sudden, Sigil accepted the font, I have no idea.

By the way: what is a "non-standard-epub" that one can handle in Sigil?