You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* If you want to view your app on your phone in a different language, instructions are found at [Translated App on the Phone](#translated-app-on-the-phone).
6
6
7
-
* If you want to help provide translations for everyone to use on their phones, please click on [Code Translation](#code-translation).
7
+
* If you want to help provide translations for everyone to use on their phone with their app (*Loop*, *Trio*, or *iAPS*), please click on [Code Translation](#code-translation).
8
8
9
9
## Translated App on the Phone
10
10
11
11
You can select the language you want displayed for any given app in your phone settings.
12
12
13
-
If you have only one language on your phone, you will not see choices under the app settings. Click on the first link (for Apple instructions) to add language options to your phone.
13
+
If you have only one language on your phone, you will not see choices under the app settings. Click on the link below (for Apple instructions) to add language options to your phone.
14
14
15
15
*[Add more than one language to your phone](https://support.apple.com/en-us/109358)
16
16
@@ -29,6 +29,10 @@ If a given phrase in the app does not have a translation string in what is calle
29
29
30
30
For the *Loop* app and the submodules (Pumps, CGM and Services) associated with the *Loop* app, the [*lokalise*](https://app.lokalise.com/projects) website is used. You must be signed up with the *Loop* project to be able to see *Loop* translations at that site.
31
31
32
+
!!! note "Want to Sign Up to Translate?"
33
+
To volunteer to translate, join [Loop zulipchat](https://loop.zulipchat.com/) and send a direct message to Marion Barker with your email address and the language(s) you can translate.
34
+
35
+
32
36
## Code Translation
33
37
34
38
Localization (strings translated to the selected language in the app) makes use of volunteers who input translations in a special web app. Their work is then dowloaded and imported into the code used by the *Loop* app and its submodules (repositories on *GitHub*).
@@ -37,58 +41,149 @@ If you notice *Loop* app messages in English even though you selected a specific
37
41
38
42
Translations for Loop are performed by volunteers at [*lokalise*](https://app.lokalise.com/projects).
39
43
40
-
To volunteer, join [Loop zulipchat](https://loop.zulipchat.com/) and send a direct message to Marion Barker with your email address and the language(s) you can translate.
41
-
42
-
> If you are using the *Trio* or *iAPS* app instead of the *Loop* app, you can still assist with pump, CGM and Tidepool module localization through *Loop**lokalise*. Some repositories from *Loop* are used by [*Trio* and *iAPS*](#what-about-other-ios-apps).
43
-
44
+
To volunteer, join [Loop zulipchat](https://loop.zulipchat.com/) and send a direct message to Marion Barker with your email address and the language(s) you can translate. You will get an invitation to join the project. You do not need to start a new project, start a free trial or sign up for anything special; just join the project you are invited to.
44
45
46
+
> If you are using the *Trio* or *iAPS* app instead of the *Loop* app, you can still assist with Pump, CGM and Tidepool module localization through *Loop**lokalise*. Some repositories from *Loop* are used by [*Trio* and *iAPS*](#what-about-other-ios-apps).
45
47
46
48
### Initial Screen on *lokalise*
47
49
48
-
When you log in to *lokalise*, you will see a screen similar to the screenshot below where the *Loop* icon is highlighted with a red rectangle. Tap on that icon to start translating.
50
+
When you log in to *lokalise*, you will see a screen similar to the screenshot below. Tap on the *Loop* icon, highlighted in the graphic with a red rectangle, to start translating.
49
51
50
52
{width="600"}
51
53
{align="center"}
52
54
53
-
After tapping on the *Loop* icon, you see the general translation tasks. (Your screen may look slightly different - some items may require more permissions that are standard.)
55
+
After tapping on the *Loop* icon, you see the general translation tasks. (Your screen may look different.)
54
56
57
+
On the left are `keys` with the English language showing. On the right is the translation for that `key` in the language you selected. Each `key` has one or more words. The statistics list the total number of keys and the total number of words.
55
58
56
-
{width="600"}
59
+
{width="600"}
57
60
{align="center"}
58
61
59
-
60
62
### How to Find Strings to Translate
61
63
62
-
Typically you would search for strings that are not translated.
64
+
You can search for:
65
+
66
+
* strings that are [not translated](#not-translated), which show up as Empty
67
+
* strings in a particular [submodule](#select-a-submodule) (for example - the Pump or CGM that you use)
68
+
* strings where the [English version was copied](#matches-source) to the translated field
69
+
* strings where you disagree with the translation
70
+
* some strings may have been automatically translated
71
+
* some translations may have a typographical error
72
+
73
+
### Not Translated
74
+
75
+
Strings that have not been translated can be selected by tapping on Filter and choosing Untranslated. An example graphic is shown before choosing untranslated keys. First tap on Filter than tap on Untranslated.
76
+
77
+
{width="900"}
78
+
{align="center"}
79
+
80
+
### Enter a Translation
63
81
64
-
### Untransalated
82
+
After tapping on an item that is empty or you want to modify, type your translation into the box on the right, where you see the words "enter translation here" in the graphic below.
65
83
66
-
### How to Select a Submodule
84
+
{width="900"}
85
+
{align="center"}
86
+
87
+
Notice the filename where that key is stored is indicated when you examine the details of a key. In the graphic above, the file `Loop/Loop/Localizable.xcstrings` is indicated.
88
+
89
+
The area under the key has a comment. This is something added in the code to explain the use of the key.
90
+
91
+
If a `key` does not have a translation in a given language, then when running the app, the English version is automatically provided. Do **not** tap on `Insert source`.
92
+
93
+
> The only reason to use `Insert source` would be if that `key` should always be identical to the English version and you want to avoid having that `key` show up when looking for untranslated keys.
94
+
95
+
### Select a Submodule
67
96
68
-
Suppose you know that you want to modify translations for the OmniBLE submodule (anything to do with the DASH pump). You can choose context as a translator in *lokalise*. The example screenshot is configured for someone translating simplified Chinese for the DanaKit pump.
97
+
Suppose you know that you want to modify translations for a particular submodule (CGM, Pump or Service module). You can choose context in *lokalise*.
69
98
70
-
{width="900"}
99
+
* Tap on Filter
100
+
* Tap on Context
101
+
* Choose the submodule file
102
+
* some submodules have multiple string catalogs (*.xcstrings)
103
+
* some items are old enough to have a few of the older string format (*.strings)
104
+
* You can ignore any file that includes "Info.plist"
105
+
* those strings do not need to be translated and the keys should be configured to be hidden from translators
106
+
107
+
The screenshot below is configured for someone translating simplified Chinese for the DanaKit pump.
108
+
109
+
{width="1024"}
71
110
{align="center"}
72
111
112
+
#### Submodule Table for Multiple Apps
113
+
114
+
These submodules are used by the *Loop*, *Trio* and *iAPS* apps.
115
+
116
+
| Type | <divstyle="width:145px"></div> Name | Files |
| Service |`TidepoolService`| TidepoolService/TidepoolServiceKit/Localizable.xcstrings<br>TidepoolService/TidepoolServiceKitUI/Localizable.xcstrings |
131
+
132
+
### Matches Source
133
+
134
+
Some of the String Catalogs have had the English version inserted in the translation field. This was done inadvertently. To find these instances in the language you are translating, set up a custom filter.
135
+
136
+
First click on Filter, then Customize (see red highlights in graphic below)
137
+
138
+
{width="900"}
139
+
{align="center"}
140
+
141
+
The next screen allows you to choose `Translation` in one drop-down and then `matches source` in the adjacent drop-down.
142
+
143
+
{width="900"}
144
+
{align="center"}
145
+
146
+
You can hit Appy or Save and Apply and give it a name so you can select the Name next time.
147
+
148
+
The screenshot below is after creating and naming a custom filter called `Translation Matches Source`.
149
+
150
+
{width="900"}
151
+
{align="center"}
152
+
153
+
154
+
### Find a String
155
+
156
+
If you observe a string you want to modify, you can type it in directly. The text you type in the search box can be all or part of a string, and in English or the language you are translating.
157
+
158
+
{width="900"}
159
+
{align="center"}
160
+
161
+
- - -
162
+
73
163
## What About Other iOS Apps
74
164
75
-
The *Trio* and the *iAPS* apps use code for CGM, pumps and services originally developed for the *Loop* app.
165
+
The *Trio* and the *iAPS* apps use submodules for CGM, Pump and Service features originally developed for the *Loop* app. New CGM and Pump modules are coming soon or already available. These are being configured for use with all these iOS apps.
76
166
77
167
* The shared code originally developed for the *Loop* app resides in the *GitHub**LoopKit* organization and is under the control of the *LoopKit* owners
78
-
* The *Trio* app has always used forks for these repositories so get their localizations for the CGM, pumps and services modules from *lokalise*
79
-
* The *iAPS* app initially used copies of the code - not connected to the *LoopKit* repositories - configured their own crowdin site for *iAPS* localization
168
+
* The *Trio* app has always used forks for these repositories so get their localizations for the CGM, Pump and Service modules from *lokalise*
169
+
* The *iAPS* app initially used copies of the code - not connected to the *LoopKit* repositories - and configured their own crowdin site for *iAPS* localization
80
170
* However, as improvements to the submodules evolved at *LoopKit*, the updates needed to be hand-edited and added to the *iAPS* copies
81
171
* In late 2025, *iAPS* started the transition to using forks from *LoopKit* instead of copies
82
-
* Some of the *iAPS* translations were imported into *lokalise*
172
+
* Some of the *iAPS* translations for CGM, Pump and Service submodules were imported into *lokalise* at this time
83
173
84
174
The bottom line is
85
175
86
176
* Submodule translations are handled at [*lokalise*](https://app.lokalise.com/)
87
-
**Trio* translations are handled at [crowdin for Trio]
177
+
**Trio* translations are handled at [crowdin for *Trio*](https://crowdin.com/project/trio/invite/public?h=48e1a77abd1611860f475c1ce17540112591650&show_welcome)
178
+
**iAPS* translations are handled at [crowdin for *iAPS*](https://crowdin.com/project/iaps)
179
+
180
+
You can use the *Trio* or *iAPS* discord server to volunteer to translate using *lokalise* by sending a direct message to Marion Barker if you are not a member of zulipchat.
181
+
182
+
- - -
183
+
184
+
## Adding Languages
88
185
186
+
We can add languages if a translator commits to take on that task.
89
187
90
-
* The *Trio* app and the *iAPS* apps each have their own translation sites
91
-
* Both of those apps have a crowdin site configured
92
-
* Initially *iAPS* used copies of some of the
188
+
At lokalise, the language must be added first before translators have access it to that language. Send a DM to Marion Barker with your request for a new language.
93
189
94
-
You can use the *Trio* or *iAPS* discord server to volunteer by sending a direct message to Marion if you are not a member of zulipchat.
0 commit comments