<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  </head>
  <body>
    <p>My mistake, it has worked, just took 20 minutes to do it.</p>
    <p>Mick<br>
    </p>
    <div class="moz-cite-prefix">On 09/04/2023 10:46, Mick Sulley wrote:<br>
    </div>
    <blockquote type="cite"
      cite="mid:c82057d3-1bda-8368-06ab-1dc2ea08f8d7@sulley.info">
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
      <p>Running Calibre 6.15.1 on Linux Mint 21<br>
      </p>
      <p>I just downloaded it to my PC and can view it in Calibre but
        cannot load it into my Kindle PaperWhite.  It looks OK but never
        finishes.</p>
      <p>Any ideas?</p>
      <p>Thanks</p>
      <p>Mick<br>
      </p>
      <div class="moz-cite-prefix">On 08/04/2023 08:57, kaizu bg wrote:<br>
      </div>
      <blockquote type="cite"
cite="mid:CANH9RBDNWg+DxNAz9ef6EU81oJ3XqYywL4XQJG8FMpa5LvzkVg@mail.gmail.com">
        <meta http-equiv="content-type" content="text/html;
          charset=UTF-8">
        <div dir="auto">Hi,
          <div dir="auto"><br>
          </div>
          <div dir="auto">Thanks for the fix. </div>
          <div dir="auto"><br>
          </div>
          <div dir="auto">Have tested it with Calibre on Linux and with
            Moon+ on Android. In both cases the TOC is visible
            correctly.</div>
          <div dir="auto"><br>
          </div>
          <div dir="auto">Regards, Kai</div>
        </div>
        <br>
        <div class="gmail_quote">
          <div dir="ltr" class="gmail_attr">la 8. huhtik. 2023 klo 0.02
            Gilles Caulier <<a href="mailto:caulier.gilles@gmail.com"
              moz-do-not-send="true" class="moz-txt-link-freetext">caulier.gilles@gmail.com</a>>
            kirjoitti:<br>
          </div>
          <blockquote class="gmail_quote" style="margin:0 0 0
            .8ex;border-left:1px #ccc solid;padding-left:1ex">EPUB TOC
            problem fixed : <a href="https://i.imgur.com/s17mfuk.png"
              rel="noreferrer noreferrer" target="_blank"
              moz-do-not-send="true" class="moz-txt-link-freetext">https://i.imgur.com/s17mfuk.png</a><br>
            <br>
            Gilles Caulier<br>
            <br>
            Le ven. 7 avr. 2023 à 16:52, Gilles Caulier <<a
              href="mailto:caulier.gilles@gmail.com" target="_blank"
              rel="noreferrer" moz-do-not-send="true"
              class="moz-txt-link-freetext">caulier.gilles@gmail.com</a>>
            a écrit :<br>
            ><br>
            > I commit a checkout in git repository to build the TOC
            :<br>
            ><br>
            > <a
