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:
optionssignifica una o varias opciones de ltext2id.project-rootes el directorio que se va a procesar de forma recursiva.
Para consultar la ayuda más reciente, escribe:
ltext2id -helpopciones de ltext2id
| Opción | Acción |
|---|---|
-help | Muestra información de ayuda actualizada y sale. |
-no-labels | No 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-messages | Ordenar alfabéticamente los mensajes de un contexto en los archivos TS. |
-source-utf16 | Tratar los archivos fuente como codificados en UTF-16 (por defecto: falso). |
-quiet | Omitir la salida de progreso. |
-only-meta-id | Sugerir ID únicamente mediante la inserción de meta-cadenas; no realizar la transformación real a llamadas basadas en ID. |
-no-auto-id | No generar automáticamente ID cuando falten los ID de meta-cadenas. Se ignoran las llamadas a funciones de traducción sin meta-ID. |
-version | Mostrar 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/projectGenerar 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/projectDesactivar 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/projectEvita 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/projectTrabaja con archivos fuente en UTF-16
Si tus fuentes están codificadas en UTF-16, activa la opción:
ltext2id -source-utf16 path/to/projectEstado 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.