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

[Mick Sulley]

My mistake, it has worked, just took 20 minutes to do it.

Mick

On 09/04/2023 10:46, Mick Sulley wrote:
>
> 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/d226c5ef/attachment.htm>