Skip to content

Commit

Permalink
Merge pull request #2023 from openaps/l10n_master
Browse files Browse the repository at this point in the history
New Crowdin updates
  • Loading branch information
peterleimbach authored Jun 23, 2024
2 parents 275ff54 + f127590 commit d301dcd
Show file tree
Hide file tree
Showing 162 changed files with 1,629 additions and 965 deletions.
6 changes: 3 additions & 3 deletions docs/CROWDIN/cs/Getting-Started/Your-AAPS-Profile.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ The duration of insulin action is set to a single value in AAPS, because your pu

Glucose targets are set according to your personal preferences. For example, if you are concerned about hypos at night, you may set your target slightly higher at 117/mg/dL (6.5 mmol/L) from 9 pm - 7am. If you want to make sure you have plenty of insulin on board (IOB) in the morning before bolusing for breakfast, you may set a lower target of 81 mg/dL (4.5 mmol/L) from 7 am - 8 am. A glucose target, particularly if it is only short-term (less than 4 hours in duration), does not need to be the _actual value_ you expect or want your glucose level to get to, rather, it is a good way to tell AAPS to be more or less aggressive, while still keeping your glucose levels in range. The **figure below** shows an example of how the DIA and glucose targets could be set in an AAPS profile.

![24-07-23, profile basics - DIA and target](./images/f3904cc3-3d9e-497e-a3b6-3a49650053e6.png)
![24-07-23, profile basics - DIA and target](../images/f3904cc3-3d9e-497e-a3b6-3a49650053e6.png)

