неділя, 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 <olivermkell...@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 <yurc...@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:// > >> > >> s...@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 <yurc...@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