<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  </head>
  <body>
    <p>P.S.</p>
    <p>Using Calibre, I have run the following and made a .pdf and a new
      ePub respectively ...</p>
    <p>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>
    </p>
    <p>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>
    </p>
    <p>But I'm not sure if the auto generated TOCs are as intended by
      the authors.</p>
    <p>Paul<br>
    </p>
    <div class="moz-cite-prefix">On 7/04/2023 2:21 pm, Paul Norman
      wrote:<br>
    </div>
    <blockquote type="cite"
      cite="mid:13e2ecc3-721a-e3c8-85fd-d3cb14e879dc@paulanorman.info">
      <meta http-equiv="content-type" content="text/html; charset=UTF-8">
      <p>Hi, <br>
      </p>
      <p>I have downloaded <a class="moz-txt-link-freetext"
          href="https://docs.digikam.org/en/epub/DigikamManual.epub"
          moz-do-not-send="true">https://docs.digikam.org/en/epub/DigikamManual.epub</a></p>
      <p>... and opened it in both <br>
      </p>
      <blockquote>
        <p>Calibre  <a class="moz-txt-link-freetext"
            href="https://calibre-ebook.com/" moz-do-not-send="true">https://calibre-ebook.com/</a><br>
          and,<br>
          Sigil <a class="moz-txt-link-freetext"
            href="https://sigil-ebook.com/sigil" moz-do-not-send="true">https://sigil-ebook.com/sigil</a></p>
      </blockquote>
      <p>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.</p>
      <p>“digiKam Recipies” shows a beautifully set out TOC in both
        Calibre and Sigil.</p>
      <p>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?</p>
      <p>As,  <a class="moz-txt-link-freetext"
          href="https://www.digikam.org/documentation/"
          moz-do-not-send="true">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 ...</p>
      <blockquote>
        <p><a class="moz-txt-link-freetext"
            href="https://docs.digikam.org/en/index.html"
            moz-do-not-send="true">https://docs.digikam.org/en/index.html</a></p>
      </blockquote>
      <p>Any help or pointers greatly appreciated please, <br>
        as sometimes we need to use the offline ePub “digiKam Manual”
        help..<br>
      </p>
      <p>TIA,</p>
      <p>Paul<br>
      </p>
      <p><br>
      </p>
      <p><br>
      </p>
    </blockquote>
  </body>
</html>