Re: Translation of manuals (was: SES manual French translation)

[Jean-Christophe Helary]

> On Jan 4, 2024, at 15:58, Stefan Kangas <stefankangas@gmail.com> wrote:
> 
> Eli Zaretskii <eliz@gnu.org> writes:
> 
>>> There are plenty of issues with static IDing parts of a document.
>> 
>> Sure.  We are in uncharted territory here, so issues are a legion.
> 
> I think the job will be easier if we use established tools and workflows
> if at all possible.
> 
>>> I think po-mode already does that and all the "out of emacs" tools do
>>> too.
>> 
>> Maybe so.  But I wouldn't assume that PO could be easily stretched to
>> this kind of jobs, since it wasn't originally designed for them.
> 
> IIUC, it's what Jean-Christophe's has already been using here:
> 
>    https://git.sr.ht/~brandelune/emacs_documentation_repository

That’s correct.

The script that I use is here:

https://git.sr.ht/~brandelune/emacs_documentation_repository/tree/main/item/emacs_docs2po.sh

Pardon my poor shell scripting skills. Plus it’s only the script that converts 
in the texi → po direction. I’ve not written the one in the other direction.

The display.texi chapter is here:

https://git.sr.ht/~brandelune/emacs_documentation_repository/tree/main/item/doc/emacs/display.texi.fr.po

JFYI, the paragraphs that Eli quoted earlier are displayed this way in OmegaT:

===

¶

A buffer can have blank areas called @dfn{display margins} on the left and on 
the right.

Ordinary text never appears in these areas, but you can put things into the 
display margins using the @code{display} property.

There is currently no way to make text or images in the margin mouse-sensitive.

¶

The way to display something in the margins is to specify it in a margin 
display specification in the @code{display} property of some text.

This is a replacing display specification, meaning that the text you put it on 
does not get displayed; the margin display appears, but that text does not.

¶

A margin display specification looks like @code{((margin right-margin) 
@var{spec})} or @code{((margin left-margin) @var{spec})}.

Here, @var{spec} is another display specification that says what to display in 
the margin.

Typically it is a string of text to display, or an image descriptor.

¶

===

I have special regex to handle all the texi commands. I describe them here:

https://goshikidai.blogspot.com/2021/08/#définitions


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