En esta página

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 Gettext
  • qph - Libro de frases de Qt Linguist
  • ts - Fuentes de traducción de Qt
  • po - Archivos de localización de GNU Gettext
  • qm - Traducciones compiladas de Qt
  • xlf - Archivos de localización XLIFF

Sintaxis de lconvert

lconvert [options] <infile> [<infile>...]

Donde:

  • options significa una o varias opciones de lconvert.
  • infile es 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 -help

opciones de lconvert

OpciónAcció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-translationsElimina 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-obsoleteOmite los mensajes obsoletos.
-no-finishedOmite los mensajes completados.
-no-untranslatedOmite los mensajes sin traducir.
-sort-contextsOrdenar los contextos en el archivo de salida « TS » por orden alfabético.
-sort-messagesOrdena 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-linesOmite los números de línea de las referencias a los archivos « UI ».
-pluralonlyOmitir los mensajes que no estén en plural.
-verboseExplica 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.ts

Combinar 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.qm

Uso 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.