Thanks for your help, Yuri. I was now successful running update_xml, see svn+ssh://[email protected]/home/kde/trunk/l10n-kf6/eo/docs/kate
In order to do this I needed to define some additional entities for Esperanto, see https://invent.kde.org/frameworks/kdoctools/-/merge_requests/59 Regards, Oliver On Mon, Oct 30, 2023 at 9:27 AM Yuri Chornoivan <[email protected]> wrote: > неділя, 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 <[email protected] > > > > > > 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 <[email protected]> > 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:// > > >> > > >> [email protected]/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 <[email protected]> > > >> > > >> 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 > > > > >
