<html><head></head><body>Awesome thank you Gilles,<br><br>A great many people will be benefited by that! :-)<br><br>The Calibre 'ebook-convert' command line sequences I had provided earlier, only successfully worked on heading levels (H1, H2, H3) and minor heuristics, and could be no where near as good as what you have managed to get done.<br><br>I look forward to downloading the corrected ePub later in the day!<br><br>Thank you,<br>Paul<hr><a href="https://PaulANorman.info">https://PaulANorman.info</a><br><br><br><div class="gmail_quote">On 8 April 2023 9:02:02 am NZST, Gilles Caulier <caulier.gilles@gmail.com> wrote:<blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
<pre class="k9mail">EPUB TOC problem fixed : <a href="https://i.imgur.com/s17mfuk.png">https://i.imgur.com/s17mfuk.png</a><br><br>Gilles Caulier<br><br>Le ven. 7 avr. 2023 à 16:52, Gilles Caulier <caulier.gilles@gmail.com> a écrit :<br><blockquote class="gmail_quote" style="margin: 0pt 0pt 1ex 0.8ex; border-left: 1px solid #729fcf; padding-left: 1ex;"><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">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 <caulier.gilles@gmail.com> a écrit :<br><blockquote class="gmail_quote" style="margin: 0pt 0pt 1ex 0.8ex; border-left: 1px solid #ad7fa8; padding-left: 1ex;"><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 <caulier.gilles@gmail.com> a écrit :<br><blockquote class="gmail_quote" style="margin: 0pt 0pt 1ex 0.8ex; border-left: 1px solid #8ae234; padding-left: 1ex;"><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 <paul@paulanorman.info> a écrit :<br><blockquote class="gmail_quote" style="margin: 0pt 0pt 1ex 0.8ex; border-left: 1px solid #fcaf3e; padding-left: 1ex;"><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">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/">https://calibre-ebook.com/</a><br> and,<br> Sigil <a href="https://sigil-ebook.com/sigil">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/">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">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></blockquote></blockquote></blockquote></pre></blockquote></div></body></html>