fix book example generation and inclusion

.github/workflows/ci.yml

@@ -102,7 +102,7 @@ jobs:
           ndarray,
           scientific_charts,
           shapes,
-            subplots,
+          subplots,
         ]
     runs-on: ubuntu-latest
     steps:
@@ -123,3 +123,22 @@ jobs:
         with:
           targets: wasm32-unknown-unknown
       - run: cd ${{ github.workspace }}/examples/wasm-yew/${{ matrix.example }} && cargo build --target wasm32-unknown-unknown
+
+  build_book:
+    name: Build Book 
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - run: cargo install mdbook --no-default-features --features search --vers "^0.4" --locked --quiet
+      - name: Build examples to generate needed html files
+        run: |
+          cd ${{ github.workspace }}/examples/basic_charts && cargo run
+          cd ${{ github.workspace }}/examples/statistical_charts && cargo run
+          cd ${{ github.workspace }}/examples/scientific_charts && cargo run
+          cd ${{ github.workspace }}/examples/financial_charts && cargo run
+          cd ${{ github.workspace }}/examples/3d_charts && cargo run
+          cd ${{ github.workspace }}/examples/subplots && cargo run
+          cd ${{ github.workspace }}/examples/shapes && cargo run
+      - name: Build book 
+        run: mdbook build docs/book

docs/book/src/fundamentals/shapes.md

