Repository location of English documentation files

[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.

-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/20231029/d595f81e/attachment.htm>