move all readme docs to documenter

Author: joshday

README.md

@@ -34,109 +34,3 @@ p  # `display(p)` to see the updated plot
 <p align="center">
     <img width=650 src="https://user-images.githubusercontent.com/8075494/213164013-3ba1a108-122a-4339-a0a2-fa2175fa06e3.png">
 </p>
-
-<br><br>
-
-## 📈 Traces
-
-- A core concept in Plotly is that of a *trace*, which is the data along with specifications on how to plot it.
-- There are many different trace *types* (e.g. "scatter" for scatterplots, "box" for boxplots).
-
-
-PlotlyLight does some simple "tricks" with the `plot` function so that:
-
-```julia
-plot.trace(; kw...) == plot(; type=trace, kw...)
-```
-
-**This lets you tab-autocomplete the trace type:**
-
-```julia
-julia> plot.<TAB>
-# bar                 barpolar            box                 candlestick
-# carpet              choropleth          choroplethmapbox    cone
-# contour             contourcarpet       densitymapbox       funnel
-# funnelarea          heatmap             heatmapgl           histogram
-# histogram2d         histogram2dcontour  icicle              image
-# indicator           isosurface          mesh3d              ohlc
-# parcats             parcoords           pie                 pointcloud
-# sankey              scatter             scatter3d           scattercarpet
-# scattergeo          scattergl           scattermapbox       scatterpolar
-# scatterpolargl      scattersmith        scatterternary      splom
-# streamtube          sunburst            surface             table
-# treemap             violin              volume              waterfall
-```
-
-**You can chain the dot syntax to add traces to a plot, e.g.**
-
-```julia
-y = randn(20)
-
-plot.bar(; y).scatter(; y)
-```
-
-<br><br>
-
-## 📄 Saving Plots
-
-### Saving Plots As HTML
-
-```julia
-p = plot(y=rand(10))
-
-PlotlyLight.save(p, "myplot.html")
-```
-
-- Note: call `preset.source.standalone!()` first if you want the html file to contain the entire plotly.js script.  This enables you to view the plot even without internet access.
-
-
-### Save Plots as Image via [PlotlyKaleido.jl](https://github.com/JuliaPlots/PlotlyKaleido.jl)
-
-```julia
-using PlotlyKaleido
-
-PlotlyKaleido.start()
-
-(;data, layout, config) = p
-
-PlotlyKaleido.savefig((; data, layout, config), "myplot.png")
-```
-
-<br><br>
-
-## 🎛️ Presets
-
-### Theme Presets
-
-Set a theme/template via `preset.template.<option>!()`.  Note that options are tab-autocomplete-able.  These are borrowed from the [built-in themes](https://plotly.com/python/templates/) in the plotly python package.
-
-```julia
-preset.template.ggplot2!()
-```
-
-### Source Presets
-
-Change how the plotly.js script gets loaded in the produced html via `preset.source.<option>!()`.
-
-```julia
-preset.source.none!()       # Don't include the script.
-preset.source.cdn!()        # Use the official plotly.js CDN.
-preset.source.local!()      # Use a local version of the plotly.js script.
-preset.source.standalone!() # Copy-paste the plotly.js script into the html output.
-```
-
-<br><br>
-
-## ⚙️ Settings
-
-Occasionally `preset`s aren't enough.  Lower level user-configurable settings are available in `PlotlyLight.settings`:
-
-```julia
-PlotlyLight.settings.src::Cobweb.Node           # plotly.js script loader
-PlotlyLight.settings.div::Cobweb.Node           # The plot-div
-PlotlyLight.settings.layout::EasyConfig.Config  # default `layout` for all plots
-PlotlyLight.settings.config::EasyConfig.Config  # default `config` for all plots
-PlotlyLight.settings.reuse_preview::Bool        # In the REPL, open plots in same page (true, the default) or different pages.
-```
-
-Check out e.g. `PlotlyLight.Settings().src` to examine default values.

docs/make.jl

@@ -11,6 +11,9 @@ makedocs(
         "index.md",
         "plotly_basics.md",
         "templates.md",
+        "saving.md",
+        "source.md",
+        "settings.md",
     ]
 )