🌐 Add a translation page

docs/EN/Setup/New-User-Setup.md

@@ -30,8 +30,9 @@ Once you have verified that you are using compatible devices, you can connect th
 ## Step 2: Add Profile Settings
 The next step is to enter your main profile settings: Basal, ISF, CR, and Target Glucose.
 
-:::{important}
-If you use mg/dL, you must first change the 'Glucose Units' before entering your profile settings.
+:::{admonition} Important
+:class: important
+If you use `mg/dL`, you must first change the `Glucose Units` **before** entering your profile settings.
 
 This is found in the Trio Settings menu under 'Preferences'
 :::
@@ -45,15 +46,14 @@ This is found in the Trio Settings menu under 'Preferences'
 ## Step 3: Adjust Safety Limits
 The next step is to adjust the standard safety limits that will allow Trio to function effectively. There are many more settings that are not mentioned in this section. It is not advised to adjust those until you have familiarized yourself with the system by using it for a while.
 
-:::{warning}
-<b>DO NOT ENABLE DYNAMIC SETTINGS YET</b>
+:::{admonition} DO NOT ENABLE DYNAMIC SETTINGS YET
+:class: warning
 
 It is essential that Trio have enough data to make sound recommendations. It is essential that your settings are tuned to be used in an Oref algorithm and you feel comfortable using the Trio app. It is not recommended to enable dynamic settings until ALL criteria below are met:
 
  - You are confident that your ISF, CR, and Basal Rates are tuned for use in the Oref algorithm
  - You have used Trio with a real CGM and real pump (not simulators) for the recommended minimum of 7 consecutive days
  - You are comfortable with the Trio app
-
 :::
 
  1. [Recommended Bolus Percentage](../settings/configuration/preferences/trio.md#recommended-bolus-percentage)

docs/EN/index.md

@@ -159,5 +159,7 @@ Sensitivity Settings <./settings/configuration/preferences/targetsettings.md>
 
 Citations <./resources/citations.md>
 
+Translation <./resources/translate.md>
+
 ```
 

docs/EN/resources/translate.md

@@ -0,0 +1,106 @@
+# Resources
+
+## Language List
+
+[عربي](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=ar)
+
+[Български](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=bg)
+
+[Čeština](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=cs)
+
+[Deutsch](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=de)
+
+[Dansk](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=da)
+
+[Ελληνικά](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=el)
+
+[Español](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=es)
+
+[日本](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=ja)
+
+[Suomi](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=fi)
+
+[Français](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=fr)
+
+[עברית](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=iw)
+
+[Hrvatski](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=hr)
+
+[हिंदी](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=hi)
+
+[Italiano](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=it)
+
+[한국어](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=ko)
+
+[Norsk](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=no)
+
+[Nederlands](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=nl)
+
+[Polski](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=pl)
+
+[Português](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=pt)
+
+[Română](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=ro)
+
+[Русский](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=ru)
+
+[Slovenčina](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=sk)
+
+[Svenska](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=sv)
+
+[Turkish](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=tr)
+
+中文（[简体](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=zh-CN))
+
+中文（[繁體](https://docs-diy--trio-org.translate.goog/en/latest/?_x_tr_sl=auto&_x_tr_tl=zh-TW))
+
+## Google Translate Links
+
+Click on a language on the list of links above to turn on Google's automatic translation.
+
+## Change Language
+
+To modify the language choice for the whole site, copy the line below, and paste it into the URL, and then choose the desired language from the list above.
+
+```
+https://docs.diy-trio.org/en/latest/translate.html
+```
+
+OR
+
+Use the Google Translation three-dot menu and select `Go to Original URL` while on the Translation page.
+
+## More Information
+
+- Every website page gets automatically translated to the selected language as do links to other websites
+
+- The Google Translate Tool will appear at the top of each page
+ - Trio Docs how-to: [Google Translate Tool Instructions](#google-translate-tool-instructions)
+ - Google how-to: [Google Translate Help Link](https://support.google.com/translate/answer/2534559?hl=en&co=GENIE.Platform%3DDesktop)
+
+:::{admonition} Automatic Translation
+: class: danger
+
+These links connect this site to the Google Translation service.
+
+* No human has reviewed the translated information for accuracy
+* Please use the translation with care
+* Not available in all regions
+* Some links may not work as expected
+* Any "code" not protected by blocks may not appear correctly - be sure to click on Original to make sure you are viewing code properly
+:::
+
+## Google Translate Tool Instructions
+
+Once Google Translate has been turned on, clicking on a language link above shows a "Google Translate: Can't translate this page error".
+
+- To modify the language for a single page, use the Google Translate tool
+- To modify the language for the entire site, see [Change Language](#change-language)
+
+The graphic below shows the Google Translate Tool when maximized (default) for a browser and mobile display. The tool can be minimized by tapping on the up/down carets at the right of the tool. This is very useful if the tool obstructs part of the original screen. Additional options can be selected with the three-dot menu as shown in the graphic.
+
+```{image} img/google-xslate.svg
+:width: 600px
+:align: center
+```
+

docs/shared.conf.py

@@ -41,6 +41,7 @@
  'sphinx.ext.todo',
  'myst_parser',
  'sphinx_copybutton',
+ 'sphinx_new_tab_link',
  # 'alabaster',
 ]
 

requirements.in

@@ -0,0 +1,5 @@
+sphinx==5.3.0
+sphinx_rtd_theme==1.2.0
+sphinx_copybutton==0.5.2
+sphinx-new-tab-link==0.6.0
+myst_parser==0.18.1

requirements.txt

@@ -1,4 +1,32 @@
-sphinx==5.3.0
-sphinx_rtd_theme==1.2.0
-sphinx_copybutton
-myst_parser==0.18.1
+alabaster==0.7.16
+babel==2.16.0
+certifi==2024.8.30
+charset-normalizer==3.3.2
+docutils==0.18.1
+idna==3.10
+imagesize==1.4.1
+Jinja2==3.1.4
+markdown-it-py==2.2.0
+MarkupSafe==2.1.5
+mdit-py-plugins==0.3.5
+mdurl==0.1.2
+myst-parser==0.18.1
+packaging==24.1
+Pygments==2.18.0
+PyYAML==6.0.2
+requests==2.32.3
+snowballstemmer==2.2.0
+Sphinx==5.3.0
+sphinx-copybutton==0.5.2
+sphinx-new-tab-link==0.6.0
+sphinx-rtd-theme==1.2.0
+sphinxcontrib-applehelp==2.0.0
+sphinxcontrib-devhelp==2.0.0
+sphinxcontrib-extdevhelper-kasane==0.2.0
+sphinxcontrib-htmlhelp==2.1.0
+sphinxcontrib-jquery==4.1
+sphinxcontrib-jsmath==1.0.1
+sphinxcontrib-qthelp==2.0.0
+sphinxcontrib-serializinghtml==2.0.0
+typing_extensions==4.12.2
+urllib3==2.2.3