Repository location of English documentation files

[Oliver Kellogg]

Thanks for your help, Yuri.

I was now successful running update_xml, see
svn+ssh://svn@svn.kde.org/home/kde/trunk/l10n-kf6/eo/docs/kate

In order to do this I needed to define some additional entities for
Esperanto, see
https://invent.kde.org/frameworks/kdoctools/-/merge_requests/59

Regards,

Oliver



On Mon, Oct 30, 2023 at 9:27 AM Yuri Chornoivan <yurchor at ukr.net> wrote:

> неділя, 29 жовтня 2023 р. 16:50:43 EET Oliver Kellogg написано:
> > Correction:
> > The confusing bullet is the one before,
> > - the *English documentation* files in the directory
> l10n-kf5/documentation/
> > *EXAMPLE* (you need this file to generate the translated DocBook file)
> >
> > The directory l10n-kf5/documentation/  is the one that I cannot find.
>
> Again, it will be created after the first run of update_xml.
>
> Best regards,
> Yuri
>
> >
> > -Oliver
> >
> > On Sun, Oct 29, 2023 at 3:29 PM Oliver Kellogg <olivermkellogg at gmail.com
> >
> >
> > wrote:
> > > > 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/20231104/a101407a/attachment.htm>