Update libgit2
[TortoiseGit.git] / Languages / README.txt
blobc398438a36f7d9b4914d0f6673a9078430f143b8
1 Translations\r
2 ============\r
3 \r
4 TortoiseGit is still in development so translations of all resources is\r
5 also a work 'in progress'.\r
6 \r
7 General\r
8 -------\r
9 The TortoiseGit project uses the web-based Transifex platform for\r
10 managing translations:\r
11 https://www.transifex.com/projects/p/tortoisegit/\r
13 This should make it easier for new translators to get started. If you\r
14 want to help to translate TortoiseGit, please register an account a\r
15 transifex.com (you can also login using your google account), then\r
16 request membership of one of our translation teams or request to create\r
17 a new team, if your language is not yet listed. If you want to\r
18 translate into a language that has different locales and you *really*\r
19 need the second locale, add the two letter ISO-3166 locale code. If\r
20 you're not sure about your country code, look here:\r
21 http://www.iso.ch/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/list-en1.html.\r
22 Please keep in mind that we would like to have as few translations as\r
23 possible that cover as many languages as possible (in order to reduce\r
24 the work needed for keeping all translations up to date).\r
26 For most (unlisted) languages you do not need to start all over. A large\r
27 amount of translated strings can be reused from the TortoiseSVN project:\r
28 Just request a new language team and contact the TortoiseGit developers!\r
30 What now?\r
31 ---------\r
32 That's all you have to do. We'll take care of creating the resource\r
33 dlls and installers for the different language packs.\r
35 Our goal is to provide language packs starting with the next releases\r
36 as soon as more than 50 % of the strings are translated on the offical\r
37 TortoiseGit download page (https://tortoisegit.org/download).\r
39 Technical details\r
40 -----------------\r
41 The TortoiseGit project uses gettext PO (portable object) files for its\r
42 translation. PO files are plain text, so you can even translate using a\r
43 normal text editor. The only thing you have to take care of is that the\r
44 editor can handle the UTF-8 charset. There is a wide range of specialized\r
45 tools out there that can handle and manipulate PO files (such as poEdit,\r
46 http://poedit.sourceforge.net).\r
48 You can also create your personal translations. Just use the\r
49 "Languages/Tortoise.pot" file as a template for your own "Tortoise_CC.po"\r
50 file and start translating it.\r
52 Building your own dlls\r
53 ----------------------\r
54 If you want to test the translations you made yourself, you need three things:\r
56 - The "raw" resource dlls for your version of TortoiseGit. Other dlls\r
57   won't work. The TortoiseGit teams provides those for every stable release.\r
58   You can find them in the release folder on https://download.tortoisegit.org/tgit/\r
59   named "TortoiseGit-LanguageDlls-X.X.X.X-(32|64)bit.7z" (you might need 7-Zip for unpacking)\r
60 - A po file containing the translations for your language.\r
61 - The ResText utility that is used to insert the data from the po file\r
62   into your resource dlls. This tool is also included in the archive in which the "raw"\r
63   resource dlls are included.\r
65 Once you got all needed files, you run:\r
67     restext apply TortoiseProcLang.dll TortoiseProcNNNN.dll Tortoise_CC.po\r
68     restext apply TortoiseMergeLang.dll TortoiseMergeNNNN.dll Tortoise_CC.po\r
69     restext apply TortoiseIDiffLang.dll TortoiseIDiffNNNN.dll Tortoise_CC.po\r
70     restext apply TortoiseGitUDiffLang.dll TortoiseGitUDiffNNNN.dll Tortoise_CC.po\r
71     restext apply TortoiseGitBlameLang.dll TortoiseGitBlameNNNN.dll Tortoise_CC.po\r
73 where NNNN is your four digit country code (1031 for germany)\r
74 and CC is your 2 letter country code (de for germany)\r
76 You can find the four digit country code at\r
77 https://msdn.microsoft.com/goglobal/bb964664.aspx\r
78 under the column LCID dec.\r
80 After successfully creating your dlls, copy them into\r
81 "C:\Program Files\TortoiseGit\Languages".\r
82 Now you should be able to select your language from the combobox on the\r
83 TortoiseGit main setting page.\r