href="https://invent.kde.org/documentation/digikam-doc/commit/433411caabf7b08b23ee47a6c76dd0f665f5ce2c"
              rel="noreferrer noreferrer" target="_blank"
              moz-do-not-send="true" class="moz-txt-link-freetext">https://invent.kde.org/documentation/digikam-doc/commit/433411caabf7b08b23ee47a6c76dd0f665f5ce2c</a><br>
            ><br>
            > The HTML and EPUB doc will re-build automatically and
            available in few<br>
            > minutes. Please try again<br>
            ><br>
            > Gilles<br>
            ><br>
            > Le ven. 7 avr. 2023 à 16:41, Gilles Caulier <<a
              href="mailto:caulier.gilles@gmail.com" target="_blank"
              rel="noreferrer" moz-do-not-send="true"
              class="moz-txt-link-freetext">caulier.gilles@gmail.com</a>>
            a écrit :<br>
            > ><br>
            > > Note : I check the KDenlive EPub documentation
            which is generated<br>
            > > exactly as digiKam (digiKam doc is based on the
            same infrastructure<br>
            > > than KDenlive), and problem is the same...<br>
            > ><br>
            > > Gilles Caulier<br>
            > ><br>
            > > Le ven. 7 avr. 2023 à 16:36, Gilles Caulier <<a
              href="mailto:caulier.gilles@gmail.com" target="_blank"
              rel="noreferrer" moz-do-not-send="true"
              class="moz-txt-link-freetext">caulier.gilles@gmail.com</a>>
            a écrit :<br>
            > > ><br>
            > > > Hi Paul,<br>
            > > ><br>
            > > > You are right thatTOC from Epub is empty.
            Convertir to PDF will not<br>
            > > > fix it. It must certainly miss something is
            the rules to export from<br>
            > > > Sphinx/RestructuredText to EPUB.<br>
            > > ><br>
            > > > Gilles Caulier<br>
            > > ><br>
            > > > Le ven. 7 avr. 2023 à 09:28, Paul Norman <<a
              href="mailto:paul@paulanorman.info" target="_blank"
              rel="noreferrer" moz-do-not-send="true"
              class="moz-txt-link-freetext">paul@paulanorman.info</a>>
            a écrit :<br>
            > > > ><br>
            > > > > P.S.<br>
            > > > ><br>
            > > > > Using Calibre, I have run the following
            and made a .pdf and a new ePub respectively ...<br>
            > > > ><br>
            > > > > ebook-convert DigikamManual.epub
            DigikamManual.pdf --paper-size=a4 --pdf-hyphenate
            --embed-all-fonts --pretty-print  --pdf-page-numbers
            --pdf-add-toc --smarten-punctuation --keep-ligatures
            --enable-heuristics  --use-auto-toc --duplicate-links-in-toc
            --level1-toc=//h:h1 --level2-toc=//h:h2 --level3-toc=//h:h3
            --max-toc-links=3000<br>
            > > > ><br>
            > > > > ebook-convert DigikamManual.epub
            new_DigikamManual.epub --epub-inline-toc --embed-all-fonts
            --pretty-print    --smarten-punctuation --keep-ligatures
            --enable-heuristics  --use-auto-toc --duplicate-links-in-toc
            --level1-toc=//h:h1 --level2-toc=//h:h2 --level3-toc=//h:h3 
            --max-toc-links=3000<br>
            > > > ><br>
            > > > > But I'm not sure if the auto generated
            TOCs are as intended by the authors.<br>
            > > > ><br>
            > > > > Paul<br>
            > > > ><br>
            > > > > On 7/04/2023 2:21 pm, Paul Norman wrote:<br>
            > > > ><br>
            > > > > Hi,<br>
            > > > ><br>
            > > > > I have downloaded <a
              href="https://docs.digikam.org/en/epub/DigikamManual.epub"
              rel="noreferrer noreferrer" target="_blank"
              moz-do-not-send="true" class="moz-txt-link-freetext">https://docs.digikam.org/en/epub/DigikamManual.epub</a><br>
            > > > ><br>
            > > > > ... and opened it in both<br>
            > > > ><br>
            > > > > Calibre  <a
              href="https://calibre-ebook.com/" rel="noreferrer
              noreferrer" target="_blank" moz-do-not-send="true"
              class="moz-txt-link-freetext">https://calibre-ebook.com/</a><br>
            > > > > and,<br>
            > > > > Sigil <a
              href="https://sigil-ebook.com/sigil" rel="noreferrer
              noreferrer" target="_blank" moz-do-not-send="true"
              class="moz-txt-link-freetext">https://sigil-ebook.com/sigil</a><br>
            > > > ><br>
            > > > > And unlike the well formatted “digiKam
            Recipies” (which I have purchased),<br>
            > > > > the digiKam Manual only displays one
            item in the Table of Contents in Calibre,<br>
            > > > > simply saying “digiKam Manual” — with no
            sub entries at all, and the rest, in the only shown page, is
            just too confusing to follow, or navigate around with if you
            start clicking anything.<br>
            > > > ><br>
            > > > > “digiKam Recipies” shows a beautifully
            set out TOC in both Calibre and Sigil.<br>
            > > > ><br>
            > > > > Is there another recommended ePub reader
            that I should be using to read the “Digikam Manual.epub” in,<br>
            > > > > or is possibly something wrong with the
            ePub's formatting and setup?<br>
            > > > ><br>
            > > > > As,  <a
              href="https://www.digikam.org/documentation/"
              rel="noreferrer noreferrer" target="_blank"
              moz-do-not-send="true" class="moz-txt-link-freetext">https://www.digikam.org/documentation/</a> 
            says:<br>
            > > > ><br>
            > > > > "The digiKam documentation can be read
            online here or downloaded in EPUB format here."<br>
            > > > ><br>
            > > > > ... I guess I expected the ePub to
            follow the general pattern of the online manual ...<br>
            > > > ><br>
            > > > > <a
              href="https://docs.digikam.org/en/index.html"
              rel="noreferrer noreferrer" target="_blank"
              moz-do-not-send="true" class="moz-txt-link-freetext">https://docs.digikam.org/en/index.html</a><br>
            > > > ><br>
            > > > > Any help or pointers greatly appreciated
            please,<br>
            > > > > as sometimes we need to use the offline
            ePub “digiKam Manual” help..<br>
            > > > ><br>
            > > > > TIA,<br>
            > > > ><br>
            > > > > Paul<br>
            > > > ><br>
            > > > ><br>
            > > > ><br>
          </blockquote>
        </div>
      </blockquote>
    </blockquote>
  </body>
</html>