[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Broken links in developers-reference as published on the Debian's website


Lev Lamberov <dogsleg@debian.org> 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
we can find links to
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
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

> 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.



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 to: