update book as per release 0.9.1

andrei-ng · andrei-ng · commit b33fea687f09 · 2024-09-06T13:39:25.000+02:00
Signed-off-by: Andrei Gherghescu &lt;8067229+andrei-ng@users.noreply.github.com&gt;
diff --git a/content/fundamentals/shapes.html b/content/fundamentals/shapes.html
@@ -188,7 +188,7 @@ <h1 id="shapes"><a class="header" href="#shapes">Shapes</a></h1>
     Axis, GridPattern, Layout, LayoutGrid, Margin, Shape, ShapeLayer, ShapeLine,
     ShapeType,
 };
-use plotly::{Bar, NamedColor, Plot, Scatter};
+use plotly::{Bar, color::NamedColor, Plot, Scatter};
 use rand::thread_rng;
 use rand_distr::{Distribution, Normal};
 <span class="boring">}</span></code></pre></pre>
diff --git a/content/getting_started.html b/content/getting_started.html
@@ -196,7 +196,7 @@ <h1 class="menu-title">Plotly.rs Book</h1>
 <h1 id="getting-started"><a class="header" href="#getting-started">Getting Started</a></h1>
 <p>To start using <a href="https://github.com/plotly/plotly.rs">plotly.rs</a> in your project add the following to your <code>Cargo.toml</code>:</p>
 <pre><code class="language-toml">[dependencies]
-plotly = "0.9.0"
+plotly = "0.9.1"
 </code></pre>
 <p><a href="https://github.com/plotly/plotly.rs">Plotly.rs</a> is ultimately a thin wrapper around the <code>plotly.js</code> library. The main job of this library is to provide <code>structs</code> and <code>enums</code> which get serialized to <code>json</code> and passed to the <code>plotly.js</code> library to actually do the heavy lifting. As such, if you are familiar with <code>plotly.js</code> or its derivatives (e.g. the equivalent Python library), then you should find <a href="https://github.com/plotly/plotly.rs"><code>plotly.rs</code></a> intuitive to use.</p>
 <p>A <code>Plot</code> struct contains one or more <code>Trace</code> objects which describe the structure of data to be displayed. Optional <code>Layout</code> and <code>Configuration</code> structs can be used to specify the layout and config of the plot, respectively.</p>
@@ -252,7 +252,7 @@ <h1 id="getting-started"><a class="header" href="#getting-started">Getting Start
 <h2 id="saving-plots"><a class="header" href="#saving-plots">Saving Plots</a></h2>
 <p>To add the ability to save plots in the following formats: png, jpeg, webp, svg, pdf and eps, you can use the <code>kaleido</code> feature. This feature depends on <a href="https://github.com/plotly/Kaleido">plotly/Kaleido</a>: a cross-platform open source library for generating static images. All the necessary binaries have been included with <code>plotly_kaleido</code> for <code>Linux</code>, <code>Windows</code> and <code>MacOS</code>. Previous versions of <a href="https://github.com/plotly/plotly.rs">plotly.rs</a> used the <code>orca</code> feature, however, this has been deprecated as it provided the same functionality but required additional installation steps. To enable the <code>kaleido</code> feature add the following to your <code>Cargo.toml</code>:</p>
 <pre><code class="language-toml">[dependencies]
-plotly = { version = "0.9.0", features = ["kaleido"] }
+plotly = { version = "0.9.1", features = ["kaleido"] }
 </code></pre>
 <h2 id="webassembly-support"><a class="header" href="#webassembly-support">WebAssembly Support</a></h2>
 <p>As of v0.8.0, <a href="https://github.com/plotly/plotly.rs">plotly.rs</a> can now be used in a <code>Wasm</code> environment by enabling the <code>wasm</code> feature in your <code>Cargo.toml</code>:</p>
diff --git a/content/print.html b/content/print.html
diff --git a/content/recipes/basic_charts/bar_charts.html b/content/recipes/basic_charts/bar_charts.html
@@ -185,7 +185,7 @@ <h1 id="bar-charts"><a class="header" href="#bar-charts">Bar Charts</a></h1>
     ColorScale, ColorScalePalette, DashType, Fill, Font, Line, LineShape, Marker, Mode, Title,
 };
 use plotly::layout::{Axis, BarMode, Layout, Legend, TicksDirection};
-use plotly::{Bar, NamedColor, Plot, Rgb, Rgba, Scatter};
+use plotly::{Bar, color::{NamedColor, Rgb, Rgba}, Plot, Scatter};
 use rand_distr::{Distribution, Normal, Uniform};
 <span class="boring">}</span></code></pre></pre>
 <p>The <code>to_inline_html</code> method is used to produce the html plot displayed in this page.</p>
