使用 lconvert

lconvert 命令行工具可过滤和转换翻译数据文件。

它支持以下文件格式

• pot - GNU Gettext 本地化模板文件
• qph -Qt Linguist 短语集
• ts - Qt 翻译源代码
• po - GNU Gettext 本地化文件
• qm - 编译的 Qt 翻译
• xlf - XLIFF 本地化文件

lconvert 语法

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

其中

• options 指一个或多个lconvert 选项。
• infile 是一个输入文件。可以指定多个输入文件。

如果指定多个输入文件，它们将被合并，并优先使用后面文件中的翻译。

要查看最新的lconvert 帮助，请输入

lconvert -help

lconvert options

示例

将 TS 文件转换为 XLIFF

要将单个 TS 文件转换为 XLIFF，请在终端运行以下命令：

lconvert -o myapp_de.xlf myapp_de.ts

合并多个 QM 文件

以下命令将多个 QM 文件合并为full_de.qm ：

lconvert -o full_de.qm qtbase_de.qm myapp_de.qm mylib_de.qm

在 CMake 中使用 lconvert

要在配置或构建 CMake 项目时调用lconvert ，请加载Qt6LinguistTools 软件包，并使用$<TARGET_FILE_NAME:Qt6::lconvert> 查找lconvert 可执行文件。

下面的示例添加了一个自定义目标xlf_de ，可将单个 TS 文件转换为 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"
)

PO 格式特定选项

转换为 PO 格式时，可以通过在po-flags 额外元数据字段中设置no-wrap 标志来禁用自动换行。默认情况下，长度超过 79 个字符的行会被换行。在源代码中使用//~ 元字符串设置该字段（例如//~ po-flags no-wrap ），或直接在 TS 文件中使用<extra-po-flags> 元素设置该字段。

在 TS 和 PO 格式之间转换时，会保留其他 PO 标志（请参阅GNU gettext 文档），但不会影响lconvert 处理。