Uso de lconvert
La herramienta de línea de comandos lconvert filtra y convierte archivos de datos de traducción.
Es compatible con los siguientes formatos de archivo:
pot- Archivos de plantillas de localización de GNU Gettextqph- Libro de frases de Qt Linguistts- Fuentes de traducción de Qtpo- Archivos de localización de GNU Gettextqm- Traducciones compiladas de Qtxlf- Archivos de localización XLIFF
Sintaxis de lconvert
lconvert [options] <infile> [<infile>...]Donde:
optionssignifica una o varias opciones de lconvert.infilees un archivo de entrada. Se pueden especificar varios archivos de entrada.
Si se especifican varios archivos de entrada, estos se fusionan, teniendo prioridad las traducciones de los archivos más recientes.
Para consultar la ayuda más reciente de « lconvert », escribe:
lconvert -helpopciones de lconvert
| Opción | Acción |
|---|---|
-h -help | Display up-to-date help information and exit. |
-i <infile> -input-file <infile> | Specify an input file. Use this option if <infile> starts with a dash. Use this option several times to merge inputs. May be - (standard input) for use in a pipe. |
-o <outfile> -output-file <outfile> | Specify an output file. Default is - (standard output). |
-if <informat> -input-format <format> | Specify input format for subsequent input files. The format is auto-detected from the file name and defaults to ts. |
-of <outformat> -output-format <outformat> | Specify output format. See -if. |
-drop-tags <regexp> | Omite las etiquetas adicionales con nombre al escribir archivos de tipo « TS » o « XLIFF ». Puedes especificar esta opción varias veces. |
-drop-translations | Elimina las traducciones existentes y restablece el estado a « unfinished ». Esto implica « --no-obsolete ». |
-source-language <language>[_<region>] | Especifica o anula el idioma de las cadenas de origen. El valor por defecto es POSIX si no se especifica y el archivo aún no lo indica. |
-target-language <language>[_<region>] | Especifica o sobrescribe el idioma de la traducción. Por defecto, el idioma de destino se lee del contenido del archivo o se deduce a partir del nombre del archivo. |
-no-obsolete | Omite los mensajes obsoletos. |
-no-finished | Omite los mensajes completados. |
-no-untranslated | Omite los mensajes sin traducir. |
-sort-contexts | Ordenar los contextos en el archivo de salida « TS » por orden alfabético. |
-sort-messages | Ordena alfabéticamente los mensajes de un contexto en los archivos ` TS `. |
-locations {absolute|relative|none} | Anular la forma en que se guardan las referencias al código fuente en los archivos « TS ». El valor por defecto es « absolute ». |
-no-ui-lines | Omite los números de línea de las referencias a los archivos « UI ». |
-pluralonly | Omitir los mensajes que no estén en plural. |
-verbose | Explica lo que se está haciendo. |
Ejemplos
Convertir un archivo TS a XLIFF
Para convertir un único archivo TS a XLIFF, ejecuta el siguiente comando en la terminal:
lconvert -o myapp_de.xlf myapp_de.tsCombinar varios archivos QM
El siguiente comando fusiona varios archivos QM en un full_de.qm:
lconvert -o full_de.qm qtbase_de.qm myapp_de.qm mylib_de.qmUso de lconvert con CMake
Para llamar a lconvert al configurar o compilar tu proyecto CMake, carga el paquete Qt6LinguistTools y utiliza $<TARGET_FILE_NAME:Qt6::lconvert> para localizar el ejecutable lconvert.
El siguiente ejemplo añade un objetivo personalizado xlf_de que convierte un único archivo TS a XLIFF.
find_package(Qt6 REQUIRED COMPONENTS LinguistTools)
add_custom_command(
OUTPUT myapp_de.xlf
COMMAND $<TARGET_FILE:Qt6::lconvert> -o myapp_de.xlf myapp_de.ts
DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/myapp_de.ts"
VERBATIM
)
add_custom_target(xlf_de
DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/myapp_de.xlf"
)Opciones específicas del formato PO
Al convertir al formato PO, puedes desactivar el ajuste automático de líneas configurando el indicador « no-wrap » en el campo de metadatos adicional « po-flags ». Por defecto, las líneas de más de 79 caracteres se ajustan. Configura este campo en el código fuente utilizando la metacadena «//~» (por ejemplo, « //~ po-flags no-wrap ») o directamente en los archivos TS utilizando el elemento « <extra-po-flags> ».
El resto de indicadores PO (véase la documentación de GNU gettext) se conservan al convertir entre los formatos TS y PO, pero no afectan al procesamiento de « lconvert ».
Nota: Los metadatos de po-flags solo se conservan al convertir directamente del formato TS al PO.
© 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.