[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:50:43
Message-ID: CANZbxGnuVJf7uzdMx4LRpMgZi3v37fwjJgG9VrAbUhckrk9tDA () mail ! gmail ! com
[Download RAW message or body]
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.
-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>Correction:</div><div>The confusing bullet is the one \
before,</div><div style="margin-left:40px">- the <span class="emphasis"><em>English \
documentation</em></span> files in the directory <code \
class="gmail-filename">l10n-kf5/documentation/<span class="gmail-replaceable"><em \
class="gmail-replaceable"><code>EXAMPLE</code></em></span></code> (you need this file \
to generate the translated DocBook file) <br></div><div><br></div><div>The directory \
<code class="gmail-filename">l10n-kf5/documentation/ </code> is the one that I \
cannot find.</div><div><br></div><div>-Oliver<br></div></div><br><div \
class="gmail_quote"><div dir="ltr" class="gmail_attr">On Sun, Oct 29, 2023 at \
3:29 PM Oliver Kellogg <<a \
href="mailto:olivermkellogg@gmail.com">olivermkellogg@gmail.com</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"><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" \
target="_blank">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>
</blockquote></div>
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic