add banner and links to versions

.github/workflows/build-pages.yml

@@ -41,7 +41,7 @@ jobs:
         run: |
           jupyter-book build .
       - name: Upload Build Artifacts
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: build-output
           path: _build/

_config.yml

@@ -18,14 +18,21 @@ launch_buttons:
   binderhub_url: "https://mybinder.org"
   jupyterhub_url: "https://hub.oggm.org"
 html:
+  extra_css:
+    - _static/custom.css
   use_repository_button: true
   use_issues_button: true
   use_edit_page_button: true
+  announcement: |
+    <p class="announcement">
+       🚧 <strong>Scheduled maintenance:</strong> the OGGM cluster will be offline <strong>April 27 (evening CEST) – April 30 (morning CEST)</strong>. 
+       <a href="https://oggm.org/2025/04/15/service-maintenance/">Learn more</a>.
+    </p>
   extra_footer: |
     <p>
     These notebooks are licensed under a <a href="https://github.com/OGGM/tutorials/blob/master/LICENSE.txt" target="_blank">BSD-3-Clause license</a>.
     <br>
-    &copy; Copyright 2014-2024.
+    &copy; Copyright 2014-2025.
     </p>
 sphinx:
   config:

_static/custom.css

@@ -0,0 +1,22 @@
+html {
+    --pst-font-size-h1: 2.2em; /* Default: 2.625 */
+    --pst-font-size-h2: 1.6em;   /* Default: 2.125 */
+    --pst-font-size-h3: 1.2em; /* Default: 1.75 */
+}
+
+.announcement {
+  background-color: orange !important; /* You can use a hex or tailwind-inspired shade if preferred */
+  color: white !important;
+  padding: 0.5em 1em;
+  margin: 0;
+  font-weight: 500;
+}
+
+.announcement a {
+  color: white !important;
+  text-decoration: underline;
+}
+
+.announcement strong {
+  font-weight: 700;
+}

notebooks/tutorials/ioggm.ipynb

@@ -9,7 +9,7 @@
     "\n",
     "This tutorial gives you the tools to run IGM within OGGM and also compare it with OGGM runs. \n",
     "\n",
