Merge pull request #2309 from plotly/what_about_dash

what about dash?

Author: nicolaskruchten

doc/Makefile

@@ -30,6 +30,7 @@ $(IPYNB_FILES): $(IPYNB_DIR)/.mapbox_token
 $(IPYNB_DIR)/%.ipynb: $(MD_DIR)/%.md
 	@mkdir -p $(IPYNB_DIR)
 	@echo "[jupytext]   $<"
+	@cat what_about_dash.md >> $<
 	@jupytext $< --to notebook --quiet --output $@
 
 $(HTML_DIR)/2019-07-03-%.html: $(IPYNB_DIR)/%.ipynb

doc/what_about_dash.md

@@ -0,0 +1,28 @@
+
+<!-- #region -->
+### What About Dash?
+
+[Dash](https://dash.plot.ly/) is an open-source framework for building analytical applications, with no Javascript required, and it is tightly integrated with the Plotly graphing library.
+
+Learn about how to install Dash at https://dash.plot.ly/installation.
+
+Everywhere in this page that you see `fig.show()`, you can display the same figure in a Dash application by passing it to the `figure` argument of the [`Graph` component](https://dash.plot.ly/dash-core-components/graph) from the built-in `dash_core_components` package like this:
+
+```python
+import plotly.graph_objects as go # or plotly.express as px
+fig = go.Figure() # or any Plotly Express function e.g. px.bar(...)
+# fig.add_trace( ... )
+# fig.update_layout( ... )
+
+import dash
+import dash_core_components as dcc
+import dash_html_components as html
+
+app = dash.Dash()
+app.layout = html.Div([
+    dcc.Graph(figure=fig)
+])
+
+app.run_server(debug=True, use_reloader=False)  # Turn off reloader if inside Jupyter
+```
+<!-- #endregion -->