Repository location of English documentation files

[Oliver Kellogg]

> In the Kate's repo
>
> https://invent.kde.org/utilities/kate/-/tree/master/doc?ref_type=heads

Ah! I don't know how I overlooked that, thanks.
At any rate, I find the following bullet from *POT and PO Files Used for
Documentation* confusing:

For the package "EXAMPLE" you will find
[...]
- the translated documentation (in DocBook format) in the directory
l10n-kf5/*$LANGUAGE*/docs/*EXAMPLE*/

It is not true that the translated documentation (in DocBook format) can be
found in the directory
    l10n-kf5/*$LANGUAGE*/docs/*EXAMPLE*/
(there is no such directory).

Cheers

Oliver


On Sun, Oct 29, 2023 at 1:32 PM Yuri Chornoivan <yurchor at ukr.net> wrote:

> неділя, 29 жовтня 2023 р. 14:07:01 EET Oliver Kellogg написано:
> > Hi Yuri,
> >
> > That's also good to know :)
> > However, I was looking for the repo location for the DocBook files of all
> > the KDE apps.
>
> There is no such thing (and never has been afaik). They are extracted by
> update_xml.sh from the git repos when needed.
>
> > Giving more context from *POT and PO Files Used for Documentation* :
> >
> > You can find the English DocBook documentation in subdirectories of the
> > source code for the corresponding package. The POT files and the
> translated
> > PO files and DocBook files for all languages are located in the KDE
> package
> > named *kde-l10n*. For the package "EXAMPLE" you will find
> >
> >    -
> >
> >    the POT files in the directory
> l10n-kf5/templates/docmessages/*EXAMPLE*/
> >    -
> >
> >    the translated PO files in the directory l10n-kdf5/*$LANGUAGE*
> >    /docmessages/*EXAMPLE*/
> >    -
> >
> >    the *English documentation* files in the directory
> >    l10n-kf5/documentation/*EXAMPLE* (you need this file to generate the
> >    translated DocBook file)
> >    -
> >
> >    the translated documentation (in DocBook format) in the directory
> >    l10n-kf5/*$LANGUAGE*/docs/*EXAMPLE*/
> >
> >
> > Taking Kate as an example, for the POT files I see
> > svn+ssh://
> svn at svn.kde.org/home/kde/trunk/l10n-kf6/templates/docmessages/kate
> > and now my question is, where are the Kate DocBook files.
>
> In the Kate's repo
>
> https://invent.kde.org/utilities/kate/-/tree/master/doc?ref_type=heads
>
> Best regards,
> Yuri
>
> >
> > Greetings
> >
> > Oliver
> >
> > On Sun, Oct 29, 2023 at 11:24 AM Yuri Chornoivan <yurchor at ukr.net>
> wrote:
> > > неділя, 29 жовтня 2023 р. 12:09:15 EET Oliver Kellogg написано:
> > > > Hello kde-doc-english,
> > > >
> > > > https://l10n.kde.org/docs/translation-howto/doc-files.html contains:
> > > >    - the *English documentation* files in the directory
> > > >    l10n-kf5/documentation/*EXAMPLE* (you need this file to generate
> the
> > > >    translated DocBook file)
> > > >
> > > > However, looking at https://websvn.kde.org/trunk/l10n-kf5/ there is
> no
> > > > subdirectory documentation.
> > > >
> > > > Could you please clarify where is the origin of the DocBook files in
> the
> > > > repository?
> > > >
> > > > Many thanks,
> > > >
> > > > Oliver
> > > >
> > > > https://eo.l10n.kde.org/teamo.php
> > >
> > > Hi,
> > >
> > > It is here:
> > >
> > > https://websvn.kde.org/trunk/www/areas/l10n/docs/translation-howto/
> > >
> > > Hope this helps.
> > >
> > > Best regards,
> > > Yuri
>
>
>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.kde.org/pipermail/kde-doc-english/attachments/20231029/508dab51/attachment.htm>