lets-plot 4.7.0rc2__cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.whl → 4.7.1rc1__cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

lets_plot/__init__.py

@@ -119,18 +119,18 @@ class LetsPlot:
         -----
         List of possible settings:
 
-        - html_isolated_frame : preload Lets-Plot JS library or not (bool). Do not use this parameter explicitly. Instead you should call `LetsPlot.setup_html()`.
-        - offline : to work with notebook without the Internet connection (bool). Do not use this parameter explicitly. Instead you should call `LetsPlot.setup_html()`.
-        - no_js : do not generate HTML+JS as an output (bool). Do not use this parameter explicitly. Instead you should call `LetsPlot.setup_html()`. Also note that without JS interactive maps and tooltips doesn't work!
+        - html_isolated_frame : preload Lets-Plot JS library or not (bool). Do not use this parameter explicitly. Instead you should call `LetsPlot.setup_html() <https://lets-plot.org/python/pages/api/lets_plot.LetsPlot.html#lets_plot.LetsPlot.setup_html>`__.
+        - offline : to work with notebook without the Internet connection (bool). Do not use this parameter explicitly. Instead you should call `LetsPlot.setup_html() <https://lets-plot.org/python/pages/api/lets_plot.LetsPlot.html#lets_plot.LetsPlot.setup_html>`__.
+        - no_js : do not generate HTML+JS as an output (bool). Do not use this parameter explicitly. Instead you should call `LetsPlot.setup_html() <https://lets-plot.org/python/pages/api/lets_plot.LetsPlot.html#lets_plot.LetsPlot.setup_html>`__. Also note that without JS interactive maps and tooltips doesn't work!
 
         Interactive map settings could also be specified:
 
-        - maptiles_kind : kind of the tiles, could be 'raster_zxy' or 'vector_lets_plot'. Do not use this parameter explicitly. Instead you should construct it with functions `maptiles_zxy()` and `maptiles_lets_plot()`.
-        - maptiles_url : address of the tile server (str). Do not use this parameter explicitly. Instead you should construct it with functions `maptiles_zxy()` and `maptiles_lets_plot()`.
-        - maptiles_theme : tiles theme, could be 'color', 'light' or 'dark'. Do not use this parameter explicitly. Instead you should construct it with function `maptiles_lets_plot()`.
-        - maptiles_attribution : an attribution or a copyright notice to display on the map as required by the tile license (str, supports HTML links). Do not use this parameter explicitly. Instead you should construct it with function `maptiles_zxy()`.
-        - maptiles_min_zoom : minimal zoom limit (int). Do not use this parameter explicitly. Instead you should construct it with function `maptiles_zxy()`.
-        - maptiles_max_zoom : maximal zoom limit (int). Do not use this parameter explicitly. Instead you should construct it with function `maptiles_zxy()`.
+        - maptiles_kind : kind of the tiles, could be 'raster_zxy' or 'vector_lets_plot'. Do not use this parameter explicitly. Instead you should construct it with functions `maptiles_zxy() <https://lets-plot.org/python/pages/api/lets_plot.maptiles_zxy.html>`__ and `maptiles_lets_plot() <https://lets-plot.org/python/pages/api/lets_plot.maptiles_lets_plot.html>`__.
+        - maptiles_url : address of the tile server (str). Do not use this parameter explicitly. Instead you should construct it with functions `maptiles_zxy() <https://lets-plot.org/python/pages/api/lets_plot.maptiles_zxy.html>`__ and `maptiles_lets_plot() <https://lets-plot.org/python/pages/api/lets_plot.maptiles_lets_plot.html>`__.
+        - maptiles_theme : tiles theme, could be 'color', 'light' or 'dark'. Do not use this parameter explicitly. Instead you should construct it with function `maptiles_lets_plot() <https://lets-plot.org/python/pages/api/lets_plot.maptiles_lets_plot.html>`__.
+        - maptiles_attribution : an attribution or a copyright notice to display on the map as required by the tile license (str, supports HTML links). Do not use this parameter explicitly. Instead you should construct it with function `maptiles_zxy() <https://lets-plot.org/python/pages/api/lets_plot.maptiles_zxy.html>`__.
+        - maptiles_min_zoom : minimal zoom limit (int). Do not use this parameter explicitly. Instead you should construct it with function `maptiles_zxy() <https://lets-plot.org/python/pages/api/lets_plot.maptiles_zxy.html>`__.
+        - maptiles_max_zoom : maximal zoom limit (int). Do not use this parameter explicitly. Instead you should construct it with function `maptiles_zxy() <https://lets-plot.org/python/pages/api/lets_plot.maptiles_zxy.html>`__.
 
         Examples
         --------
