lilypond-devel
[Top][All Lists]
Advanced

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

Re: fix-docsize.sh errors in make doc


From: David Kastrup
Subject: Re: fix-docsize.sh errors in make doc
Date: Mon, 14 Sep 2020 21:54:50 +0200
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux)

Michael Käppler <xmichael-k@web.de> writes:

> Hi Jean,
>
> Am 12.09.2020 um 13:28 schrieb Jean Abou Samra:
>> Hi,
>>
>> Towards the end of the process, `make doc` outputs warnings coming
>> from fix-docsize.sh. This occurs in CI too. Any ideas?
>>
>> Best,
>> Jean
>
> IIUC this is simply due to the fact that the mentioned manuals are not
> translated and therefore
> are missing in the doc tree. Since fix-docsize.sh cannot determine the
> size of files that don't exist,
> it outputs this message.
>
> The more important issue seems to me that the missing translations cause
> many broken links in the documentation.

The reason fix-docsize.sh gives those warnings is to help diagnosing
those broken links.

> Was this always the case?

It came with some doc reorganisation.  The offline docs were broken for
a long time.  The online docs might or might not have worked depending
on the language settings in your browser (via Apache redirection
configuration), and it would be very hard to browse through
documentation in a language that wasn't first choice in your browser:
this frequently cast you back into some other language.

> I think these should links should either be removed or point to the
> english version with an adjusted link text like
> 'Changes (no translation available)'

The whole language selection thing is completely broken.  Only the
landing page should look at your browser language selection; afterwards
all links should stick with the selected language.

Of course the problem with that is that this should not be the case for
an English-language fallback.  Strictly speaking, those should not be
the same as the normal English-language pages but rather be per-language
copies that have all links changed to stick within the language that is
missing the page translation.

-- 
David Kastrup



reply via email to

[Prev in Thread] Current Thread [Next in Thread]