Re: Problem with documentation download

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

Re: Problem with documentation download

Federico Bruni-3
Il giorno mer 1 feb 2017 alle 11:16, [hidden email] ha scritto:
> I'm trying to download this document: Uceni.pdf from
> http://lilypond.org/learning.cs.html but I get a message: Not found
> The requested URL /doc/v2.18/Documentation/learning.cs.pdf was not
> found on this server. Can you fix this bug please?

Hi Zdenek

As far as I can see in the git log, the last update to czech
documentation dates back to August 2012.
The information may be inaccurate or incomplete for the current stable
(2.18).
If you feel like working on updating the translation of this manual,
let us know :-)

I'm Cc-ing the translation list.
It seems that PDF files are disabled for your language:

$ cat Documentation/cs/GNUmakefile
ISOLANG = cs
depth = ../..
STEPMAKE_TEMPLATES = documentation texinfo
LOCALSTEPMAKE_TEMPLATES = lilypond ly doc-i18n-root
NO_PDF_FILES = 1

If I comment the last line I get the PDF file (I'll send it privately
to you in the next mail).

@TRANSLATORS: ok if I comment that line and push to translation branch?

Same for japanese and chinese languages:
$ git grep -n NO_PDF_FILES
Documentation/cs/GNUmakefile:5:NO_PDF_FILES = 1
Documentation/ja/GNUmakefile:5:NO_PDF_FILES = 1
Documentation/nl/GNUmakefile:5:# NO_PDF_FILES = 1
Documentation/zh/GNUmakefile:5:NO_PDF_FILES = 1
make/doc-i18n-root-targets.make:4:ifneq ($(NO_PDF_FILES),)
make/doc-i18n-root-targets.make:7:ifeq ($(NO_PDF_FILES),)

These two languages still have a correct link to a PDF file, but in
english (this depends on texinfo source).
Don't know what's the purpose of this though.





Reply | Threaded
Open this post in threaded view
|

Re: Problem with documentation download

David Kastrup
Federico Bruni <[hidden email]> writes:

> Il giorno mer 1 feb 2017 alle 11:16, [hidden email] ha scritto:
>> I'm trying to download this document: Uceni.pdf from
>> http://lilypond.org/learning.cs.html but I get a message: Not found
>> The requested URL /doc/v2.18/Documentation/learning.cs.pdf was not
>> found on this server. Can you fix this bug please?
>
> Hi Zdenek
>
> As far as I can see in the git log, the last update to czech
> documentation dates back to August 2012.
> The information may be inaccurate or incomplete for the current stable
> (2.18).
> If you feel like working on updating the translation of this manual,
> let us know :-)
>
> I'm Cc-ing the translation list.
> It seems that PDF files are disabled for your language:
>
> $ cat Documentation/cs/GNUmakefile
> ISOLANG = cs
> depth = ../..
> STEPMAKE_TEMPLATES = documentation texinfo
> LOCALSTEPMAKE_TEMPLATES = lilypond ly doc-i18n-root
> NO_PDF_FILES = 1
>
> If I comment the last line I get the PDF file (I'll send it privately
> to you in the next mail).
>
> @TRANSLATORS: ok if I comment that line and push to translation branch?

I think it is awfully outdated and half-German (and the German parts are
copies from awfully outdated source as well).  We really need more
active translators, and this translation wasn't even finished.

--
David Kastrup


Reply | Threaded
Open this post in threaded view
|

Re: Problem with documentation download

Francisco Vila
In reply to this post by Federico Bruni-3
2017-02-01 17:08 GMT+01:00 Federico Bruni <[hidden email]>:
> @TRANSLATORS: ok if I comment that line and push to translation branch?

I don't oppose but those PDFs were not built for a reason.

--
Francisco Vila. Badajoz (Spain)
www.paconet.org , www.csmbadajoz.com


Reply | Threaded
Open this post in threaded view
|

Re: Problem with documentation download

Federico Bruni-3

Il giorno gio 2 feb 2017 alle 12:23, Francisco Vila
<[hidden email]> ha scritto:
> 2017-02-01 17:08 GMT+01:00 Federico Bruni <[hidden email]>:
>>  @TRANSLATORS: ok if I comment that line and push to translation
>> branch?
>
> I don't oppose but those PDFs were not built for a reason.
>
>

My change proposal was only for the czech documentation, which does not
have an active maintainer AFAIK (not japanese or chinese).

What's the reason for blocking the build of PDF files?
If there's a good reason not to build the czech PDF file, then we
should change it to link to the english PDF. File not found is not nice.





Reply | Threaded
Open this post in threaded view
|

Re: Problem with documentation download

Francisco Vila
2017-02-02 12:46 GMT+01:00 Federico Bruni <[hidden email]>:
> What's the reason for blocking the build of PDF files?

I don't remember but we should test it first and throw a look on it.

> If there's a good reason not to build the czech PDF file, then we should
> change it to link to the english PDF. File not found is not nice.

Of course I agree on this.

--
Francisco Vila. Badajoz (Spain)
www.paconet.org , www.csmbadajoz.com


Reply | Threaded
Open this post in threaded view
|

Re: Problem with documentation download

David Kastrup
In reply to this post by Federico Bruni-3
Federico Bruni <[hidden email]> writes:

> Il giorno gio 2 feb 2017 alle 12:23, Francisco Vila
> <[hidden email]> ha scritto:
>> 2017-02-01 17:08 GMT+01:00 Federico Bruni <[hidden email]>:
>>>  @TRANSLATORS: ok if I comment that line and push to translation
>>> branch?
>>
>> I don't oppose but those PDFs were not built for a reason.
>>
>>
>
> My change proposal was only for the czech documentation, which does
> not have an active maintainer AFAIK (not japanese or chinese).
>
> What's the reason for blocking the build of PDF files?
> If there's a good reason not to build the czech PDF file, then we
> should change it to link to the english PDF. File not found is not
> nice.

At the current point of time, building the Czech PDF file is not just a
waste of time but also not helpful to the Czech users of LilyPond.

If we can sensibly link to the English documentation, we should likely
do that.

Maybe we should offer an additional link to the English versions for
_all_ languages knowing to have an outdated translation, including
German and Dutch.

--
David Kastrup


Reply | Threaded
Open this post in threaded view
|

Re: Problem with documentation download

Federico Bruni-3
Il giorno gio 2 feb 2017 alle 12:52, David Kastrup <[hidden email]> ha
scritto:
> At the current point of time, building the Czech PDF file is not just
> a waste of time but also not helpful to the Czech users of LilyPond.
> If we can sensibly link to the English documentation, we should
> likely do that. Maybe we should offer an additional link to the
> English versions for _all_ languages knowing to have an outdated
> translation, including German and Dutch.

Ok, then I'll make sure that it will point to the English PDF file.

Some months ago I suggested using a warning for out-of-date translated
pages:
https://lists.gnu.org/archive/html/lilypond-user/2016-11/msg00736.html

I've now added an issue on the tracker:
https://sourceforge.net/p/testlilyissues/issues/5048/

I'm going to label as "translations" the issues related with
translation. Because searching in Sourceforge is a pain.