Merge branch 'main' into module-4

Author: maxrjones

.github/workflows/deploy-to-gh-pages.yml

@@ -5,9 +5,6 @@ on:
     branches: ["main"]
   workflow_dispatch:
 
-env:
-  BASE_URL: "/${{ github.event.repository.name }}"
-
 
 # Allow one concurrent deployment
 concurrency:

01-prerequisites.md

@@ -3,7 +3,7 @@
 This workshop requires a few prerequisites:
 
 
-## A computer with a web browser installed
+## A *fully-charged* computer with a web browser installed
 
 All activities in this workshop will be performed in a cloud computing environment
 called [CryoCloud](https://cryointhecloud.com/).
@@ -17,6 +17,15 @@ This means you can participate even on a Chromebook or a locked-down corporate c
 Please [sign up for a GitHub account](https://github.com/signup) if you haven't already.
 
 
+## Accept invitation to CryoCloud Slack
+
+You have been sent an invitation to join the CryoCloud Slack!
+Please accept it!
+
+All asynchronous support will occur on this Slack; if you need support with setup steps
+or questions after the workshop, Slack is the best place to ask.
+
+
 ## Complete the CryoCloud onboarding process
 
 1. Fill out this short [Getting Started Survey](https://forms.gle/d8oP1gp9YikS2ixM8) to give us the
@@ -45,3 +54,14 @@ will give you access to log in to CryoCloud.
   right up!
   * You will see a dialog to "Authorize nasa-cryo-prod" on your first login.
     **Click the green "Authorize 2i2c-org" button**.
+
+
+## Read relevant codes of conduct
+
+### [The AGU Code of Conduct](https://connect.agu.org/codeofconduct)
+
+Specifically, please read the sections titled **The rules** and **Discussion group
+etiquette**.
+
+
+### [The CryoCloud Code of Conduct](https://book.cryointhecloud.com/code-of-conduct)

02-schedule.md

@@ -7,6 +7,13 @@ These materials are under development and subject to change all the way until
 AGU!
 :::
 
+## 🍽️ Breakfast! (8:00-9:00)
+
+Breakfast will be provided in the room.
+
+Vegetarian options will be available and all ingredients will be listed.
+
+
 ## 🌅 Morning (8:30 - 12:00)
 
 | Time     | Duration   | Topic                                         | Presenter(s) |
@@ -16,16 +23,15 @@ AGU!
 | 9:25 AM  | 10 minutes | **Break**                                     |              |
 | 9:35 AM  | 60 minutes | [](modules/02-interactive-viz/index.ipynb)    | Qiusheng     |
 | 10:35 AM | 10 minutes | **Break**                                     |              |
-| 10:45 AM | 60 minutes | [](modules/03-integrating-ai/index.md)        | Qiusheng     |
+| 10:45 AM | 60 minutes | [](modules/03-integrating-ai/index.ipynb)     | Qiusheng     |
 | 11:45 AM | 15 minutes | **Q&A**                                       | All          |
 
 ## 🍽️ Lunch! (12:00 - 1:30)
 
-:::{important}
-AGU does not provide lunch.
+Lunch will be provided in the room.
+
+Vegetarian options will be available and all ingredients will be listed.
 
-We may do a group order for food delivery.
-:::
 
 ## 🌇 Afternoon (1:30 - 5:00)
 

assets/styles/style.css

@@ -9,3 +9,42 @@ body {
 [aria-label="Document Outline"] {
   max-height: calc(100vh - 100px) !important;
 }
+
+.myst-static-input-wrapper {
+  border: 1px solid #ccc;
+}
+
+.myst-static-input-wrapper::before {
+  content: "📥 MyST input";
+  display: block;
+  background-color: #f5f5f5;
+  border-bottom: 1px solid #ccc;
+  padding: 8px 12px;
+  font-weight: bold;
+  font-size: 14px;
+  color: #333;
+  margin: 0;
+}
+
+.myst-static-output-wrapper {
+  border: 1px solid #ccc;
+  margin-bottom: 20px;
+}
+
+.myst-static-output-wrapper::before {
+  content: "📤 MyST output";
+  display: block;
+  background-color: #f5f5f5;
+  border-bottom: 1px solid #ccc;
+  padding: 8px 12px;
+  font-weight: bold;
+  font-size: 14px;
+  color: #333;
+  margin: 0;
+}
+
+.myst-static-content {
+  padding-left: 12px;
+  padding-right: 12px;
+  margin: 0;
+}

docker/environment.yml

@@ -6,11 +6,12 @@ dependencies:
   - "jupyterlab>=4.4.2"
 
   # Some cool extensions
-  - "jupyterlab-favorites"
+  - "jupyterlab-favorites <3.3.0"  # 3.3.0 seems to introduce a bug duplicating headers in Notebook Markdown cells (https://github.com/jupyterlab-contrib/jupyterlab-favorites/issues/35)
   - "jupyter-collaboration>=3,<4"
   - "jupyter-server-proxy"
   - "jupyterlab-myst"
   - "jupyterlab-geojson"
+  - "jupyterlab_execute_time"
   - "nbdime"
 
   # Python mainstays
@@ -37,19 +38,22 @@ dependencies:
   - "shapely"
   - "fiona"
   - "pystac-client"
+  - "odc-stac"
+  - "ibis-duckdb"
+  - "exactextract"
 
   # geo viz
-  - "jupytergis >=0.9.2"
+  - "jupytergis >=0.10.1"
   - "leafmap"
   - "folium"
   - "cartopy"
   - "geoviews"
   - "maplibre"
 
   # Publishing
-  - "mystmd"
+  - "mystmd >=1.6.6"
   - "typst"
-  - "jupyter-myst-build-proxy >=0.5.0"
+  - "jupyter-myst-build-proxy >=0.5.1"
 
   # Testing and validation
   - "ruff"

docker/overrides.json

@@ -0,0 +1,8 @@
+{
+  "@jupyterlab/notebook-extension:tracker": {
+    "scrollPastEnd": false
+  },
+  "@jupyterlab/apputils-extension:notification": {
+    "fetchNews": "false"
+  }
+}

docker/postBuild

@@ -7,3 +7,7 @@ set -euo pipefail
 # used in the JupyterHub.
 cp custom_jupyter_server_config.json ${NB_PYTHON_PREFIX}/etc/jupyter/jupyter_server_config.d/
 cp custom_jupyter_server_config.json ${NB_PYTHON_PREFIX}/etc/jupyter/jupyter_notebook_config.d/
+
+# Install settings overrides, including fix for jumping-scroll behavior
+mkdir -p ${NB_PYTHON_PREFIX}/share/jupyter/lab/settings
+cp overrides.json ${NB_PYTHON_PREFIX}/share/jupyter/lab/settings

for-instructors/helpers.md

@@ -0,0 +1,25 @@
+# 🪄 Helpers
+
+This repository includes a `plugin-custom-directives.mjs` file which defines custom
+directives that will save some time authoring certain repeated elements.
+
+## Git commit checkpoint directive
+
+```{myst:static}
+:::{gitCommitCheckpoint} my commit message
+:::
+```
+
+
+## "You should notice..." directive
+
+``````{myst:static}
+:::{youShouldNotice}
+...the `{youShouldNotice}` directive fully supports markdown in the body.
+This means you can, for example include some code:
+
+```python
+print("Some code!")
+```
+:::
+``````

for-instructors/style-guide.md

@@ -209,6 +209,30 @@ E.g.:
 :::
 ```
 
+**As a shortcut, you can use the `{youShouldNotice}` directive.**
+See [](./helpers.md).
+
+
+#### Committing
+
+Use 💾 in a callout to indicate that the user should stop and do a commit now.
+Provide the full set of commands the user should run.
+
+``````{myst}
+:::{important} 💾 Commit & push to GitHub
+:icon: false
+
+```bash
+git add .
+git commit -m "Commit message"
+git push -u origin main
+```
+:::
+``````
+
+**As a shortcut, you can use the `{gitCommitCheckpoint}` directive.**
+See [](./helpers.md).
+
 
 ### Voice / language
 

index.md

@@ -1,10 +1,24 @@
+# AGU 2025 Workshop: Open Geospatial Workflows in the Cloud
+
+**What**: A full-day hands-on workshop; breakfast, lunch, and coffee provided.
+**All materials are available on this website**!
+AGU's identifier for this workshop is [SCIWS10](https://agu.confex.com/agu/agu25/meetingapp.cgi/Session/252640).
+The GeoJupyter community is hosting a total of 4 events; you can learn more at the
+[GeoJupyter @ AGU2025 landing page](https://events.geojupyter.org/conferences/2025-agu/)!
+
+**When**: Thursday, December 18, 2025 @ 8:30 AM - 5:00 PM CT
+
+**Where**: New Orleans Convention Center rooms 333-334
+
 :::{attention} 🏗️  Under development
 :icon: false
 
 These materials are under development and subject to change all the way until
 AGU!
 :::
 
+## Workshop abstract
+
 In an era where cutting-edge research demands flexibility, collaboration, and
 reproducibility, having the right set of tools is imperative.
 This workshop propels you into the future with modern, cloud-based workflows for