@@ -170,7 +170,7 @@ class LetsPlot:
         Parameters
         ----------
         theme : spec
-            Theme spec provided by `theme(...)`, `theme_xxx()`, `flavor_xxx()` functions, or their sum.
+            Theme spec provided by `theme(...) <https://lets-plot.org/python/pages/api/lets_plot.theme.html>`__, ``theme_xxx()``, ``flavor_xxx()`` functions, or their sum.
 
         """
         if theme is None:
@@ -189,10 +189,10 @@ class LetsPlot:
         """
         Configure Lets-Plot to show its HTML output in an external browser.
 
-        When the "show externally" is set up, an invocation of `figire.show()` will
+        When the "show externally" is set up, an invocation of ``figire.show()`` will
         - generate HTML output
         - save it to a temporary file
-        - open the file in the default web browser or in a web browser specified by the `exec` parameter.
+        - open the file in the default web browser or in a web browser specified by the ``exec`` parameter.
 
         Parameters
         ----------
@@ -202,8 +202,8 @@ class LetsPlot:
         new : bool, default=False
             If True, the URL is opened in a new window of the web browser.
             If False, the URL is opened in the already opened web browser window.
-            The `new` parameter is only applicable when the `exec` parameter is not specified.
-            Please note that the `new` parameter is not supported by all web browsers and all OS-s.
+            The ``new`` parameter is only applicable when the ``exec`` parameter is not specified.
+            Please note that the ``new`` parameter is not supported by all web browsers and all OS-s.
 
         Examples
         --------

lets_plot/_global_settings.py

@@ -18,7 +18,6 @@ ENV_OFFLINE = 'LETS_PLOT_OFFLINE'  # bool
 ENV_NO_JS = 'LETS_PLOT_NO_JS'  # bool
 ENV_MAX_WIDTH = 'LETS_PLOT_MAX_WIDTH'
 ENV_MAX_HEIGHT = 'LETS_PLOT_MAX_HEIGHT'
-ENV_MAGICK_EXPORT = 'LETS_PLOT_MAGICK_EXPORT'  # bool
 ENV_MAPTILES_KIND = 'LETS_PLOT_MAPTILES_KIND'
 ENV_MAPTILES_URL = 'LETS_PLOT_MAPTILES_URL'
 ENV_MAPTILES_THEME = 'LETS_PLOT_MAPTILES_THEME'
@@ -47,7 +46,6 @@ JS_NAME = 'js_name'
 JS_URL_MANUAL = 'js_url_manual'
 MAX_WIDTH = 'max_width'
 MAX_HEIGHT = 'max_height'
-MAGICK_EXPORT = 'magick_export'
 
 MAPTILES_KIND = 'maptiles_kind'
 MAPTILES_URL = 'maptiles_url'
@@ -85,7 +83,6 @@ def _get_env_val(actual_name: str) -> Any:
 _settings = {
     OFFLINE: _init_value(OFFLINE, False),  # default: download from CDN
     NO_JS: _init_value(NO_JS, False),
-    MAGICK_EXPORT: _init_value(MAGICK_EXPORT, True),  # default: use cairo for export
     # JS_BASE_URL: 'https://dl.bintray.com/jetbrains/lets-plot',
     # JS_BASE_URL: "https://cdnjs.cloudflare.com/ajax/libs/lets-plot",
     JS_BASE_URL: "https://cdn.jsdelivr.net/gh/JetBrains/lets-plot@v{version}".format(version=__version__),
@@ -101,7 +98,6 @@ _settings = {
 
     'dev_' + OFFLINE: _init_value('dev_' + OFFLINE, True),  # default: embed js into the notebook
     'dev_' + NO_JS: _init_value('dev_' + NO_JS, False),
-    'dev_' + MAGICK_EXPORT: _init_value('dev_' + MAGICK_EXPORT, True),  # default: use cairo for export
     # We don't publish "dev" version, it must be served on localhost:
     # $ cd lets-plot
     # ./gradlew js-package:jsBrowserDevelopmentWebpack

lets_plot/_kbridge.py

@@ -15,15 +15,23 @@ def _generate_dynamic_display_html(plot_spec: Dict) -> str:
     return lets_plot_kotlin_bridge.generate_html(plot_spec)
 
 
-def _generate_svg(plot_spec: Dict, use_css_pixelated_image_rendering: bool = True) -> str:
+def _generate_svg(plot_spec: Dict, w: float = None, h: float = None, unit: str = None, use_css_pixelated_image_rendering: bool=True) -> str:
     plot_spec = _standardize_plot_spec(plot_spec)
-    return lets_plot_kotlin_bridge.export_svg(plot_spec, use_css_pixelated_image_rendering)
+    w = -1.0 if w is None else float(w)
+    h = -1.0 if h is None else float(h)
+    unit = '' if unit is None else str(unit)  # None is not a valid value for str type - PyArg_ParseTuple will fail
+    return lets_plot_kotlin_bridge.export_svg(plot_spec, w, h, unit, use_css_pixelated_image_rendering)
 
-def _export_png(bytestring: Dict, output_width: float, output_height: float, unit: str, dpi: int, scale: float) -> str:
+def _generate_png(bytestring: Dict, output_width: float, output_height: float, unit: str, dpi: int, scale: float) -> str:
     """
     Export a plot to PNG format. Returns base64 encoded string of the PNG image.
     """
     plot_spec = _standardize_plot_spec(bytestring)
+    output_width = -1.0 if output_width is None else float(output_width)
+    output_height = -1.0 if output_height is None else float(output_height)
+    unit = '' if unit is None else str(unit)  # None is not a valid value for str type - PyArg_ParseTuple will fail
+    dpi = -1 if dpi is None else int(dpi)
+    scale = -1.0 if scale is None else float(scale)
     return lets_plot_kotlin_bridge.export_png(plot_spec, output_width, output_height, unit, dpi, scale)
 
 

lets_plot/_version.py

@@ -3,4 +3,4 @@
 # Use of this source code is governed by the MIT license that can be found in the LICENSE file.
 #
 # see: https://www.python.org/dev/peps/pep-0440/#developmental-releases
-__version__ = '4.7.0rc2'
+__version__ = '4.7.1rc1'

lets_plot/bistro/corr.py

@@ -70,8 +70,8 @@ class corr_plot:
 
     Notes
     -----
-    To hide axis tooltips, set 'blank' or the result of `element_blank()`
-    to the `axis_tooltip`, `axis_tooltip_x` or `axis_tooltip_y` parameter of the `theme()`.
+    To hide axis tooltips, set 'blank' or the result of `element_blank() <https://lets-plot.org/python/pages/api/lets_plot.element_blank.html>`__
+    to the ``axis_tooltip``, ``axis_tooltip_x`` or ``axis_tooltip_y`` parameter of the `theme() <https://lets-plot.org/python/pages/api/lets_plot.theme.html>`__.
 
     Examples
     --------
@@ -146,7 +146,7 @@ class corr_plot:
         """
         Parameters
         ----------
-        data : dict or Pandas or Polars `DataFrame`
+        data : dict or Pandas or Polars ``DataFrame``
             Correlation matrix or data (correlation will be calculated for each variable pair).
             Data will be recognized as correlation matrix if it has a square shape and all values are
             in range -1.0..+1.0 or NaN.
@@ -189,7 +189,7 @@ class corr_plot:
 
         Returns
         -------
-        `corr_plot`
+        ``corr_plot``
             Correlation plot specification.
         """
         return self._duplicate()._set_points(type, diag)
@@ -215,7 +215,7 @@ class corr_plot:
 
         Returns
         -------
-        `corr_plot`
+        ``corr_plot``
             Correlation plot specification.
         """
         return self._duplicate()._set_labels(type, diag, map_size, color)
@@ -234,14 +234,15 @@ class corr_plot:
 
         Returns
         -------
-        `corr_plot`
+        ``corr_plot``
             Correlation plot specification.
         """
         return self._duplicate()._set_tiles(type, diag)
 
     def palette_gradient(self, low, mid, high):
         """
-        Set `scale_color_gradient2()` and `scale_fill_gradient()` for corr plot.
+        Set `scale_color_gradient2() <https://lets-plot.org/python/pages/api/lets_plot.scale_color_gradient2.html>`__ and
+        `scale_fill_gradient() <https://lets-plot.org/python/pages/api/lets_plot.scale_fill_gradient.html>`__ for corr plot.
 
         Parameters
         ----------
@@ -254,106 +255,106 @@ class corr_plot:
 
         Returns
         -------
-        `corr_plot`
+        ``corr_plot``
             Correlation plot specification.
         """
         return self._duplicate()._set_gradient_palette(low, mid, high)
 
     def palette_BrBG(self):
         """
-        Set `scale_color_brewer()` with BrBG palette for corr plot.
+        Set `scale_color_brewer() <https://lets-plot.org/python/pages/api/lets_plot.scale_color_brewer.html>`__ with BrBG palette for corr plot.
 
         Returns
         -------
-        `corr_plot`
+        ``corr_plot``
             Correlation plot specification.
         """
         return self._set_brewer_palette('BrBG')
 
     def palette_PiYG(self):
         """
-        Set `scale_color_brewer()` with PiYG palette for corr plot.
+        Set `scale_color_brewer() <https://lets-plot.org/python/pages/api/lets_plot.scale_color_brewer.html>`__ with PiYG palette for corr plot.
 
         Returns
         -------
-        `corr_plot`
+        ``corr_plot``
             Correlation plot specification.
         """
         return self._duplicate()._set_brewer_palette('PiYG')
 
     def palette_PRGn(self):
         """
-        Set `scale_color_brewer()` with PRGn palette for corr plot.
+        Set `scale_color_brewer() <https://lets-plot.org/python/pages/api/lets_plot.scale_color_brewer.html>`__ with PRGn palette for corr plot.
 
         Returns
         -------
-        `corr_plot`
+        ``corr_plot``
             Correlation plot specification.
         """
         return self._duplicate()._set_brewer_palette('PRGn')
 
     def palette_PuOr(self):
         """
-        Set `scale_color_brewer()` with PuOr palette for corr plot.
+        Set `scale_color_brewer() <https://lets-plot.org/python/pages/api/lets_plot.scale_color_brewer.html>`__ with PuOr palette for corr plot.
 
         Returns
         -------
-        `corr_plot`
+        ``corr_plot``
             Correlation plot specification.
         """
         return self._duplicate()._set_brewer_palette('PuOr')
 
     def palette_RdBu(self):
         """
-        Set `scale_color_brewer()` with RdBu palette for corr plot.
+        Set `scale_color_brewer() <https://lets-plot.org/python/pages/api/lets_plot.scale_color_brewer.html>`__ with RdBu palette for corr plot.
 
         Returns
         -------
-        `corr_plot`
+        ``corr_plot``
             Correlation plot specification.
         """
         return self._duplicate()._set_brewer_palette('RdBu')
 
     def palette_RdGy(self):
         """
-        Set `scale_color_brewer()` with RdGy palette for corr plot.
+        Set `scale_color_brewer() <https://lets-plot.org/python/pages/api/lets_plot.scale_color_brewer.html>`__ with RdGy palette for corr plot.
 
         Returns
         -------
-        `corr_plot`
+        ``corr_plot``
             Correlation plot specification.
         """
         return self._duplicate()._set_brewer_palette('RdGy')
 
     def palette_RdYlBu(self):
         """
-        Set `scale_color_brewer()` with RdYlBu palette for corr plot.
+        Set `scale_color_brewer() <https://lets-plot.org/python/pages/api/lets_plot.scale_color_brewer.html>`__ with RdYlBu palette for corr plot.
 
         Returns
         -------
-        `corr_plot`
+        ``corr_plot``
             Correlation plot specification.
         """
         return self._duplicate()._set_brewer_palette('RdYlBu')
 
     def palette_RdYlGn(self):
         """
-        Set `scale_color_brewer()` with RdYlGn palette for corr plot.
+        Set `scale_color_brewer() <https://lets-plot.org/python/pages/api/lets_plot.scale_color_brewer.html>`__ with RdYlGn palette for corr plot.
 
         Returns
         -------
-        `corr_plot`
+        ``corr_plot``
             Correlation plot specification.
         """
         return self._duplicate()._set_brewer_palette('RdYlGn')
 
     def palette_Spectral(self):
         """
-        Set `scale_color_brewer()` with Spectral palette for corr plot.
+        Set `scale_color_brewer() <https://lets-plot.org/python/pages/api/lets_plot.scale_color_brewer.html>`__ with Spectral palette for corr plot.
 
         Returns
         -------
-        `corr_plot`
+        ``corr_plot``
             Correlation plot specification.
         """
         return self._duplicate()._set_brewer_palette('Spectral')
@@ -391,7 +392,7 @@ class corr_plot:
 
         Returns
         -------
-        `PlotSpec`
+        ``PlotSpec``
             Plot specification.
         """
 

lets_plot/bistro/im.py

@@ -33,8 +33,8 @@ def image_matrix(image_data_array,
 
     Parameters
     ----------
-    image_data_array : `ndarray`
-        2D `numpy.ndarray` containing images.
+    image_data_array : ``ndarray``
+        2D ``numpy.ndarray`` containing images.
     cmap : str, optional
         Name of colormap. For example "viridis", "magma", "plasma", "inferno", or any other colormap
         which is supported by the Palettable package (https://github.com/jiffyclub/palettable)
@@ -45,7 +45,7 @@ def image_matrix(image_data_array,
         This parameter is ignored for RGB(A) images.
     vmin, vmax : number, optional
         Define the data range used for luminance normalization in grey-scale images.
-        This parameter is ignored for RGB(A) images or if parameter `norm=False`.
+        This parameter is ignored for RGB(A) images or if parameter ``norm=False``.
     scale : float, default=1.0
         Specify the image size magnification factor.
     spacer : number, default=1
@@ -53,7 +53,7 @@ def image_matrix(image_data_array,
 
     Returns
     -------
-    `SupPlotsSpec`
+    ``SupPlotsSpec``
         A specification describing the combined figure with all plots and their layout.
 
     Examples

lets_plot/bistro/joint.py

@@ -47,19 +47,19 @@ def joint_plot(data, x, y, *,
 
     Parameters
     ----------
-    data : dict or Pandas or Polars `DataFrame`
+    data : dict or Pandas or Polars ``DataFrame``
         The data to be displayed.
     x, y : str
         Names of a variables.
     geom : {'point', 'tile', 'hex', 'density2d', 'density2df'}, default='point'
         The geometric object to use to display the data.
     bins : int or list of int
-        Number of bins in both directions, vertical and horizontal. Overridden by `binwidth`.
+        Number of bins in both directions, vertical and horizontal. Overridden by ``binwidth``.
         If only one value given - interpret it as list of two equal values.
         Applicable simultaneously for 'tile'/'hex' geom and 'histogram' marginal.
     binwidth : float or list of float
         The width of the bins in both directions, vertical and horizontal.
-        Overrides `bins`. The default is to use bin widths that cover the entire range of the data.
+        Overrides ``bins``. The default is to use bin widths that cover the entire range of the data.
         If only one value given - interpret it as list of two equal values.
         Applicable simultaneously for 'tile'/'hex' geom and 'histogram' marginal.
     color : str
@@ -86,7 +86,7 @@ def joint_plot(data, x, y, *,
         Second parameter is a string specifying which sides of the plot the marginal layer will appear on.
         Possible values: 't' (top), 'b' (bottom), 'l' (left), 'r' (right).
         Third parameter (optional) is size of marginal.
-        To suppress marginals use `marginal='none'`.
+        To suppress marginals use ``marginal='none'``.
         Examples:
         "hist:tr:0.3",
         "dens:tr,hist:bl",
@@ -94,13 +94,13 @@ def joint_plot(data, x, y, *,
 
     Returns
     -------
-    `PlotSpec`
+    ``PlotSpec``
         Plot object specification.
 
     Notes
     -----
-    To hide axis tooltips, set 'blank' or the result of `element_blank()`
-    to the `axis_tooltip`, `axis_tooltip_x` or `axis_tooltip_y` parameter of the `theme()`.
+    To hide axis tooltips, set 'blank' or the result of `element_blank() <https://lets-plot.org/python/pages/api/lets_plot.element_blank.html>`__
+    to the ``axis_tooltip``, ``axis_tooltip_x`` or ``axis_tooltip_y`` parameter of the `theme() <https://lets-plot.org/python/pages/api/lets_plot.theme.html>`__.
 
     Examples
     --------

lets_plot/bistro/qq.py

@@ -16,14 +16,14 @@ def qq_plot(data=None, sample=None, *, x=None, y=None,
     """
     Produce a Q-Q plot (quantile-quantile plot).
 
-    Supply the `sample` parameter to compare distribution of observations with a theoretical distribution
-    ('normal' or as otherwise specified by the `distribution` parameter).
+    Supply the ``sample`` parameter to compare distribution of observations with a theoretical distribution
+    ('normal' or as otherwise specified by the ``distribution`` parameter).
 
-    Alternatively, supply `x` and `y` parameters to compare the distribution of `x` with the distribution of `y`.
+    Alternatively, supply ``x`` and ``y`` parameters to compare the distribution of ``x`` with the distribution of ``y``.
 
     Parameters
     ----------
-    data : dict or Pandas or Polars `DataFrame`
+    data : dict or Pandas or Polars ``DataFrame``
         The data to be displayed.
     sample : str
         Name of variable specifying a vector of observations used for computing of "sample quantiles".
@@ -33,16 +33,16 @@ def qq_plot(data=None, sample=None, *, x=None, y=None,
         x and y "sample quantiles".
         Use these two parameters to produce a "sample X vs. sample Y" Q-Q plot.
     distribution : {'norm', 'uniform', 't', 'gamma', 'exp', 'chi2'}, default='norm'
-        Distribution function to use. Could be specified if `sample` is.
+        Distribution function to use. Could be specified if ``sample`` is.
     dparams : list
         Additional parameters (of float type) passed on to distribution function.
-        Could be specified if `sample` is.
-        If `distribution` is `'norm'` then `dparams` is a pair [mean, std] (=[0.0, 1.0] by default).
-        If `distribution` is `'uniform'` then `dparams` is a pair [a, b] (=[0.0, 1.0] by default).
-        If `distribution` is `'t'` then `dparams` is an integer number [d] (=[1] by default).
-        If `distribution` is `'gamma'` then `dparams` is a pair [alpha, beta] (=[1.0, 1.0] by default).
-        If `distribution` is `'exp'` then `dparams` is a float number [lambda] (=[1.0] by default).
-        If `distribution` is `'chi2'` then `dparams` is an integer number [k] (=[1] by default).
+        Could be specified if ``sample`` is.
+        If ``distribution`` is ``'norm'`` then ``dparams`` is a pair [mean, std] (=[0.0, 1.0] by default).
+        If ``distribution`` is ``'uniform'`` then ``dparams`` is a pair [a, b] (=[0.0, 1.0] by default).
+        If ``distribution`` is ``'t'`` then ``dparams`` is an integer number [d] (=[1] by default).
+        If ``distribution`` is ``'gamma'`` then ``dparams`` is a pair [alpha, beta] (=[1.0, 1.0] by default).
+        If ``distribution`` is ``'exp'`` then ``dparams`` is a float number [lambda] (=[1.0] by default).
+        If ``distribution`` is ``'chi2'`` then ``dparams`` is an integer number [k] (=[1] by default).
     quantiles : list, default=[0.25, 0.75]
         Pair of quantiles to use when fitting the Q-Q line.
     group : str
@@ -59,7 +59,7 @@ def qq_plot(data=None, sample=None, *, x=None, y=None,
         Second parameter is a string specifying which sides of the plot the marginal layer will appear on.
         Possible values: 't' (top), 'b' (bottom), 'l' (left), 'r' (right).
         Third parameter (optional) is size of marginal.
-        To suppress marginals use `marginal='none'`.
+        To suppress marginals use ``marginal='none'``.
         Examples:
         "hist:tr:0.3",
         "dens:tr,hist:bl",
@@ -91,7 +91,7 @@ def qq_plot(data=None, sample=None, *, x=None, y=None,
 
     Returns
     -------
-    `PlotSpec`
+    ``PlotSpec``
         Plot object specification.
 
     Notes
@@ -104,8 +104,8 @@ def qq_plot(data=None, sample=None, *, x=None, y=None,
 
     ----
 
-    To hide axis tooltips, set 'blank' or the result of `element_blank()`
-    to the `axis_tooltip`, `axis_tooltip_x` or `axis_tooltip_y` parameter of the `theme()`.
+    To hide axis tooltips, set 'blank' or the result of `element_blank() <https://lets-plot.org/python/pages/api/lets_plot.element_blank.html>`__
+    to the ``axis_tooltip``, ``axis_tooltip_x`` or ``axis_tooltip_y`` parameter of the `theme() <https://lets-plot.org/python/pages/api/lets_plot.theme.html>`__.
 
     Examples
     --------

lets_plot/bistro/residual.py

@@ -141,12 +141,12 @@ def residual_plot(data=None, x=None, y=None, *,
     """
     Produce a residual plot that shows the difference between the observed response and the fitted response values.
 
-    To use `residual_plot()`, the `numpy` and `pandas` libraries are required.
+    To use ``residual_plot()``, the `numpy` and `pandas` libraries are required.
     Also, `statsmodels` and `scipy` are required for 'lm' and 'loess' methods.
 
     Parameters
     ----------
-    data : dict or Pandas or Polars `DataFrame`
+    data : dict or Pandas or Polars ``DataFrame``
         The data to be displayed.
     x : str
         Name of independent variable.
@@ -154,7 +154,7 @@ def residual_plot(data=None, x=None, y=None, *,
         Name of dependent variable that will be fitted.
     method : {'lm', 'loess', 'lowess', 'none'}, default='lm'
         Fitting method: 'lm' (Linear Model) or 'loess'/'lowess' (Locally Estimated Scatterplot Smoothing).
-        If value of `deg` parameter is greater than 1 then linear model becomes polynomial of the given degree.
+        If value of ``deg`` parameter is greater than 1 then linear model becomes polynomial of the given degree.
         If method is 'none' then data lives as is.
     deg : int, default=1
         Degree of polynomial for linear regression model.
@@ -166,14 +166,14 @@ def residual_plot(data=None, x=None, y=None, *,
     max_n : int
         Maximum number of data-points for 'loess' method. If this quantity exceeded random sampling is applied to data.
     geom : {'point', 'tile', 'hex', 'density2d', 'density2df', 'none'}, default='point'
-        The geometric object to use to display the data. No object will be used if `geom='none'`.
+        The geometric object to use to display the data. No object will be used if ``geom='none'``.
     bins : int or list of int
-        Number of bins in both directions, vertical and horizontal. Overridden by `binwidth`.
+        Number of bins in both directions, vertical and horizontal. Overridden by ``binwidth``.
         If only one value given - interpret it as list of two equal values.
         Applicable simultaneously for 'tile'/'hex' geom and 'histogram' marginal.
     binwidth : float or list of float
         The width of the bins in both directions, vertical and horizontal.
-        Overrides `bins`. The default is to use bin widths that cover the entire range of the data.
+        Overrides ``bins``. The default is to use bin widths that cover the entire range of the data.
         If only one value given - interpret it as list of two equal values.
         Applicable simultaneously for 'tile'/'hex' geom and 'histogram' marginal.
     color : str
@@ -198,7 +198,7 @@ def residual_plot(data=None, x=None, y=None, *,
         Second parameter is a string specifying which sides of the plot the marginal layer will appear on.
         Possible values: 't' (top), 'b' (bottom), 'l' (left), 'r' (right).
         Third parameter (optional) is size of marginal.
-        To suppress marginals use `marginal='none'`.
+        To suppress marginals use ``marginal='none'``.
         Examples:
         "hist:tr:0.3",
         "dens:tr,hist:bl",
@@ -206,7 +206,7 @@ def residual_plot(data=None, x=None, y=None, *,
 
     Returns
     -------
-    `PlotSpec`
+    ``PlotSpec``
         Plot object specification.
 
     Notes
@@ -216,8 +216,8 @@ def residual_plot(data=None, x=None, y=None, *,
 
     ----
 
-    To hide axis tooltips, set 'blank' or the result of `element_blank()`
-    to the `axis_tooltip`, `axis_tooltip_x` or `axis_tooltip_y` parameter of the `theme()`.
+    To hide axis tooltips, set 'blank' or the result of `element_blank() <https://lets-plot.org/python/pages/api/lets_plot.element_blank.html>`__
+    to the ``axis_tooltip``, ``axis_tooltip_x`` or ``axis_tooltip_y`` parameter of the `theme() <https://lets-plot.org/python/pages/api/lets_plot.theme.html>`__.
 
     Examples
     --------