Bug#690750: developers-reference: no link to English manual

classic Classic list List threaded Threaded
12 messages Options
Reply | Threaded
Open this post in threaded view
|

Bug#690750: developers-reference: no link to English manual

Hideki Yamane (Debian-JP)
Package: developers-reference
Version: 3.4.9
Severity: minor
tags: l10n
Control: user [hidden email]
Control: usertags -1 debianjp

Hi,

 Now it's index.html says "This page is also available in French, German
 and Japanese." and link to each language. However, this line is same in
 each language.

 So, non-English manuals doesn't have a link to original English manual.
 As a comment in index.dbx,
> <!-- TODO: Maybe better: "This document has originally been written
> in English.  Translations into different languages are available." -->

 Yes, it should be fixed (as severity: minor).

--
Regards,

 Hideki Yamane     henrich @ debian.or.jp/org
 http://wiki.debian.org/HidekiYamane


--
To UNSUBSCRIBE, email to [hidden email]
with a subject of "unsubscribe". Trouble? Contact [hidden email]

Reply | Threaded
Open this post in threaded view
|

Bug#690750: developers-reference: no link to English manual

Holger Wansing-4
Control: tags -1 + patch

Hideki Yamane <[hidden email]> wrote:
>  Now it's index.html says "This page is also available in French, German
>  and Japanese." and link to each language. However, this line is same in
>  each language.
>
>  So, non-English manuals doesn't have a link to original English manual.

I have attached a patch to fix this, so that it says:

"This manual is available in English, French, German, Italian, Russian, and
Japanese."

That way, the same text would work for all translations :-)

I can commit this, if you agree.


Holger


--
Holger Wansing <[hidden email]>
PGP-Finterprint: 496A C6E8 1442 4B34 8508  3529 59F1 87CA 156E B076

Reply | Threaded
Open this post in threaded view
|

Bug#690750: developers-reference: no link to English manual

Holger Wansing-4
In reply to this post by Hideki Yamane (Debian-JP)
Control: tags -1 + patch

[hidden email] wrote:
> I have attached a patch to fix this, so that it says:

The patch is now attached.


Holger


--
Holger Wansing <[hidden email]>
PGP-Finterprint: 496A C6E8 1442 4B34 8508  3529 59F1 87CA 156E B076

languages.diff (924 bytes) Download Attachment
Reply | Threaded
Open this post in threaded view
|

Bug#690750: Broken links in developers-reference as published on the Debian's website

Lev Lamberov-3
In reply to this post by Hideki Yamane (Debian-JP)
Hi Holger,

thanks for your attention to the bug report, but my report was about a
different issue. Let me explain.

First, let's take a look at developers-reference as it pubished on the
Debian's website. Say, in English [web-en]. It incorrectly links to
translations as index.{fr,de,it,ru,jp}.en.html, such files do not exist.
Any other translation, say, French [web-fr] links to translations as
index.{de,it,ru,jp}.fr.html, such files do not exist.

[web-en] https://www.debian.org/doc/manuals/developers-reference/index.en.html

[web-fr] https://www.debian.org/doc/manuals/developers-reference/index.fr.html

Second, let's take a look at developers-reference package. All links
there are correct, that is in _any_ language links point to
index.{fr,de,it,ru,jp}.html.

Third, let's take a look at developers-reference source code. In English
we currently have as follows:

<para>
If you want to print this reference, you should use the <ulink
url="developers-reference.pdf">pdf version</ulink>.  This page is also
available in <ulink url="index.fr.html">French</ulink>, <ulink
url="index.de.html">German</ulink>, <ulink
url="index.it.html">Italian</ulink>, <ulink
url="index.ru.html">Russian</ulink>, and <ulink
url="index.ja.html">Japanese</ulink>.
<!-- TODO: Maybe better: "This document has originally been written
in English.  Translations into different languages are available." -->
</para>

Again, links are correct and point to index.{fr,de,it,ru,jp}.html. And
the same holds for any translation.

Broken links are only in developers-reference published on the Debian's
website. Since links in the source code and in the developers-reference
package are correct, then it is the content negotiation problem. Looks
like the webserver incorrectly rewrites links.

Let me stress that my report is _not_ about links to English, or links
in English. It is about _broken_ links in _any_ developers-reference as
published on the Debian's website. So, my bug report is about
www.debian.org, not developers-reference. Please, reconsider it and
reassign #912724 to www.debian.org.

Regards,
Lev

Reply | Threaded
Open this post in threaded view
|

Bug#690750: Broken links in developers-reference as published on the Debian's website

Laura Arjona Reina-4
Hello
Could this be caused by the code of mvhtml() function in cron/parts/7doc
script?

https://salsa.debian.org/webmaster-team/cron/blob/master/parts/7doc

