digiKam handbook migrated from DocBook to Sphinx/ReStructuredText

Gilles Caulier caulier.gilles at gmail.com
Fri Dec 30 23:18:04 GMT 2022


Hi,

Yes, these kinds of urls formatting will be restored. I currently do a
second pass in the rdt files to see if I forget links and I found some
missing entries.

Best

Gilles

Le sam. 31 déc. 2022 à 00:06, Freek de Kruijf <freekdekruijf at kde.nl> a écrit :
>
> Op donderdag 29 december 2022 08:51:47 CET schreef Gilles Caulier:
> > Hi all translation team,
> >
> > I'm glad to announce that the whole digiKam handbook based on DocBook
> > format is not fully migrated to the Sphinx/RestructuredText framework.
> > This will help to maintain the manual more easily in time, as
> > ReStructuredText is so far better in all forms than the DocBook
> > format, especially for huge documentation.
> >
> > The infrastructure is based on the KDenLive works (based too on the
> > Krita works). For the translations of this manual, it will be the same
> > workflow.
> >
> > Online manual is hosted in a dedicated web site available here :
> >
> > https://docs.digikam.org/en/index.html
> >
> > This means that older Docbook translations from the older manual are
> > now obsolete...
> >
> > Typically the obsolete POT files are there (docbook):
> >
> > https://websvn.kde.org/trunk/l10n-kf5/templates/docmessages/digikam-doc/
> >
> > The new POT files are there (ReStructuredText):
> >
> > https://websvn.kde.org/trunk/l10n-kf5/templates/messages/digikam-doc/
> >
> > The git repository for the new manual still the same than previous one :
> >
> > https://invent.kde.org/documentation/digikam-doc
> >
> > Look at the README file for details.
> >
> > Thanks to contribute and all the best for this new year
> >
> > Gilles Caulier
>
> When copying the translated text from docmessages into the digikam-doc
> environment I noticed that several time the original English text from
> docmessages did contain structures like "<ulink url="http://
> show.newscodes.org/index.html">this URL</ulink>", which appear in the text in
> digikam-doc as "this URL".
>
> Will these URL's reappear at a later time in the new text as:
> `this URL<http://show.newscodes.org/index.html>`_ ?
>
> I also found the structure, originally with a URL and now only "here". So here
> does not point to anything.
>
> --
>
> fr.gr.
>
> Freek de Kruijf
> vertaler/coördinator van KDE
>
>
>


More information about the kde-doc-english mailing list