-    "**This is very much work in progress.** You'll need an IGM installation for this to run. The notebook currently does not run on OGGM Hub or is not displayed on the website, because of the Tensorflow depedency. We are working on it!"
+    "**This is very much work in progress.** You'll need an IGM installation for this to run. The notebook currently does not run on OGGM Hub, because of the Tensorflow depedency. We are working on it!"
    ]
   },
   {
@@ -87,8 +87,9 @@
    "id": "5",
    "metadata": {},
    "source": [
-    "### Activate the 3 lines of code in the following code block to match the starting volume with the consensus volume (Farinotti et al. 2019) \n",
-    "#### Note: the consensus volume is used as a reference volume for OGGM's dynamic spinup during the bed inversion as a reference volume, but in the further workflow only the RGI-area is matched and not the consensus volume. "
+    "Activate the 3 lines of code in the following code block to match the starting volume with the consensus volume (Farinotti et al. 2019) \n",
+    "\n",
+    "Note: the consensus volume is used as a reference volume for OGGM's dynamic spinup during the bed inversion as a reference volume, but in the further workflow only the RGI-area is matched and not the consensus volume. "
    ]
   },
   {
@@ -111,7 +112,7 @@
    "id": "7",
    "metadata": {},
    "source": [
-    "### Running OGGM Flowline with a GCM Climate"
+    "## Running OGGM Flowline with a GCM Climate"
    ]
   },
   {
@@ -160,8 +161,9 @@
    "id": "10",
    "metadata": {},
    "source": [
-    "### create the corresponding mass balance model(MB model) of the run above, so that the iOGGM run can be forced with same MB model\n",
-    "#### (using this MB model with the instructed-oggm doesn't work yet)"
+    "## create the corresponding mass balance model(MB model) of the run above, so that the iOGGM run can be forced with same MB model\n",
+    "\n",
+    "(using this MB model with the instructed-oggm doesn't work yet)"
    ]
   },
   {
@@ -182,8 +184,9 @@
    "id": "12",
    "metadata": {},
    "source": [
-    "### Running OGGM Flowline with a Random Climate \n",
-    "#### this run is forced with climate data from 1999-2019 randomly sampled"
+    "## Running OGGM Flowline with a Random Climate \n",
+    "\n",
+    "this run is forced with climate data from 1999-2019 randomly sampled"
    ]
   },
   {
@@ -209,7 +212,7 @@
    "id": "14",
    "metadata": {},
    "source": [
-    "### create the corresponding random mass balance model(MB model) of the run above, so that the iOGGM run can be forced with same random MB model"
+    "## create the corresponding random mass balance model(MB model) of the run above, so that the iOGGM run can be forced with same random MB model"
    ]
   },
   {
@@ -260,8 +263,9 @@
    "id": "18",
    "metadata": {},
    "source": [
-    "### Running the iOGGM from the consensus ice thickness (Farinotti et al. 2019)\n",
-    "#### once with random and once with the same GCM climate as above"
+    "## Running the iOGGM from the consensus ice thickness (Farinotti et al. 2019)\n",
+    "\n",
+    "once with random and once with the same GCM climate as above"
    ]
   },
   {
@@ -302,8 +306,9 @@
    "id": "21",
    "metadata": {},
    "source": [
-    "### Running the iOGGM from the Cook et al. 2023 ice thickness product\n",
-    "#### once with random and once with the same GCM climate as above"
+    "## Running the iOGGM from the Cook et al. 2023 ice thickness product\n",
+    "\n",
+    "once with random and once with the same GCM climate as above"
    ]
   },
   {
@@ -382,7 +387,7 @@
    "id": "28",
    "metadata": {},
    "source": [
-    "#### adapt starting date for the random runs"
+    "adapt starting date for the random runs"
    ]
   },
   {

notebooks/tutorials/massbalance_perturbation.ipynb

@@ -472,7 +472,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.4"
+   "version": "3.12.4"
   },
   "latex_envs": {
    "LaTeX_envs_menu_present": true,

notebooks/welcome.ipynb

@@ -8,7 +8,14 @@
     "\n",
     "If you are new to jupyter notebooks or to jupyterlab, we recommend to have a look at our [introduction to jupyter notebooks](https://edu.oggm.org/en/latest/notebooks_howto.html) first!\n",
     "\n",
-    "If you are reading this from our webpage (https://oggm.org/tutorials), remember that each page displayed here is in fact a jupyter notebook! You can start an interactive version of these tutorials online with [MyBinder](https://docs.oggm.org/en/latest/cloud.html) by clicking on the \"launch button\" on the top right of this page (the little rocket 🚀)."
+    "If you are reading this from our webpage (https://oggm.org/tutorials), remember that each page displayed here is in fact a jupyter notebook! You can start an interactive version of these tutorials online with [MyBinder](https://docs.oggm.org/en/latest/cloud.html) by clicking on the \"launch button\" on the top right of this page (the little rocket 🚀).\n",
+    "\n",
+    "⚠️ You can access various versions of these tutorials ont the web:\n",
+    "- [Stable](https://oggm.org/tutorials) (**the default**): the version of the tutorials working with the latest official release of OGGM\n",
+    "- [Development version](https://tutorials.oggm.org/master): the version of the tutorials working with the most up-to-date version of OGGM on github (unreleased)\n",
+    "- [v1.5.3](https://tutorials.oggm.org/v1.5.3/notebooks/welcome.html) (2022): legacy tutorials for the OGGM versions predating v1.6 and the mass-balance calibration overhaul.\n",
+    "\n",
+    "Note that you can download the notebooks for any of these versions on github by selecting a given branch: [stable](https://github.com/OGGM/tutorials/tree/stable), [master](https://github.com/OGGM/tutorials), [v1.5.3](https://github.com/OGGM/tutorials/tree/v1.5.3). Be aware of which versions you are using!"
    ]
   },
   {