diff --git a/content/recipes/basic_charts/line_charts.html b/content/recipes/basic_charts/line_charts.html
@@ -185,7 +185,7 @@ <h1 id="line-charts"><a class="header" href="#line-charts">Line Charts</a></h1>
     ColorScale, ColorScalePalette, DashType, Fill, Font, Line, LineShape, Marker, Mode, Title,
 };
 use plotly::layout::{Axis, BarMode, Layout, Legend, TicksDirection};
-use plotly::{Bar, NamedColor, Plot, Rgb, Rgba, Scatter};
+use plotly::{Bar, color::{NamedColor, Rgb, Rgba}, Plot, Scatter};
 use rand_distr::{Distribution, Normal, Uniform};
 <span class="boring">}</span></code></pre></pre>
 <p>The <code>to_inline_html</code> method is used to produce the html plot displayed in this page.</p>
@@ -203,7 +203,7 @@ <h2 id="adding-names-to-line-and-scatter-plot"><a class="header" href="#adding-n
         .mode(Mode::LinesMarkers)
         .name("Scatter + Lines");
 
-    let layout = Layout::new().title(Title::new("Adding Names to Line and Scatter Plot"));
+    let layout = Layout::new().title(Title::with_text("Adding Names to Line and Scatter Plot"));
     let mut plot = Plot::new();
     plot.add_trace(trace1);
     plot.add_trace(trace2);
@@ -248,7 +248,7 @@ <h2 id="line-and-scatter-styling"><a class="header" href="#line-and-scatter-styl
         .marker(Marker::new().color(Rgb::new(128, 0, 128)).size(12))
         .line(Line::new().color(Rgb::new(128, 0, 128)).width(1.0));
 
-    let layout = Layout::new().title(Title::new("Line and Scatter Styling"));
+    let layout = Layout::new().title(Title::with_text("Line and Scatter Styling"));
     let mut plot = Plot::new();
     plot.add_trace(trace1);
     plot.add_trace(trace2);
@@ -288,7 +288,7 @@ <h2 id="styling-line-plot"><a class="header" href="#styling-line-plot">Styling L
         .line(Line::new().color(Rgb::new(55, 128, 191)).width(1.0));
 
     let layout = Layout::new()
-        .title(Title::new("Styling Line Plot"))
+        .title(Title::with_text("Styling Line Plot"))
         .width(500)
         .height(500);
     let mut plot = Plot::new();
diff --git a/content/recipes/basic_charts/scatter_plots.html b/content/recipes/basic_charts/scatter_plots.html
@@ -185,7 +185,7 @@ <h1 id="scatter-plots"><a class="header" href="#scatter-plots">Scatter Plots</a>
     ColorScale, ColorScalePalette, DashType, Fill, Font, Line, LineShape, Marker, Mode, Title,
 };
 use plotly::layout::{Axis, BarMode, Layout, Legend, TicksDirection};
-use plotly::{Bar, NamedColor, Plot, Rgb, Rgba, Scatter};
+use plotly::{Bar, color::{NamedColor, Rgb, Rgba}, Plot, Scatter};
 use rand_distr::{Distribution, Normal, Uniform};
 <span class="boring">}</span></code></pre></pre>
 <p>The <code>to_inline_html</code> method is used to produce the html plot displayed in this page.</p>
@@ -329,9 +329,9 @@ <h2 id="data-labels-hover"><a class="header" href="#data-labels-hover">Data Labe
     plot.add_trace(trace2);
 
     let layout = Layout::new()
