[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-10-29 14:29:45
Message-ID: CANZbxGnfbTc1HcBhnn3ksM4yCw6N+d4rJhBBb0f=MsVi6mNJog () mail ! gmail ! com
[Download RAW message or body]
> 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>> 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></div><div>Ah! I don't know how I overlooked that, thanks.</div><div>At any \
rate, I find the following bullet from *POT and PO Files Used for Documentation* \
confusing:</div><div><br></div><div style="margin-left:40px">For the package \
"EXAMPLE" you will find</div><div style="margin-left:40px">[...]</div><div \
style="margin-left:40px">- the translated documentation (in DocBook format) in the \
directory l10n-kf5/*$LANGUAGE*/docs/*EXAMPLE*/</div><div><br></div><div>It is not \
true that the translated documentation (in DocBook format) can be found in the \
directory</div><div><div> l10n-kf5/*$LANGUAGE*/docs/*EXAMPLE*/</div><div>(there \
is no such directory).</div><div><br></div><div>Cheers</div><div><br></div><div>Oliver</div><div><br></div></div></div><br><div \
class="gmail_quote"><div dir="ltr" class="gmail_attr">On Sun, Oct 29, 2023 at \
1:32 PM 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 р. 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 all<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 translated<br>
> PO files and DocBook files for all languages are located in the KDE package<br>
> named *kde-l10n*. For the package "EXAMPLE" you will find<br>
> <br>
> -<br>
> <br>
> the POT files in the directory \
l10n-kf5/templates/docmessages/*EXAMPLE*/<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>
> <br>
> Taking Kate as an example, for the POT files I see<br>
> svn+ssh://<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>
> 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>
> <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>> 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> \
contains:<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>
> > > 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 is \
no<br> > > > subdirectory documentation.<br>
> > > <br>
> > > Could you please clarify where is the origin of the DocBook files in \
the<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