Add global instances, fix external link in cards

Author: PhilReedData

README.md

@@ -6,6 +6,7 @@ Built using [Jupyter Book 1](https://jupyterbook.org/). For additional guidance,
 
 - [Anatomy of a Jupyter Book (TeachBooks.io)](https://teachbooks.io/manual/basic-features/jupyterbook.html)
 - [Sphinx Design (the engine behind Jupyter Book)](https://sphinx-design.readthedocs.io/en/latest/) including [CSS classes](https://sphinx-design.readthedocs.io/en/pydata-theme/css_classes.html)
+- [MyST Syntax Extensions](https://myst-parser.readthedocs.io/en/latest/syntax/optional.html) even though we are using Markdown, not MyST
 
 To run locally, install Jupyter Book then build:
 ```shell

TeSS_docs/_config.yml

@@ -26,12 +26,17 @@ bibtex_bibfiles:
 
 # Information about where the book exists on the web
 repository:
-  url: https://github.com/ibisba/workshop  # Online location of your book
+  url: https://github.com/ElixirTeSS/docs  # Online location of your book
   path_to_book: .  # Optional path to your book, relative to the repository root
   branch: main  # Which branch of the repository should be used when creating links (optional)
 
 # Add GitHub buttons to your book
 # See https://jupyterbook.org/customize/config.html#add-a-link-to-your-repository
 html:
   use_issues_button: true
-  use_repository_button: true
+  use_repository_button: true
+
+# Generate anchor links for headings down to h3, so we can do eg [API](#api)
+sphinx:
+  config:
+    myst_heading_anchors: 3

TeSS_docs/_static/custom-classes.css

@@ -1,6 +1,6 @@
 /* Custom CSS Classes */
 
-article .external:not(:has(img))::after {
+article .external:not(:has(img)):not(.sd-hide-link-text )::after {
     /* ↗, but nicer. SVG adapted from Inter's rendition of "↗". */
     content: url("data:image/svg+xml,%3C%3Fxml version='1.0' encoding='UTF-8' standalone='no'%3F%3E%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 12 12' version='1.1' id='svg1' width='12' height='12'%3E%3Cpath d='M 7.6490176,0 C 7.2259314,0 6.8841158,0.33671562 6.8841158,0.75348946 c 0,0.41677384 0.3418156,0.75348944 0.7649018,0.75348944 H 9.6258104 L 4.8141006,6.2492535 c -0.2987899,0.2943316 -0.2987899,0.7723267 0,1.0666587 0.2987896,0.2943318 0.7840244,0.2943318 1.0828141,0 L 10.708625,2.5736375 v 1.9472993 c 0,0.416774 0.341816,0.7534895 0.764901,0.7534895 0.423086,0 0.764902,-0.3367155 0.764902,-0.7534895 V 0.75348946 C 12.238428,0.33671562 11.896612,0 11.473526,0 Z M 1.9122544,0.75348946 C 0.85573386,0.75348946 0,1.5964559 0,2.6372133 v 7.5348947 c 0,1.040757 0.85573386,1.883724 1.9122544,1.883724 H 9.561272 c 1.05652,0 1.912254,-0.842967 1.912254,-1.883724 V 7.5348946 c 0,-0.4167736 -0.341816,-0.7534893 -0.764901,-0.7534893 -0.423086,0 -0.7649021,0.3367157 -0.7649021,0.7534893 v 2.6372134 c 0,0.207209 -0.1721028,0.376745 -0.3824509,0.376745 H 1.9122544 c -0.2103479,0 -0.3824509,-0.169536 -0.3824509,-0.376745 V 2.6372133 c 0,-0.2072096 0.172103,-0.3767448 0.3824509,-0.3767448 h 2.6771561 c 0.4230865,0 0.7649017,-0.3367156 0.7649017,-0.7534896 0,-0.4167738 -0.3418152,-0.75348944 -0.7649017,-0.75348944 z' id='path1' style='fill:%23999999;fill-opacity:1;stroke-width:0.0237243' /%3E%3C/svg%3E%0A");
     /* inline => inline-block, so that we can give it a height */
@@ -22,3 +22,7 @@ html[data-theme="light"] article .sd-btn-primary.external:not(:has(img))::after
 html[data-theme="dark"] article .sd-btn-primary.external:not(:has(img))::after {
     filter: brightness(0);
 }
+/*
+article .sd-card :not(p) .external:not(:has(img))::after {
+    content: none;
+}*/

TeSS_docs/overview/tess.md

@@ -1,6 +1,6 @@
 # Introduction to TeSS
 
-**Training e-Support Service (TeSS)**
+## Training e-Support Service (TeSS)
 
 
 TeSS is a platform that was developed to provide a one-stop shop for trainers and trainees to discover online information and content, including training materials, events and interactive tutorials. 
@@ -15,10 +15,70 @@ TeSS was originally developed as part of [ELIXIR](https://elixir-europe.org/), E
 One of the goals of ELIXIR is to train research scientists to better use available computational infrastructures to address critical research questions. 
 This requires access both to face-to-face training opportunities and to disparate training materials and resources, currently dispersed across Europe.
 
+## Global instances of TeSS
 
+TeSS is an open source, reusable software platform, and has been deployed by several other communities across the globe.
 
-```{seealso} 
-- [mTeSS-X project website](https://elixirtess.github.io/mTeSS-X/) which includes [global instances of TeSS](https://elixirtess.github.io/mTeSS-X/global)
-- [Original documentation at ELIXIR TeSS](https://tess.elixir-europe.org/about)
-```
+::::{grid} 1 1 2 3
+:class-container: text-center
+:gutter: 3
 
+:::{grid-item-card}
+:link: https://tess.elixir-europe.org/
+{fas}`earth-europe;sd-text-secondary` **ELIXIR TeSS (Training eSupport System)**
+^^^
+The original TeSS portal, computational resources for life sciences for ELIXIR Europe
+:::
+
+:::{grid-item-card}
+:link: https://pan-training.eu/
+{fas}`earth-europe;sd-text-secondary` **PaN Training Catalogue**
+^^^
+Training for photon & neutron science around Europe
+:::
+
+:::{grid-item-card}
+:link: https://dresa.org.au/
+{fas}`earth-oceania;sd-text-secondary` **Digital Research Skills Australasia (DReSA)**
+^^^
+Browsing, discovering and organising digital research events and training resources
+:::
+
+:::{grid-item-card}
+:link: https://taxila.nl/
+{fas}`earth-europe;sd-text-secondary` **Taxila**
+^^^
+Collection of trainers, events, and materials empowering research in the Netherlands
+:::
+
+:::{grid-item-card}
+:link: https://training.scilifelab.se/
+{fas}`earth-europe;sd-text-secondary` **SciLifeLab Training Portal**
+^^^
+Training for life science professionals across Sweden
+:::
+
+:::{grid-item-card}
+:link: https://explora.alliancecan.ca/
+{fas}`earth-americas;sd-text-secondary` **Explora**
+^^^
+Canadian digital research infrastructure training (Digital Research Alliance of Canada)
+:::
+
+:::{grid-item-card}
+:link: https://training.cern.ch/
+{fas}`earth-europe;sd-text-secondary` **HEP Training**
+^^^
+Training and events for the High Energy Physics community
+:::
+
+:::{grid-item-card}
+:link: https://everse-training.app.cern.ch/
+{fas}`earth-europe;sd-text-secondary` **EVERSE Training**
+^^^
+Training and events to foster research software quality in Europe
+:::
+
+::::
+
+If you are maintaining an instance of TeSS and would like us to include it here, please [contact us](https://tess.elixir-europe.org/about/us#contact).