Merge pull request #44 from ebouchut/doc/open_external_links_in_new_w…

…indow

🚸 UX Improvement: Open external links in a new window

docs/css/extra.css

@@ -11,4 +11,15 @@ article ul ul {
 
 article ul ul ul {
         list-style-type:  square !important;
-}
+}
+
+/*
+ * Materialize links that open in a new window/tab with a right-up arrow icon
+ */
+a[target="_blank"]::after {
+    content:     '↗';
+    display:     inline-block;
+    margin-left: 0.2em;
+    width:       1em;
+    height:      1em;
+}

docs/data/glucodyn.md

@@ -1,13 +1,13 @@
 # Perceptus
 
-[Perceptus](http://perceptus.org/) is a website and set of free tools developed by *Kenneth Stack* and *Gustavo Munoz*, two active members of the DIY community. *Perceptus* provides two tools particularly helpful for *Loop* users; *Dash* and *GlucoDyn*. As a side note, *Gustavo* has an excellent Spanish [Tedx Talk](https://youtu.be/K1C4xEWipOo) about building his own DIY looping algorithm. *Kenneth* is also the brains behind [NSApple watch app](https://github.com/Kdisimone/nsapple/tree/nsapple-units).
+[Perceptus](http://perceptus.org/){: target="_blank" } is a website and set of free tools developed by *Kenneth Stack* and *Gustavo Munoz*, two active members of the DIY community. *Perceptus* provides two tools particularly helpful for *Loop* users; *Dash* and *GlucoDyn*. As a side note, *Gustavo* has an excellent Spanish [Tedx Talk](https://youtu.be/K1C4xEWipOo){: target="_blank" } about building his own DIY looping algorithm. *Kenneth* is also the brains behind [NSApple watch app](https://github.com/Kdisimone/nsapple/tree/nsapple-units){: target="_blank" }.
 
 ## Dash {: translate="no" }
 For *Loop* users with *Nightscout* integration running, *Dash* can provide an alternate view and data analysis for the *Loop* data stored in your Nightscout's mLab database. (Note: *mLab* used to be called *MongoLab*, still the same intended reference)
 
 To set up your *Dash* integration, you will need to:  
 
-* Signup for a *Perceptus* account [here](http://perceptus.org/)  
+* Signup for a *Perceptus* account [here](http://perceptus.org/){: target="_blank" }  
 
 * Provide your *mLab* database information
 

docs/data/nightscout.md

@@ -1,6 +1,6 @@
 # Nightscout {: translate="no" }
 
-[Nightscout](https://nightscout.github.io/) (NS) is a cornerstone of the DIY type 1 community. It is an excellent tool to remotely view Loop's actions and access insulin and blood glucose data. It allows for easy remote monitoring of *Loop* activities, troubleshooting of *Loop* errors, history of CGM, carbs, boluses, & temporary basal rates, and reports to analyze data trends and patterns. There is a *Nightscout* app in your iPhone App Store, or you can use a web browser to view the data.  [Setting up Nightscout for Loop](https://loopkit.github.io/loopdocs/nightscout/new_user/) is free and fairly quick. Once set up, the site can be accessed by anyone that you share your unique *Nightscout* URL with.
+[Nightscout](https://nightscout.github.io/){: target="_blank" } (NS) is a cornerstone of the DIY type 1 community. It is an excellent tool to remotely view Loop's actions and access insulin and blood glucose data. It allows for easy remote monitoring of *Loop* activities, troubleshooting of *Loop* errors, history of CGM, carbs, boluses, & temporary basal rates, and reports to analyze data trends and patterns. There is a *Nightscout* app in your iPhone App Store, or you can use a web browser to view the data.  [Setting up Nightscout for Loop](https://loopkit.github.io/loopdocs/nightscout/new_user/){: target="_blank" } is free and fairly quick. Once set up, the site can be accessed by anyone that you share your unique *Nightscout* URL with.
 
 ## Nightscout Display
 *Nightscout* is highly recommended for *Loop* users, especially those using *Loop* as caregivers. *Nightscout* displays are often the easiest way to troubleshoot *Loop* settings if you are having problems and seeking input from others.  Below is some discussion about the general *Nightscout* display, as well as some <span translate="no">Loop</span>-specific display information.
@@ -26,7 +26,7 @@ Within your NS profile, you will enter in the scheduled basal rates from your *L
 
 ### Predicted Blood Glucose
 
-The purple line to the right of the blood glucose readings is Loop&#39;s predicted blood glucose curve.  Watching the behavior of that purple line can help you understand why *Loop* is making decisions regarding high or low temporary basal rates. You can read more on that topic in the [Algorithm](https://loopkit.github.io/loopdocs/operation/algorithm/temp-basal) section of *LoopDocs*.
+The purple line to the right of the blood glucose readings is Loop&#39;s predicted blood glucose curve.  Watching the behavior of that purple line can help you understand why *Loop* is making decisions regarding high or low temporary basal rates. You can read more on that topic in the [Algorithm](https://loopkit.github.io/loopdocs/operation/algorithm/temp-basal){: target="_blank" } section of *LoopDocs*.
 
 
 ### <span translate="no">L&#8203;oop</span> pill

docs/data/tidepool.md

@@ -12,7 +12,7 @@ In Tidepool's own words, their commitment to diabetes data and accessibility
 
     We believe that connected data leads to better decision-making. Tidepool's free software liberates data from diabetes devices, and places it in context of the real world. Tidepool is designed to help you discover insights and bring context to your diabetes management. And, to help make your data more actionable, we allow you to share your data with anyone you choose: caregivers, clinicians, endocrinologists, friends, researchers – anyone.
 
-*Tidepool* has [announced](https://tidepool.org/loop/) that they are embarking on a project to build and support an FDA-regulated version of *Loop*, to be available in the iOS App Store, intended to work with commercially available insulin pumps and CGMs.
+*Tidepool* has [announced](https://tidepool.org/loop/){: target="_blank" } that they are embarking on a project to build and support an FDA-regulated version of *Loop*, to be available in the iOS App Store, intended to work with commercially available insulin pumps and CGMs.
 
 ## <span translate="no">Tidepool&nbsp;</span>  Data
 Once you start uploading data into your *Tidepool* account, you'll see some of the benefits pretty quickly. Tidepool&#39;s data presentation is easy on the eyes. Lots of calm colors, logical data layout, quick to access important information...basically a breeze to get your needed data and get on with your analysis.
@@ -32,7 +32,7 @@ Children with type 1 diabetes can have their own data account, and parents can h
 
 There are two methods for uploading different data to your *Tidepool* account:
 
-* **Tidepool Uploader** (program on your computer) -   *Tidepool* Uploader supports a large variety of current diabetes devices in the market; Animas, T-slim, Medtronic, Omnipod, Dexcom, and more. The full list of devices is [here](https://tidepool.org/products/tidepool-uploader/#devices). To upload the data from these devices, you download the free *Tidepool* Uploader program, connect your device to the computer according to the instructions provided in the Uploader, and your data is then securely uploaded and stored in your *Tidepool* account. Most users will perform uploads on a semi-regular basis; weekly, monthly, or prior to each clinic visit.  
+* **Tidepool Uploader** (program on your computer) -   *Tidepool* Uploader supports a large variety of current diabetes devices in the market; Animas, T-slim, Medtronic, Omnipod, Dexcom, and more. The full list of devices is [here](https://tidepool.org/products/tidepool-uploader/#devices){: target="_blank" }. To upload the data from these devices, you download the free *Tidepool* Uploader program, connect your device to the computer according to the instructions provided in the Uploader, and your data is then securely uploaded and stored in your *Tidepool* account. Most users will perform uploads on a semi-regular basis; weekly, monthly, or prior to each clinic visit.  
 
 * **Tidepool Mobile** (app on your phone) - *Tidepool* Mobile is available for both Android and iOS/iPhone users. *Tidepool* Mobile is a companion app to *Tidepool* that lets you add notes about meals, exercise, or anything else. See your CGM, pump, and meter data alongside any notes you add. Track your favorite meals and your regular exercise, and learn from what happens.  
 
@@ -90,7 +90,7 @@ For example, here’s a sample note+data set below from my *Tidepool* Mobile app
 {align="center"}
 
 ## Tidepool&#39;s Mobile app for iOS/iPhone
-As part of *Tidepool* *Loop* development, *Tidepool* updated its *Tidepool* Mobile iOS app to integrate with *Loop* user's data stored in Apple's HealthKit database. This update also supports the [Jaeb Center observational study](jaeb.org/loopstudy) of Loop.
+As part of *Tidepool* *Loop* development, *Tidepool* updated its *Tidepool* Mobile iOS app to integrate with *Loop* user's data stored in Apple's HealthKit database. This update also supports the [Jaeb Center observational study](https://www.jaeb.org/projects/){: target="_blank" } of Loop.
 
 ### How does the Loop data upload work?
 The *Tidepool* Mobile iOS app will sync Loop&#39;s diabetes-related HealthKit data into your *Tidepool* account. The app will continuously upload that data so long as the *Tidepool* Mobile app is open, even if it is only open in the background. That data will then be viewable in two places: on the *Tidepool* Mobile app itself <u>when using notes</u>, or in your *Tidepool* account using the desktop Chrome browser (note: the two options are not identical viewing platforms, see discussion above). This means you will not have to plug any of your devices into a USB cable in order to upload your information to *Tidepool*.
@@ -115,4 +115,4 @@ Hormones can also be easily tracked with notes. *What day-of-the-month and how d
 The *Tidepool Mobile* application uploads diabetes-related HealthKit data regardless of the source. Loop users store their data in HealthKit, so this is a nice fit. Other diabetes devices (e.g., OneDrop BG meter) and apps (e.g., Spike and Dexcom) also store their data in HealthKit. Some people even manually enter their diabetes data into HealthKit. For all those uses, the <span>*Tidepool Mobile* application</span> will upload the HealthKit data. OpenAPS does not store its data in HealthKit, so this will not upload OpenAPS-related data. However, if OpenAPS users are using Spike app, some integration of information through Nightscout is possible. Currently, OpenAPS SMBs, boluses, and carbohydrates can be uploaded to HealthKit for OpenAPS+Spike+Nightscout+iPhone users.  Spike does plan to add temporary basal integration to HealthKit at some time in the future.
 
 ### How can you get the Tidepool Mobile app?
-*Tidepool Mobile* is available in the [iOS App Store](https://apps.apple.com/us/app/tidepool-mobile/id1026395200) on your Loop device.
+*Tidepool Mobile* is available in the [iOS App Store](https://apps.apple.com/us/app/tidepool-mobile/id1026395200){: target="_blank" } on your Loop device.

docs/how-to/endo.md

@@ -2,7 +2,7 @@
 
 There is a wide range of comfort within the health care profession for DIY projects and type 1 diabetes. Loop is no different; some health care providers are comfortable and some are distrusting. As with all things health care related, honesty with your health care provider is paramount so that the best decisions can be made.
 
-Since using Loop often requires people to secure access to pump supplies that they may not have otherwise have, often times the first conversation about Looping with an endocrinologist will be when trying to get prescriptions for Medtronic or Omnipod supplies. The best approach is to start with objective information. Find out if the clinic has other patients already Looping and whether or not they have concerns from what they have seen. Provide links to the [LoopDocs site](http://loopdocs.org) and this site so that your endocrinologist or health care provider can read about the system's algorithm and operations.
+Since using Loop often requires people to secure access to pump supplies that they may not have otherwise have, often times the first conversation about Looping with an endocrinologist will be when trying to get prescriptions for Medtronic or Omnipod supplies. The best approach is to start with objective information. Find out if the clinic has other patients already Looping and whether or not they have concerns from what they have seen. Provide links to the [LoopDocs site](http://loopdocs.org){: target="_blank" } and this site so that your endocrinologist or health care provider can read about the system's algorithm and operations.
 
 Most often the important aspects that need discussion are:
 

docs/how-to/exercise.md

@@ -3,7 +3,7 @@
 Hands-down, exercise is the most commonly discussed topic of long-term Loop users. Exercise is highly specific to an individual and its impact on blood sugar is not always equal. For example, many people find anaerobic exercise such as weight lifting will raise blood glucose, and aerobic exercise such as running will lower blood glucose. The degree to which impacts are observed also depends on the insulin and carbohydrates on board going into the exercise. Blood glucose response in competition can be quite different than a regular training session due to the added adrenaline. Exercising with T1D does require extra preparation, but with preparation, things should go much easier.
 
 ## Exercise Basics
-A 2013 JDRF survey found that 36 percent of T1D patients, caregivers and healthcare professionals view exercise as a challenge and would like to learn more about exercising safely. The JDRF PEAK (T!D Performance in Exercise and Knowledge) education curriculum explores the environmental, dietary, physiological and psychosocial elements that impact physical activity with T1D ([source](https://www.jdrf.org/t1d-resources/peak/)). As part of JDRF's PEAK resources, they have published a helpful [article about exercise and T1D for athletes](https://www.jdrf.org/t1d-resources/living-with-t1d/exercise/). Below is an excerpt from that article.  There are a couple key considerations (highlighted in orange) that be different in Loop use.  Those considerations are discussed further below.
+A 2013 JDRF survey found that 36 percent of T1D patients, caregivers and healthcare professionals view exercise as a challenge and would like to learn more about exercising safely. The JDRF PEAK (T!D Performance in Exercise and Knowledge) education curriculum explores the environmental, dietary, physiological and psychosocial elements that impact physical activity with T1D ([source](https://www.jdrf.org/t1d-resources/peak/){: target="_blank" }). As part of JDRF's PEAK resources, they have published a helpful [article about exercise and T1D for athletes](https://www.jdrf.org/t1d-resources/living-with-t1d/exercise/){: target="_blank" }. Below is an excerpt from that article.  There are a couple key considerations (highlighted in orange) that be different in Loop use.  Those considerations are discussed further below.
 
 ***********************
 **With great exercise, comes great responsibility**

docs/index.md

@@ -1,12 +1,13 @@
 # Introduction
 
-Welcome to LoopTips!  The purpose of these pages is to help you make the most of your DIY closed-looping experience.  In particular, these pages support users of the [Loop app](https://loopkit.github.io/loopdocs/).  These documents have been a long time in the making and as always, your feedback is welcome.  If you have comments, please feel free to provide input at the [Looped Facebook Group](https://www.facebook.com/groups/TheLoopedGroup/?fref=nf) or in [Loop's Zulipchat](https://loop.zulipchat.com).
+Welcome to LoopTips!  The purpose of these pages is to help you make the most of your DIY closed-looping experience.  In particular, these pages support users of the [Loop app](https://loopkit.github.io/loopdocs/){: target="_blank" }.  These documents have been a long time in the making and as always, your feedback is welcome.  If you have comments, please feel free to provide input at the [Looped Facebook Group](https://www.facebook.com/groups/TheLoopedGroup/?fref=nf){: target="_blank" } or in [Loop's Zulipchat](https://loop.zulipchat.com){: target="_blank" }
+.
 
-LoopTips is a companion to LoopDocs.   LoopTips does not cover the build or installation of Loop app.  If you have problems with building your Loop app or troubleshooting the technical aspects of Loop operations, please head over to [LoopDocs](https://loopkit.github.io/loopdocs/) for help.  The LoopTips pages are specifically related to understanding how your loop is recommending the actions being taken, and how you can improve your blood glucose outcomes on Loop. Some of the pages that originated in LoopTips are now included in LoopDocs. Don't be surprised when you find links between the sites. (The color bar is deliberately a different shade to help you know where you are.)
+LoopTips is a companion to LoopDocs.   LoopTips does not cover the build or installation of Loop app.  If you have problems with building your Loop app or troubleshooting the technical aspects of Loop operations, please head over to [LoopDocs](https://loopkit.github.io/loopdocs/){: target="_blank" } for help.  The LoopTips pages are specifically related to understanding how your loop is recommending the actions being taken, and how you can improve your blood glucose outcomes on Loop. Some of the pages that originated in LoopTips are now included in LoopDocs. Don't be surprised when you find links between the sites. (The color bar is deliberately a different shade to help you know where you are.)
 
 ## What is a closed loop?
 
-The U.S. Food and Drug Administration (FDA) has a general definition of an "artificial pancreas device system" (aka closed loop system) [on their website](https://www.fda.gov/medicaldevices/productsandmedicalprocedures/homehealthandconsumer/consumerproducts/artificialpancreas/ucm259548.htm#illustration), quoted below.
+The U.S. Food and Drug Administration (FDA) has a general definition of an "artificial pancreas device system" (aka closed loop system) [on their website](https://www.fda.gov/medicaldevices/productsandmedicalprocedures/homehealthandconsumer/consumerproducts/artificialpancreas/ucm259548.htm#illustration){: target="_blank" }, quoted below.
 
 ![FDA Image](img/fda-image.png){width="450"}
 {align="center"}
@@ -21,7 +22,7 @@ The U.S. Food and Drug Administration (FDA) has a general definition of an "arti
 
 The Loop app is a do-it-yourself closed loop algorithm and user interface, developed through the work of community volunteers. You can read about the history of Loop development in LoopDocs. Loop predicts future blood glucose based on basals, carbohydrate intake, insulin deliveries, and current CGM readings. These blood glucose predictions provide Loop with the information needed to recommend a temporary basal rate to attain a targeted glucose range in the future. The system can either operate as an “open loop” by making recommendations to the user for their approval before enacting or as a “closed loop” by automatically setting the recommended temporary basal rate.
 
-As exciting as this sounds...we should first get the caveats out of the way.  There are some limitations on what kind of pumps/equipment are required.  This system doesn't work with most pumps and requires you to do some work. The pumps that are supported and the directions for building are thoroughly covered in [LoopDocs](https://loopkit.github.io/loopdocs/).
+As exciting as this sounds...we should first get the caveats out of the way.  There are some limitations on what kind of pumps/equipment are required.  This system doesn't work with most pumps and requires you to do some work. The pumps that are supported and the directions for building are thoroughly covered in [LoopDocs](https://loopkit.github.io/loopdocs/){: target="_blank" }.
 
 ## Disclaimer