Add getting started and installation instructions to the welcome page

Editing the front page to include a one-click Binder link to run the Jupyter notebooks, and steps for people to get a conda virtual environment set up locally for the AGU24 pre-conference workshop.

Based on EGU22 short course at GenericMappingTools/egu22pygmt#10.

Author: weiji14

book/_toc.yml

@@ -4,11 +4,13 @@
 format: jb-book
 root: intro
 parts:
-- caption: Details
+- caption: 🔗 Details
   chapters:
     - title: AGU24 Homepage
       url: https://www.agu.org/annual-meeting
-- caption: Tutorials
+    - title: Course materials on GitHub
+      url: https://github.com/GenericMappingTools/agu24workshop
+- caption: 🧑‍🏫 Tutorials
   chapters:
   - file: markdown
   - file: notebooks

book/intro.md

@@ -1,11 +1,90 @@
-# Welcome to your Jupyter Book
+# Mastering Geospatial Visualizations with GMT/PyGMT
 
-This is a small sample book to give you a feel for how book content is
-structured.
-It shows off a few of the major file types, as well as some sample content.
-It does not go in-depth into any particular topic - check out [the Jupyter Book documentation](https://jupyterbook.org) for more information.
+## Welcome to the AGU24 GMT/PyGMT workshop 🥳
 
-Check out the content pages bundled with this sample book to see more.
+This Jupyter book 📖 contains [GMT](https://docs.generic-mapping-tools.org/6.5) and
+[PyGMT](https://www.pygmt.org/v0.13.0) tutorials for producing maps 🗺️ and doing
+geospatial data processing 🌐
 
 ```{tableofcontents}
 ```
+
+Each tutorial is rendered on this website for easy viewing 👀, but they are all Jupyter
+notebooks designed to be ran interactively 💫. See the instructions below on how you can
+start running the tutorials in no time! 🚀
+
+
+# 🌠 Quickstart
+
+To run these notebooks in an interactive Jupyter session online, 🖱️ click on the button
+below to launch on regular
+[Binder](https://mybinder.readthedocs.io/en/latest/index.html).
+
+[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/GenericMappingTools/agu24workshop/main)
+
+Alternatively, you can go to a specific tutorial page, hover over the rocket 🚀 icon on
+the top right, and click 'Binder'.
+
+# 💻 Running the notebooks locally
+
+If you prefer to run the 🧑‍🏫 tutorials with a local installation of GMT/PyGMT, then
+follow along! For this AGU24 workshop, we recommend creating a virtual conda environment
+and installing the C and 🐍 Python libraries inside.
+
+:::{tip} For users comfortable with using `git`, feel free to ⬇️ download or clone the
+repository containing the workshop materials directly using
+`git clone https://github.com/GenericMappingTools/agu24workshop.git`
+:::
+
+Here's the instructions to install the `agu24workshop` environment:
+
+1. Ensure that you have the
+   [`conda`](https://docs.conda.io/projects/conda/en/latest/user-guide/index.html)
+   package manager installed (e.g. via
+   [`miniconda`](https://docs.anaconda.com/miniconda) or
+   [Anaconda](https://www.anaconda.com/download)). You can also use
+   [`mamba`](https://mamba.readthedocs.io/en/stable/installation/mamba-installation.html)
+   which tends to be a ⚡ faster alternative.
+
+2. Make a folder called 'agu24workshop'. This will be where you will put all the Jupyter
+   notebooks and data files 🗃️ used in the workshop.
+
+3. Download a copy of the 'environment.yml' file which contains a 📄 list of
+   dependencies required to run the tutorials in this workshop. Get it at
+   https://github.com/GenericMappingTools/agu24workshop/blob/main/environment.yml.
+
+4. Run the following commands on the 🧑‍💻 command-line to create the virtual environment
+
+    ```bash
+    cd /path/to/agu24workshop
+    conda env create --name agu24workshop --file environment.yml
+    ```
+
+5. Once the installation is completed 🏁, launch
+   [Jupyter Lab](https://jupyterlab.readthedocs.io) as follows:
+
+    ```bash
+    conda activate agu24workshop
+    jupyter lab
+    ```
+
+   This should open up a page in your default browser. If not, you can click and open
+   the 🔗 link that says `http://localhost:8888/lab?token=...` in your command-line
+   terminal and this will will take you to the Jupyter Lab page.
+
+6. Download the Jupyter notebook(s) you want to run (e.g.
+   https://www.generic-mapping-tools.org/agu24workshop/first-figure.html) using either
+   the download button on the ↗️ top right (select '.ipynb') or from GitHub at
+   https://github.com/GenericMappingTools/agu24workshop/tree/main/book. Make sure to put
+   the *.ipynb file(s) inside of the 'agu24workshop' folder.
+
+7. Open the Jupyter notebook in the left-pane file browser, e.g. by 🖱️ double-clicking
+   on `first-figure.ipynb`. You are now ready to run through the course materials 🎉!
+
+```{note}
+If you're intending to use GMT/PyGMT in another project outside of this course, please
+follow the official installation instructions at:
+
+- https://docs.generic-mapping-tools.org/latest/install.html
+- https://www.pygmt.org/latest/install.html
+```