view release on metacpan or  search on metacpan

i18n/src/xlate.gpt5-ES.pod  view on Meta::CPAN

=encoding utf-8

=head1 NAME

App::Greple::xlate - módulo de soporte de traducción para greple

=head1 SYNOPSIS

    greple -Mxlate --xlate-engine gpt5 --xlate pattern target-file

    greple -Mxlate --xlate-engine deepl --xlate pattern target-file

=head1 VERSION

Version 2.02

=head1 DESCRIPTION

B<Greple> B<xlate> module encuentra los bloques de texto deseados y los reemplaza por el texto traducido. El motor principal es GPT-5.6 Terra (F<llm/gpt5.pm>), que llama al comando L<llm|https://llm.datasette.io/>; DeepL (F<deepl.pm>) y los motores h...

Las traducciones se almacenan en caché por archivo, por lo que volver a ejecutar un comando no cuesta nada para el texto sin cambios. Cuando se edita un documento, solo los párrafos modificados se envían de nuevo a la API; un motor consciente del ...

Si desea traducir bloques de texto normales en un documento escrito en el estilo pod de Perl, use el comando B<greple> con C<--xlate-engine gpt5> y el módulo C<perl> así:

    greple -Mxlate --xlate-engine gpt5 -Mperl --pod --re '^([\w\pP].*\n)+' --all foo.pm

En este comando, la cadena de patrón C<^([\w\pP].*\n)+> significa líneas consecutivas que comienzan con letras alfanuméricas y signos de puntuación. Este comando muestra el área a traducir resaltada. La opción B<--all> se utiliza para producir ...

=for html <p>
<img width="750" src="https://raw.githubusercontent.com/kaz-utashiro/App-Greple-xlate/main/images/select-area.png">
</p>

Luego agregue la opción C<--xlate> para traducir el área seleccionada. Entonces, encontrará las secciones deseadas y las reemplazará por la salida del motor de traducción.

De forma predeterminada, el texto original y el traducido se imprimen en el formato de "marcador de conflicto" compatible con L<git(1)>. Usando el formato C<ifdef>, puede obtener la parte deseada fácilmente con el comando L<unifdef(1)>. El formato d...

=for html <p>
<img width="750" src="https://raw.githubusercontent.com/kaz-utashiro/App-Greple-xlate/main/images/format-conflict.png">
</p>

Si desea traducir todo el texto, use la opción B<--match-all>. Este es un atajo para especificar el patrón C<(?s).+> que coincide con todo el texto.

Los datos en formato de marcador de conflicto pueden visualizarse en estilo lado a lado con el comando L<sdif|App::sdif> y la opción C<-V>. Dado que no tiene sentido comparar por cadena, se recomienda la opción C<--no-cdif>. Si no necesita colorear...

    sdif -V --no-filename --no-tc --no-cdif data_shishin.deepl-EN-US.cm

=for html <p>
<img width="750" src="https://raw.githubusercontent.com/kaz-utashiro/App-Greple-xlate/main/images/sdif-cm-view.png">
</p>

=head1 NORMALIZATION

El procesamiento se realiza en unidades especificadas, pero en el caso de una secuencia de múltiples líneas de texto no vacío, se convierten juntas en una sola línea. Esta operación se realiza de la siguiente manera:

=over 2

=item *

Eliminar los espacios en blanco al principio y al final de cada línea.

=item *

Si una línea termina con un signo de puntuación de ancho completo, concatenar con la siguiente línea.

=item *

Si una línea termina con un carácter de ancho completo y la siguiente línea comienza con un carácter de ancho completo, concatenar las líneas.

=item *

Si el final o el comienzo de una línea no es un carácter de ancho completo, concatenarlas insertando un espacio.

=back

Los datos de caché se gestionan en función del texto normalizado, por lo que incluso si se realizan modificaciones que no afecten los resultados de la normalización, los datos de traducción en caché seguirán siendo efectivos.

Este proceso de normalización se realiza solo para el primer (índice 0) y los patrones de número par. Por lo tanto, si se especifican dos patrones como se indica a continuación, el texto que coincida con el primer patrón se procesará después d...

    greple -Mxlate -E normalized -E not-normalized

Por lo tanto, use el primer patrón para el texto que deba procesarse combinando múltiples líneas en una sola línea, y use el segundo patrón para texto preformateado. Si no hay texto que coincida en el primer patrón, use un patrón que no coinci...

=head1 MASKING

Ocasionalmente, hay partes del texto que no desea traducir. Por ejemplo, etiquetas en archivos markdown. DeepL sugiere que, en tales casos, la parte del texto a excluir se convierta en etiquetas XML, se traduzca y luego se restaure una vez completada...

    --xlate-setopt maskfile=MASKPATTERN

Esto interpretará cada línea del archivo C<MASKPATTERN> como una expresión regular, traducirá las cadenas que coincidan con ella y revertirá después del procesamiento. Las líneas que comienzan con C<#> se ignoran.

Un patrón complejo puede escribirse en múltiples líneas con salto de línea escapado con barra invertida.

Cómo se transforma el texto mediante el enmascaramiento puede verse con la opción B<--xlate-mask>.

