<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">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">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">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">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">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">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">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">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">https://calibre-ebook.com/</a><br>
> > > > and,<br>
> > > > Sigil <a href="https://sigil-ebook.com/sigil" rel="noreferrer noreferrer" target="_blank">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">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">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>