Maybe it works well for links *.html and *.XX.html being XX the language
processing in that time, but maybe it's not prepared for *.YY.html files
being YY a different language than the one being processed each time.

I've had a look at the code but I cannot understand it well, sorry.

Kind regards

El 03/11/18 a las 22:07, Lev Lamberov escribió:

> Hi Holger,
>
> thanks for your attention to the bug report, but my report was about a
> different issue. Let me explain.
>
> First, let's take a look at developers-reference as it pubished on the
> Debian's website. Say, in English [web-en]. It incorrectly links to
> translations as index.{fr,de,it,ru,jp}.en.html, such files do not exist.
> Any other translation, say, French [web-fr] links to translations as
> index.{de,it,ru,jp}.fr.html, such files do not exist.
>
> [web-en] https://www.debian.org/doc/manuals/developers-reference/index.en.html
>
> [web-fr] https://www.debian.org/doc/manuals/developers-reference/index.fr.html
>
> Second, let's take a look at developers-reference package. All links
> there are correct, that is in _any_ language links point to
> index.{fr,de,it,ru,jp}.html.
>
> Third, let's take a look at developers-reference source code. In English
> we currently have as follows:
>
> <para>
> If you want to print this reference, you should use the <ulink
> url="developers-reference.pdf">pdf version</ulink>.  This page is also
> available in <ulink url="index.fr.html">French</ulink>, <ulink
> url="index.de.html">German</ulink>, <ulink
> url="index.it.html">Italian</ulink>, <ulink
> url="index.ru.html">Russian</ulink>, and <ulink
> url="index.ja.html">Japanese</ulink>.
> <!-- TODO: Maybe better: "This document has originally been written
> in English.  Translations into different languages are available." -->
> </para>
>
> Again, links are correct and point to index.{fr,de,it,ru,jp}.html. And
> the same holds for any translation.
>
> Broken links are only in developers-reference published on the Debian's
> website. Since links in the source code and in the developers-reference
> package are correct, then it is the content negotiation problem. Looks
> like the webserver incorrectly rewrites links.
>
> Let me stress that my report is _not_ about links to English, or links
> in English. It is about _broken_ links in _any_ developers-reference as
> published on the Debian's website. So, my bug report is about
> www.debian.org, not developers-reference. Please, reconsider it and
> reassign #912724 to www.debian.org.
>
> Regards,
> Lev
>

--
Laura Arjona Reina
https://wiki.debian.org/LauraArjona

Reply | Threaded
Open this post in threaded view
|

Bug#912724: Broken links in developers-reference as published on the Debian's website

Holger Wansing-2
In reply to this post by Lev Lamberov-3
Control: reassign 912724 www.debian.org

Lev Lamberov <[hidden email]> wrote:
> Hi Holger,
>
> thanks for your attention to the bug report, but my report was about a
> different issue. Let me explain.
>
[]
>
> Let me stress that my report is _not_ about links to English, or links
> in English. It is about _broken_ links in _any_ developers-reference as
> published on the Debian's website. So, my bug report is about
> www.debian.org, not developers-reference. Please, reconsider it and
> reassign #912724 to www.debian.org.

Yes, you are right. I did not read your report careful enough. Sorry.
Reassigning back to www.debian.org


Holger

--
============================================================
Created with Sylpheed 3.5.1 under
        D E B I A N   L I N U X   9   " S T R E T C H " .

Registered Linux User #311290 - https://linuxcounter.net/
============================================================

Reply | Threaded
Open this post in threaded view
|

Bug#690750: Broken links in developers-reference as published on the Debian's website

Holger Wansing-2
In reply to this post by Lev Lamberov-3
Hi,

Lev Lamberov <[hidden email]> wrote:
> Hi Holger,
>
> thanks for your attention to the bug report, but my report was about a
> different issue. Let me explain.

When looking into all this, it's even more complicated ...

> First, let's take a look at developers-reference as it pubished on the
> Debian's website. Say, in English [web-en]. It incorrectly links to
> translations as index.{fr,de,it,ru,jp}.en.html, such files do not exist.
> Any other translation, say, French [web-fr] links to translations as
> index.{de,it,ru,jp}.fr.html, such files do not exist.
>
> [web-en] https://www.debian.org/doc/manuals/developers-reference/index.en.html
>
> [web-fr] https://www.debian.org/doc/manuals/developers-reference/index.fr.html

... since there are links on the website which work, and others do not:

On https://www.debian.org/doc/devel-manuals#devref (on the wegpage itself)
all links are correct and working.
However, when going into the document itself under for example
https://www.debian.org/doc/manuals/developers-reference/index.en.html
we can find links to
https://www.debian.org/doc/manuals/developers-reference/index.fr.en.html
https://www.debian.org/doc/manuals/developers-reference/index.de.en.html
and so on. So re-writing the links inside the document does not work correctly,
while the ones on the wegpages itself are fine.


