Translating Guile documentation

Translating Guile documentation

[Denys Nykula]

[-- Attachment #1: Type: text/plain, Size: 1054 bytes --]

Hello.

Have the Guile website and reference manual ever been translated to
languages other than English? If I would like to start translating them
to my primary language, Ukrainian, what should I know in advance?

If I understand correctly, for translation I need to clone:
https://git.savannah.gnu.org/cgit/guile/guile-web.git/tree/website/apps/base
and
https://git.savannah.gnu.org/gitweb/?p=guile.git;a=tree;f=doc/ref;hb=HEAD

Then I need to edit the SXML and Texinfo files, run make and upload the
result on my web server. My question is what are the recommendations for
those who try that and whether any guile i18n working group exists.

Somewhat related, please fix the links on the Learn page:

-http://www.cs.indiana.edu/scheme-repository/home.html
+https://legacy.cs.indiana.edu/ftp/scheme-repository/

-http://www.cs.washington.edu/education/courses/341/99su/lectures/scheme/
+https://courses.cs.washington.edu/courses/cse341/99su/lectures/scheme/ppframe.htm

The last is very nice and simple, I think it should be higher in the page.

Denys

[-- Attachment #2: Type: text/html, Size: 1176 bytes --]

Re: Translating Guile documentation

[Maxime Devos]

[-- Attachment #1: Type: text/plain, Size: 435 bytes --]

Denys Nykula schreef op zo 24-04-2022 om 01:24 [+0300]:
> Then I need to edit the SXML and Texinfo files, run make and upload the
> result on my web server. My question is what are the recommendations for
> those who try that and whether any guile i18n working group exists.

Guix uses po4a and https://translate.fedoraproject.org/, maybe Guile
can do the same?  I have not heard of any guile i18n group.

Greetings,
Maxime.

[-- Attachment #2: This is a digitally signed message part --]
[-- Type: application/pgp-signature, Size: 260 bytes --]

Re: Translating Guile documentation

[pelzflorian (Florian Pelz)]

Hello Denys.

On Sun, Apr 24, 2022 at 01:24:33AM +0300, Denys Nykula wrote:
> Hello.
> 
> Have the Guile website and reference manual ever been translated to
> languages other than English? If I would like to start translating them
> to my primary language, Ukrainian, what should I know in advance?

You have a wonderful ambition there.

This reminds me of my attempts a long time ago to translate the copy
of r5rs that is shipped with Guile to German.

https://lists.gnu.org/archive/html/guile-devel/2018-04/msg00007.html

Nothing came of it and I don’t know if Guile’s documentation is stable
enough.  For example, at

https://guix.gnu.org/blog/2022/online-guix-days-2022-announcement-2/

there have been discussions about reworking part of the docs.  See there at

* 13:40–14:15: A Deep Dive into the Guile Documentation & Makeover Proposal

In hindsight, I would rather translate the SICP book

http://mitpress.mit.edu/sicp/

(which already has been translated to German by Susanne
Daniels-Herold, but I think to no other language).  I’ve not checked
if there are more recent comparable books.  Of course, there are SRFIs
and Guile specifics beyond SICP, like (ice-9 match).

Regards,
Florian