checking for a possible bug in xrefs (or is it my dev version of myst?)

Author: parmentelat

notebooks/2-05-folium-nb.md notebooks/2-05-xrefs-nb.mdnotebooks/2-05-folium-nb.md renamed to notebooks/2-05-xrefs-nb.md

@@ -16,13 +16,26 @@ language_info:
 
 +++ {"slideshow": {"slide_type": ""}, "tags": []}
 
-# folium (and embeds)
+# x-refs 
+
+playing with labeled cells, embed, figure ...
+
+trying with cells that produce:
+
+- a 2d plot
+- a pandas df
+- a folium map
 
 +++
 
 ## matplotlib output
 
-+++
+```{code-cell} ipython3
+import numpy as np
+import matplotlib.pyplot as plt
+```
+
++++ {"jp-MarkdownHeadingCollapsed": true}
 
 ### the source cell
 
@@ -31,9 +44,6 @@ we put a label `the-labeled-plot` on the following code cell
 ```{code-cell} ipython3
 #| label: the-labeled-plot
 
-import numpy as np
-import matplotlib.pyplot as plt
-
 X = np.linspace(0, 2*np.pi)
 Y = np.sin(X)
 
@@ -43,11 +53,77 @@ plt.plot(X, Y);
 
 ### referencing `the-labeled-plot`
 
-- with a `![](#label)` ![](#the-labeled-plot)
-- same without the ! [](#the-labeled-plot)
-- with an `embed`directive
-  ```{embed} #the-labeled-plot
-  ```
++++
+
+---
+
++++
+
+#### WITHOUT -- the exclamation mark
+
+we write this 
+`[some visible text](#the-labeled-plot)` 
+ [some visible text](#the-labeled-plot)
+
++++
+
+---
+
++++
+
+#### WITH --  an exclamation mark
+we write this 
+`![](#the-labeled-plot)` (text in brackets doesn't seem to be used)
+ ![](#the-labeled-plot)
+
++++
+
+---
+
++++
+
+#### EMBED instead
+
+now we use an `embed` directive - with a sharp `#` in front of the label
+
+```{embed} #the-labeled-plot
+```
+
++++
+
+---
+
++++
+
+#### FIGURE instead
+
+now we use an `figure` directive - same thing, with a sharp `#` in front of the label
+
+```{figure} #the-labeled-plot
+some figure text goes here
+```
+
++++
+
+---
+---
+
++++
+
+## pandas df
+
+```{code-cell} ipython3
+import seaborn as sns
+```
+
+```{code-cell} ipython3
+#| label: the-labeled-map
+
+titanic = sns.load_dataset("titanic")
+titanic.head(2)
+```
+
+hover on [this text to view the dataframe](#the-labeled-map)
 
 +++
 
@@ -84,14 +160,6 @@ def paris_map():
 paris_map()
 ```
 
-### the embedded result with an `{embed}` directive
-
-once this is done we can show the cell output 
-```{embed} #the-labeled-map
-```
-
-+++
-
-### same but with a `![]()`
+### referencing the map
 
-![alternative text](#the-labeled-map)
+[this should show a map ?](#the-labeled-map)