@@ -24,92 +24,92 @@ The `to_inline_html` method is used to produce the html plot displayed in this p
 {{#include ../../../../examples/shapes/src/main.rs:filled_area_chart}}
 ```
 
-{{#include ../../../../examples/shapes/out/filled_area_chart.html}}
+{{#include ../../../../examples/shapes/output/inline_filled_area_chart.html}}
 
 
 ## Vertical and Horizontal Lines Positioned Relative to Axes
 ```rust,no_run
 {{#include ../../../../examples/shapes/src/main.rs:vertical_and_horizontal_lines_positioned_relative_to_axes}}
 ```
 
-{{#include ../../../../examples/shapes/out/vertical_and_horizontal_lines_positioned_relative_to_axes.html}}
+{{#include ../../../../examples/shapes/output/inline_vertical_and_horizontal_lines_positioned_relative_to_axes.html}}
 
 
 ## Lines Positioned Relative to the Plot and to the Axes
 ```rust,no_run
 {{#include ../../../../examples/shapes/src/main.rs:lines_positioned_relative_to_the_plot_and_to_the_axes}}
 ```
 
-{{#include ../../../../examples/shapes/out/lines_positioned_relative_to_the_plot_and_to_the_axes.html}}
+{{#include ../../../../examples/shapes/output/inline_lines_positioned_relative_to_the_plot_and_to_the_axes.html}}
 
 
 ## Creating Tangent Lines with Shapes
 ```rust,no_run
 {{#include ../../../../examples/shapes/src/main.rs:creating_tangent_lines_with_shapes}}
 ```
 
-{{#include ../../../../examples/shapes/out/creating_tangent_lines_with_shapes.html}}
+{{#include ../../../../examples/shapes/output/inline_creating_tangent_lines_with_shapes.html}}
 
 
 ## Rectangles Positioned Relative to the Axes
 ```rust,no_run
 {{#include ../../../../examples/shapes/src/main.rs:rectangles_positioned_relative_to_the_axes}}
 ```
 
-{{#include ../../../../examples/shapes/out/rectangles_positioned_relative_to_the_axes.html}}
+{{#include ../../../../examples/shapes/output/inline_rectangles_positioned_relative_to_the_axes.html}}
 
 
 ## Rectangle Positioned Relative to the Plot and to the Axes
 ```rust,no_run
 {{#include ../../../../examples/shapes/src/main.rs:rectangle_positioned_relative_to_the_plot_and_to_the_axes}}
 ```
 
-{{#include ../../../../examples/shapes/out/rectangle_positioned_relative_to_the_plot_and_to_the_axes.html}}
+{{#include ../../../../examples/shapes/output/inline_rectangle_positioned_relative_to_the_plot_and_to_the_axes.html}}
 
 
 ## Highlighting Time Series Regions with Rectangle Shapes
 ```rust,no_run
 {{#include ../../../../examples/shapes/src/main.rs:highlighting_time_series_regions_with_rectangle_shapes}}
 ```
 
-{{#include ../../../../examples/shapes/out/highlighting_time_series_regions_with_rectangle_shapes.html}}
+{{#include ../../../../examples/shapes/output/inline_highlighting_time_series_regions_with_rectangle_shapes.html}}
 
 
 ## Circles Positioned Relative to the Axes
 ```rust,no_run
 {{#include ../../../../examples/shapes/src/main.rs:circles_positioned_relative_to_the_axes}}
 ```
 
-{{#include ../../../../examples/shapes/out/circles_positioned_relative_to_the_axes.html}}
+{{#include ../../../../examples/shapes/output/inline_circles_positioned_relative_to_the_axes.html}}
 
 
 ## Highlighting Clusters of Scatter Points with Circle Shapes
 ```rust,no_run
 {{#include ../../../../examples/shapes/src/main.rs:highlighting_clusters_of_scatter_points_with_circle_shapes}}
 ```
 
-{{#include ../../../../examples/shapes/out/highlighting_clusters_of_scatter_points_with_circle_shapes.html}}
+{{#include ../../../../examples/shapes/output/inline_highlighting_clusters_of_scatter_points_with_circle_shapes.html}}
 
 
 ## Venn Diagram with Circle Shapes
 ```rust,no_run
 {{#include ../../../../examples/shapes/src/main.rs:venn_diagram_with_circle_shapes}}
 ```
 
-{{#include ../../../../examples/shapes/out/venn_diagram_with_circle_shapes.html}}
+{{#include ../../../../examples/shapes/output/inline_venn_diagram_with_circle_shapes.html}}
 
 
 ## Adding Shapes to Subplots
 ```rust,no_run
 {{#include ../../../../examples/shapes/src/main.rs:adding_shapes_to_subplots}}
 ```
 
-{{#include ../../../../examples/shapes/out/adding_shapes_to_subplots.html}}
+{{#include ../../../../examples/shapes/output/inline_adding_shapes_to_subplots.html}}
 
 
 ## SVG Paths
 ```rust,no_run
 {{#include ../../../../examples/shapes/src/main.rs:svg_paths}}
 ```
 
-{{#include ../../../../examples/shapes/out/svg_paths.html}}
+{{#include ../../../../examples/shapes/output/inline_svg_paths.html}}

docs/book/src/recipes/3dcharts/3dcharts.md

@@ -19,4 +19,4 @@ The `to_inline_html` method is used to produce the html plot displayed in this p
 {{#include ../../../../../examples/3d_charts/src/main.rs:simple_scatter3d_plot}}
 ```
 
-{{#include ../../../../../examples/3d_charts/out/simple_scatter3d_plot.html}}
+{{#include ../../../../../examples/3d_charts/output/inline_simple_scatter3d_plot.html}}

docs/book/src/recipes/basic_charts/bar_charts.md

@@ -20,18 +20,18 @@ The `to_inline_html` method is used to produce the html plot displayed in this p
 {{#include ../../../../../examples/basic_charts/src/main.rs:basic_bar_chart}}
 ```
 
-{{#include ../../../../../examples/basic_charts/out/basic_bar_chart.html}}
+{{#include ../../../../../examples/basic_charts/output/inline_basic_bar_chart.html}}
 
 ## Grouped Bar Chart
 ```rust,no_run
 {{#include ../../../../../examples/basic_charts/src/main.rs:grouped_bar_chart}}
 ```
 
-{{#include ../../../../../examples/basic_charts/out/grouped_bar_chart.html}}
+{{#include ../../../../../examples/basic_charts/output/inline_grouped_bar_chart.html}}
 
 ## Stacked Bar Chart
 ```rust,no_run
 {{#include ../../../../../examples/basic_charts/src/main.rs:stacked_bar_chart}}
 ```
 
-{{#include ../../../../../examples/basic_charts/out/stacked_bar_chart.html}}
+{{#include ../../../../../examples/basic_charts/output/inline_stacked_bar_chart.html}}

docs/book/src/recipes/basic_charts/line_charts.md

@@ -20,40 +20,40 @@ The `to_inline_html` method is used to produce the html plot displayed in this p
 {{#include ../../../../../examples/basic_charts/src/main.rs:adding_names_to_line_and_scatter_plot}}
 ```
 
-{{#include ../../../../../examples/basic_charts/out/adding_names_to_line_and_scatter_plot.html}}
+{{#include ../../../../../examples/basic_charts/output/inline_adding_names_to_line_and_scatter_plot.html}}
 
 
 ## Line and Scatter Styling
 ```rust,no_run
 {{#include ../../../../../examples/basic_charts/src/main.rs:line_and_scatter_styling}}
 ```
 
-{{#include ../../../../../examples/basic_charts/out/line_and_scatter_styling.html}}
+{{#include ../../../../../examples/basic_charts/output/inline_line_and_scatter_styling.html}}
 
 ## Styling Line Plot
 ```rust,no_run
 {{#include ../../../../../examples/basic_charts/src/main.rs:styling_line_plot}}
 ```
 
-{{#include ../../../../../examples/basic_charts/out/styling_line_plot.html}}
+{{#include ../../../../../examples/basic_charts/output/inline_styling_line_plot.html}}
 
 ## Line Shape Options for Interpolation
 ```rust,no_run
 {{#include ../../../../../examples/basic_charts/src/main.rs:line_shape_options_for_interpolation}}
 ```
 
-{{#include ../../../../../examples/basic_charts/out/line_shape_options_for_interpolation.html}}
+{{#include ../../../../../examples/basic_charts/output/inline_line_shape_options_for_interpolation.html}}
 
 ## Line Dash
 ```rust,no_run
 {{#include ../../../../../examples/basic_charts/src/main.rs:line_dash}}
 ```
 
-{{#include ../../../../../examples/basic_charts/out/line_dash.html}}
+{{#include ../../../../../examples/basic_charts/output/inline_line_dash.html}}
 
 ## Filled Lines
 ```rust,no_run
 {{#include ../../../../../examples/basic_charts/src/main.rs:filled_lines}}
 ```
 
-{{#include ../../../../../examples/basic_charts/out/filled_lines.html}}
+{{#include ../../../../../examples/basic_charts/output/inline_filled_lines.html}}

docs/book/src/recipes/basic_charts/pie_charts.md

@@ -18,24 +18,24 @@ The `to_inline_html` method is used to produce the html plot displayed in this p
 {{#include ../../../../../examples/basic_charts/src/main.rs:basic_pie_chart}}
 ```
 
-{{#include ../../../../../examples/basic_charts/out/basic_pie_chart.html}}
+{{#include ../../../../../examples/basic_charts/output/inline_basic_pie_chart.html}}
 
 ```rust,no_run
 {{#include ../../../../../examples/basic_charts/src/main.rs:basic_pie_chart_labels}}
 ```
 
-{{#include ../../../../../examples/basic_charts/out/basic_pie_chart_labels.html}}
+{{#include ../../../../../examples/basic_charts/output/inline_basic_pie_chart_labels.html}}
 
 ## Grouped Pie Chart
 ```rust,no_run
 {{#include ../../../../../examples/basic_charts/src/main.rs:grouped_donout_pie_charts}}
 ```
 
-{{#include ../../../../../examples/basic_charts/out/grouped_donout_pie_charts.html}}
+{{#include ../../../../../examples/basic_charts/output/inline_grouped_donout_pie_charts.html}}
 
 ## Pie Chart Text Control
 ```rust,no_run
 {{#include ../../../../../examples/basic_charts/src/main.rs:pie_chart_text_control}}
 ```
 
-{{#include ../../../../../examples/basic_charts/out/pie_chart_text_control.html}}
+{{#include ../../../../../examples/basic_charts/output/inline_pie_chart_text_control.html}}

docs/book/src/recipes/basic_charts/scatter_plots.md

@@ -19,51 +19,51 @@ The `to_inline_html` method is used to produce the html plot displayed in this p
 {{#include ../../../../../examples/basic_charts/src/main.rs:simple_scatter_plot}}
 ```
 
-{{#include ../../../../../examples/basic_charts/out/simple_scatter_plot.html}}
+{{#include ../../../../../examples/basic_charts/output/inline_simple_scatter_plot.html}}
 
 
 ## Line and Scatter Plots
 ```rust,no_run
 {{#include ../../../../../examples/basic_charts/src/main.rs:line_and_scatter_plots}}
 ```
 
-{{#include ../../../../../examples/basic_charts/out/line_and_scatter_plots.html}}
+{{#include ../../../../../examples/basic_charts/output/inline_line_and_scatter_plots.html}}
 
 ## Bubble Scatter Plots
 ```rust,no_run
 {{#include ../../../../../examples/basic_charts/src/main.rs:bubble_scatter_plots}}
 ```
 
-{{#include ../../../../../examples/basic_charts/out/bubble_scatter_plots.html}}
+{{#include ../../../../../examples/basic_charts/output/inline_bubble_scatter_plots.html}}
 
 
 ## Data Labels Hover
 ```rust,no_run
 {{#include ../../../../../examples/basic_charts/src/main.rs:data_labels_hover}}
 ```
 
-{{#include ../../../../../examples/basic_charts/out/data_labels_hover.html}}
+{{#include ../../../../../examples/basic_charts/output/inline_data_labels_hover.html}}
 
 
 ## Data Labels on the Plot
 ```rust,no_run
 {{#include ../../../../../examples/basic_charts/src/main.rs:data_labels_on_the_plot}}
 ```
 
-{{#include ../../../../../examples/basic_charts/out/data_labels_on_the_plot.html}}
+{{#include ../../../../../examples/basic_charts/output/inline_data_labels_on_the_plot.html}}
 
 
 ## Colored and Styled Scatter Plot
 ```rust,no_run
 {{#include ../../../../../examples/basic_charts/src/main.rs:colored_and_styled_scatter_plot}}
 ```
 
-{{#include ../../../../../examples/basic_charts/out/colored_and_styled_scatter_plot.html}}
+{{#include ../../../../../examples/basic_charts/output/inline_colored_and_styled_scatter_plot.html}}
 
 
 ## Large Data Sets
 ```rust,no_run
 {{#include ../../../../../examples/basic_charts/src/main.rs:large_data_sets}}
 ```
 
-{{#include ../../../../../examples/basic_charts/out/large_data_sets.html}}
+{{#include ../../../../../examples/basic_charts/output/inline_large_data_sets.html}}

docs/book/src/recipes/financial_charts/candlestick_charts.md

@@ -18,4 +18,4 @@ The `to_inline_html` method is used to produce the html plot displayed in this p
 {{#include ../../../../../examples/financial_charts/src/main.rs:simple_candlestick_chart}}
 ```
 
-{{#include ../../../../../examples/financial_charts/out/simple_candlestick_chart.html}}
+{{#include ../../../../../examples/financial_charts/output/inline_simple_candlestick_chart.html}}

docs/book/src/recipes/financial_charts/ohlc_charts.md

@@ -18,4 +18,4 @@ The `to_inline_html` method is used to produce the html plot displayed in this p
 {{#include ../../../../../examples/financial_charts/src/main.rs:simple_ohlc_chart}}
 ```
 
-{{#include ../../../../../examples/financial_charts/out/simple_ohlc_chart.html}}
+{{#include ../../../../../examples/financial_charts/output/inline_simple_ohlc_chart.html}}

docs/book/src/recipes/financial_charts/time_series_and_date_axes.md

@@ -18,28 +18,28 @@ The `to_inline_html` method is used to produce the html plot displayed in this p
 {{#include ../../../../../examples/financial_charts/src/main.rs:time_series_plot_with_custom_date_range}}
 ```
 
-{{#include ../../../../../examples/financial_charts/out/time_series_plot_with_custom_date_range.html}}
+{{#include ../../../../../examples/financial_charts/output/inline_time_series_plot_with_custom_date_range.html}}
 
 
 ## Time Series with Range Slider
 ```rust,no_run
 {{#include ../../../../../examples/financial_charts/src/main.rs:time_series_with_range_slider}}
 ```
 
-{{#include ../../../../../examples/financial_charts/out/time_series_with_range_slider.html}}
+{{#include ../../../../../examples/financial_charts/output/inline_time_series_with_range_slider.html}}
 
 
 ## Time Series with Range Selector Buttons
 ```rust,no_run
 {{#include ../../../../../examples/financial_charts/src/main.rs:time_series_with_range_selector_buttons}}
 ```
 
-{{#include ../../../../../examples/financial_charts/out/time_series_with_range_selector_buttons.html}}
+{{#include ../../../../../examples/financial_charts/output/inline_time_series_with_range_selector_buttons.html}}
 
 
 ## Customizing Tick Label Formatting by Zoom Level
 ```rust,no_run
 {{#include ../../../../../examples/financial_charts/src/main.rs:customizing_tick_label_formatting_by_zoom_level}}
 ```
 
-{{#include ../../../../../examples/financial_charts/out/customizing_tick_label_formatting_by_zoom_level.html}}
+{{#include ../../../../../examples/financial_charts/output/inline_customizing_tick_label_formatting_by_zoom_level.html}}

docs/book/src/recipes/scientific_charts/contour_plots.md

@@ -16,28 +16,28 @@ The `to_inline_html` method is used to produce the html plot displayed in this p
 {{#include ../../../../../examples/scientific_charts/src/main.rs:simple_contour_plot}}
 ```
 
-{{#include ../../../../../examples/scientific_charts/out/simple_contour_plot.html}}
+{{#include ../../../../../examples/scientific_charts/output/inline_simple_contour_plot.html}}
 
 
 ## Colorscale for Contour Plot
 ```rust,no_run
 {{#include ../../../../../examples/scientific_charts/src/main.rs:colorscale_for_contour_plot}}
 ```
 
-{{#include ../../../../../examples/scientific_charts/out/colorscale_for_contour_plot.html}}
+{{#include ../../../../../examples/scientific_charts/output/inline_colorscale_for_contour_plot.html}}
 
 
 ## Customizing Size and Range of a Contour Plot Contours
 ```rust,no_run
 {{#include ../../../../../examples/scientific_charts/src/main.rs:customizing_size_and_range_of_a_contour_plots_contours}}
 ```
 
-{{#include ../../../../../examples/scientific_charts/out/customizing_size_and_range_of_a_contour_plots_contours.html}}
+{{#include ../../../../../examples/scientific_charts/output/inline_customizing_size_and_range_of_a_contour_plots_contours.html}}
 
 
 ## Customizing Spacing Between X and Y Ticks
 ```rust,no_run
 {{#include ../../../../../examples/scientific_charts/src/main.rs:customizing_spacing_between_x_and_y_ticks}}
 ```
 
-{{#include ../../../../../examples/scientific_charts/out/customizing_spacing_between_x_and_y_ticks.html}}
+{{#include ../../../../../examples/scientific_charts/output/inline_customizing_spacing_between_x_and_y_ticks.html}}