view release on metacpan or  search on metacpan

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

Puede recuperar solo el texto japonés con el comando B<unifdef>:

    unifdef -UORIGINAL -DJA foo.ja.pm

=item B<space>

=item B<space+>

El texto original y el convertido se imprimen separados por una sola línea en blanco. Para C<space+>, también se imprime una nueva línea después del texto convertido.

=item B<xtxt>

Si el formato es C<xtxt> (texto traducido) o desconocido, solo se imprime el texto traducido.

=back

=item B<--xlate-maxlen>=I<chars> (Default: 0)

Especifique la longitud máxima del texto que se enviará a la API de una vez. El valor predeterminado 0 significa el límite propio del motor: para el servicio de cuenta gratuita de DeepL, es 128K para la API (B<--xlate>) y 5000 para la interfaz del...

=item B<--xlate-maxline>=I<n> (Default: 0)

Especifique el número máximo de líneas de texto que se enviarán a la API de una vez.

Establezca este valor en 1 si desea traducir una línea a la vez. Esta opción tiene prioridad sobre la opción C<--xlate-maxlen>.

=item B<--xlate-prompt>=I<text>

Especifique un prompt personalizado para enviarlo al motor de traducción. Esta opción está disponible para los motores LLM (C<gpt3>, C<gpt4o>, C<gpt5>), pero no para DeepL. Puede personalizar el comportamiento de la traducción proporcionando inst...

=item B<--xlate-context>=I<text>

Especifique información de contexto adicional que se enviará al motor de traducción. Esta opción se puede usar varias veces para proporcionar múltiples cadenas de contexto. La información de contexto ayuda al motor de traducción a comprender e...

=item B<--xlate-context-window>=I<n>

(Context-aware engines only, e.g. C<gpt5> on the llm backend)
Número de bloques traducidos circundantes que se pasan como contexto de referencia al volver a traducir bloques modificados (predeterminado 2). El contexto también incluye el texto fuente sin procesar alrededor de la región modificada (encabezados...

=item B<--xlate-cache-seed>=I<file>

Inicialice la caché de un documento nuevo a partir del archivo de caché de otro documento. Útil para informes periódicos: inicialice la caché del nuevo número con la del número anterior, de modo que los párrafos sin cambios no se vuelvan a tr...

=item B<--xlate-anonymize>=I<file>

Anonimice las cadenas sensibles antes de que se envíen a la API de traducción y restáurelas en la salida. El archivo de diccionario proporciona una entrada por elemento: en JSON (canónico, generable por máquina)

    [ { "category": "person",  "text": "山田太郎" },
      { "category": "company", "regex": "アクメ(株式会社)?" } ]

o en un formato de línea simple (C<category pattern>, C</.../> para regex). Cada elemento se reemplaza por una etiqueta de categoría como C<< <person id=1 /> >>; la misma cadena siempre obtiene la misma etiqueta, por lo que el modelo puede llevar l...

Un diccionario puede generarse mediante una herramienta externa; por ejemplo, un modelo local que extrae entidades sensibles:

    llm -m <local-model> \
        -s 'Extract sensitive entities as a JSON array of objects
            with "category" and "text" fields.' \
        < report.md > report.anon.json
    greple -Mxlate --xlate-anonymize=report.anon.json ...

Se tolera una BOM UTF-8 en el archivo. Los valores en el formato de línea de front matter pueden llevar un comentario final solo en su propia línea, no después del valor.

=item B<--xlate-anonymize-mark>[=I<regex>]

Recoja entradas de anonimización de marcas en línea en el propio documento. Marque la primera aparición como C<{{ person("山田太郎") }}> y cada aparición de la cadena en todo el documento se anonimizará. La marca en sí permanece en el orige...

Tenga en cuenta que, con una opción de valor opcional como esta, un argumento de archivo siguiente se tomaría como el valor: escriba C<--xlate-anonymize-mark=> (con un C<=> final) cuando use la notación predeterminada.

Se pueden configurar notaciones alternativas, por ejemplo C<< --xlate-anonymize-mark='@@(?<category>[a-z][a-z0-9_]*):(?<text>[^\n]+?)@@' >> para marcas de estilo C<@@person:NAME@@>, o una forma de comentario HTML que permanezca invisible en el Markdo...

=item B<--xlate-template>[=I<regex>]

Trate las expresiones de plantilla (predeterminado: Jinja2 C<{{ ... }}>, C<{% ... %}>, C<{# ... #}>) como marcadores de posición opacos: indique al modelo que las copie sin cambios y verifique, por bloque, que la respuesta contenga exactamente las m...

Tenga en cuenta que, con una opción de valor opcional como esta, un argumento de archivo siguiente se tomaría como el valor: escriba C<--xlate-template=> (con un C<=> final) al usar la notación predeterminada.

=item B<--xlate-frontmatter>

Trate un bloque inicial C<---> ... C<---> como front matter YAML: exclúyalo de la traducción y de los fragmentos de contexto de la fase 2, y agregue sus valores planos C<key: value> a las reglas de anonimización (categoría C<var>) como red de seg...

Deje siempre una línea en blanco después del C<---> de cierre. Con un patrón de coincidencia de estilo párrafo, el front matter que se une directamente al texto del cuerpo forma un bloque superpuesto que la exclusión no puede suprimir (en ese ca...

=item B<--xlate-glossary>=I<glossary>

Especifique un ID de glosario que se utilizará para la traducción. Esta opción solo está disponible al usar el motor de DeepL. El ID de glosario debe obtenerse de su cuenta de DeepL y garantiza una traducción coherente de términos específicos.

=item B<--xlate-dryrun>

No llame a la API de traducción; en su lugar, muestre, a través de la visualización de progreso, cada payload exactamente como se transmitiría (después de la anonimización y el enmascaramiento). Útil para comprobar qué sale de la máquina y p...

=item B<-->[B<no->]B<xlate-progress> (Default: True)

Vea el resultado de la traducción en tiempo real en la salida STDERR. El payload C<From> se muestra tal como se transmitió, después de la anonimización y el enmascaramiento.

=item B<--xlate-stripe>

Use el módulo L<App::Greple::stripe> para mostrar la parte coincidente con un estilo de rayas tipo cebra. Esto es útil cuando las partes coincidentes están conectadas consecutivamente.

La paleta de colores se cambia según el color de fondo de la terminal. Si desea especificarlo explícitamente, puede usar B<--xlate-stripe-light> o B<--xlate-stripe-dark>.

=item B<--xlate-mask>

Realice la función de enmascaramiento y muestre el texto convertido tal cual sin restauración.

=item B<--match-all>

Establezca todo el texto del archivo como área objetivo.

=item B<--lineify-cm>

=item B<--lineify-colon>

En el caso de los formatos C<cm> y C<colon>, la salida se divide y se formatea línea por línea. Por lo tanto, si solo se traduce una parte de una línea, no se puede obtener el resultado esperado. Estos filtros corrigen la salida que se corrompe al...

En la implementación actual, si se traducen múltiples partes de una línea, se generan como líneas independientes.

=back

=head1 CACHE OPTIONS

El módulo B<xlate> puede almacenar en caché el texto de la traducción para cada archivo y leerlo antes de la ejecución para eliminar la sobrecarga de consultar al servidor. Con la estrategia de caché predeterminada C<auto>, mantiene los datos de...