<div dir="ltr"><div>Thanks for your help, Yuri.</div><div><br></div><div>I was now successful running update_xml, see</div><div><span style="color:rgb(0,0,0);background-color:rgb(255,255,255);font-family:arial,sans-serif">svn+ssh://<a href="http://svn@svn.kde.org/home/kde/trunk/l10n-kf6/eo/docs/kate">svn@svn.kde.org/home/kde/trunk/l10n-kf6/eo/docs/kate</a></span><span style="font-family:arial,sans-serif"><br></span></div><div><span style="font-family:arial,sans-serif"><br></span></div><div><span style="font-family:arial,sans-serif">In order to do this I needed to define some additional entities for Esperanto, see</span></div><div><a href="https://invent.kde.org/frameworks/kdoctools/-/merge_requests/59">https://invent.kde.org/frameworks/kdoctools/-/merge_requests/59</a></div><br><div><span style="font-family:arial,sans-serif">Regards,</span></div><div><span style="font-family:arial,sans-serif"><br></span></div><div><span style="font-family:arial,sans-serif">Oliver</span></div><div><span style="font-family:arial,sans-serif"><br></span></div><div><br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Mon, Oct 30, 2023 at 9:27 AM Yuri Chornoivan <<a href="mailto:yurchor@ukr.net">yurchor@ukr.net</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">неділя, 29 жовтня 2023 р. 16:50:43 EET Oliver Kellogg написано:<br>
> Correction:<br>
> The confusing bullet is the one before,<br>
> - the *English documentation* files in the directory l10n-kf5/documentation/<br>
> *EXAMPLE* (you need this file to generate the translated DocBook file)<br>
> <br>
> The directory l10n-kf5/documentation/  is the one that I cannot find.<br>
<br>
Again, it will be created after the first run of update_xml.<br>
<br>
Best regards,<br>
Yuri<br>
<br>
> <br>
> -Oliver<br>
> <br>
> On Sun, Oct 29, 2023 at 3:29 PM Oliver Kellogg <<a href="mailto:olivermkellogg@gmail.com" target="_blank">olivermkellogg@gmail.com</a>><br>
> <br>
> wrote:<br>
> > > In the Kate's repo<br>
> > > <br>
> > > <a href="https://invent.kde.org/utilities/kate/-/tree/master/doc?ref_type=heads" rel="noreferrer" target="_blank">https://invent.kde.org/utilities/kate/-/tree/master/doc?ref_type=heads</a><br>
> > <br>
> > Ah! I don't know how I overlooked that, thanks.<br>
> > At any rate, I find the following bullet from *POT and PO Files Used for<br>
> > Documentation* confusing:<br>
> > <br>
> > For the package "EXAMPLE" you will find<br>
> > [...]<br>
> > - the translated documentation (in DocBook format) in the directory<br>
> > l10n-kf5/*$LANGUAGE*/docs/*EXAMPLE*/<br>
> > <br>
> > It is not true that the translated documentation (in DocBook format) can<br>
> > be found in the directory<br>
> > <br>
> >     l10n-kf5/*$LANGUAGE*/docs/*EXAMPLE*/<br>
> > <br>
> > (there is no such directory).<br>
> > <br>
> > Cheers<br>
> > <br>
> > Oliver<br>
> > <br>
> > On Sun, Oct 29, 2023 at 1:32 PM Yuri Chornoivan <<a href="mailto:yurchor@ukr.net" target="_blank">yurchor@ukr.net</a>> wrote:<br>
> >> неділя, 29 жовтня 2023 р. 14:07:01 EET Oliver Kellogg написано:<br>
> >> > Hi Yuri,<br>
> >> > <br>
> >> > That's also good to know :)<br>
> >> > However, I was looking for the repo location for the DocBook files of<br>
> >> <br>
> >> all<br>
> >> <br>
> >> > the KDE apps.<br>
> >> <br>
> >> There is no such thing (and never has been afaik). They are extracted by<br>
> >> update_xml.sh from the git repos when needed.<br>
> >> <br>
> >> > Giving more context from *POT and PO Files Used for Documentation* :<br>
> >> > <br>
> >> > You can find the English DocBook documentation in subdirectories of the<br>
> >> > source code for the corresponding package. The POT files and the<br>
> >> <br>
> >> translated<br>
> >> <br>
> >> > PO files and DocBook files for all languages are located in the KDE<br>
> >> <br>
> >> package<br>
> >> <br>
> >> > named *kde-l10n*. For the package "EXAMPLE" you will find<br>
> >> > <br>
> >> >    -<br>
> >> >    <br>
> >> >    the POT files in the directory<br>
> >> <br>
> >> l10n-kf5/templates/docmessages/*EXAMPLE*/<br>
> >> <br>
> >> >    -<br>
> >> >    <br>
> >> >    the translated PO files in the directory l10n-kdf5/*$LANGUAGE*<br>
> >> >    /docmessages/*EXAMPLE*/<br>
> >> >    -<br>
> >> >    <br>
> >> >    the *English documentation* files in the directory<br>
> >> >    l10n-kf5/documentation/*EXAMPLE* (you need this file to generate the<br>
> >> >    translated DocBook file)<br>
> >> >    -<br>
> >> >    <br>
> >> >    the translated documentation (in DocBook format) in the directory<br>
> >> >    l10n-kf5/*$LANGUAGE*/docs/*EXAMPLE*/<br>
> >> > <br>
> >> > Taking Kate as an example, for the POT files I see<br>
> >> > svn+ssh://<br>
> >> <br>
> >> <a href="http://svn@svn.kde.org/home/kde/trunk/l10n-kf6/templates/docmessages/kate" rel="noreferrer" target="_blank">svn@svn.kde.org/home/kde/trunk/l10n-kf6/templates/docmessages/kate</a><br>
> >> <br>
> >> > and now my question is, where are the Kate DocBook files.<br>
> >> <br>
> >> In the Kate's repo<br>
> >> <br>
> >> <a href="https://invent.kde.org/utilities/kate/-/tree/master/doc?ref_type=heads" rel="noreferrer" target="_blank">https://invent.kde.org/utilities/kate/-/tree/master/doc?ref_type=heads</a><br>
> >> <br>
> >> Best regards,<br>
> >> Yuri<br>
> >> <br>
> >> > Greetings<br>
> >> > <br>
> >> > Oliver<br>
> >> > <br>
> >> > On Sun, Oct 29, 2023 at 11:24 AM Yuri Chornoivan <<a href="mailto:yurchor@ukr.net" target="_blank">yurchor@ukr.net</a>><br>
> >> <br>
> >> wrote:<br>
> >> > > неділя, 29 жовтня 2023 р. 12:09:15 EET Oliver Kellogg написано:<br>
> >> > > > Hello kde-doc-english,<br>
> >> > > > <br>
> >> > > > <a href="https://l10n.kde.org/docs/translation-howto/doc-files.html" rel="noreferrer" target="_blank">https://l10n.kde.org/docs/translation-howto/doc-files.html</a><br>
> >> <br>
> >> contains:<br>
> >> > > >    - the *English documentation* files in the directory<br>
> >> > > >    l10n-kf5/documentation/*EXAMPLE* (you need this file to generate<br>
> >> <br>
> >> the<br>
> >> <br>
> >> > > >    translated DocBook file)<br>
> >> > > > <br>
> >> > > > However, looking at <a href="https://websvn.kde.org/trunk/l10n-kf5/" rel="noreferrer" target="_blank">https://websvn.kde.org/trunk/l10n-kf5/</a> there<br>
> >> <br>
> >> is no<br>
> >> <br>
> >> > > > subdirectory documentation.<br>
> >> > > > <br>
> >> > > > Could you please clarify where is the origin of the DocBook files<br>
> >> <br>
> >> in the<br>
> >> <br>
> >> > > > repository?<br>
> >> > > > <br>
> >> > > > Many thanks,<br>
> >> > > > <br>
> >> > > > Oliver<br>
> >> > > > <br>
> >> > > > <a href="https://eo.l10n.kde.org/teamo.php" rel="noreferrer" target="_blank">https://eo.l10n.kde.org/teamo.php</a><br>
> >> > > <br>
> >> > > Hi,<br>
> >> > > <br>
> >> > > It is here:<br>
> >> > > <br>
> >> > > <a href="https://websvn.kde.org/trunk/www/areas/l10n/docs/translation-howto/" rel="noreferrer" target="_blank">https://websvn.kde.org/trunk/www/areas/l10n/docs/translation-howto/</a><br>
> >> > > <br>
> >> > > Hope this helps.<br>
> >> > > <br>
> >> > > Best regards,<br>
> >> > > Yuri<br>
<br>
<br>
<br>
<br>
</blockquote></div>