-        .title(Title::new("Data Labels Hover"))
-        .x_axis(Axis::new().title(Title::new("x")).range(vec![0.75, 5.25]))
-        .y_axis(Axis::new().title(Title::new("y")).range(vec![0., 8.]));
+        .title(Title::with_text("Data Labels Hover"))
+        .x_axis(Axis::new().title(Title::with_text("x")).range(vec![0.75, 5.25]))
+        .y_axis(Axis::new().title(Title::with_text("y")).range(vec![0., 8.]));
     plot.set_layout(layout);
     if show {
         plot.show();
@@ -372,7 +372,7 @@ <h2 id="data-labels-on-the-plot"><a class="header" href="#data-labels-on-the-plo
     plot.add_trace(trace2);
 
     let layout = Layout::new()
-        .title(Title::new("Data Labels on the Plot"))
+        .title(Title::with_text("Data Labels on the Plot"))
         .x_axis(Axis::new().range(vec![0.75, 5.25]))
         .y_axis(Axis::new().range(vec![0., 8.]));
     plot.set_layout(layout);
@@ -464,14 +464,14 @@ <h2 id="colored-and-styled-scatter-plot"><a class="header" href="#colored-and-st
     .marker(Marker::new().color(Rgb::new(142, 124, 195)).size(12));
 
     let layout = Layout::new()
-        .title(Title::new("Quarter 1 Growth"))
+        .title(Title::with_text("Quarter 1 Growth"))
         .x_axis(
             Axis::new()
-                .title(Title::new("GDP per Capita"))
+                .title(Title::with_text("GDP per Capita"))
                 .show_grid(false)
                 .zero_line(false),
         )
-        .y_axis(Axis::new().title(Title::new("Percent")).show_line(false));
+        .y_axis(Axis::new().title(Title::with_text("Percent")).show_line(false));
     let mut plot = Plot::new();
     plot.add_trace(trace1);
     plot.add_trace(trace2);
diff --git a/content/recipes/financial_charts/time_series_and_date_axes.html b/content/recipes/financial_charts/time_series_and_date_axes.html
@@ -203,7 +203,7 @@ <h2 id="time-series-plot-with-custom-date-range"><a class="header" href="#time-s
 
     let layout = Layout::new()
         .x_axis(Axis::new().range(vec!["2016-07-01", "2016-12-31"]))
-        .title(Title::new("Manually Set Date Range"));
+        .title(Title::with_text("Manually Set Date Range"));
     plot.set_layout(layout);
 
     if show {
@@ -243,7 +243,7 @@ <h2 id="time-series-with-range-slider"><a class="header" href="#time-series-with
 
     let layout = Layout::new()
         .x_axis(Axis::new().range_slider(RangeSlider::new().visible(true)))
-        .title(Title::new("Manually Set Date Range"));
+        .title(Title::with_text("Manually Set Date Range"));
     plot.set_layout(layout);
 
     if show {
diff --git a/content/recipes/scientific_charts/contour_plots.html b/content/recipes/scientific_charts/contour_plots.html
@@ -247,7 +247,7 @@ <h2 id="colorscale-for-contour-plot"><a class="header" href="#colorscale-for-con
     ];
     let trace = Contour::new_z(z).color_scale(ColorScale::Palette(ColorScalePalette::Jet));
 
-    let layout = Layout::new().title(Title::new("Colorscale for Contour Plot"));
+    let layout = Layout::new().title(Title::with_text("Colorscale for Contour Plot"));
     let mut plot = Plot::new();
     plot.set_layout(layout);
     plot.add_trace(trace);
@@ -289,7 +289,7 @@ <h2 id="customizing-size-and-range-of-a-contour-plot-contours"><a class="header"
         .auto_contour(false)
         .contours(Contours::new().start(0.0).end(8.0).size(2));
 
-    let layout = Layout::new().title(Title::new("Customizing Size and Range of Contours"));
+    let layout = Layout::new().title(Title::with_text("Customizing Size and Range of Contours"));
     let mut plot = Plot::new();
     plot.set_layout(layout);
     plot.add_trace(trace);
@@ -334,7 +334,7 @@ <h2 id="customizing-spacing-between-x-and-y-ticks"><a class="header" href="#cust
         .dy(10.0)
         .y0(10.0);
 
-    let layout = Layout::new().title(Title::new("Customizing Size and Range of Contours"));
+    let layout = Layout::new().title(Title::with_text("Customizing Size and Range of Contours"));
     let mut plot = Plot::new();
     plot.set_layout(layout);
     plot.add_trace(trace);
diff --git a/content/recipes/statistical_charts/box_plots.html b/content/recipes/statistical_charts/box_plots.html
@@ -185,7 +185,7 @@ <h1 id="box-plots"><a class="header" href="#box-plots">Box Plots</a></h1>
 use plotly::common::{ErrorData, ErrorType, Line, Marker, Mode, Orientation, Title};
 use plotly::histogram::{Bins, Cumulative, HistFunc, HistNorm};
 use plotly::layout::{Axis, BarMode, BoxMode, Layout, Margin};
-use plotly::{Bar, BoxPlot, Histogram, NamedColor, Plot, Rgb, Rgba, Scatter};
+use plotly::{Bar, BoxPlot, Histogram, color::{NamedColor, Rgb, Rgba}, Scatter};
 use rand_distr::{Distribution, Normal, Uniform};
 
 <span class="boring">}</span></code></pre></pre>
@@ -328,7 +328,7 @@ <h2 id="grouped-box-plot"><a class="header" href="#grouped-box-plot">Grouped Box
     let layout = Layout::new()
         .y_axis(
             Axis::new()
-                .title(Title::new("normalized moisture"))
+                .title(Title::with_text("normalized moisture"))
                 .zero_line(false),
         )
         .box_mode(BoxMode::Group);
@@ -393,7 +393,7 @@ <h2 id="box-plot-styling-outliers"><a class="header" href="#box-plot-styling-out
         .marker(Marker::new().color(Rgb::new(107, 174, 214)))
         .box_points(BoxPoints::Outliers);
 
-    let layout = Layout::new().title(Title::new("Box Plot Styling Outliers"));
+    let layout = Layout::new().title(Title::with_text("Box Plot Styling Outliers"));
 
     let mut plot = Plot::new();
     plot.set_layout(layout);
@@ -442,7 +442,7 @@ <h2 id="box-plot-styling-mean-and-standard-deviation"><a class="header" href="#b
         .name("Mean and Standard Deviation")
         .marker(Marker::new().color(Rgb::new(8, 81, 156)))
         .box_mean(BoxMean::StandardDeviation);
-    let layout = Layout::new().title(Title::new("Box Plot Styling Mean and Standard Deviation"));
+    let layout = Layout::new().title(Title::with_text("Box Plot Styling Mean and Standard Deviation"));
 
     let mut plot = Plot::new();
     plot.set_layout(layout);
@@ -510,10 +510,10 @@ <h2 id="grouped-horizontal-box-plot"><a class="header" href="#grouped-horizontal
     plot.add_trace(trace3);
 
     let layout = Layout::new()
-        .title(Title::new("Grouped Horizontal Box Plot"))
+        .title(Title::with_text("Grouped Horizontal Box Plot"))
         .x_axis(
             Axis::new()
-                .title(Title::new("normalized moisture"))
+                .title(Title::with_text("normalized moisture"))
                 .zero_line(false),
         )
         .box_mode(BoxMode::Group);
diff --git a/content/recipes/statistical_charts/error_bars.html b/content/recipes/statistical_charts/error_bars.html
@@ -185,7 +185,7 @@ <h1 id="error-bars"><a class="header" href="#error-bars">Error Bars</a></h1>
 use plotly::common::{ErrorData, ErrorType, Line, Marker, Mode, Orientation, Title};
 use plotly::histogram::{Bins, Cumulative, HistFunc, HistNorm};
 use plotly::layout::{Axis, BarMode, BoxMode, Layout, Margin};
-use plotly::{Bar, BoxPlot, Histogram, NamedColor, Plot, Rgb, Rgba, Scatter};
+use plotly::{Bar, BoxPlot, Histogram, Plot, color::{NamedColor, Rgb, Rgba}, Scatter};
 use rand_distr::{Distribution, Normal, Uniform};
 
 <span class="boring">}</span></code></pre></pre>
