Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
TeXworks uses the standard Qt mechanisms to support translating the user interface into other languages than the default (built-in) English. This page is intended to help translators get started. For more details, see the Qt Linguist documentation (included in Qt Assistant), which you should have if you've installed a current version of Qt.
In brief, to provide a translation for a particular language, you need to
- use the
lupdatetool to create
.tsfiles for TeXworks itself and the QtPDF library;
.tsfiles are XML files containing all the text strings from the user interface;
- use Linguist to edit these files, adding the translation for each string;
- use Linguist or
lreleaseto compile the
.qmfiles that can be loaded at runtime; and
- put the
.qmfiles into the TeXworks
A little more detail
Translation files are named with a two-letter language code such as "de" (German), "fr" (French), etc., following the conventions for locale names. A country code can be added where there are variations between different languages (e.g., "en_US" versus "en_GB"), but in most cases it should not be necessary to make such distinctions.
In the TeXworks source code, translations live in several directories:
transcontains the translations belonging to the core of TeXworks
modules/QtPDF/transcontains the translations belonging to QtPDF, the library responsible for handling
In the following, we will describe how to deal with the TeXworks core translations. Translating other parts should work analogously.
To create a new
.ts file for a particular language, run
lupdate on the
TeXworks_trans.pro file (in the
trans directory), and specify the
.ts file to be created. We'll use German as an example:
cd trans lupdate TeXworks_trans.pro -ts TeXworks_de.ts
The same command is used to update the
.ts file when there are changes in the TeXworks source. This allows you to keep all your existing translation work, and just add or modify strings for any changed parts of the user interface.
Use Qt Linguist to edit the
.ts file, adding translations. Note that Linguist can show the source code where the string is used, which may be helpful in understanding the context if it is not immediately clear. It also "remembers" your translations, so that if the same string occurs again, it can suggest the same translation.
Finally, use the File/Release command within Linguist to generate a compiled
.qm file (or use the
lrelease command-line tool). Note that you can do this at any stage; if you have not translated all the strings, the original English will be used for those that are missing. So you can try out your work before finishing it all.
For your translation to be loaded by TeXworks, you need to put the
.qm file in the
translations folder (in the TeXworks resources folder, alongside others such as templates and completion files); then re-start the TeXworks application.
Once you are satisfied with your work we'd be happy to include it in TeXworks. You can create a pull request on GitHub, link the .ts file to a new issue, or send it to the mailing list to let us know of your contribution.