Skip to content

Commit cf832a5

Browse files
committed
Deploying to gh-pages from @ f94e744 🚀
1 parent 800f829 commit cf832a5

2 files changed

Lines changed: 30 additions & 74 deletions

File tree

faqs/app-translation/index.html

Lines changed: 29 additions & 73 deletions
Original file line numberDiff line numberDiff line change
@@ -4175,17 +4175,6 @@
41754175
</span>
41764176
</a>
41774177

4178-
</li>
4179-
4180-
<li class="md-nav__item">
4181-
<a href="#crowdin-projects" class="md-nav__link">
4182-
<span class="md-ellipsis">
4183-
4184-
crowdin projects
4185-
4186-
</span>
4187-
</a>
4188-
41894178
</li>
41904179

41914180
<li class="md-nav__item">
@@ -4561,17 +4550,6 @@
45614550
</span>
45624551
</a>
45634552

4564-
</li>
4565-
4566-
<li class="md-nav__item">
4567-
<a href="#crowdin-projects" class="md-nav__link">
4568-
<span class="md-ellipsis">
4569-
4570-
crowdin projects
4571-
4572-
</span>
4573-
</a>
4574-
45754553
</li>
45764554

45774555
<li class="md-nav__item">
@@ -4774,38 +4752,27 @@ <h2 id="translated-app-on-the-phone">Translated App on the Phone<a class="header
47744752
<div class="admonition note">
47754753
<p class="admonition-title">Want to Translate?</p>
47764754
<p>To volunteer to translate, join <a href="https://loop.zulipchat.com/"><abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr> zulipchat</a> and send a direct message to Marion Barker with your email address and the language(s) you can translate.</p>
4777-
<p>If you want translate one of the new <abbr title="continuous glucose monitor, wearable medical device that measures and reports glucose in interstitial fluid">CGM</abbr> / Pump repositories: DanaKit, EversenseKit and MedtrumKit, indicate that as well. Those new repositories are handled using a <a href="#crowdin-projects"><em>crowdin</em> project</a> for each <abbr title="contains project files and each file's revision history">repository</abbr>.</p>
47784755
</div>
4756+
<hr />
47794757
<h2 id="code-translation">Code Translation<a class="headerlink" href="#code-translation" title="Anchor link to this Header on this Page">&para;</a></h2>
47804758
<p>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 <em><abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr></em> app and its <abbr title="for Loop, submodules are repositories defined in the Workspace repository that are required to build the app">submodules</abbr> (repositories on <em><abbr title="an online service for storing repositories, accessible from a browser">GitHub</abbr></em>).</p>
47814759
<p>If you notice <em><abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr></em> app messages in English even though you selected a specific language, and you can help translate it, please volunteer.</p>
47824760
<h3 id="loop-lokalise-project"><abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr> <em>lokalise</em> project<a class="headerlink" href="#loop-lokalise-project" title="Anchor link to this Header on this Page">&para;</a></h3>
4783-
<p>Translations for most of the repositories used by <abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr> are performed by volunteers at <a href="https://app.lokalise.com/projects"><em>lokalise</em></a>.</p>
4784-
<p>Some newer <abbr title="continuous glucose monitor, wearable medical device that measures and reports glucose in interstitial fluid">CGM</abbr> and Pump modules, currently found in feature branches, get their translations from <em>crowdin</em> instead of <em>lokalise</em>.</p>
4761+
<p>Translations for the repositories used by <abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr> are performed by volunteers at <a href="https://app.lokalise.com/projects"><em>lokalise</em></a>.</p>
4762+
<p>Some newer <abbr title="continuous glucose monitor, wearable medical device that measures and reports glucose in interstitial fluid">CGM</abbr> and Pump modules, currently found in feature branches, were initially configured to get their translations from <em>crowdin</em> instead of <em>lokalise</em>.</p>
47854763
<ul>
4786-
<li>There was an early attempt to use both <em>lokalise</em> and <em>crowdin</em> but merging input from two sources was deemed impractical</li>
4787-
<li>The DanaKit, MedtrumKit and EversenseKit translations are each handled by separate <a href="#crowdin-projects"><em>crowdin</em> projects</a></li>
4764+
<li>There was an early attempt to use both <em>lokalise</em> and <em>crowdin</em> but merging input from two sources was deemed impractical<ul>
4765+
<li>Briefly, DanaKit, MedtrumKit and EversenseKit translations were handled by their separate <em>crowdin</em> projects</li>
47884766
</ul>
4789-
<h3 id="crowdin-projects"><em>crowdin</em> projects<a class="headerlink" href="#crowdin-projects" title="Anchor link to this Header on this Page">&para;</a></h3>
4790-
<p>Some new pump and <abbr title="continuous glucose monitor, wearable medical device that measures and reports glucose in interstitial fluid">CGM</abbr> modules are provided by developers associated with the <em>Trio</em> (<em>OpenAPS</em>) community. They have an established base of translators who are familiar with using <em>crowdin</em>. Translations for each of these new repositories is handled directly at the <abbr title="contains project files and each file's revision history">repository</abbr> level. <abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr> translators who want to help with these repositories can just add that information to the request when they <a href="#volunteer-to-translate">volunteer to translate</a>.</p>
4791-
<ul>
4792-
<li><a href="https://crowdin.com/project/danakit">DanaKit crowdin</a></li>
4793-
<li><a href="https://crowdin.com/project/medtrumkit">MedtrumKit crowdin</a></li>
4794-
<li>EversenseKit - not configured yet, coming soon</li>
4767+
</li>
4768+
<li>In the interest of efficiency and offloading responsibility from developers so they can develop, these have been returned to lokalise</li>
47954769
</ul>
47964770
<h3 id="volunteer-to-translate">Volunteer to Translate<a class="headerlink" href="#volunteer-to-translate" title="Anchor link to this Header on this Page">&para;</a></h3>
4797-
<p>To volunteer, join <a href="https://loop.zulipchat.com/"><abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr> zulipchat</a> 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 (<em>crowdin</em>) in addition to the <abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr> repositories. You will get an invitation to join the <abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr> <em>lokalise</em> project. You do not need to start a new <em>lokalise</em> project. Do not start a free <em>lokalise</em> trial or sign up for anything special; just join the project you are invited to.</p>
4771+
<p>To volunteer, join <a href="https://loop.zulipchat.com/"><abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr> zulipchat</a> 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 <abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr> <em>lokalise</em> project. You do not need to start a new <em>lokalise</em> project. Do not start a free <em>lokalise</em> trial or sign up for anything special; just join the project you are invited to.</p>
47984772
<blockquote>
47994773
<p>If you are using the <em>Trio</em> or <em>iAPS</em> app instead of the <em><abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr></em> app, you can still assist with Pump, <abbr title="continuous glucose monitor, wearable medical device that measures and reports glucose in interstitial fluid">CGM</abbr> and Tidepool module localization through <em><abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr></em> <em>lokalise</em>. Some repositories from <em><abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr></em> are used by <a href="#what-about-other-ios-apps"><em>Trio</em> and <em>iAPS</em></a>.</p>
48004774
</blockquote>
4801-
<p>Alternative contacts for addtion to <em>crowdin</em>:</p>
4802-
<ul>
4803-
<li>Bastiaan Verhaar in zulipchat<ul>
4804-
<li>Bastiaan is known as <code>INeedSugar</code> in <a href="https://discord.gg/FnwFEFUwXE">Trio discord</a> and <a href="https://discord.com/invite/ptkk2Y264Z">iAPS discord</a></li>
4805-
</ul>
4806-
</li>
4807-
<li><code>lubor</code> in <a href="https://discord.com/invite/ptkk2Y264Z">iAPS discord</a></li>
4808-
</ul>
4775+
<hr />
48094776
<h2 id="lokalise-information">Lokalise Information<a class="headerlink" href="#lokalise-information" title="Anchor link to this Header on this Page">&para;</a></h2>
48104777
<h3 id="initial-screen-on-lokalise">Initial Screen on <em>lokalise</em><a class="headerlink" href="#initial-screen-on-lokalise" title="Anchor link to this Header on this Page">&para;</a></h3>
48114778
<p>When you log in to <em>lokalise</em>, you will see a screen similar to the screenshot below. Tap on the <em><abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr></em> icon, highlighted in the graphic with a red rectangle, to start translating.</p>
@@ -4838,7 +4805,7 @@ <h3 id="enter-a-translation">Enter a Translation<a class="headerlink" href="#ent
48384805
<p>The only reason to use <code>Insert source</code> would be if that <code>key</code> should always be identical to the English version and you want to avoid having that <code>key</code> show up when looking for untranslated keys.</p>
48394806
</blockquote>
48404807
<h3 id="select-a-submodule">Select a Submodule<a class="headerlink" href="#select-a-submodule" title="Anchor link to this Header on this Page">&para;</a></h3>
4841-
<p>Suppose you know that you want to modify translations for a particular submodule (<abbr title="continuous glucose monitor, wearable medical device that measures and reports glucose in interstitial fluid">CGM</abbr>, Pump or Service module). You can choose context in <em>lokalise</em>; or if it is one of the newer <abbr title="for Loop, submodules are repositories defined in the Workspace repository that are required to build the app">submodules</abbr>, go directly to the <em>crowdin</em> project for that submodule. See <a href="#submodule-table-for-multiple-apps">Submodule Table for Multiple Apps</a> for a detailed listing.</p>
4808+
<p>Suppose you know that you want to modify translations for a particular submodule (<abbr title="continuous glucose monitor, wearable medical device that measures and reports glucose in interstitial fluid">CGM</abbr>, Pump or Service module). You can choose context in <em>lokalise</em>. See <a href="#submodule-table-for-multiple-apps">Submodule Table for Multiple Apps</a> for a detailed listing.</p>
48424809
<ul>
48434810
<li>Tap on Filter</li>
48444811
<li>Tap on Context</li>
@@ -4853,7 +4820,6 @@ <h3 id="select-a-submodule">Select a Submodule<a class="headerlink" href="#selec
48534820
</li>
48544821
</ul>
48554822
<p>The screenshot below is configured for someone translating simplified Chinese for the DanaKit pump.</p>
4856-
<p><strong>NOTE</strong> The DanaKit keys are no longer visible in <em>lokalise</em>. They are being handled using <a href="#crowdin-projects"><em>crowdin</em></a>.</p>
48574823
<p align="center"><img alt="choose a submodule for translation" src="../img/lokalise-by-context-submodule-xcstrings.png" width="1024" /></p>
48584824
<h3 id="matches-source">Matches Source<a class="headerlink" href="#matches-source" title="Anchor link to this Header on this Page">&para;</a></h3>
48594825
<p>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.</p>
@@ -4882,8 +4848,10 @@ <h2 id="what-about-other-ios-apps">What About Other <abbr title="operating syste
48824848
</ul>
48834849
<p>The bottom line is</p>
48844850
<ul>
4885-
<li><abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr> and older (pre 2025) submodule translations are handled at <a href="https://app.lokalise.com/"><em>lokalise</em></a></li>
4886-
<li>New <abbr title="for Loop, submodules are repositories defined in the Workspace repository that are required to build the app">submodules</abbr>, DanaKit, EversenseKit, and MedtrumKit. are currently handled in <a href="#crowdin-projects"><em>crowdin</em> projects</a> for the individual repositories</li>
4851+
<li><abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr> and all its submodule translations are handled at <a href="https://app.lokalise.com/"><em>lokalise</em></a><ul>
4852+
<li>This includes cgm managers, pump managers and service managers used by several OS-AID systems</li>
4853+
</ul>
4854+
</li>
48874855
<li><em>Trio</em> translations are handled at <a href="https://crowdin.com/project/trio/invite/public?h=48e1a77abd1611860f475c1ce17540112591650&amp;show_welcome">crowdin for <em>Trio</em></a></li>
48884856
<li><em>iAPS</em> translations are handled at <a href="https://crowdin.com/project/iaps">crowdin for <em>iAPS</em></a></li>
48894857
</ul>
@@ -4906,6 +4874,11 @@ <h3 id="submodule-table-for-multiple-apps">Submodule Table for Multiple Apps<a c
49064874
</tr>
49074875
<tr>
49084876
<td style="text-align: center;"><abbr title="continuous glucose monitor, wearable medical device that measures and reports glucose in interstitial fluid">CGM</abbr></td>
4877+
<td style="text-align: left;"><code>EversenseKit</code></td>
4878+
<td style="text-align: left;">EversenseKit/EversenseKitUI/Localizable.xcstrings</td>
4879+
</tr>
4880+
<tr>
4881+
<td style="text-align: center;"><abbr title="continuous glucose monitor, wearable medical device that measures and reports glucose in interstitial fluid">CGM</abbr></td>
49094882
<td style="text-align: left;"><code>G7SensorKit</code></td>
49104883
<td style="text-align: left;">G7SensorKit/G7SensorKit/Localizable.xcstrings<br>G7SensorKit/G7SensorKitUI/Localizable.xcstrings</td>
49114884
</tr>
@@ -4926,6 +4899,16 @@ <h3 id="submodule-table-for-multiple-apps">Submodule Table for Multiple Apps<a c
49264899
</tr>
49274900
<tr>
49284901
<td style="text-align: center;">Pump</td>
4902+
<td style="text-align: left;"><code>DanaKit</code></td>
4903+
<td style="text-align: left;">DanaKit/Localizable.xcstrings</td>
4904+
</tr>
4905+
<tr>
4906+
<td style="text-align: center;">Pump</td>
4907+
<td style="text-align: left;"><code>MedtrumKit</code></td>
4908+
<td style="text-align: left;">MedtrumKit/Localizable.xcstrings</td>
4909+
</tr>
4910+
<tr>
4911+
<td style="text-align: center;">Pump</td>
49294912
<td style="text-align: left;"><code>OmniBLE</code></td>
49304913
<td style="text-align: left;">OmniBLE/Localizable.xcstrings<br>OmniBLE/OmniBLE/Localizable.xcstrings</td>
49314914
</tr>
@@ -4956,33 +4939,6 @@ <h3 id="submodule-table-for-multiple-apps">Submodule Table for Multiple Apps<a c
49564939
</tr>
49574940
</tbody>
49584941
</table>
4959-
<p>These <abbr title="for Loop, submodules are repositories defined in the Workspace repository that are required to build the app">submodules</abbr> are used by the <em><abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr></em>, <em>Trio</em> and <em>iAPS</em> apps and are handled by <em>crowdin</em>.</p>
4960-
<table>
4961-
<thead>
4962-
<tr>
4963-
<th style="text-align: center;">Type</th>
4964-
<th style="text-align: left;"><div style="width:145px"></div> Name</th>
4965-
<th style="text-align: left;">Files</th>
4966-
</tr>
4967-
</thead>
4968-
<tbody>
4969-
<tr>
4970-
<td style="text-align: center;">Pump</td>
4971-
<td style="text-align: left;"><code>DanaKit</code></td>
4972-
<td style="text-align: left;">see <a href="https://crowdin.com/project/danakit">DanaKit <em>crowdin</em></a></td>
4973-
</tr>
4974-
<tr>
4975-
<td style="text-align: center;">Pump</td>
4976-
<td style="text-align: left;"><code>MedtrumKit</code></td>
4977-
<td style="text-align: left;">see <a href="https://crowdin.com/project/medtrumkit">MedtrumKit <em>crowdin</em></a></td>
4978-
</tr>
4979-
<tr>
4980-
<td style="text-align: center;"><abbr title="continuous glucose monitor, wearable medical device that measures and reports glucose in interstitial fluid">CGM</abbr></td>
4981-
<td style="text-align: left;"><code>EversenseKit</code></td>
4982-
<td style="text-align: left;">crowdin project is not yet configured</td>
4983-
</tr>
4984-
</tbody>
4985-
</table>
49864942
<p>The modules are specific to the particular app:</p>
49874943
<table>
49884944
<thead>

search/search_index.json

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

0 commit comments

Comments
 (0)