TOC scope error when using Kindlegen

[nathanpinard]

Current, I'm trying to fix an error that continues to pop up on various EPUBs that come back from conversion.

This error is as follows:

Error(prcgen):E24011: TOC section scope is not included in the parent chapter:Title Page Error(prcgen)

This is the current NCX code:

<navMap>

<navPoint id="1" playOrder="1">
<navLabel><text>Copyright</text></navLabel>
<content src="Text/copy.xhtml"/>
</navPoint>

<navPoint id="2" playOrder="2">
<navLabel><text>Book #1: "VIRTUE"</text></navLabel>
<content src="Text/book01.xhtml"/>


<navPoint id="3" playOrder="3">
<navLabel><text>INDEX</text></navLabel>
<content src="Text/toc.xhtml"/>
</navPoint>

<navPoint id="4" playOrder="4">
<navLabel><text>Cover: WATERCOLOR: Big Fish in Sky w/Crab</text></navLabel>
<content src="Text/cover.xhtml"/>
</navPoint>

<navPoint id="5" playOrder="5">
<navLabel><text>Title Page</text></navLabel>
<content src="Text/title.xhtml"/>
</navPoint>

<navPoint id="6" playOrder="6">
<navLabel><text>Index</text></navLabel>
<content src="Text/toc.xhtml#IN01"/>
</navPoint>
<navPoint id="7" playOrder="7">
<navLabel><text>Virtue</text></navLabel>
<content src="Text/chap01.xhtml"/>
</navPoint>
<navPoint id="8" playOrder="8">
<navLabel><text>Consciousness Unending, IV</text></navLabel>
<content src="Text/chap02.xhtml"/>
</navPoint>
<navPoint id="9" playOrder="9">
<navLabel><text>Life's About You....</text></navLabel>
<content src="Text/chap03.xhtml"/>
</navPoint>
<navPoint id="10" playOrder="10">
<navLabel><text>We Grow the Fruit....</text></navLabel>
<content src="Text/chap04.xhtml"/>
</navPoint>
<navPoint id="11" playOrder="11">
<navLabel><text>In This Valley</text></navLabel>
<content src="Text/chap05.xhtml"/>
</navPoint>
<navPoint id="12" playOrder="12">
<navLabel><text>WATERCOLOR: Sanctuary, Kanaha Beach Park,</text></navLabel>
<content src="Text/chap06.xhtml"/>
</navPoint>
<navPoint id="13" playOrder="13">
<navLabel><text>Kahului, Maui, Hawaii 1998</text></navLabel>
<content src="Text/chap06.xhtml#IN04"/>
</navPoint>
<navPoint id="14" playOrder="14">
<navLabel><text>How Did They Deceive Me?</text></navLabel>
<content src="Text/chap07.xhtml"/>
</navPoint>
<navPoint id="15" playOrder="15">
<navLabel><text>Disenchanted</text></navLabel>
<content src="Text/chap08.xhtml"/>
</navPoint>
<navPoint id="16" playOrder="16">
<navLabel><text>The Deafening</text></navLabel>
<content src="Text/chap09.xhtml"/>
</navPoint>
<navPoint id="17" playOrder="17">
<navLabel><text>God Sees.....</text></navLabel>
<content src="Text/chap10.xhtml"/>
</navPoint>
</navPoint>

<navPoint id="18" playOrder="18">
<navLabel><text>Book # 2: THE UNBELOVED c 1999 yfr</text></navLabel>
<content src="Text/book02.xhtml"/>
<navPoint id="19" playOrder="19">
<navLabel><text>Title Page</text></navLabel>
<content src="Text/book02.xhtml#IN02"/>
</navPoint>
<navPoint id="20" playOrder="20">
<navLabel><text>Index</text></navLabel>
<content src="Text/toc01.xhtml"/>
</navPoint>
<navPoint id="21" playOrder="21">
<navLabel><text>The Unbeloved *</text></navLabel>
<content src="Text/chapp01.xhtml"/>
</navPoint>
<navPoint id="22" playOrder="22">
<navLabel><text>What Does It Mean?</text></navLabel>
<content src="Text/chapp02.xhtml"/>
</navPoint>
<navPoint id="23" playOrder="23">
<navLabel><text>What Happened Here?</text></navLabel>
<content src="Text/chapp03.xhtml"/>
</navPoint>
<navPoint id="24" playOrder="24">
<navLabel><text>WATERCOLOR: Hidden Refuge , Paia, Maui, Hawaii 1998</text></navLabel>
<content src="Text/chapp04.xhtml"/>
</navPoint>
<navPoint id="25" playOrder="25">
<navLabel><text>Listen Up! (a rap poem)</text></navLabel>
<content src="Text/chapp05.xhtml"/>
</navPoint>
<navPoint id="26" playOrder="26">
<navLabel><text>Where Do I Go From Here?</text></navLabel>
<content src="Text/chapp06.xhtml"/>
</navPoint>
<navPoint id="27" playOrder="27">
<navLabel><text>Someone For Me</text></navLabel>
<content src="Text/chapp07.xhtml"/>
</navPoint>
<navPoint id="28" playOrder="28">
<navLabel><text>What Kind of World Is This?!</text></navLabel>
<content src="Text/chapp08.xhtml"/>
</navPoint>
<navPoint id="29" playOrder="29">
<navLabel><text>Will the Universe...?</text></navLabel>
<content src="Text/chapp09.xhtml"/>
</navPoint>
<navPoint id="30" playOrder="30">
<navLabel><text>How Foolishly I Thought</text></navLabel>
<content src="Text/chapp10.xhtml"/>
</navPoint>