> Second, let's take a look at developers-reference package. All links
> there are correct, that is in _any_ language links point to
> index.{fr,de,it,ru,jp}.html.

That might be correct so far.
However, if you install those packages on your local machine (let's say the
english and the french package), the links inside that documents do not
work:
when you open the english document locally, the link to the german version
is file:///usr/share/doc/developers-reference/index.de.html
however that file does not exist, it is stored as
usr/share/doc/developers-reference-de/index.html


> Third, let's take a look at developers-reference source code. In English
> we currently have as follows:
>
> <para>
> If you want to print this reference, you should use the <ulink
> url="developers-reference.pdf">pdf version</ulink>.  This page is also
> available in <ulink url="index.fr.html">French</ulink>, <ulink
> url="index.de.html">German</ulink>, <ulink
> url="index.it.html">Italian</ulink>, <ulink
> url="index.ru.html">Russian</ulink>, and <ulink
> url="index.ja.html">Japanese</ulink>.
> <!-- TODO: Maybe better: "This document has originally been written
> in English.  Translations into different languages are available." -->
> </para>




Proposal: maybe the easiest way to make all variants (view via debian.org
and opened locally) work correctly, would be to change it this way:

"This page is also available in
<ulink url="https://www.debian.org/doc/devel-manuals#devref">French, German,
Italian, Russian, and Japanese</ulink>."

since the links on that page are fine and can be linked from everywhere
with one single static link.
Of course, there are still some corner cases which do not work (for example,
when you have the packages installed locally, you cannot switch from the
local english to the local german version via that links, and when you
have no internet connection, you also get an irritating situation), but most
usecases should be fine, and it would be an improvement compared to the
current situation, where all links do not work!

Would fix #690750 and #912724.


Comments?

Holger


--
============================================================
Created with Sylpheed 3.5.1 under
        D E B I A N   L I N U X   9   " S T R E T C H " .

Registered Linux User #311290 - https://linuxcounter.net/
============================================================

Reply | Threaded
Open this post in threaded view
|

Bug#690750: Broken links in developers-reference as published on the Debian's website

Holger Wansing-2
Hi,

Holger Wansing <[hidden email]> wrote:

>
> Proposal: maybe the easiest way to make all variants (view via debian.org
> and opened locally) work correctly, would be to change it this way:
>
> "This page is also available in
> <ulink url="https://www.debian.org/doc/devel-manuals#devref">French, German,
> Italian, Russian, and Japanese</ulink>."
>
> since the links on that page are fine and can be linked from everywhere
> with one single static link.
> Of course, there are still some corner cases which do not work (for example,
> when you have the packages installed locally, you cannot switch from the
> local english to the local german version via that links, and when you
> have no internet connection, you also get an irritating situation), but most
> usecases should be fine, and it would be an improvement compared to the
> current situation, where all links do not work!
>
> Would fix #690750 and #912724.
>
>
> Comments?

If noone objects shortly, I will commit this next weekend then.


Holger


--
============================================================
Created with Sylpheed 3.5.1 under
        D E B I A N   L I N U X   9   " S T R E T C H " .

Registered Linux User #311290 - https://linuxcounter.net/
============================================================

Reply | Threaded
Open this post in threaded view
|

Bug#690750: Broken links in developers-reference as published on the Debian's website

Lev Lamberov-3
In reply to this post by Holger Wansing-2
Вс 04 ноя 2018 @ 12:00 Holger Wansing <[hidden email]>:

> Proposal: maybe the easiest way to make all variants (view via debian.org
> and opened locally) work correctly, would be to change it this way:
>
> "This page is also available in
> <ulink url="https://www.debian.org/doc/devel-manuals#devref">French, German,
> Italian, Russian, and Japanese</ulink>."
>
> since the links on that page are fine and can be linked from everywhere
> with one single static link.
> Of course, there are still some corner cases which do not work (for example,
> when you have the packages installed locally, you cannot switch from the
> local english to the local german version via that links, and when you
> have no internet connection, you also get an irritating situation), but most
> usecases should be fine, and it would be an improvement compared to the
> current situation, where all links do not work!
>
> Would fix #690750 and #912724.
>
> Comments?

In case one take a look into other documentation (togather with its
translation), one will not find any such notes and links to
translations. Maybe there's no need in such note in "Debian Developer's
Reference"? Or at least no need in explicit links? What about to remove
it completely or change text to something like "This documentation is
also available in some other languages"?

Regards,
Lev

Reply | Threaded
Open this post in threaded view
|

Bug#690750: Bug#912724: Broken links in developers-reference as published on the Debian's website

Holger Wansing-4
Hi,

Am Montag, 12. November 2018 schrieb Lev Lamberov:

