Merge pull request #2 from jupyter-book/sp/separate-dir-types

🗂️ separate pages for figures, embeds, xrefs

Author: stevejpurves

content/embeds.md

@@ -0,0 +1,18 @@
+# Embeds
+
+MyST This supports embedding of notebook content and other files. The following are some examples using the embed directive. 
+
+## A Matplotlib Output
+
+:::{embed} #fig-matplotlib
+:::
+
+## A Plotly Figure
+
+:::{embed} #fig-plotly-output
+:::
+
+## A Bokeh Figure
+
+:::{embed} #fig-bokeh
+:::

content/external.md

@@ -0,0 +1,14 @@
+# External content
+
+MyST Supports cross-referencing into external content in order to create figures and embeds. External content could be in a different version of the AST and would need special handling.
+
+
+## An External Figure!
+
+![](xref:guide#img:altair-horsepower)
+
+
+## An External Embed!
+
+:::{embed} xref:guide#img:altair-horsepower
+:::

content/figures.md

@@ -0,0 +1,18 @@
+# Figures
+
+MyST supports using notebook outputs inside figures, This page contains some examples. 
+
+## A Matplotlib Figure
+
+![](#fig-matplotlib)
+
+## A Plotly Figure
+
+:::{figure} #fig-plotly-output
+A plotly figure
+:::
+
+## A Bokeh Figure
+
+![](#fig-bokeh)
+

content/index.md

@@ -1,20 +1,8 @@
 # Plots
 
-MyST supports embedding plots from other pages and site! Here are some such plots, such as [](#fig-plotly-output) and [](#fig-bokeh-output). See them below!
+MyST supports embedding plots from other pages and site! Here are some such plots, such as [](#fig-plotly-output) and [](#fig-bokeh-output).
 
-## A Plotly Figure
+* [](./figures.md)
+* [](./embeds.md)
+* [](./external.md)
 
-:::{embed} #fig-plotly-output
-:::
-
-## A Bokeh Figure
-
-![](#fig-bokeh)
-
-## A Matplotlib Figure
-
-![](#fig-matplotlib)
-
-## An External Figure!
-
-![](xref:guide#img:altair-horsepower)

myst.yml

@@ -7,6 +7,9 @@ project:
     guide: https://mystmd.org/guide
   toc:
     - file: content/index.md
+    - file: content/figures.md
+    - file: content/embeds.md
+    - file: content/external.md
     - file: content/bokeh.md
     - file: content/plotly.md
     - file: content/matplotlib.md