</navPoint>

<navPoint id="31" playOrder="31">
<navLabel><text>Book #3: WE ONLY NEED c 2001 yfr</text></navLabel>
<content src="Text/book03.xhtml"/>

<navPoint id="32" playOrder="32">
<navLabel><text>WATERCOLOR: Black Cat of Westminster Alley , Venice Beach, L.A., Calif 1994</text></navLabel>
<content src="Text/fm1.xhtml"/>
</navPoint>
<navPoint id="33" playOrder="33">
<navLabel><text>Title Page</text></navLabel>
<content src="Text/book03.xhtml#IN03"/>
</navPoint>
<navPoint id="34" playOrder="34">
<navLabel><text>Index</text></navLabel>
<content src="Text/toc02.xhtml"/>
</navPoint>
<navPoint id="35" playOrder="35">
<navLabel><text>We Only Need.....</text></navLabel>
<content src="Text/chappp01.xhtml"/>
</navPoint>
<navPoint id="36" playOrder="36">
<navLabel><text>The Guardians</text></navLabel>
<content src="Text/chappp02.xhtml"/>
</navPoint>
<navPoint id="37" playOrder="37">
<navLabel><text>Conscience</text></navLabel>
<content src="Text/chappp03.xhtml"/>
</navPoint>

<navPoint id="38" playOrder="38">
<navLabel><text>WATERCOLOR: Venice Beach, L.A. Calif 1993</text></navLabel>
<content src="Text/chappp05.xhtml"/>
</navPoint>
<navPoint id="39" playOrder="39">
<navLabel><text>Promiced Land</text></navLabel>
<content src="Text/chappp06.xhtml"/>
</navPoint>
<navPoint id="40" playOrder="40">
<navLabel><text>Consicousness Unending, I, II, III</text></navLabel>
<content src="Text/chappp07.xhtml"/>
</navPoint>
<navPoint id="41" playOrder="41">
<navLabel><text>I Came Slowly Along the Trail</text></navLabel>
<content src="Text/chappp08.xhtml"/>
</navPoint>
<navPoint id="42" playOrder="42">
<navLabel><text>Our Self</text></navLabel>
<content src="Text/chappp09.xhtml"/>
</navPoint>
<navPoint id="43" playOrder="43">
<navLabel><text>Conscience Unending, V &amp; VI</text></navLabel>
<content src="Text/chappp10.xhtml"/>
</navPoint>
<navPoint id="44" playOrder="44">
<navLabel><text>Author's Biography</text></navLabel>
<content src="Text/aut.xhtml"/>
</navPoint>

</navPoint>


</navMap>

Does anyone see what the matter is?

[JSWolf]

Before you try to convert this epub using Kindlegen, run it through epubcheck to make sure it's valid code.

[nathanpinard]

It validates properly, except for the template fallback error bug that occurs in epubcheck 3.0.1. But nothing else.

This error is what is the bug: OEBPS/Text/cover.xhtml(9,105): non-standard stylesheet resource 'OEBPS/Misc/page-template.xpgt' of type 'application/vnd.adobe-page-template+xml'. A fallback must be specified.

Which is set in the epub: <item href="Misc/page-template.xpgt" id="page" media-type="application/vnd.adobe-page-template+xml" />

[Hitch]

Originally Posted by nathanpinard

It validates properly, except for the template fallback error bug that occurs in epubcheck 3.0.1. But nothing else.

This error is what is the bug: OEBPS/Text/cover.xhtml(9,105): non-standard stylesheet resource 'OEBPS/Misc/page-template.xpgt' of type 'application/vnd.adobe-page-template+xml'. A fallback must be specified.

Which is set in the epub: <item href="Misc/page-template.xpgt" id="page" media-type="application/vnd.adobe-page-template+xml" />

Well, for one thing, if you're using the ePUBcheck at IDPF, or iTunes, you can't use an xpgt, period. You haven't been able to for nearly a year. It's a bug in the last two "updates" and upgrades to ePUBcheck. The fallback doesn't work; ePUBcheck doesn't recognize it. Rip out your xpgt.

And WHY am I so up on this? Becuase a client of mine, TODAY, came in with 40 freaking ePUBs, that we've made for them, since 2009, and--as he waited all this time, before uploading to iTunes, wants them FIXED. 40 of them. For hells' sake.

Hitch

[nathanpinard]

iTunes will not detect that error actually. In fact all partners somewhat don't detect that error. (maybe some I'm not aware of)

