/usr/share/qt5/doc/qtlinguist/linguist-manager.html is in qttools5-doc-html 5.5.1-3build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 | <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- linguist-manual.qdoc -->
<title>Qt Linguist Manual: Release Manager | Qt Linguist Manual </title>
<link rel="stylesheet" type="text/css" href="style/offline.css" />
</head>
<body>
<div class="header" id="qtdocheader">
<div class="main">
<div class="main-rounded">
<div class="navigationbar">
<ul>
<li>Qt 5.5</li>
<li><a href="qtlinguist-index.html">Qt Linguist Manual</a></li>
<li>Qt Linguist Manual: Release Manager</li>
<li id="buildversion">Qt 5.5.1 Reference Documentation</li>
</ul>
</div>
</div>
<div class="content">
<div class="line">
<div class="content mainContent">
<link rel="prev" href="linguist-overview.html" />
<link rel="next" href="linguist-translators.html" />
<p class="naviNextPrevious headerNavi">
<a class="prevPage" href="linguist-overview.html">Overview of the Translation Process</a>
<a class="nextPage" href="linguist-translators.html">Qt Linguist Manual: Translators</a>
</p><p/>
<div class="sidebar">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#creating-translation-files">Creating Translation Files</a></li>
<li class="level1"><a href="#using-lupdate">Using lupdate</a></li>
<li class="level1"><a href="#using-lrelease">Using lrelease</a></li>
<li class="level1"><a href="#missing-translations">Missing Translations</a></li>
</ul>
</div>
<div class="sidebar-content" id="sidebar-content"></div></div>
<h1 class="title">Qt Linguist Manual: Release Manager</h1>
<span class="subtitle"></span>
<!-- $$$linguist-manager.html-description -->
<div class="descr"> <a name="details"></a>
<p>Two tools are provided for the release manager, lupdate and lrelease. These tools can process <a href="../qmake/qmake-manual.html">qmake</a> project files, or operate directly on the file system.</p>
<a name="creating-translation-files"></a>
<h2 id="creating-translation-files">Creating Translation Files</h2>
<p>Translation files consist of all the user-visible text and Ctrl key accelerators in an application and translations of that text.</p>
<p>To create translation files:</p>
<ol class="1">
<li>Run lupdate to generate the first set of translation source (TS) files with all the user-visible text but no translations.</li>
<li>Give the TS files to the translator who adds translations using <i>Qt Linguist</i>. <i>Qt Linguist</i> takes care of any changed or deleted source text.</li>
<li>Run lupdate to incorporate any new text added to the application. lupdate synchronizes the user-visible text from the application with the translations. It does not destroy any data.</li>
<li>To release the application, run lrelease to read the TS files and produce the QM files used by the application at runtime.</li>
</ol>
<p>For lupdate to work successfully, it must know which translation files to produce. The files are listed in the application's <code>.pro</code> Qt project file.</p>
<a name="using-lupdate"></a>
<h2 id="using-lupdate">Using lupdate</h2>
<p>Usage: <code>lupdate myproject.pro</code></p>
<p>The lupdate command line tool finds the translatable strings in the specified source, header and <i>Qt Designer</i> interface files, and produces or updates <code>.ts</code> translation files. The files to process and the files to update can be set at the command line, or provided in a <code>.pro</code> file specified as an command line argument. The developer creates the .pro file, as described in <a href="linguist-programmers.html">Qt Linguist Manual: Developers</a>.</p>
<p>The produced translation files are given to the translator who uses <i>Qt Linguist</i> to read the files and insert the translations.</p>
<p>Companies that have their own translators in-house may find it useful to run lupdate regularly, perhaps monthly, as the application develops. This will lead to a fairly low volume of translation work spread evenly over the life of the project and will allow the translators to support a number of projects simultaneously.</p>
<p>Companies that hire in translators as required may prefer to run lupdate only a few times during the application life cycle. The first time might be just before the first test phase. This will provide the translator with a substantial single block of work and any bugs that the translator detects may easily be included with those found during the initial test phase. The second and any subsequent lupdate runs would probably take place during the final beta phase.</p>
<p>The TS file format is a simple human-readable XML format that can be used with version control systems if required. <code>lupdate</code> can also process Localization Interchange File Format (XLIFF) format files; files in this format typically have file names that end with the <code>.xlf</code> suffix.</p>
<p><b>Note: </b>The minimum supported version for XLIFF format files is 1.1. XLIFF 1.0 version files are not supported.</p><p>Pass the <code>-help</code> option to <code>lupdate</code> to view supported options.</p>
<p><i>Qt Linguist</i> is also able to import and export XLIFF files. See the <a href="linguist-translators.html">Translators</a> section for more information.</p>
<a name="using-lrelease"></a>
<h2 id="using-lrelease">Using lrelease</h2>
<p>Usage: <code>lrelease myproject.pro</code></p>
<p>The lrelease command line tool produces QM files out of TS files. The QM file format is a compact binary format that is used by the localized application. It provides extremely fast lookups for translations. The TS files lrelease processes can be specified at the command line, or given indirectly by a Qt <code>.pro</code> project file.</p>
<p>This tool is run whenever a release of the application is to be made, from initial test version through to final release version. If the QM files are not created, for example because an alpha release is required before any translation has been undertaken, the application will run perfectly well using the text the developers placed in the source files. Once the QM files are available the application will detect them and use them automatically.</p>
<p><b>Note: </b>The lrelease tool only incorporates translations that are marked as "finished". Otherwise the original text is used instead.</p><p>Pass the <code>-help</code> option to <code>lrelease</code> to view supported options.</p>
<a name="missing-translations"></a>
<h2 id="missing-translations">Missing Translations</h2>
<p>Both lupdate and lrelease may be used with TS translation source files which are incomplete. Missing translations will be replaced with the native language phrases at runtime.</p>
</div>
<!-- @@@linguist-manager.html -->
<p class="naviNextPrevious footerNavi">
<a class="prevPage" href="linguist-overview.html">Overview of the Translation Process</a>
<a class="nextPage" href="linguist-translators.html">Qt Linguist Manual: Translators</a>
</p>
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2015 The Qt Company Ltd.
Documentation contributions included herein are the copyrights of
their respective owners.<br> The documentation provided herein is licensed under the terms of the <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation License version 1.3</a> as published by the Free Software Foundation.<br> 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. </p>
</div>
</body>
</html>
|