lets-plot 4.7.0rc3__cp311-cp311-win_amd64.whl → 4.7.1rc1__cp311-cp311-win_amd64.whl

lets_plot/plot/scale_colormap_mpl.py

@@ -82,7 +82,8 @@ def scale_cmapmpl(aesthetic, *,
         Missing values will be replaced with this value.
     guide
         Guide to use for this scale. It can either be a string ('colorbar', 'legend')
-        or a call to a guide function (`guide_colorbar()`, `guide_legend()`)
+        or a call to a guide function (`guide_colorbar() <https://lets-plot.org/python/pages/api/lets_plot.guide_colorbar.html>`__,
+        `guide_legend() <https://lets-plot.org/python/pages/api/lets_plot.guide_legend.html>`__)
         specifying additional arguments. 'none' will hide the guide.
     trans : {'identity', 'log10', 'log2', 'symlog', 'sqrt', 'reverse'}
         Name of built-in transformation.
@@ -97,7 +98,7 @@ def scale_cmapmpl(aesthetic, *,
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         The scale specification.
 
     Notes
@@ -165,7 +166,8 @@ def scale_fill_cmapmpl(cmap, *,
         Missing values will be replaced with this value.
     guide
         Guide to use for this scale. It can either be a string ('colorbar', 'legend')
-        or a call to a guide function (`guide_colorbar()`, `guide_legend()`)
+        or a call to a guide function (`guide_colorbar() <https://lets-plot.org/python/pages/api/lets_plot.guide_colorbar.html>`__,
+        `guide_legend() <https://lets-plot.org/python/pages/api/lets_plot.guide_legend.html>`__)
         specifying additional arguments. 'none' will hide the guide.
     trans : {'identity', 'log10', 'log2', 'symlog', 'sqrt', 'reverse'}
         Name of built-in transformation.
@@ -180,7 +182,7 @@ def scale_fill_cmapmpl(cmap, *,
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         The scale specification.
 
     Notes
@@ -244,7 +246,8 @@ def scale_color_cmapmpl(cmap, *,
         Missing values will be replaced with this value.
     guide
         Guide to use for this scale. It can either be a string ('colorbar', 'legend')
-        or a call to a guide function (`guide_colorbar()`, `guide_legend()`)
+        or a call to a guide function (`guide_colorbar() <https://lets-plot.org/python/pages/api/lets_plot.guide_colorbar.html>`__,
+        `guide_legend() <https://lets-plot.org/python/pages/api/lets_plot.guide_legend.html>`__)
         specifying additional arguments. 'none' will hide the guide.
     trans : {'identity', 'log10', 'log2', 'symlog', 'sqrt', 'reverse'}
         Name of built-in transformation.
@@ -259,7 +262,7 @@ def scale_color_cmapmpl(cmap, *,
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         The scale specification.
 
     Notes

lets_plot/plot/scale_convenience.py

@@ -13,7 +13,7 @@ __all__ = ['lims', 'xlim', 'ylim']
 
 def lims(x, y):
     """
-    This is a shortcut for supplying the `limits` parameter to the x and y axes.
+    This is a shortcut for supplying the ``limits`` parameter to the x and y axes.
     Observations outside the range will be dropped.
 
     Parameters
@@ -29,7 +29,7 @@ def lims(x, y):
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Examples
@@ -58,7 +58,7 @@ def lims(x, y):
 
 def xlim(*limits):
     """
-    This is a shortcut for supplying the `limits` parameter to the x axis.
+    This is a shortcut for supplying the ``limits`` parameter to the x axis.
     Observations outside the range will be dropped.
 
     Parameters
@@ -70,7 +70,7 @@ def xlim(*limits):
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Examples
@@ -95,7 +95,7 @@ def xlim(*limits):
 
 def ylim(*limits):
     """
-    This is a shortcut for supplying the `limits` parameter to the y axis.
+    This is a shortcut for supplying the ``limits`` parameter to the y axis.
     Observations outside the range will be dropped.
     
     Parameters
@@ -107,7 +107,7 @@ def ylim(*limits):
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Examples

lets_plot/plot/scale_identity_.py

@@ -58,7 +58,7 @@ def scale_identity(aesthetic, *,
 
     Returns
     -------
-    `FeatureSpec` or `FeatureSpecArray`
+    ``FeatureSpec`` or ``FeatureSpecArray``
         Scales specification.
 
     Examples
@@ -128,7 +128,7 @@ def scale_color_identity(name=None, breaks=None, labels=None, lablim=None, limit
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Notes
@@ -197,7 +197,7 @@ def scale_fill_identity(name=None, breaks=None, labels=None, lablim=None, limits
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Notes
@@ -266,7 +266,7 @@ def scale_shape_identity(name=None, breaks=None, labels=None, lablim=None, limit
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Notes
@@ -339,7 +339,7 @@ def scale_linetype_identity(name=None, breaks=None, labels=None, lablim=None, li
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Notes
@@ -415,7 +415,7 @@ def scale_alpha_identity(name=None, breaks=None, labels=None, lablim=None, limit
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Notes
@@ -485,7 +485,7 @@ def scale_size_identity(name=None, breaks=None, labels=None, lablim=None, limits
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Notes
@@ -555,7 +555,7 @@ def scale_linewidth_identity(name=None, breaks=None, labels=None, lablim=None, l
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Notes
@@ -623,7 +623,7 @@ def scale_stroke_identity(name=None, breaks=None, labels=None, lablim=None, limi
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Notes

lets_plot/plot/scale_position.py

@@ -74,7 +74,7 @@ def scale_x_continuous(name=None, *,
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Examples
@@ -158,7 +158,7 @@ def scale_y_continuous(name=None, *,
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Examples
@@ -239,7 +239,7 @@ def scale_x_log10(name=None, *,
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Examples
@@ -316,7 +316,7 @@ def scale_y_log10(name=None, *,
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Examples
@@ -393,7 +393,7 @@ def scale_x_log2(name=None, *,
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Examples
@@ -470,7 +470,7 @@ def scale_y_log2(name=None, *,
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Examples
@@ -547,7 +547,7 @@ def scale_x_reverse(name=None, *,
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Examples
@@ -624,7 +624,7 @@ def scale_y_reverse(name=None, *,
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Examples
@@ -708,7 +708,7 @@ def scale_x_discrete(name=None, *,
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Examples
@@ -793,7 +793,7 @@ def scale_x_discrete_reversed(name=None, *,
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Examples
@@ -877,7 +877,7 @@ def scale_y_discrete(name=None, *,
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Examples
@@ -962,7 +962,7 @@ def scale_y_discrete_reversed(name=None, *,
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Examples
@@ -1053,7 +1053,7 @@ def scale_x_datetime(name=None, *,
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Examples
@@ -1143,7 +1143,7 @@ def scale_y_datetime(name=None, *,
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Examples
@@ -1223,7 +1223,7 @@ def scale_x_time(name=None, *,
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Examples
@@ -1302,7 +1302,7 @@ def scale_y_time(name=None, *,
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Scale specification.
 
     Examples

lets_plot/plot/series_meta.py

@@ -100,7 +100,13 @@ def _infer_type_polars_dataframe(var_name: str, var_type) -> str:
     lp_dtype = TYPE_UNKNOWN
 
     # https://docs.pola.rs/api/python/stable/reference/datatypes.html
-    if var_type in PL_FLOAT_DTYPES:
+    if isinstance(var_type, pl.datatypes.Enum):
+        # In the current version of Polars, Enum is always a string
+        # https://docs.pola.rs/api/python/stable/reference/datatypes.html#string
+        return TYPE_STRING
+    elif isinstance(var_type, pl.datatypes.Categorical):
+        return TYPE_STRING
+    elif var_type in PL_FLOAT_DTYPES:
         lp_dtype = TYPE_FLOATING
     elif var_type in PL_INTEGER_DTYPES:
         lp_dtype = TYPE_INTEGER

lets_plot/plot/stat.py

@@ -21,28 +21,29 @@ def stat_summary(mapping=None, *, data=None, geom=None,
 
     Parameters
     ----------
-    mapping : `FeatureSpec`
-        Set of aesthetic mappings created by `aes()` function.
+    mapping : ``FeatureSpec``
+        Set of aesthetic mappings created by `aes() <https://lets-plot.org/python/pages/api/lets_plot.aes.html>`__ function.
         Aesthetic mappings describe the way that variables in the data are
         mapped to plot "aesthetics".
-    data : dict or Pandas or Polars `DataFrame`
+    data : dict or Pandas or Polars ``DataFrame``
         The data to be displayed in this layer. If None, the default, the data
         is inherited from the plot data as specified in the call to ggplot.
     geom : str, default='pointrange'
         The geometry to display the summary stat for this layer, as a string.
-    position : str or `FeatureSpec`, default='identity'
+    position : str or ``FeatureSpec``, default='identity'
         Position adjustment.
         Either a position adjustment name: 'dodge', 'jitter', 'nudge', 'jitterdodge', 'fill',
-        'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
+        'stack' or 'identity', or the result of calling a position adjustment function
+        (e.g., `position_dodge() <https://lets-plot.org/python/pages/api/lets_plot.position_dodge.html>`__ etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     inherit_aes : bool, default=True
         False - do not combine the layer aesthetic mappings with the plot shared mappings.
-    sampling : `FeatureSpec`
-        Result of the call to the `sampling_xxx()` function.
+    sampling : ``FeatureSpec``
+        Result of the call to the ``sampling_xxx()`` function.
         To prevent any sampling for this layer pass value "none" (string "none").
-    tooltips : `layer_tooltips`
-        Result of the call to the `layer_tooltips()` function.
+    tooltips : ``layer_tooltips``
+        Result of the call to the `layer_tooltips() <https://lets-plot.org/python/pages/api/lets_plot.layer_tooltips.html>`__ function.
         Specify appearance, style and content.
         Set tooltips='none' to hide tooltips from the layer.
     orientation : str
@@ -73,21 +74,21 @@ def stat_summary(mapping=None, *, data=None, geom=None,
 
     Returns
     -------
-    `LayerSpec`
+    ``LayerSpec``
         Geom object specification.
 
     Notes
     -----
     Computed variables:
 
-    - ..y.. : result of calculating of `fun`.
-    - ..ymin.. : result of calculating of `fun_min`.
-    - ..ymax.. : result of calculating of `fun_max`.
+    - ..y.. : result of calculating of ``fun``.
+    - ..ymin.. : result of calculating of ``fun_min``.
+    - ..ymax.. : result of calculating of ``fun_max``.
 
     ----
 
-    To hide axis tooltips, set 'blank' or the result of `element_blank()`
-    to the `axis_tooltip` or `axis_tooltip_x` 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`` or ``axis_tooltip_x`` parameter of the `theme() <https://lets-plot.org/python/pages/api/lets_plot.theme.html>`__.
 
     Examples
     --------
@@ -173,28 +174,29 @@ def stat_summary_bin(mapping=None, *, data=None, geom=None,
 
     Parameters
     ----------
-    mapping : `FeatureSpec`
-        Set of aesthetic mappings created by `aes()` function.
+    mapping : ``FeatureSpec``
+        Set of aesthetic mappings created by `aes() <https://lets-plot.org/python/pages/api/lets_plot.aes.html>`__ function.
         Aesthetic mappings describe the way that variables in the data are
         mapped to plot "aesthetics".
-    data : dict or Pandas or Polars `DataFrame`
+    data : dict or Pandas or Polars ``DataFrame``
         The data to be displayed in this layer. If None, the default, the data
         is inherited from the plot data as specified in the call to ggplot.
     geom : str, default='pointrange'
         The geometry to display the summary stat for this layer, as a string.
-    position : str or `FeatureSpec`, default='identity'
+    position : str or ``FeatureSpec``, default='identity'
         Position adjustment.
         Either a position adjustment name: 'dodge', 'jitter', 'nudge', 'jitterdodge', 'fill',
-        'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
+        'stack' or 'identity', or the result of calling a position adjustment function
+        (e.g., `position_dodge() <https://lets-plot.org/python/pages/api/lets_plot.position_dodge.html>`__ etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     inherit_aes : bool, default=True
         False - do not combine the layer aesthetic mappings with the plot shared mappings.
-    sampling : `FeatureSpec`
-        Result of the call to the `sampling_xxx()` function.
+    sampling : ``FeatureSpec``
+        Result of the call to the ``sampling_xxx()`` function.
         To prevent any sampling for this layer pass value "none" (string "none").
-    tooltips : `layer_tooltips`
-        Result of the call to the `layer_tooltips()` function.
+    tooltips : ``layer_tooltips``
+        Result of the call to the `layer_tooltips() <https://lets-plot.org/python/pages/api/lets_plot.layer_tooltips.html>`__ function.
         Specify appearance, style and content.
         Set tooltips='none' to hide tooltips from the layer.
     orientation : str, default='x'
@@ -213,7 +215,7 @@ def stat_summary_bin(mapping=None, *, data=None, geom=None,
         A list of probabilities defining the quantile functions 'lq', 'mq' and 'uq'.
         Must contain exactly 3 values between 0 and 1.
     bins : int, default=30
-        Number of bins. Overridden by `binwidth`.
+        Number of bins. Overridden by ``binwidth``.
     binwidth : float
         The width of the bins. The default is to use bin widths that cover
         the range of the data. You should always override this value,
@@ -234,21 +236,21 @@ def stat_summary_bin(mapping=None, *, data=None, geom=None,
 
     Returns
     -------
-    `LayerSpec`
+    ``LayerSpec``
         Geom object specification.
 
     Notes
     -----
     Computed variables:
 
-    - ..y.. : result of calculating of `fun`.
-    - ..ymin.. : result of calculating of `fun_min`.
-    - ..ymax.. : result of calculating of `fun_max`.
+    - ..y.. : result of calculating of ``fun``.
+    - ..ymin.. : result of calculating of ``fun_min``.
+    - ..ymax.. : result of calculating of ``fun_max``.
 
     ----
 
-    To hide axis tooltips, set 'blank' or the result of `element_blank()`
-    to the `axis_tooltip` or `axis_tooltip_x` 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`` or ``axis_tooltip_x`` parameter of the `theme() <https://lets-plot.org/python/pages/api/lets_plot.theme.html>`__.
 
     Examples
     --------
@@ -333,28 +335,29 @@ def stat_ecdf(mapping=None, *, data=None, geom=None,
 
     Parameters
     ----------
-    mapping : `FeatureSpec`
-        Set of aesthetic mappings created by `aes()` function.
+    mapping : ``FeatureSpec``
+        Set of aesthetic mappings created by `aes() <https://lets-plot.org/python/pages/api/lets_plot.aes.html>`__ function.
         Aesthetic mappings describe the way that variables in the data are
         mapped to plot "aesthetics".
-    data : dict or Pandas or Polars `DataFrame`
+    data : dict or Pandas or Polars ``DataFrame``
         The data to be displayed in this layer. If None, the default, the data
         is inherited from the plot data as specified in the call to ggplot.
     geom : str, default='step'
         The geometry to display the ecdf stat for this layer, as a string.
-    position : str or `FeatureSpec`, default='identity'
+    position : str or ``FeatureSpec``, default='identity'
         Position adjustment.
         Either a position adjustment name: 'dodge', 'jitter', 'nudge', 'jitterdodge', 'fill',
-        'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
+        'stack' or 'identity', or the result of calling a position adjustment function
+        (e.g., `position_dodge() <https://lets-plot.org/python/pages/api/lets_plot.position_dodge.html>`__ etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     inherit_aes : bool, default=True
         False - do not combine the layer aesthetic mappings with the plot shared mappings.
-    sampling : `FeatureSpec`
-        Result of the call to the `sampling_xxx()` function.
+    sampling : ``FeatureSpec``
+        Result of the call to the ``sampling_xxx()`` function.
         To prevent any sampling for this layer pass value "none" (string "none").
-    tooltips : `layer_tooltips`
-        Result of the call to the `layer_tooltips()` function.
+    tooltips : ``layer_tooltips``
+        Result of the call to the `layer_tooltips() <https://lets-plot.org/python/pages/api/lets_plot.layer_tooltips.html>`__ function.
         Specify appearance, style and content.
         Set tooltips='none' to hide tooltips from the layer.
     orientation : str, default='x'
@@ -364,7 +367,7 @@ def stat_ecdf(mapping=None, *, data=None, geom=None,
         If None, do not interpolate.
         If not None, this is the number of points to interpolate with.
     pad : bool, default=True
-        If geometry is `'step'` and `pad=True`, then the points at the ends:
+        If geometry is ``'step'`` and ``pad=True``, then the points at the ends:
         (-inf, 0) and (inf, 1) are added to the ecdf.
     color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
         Define the color aesthetic for the geometry.
@@ -376,22 +379,22 @@ def stat_ecdf(mapping=None, *, data=None, geom=None,
 
     Returns
     -------
-    `LayerSpec`
+    ``LayerSpec``
         Geom object specification.
 
     Notes
     -----
-    `stat_ecdf()` understands the following aesthetics mappings:
+    ``stat_ecdf()`` understands the following aesthetics mappings:
 
     - x : x-axis coordinates.
     - y : y-axis coordinates.
 
-    In addition, you can use any aesthetics, available for the geometry defined by the `geom` parameter.
+    In addition, you can use any aesthetics, available for the geometry defined by the ``geom`` parameter.
 
     ----
 
-    To hide axis tooltips, set 'blank' or the result of `element_blank()`
-    to the `axis_tooltip` or `axis_tooltip_x` 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`` or ``axis_tooltip_x`` parameter of the `theme() <https://lets-plot.org/python/pages/api/lets_plot.theme.html>`__.
 
     Examples
     --------
@@ -474,28 +477,29 @@ def stat_sum(mapping=None, *, data=None, geom=None, position=None, show_legend=N
 
     Parameters
     ----------
-    mapping : `FeatureSpec`
-        Set of aesthetic mappings created by `aes()` function.
+    mapping : ``FeatureSpec``
+        Set of aesthetic mappings created by `aes() <https://lets-plot.org/python/pages/api/lets_plot.aes.html>`__ function.
         Aesthetic mappings describe the way that variables in the data are
         mapped to plot "aesthetics".
-    data : dict or Pandas or Polars `DataFrame`
+    data : dict or Pandas or Polars ``DataFrame``
         The data to be displayed in this layer. If None, the default, the data
         is inherited from the plot data as specified in the call to ggplot.
     geom : str, default='point'
         The geometry to display the sum stat for this layer, as a string.
-    position : str or `FeatureSpec`, default='identity'
+    position : str or ``FeatureSpec``, default='identity'
         Position adjustment.
         Either a position adjustment name: 'dodge', 'jitter', 'nudge', 'jitterdodge', 'fill',
-        'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
+        'stack' or 'identity', or the result of calling a position adjustment function
+        (e.g., `position_dodge() <https://lets-plot.org/python/pages/api/lets_plot.position_dodge.html>`__ etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     inherit_aes : bool, default=True
         False - do not combine the layer aesthetic mappings with the plot shared mappings.
-    sampling : `FeatureSpec`
-        Result of the call to the `sampling_xxx()` function.
+    sampling : ``FeatureSpec``
+        Result of the call to the ``sampling_xxx()`` function.
         To prevent any sampling for this layer pass value "none" (string "none").
-    tooltips : `layer_tooltips`
-        Result of the call to the `layer_tooltips()` function.
+    tooltips : ``layer_tooltips``
+        Result of the call to the `layer_tooltips() <https://lets-plot.org/python/pages/api/lets_plot.layer_tooltips.html>`__ function.
         Specify appearance, style and content.
         Set tooltips='none' to hide tooltips from the layer.
     color_by : {'fill', 'color', 'paint_a', 'paint_b', 'paint_c'}, default='color'
@@ -510,7 +514,7 @@ def stat_sum(mapping=None, *, data=None, geom=None, position=None, show_legend=N
 
     Returns
     -------
-    `LayerSpec`
+    ``LayerSpec``
         Geom object specification.
 
     Notes
@@ -521,17 +525,17 @@ def stat_sum(mapping=None, *, data=None, geom=None, position=None, show_legend=N
     - ..prop.. : proportion of points with same x-axis and y-axis coordinates.
     - ..proppct.. : proportion of points with same x-axis and y-axis coordinates in percent.
 
-    `stat_sum()` understands the following aesthetics mappings:
+    ``stat_sum()`` understands the following aesthetics mappings:
 
     - x : x-axis coordinates.
     - y : y-axis coordinates.
 
-    In addition, you can use any aesthetics, available for the geometry defined by the `geom` parameter.
+    In addition, you can use any aesthetics, available for the geometry defined by the ``geom`` parameter.
 
     ----
 
-    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
     --------