[prev in list] [next in list] [prev in thread] [next in thread]
List: kde-doc-english
Subject: Re: Repository location of English documentation files
From: Oliver Kellogg <olivermkellogg () gmail ! com>
Date: 2023-11-04 15:49:42
Message-ID: CANZbxGn-q9dDy72hKZ+h=vzL6W0yPDvHOWdZDdxTMAGPB07doQ () mail ! gmail ! com
[Download RAW message or body]
Thanks for your help, Yuri.
I was now successful running update_xml, see
svn+ssh://svn@svn.kde.org/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 <yurchor@ukr.net> 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 <olivermkellogg@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 <yurchor@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@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@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
>
>
>
>
>
[Attachment #3 (text/html)]
<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>
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic