Repository location of English documentation files

[Yuri Chornoivan]

неділя, 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