diff --git a/content/recipes/statistical_charts/histograms.html b/content/recipes/statistical_charts/histograms.html
@@ -185,7 +185,7 @@ <h1 id="histograms"><a class="header" href="#histograms">Histograms</a></h1>
 use plotly::common::{ErrorData, ErrorType, Line, Marker, Mode, Orientation, Title};
 use plotly::histogram::{Bins, Cumulative, HistFunc, HistNorm};
 use plotly::layout::{Axis, BarMode, BoxMode, Layout, Margin};
-use plotly::{Bar, BoxPlot, Histogram, NamedColor, Plot, Rgb, Rgba, Scatter};
+use plotly::{Bar, BoxPlot, Histogram, Plot, color::{NamedColor, Rgb, Rgba}, Scatter};
 use rand_distr::{Distribution, Normal, Uniform};
 
 <span class="boring">}</span></code></pre></pre>
@@ -372,9 +372,9 @@ <h2 id="colored-and-styled-histograms"><a class="header" href="#colored-and-styl
         .auto_bin_x(false)
         .x_bins(Bins::new(-3.2, 4.0, 0.06));
     let layout = Layout::new()
-        .title(Title::new("Sampled Results"))
-        .x_axis(Axis::new().title(Title::new("Value")))
-        .y_axis(Axis::new().title(Title::new("Count")))
+        .title(Title::with_text("Sampled Results"))
+        .x_axis(Axis::new().title(Title::with_text("Value")))
+        .y_axis(Axis::new().title(Title::with_text("Count")))
         .bar_mode(BarMode::Overlay)
         .bar_gap(0.05)
         .bar_group_gap(0.2);
