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

[kaizu bg]

Hi,

Thanks for the fix.

Have tested it with Calibre on Linux and with Moon+ on Android. In both
cases the TOC is visible correctly.

Regards, Kai

la 8. huhtik. 2023 klo 0.02 Gilles Caulier <caulier.gilles at gmail.com>
kirjoitti:

> EPUB TOC problem fixed : https://i.imgur.com/s17mfuk.png
>
> Gilles Caulier
>
> Le ven. 7 avr. 2023 à 16:52, Gilles Caulier <caulier.gilles at gmail.com> a
> écrit :
> >
> > I commit a checkout in git repository to build the TOC :
> >
> >
> https://invent.kde.org/documentation/digikam-doc/commit/433411caabf7b08b23ee47a6c76dd0f665f5ce2c
> >
> > The HTML and EPUB doc will re-build automatically and available in few
> > minutes. Please try again
> >
> > Gilles
> >
> > Le ven. 7 avr. 2023 à 16:41, Gilles Caulier <caulier.gilles at gmail.com>
> a écrit :
> > >
> > > 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
> > > > >
> > > > >
> > > > >
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.kde.org/pipermail/digikam-users/attachments/20230408/7618c349/attachment.htm>