more progress on examples

Author: gvwilson

docs/bin/example_pages.py

@@ -53,10 +53,11 @@ def _make_html(examples):
         accum.append('<div class="section">\n')
         accum.append('  <div class="row auto-eg-padding">\n')
 
-        accum.append(_make_html_name(path, header))
+        _make_html_name(accum, path, header)
 
         accum.append('  <div class="row">\n')
-        accum.append(_make_html_text(path, header, content))
+        _make_html_text(accum, path, header, content)
+        _make_plot_url(accum, path, header, content)
         accum.append("  </div>\n")
 
         accum.append("    </div>\n")
@@ -74,12 +75,12 @@ def _make_html(examples):
 """
 
 
-def _make_html_name(path, header):
+def _make_html_name(accum, path, header):
     """Make example name block."""
     name = header["name"] if header["name"] else ""
     _log(not name, f"{path} does not have name")
     name = _strip_html(name.replace(" ", "-").replace(",", "").lower())
-    return HTML_NAME.format(name=name)
+    accum.append(HTML_NAME.format(name=name))
 
 
 HTML_TEXT = """\
@@ -103,7 +104,7 @@ def _make_html_name(path, header):
 """
 
 
-def _make_html_text(path, header, content):
+def _make_html_text(accum, path, header, content):
     """Make text of example."""
     columns = "twelve" if "horizontal" in header.get("arrangement", "") else "six"
     markdown_content = markdown(header.get("markdown_content", ""))
@@ -112,12 +113,58 @@ def _make_html_text(path, header, content):
     )
     description = header.get("description", "")
     description = HTML_TEXT_DESCRIPTION.format(text=description) if description else ""
-    return HTML_TEXT.format(
+    accum.append(HTML_TEXT.format(
         columns=columns,
         markdown_content=markdown_content,
         page_content=page_content,
         description=description,
-    )
+    ))
+
+
+
+PLOT_URL = """\
+            <div class="{columns} columns">
+              {plot_url_img}
+              {plot_url_embed}
+            </div>
+"""
+
+PLOT_URL_IMG = """\
+                <img src="{plot_url}" />
+"""
+
+PLOT_URL_EMBED = """\
+                <iframe id="auto-examples" src="{plot_url}{embed_class}"
+                style="width: {width} height: {height} border: none;"></iframe>
+"""
+
+def _make_plot_url(accum, path, header, content):
+    """Handle specified plot URL."""
+    plot_url = header.get("plot_url")
+    if not plot_url:
+        return
+    columns = "twelve" if "horizontal" in header.get("arrangement", "") else "six"
+
+    plot_url_img = ""
+    plot_url_embed = ""
+    if (".gif" in plot_url) or (".png" in plot_url):
+        plot_url_img = PLOT_URL_IMG.format(plot_url=plot_url)
+    else:
+        embed_class = ".embed" if "plot.ly" in plot_url else ""
+        width = f"{header.get('width', '550')}px"
+        height = f"{header.get('height', '550')}px"
+        plot_url_embed = PLOT_URL_EMBED.format(
+            plot_url=plot_url,
+            embed_class=embed_class,
+            width=width,
+            height=height,
+        )
+    accum.append(PLOT_URL.format(
+        columns=columns,
+        plot_url=plot_url,
+        plot_url_img=plot_url_img,
+        plot_url_embed=plot_url_embed,
+    ))
 
 
 def _parse_args():