diff --git a/content/recipes/subplots/multiple_axes.html b/content/recipes/subplots/multiple_axes.html
@@ -180,7 +180,7 @@ <h1 id="multiple-axes"><a class="header" href="#multiple-axes">Multiple Axes</a>
 <p>The following imports have been used to produce the plots below:</p>
 <pre><pre class="playground"><code class="language-rust"><span class="boring">#![allow(unused)]
 </span><span class="boring">fn main() {
-</span>use plotly::common::{Font, Side, Title};
+</span>use plotly::common::{Font, AxisSide, Title};
 use plotly::layout::{Axis, GridPattern, Layout, LayoutGrid, Legend, RowOrder};
 use plotly::{Plot, Rgb, Scatter};
 <span class="boring">}</span></code></pre></pre>
@@ -199,14 +199,14 @@ <h2 id="two-y-axes"><a class="header" href="#two-y-axes">Two Y Axes</a></h2>
     plot.add_trace(trace2);
 
     let layout = Layout::new()
-        .title(Title::new("Double Y Axis Example"))
-        .y_axis(Axis::new().title(Title::new("yaxis title")))
+        .title(Title::with_text("Double Y Axis Example"))
+        .y_axis(Axis::new().title(Title::with_text("yaxis title")))
         .y_axis2(
             Axis::new()
-                .title(Title::new("yaxis2 title").font(Font::new().color(Rgb::new(148, 103, 189))))
+                .title(Title::with_text("yaxis2 title").font(Font::new().color(Rgb::new(148, 103, 189))))
                 .tick_font(Font::new().color(Rgb::new(148, 103, 189)))
                 .overlaying("y")
-                .side(Side::Right),
+                .side(AxisSide::Right),
         );
     plot.set_layout(layout);
     if show {
@@ -246,38 +246,38 @@ <h2 id="multiple-axes-1"><a class="header" href="#multiple-axes-1">Multiple Axes
     plot.add_trace(trace4);
 
     let layout = Layout::new()
-        .title(Title::new("multiple y-axes example"))
+        .title(Title::with_text("multiple y-axes example"))
         .width(800)
         .x_axis(Axis::new().domain(&amp;[0.3, 0.7]))
         .y_axis(
             Axis::new()
-                .title(Title::new("yaxis title").font(Font::new().color("#1f77b4")))
+                .title(Title::with_text("yaxis title").font(Font::new().color("#1f77b4")))
                 .tick_font(Font::new().color("#1f77b4")),
         )
         .y_axis2(
             Axis::new()
-                .title(Title::new("yaxis2 title").font(Font::new().color("#ff7f0e")))
+                .title(Title::with_text("yaxis2 title").font(Font::new().color("#ff7f0e")))
                 .tick_font(Font::new().color("#ff7f0e"))
                 .anchor("free")
                 .overlaying("y")
-                .side(Side::Left)
+                .side(AxisSide::Left)
                 .position(0.15),
         )
         .y_axis3(
             Axis::new()
-                .title(Title::new("yaxis3 title").font(Font::new().color("#d62728")))
+                .title(Title::with_text("yaxis3 title").font(Font::new().color("#d62728")))
                 .tick_font(Font::new().color("#d62728"))
                 .anchor("x")
                 .overlaying("y")
-                .side(Side::Right),
+                .side(AxisSide::Right),
         )
         .y_axis4(
             Axis::new()
-                .title(Title::new("yaxis4 title").font(Font::new().color("#9467bd")))
+                .title(Title::with_text("yaxis4 title").font(Font::new().color("#9467bd")))
                 .tick_font(Font::new().color("#9467bd"))
                 .anchor("free")
                 .overlaying("y")
-                .side(Side::Right)
+                .side(AxisSide::Right)
                 .position(0.85),
         );
     plot.set_layout(layout);
diff --git a/content/recipes/subplots/subplots.html b/content/recipes/subplots/subplots.html
@@ -440,7 +440,7 @@ <h2 id="multiple-custom-sized-subplots"><a class="header" href="#multiple-custom
     plot.add_trace(trace4);
 
     let layout = Layout::new()
-        .title(Title::new("Multiple Custom Sized Subplots"))
+        .title(Title::with_text("Multiple Custom Sized Subplots"))
         .x_axis(Axis::new().domain(&amp;[0., 0.45]).anchor("y1"))
         .y_axis(Axis::new().domain(&amp;[0.5, 1.]).anchor("x1"))
         .x_axis2(Axis::new().domain(&amp;[0.55, 1.]).anchor("y2"))
diff --git a/content/searchindex.js b/content/searchindex.js
diff --git a/content/searchindex.json b/content/searchindex.json
