Re: EPUB toc for whole book?

[John MacFarlane <fiddlosopher-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>]

+++ niczero [Apr 28 12 03:21 ]:
>    Hi David,
>    I just joined this group for the very purpose of reporting that
>    internal links between chapters don't work
>    (in .epub).  I haven't yet homed-in on why, but any internal links in
>    one chapter
>    ("see [Chapter 2](#ch2)") just get left as they are, so my .epub
>    contains original fragments of md
>    where the links should be.  I tried moving the anchor away from the
>    heading, so the .md has
>    "
>    # Chapter 2
>    <a name="ch2">.</a>
>    "
>    but that didn't help.  I'm now busy hunting for a workaround because
>    each chapter is littered with
>    references to other chapters, there are 108 chapters, and having
>    hyperlinking working is a big
>    part of why I'm building the ebook.

Internal links between chapters do work in pandoc 1.9.2 -- but
maybe not in the way you expect. You need to create
the links using the implicit identifiers described in
<http://johnmacfarlane.net/pandoc/README.html#header-identifiers-in-html-latex-and-context>.

So, to link to

    # Chapter 2

what you want is

    See [Chapter 2](#chapter-2)

Try that.  The reason the raw HTML anchors don't work is that the
epub gets split over several different files.

>    By the way, all my chapter headings appear in the book's toc, but they
>    didn't originally.  In my
>    first draft some of my headings were non-unique.  When I fixed that,
>    the toc appeared.  Are you
>    getting anything at all?  Originally I had just two entries, the title
>    page and one 'chapter' for the
>    entire book.
>    When I say 'toc', I mean what I see when I click on 'contents' in the
>    calibre ebook reader; it
>    doesn't appear within the body of the book.

Here's how pandoc currently handles these things.  Your document is
divided into chapters by level-1 headers.  If you only have one
level-1 header, you'll only get one chapter.  Your epub reader will
have a master table of contents showing these chapters.  This is
independent of whether you use --toc on the command line.  If you
use --toc, you'll *also* get a table of contents for each chapter,
at the beginning of that chapter.

It may be possible to change things so that the master table of
contents shows all the sections and subsections; I can look into
that if people are interested.  (It would be helpful if someone
gave me an example of an epub that worked that way, so I can see
how it's done.)

John