> Вс 04 ноя 2018 @ 12:00 Holger Wansing <[hidden email]>:
>
> > Proposal: maybe the easiest way to make all variants (view via debian.org
> > and opened locally) work correctly, would be to change it this way:
> >
> > "This page is also available in
> > <ulink url="https://www.debian.org/doc/devel-manuals#devref">French, German,
> > Italian, Russian, and Japanese</ulink>."
> >
> > since the links on that page are fine and can be linked from everywhere
> > with one single static link.
> > Of course, there are still some corner cases which do not work (for example,
> > when you have the packages installed locally, you cannot switch from the
> > local english to the local german version via that links, and when you
> > have no internet connection, you also get an irritating situation), but most
> > usecases should be fine, and it would be an improvement compared to the
> > current situation, where all links do not work!
> >
> > Would fix #690750 and #912724.
> >
> > Comments?
>
> In case one take a look into other documentation (togather with its
> translation), one will not find any such notes and links to
> translations. Maybe there's no need in such note in "Debian Developer's
> Reference"? Or at least no need in explicit links? What about to remove
> it completely or change text to something like "This documentation is
> also available in some other languages"?

Yes, I had also thought about that.
Another benefit would be, that we don't need to rephrase
the sentence, when new translations are added or outdated
onces removed.
But I still would like to make that a link, for usability.
 

Holger

--
Sent from my Jolla phone
http://www.jolla.com/
Reply | Threaded
Open this post in threaded view
|

Bug#690750: Broken links in developers-reference as published on the Debian's website

Holger Wansing-4
In reply to this post by Lev Lamberov-3
Control: tags -1 + pending

Lev Lamberov <[hidden email]> wrote:

> Вс 04 ноя 2018 @ 12:00 Holger Wansing <[hidden email]>:
>
> > Proposal: maybe the easiest way to make all variants (view via debian.org
> > and opened locally) work correctly, would be to change it this way:
> >
> > "This page is also available in
> > <ulink url="https://www.debian.org/doc/devel-manuals#devref">French, German,
> > Italian, Russian, and Japanese</ulink>."
> >
> > since the links on that page are fine and can be linked from everywhere
> > with one single static link.
> > Of course, there are still some corner cases which do not work (for example,
> > when you have the packages installed locally, you cannot switch from the
> > local english to the local german version via that links, and when you
> > have no internet connection, you also get an irritating situation), but most
> > usecases should be fine, and it would be an improvement compared to the
> > current situation, where all links do not work!
> >
> > Would fix #690750 and #912724.
> >
> > Comments?
>
> In case one take a look into other documentation (togather with its
> translation), one will not find any such notes and links to
> translations. Maybe there's no need in such note in "Debian Developer's
> Reference"? Or at least no need in explicit links? What about to remove
> it completely or change text to something like "This documentation is
> also available in some other languages"?

I have committed this now like this, while 'some  other languages' is a link
to https://www.debian.org/doc/devel-manuals#devref


Tagging these bugs as pending

Holger




--
Holger Wansing <[hidden email]>
PGP-Finterprint: 496A C6E8 1442 4B34 8508  3529 59F1 87CA 156E B076

Reply | Threaded
Open this post in threaded view
|

Bug#690750: Broken links in developers-reference as published on the Debian's website

Lev Lamberov-3
Пт 16 ноя 2018 @ 20:07 Holger Wansing <[hidden email]>:

> Control: tags -1 + pending
>
> Lev Lamberov <[hidden email]> wrote:
>> Вс 04 ноя 2018 @ 12:00 Holger Wansing <[hidden email]>:
>>
>> > Proposal: maybe the easiest way to make all variants (view via debian.org
>> > and opened locally) work correctly, would be to change it this way:
>> >
>> > "This page is also available in
>> > <ulink url="https://www.debian.org/doc/devel-manuals#devref">French, German,
>> > Italian, Russian, and Japanese</ulink>."
>> >
>> > since the links on that page are fine and can be linked from everywhere
>> > with one single static link.
>> > Of course, there are still some corner cases which do not work (for example,
>> > when you have the packages installed locally, you cannot switch from the
>> > local english to the local german version via that links, and when you
>> > have no internet connection, you also get an irritating situation), but most
>> > usecases should be fine, and it would be an improvement compared to the
>> > current situation, where all links do not work!
>> >
>> > Would fix #690750 and #912724.
>> >
>> > Comments?
>>
>> In case one take a look into other documentation (togather with its
>> translation), one will not find any such notes and links to
>> translations. Maybe there's no need in such note in "Debian Developer's
>> Reference"? Or at least no need in explicit links? What about to remove
>> it completely or change text to something like "This documentation is
>> also available in some other languages"?
>
> I have committed this now like this, while 'some  other languages' is a link
> to https://www.debian.org/doc/devel-manuals#devref

Thanks, Holger! Looks like this is the best option for now. Maybe better
variant will come later.

Cheers!
Lev