Re: Where to contribute manual translations ? (Re: Emacs-devel Digest, Vol 238, Issue 29)

[Jean-Christophe Helary <jean.christophe.helary@traductaire-libre.org>]

> On Dec 29, 2023, at 9:24, Jean-Christophe Helary <jean.christophe.helary@traductaire-libre.org> wrote:
> 
>> On Dec 29, 2023, at 2:00, emacs-devel-request@gnu.org wrote:
> 
>> Message: 1
>> Date: Wed, 27 Dec 2023 21:14:06 +0000
>> From: Vincent Belaïche <vincent.b.1@hotmail.fr>
>> To: emacs-devel <emacs-devel@gnu.org>
>> Subject: Where to contribute manual translations ?
>> Message-ID:
>> 	<PAXP192MB1608F5D8D0A89A5571C67D07849FA@PAXP192MB1608.EURP192.PROD.OUTLOOK.COM>
>> 
>> 
>> Hello,
>> 
>> Where is the right place to contribute a translation to French of the SES manual ?
>> Is it there : https://savannah.nongnu.org/projects/emacsdoc-fr
>> French GNU Emacs manual - Summary [Savannah]<https://savannah.nongnu.org/projects/emacsdoc-fr>
>> Savannah is a central point for development, distribution and maintenance of free software, both GNU and non-GNU.
>> savannah.nongnu.org
> 
> There have been many attempts at translating the manuals.
> 
> One was organized by traduc.org. I ended up "in charge" of it.
> 
> I moved the project to chapril / sr.ht a few years ago to easily include translators. The translation evolves slowly by it is also used for technical translation master student internships.
> 
> https://forge.chapril.org/brandelune/documentation_emacs/
> 
> The sources are hosted on sr.ht.
> 
> https://git.sr.ht/~brandelune/emacs_documentation_repository

I also made a presentation at EmacsConf 2021 on the subject:
https://emacsconf.org/2021/talks/omegat/

If you're interested in joining this effort, it is extremely "horizontal" → you don't have to do anything in particular. If you need to discuss terminology issues, I just created a dedicated mailing list:

https://lists.sr.ht/~brandelune/documentation_emacs

And I also created a tracker for translation/technical issues:
https://todo.sr.ht/~brandelune/documentation_emacs

You can also not join this project and that's also totally fine.

>> Another question : how to internationalize docstrings ? IMHO it would be great if the docstring could have some info manual anchor in it, and one could display it from the currently selected language manual. Besides, reading docstring from manual via some anchor is basically what Calc does with some kitchen tricks.
> 
> Eli answered that.

There is also a different issue, that comes before translation, it is fixing user facing strings, so that they can eventually be translated one day. I also made a presentation on that at EmacsConf 2022:
https://emacsconf.org/2022/talks/localizing/




-- 
Jean-Christophe Helary @jchelary@emacs.ch
https://traductaire-libre.org
https://mac4translators.blogspot.com
https://sr.ht/~brandelune/omegat-as-a-book/