Is digiKam's ePub offline documentation missing its functional TOC?

[Gilles Caulier]

Note : I check the KDenlive EPub documentation which is generated
exactly as digiKam (digiKam doc is based on the same infrastructure
than KDenlive), and problem is the same...

Gilles Caulier

Le ven. 7 avr. 2023 à 16:36, Gilles Caulier <caulier.gilles at gmail.com> a écrit :
>
> Hi Paul,
>
> You are right thatTOC from Epub is empty. Convertir to PDF will not
> fix it. It must certainly miss something is the rules to export from
> Sphinx/RestructuredText to EPUB.
>
> Gilles Caulier
>
> Le ven. 7 avr. 2023 à 09:28, Paul Norman <paul at paulanorman.info> a écrit :
> >
> > P.S.
> >
> > Using Calibre, I have run the following and made a .pdf and a new ePub respectively ...
> >
> > 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
> >
> > 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
> >
> > But I'm not sure if the auto generated TOCs are as intended by the authors.
> >
> > Paul
> >
> > On 7/04/2023 2:21 pm, Paul Norman wrote:
> >
> > Hi,
> >
> > I have downloaded https://docs.digikam.org/en/epub/DigikamManual.epub
> >
> > ... and opened it in both
> >
> > Calibre  https://calibre-ebook.com/
> > and,
> > Sigil https://sigil-ebook.com/sigil
> >
> > And unlike the well formatted “digiKam Recipies” (which I have purchased),
> > the digiKam Manual only displays one item in the Table of Contents in Calibre,
> > 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.
> >
> > “digiKam Recipies” shows a beautifully set out TOC in both Calibre and Sigil.
> >
> > Is there another recommended ePub reader that I should be using to read the “Digikam Manual.epub” in,
> > or is possibly something wrong with the ePub's formatting and setup?
> >
> > As,  https://www.digikam.org/documentation/  says:
> >
> > "The digiKam documentation can be read online here or downloaded in EPUB format here."
> >
> > ... I guess I expected the ePub to follow the general pattern of the online manual ...
> >
> > https://docs.digikam.org/en/index.html
> >
> > Any help or pointers greatly appreciated please,
> > as sometimes we need to use the offline ePub “digiKam Manual” help..
> >
> > TIA,
> >
> > Paul
> >
> >
> >