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

[Paul A. Norman]

Awesome thank you Gilles,

A great many people will be benefited by that! :-)

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.

I look forward to downloading the corrected ePub later in the day!

Thank you,
Paul
---
https://PaulANorman.info


On 8 April 2023 9:02:02 am NZST, Gilles Caulier <caulier.gilles at gmail.com> wrote:
>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/394d0498/attachment.htm>