For the final three parameters, basal rates (BR), insulin sensitivity factors (ISF) and insulin-to-carb ratios (IC or ICR), the absolute values and trends in your insulin requirements vary significantly from person to person, depending on your biology, gender, age, fitness level etc. as well as shorter term factors like illness and recent exercise. For more guidance on this, the book [“Brights Spots and Landmines”](https://brightspotsandlandmines.org/Bright_Spots_and_Landmines_by_Adam_Brown.pdf) by Adam Brown is an excellent book to read.

Expand Down Expand Up @@ -48,7 +48,7 @@ Approx ISF (mmol/L) = 94/40 = 2.4

See the **figure below** for an example of how the basal rates and ISF values could be set in an AAPS profile.

![24-07-23, profile basics - basal and ISF](./images/55c8ed24-e24e-4caa-9c17-294fa93cb84a.png)
![24-07-23, profile basics - basal and ISF](../images/55c8ed24-e24e-4caa-9c17-294fa93cb84a.png)

#### **Insulin to Carb ratio (ICR)**

Expand All @@ -64,7 +64,7 @@ If your ICR is weaker, perhaps 1:20, you would only need 0.5U of insulin to cove

As shown in the **figure below**, when entering these values into an AAPS profile, we just enter the final part of the ratio, so an insulin-to-carb ratio of 1:3.5 is entered simply as “3.5”.

![24-07-23, profile basics - ICR](./images/7741eefb-cae5-45c5-a9e5-8eae5ead3f48.png)
![24-07-23, profile basics - ICR](../images/7741eefb-cae5-45c5-a9e5-8eae5ead3f48.png)

#### **Why should I try to get my profile settings right? Can’t the loop just take care of it?**

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ you should see the **AAPS** icon and be able to open the app.
Did you remeber to disallow the installation from Google Drive?
```

## Please go on with [configuring the AAPS loop](configuring-the-AAPS-loop.md).
## Please go on with [configuring the AAPS loop](../Installing-AndroidAPS/setup-wizard.md).

## Option 2. Use a USB cable to transfer files

Expand Down
6 changes: 3 additions & 3 deletions docs/CROWDIN/cs/Installing-AndroidAPS/building-AAPS.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ If you think something in the building instructions is wrong, missing or confusi

:::{admonition} WARNING
:class: warning
If you have built AndroidAPS before, you don't need to take all the following steps again.
If you have built AAPS before, you don't need to take all the following steps again.
Please jump directly to the [update guide](../Installing-AndroidAPS/Update-to-new-version)!
:::

Expand Down Expand Up @@ -349,7 +349,7 @@ If you want to create the apk for your watch, you need to select AAPS.wear!
:::{admonition} INFORMATION!
:class: information
You will only need to create the keystore once.
If you have build AndroidAPS before, do NOT create a new keystore but select your existing one!
If you have build AAPS before, do NOT create a new keystore but select your existing one!
:::

**_Note:_** The key store is a file in which the information for signing the app is stored. It is encrypted, and the information is secured with passwords.
Expand Down Expand Up @@ -379,7 +379,7 @@ You now need a password for your key. To keep it simple, if you want, you can us

:::{admonition} WARNING!
:class: warning
Note down these passwords! You will need them when you build the next AndroidAPS update!
Note down these passwords! You will need them when you build the next AAPS update!
:::

The validity (6) is 25 years by default, leave it as it is.
Expand Down
3 changes: 3 additions & 0 deletions docs/CROWDIN/cs/Sandbox/imageTranslation.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# test page for image translation with Crowdin

![simple test case](../images/ThisIsASimpleTestCase4ImageTranslation.png)
30 changes: 14 additions & 16 deletions docs/CROWDIN/cs/Usage/FullClosedLoop.md

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion docs/CROWDIN/cs/Usage/completing-the-objectives.md
Original file line number Diff line number Diff line change
Expand Up @@ -119,7 +119,7 @@ Your target is a core value. All calculations are based on it. It is different f

You may want to experiment with adjusting your targets being in a tighter range (say, 1 or less mmol/l [20 mg/dl or less] wide) and observe a resulting system behaviour.

You can adjust (widen or tighten) the graph’s green area, representing your target range, by entering different values in [Preferences](../Configuration/Preferences.md) > Range for Visualisation.
You can adjust (widen or tighten) the graph’s green area, representing your target range, by entering different values in [Preferences](../Configuration/Preferences.md) > Overview > Range for Visualisation.

![Stop sign](../images/sign_stop.png)
:::{admonition} If you have been using a virtual pump, change to a real insulin pump now!
Expand Down
Binary file modified docs/CROWDIN/cs/images/Garmin_WF-annotated.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
46 changes: 42 additions & 4 deletions docs/CROWDIN/cs/remote-control.md
Original file line number Diff line number Diff line change
Expand Up @@ -284,13 +284,14 @@ _Note that **NSClient** has been replaced by **AAPSClient** for AAPS version 3.2

For versions of **AAPS** which are older than AAPS 3.2, if you have a caregiver/parent Android phone you can directly download and install the [**AAPSClient**](https://github.com/nightscout/AndroidAPS/releases/) apk. **AAPSClient** looks very similar in appearance to **AAPS** itself, offering the caregiver tabs that will remotely action commands in **AAPS**:

![image](images/remote-control-19.png)
![NSCLIENT_ 2024-05-17 134512](https://github.com/openaps/AndroidAPSdocs/assets/137224335/6c66a27c-21d7-4c43-ac66-001669c0634f)


There are 2 versions of the apk that can be [downloaded from here](https://github.com/nightscout/AndroidAPS/releases/), **AAPSClient** & **AAPSClient2** which have a subtle but important difference as explained below.

**AAPSClient** can be installed on a single phone or multiple follower phones (_i.e._ parent 1’s follower phone and parent 2’s follower phone) in order for both caregivers to be granted access and remote control a patient's **AAPS** phone.
**AAPSClient** can be installed on a single phone or multiple follower phones (i.e. parent 1’s follower phone and parent 2’s follower phone) in order for both caregivers to be granted access and remote control a patient's **AAPS** phone.

Should a caregiver require a second copy of **AAPSClient** to remote control a additional patient with a nightscout account, they should install **AAPSClient2** in addition to **AAPSClient**. **AAPSClient 2** allows a single caregiver to install the **AAPSClient** apk twice on the same follower phone in order to be given simultaneous access and remote control to two different patients.
Should a caregiver require a second copy of **AAPSClient** to remote control an additional patient with a Nightscout account, they should install **AAPSClient2** in addition to **AAPSClient**. **AAPSClient 2** allows a single caregiver to install the **AAPSClient** apk twice on the same follower phone in order to be given simultaneous access and remote control to two different patients.

To download **AAPSClient**, navigate to [here](https://github.com/nightscout/AndroidAPS/releases/) and click on the asset **“app-AAPSClient-release_x.x.x.x”** (it may be a newer version to that shown in the screenshot below):

Expand All @@ -306,11 +307,48 @@ The **AAPSClient** apk can now be either:

Transferred by a USB cable onto the follower phone; or Dragged into Google drive folder, and then added onto the follower phone by clicking on the "app-AAPSClient-release" file.

### Synchronization- AAPSClient and AAPS set up (for Version 3.2.0.0 above)

Once __AAPSClient__ apk is installed on the follower phone, the user must ensure their ‘Preferences’ in Config Builder are correctly set up and aligned with __AAPS__ for Nightscout 15 (see Release Notes [here](https://androidaps.readthedocs.io/en/latest/Installing-AndroidAPS/Update-to-new-version.html)). The example below provides Synchronization guidance for NSClient and NSClientV3 using Nightscout15 but there are other options available with __AAPS__ (e.g xDrip+).

Within the ‘Synchronization’ located under ‘Config Builder’, the user can opt for either Synchronization options for both __AAPS__ and follower phone being:

- Option 1: NSClient (also known as ‘v1’) - which synchronises the user’s data with Nightscout; or

- Option 2: NSClientV3 (also referred to as ‘v3’).- which synchronises the user’s data with Nightscout using v3 API.

![AAPS1_Screenshot 2024-05-17 133502](https://github.com/openaps/AndroidAPSdocs/assets/137224335/4bdfed7e-3b2f-4fe8-b6db-6fcf0e5c7d98)

The user must ensure that __both__ the AAPS and AAPS Client phones are synched together by actioning either option for v1 or v3 being:

Option 1: v1 for both phones:

- Enter your Nightscout URL

- Enter your API secret

Option 2: v3 for both phones:

- Enter your Nightscout URL under NSClientV3 tab

- Enter your NS access token under ‘Config Build’ tab. Please follow the notes [here](https://nightscout.github.io/nightscout/security/#create-a-token)

If selecting Websockets (which is optional) ensure this is activated or deactivated for both __AAPS’__ and __AAPSClient’s__ phone. Activating Websockets in __AAPS__ and not within __AAPSClient__ (and vice versa) will only cause __AAPS__ to malfunction. By enabling websockets will allow for faster synchronization with Nightscout but may lead to more phone battery consumption.



![WB2_Screenshot 2024-05-17 140548](https://github.com/openaps/AndroidAPSdocs/assets/137224335/8d9a7dc5-b3ea-4bf3-9286-313f329b1966)


Users should ensure that both __AAPSClient__ and __AAPS__ are showing ‘connected’ under the ‘NSClient' tab for each phone, and that ‘Profile Switches’ or ‘Temp Target' can be correctly activated in __AAPS__ once selected in __AAPSClient__.

Users should also ensure that carbs are logged in both ‘Treatments’ within both __AAPSClient__ and __AAPS__ otherwise this could indicate a malfunction within the user’s set up.

### Features of AAPSClient include:

![Sara's AAPSClient table](images/remote-control-23.png)

**AAPSClient** allows the caregiver to make many of the adjustments that are allowed directly in **AAPS** (excluding insulin boluses) remotely, via the mobile or internet network. The main benefits of **AAPSClient** are the speed and ease with which caregivers/parents can use it to remotely control **APPS**. AAPSClient _can_ be much faster than entering SMS Commands, if delivering a command which would require authentication. Commands entered on **AAPSClient** are uploaded onto Nightscout.
**AAPSClient** allows the caregiver to make many of the adjustments that are allowed directly in **AAPS** (excluding insulin boluses) remotely, via the mobile or internet network. The main benefits of **AAPSClient** are the speed and ease with which caregivers/parents can use it to remotely control **APPS**. __AAPSClient__ _can_ be much faster than entering SMS Commands, if delivering a command which would require authentication. Commands entered on **AAPSClient** are uploaded onto Nightscout.

Remote control through **AAPSClient** is only recommended if your synchronization is working well (_i.e._ you don’t see unwanted data changes like self-modification of TT, TBR etc) see [release notes for Version 2.8.1.1](Releasenotes-important-hints-2-8-1-1) for further details.

Expand Down
6 changes: 3 additions & 3 deletions docs/CROWDIN/de/Getting-Started/Your-AAPS-Profile.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ Da Deine Pumpe nur ein Insulinart abgibt, ist die Insulinwirkdauer in AAPS auch

Glukoseziele werden passend zu Deinen persönlichen Bedürfnissen gesetzt. Wenn Du beispielsweise Angst vor nächtlichen Hypos hast, kannst Du Dein Glukoseziel von 21.00 - 07.00 Uhr auf 117 mg/dl setzen (6,5 mmol/l) setzen. Wenn Du erreichen möchtest, dass Du vor dem Frühstücksbolus am Morgen bereits genügend aktives Insulin (IOB) im Körper hast, könntest Du für die Zeit von 07.00 - 08.00 Uhr ein niedrigeres Ziel von 81 mg/dl (4,5 mmol/dl) setzen. Ein Glukoseziel, insbesondere dann, wenn es nur kurz (weniger als 4 Stunden) gültig ist, muss nicht der _tatsächliche Wert_ sein, den Du erreichen möchtest, sondern kann ein guter Weg sein AAPS - während der Glukosewert im Zielbereich gehalten wird - aggressiver oder weniger aggressiv zu machen. Die **Abbildung unten** zeigt, wie die Insulinwirkdauer (DIA) und Glukoseziele in einem AAPS-Profil gespeichert werden können.

![24-07-23, profile basics - DIA and target](./images/f3904cc3-3d9e-497e-a3b6-3a49650053e6.png)
![24-07-23, profile basics - DIA and target](../images/f3904cc3-3d9e-497e-a3b6-3a49650053e6.png)

Für die restlichen drei Parameter Basalrate (BR), Insulinempfindlichkeitsfaktoren (ISF) und Insulin-Kohlenhydrat-Verhätnisse bzw. Mahlzeitenfaktoren (IC oder ICR), variieren die absoluten Werte und Trends Deines Insulinbedarfs in Abhängigkeit von Deiner Biologie, Geschlecht, Alter, Fitnessgrad usw., aber auch von vorübergehenden Einflüssen wie Krankheit und sportlicher Aktivitität mitunter erheblich. Für tiefere Einblicke in das Thema wird das englischsprachige Buch [“Brights Spots and Landmines”](https://brightspotsandlandmines.org/Bright_Spots_and_Landmines_by_Adam_Brown.pdf) von Adam Brown empfohlen.

Expand Down Expand Up @@ -48,7 +48,7 @@ Ungefährer ISF (mmol/l) = 94/40 = 2,4

Die **Abbildung unten** zeigt beispielhaft, wie die Basalraten und ISF-Werte in einem AAPS-Profil gespeichert werden können.

![24-07-23, profile basics - basal and ISF](./images/55c8ed24-e24e-4caa-9c17-294fa93cb84a.png)
![24-07-23, profile basics - basal and ISF](../images/55c8ed24-e24e-4caa-9c17-294fa93cb84a.png)

#### **Insulin-Kohlenhydrat-Verhältnis (insulin to carb ratio - ICR)**

Expand All @@ -64,7 +64,7 @@ Wenn Du einen schwächeren ICR-Wert hast, z. B. 1:20, würdest Du nur 0,5 IE Ins

Wie in der **Abbildung unten** gezeigt, wird nur der berechnete Wert in das AAPS-Profil eingetragen. Ein Insulin-Kohlenhydrat-Verhältnis von 1:3,5 wird als "3.5" eingegeben. (Hinweis: Bitte verwende den Punkt als Dezimaltrennzeichen, d.h. "3.5" und nicht "3,5").

![24-07-23, profile basics - ICR](./images/7741eefb-cae5-45c5-a9e5-8eae5ead3f48.png)
![24-07-23, profile basics - ICR](../images/7741eefb-cae5-45c5-a9e5-8eae5ead3f48.png)

#### **Warum sollte ich versuchen, meine Profileinstellungen richtig zu haben? Kann sich der Loop nicht darum kümmern?**

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ you should see the **AAPS** icon and be able to open the app.
Did you remeber to disallow the installation from Google Drive?
```

## Please go on with [configuring the AAPS loop](configuring-the-AAPS-loop.md).
## Please go on with [configuring the AAPS loop](../Installing-AndroidAPS/setup-wizard.md).

## Option 2. USB-Kabel zum Übertragen von Dateien verwenden

Expand Down
6 changes: 3 additions & 3 deletions docs/CROWDIN/de/Installing-AndroidAPS/building-AAPS.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ Wenn du denkst, dass etwas in der Anleitung zum Erstellen der App falsch ist, fe

:::{admonition} WARNUNG
:class: warning
Wenn Du AAPS in der Vergangenheit bereits einmal erstellt hast, musst Du nicht alle der Schritte noch einmal durchlaufen.
If you have built AAPS before, you don't need to take all the following steps again.
Bitte springe direkt zum [Update-Leitfaden](../Installing-AndroidAPS/Update-to-new-version)!
:::

Expand Down Expand Up @@ -349,7 +349,7 @@ If you want to create the apk for your watch, you need to select AAPS.wear!
:::{admonition} INFORMATION!
:class: information
You will only need to create the keystore once.
If you have build AndroidAPS before, do NOT create a new keystore but select your existing one!
If you have build AAPS before, do NOT create a new keystore but select your existing one!
:::

**_Note:_** The key store is a file in which the information for signing the app is stored. It is encrypted, and the information is secured with passwords.
Expand Down Expand Up @@ -379,7 +379,7 @@ You now need a password for your key. To keep it simple, if you want, you can us

:::{admonition} WARNING!
:class: warning
Note down these passwords! You will need them when you build the next AndroidAPS update!
Note down these passwords! You will need them when you build the next AAPS update!
:::

The validity (6) is 25 years by default, leave it as it is.
Expand Down
3 changes: 3 additions & 0 deletions docs/CROWDIN/de/Sandbox/imageTranslation.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# test page for image translation with Crowdin

![simple test case](../images/ThisIsASimpleTestCase4ImageTranslation.png)
Loading

0 comments on commit d301dcd

Please sign in to comment.