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
Copy file name to clipboardExpand all lines: docs/faqs/app-translation.md
+53-7Lines changed: 53 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -32,19 +32,46 @@ For the *Loop* app and the submodules (Pumps, CGM and Services) associated with
32
32
!!! note "Want to Sign Up to Translate?"
33
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
34
35
+
If you want to be translate for one of the new CGM / Pump repositories, include that information as well. This includes DanaKit, EversenseKit and MedtrumKit. Those new repositories are handled using a [*crowdin* project](#crowdin-projects) for each repository.
36
+
35
37
36
38
## Code Translation
37
39
38
40
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*).
39
41
40
42
If you notice *Loop* app messages in English even though you selected a specific language, and you can help translate it, please volunteer.
41
43
42
-
Translations for Loop are performed by volunteers at [*lokalise*](https://app.lokalise.com/projects).
44
+
### Loop *lokalise* project
45
+
46
+
Translations for most of the repositories used by Loop are performed by volunteers at [*lokalise*](https://app.lokalise.com/projects).
47
+
48
+
Some newer CGM and Pump modules, currently found in feature branches, get their translations from *crowdin* instead of *lokalise*.
49
+
50
+
* There was an early attempt to use both *lokalise* and *crowdin* but merging input from two sources was deemed impractical
51
+
* The DanaKit, MedtrumKit and EversenseKit translations are each handled by separate [*crowdin* projects](#crowdin-projects)
52
+
53
+
### *crowdin* projects
54
+
55
+
Some new pump and CGM modules are provided by developers associated with the *Trio* (*OpenAPS*) community. They have an established base of translators who are familiar with using *crowdin*. Translations for each of these new repositories is handled directly at the repository level. Loop translators who want to help with these repositories can just add that information to the request when they [volunteer to translate](#volunteer-to-translate).
43
56
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.
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. Indicate whether you need access to the new repositories (*crowdin*) in addition to the Loop repositories. You will get an invitation to join the Loop *lokalise* 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.
45
64
46
65
> 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).
47
66
67
+
Alternative contacts for addtion to *crowdin*:
68
+
69
+
* Bastiaan Verhaar in zulipchat
70
+
* Bastiaan is known as `INeedSugar` in [Trio discord](https://discord.gg/FnwFEFUwXE) and [iAPS discord](https://discord.com/invite/ptkk2Y264Z)
71
+
*`lubor` in [iAPS discord](https://discord.com/invite/ptkk2Y264Z)
72
+
73
+
## Lokalise Information
74
+
48
75
### Initial Screen on *lokalise*
49
76
50
77
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.
@@ -94,7 +121,7 @@ If a `key` does not have a translation in a given language, then when running th
94
121
95
122
### Select a Submodule
96
123
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*.
124
+
Suppose you know that you want to modify translations for a particular submodule (CGM, Pump or Service module). You can choose context in *lokalise*; or if it is one of the newer submodules, go directly to the *crowdin* project for that submodule. See [Submodule Table for Multiple Apps](#submodule-table-for-multiple-apps) for a detailed listing.
98
125
99
126
* Tap on Filter
100
127
* Tap on Context
@@ -106,12 +133,14 @@ Suppose you know that you want to modify translations for a particular submodule
106
133
107
134
The screenshot below is configured for someone translating simplified Chinese for the DanaKit pump.
108
135
136
+
**NOTE** The DanaKit keys are no longer visible in *lokalise*. They are being handled using [*crowdin*](#crowdin-projects).
137
+
109
138
{width="1024"}
110
139
{align="center"}
111
140
112
141
#### Submodule Table for Multiple Apps
113
142
114
-
These submodules are used by the *Loop*, *Trio* and *iAPS* apps.
143
+
These submodules are used by the *Loop*, *Trio* and *iAPS* apps and are handled by *lokalise*.
115
144
116
145
| Type | <divstyle="width:145px"></div> Name | Files |
117
146
|:-:|:--|:--|
@@ -120,15 +149,31 @@ These submodules are used by the *Loop*, *Trio* and *iAPS* apps.
| Service |`TidepoolService`| TidepoolService/TidepoolServiceKit/Localizable.xcstrings<br>TidepoolService/TidepoolServiceKitUI/Localizable.xcstrings |
131
158
159
+
160
+
These submodules are used by the *Loop*, *Trio* and *iAPS* apps and are handled by *crowdin*.
161
+
162
+
| Type | <divstyle="width:145px"></div> Name | Files |
163
+
|:-:|:--|:--|
164
+
| Pump |`DanaKit`| see [DanaKit *crowdin*](https://crowdin.com/project/danakit)|
165
+
| Pump |`MedtrumKit`| see [MedtrumKit *crowdin*](https://crowdin.com/project/medtrumkit)|
166
+
| CGM |`EversenseKit`| crowdin project is not yet configured |
167
+
168
+
The modules are specific to the particular app:
169
+
170
+
| Type | <divstyle="width:145px"></div> Name | Files |
171
+
|:-:|:--|:--|
172
+
| Loop |`Loop`| use [Loop *lokalise*](https://app.lokalise.com/projects)|
173
+
| Trio |`Trio`| use [Trio *crowdin*](https://crowdin.com/project/trio)|
174
+
| iAPS |`iAPS`| use [iAPS *crowdsin*](https://crowdin.com/project/iaps)|
175
+
176
+
132
177
### Matches Source
133
178
134
179
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.
@@ -173,7 +218,8 @@ The *Trio* and the *iAPS* apps use submodules for CGM, Pump and Service features
173
218
174
219
The bottom line is
175
220
176
-
* Submodule translations are handled at [*lokalise*](https://app.lokalise.com/)
221
+
* Loop and older (pre 2025) submodule translations are handled at [*lokalise*](https://app.lokalise.com/)
222
+
* New submodules, DanaKit, EversenseKit, and MedtrumKit. are currently handled in [*crowdin* projects](#crowdin-projects) for the individual repositories
177
223
**Trio* translations are handled at [crowdin for *Trio*](https://crowdin.com/project/trio/invite/public?h=48e1a77abd1611860f475c1ce17540112591650&show_welcome)
178
224
**iAPS* translations are handled at [crowdin for *iAPS*](https://crowdin.com/project/iaps)
0 commit comments