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

[Mick Sulley]

Running Calibre 6.15.1 on Linux Mint 21

I just downloaded it to my PC and can view it in Calibre but cannot load 
it into my Kindle PaperWhite.  It looks OK but never finishes.

Any ideas?

Thanks

Mick

On 08/04/2023 08:57, kaizu bg wrote:
> 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/20230409/95c65cff/attachment-0001.htm>