I pulled the template for Adobe, and that didn't solve me error.

There is an addition error I didn't include on the Kindlegen log: ):W30001: An overlapping subsequent nav point found for the nav point: "INDEX" Error(prcgen):E24011: TOC section scope is not included in the parent chapter:Title Page

But I can't see what's wrong with the overlap.

[JSWolf]

Originally Posted by Hitch

Well, for one thing, if you're using the ePUBcheck at IDPF, or iTunes, you can't use an xpgt, period. You haven't been able to for nearly a year. It's a bug in the last two "updates" and upgrades to ePUBcheck. The fallback doesn't work; ePUBcheck doesn't recognize it. Rip out your xpgt.

And WHY am I so up on this? Becuase a client of mine, TODAY, came in with 40 freaking ePUBs, that we've made for them, since 2009, and--as he waited all this time, before uploading to iTunes, wants them FIXED. 40 of them. For hells' sake.

Hitch

If all you are doing is removing the XGPT files from these 40 ePub, it's so simple to do. Toss them into Calibre, install the Modify ePub plugin, select just to remove the xGPT file and let it run. Ypu'll end up with 40 XGPT free ePub without the rest of the ePub having been mucked with.

[Hitch]

Originally Posted by nathanpinard

iTunes will not detect that error actually. In fact all partners somewhat don't detect that error. (maybe some I'm not aware of)

I pulled the template for Adobe, and that didn't solve me error.

There is an addition error I didn't include on the Kindlegen log: ):W30001: An overlapping subsequent nav point found for the nav point: "INDEX" Error(prcgen):E24011: TOC section scope is not included in the parent chapter:Title Page

But I can't see what's wrong with the overlap.

If it were me, I'd literally print it out (if you don't have markup tools, by which I mean, colored swaths of color) and match up the navpoints. I looked at this several times, and while I can't put my finger on it, I feel like you are either missing a navpoint or have one too many (closing). I could be completely wrong, and I haven't taken the time to sit down with it, but something, somewhere, feels off in the nesting. Something around the rapid part-1/toc/cover/ area.

FWIW.

@Wolfie: I may yet love you.

Hitch

[nathanpinard]

To make sure the warning itself wasn't causing this issue, I renamed all the TOC entries to be unique.

Still the TOC scope error appears.

I also removed the anchors just to see if that did anything, but that didn't work either.

I'm unable to find anything that validates this as well.

[Hitch]

Sorry, stupid question:

What do you mean when you say:

Originally Posted by nathanpinard

I'm unable to find anything that validates this as well.

Validates what? The NCX, the ePUB, or...?

Hitch

[nathanpinard]

I meant the NCX in terms of nesting. If there was any kind of tool to validate to see if there is some extra, or missing code.

[Doitsu]

Originally Posted by nathanpinard

I meant the NCX in terms of nesting. If there was any kind of tool to validate to see if there is some extra, or missing code.

If you have a Windows or Linux machine, you could check the NCX for well-formedness with XML Copy Editor (freeware).

Simply create a blank XML/XHTML document with XML Copy Editor, paste the contents of the NCX file into it and press F2 to check the NCX file for well-formedness.

[nathanpinard]

Originally Posted by Doitsu

If you have a Windows or Linux machine, you could check the NCX for well-formedness with XML Copy Editor (freeware).

Simply create a blank XML/XHTML document with XML Copy Editor, paste the contents of the NCX file into it and press F2 to check the NCX file for well-formedness.

According to that app, the document is well-formed.

So now...I'm stumped.

[odedta]

Doesn't Calibre's "Check Book" function give you an error?

[nathanpinard]

Originally Posted by odedta

Doesn't Calibre's "Check Book" function give you an error?

No problems found in the Book Check option for Calibre.

[Hitch]

Originally Posted by nathanpinard

No problems found in the Book Check option for Calibre.

Well, then...

And I hate to say this, but what you have to do now is work your way OUT. That's what we do here--bracket navigation for errors like this.

You need to start with the innermost ncx elements (yes--I understand you have three nested sections, this is a boxed-set, right? Or something spiritually akin?), and work outwards, building each one. Start with, say, what appears to be book 1--start with play orders 6-7, build that, and see if it validates (obviously, it will, but skipping steps = bad). Then add play order 5. See if you get the error when you add 5 (I think you might). If you don't, add 4, repeat, then 3. By the time you have added 3, I think you'll have replicated the error. It's a long, tedious process, but I don't see another way around it.

I suspect that the glitch is either in 3 + 5, or 5 + 6. Something about this is ringing a very, very distant bell, from back in the MOBIPOCKET days, in building PRC's, but I can't quite pull it from the recesses of my brain. (Sorry about that, but it had to be at least 4 years ago, which is 3 millennium in eBook terms, obviously.)

Also--can you post your GUIDE, in toto, please? Is there any chance you inadvertently duplicated Guide elements, like text or toc?

That's my best advice, and it's what we would do, here. FWIW.

Hitch