Creating translation files
Most of the text to translate in an application consists of either single words or short phrases. These typically appear as window titles, menu items, tooltips, and labels to buttons, check boxes, and radio buttons.
Developers mark the phrases as translatable in the QML and C++ source code. The Qt tools provide context information for each of the phrases to help the translator understand their meaning. The developer can add comments to the phrases.
Translation files consist of all the user-visible text and Ctrl key shortcuts in an application and translations of that text.
To create translation files:
lupdateto generate the first set of translation source (TS) files with all the user-visible text but no translations.
- Give the TS files to translators who add translations using Qt Linguist. Qt Linguist indicates changed and deleted source text.
lupdateto incorporate any new text added to the application.
lupdatesynchronizes the user-visible text from the application with the translations. It does not destroy any data.
lreleaseto read the TS files and produce the QM files used by the application at runtime.
lupdate to work successfully, it must know which translation files to produce. Specify the files in the application's Qt project file.
When building with CMake, you use CMake commands to add targets that create or update TS files and transform them into QM files. The translation files are generated when you build the targets.
© 2023 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.