Repository location of English documentation files

[Yuri Chornoivan]

неділя, 29 жовтня 2023 р. 16:29:45 EET 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).

Just because the above-mentioned instructions were not followed.

Once the update_xml.sh script has been executed you will have this directory.

Best regards,
Yuri

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