Los marcadores de enmascaramiento son etiquetas XML autocerradas bien formadas, como C<< <m id="1" /> >>. Los motores LLM basados en JSON reciben las etiquetas en sus matrices de entrada. Para DeepL, una solicitud que contiene etiquetas de marcador s...

El enmascaramiento protege el marcado para que no se traduzca. Para ocultar cadenas sensibles al propio servicio de traducción, consulte L</ANONYMIZATION AND TEMPLATES>; ambos pueden usarse juntos.

Esta interfaz es experimental y está sujeta a cambios en el futuro.

=head1 ANONYMIZATION AND TEMPLATES

Las cadenas sensibles pueden ocultarse antes de enviarse a la API de traducción y restaurarse en la salida. Hay tres fuentes de reglas de anonimización disponibles: un archivo de diccionario (B<--xlate-anonymize>), marcas en línea en el propio doc...

Para documentos de formulario (informes trimestrales y similares), defina los actores al principio y haga referencia a ellos en el cuerpo:

    ---
    報告者: 山田太郎

i18n/src/xlate.gpt5-ES.pod  view on Meta::CPAN

=item --xlate-cache=I<strategy>

=over 4

=item C<auto> (Default)

Mantenga el archivo de caché si existe.

=item C<create>

Cree un archivo de caché vacío y salga.

=item C<always>, C<yes>, C<1>

Mantén la caché de todos modos siempre que el destino sea un archivo normal.

=item C<clear>

Borra primero los datos de la caché.

=item C<never>, C<no>, C<0>

Nunca uses el archivo de caché aunque exista.

=item C<accumulate>

Por defecto, los datos no utilizados se eliminan del archivo de caché. Si no quieres eliminarlos y prefieres mantenerlos en el archivo, usa C<accumulate>.

=back

=item B<--xlate-update>

Esta opción fuerza la actualización del archivo de caché aunque no sea necesaria.

=back

=head1 COMMAND LINE INTERFACE

Puedes usar fácilmente este módulo desde la línea de comandos utilizando el comando C<xlate> incluido en la distribución. Consulta la página del manual C<xlate> para su uso.

El comando C<xlate> admite opciones largas al estilo GNU como C<--to-lang>, C<--from-lang>, C<--engine> y C<--file>. Use C<xlate -h> para ver todas las opciones disponibles.

El comando C<xlate> funciona en conjunto con el entorno Docker, por lo que, incluso si no tienes nada instalado localmente, puedes usarlo siempre que Docker esté disponible. Usa la opción C<-D> o C<-C>.

Las operaciones de Docker son manejadas por L<App::dozo>, que también puede usarse como un comando independiente. El comando C<dozo> admite el archivo de configuración C<.dozorc> para ajustes persistentes del contenedor.

Además, dado que se proporcionan makefiles para varios estilos de documentos, es posible la traducción a otros idiomas sin especificaciones especiales. Usa la opción C<-M>.

También puedes combinar las opciones Docker y C<make> para poder ejecutar C<make> en un entorno Docker.

Ejecutar como C<xlate -C> iniciará una shell con el repositorio git de trabajo actual montado.

Lee el artículo en japonés en la sección L</SEE ALSO> para más detalles.

=head1 EMACS

Carga el archivo F<xlate.el> incluido en el repositorio para usar el comando C<xlate> desde el editor Emacs. La función C<xlate-region> traduce la región indicada. El idioma predeterminado es C<EN-US> y puedes especificar el idioma invocándola con...

=for html <p>
<img width="750" src="https://raw.githubusercontent.com/kaz-utashiro/App-Greple-xlate/main/images/emacs.png">
</p>

=head1 ENVIRONMENT

=over 7

=item DEEPL_AUTH_KEY

Configura tu clave de autenticación para el servicio DeepL.

=item OPENAI_API_KEY

Clave de autenticación de OpenAI, utilizada por los motores heredados B<gpty>. El motor B<gpt5> basado en C<llm> también lee esta variable, pero las claves almacenadas con C<llm keys set openai> también funcionan.

=item GREPLE_XLATE_CACHE

Configura la estrategia de caché predeterminada (consulta L</CACHE OPTIONS>).

=back

=head1 INSTALL

=head2 CPANMINUS

    $ cpanm App::Greple::xlate

=head2 TOOLS

Instala la herramienta de línea de comandos para el motor que uses: C<llm> para el motor B<gpt5>, C<deepl> para DeepL, C<gpty> para los motores GPT heredados.

L<https://llm.datasette.io/>

L<https://github.com/DeepLcom/deepl-python>

L<https://github.com/tecolicom/App-gpty>

=head1 SEE ALSO

=head2 MODULES

L<App::Greple::xlate::llm>, L<App::Greple::xlate::deepl>

L<App::dozo> - Ejecutor genérico de Docker utilizado por xlate para operaciones de contenedor

=head2 RELATED MODULES

=over 2

=item * L<App::Greple>

Consulta el manual B<greple> para más detalles sobre el patrón de texto objetivo. Usa las opciones B<--inside>, B<--outside>, B<--include>, B<--exclude> para limitar el área de coincidencia.

=item * L<App::Greple::update>

Puedes usar el módulo C<-Mupdate> para modificar archivos con el resultado del comando B<greple>.

=item * L<App::sdif>

Usa B<sdif> para mostrar el formato de marcador de conflicto junto con la opción B<-V>.