=D0=BD=D0=B5=D0=B4=D1=96=D0=BB=D1=8F, 29 =D0=B6=D0=BE=D0=B2=D1=82=D0=BD=D1= =8F 2023 =D1=80. 16:50:43 EET Oliver Kellogg =D0=BD=D0=B0=D0=BF=D0=B8=D1=81= =D0=B0=D0=BD=D0=BE: > Correction: > The confusing bullet is the one before, > - the *English documentation* files in the directory l10n-kf5/documentati= on/ > *EXAMPLE* (you need this file to generate the translated DocBook file) >=20 > 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 >=20 > -Oliver >=20 > On Sun, Oct 29, 2023 at 3:29=E2=80=AFPM Oliver Kellogg >=20 > wrote: > > > In the Kate's repo > > >=20 > > > https://invent.kde.org/utilities/kate/-/tree/master/doc?ref_type=3Dhe= ads > >=20 > > 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: > >=20 > > For the package "EXAMPLE" you will find > > [...] > > - the translated documentation (in DocBook format) in the directory > > l10n-kf5/*$LANGUAGE*/docs/*EXAMPLE*/ > >=20 > > It is not true that the translated documentation (in DocBook format) can > > be found in the directory > >=20 > > l10n-kf5/*$LANGUAGE*/docs/*EXAMPLE*/ > >=20 > > (there is no such directory). > >=20 > > Cheers > >=20 > > Oliver > >=20 > > On Sun, Oct 29, 2023 at 1:32=E2=80=AFPM Yuri Chornoivan wrote: > >> =D0=BD=D0=B5=D0=B4=D1=96=D0=BB=D1=8F, 29 =D0=B6=D0=BE=D0=B2=D1=82=D0= =BD=D1=8F 2023 =D1=80. 14:07:01 EET Oliver Kellogg =D0=BD=D0=B0=D0=BF=D0=B8= =D1=81=D0=B0=D0=BD=D0=BE: > >> > Hi Yuri, > >> >=20 > >> > That's also good to know :) > >> > However, I was looking for the repo location for the DocBook files of > >>=20 > >> all > >>=20 > >> > the KDE apps. > >>=20 > >> There is no such thing (and never has been afaik). They are extracted = by > >> update_xml.sh from the git repos when needed. > >>=20 > >> > Giving more context from *POT and PO Files Used for Documentation* : > >> >=20 > >> > You can find the English DocBook documentation in subdirectories of = the > >> > source code for the corresponding package. The POT files and the > >>=20 > >> translated > >>=20 > >> > PO files and DocBook files for all languages are located in the KDE > >>=20 > >> package > >>=20 > >> > named *kde-l10n*. For the package "EXAMPLE" you will find > >> >=20 > >> > - > >> > =20 > >> > the POT files in the directory > >>=20 > >> l10n-kf5/templates/docmessages/*EXAMPLE*/ > >>=20 > >> > - > >> > =20 > >> > the translated PO files in the directory l10n-kdf5/*$LANGUAGE* > >> > /docmessages/*EXAMPLE*/ > >> > - > >> > =20 > >> > the *English documentation* files in the directory > >> > l10n-kf5/documentation/*EXAMPLE* (you need this file to generate = the > >> > translated DocBook file) > >> > - > >> > =20 > >> > the translated documentation (in DocBook format) in the directory > >> > l10n-kf5/*$LANGUAGE*/docs/*EXAMPLE*/ > >> >=20 > >> > Taking Kate as an example, for the POT files I see > >> > svn+ssh:// > >>=20 > >> svn@svn.kde.org/home/kde/trunk/l10n-kf6/templates/docmessages/kate > >>=20 > >> > and now my question is, where are the Kate DocBook files. > >>=20 > >> In the Kate's repo > >>=20 > >> https://invent.kde.org/utilities/kate/-/tree/master/doc?ref_type=3Dhea= ds > >>=20 > >> Best regards, > >> Yuri > >>=20 > >> > Greetings > >> >=20 > >> > Oliver > >> >=20 > >> > On Sun, Oct 29, 2023 at 11:24=E2=80=AFAM Yuri Chornoivan > >>=20 > >> wrote: > >> > > =D0=BD=D0=B5=D0=B4=D1=96=D0=BB=D1=8F, 29 =D0=B6=D0=BE=D0=B2=D1=82= =D0=BD=D1=8F 2023 =D1=80. 12:09:15 EET Oliver Kellogg =D0=BD=D0=B0=D0=BF=D0= =B8=D1=81=D0=B0=D0=BD=D0=BE: > >> > > > Hello kde-doc-english, > >> > > >=20 > >> > > > https://l10n.kde.org/docs/translation-howto/doc-files.html > >>=20 > >> contains: > >> > > > - the *English documentation* files in the directory > >> > > > l10n-kf5/documentation/*EXAMPLE* (you need this file to gener= ate > >>=20 > >> the > >>=20 > >> > > > translated DocBook file) > >> > > >=20 > >> > > > However, looking at https://websvn.kde.org/trunk/l10n-kf5/ there > >>=20 > >> is no > >>=20 > >> > > > subdirectory documentation. > >> > > >=20 > >> > > > Could you please clarify where is the origin of the DocBook files > >>=20 > >> in the > >>=20 > >> > > > repository? > >> > > >=20 > >> > > > Many thanks, > >> > > >=20 > >> > > > Oliver > >> > > >=20 > >> > > > https://eo.l10n.kde.org/teamo.php > >> > >=20 > >> > > Hi, > >> > >=20 > >> > > It is here: > >> > >=20 > >> > > https://websvn.kde.org/trunk/www/areas/l10n/docs/translation-howto/ > >> > >=20 > >> > > Hope this helps. > >> > >=20 > >> > > Best regards, > >> > > Yuri