En esta página

Uso de ltext2id

La herramienta de línea de comandos « ltext2id » convierte un proyecto que utiliza traducciones basadas en texto para que utilice traducciones basadas en ID. Analiza el árbol del proyecto, actualiza el código fuente para que llame a las API de traducción basadas en ID y ajusta los archivos « TS » correspondientes en consecuencia. En caso de que se produzca algún error en la conversión, el código fuente se anotará con « //ltext2id error: » en los puntos donde se haya producido el error.

Nota: Realiza una copia de seguridad completa (o trabaja en una rama de Git limpia) antes de ejecutar « ltext2id ». La herramienta modifica los archivos fuente y los archivos « TS » in situ.

Para obtener los mejores resultados, incluye tanto los archivos fuente como los archivos « TS » en la raíz del proyecto que pases a la herramienta, de modo que las actualizaciones se mantengan coherentes entre el código y las traducciones.

Sintaxis de ltext2id

ltext2id [options] [project-root]

Donde:

  • options significa una o varias opciones de ltext2id.
  • project-root es el directorio que se va a procesar de forma recursiva.

Para consultar la ayuda más reciente, escribe:

ltext2id -help

opciones de ltext2id

OpciónAcción
-helpMuestra información de ayuda actualizada y sale.
-no-labelsNo generar etiquetas para las traducciones basadas en ID. Por defecto, se utilizan los contextos de los mensajes como etiquetas para que las entradas mantengan una visualización similar en Qt Linguist.
-sort-messagesOrdenar alfabéticamente los mensajes de un contexto en los archivos TS.
-source-utf16Tratar los archivos fuente como codificados en UTF-16 (por defecto: falso).
-quietOmitir la salida de progreso.
-only-meta-idSugerir ID únicamente mediante la inserción de meta-cadenas; no realizar la transformación real a llamadas basadas en ID.
-no-auto-idNo generar automáticamente ID cuando falten los ID de meta-cadenas. Se ignoran las llamadas a funciones de traducción sin meta-ID.
-versionMostrar la versión de ltext2id y salir.

Ejemplos

Convertir un proyecto a traducciones basadas en identificadores

Ejecuta la herramienta en la raíz del proyecto. El código fuente y los archivos « TS » que se encuentran en ese directorio se actualizan in situ.

ltext2id path/to/project

Generar solo sugerencias de ID (sin cambios en el código)

Utiliza -only-meta-id para insertar sugerencias de ID mediante metacadenas sin reescribir las llamadas a la API basada en ID. Como resultado, las llamadas de traducción se anotan con la metacadena «//~ meta-id <id>» (cpp), que especifica los ID sugeridos (meta-ID).

ltext2id -only-meta-id path/to/project

Desactivar la generación de etiquetas

Evita la generación de etiquetas si no deseas que los contextos se reflejen como etiquetas en Qt Linguist:

ltext2id -no-labels path/to/project

Evita los identificadores generados automáticamente

Omite la generación automática para las llamadas a las que les falte el meta-ID, es decir, los ID ya especificados mediante la cadena meta «//~ meta-id <id>» (cpp):

ltext2id -no-auto-id path/to/project

Trabaja con archivos fuente en UTF-16

Si tus fuentes están codificadas en UTF-16, activa la opción:

ltext2id -source-utf16 path/to/project

Estado de salida

ltext2id devuelve un código de salida distinto de cero en caso de error (por ejemplo, cuando se produce un error irrecuperable durante la transformación de los archivos). Revisa las anotaciones de las fuentes in situ marcadas con « //ltext2id error: » para solucionar los problemas restantes.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.